openapi-typescript@7, [email protected] 🎉 (openapi-ts#1706)

* Breaking 0.10.0 changes

* Update docs

* Update lockfile

Author: drwpow

biome.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://biomejs.dev/schemas/1.7.0/schema.json",
+  "$schema": "https://biomejs.dev/schemas/1.8.1/schema.json",
   "extends": ["../../biome.json"],
   "files": {
     "include": ["./bin/", "./src/", "./test/"],

examples/digital-ocean-api.ts

@@ -24,7 +24,7 @@ introduction: |
   |GET|For simple retrieval of information about your account, Droplets, or environment, you should use the GET method.  The information you request will be returned to you as a JSON object. The attributes defined by the JSON object can be used to form additional requests.  Any request using the GET method is read-only and will not affect any of the objects you are querying.|
   |DELETE|To destroy a resource and remove it from your account and environment, the DELETE method should be used.  This will remove the specified object if it is found.  If it is not found, the operation will return a response indicating that the object was not found. This idempotency means that you do not have to check for a resource's availability prior to issuing a delete command, the final state will be the same regardless of its existence.|
   |PUT|To update the information about a resource in your account, the PUT method is available. Like the DELETE Method, the PUT method is idempotent.  It sets the state of the target using the provided values, regardless of their current values. Requests using the PUT method do not need to check the current attributes of the object.|
-  |PATCH|Some resources support partial modification. In these cases, the PATCH method is available. Unlike PUT which generally requires a complete representation of a resource, a PATCH request is is a set of instructions on how to modify a resource updating only specific attributes.|
+  |PATCH|Some resources support partial modification. In these cases, the PATCH method is available. Unlike PUT which generally requires a complete representation of a resource, a PATCH request is a set of instructions on how to modify a resource updating only specific attributes.|
   |POST|To create a new object, your request should specify the POST method. The POST request includes all of the attributes necessary to create a new object.  When you wish to create a new object, send a POST request to the target endpoint.|
   |HEAD|Finally, to retrieve metadata information, you should use the HEAD method to get the headers.  This returns only the header of what would be returned with an associated GET request. Response headers contain some useful information about your API access and the results that are available for your request. For instance, the headers contain your current rate-limit value and the amount of time available until the limit resets. It also contains metrics about the total number of objects found, pagination information, and the total content length.|
 
@@ -93,7 +93,7 @@ introduction: |
 
   ### Response for a Single Object
 
-  ```
+  ```json
       {
           "droplet": {
               "name": "example.com"
@@ -104,7 +104,7 @@ introduction: |
 
   ### Response for an Object Collection
 
-  ```
+  ```json
       {
           "droplets": [
               {
@@ -135,7 +135,7 @@ introduction: |
 
   ### Sample Meta Object
 
-  ```
+  ```json
       {
           . . .
           "meta": {
@@ -175,7 +175,7 @@ introduction: |
 
   ### Sample Links Object
 
-  ```
+  ```json
       {
           . . .
           "links": {
@@ -233,7 +233,7 @@ introduction: |
   
   `ratelimit-remaining` reaching zero can also indicate that the "burst limit" of 250 
   requests per minute limit was met, even if the 5,000 requests per hour limit was not. 
-  In this case, the 429 error response will include a retry-after header to indicate how 
+  In this case, the 429 error response will include a `retry-after` header to indicate how 
   long to wait (in seconds) until the request may be retried.
 
   You can see the format of the response in the examples. 

examples/digital-ocean-api/description.yml

@@ -31,9 +31,11 @@ requestBody:
               run_command: bin/api
               environment_slug: node-js
               instance_count: 2
-              instance_size_slug: basic-xxs
+              instance_size_slug: apps-s-1vcpu-0.5gb
               routes:
                 - path: /api
+          egress:
+            type: DEDICATED_IP
   required: true
 
 responses:

examples/digital-ocean-api/resources/apps/apps_create.yml

@@ -1,8 +1,13 @@
 operationId: apps_get_tier
 
+deprecated: true
+
 summary: Retrieve an App Tier
 
-description: Retrieve information about a specific app tier.
+description: |
+  Retrieve information about a specific app tier. 
+  This endpoint has been deprecated because app tiers are not tied to instance sizes anymore. 
+  The concept of tiers will be retired in the future.
 
 tags:
 - Apps

examples/digital-ocean-api/resources/apps/apps_get_tier.yml

@@ -1,8 +1,13 @@
 operationId: apps_list_tiers
 
+deprecated: true
+
 summary: List App Tiers
 
-description: List all app tiers.
+description: | 
+  List all app tiers. 
+  This endpoint has been deprecated because app tiers are not tied to instance sizes anymore. 
+  The concept of tiers will be retired in the future.
 
 tags:
 - Apps

examples/digital-ocean-api/resources/apps/apps_list_tiers.yml

@@ -0,0 +1,48 @@
+operationId: apps_toggle_database_trusted_source
+
+summary: Toggle Database Trusted Source
+
+description: Toggles the trusted source status of a database component for a given app.
+
+tags:
+  - Apps
+
+parameters:
+  - $ref: parameters.yml#/app_id
+
+requestBody:
+  content:
+    application/json:
+      schema:
+        $ref: models/toggle_database_trusted_source_request.yml
+  required: true
+
+responses:
+  "200":
+    $ref: responses/toggle_database_trusted_source.yml
+
+  "400":
+    $ref: ../../shared/responses/bad_request.yml
+
+  "401":
+    $ref: ../../shared/responses/unauthorized.yml
+
+  "404":
+    $ref: '../../shared/responses/not_found.yml'
+
+  "429":
+    $ref: "../../shared/responses/too_many_requests.yml"
+
+  "500":
+    $ref: ../../shared/responses/server_error.yml
+
+  default:
+    $ref: ../../shared/responses/unexpected_error.yml
+
+x-codeSamples:
+  - $ref: 'examples/curl/apps_toggle_database_trusted_source.yml'
+  - $ref: 'examples/python/apps_toggle_database_trusted_source.yml'
+
+security:
+  - bearer_auth:
+      - 'app:update'

examples/digital-ocean-api/resources/apps/apps_toggle_database_trusted_source.yml

@@ -29,7 +29,7 @@ requestBody:
               run_command: bin/api
               environment_slug: node-js
               instance_count: 2
-              instance_size_slug: basic-xxs
+              instance_size_slug: apps-s-1vcpu-0.5gb
               routes:
                 - path: /api
         app_id: b6bdf840-2854-4f87-a36c-5f231c617c84

examples/digital-ocean-api/resources/apps/apps_validate_appSpec.yml

@@ -8,5 +8,5 @@ source: |-
     "services":[{"name":"api","github":{"branch":"main",\
     "deploy_on_push":true,"repo":"digitalocean/sample-golang"}, \
     "run_command":"bin/api","environment_slug":"node-js", \
-    "instance_count":2,"instance_size_slug":"basic-xxs", \
+    "instance_count":2,"instance_size_slug":"apps-s-1vcpu-0.5gb", \
     "routes":[{"path":"/api"}]}]}}'

examples/digital-ocean-api/resources/apps/examples/curl/apps_create.yml

@@ -0,0 +1,6 @@
+lang: Curl
+source: |-
+  curl -X POST https://api.digitalocean.com/v2/apps/{app_id}/components/{component_name}/trusted_sources \
+    -H "Content-Type: application/json" \
+    -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
+    -d '{ "enable": true }'