chore: 🐝 Update SDK - Generate 0.2.0 (#12)

github-actions[bot] · speakeasybot · speakeasy-github[bot] · web-flow · commit 52a3fe18ea2b · 2025-02-25T12:37:43.000Z
* ci: regenerated with OpenAPI Doc , Speakeasy CLI 1.502.0

* empty commit to trigger [run-tests] workflow

---------

Co-authored-by: speakeasybot &lt;bot@speakeasyapi.dev&gt;
Co-authored-by: speakeasy-github[bot] &lt;128539517+speakeasy-github[bot]@users.noreply.github.com&gt;
diff --git a/.gitignore b/.gitignore
@@ -1,3 +1,4 @@
+/mcp-server
 /bin
 /.eslintcache
 /.speakeasy/reports
diff --git a/.speakeasy/gen.lock b/.speakeasy/gen.lock
@@ -3,10 +3,10 @@ id: 8ee5821f-25ad-41d5-94bd-080f4048f5d5
 management:
   docChecksum: 65a8cad189779a50db0e3beea8a6a0f1
   docVersion: 0.0.0
-  speakeasyVersion: 1.498.1
-  generationVersion: 2.518.1
-  releaseVersion: 0.1.3
-  configChecksum: 15e51277f78558c302ead81bd2747547
+  speakeasyVersion: 1.502.0
+  generationVersion: 2.524.1
+  releaseVersion: 0.2.0
+  configChecksum: e7f877270d1cda2cf91c3e031b72ab63
   repoURL: https://github.com/speakeasy-api/bluesky-ts.git
   installationURL: https://github.com/speakeasy-api/bluesky-ts
   published: true
@@ -15,7 +15,7 @@ features:
     additionalDependencies: 0.1.0
     additionalProperties: 0.1.1
     constsAndDefaults: 0.1.11
-    core: 3.20.0
+    core: 3.21.1
     defaultEnabledRetries: 0.1.0
     devContainers: 2.90.0
     enumUnions: 0.1.0
@@ -26,7 +26,7 @@ features:
     globalSecurityFlattening: 0.1.0
     globalServerURLs: 2.82.4
     groups: 2.81.2
-    mcpServer: 0.1.1
+    mcpServer: 0.3.0
     methodArguments: 0.1.2
     nameOverrides: 2.81.2
     pagination: 2.82.8
diff --git a/.speakeasy/gen.yaml b/.speakeasy/gen.yaml
@@ -18,7 +18,7 @@ generation:
     oAuth2ClientCredentialsEnabled: false
     oAuth2PasswordEnabled: false
 typescript:
-  version: 0.1.3
+  version: 0.2.0
   additionalDependencies:
     dependencies: {}
     devDependencies: {}
diff --git a/.speakeasy/workflow.lock b/.speakeasy/workflow.lock
@@ -1,21 +1,21 @@
-speakeasyVersion: 1.498.1
+speakeasyVersion: 1.502.0
 sources:
     OAS:
         sourceNamespace: oas
-        sourceRevisionDigest: sha256:67ea8cf97879cde6198e535a51d38ab1ea027c16f04b9ecc75abdc4e9f5ddfad
+        sourceRevisionDigest: sha256:e1219e25d26c16987db000021f18323b34f8a5887ac8aa7c73e807baff6e3263
         sourceBlobDigest: sha256:fc611c3f426fda575a39f6881e166ba50f7760e7c81a8a7d094b851ae6f3fbb8
         tags:
             - latest
-            - speakeasy-sdk-regen-1740074531
+            - speakeasy-sdk-regen-1740161432
             - 0.0.0
 targets:
     bluesky:
         source: OAS
         sourceNamespace: oas
-        sourceRevisionDigest: sha256:67ea8cf97879cde6198e535a51d38ab1ea027c16f04b9ecc75abdc4e9f5ddfad
+        sourceRevisionDigest: sha256:e1219e25d26c16987db000021f18323b34f8a5887ac8aa7c73e807baff6e3263
         sourceBlobDigest: sha256:fc611c3f426fda575a39f6881e166ba50f7760e7c81a8a7d094b851ae6f3fbb8
         codeSamplesNamespace: oas-typescript-code-samples
-        codeSamplesRevisionDigest: sha256:bf6456e86d27ecf9abb5ed822fdee96579d24b5d625e8752d26bd56d5d4c307a
+        codeSamplesRevisionDigest: sha256:e022cc6f30be05153433d64c6f8644170041b02aea03d095c774b0d146f1de23
 workflow:
     workflowVersion: 1.0.0
     speakeasyVersion: latest
diff --git a/README.md b/README.md
@@ -27,6 +27,19 @@ This section contains HTTP API reference docs for Bluesky and AT Protocol lexico
 <!-- $toc-max-depth=2 -->
 * [@speakeasy-api/bluesky](#speakeasy-apibluesky)
   * [SDK Installation](#sdk-installation)
+  * [Requirements](#requirements)
+  * [SDK Example Usage](#sdk-example-usage)
+  * [Authentication](#authentication)
+  * [Available Resources and Operations](#available-resources-and-operations)
+  * [Standalone functions](#standalone-functions)
+  * [React hooks with TanStack Query](#react-hooks-with-tanstack-query)
+  * [Pagination](#pagination)
+  * [File uploads](#file-uploads)
+  * [Retries](#retries)
+  * [Error Handling](#error-handling)
+  * [Server Selection](#server-selection)
+  * [Custom HTTP Client](#custom-http-client)
+  * [Debugging](#debugging)
 * [Development](#development)
   * [Maturity](#maturity)
   * [Contributions](#contributions)
@@ -94,10 +107,12 @@ Add the following server definition to your `claude_desktop_config.json` file:
   "mcpServers": {
     "Bluesky": {
       "command": "npx",
-      "args": ["-y", "--package", "@speakeasy-sdks/bluesky", "--", "mcp", "start"],
-      "env": {
-        "BLUESKY_BEARER": "..."
-      }
+      "args": [
+        "-y", "--package", "@speakeasy-sdks/bluesky",
+        "--",
+        "mcp", "start",
+        "--bearer", "..."
+      ]
     }
   }
 }
@@ -108,29 +123,14 @@ Add the following server definition to your `claude_desktop_config.json` file:
 <details>
 <summary>Cursor installation steps</summary>
 
-1. Create a shell script called `mcp-bluesky.sh` with the following content:
-
-    ```sh
-    #!/bin/sh
-     
-    export BLUESKY_BEARER="..."
-
-    exec npx -y --package @speakeasy-sdks/bluesky -- mcp start "$@"
-    ```
-
-2. Then make it executable with the following command:
+Go to `Cursor Settings > Features > MCP Servers > Add new MCP server` and use the following settings:
 
-    ```sh
-    chmod +x mcp-bluesky.sh
-    ```
-
-3. In Cursor, `Cursor Settings > Features > MCP Servers > Add new MCP server` and use the following settings:
-
-    | Field   | Value |
-    | ------- | ----- |
-    | Name    | Bluesky |
-    | Type    | `command` |
-    | Command | `/path/to/mcp-bluesky.sh` |
+- Name: Bluesky
+- Type: `command`
+- Command:
+```sh
+npx -y --package @speakeasy-sdks/bluesky -- mcp start --bearer ... 
+```
 
 </details>
 
diff --git a/RELEASES.md b/RELEASES.md
@@ -62,4 +62,14 @@ Based on:
 ### Generated
 - [typescript v0.1.3] .
 ### Releases
-- [NPM v0.1.3] https://www.npmjs.com/package/@speakeasy-sdks/bluesky/v/0.1.3 - .
+- [NPM v0.1.3] https://www.npmjs.com/package/@speakeasy-sdks/bluesky/v/0.1.3 - .
+
+## 2025-02-25 12:23:52
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.502.0 (2.524.1) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [typescript v0.2.0] .
+### Releases
+- [NPM v0.2.0] https://www.npmjs.com/package/@speakeasy-sdks/bluesky/v/0.2.0 - .
diff --git a/jsr.json b/jsr.json
@@ -2,7 +2,7 @@
 
 {
   "name": "@speakeasy-sdks/bluesky",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",    
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@speakeasy-sdks/bluesky",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "author": "Speakeasy",
   "type": "module",
   "bin": {
diff --git a/src/lib/config.ts b/src/lib/config.ts
@@ -24,7 +24,7 @@ export const ServerList = {
 } as const;
 
 export type SDKOptions = {
-  bearer?: string | (() => Promise<string>);
+  bearer?: string | (() => Promise<string>) | undefined;
 
   httpClient?: HTTPClient;
   /**
@@ -60,8 +60,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "0.0.0",
-  sdkVersion: "0.1.3",
-  genVersion: "2.518.1",
+  sdkVersion: "0.2.0",
+  genVersion: "2.524.1",
   userAgent:
-    "speakeasy-sdk/typescript 0.1.3 2.518.1 0.0.0 @speakeasy-sdks/bluesky",
+    "speakeasy-sdk/typescript 0.2.0 2.524.1 0.0.0 @speakeasy-sdks/bluesky",
 } as const;
diff --git a/src/lib/primitives.ts b/src/lib/primitives.ts
@@ -134,3 +134,17 @@ export function compactMap<T>(
 
   return out;
 }
+
+export function allRequired<V extends Record<string, unknown>>(
+  v: V,
+):
+  | {
+      [K in keyof V]: NonNullable<V[K]>;
+    }
+  | undefined {
+  if (Object.values(v).every((x) => x == null)) {
+    return void 0;
+  }
+
+  return v as ReturnType<typeof allRequired<V>>;
+}
diff --git a/src/mcp-server/cli/start/command.ts b/src/mcp-server/cli/start/command.ts
@@ -15,12 +15,6 @@ export const startCommand = buildCommand({
   },
   parameters: {
     flags: {
-      "log-level": {
-        kind: "enum",
-        brief: "The log level to use for the server",
-        default: "info",
-        values: consoleLoggerLevels,
-      },
       transport: {
         kind: "enum",
         brief: "The transport to use for communicating with the server",
@@ -46,7 +40,14 @@ export const startCommand = buildCommand({
           },
         }
         : {}),
-
+      bearer: {
+        kind: "parsed",
+        brief: "Sets the bearer auth field for the API",
+        optional: true,
+        parse: (value) => {
+          return z.string().parse(value);
+        },
+      },
       "server-url": {
         kind: "parsed",
         brief: "Overrides the default server URL used by the SDK",
@@ -59,6 +60,36 @@ export const startCommand = buildCommand({
         optional: true,
         values: Object.keys(ServerList) as Array<keyof typeof ServerList>,
       },
+      "log-level": {
+        kind: "enum",
+        brief: "The log level to use for the server",
+        default: "info",
+        values: consoleLoggerLevels,
+      },
+      env: {
+        kind: "parsed",
+        brief: "Environment variables made available to the server",
+        optional: true,
+        variadic: true,
+        parse: (val: string) => {
+          const sepIdx = val.indexOf("=");
+          if (sepIdx === -1) {
+            throw new Error("Invalid environment variable format");
+          }
+
+          const key = val.slice(0, sepIdx);
+          const value = val.slice(sepIdx + 1);
+
+          return [
+            z.string().nonempty({
+              message: "Environment variable key must be a non-empty string",
+            }).parse(key),
+            z.string().nonempty({
+              message: "Environment variable value must be a non-empty string",
+            }).parse(value),
+          ] satisfies [string, string];
+        },
+      },
     },
   },
   docs: {
diff --git a/src/mcp-server/cli/start/impl.ts b/src/mcp-server/cli/start/impl.ts
@@ -15,15 +15,21 @@ import { MCPScope } from "../../scopes.js";
 import { createMCPServer } from "../../server.js";
 
 interface StartCommandFlags {
-  readonly "log-level": ConsoleLoggerLevel;
   readonly transport: "stdio" | "sse";
   readonly port: number;
   readonly scope?: MCPScope[];
+  readonly bearer?: string | undefined;
   readonly "server-url"?: string;
   readonly server?: SDKOptions["server"];
+  readonly "log-level": ConsoleLoggerLevel;
+  readonly env?: [string, string][];
 }
 
 export async function main(this: LocalContext, flags: StartCommandFlags) {
+  flags.env?.forEach(([key, value]) => {
+    process.env[key] = value;
+  });
+
   switch (flags.transport) {
     case "stdio":
       await startStdio(flags);
@@ -42,8 +48,9 @@ async function startStdio(flags: StartCommandFlags) {
   const server = createMCPServer({
     logger,
     scopes: flags.scope,
+    ...{ bearer: flags.bearer },
     serverURL: flags["server-url"],
-    server: flags["server"],
+    server: flags.server,
   });
   await server.connect(transport);
 
@@ -61,8 +68,9 @@ async function startSSE(flags: StartCommandFlags) {
   const mcpServer = createMCPServer({
     logger,
     scopes: flags.scope,
+    ...{ bearer: flags.bearer },
     serverURL: flags["server-url"],
-    server: flags["server"],
+    server: flags.server,
   });
   let transport: SSEServerTransport | undefined;
   const controller = new AbortController();
diff --git a/src/mcp-server/mcp-server.ts b/src/mcp-server/mcp-server.ts
@@ -19,7 +19,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.1.3",
+    currentVersion: "0.2.0",
   },
 });
 
diff --git a/src/mcp-server/server.ts b/src/mcp-server/server.ts
@@ -182,14 +182,16 @@ export function createMCPServer(deps: {
   logger: ConsoleLogger;
   scopes?: MCPScope[] | undefined;
   serverURL?: string | undefined;
-  server?: SDKOptions["server"];
+  bearer?: SDKOptions["bearer"] | undefined;
+  server?: SDKOptions["server"] | undefined;
 }) {
   const server = new McpServer({
     name: "Bluesky",
-    version: "0.1.3",
+    version: "0.2.0",
   });
 
   const client = new BlueskyCore({
+    bearer: deps.bearer,
     serverURL: deps.serverURL,
     server: deps.server,
   });

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+/mcp-server`
`1`	`2`	`/bin`
`2`	`3`	`/.eslintcache`
`3`	`4`	`/.speakeasy/reports`
Original file line number	Diff line number	Diff line change
`@@ -2,7 +2,7 @@`
`2`	`2`
`3`	`3`	`{`
`4`	`4`	`"name": "@speakeasy-sdks/bluesky",`
`5`		`- "version": "0.1.3",`
	`5`	`+ "version": "0.2.0",`
`6`	`6`	`"exports": {`
`7`	`7`	`".": "./src/index.ts",`
`8`	`8`	`"./models/errors": "./src/models/errors/index.ts",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@speakeasy-sdks/bluesky",`
`3`		`- "version": "0.1.3",`
	`3`	`+ "version": "0.2.0",`
`4`	`4`	`"author": "Speakeasy",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"bin": {`