feat: update

Author: ryan-timothy-albert

.devcontainer/README.md

@@ -0,0 +1,30 @@
+
+> **Remember to shutdown a GitHub Codespace when it is not in use!**
+
+# Dev Containers Quick Start
+
+The default location for usage snippets is the `samples` directory.
+
+## Running a Usage Sample
+
+A sample usage example has been provided in a `root.ts` file. As you work with the SDK, it's expected that you will modify these samples to fit your needs. To execute this particular snippet, use the command below.
+
+```
+ts-node root.ts
+```
+
+## Generating Additional Usage Samples
+
+The speakeasy CLI allows you to generate more usage snippets. Here's how:
+
+- To generate a sample for a specific operation by providing an operation ID, use:
+
+```
+speakeasy generate usage -s openapi.json -l typescript -i {INPUT_OPERATION_ID} -o ./samples
+```
+
+- To generate samples for an entire namespace (like a tag or group name), use:
+
+```
+speakeasy generate usage -s openapi.json -l typescript -n {INPUT_TAG_NAME} -o ./samples
+```

.devcontainer/devcontainer.json

@@ -0,0 +1,45 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/images/tree/main/src/typescript-node
+{
+    "name": "TypeScript",
+    "image": "mcr.microsoft.com/devcontainers/typescript-node:1-20-bullseye",
+    // Features to add to the dev container. More info: https://containers.dev/features.
+    // "features": {},
+    // Use 'forwardPorts' to make a list of ports inside the container available locally.
+    // "forwardPorts": [],
+    // Use 'postCreateCommand' to run commands after the container is created.
+    "postCreateCommand": "sudo chmod +x ./.devcontainer/setup.sh && ./.devcontainer/setup.sh",
+    "customizations": {
+        "vscode": {
+            "extensions": [
+                "ms-vscode.vscode-typescript-tslint-plugin",
+                "esbenp.prettier-vscode",
+                "github.vscode-pull-request-github"
+            ],
+            "settings": {
+                "files.eol": "\n",
+                "editor.formatOnSave": true,
+                "typescript.tsc.autoDetect": "on",
+                "typescript.updateImportsOnFileMove.enabled": "always",
+                "typescript.preferences.importModuleSpecifier": "relative",
+                "[typescript]": {
+                    "editor.codeActionsOnSave": {
+                        "source.organizeImports": true
+                    }
+                },
+                "[typescriptreact]": {
+                    "editor.codeActionsOnSave": {
+                        "source.organizeImports": true
+                    }
+                }
+            }
+        },
+        "codespaces": {
+            "openFiles": [
+                ".devcontainer/README.md"
+            ]
+        }
+    }
+    // Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+    // "remoteUser": "root"
+}

.devcontainer/setup.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+
+# Install the speakeasy CLI
+curl -fsSL https://raw.githubusercontent.com/speakeasy-api/speakeasy/main/install.sh | sh
+
+# Setup samples directory
+rmdir samples || true
+mkdir samples
+
+npm install
+npm install -g ts-node
+npm link
+npm link @speakeasy-api/code-samples
+TS_CONFIG_CONTENT=$(cat <<EOL
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "openapi": ["../src/index"],
+      "openapi/*": ["../src/*"]
+    }
+  },
+  "include": ["./**/*.ts"]
+}
+EOL
+)
+echo "$TS_CONFIG_CONTENT" > samples/tsconfig.json
+
+# Generate starter usage sample with speakeasy
+speakeasy generate usage -s openapi.json -l typescript -o samples/root.ts

.speakeasy/gen.lock

@@ -5,14 +5,15 @@ management:
   docVersion: 0.4.0
   speakeasyVersion: 1.441.0
   generationVersion: 2.460.1
-  releaseVersion: 0.35.0
-  configChecksum: 1de1cbeadb9ebd16f441a50fda7f87b9
+  releaseVersion: 0.36.0
+  configChecksum: 9505b45b3f0fe8a1a05ea6570deeca6b
 features:
   typescript:
     acceptHeaders: 2.81.2
     additionalDependencies: 0.1.0
     core: 3.18.5
     defaultEnabledRetries: 0.1.0
+    devContainers: 2.90.0
     downloadStreams: 0.1.1
     enumUnions: 0.1.0
     envVarSecurityUsage: 0.1.2
@@ -30,6 +31,9 @@ features:
     tests: 0.7.0
     uploadStreams: 0.1.0
 generatedFiles:
+  - .devcontainer/README.md
+  - .devcontainer/devcontainer.json
+  - .devcontainer/setup.sh
   - .eslintrc.cjs
   - .gitattributes
   - .npmignore
@@ -107,6 +111,7 @@ examples:
       responses:
         4XX:
           application/json: {"message": "<value>", "status_code": 159498}
+        "200": {}
   generateCodeSamplePreviewAsync:
     speakeasy-default-generate-code-sample-preview-async:
       requestBody:
@@ -126,3 +131,4 @@ examples:
           application/json: {"status": "pending"}
         4XX:
           application/json: {"message": "<value>", "status_code": 893724}
+        "200": {}

.speakeasy/gen.yaml

@@ -1,5 +1,8 @@
 configVersion: 2.0.0
 generation:
+  devContainers:
+    enabled: true
+    schemaPath: openapi.json
   sdkClassName: SDK
   maintainOpenAPIOrder: true
   usageSnippets:
@@ -13,7 +16,7 @@ generation:
     oAuth2ClientCredentialsEnabled: false
     oAuth2PasswordEnabled: false
 typescript:
-  version: 0.35.0
+  version: 0.36.0
   additionalDependencies:
     dependencies: {}
     devDependencies: {}

jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "@speakeasy-api/code-samples",
-  "version": "0.35.0",
+  "version": "0.36.0",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",