@polar-sh/sdk 0.31.0 → 0.32.0

package/README.md

@@ -83,7 +83,7 @@ yarn add @polar-sh/sdk zod
 This SDK is also an installable MCP server where the various SDK methods are
 exposed as tools that can be invoked by AI applications.
 
-> Node.js v20 or greater is required to run the MCP server.
+> Node.js v20 or greater is required to run the MCP server from npm.
 
 <details>
 <summary>Claude installation steps</summary>
@@ -111,17 +111,50 @@ Add the following server definition to your `claude_desktop_config.json` file:
 <details>
 <summary>Cursor installation steps</summary>
 
-Go to `Cursor Settings > Features > MCP Servers > Add new MCP server` and use the following settings:
+Create a `.cursor/mcp.json` file in your project root with the following content:
 
-- Name: Polar
-- Type: `command`
-- Command:
-```sh
-npx -y --package @polar-sh/sdk -- mcp start --access-token ... 
+```json
+{
+  "mcpServers": {
+    "Polar": {
+      "command": "npx",
+      "args": [
+        "-y", "--package", "@polar-sh/sdk",
+        "--",
+        "mcp", "start",
+        "--access-token", "..."
+      ]
+    }
+  }
+}
 ```
 
 </details>
 
+You can also run MCP servers as a standalone binary with no additional dependencies. You must pull these binaries from available Github releases:
+
+```bash
+curl -L -o mcp-server \
+    https://github.com/{org}/{repo}/releases/download/{tag}/mcp-server-bun-darwin-arm64 && \
+chmod +x mcp-server
+```
+
+If the repo is a private repo you must add your Github PAT to download a release `-H "Authorization: Bearer {GITHUB_PAT}"`.
+
+
+```json
+{
+  "mcpServers": {
+    "Todos": {
+      "command": "./DOWNLOAD/PATH/mcp-server",
+      "args": [
+        "start"
+      ]
+    }
+  }
+}
+```
+
 For a full list of server arguments, run:
 
 ```sh

package/bin/mcp-server.js

@@ -4018,9 +4018,9 @@ var init_config = __esm(() => {
   SDK_METADATA = {
     language: "typescript",
     openapiDocVersion: "0.1.0",
-    sdkVersion: "0.31.0",
-    genVersion: "2.548.6",
-    userAgent: "speakeasy-sdk/typescript 0.31.0 2.548.6 0.1.0 @polar-sh/sdk"
+    sdkVersion: "0.32.0",
+    genVersion: "2.558.2",
+    userAgent: "speakeasy-sdk/typescript 0.32.0 2.558.2 0.1.0 @polar-sh/sdk"
   };
 });
 
@@ -35004,6 +35004,30 @@ var init_core = __esm(() => {
   };
 });
 
+// src/mcp-server/prompts.ts
+function createRegisterPrompt(logger, server, sdk, allowedScopes) {
+  return (prompt) => {
+    const scopes = prompt.scopes ?? [];
+    if (!scopes.every((s) => allowedScopes.has(s))) {
+      return;
+    }
+    if (prompt.args) {
+      if (prompt.description) {
+        server.prompt(prompt.name, prompt.description, prompt.args, async (args, ctx) => prompt.prompt(sdk, args, ctx));
+      } else {
+        server.prompt(prompt.name, prompt.args, async (args, ctx) => prompt.prompt(sdk, args, ctx));
+      }
+    } else {
+      if (prompt.description) {
+        server.prompt(prompt.name, prompt.description, async (ctx) => prompt.prompt(sdk, ctx));
+      } else {
+        server.prompt(prompt.name, async (ctx) => prompt.prompt(sdk, ctx));
+      }
+    }
+    logger.debug("Registered prompt", { name: prompt.name });
+  };
+}
+
 // src/mcp-server/shared.ts
 async function consumeStream(stream) {
   const reader = stream.getReader();
@@ -35449,6 +35473,9 @@ function resolveSecurity(...options) {
       } else if (o.type === "oauth2:password") {
         return typeof o.value === "string" && !!o.value;
       } else if (o.type === "oauth2:client_credentials") {
+        if (typeof o.value == "string") {
+          return !!o.value;
+        }
         return o.value.clientID != null || o.value.clientSecret != null;
       } else if (typeof o.value === "string") {
         return !!o.value;
@@ -35514,7 +35541,9 @@ function applyBearer(state, spec) {
   if (value.slice(0, 7).toLowerCase() !== "bearer ") {
     value = `Bearer ${value}`;
   }
-  state.headers[spec.fieldName] = value;
+  if (spec.fieldName !== undefined) {
+    state.headers[spec.fieldName] = value;
+  }
 }
 function resolveGlobalSecurity(security) {
   return resolveSecurity([
@@ -39349,6 +39378,24 @@ var init_orderproduct = __esm(() => {
   })(OrderProduct$ ||= {});
 });
 
+// src/models/components/orderstatus.ts
+var OrderStatus, OrderStatus$inboundSchema, OrderStatus$outboundSchema, OrderStatus$;
+var init_orderstatus = __esm(() => {
+  init_lib();
+  OrderStatus = {
+    Pending: "pending",
+    Paid: "paid",
+    Refunded: "refunded",
+    PartiallyRefunded: "partially_refunded"
+  };
+  OrderStatus$inboundSchema = nativeEnumType(OrderStatus);
+  OrderStatus$outboundSchema = OrderStatus$inboundSchema;
+  ((OrderStatus$) => {
+    OrderStatus$.inboundSchema = OrderStatus$inboundSchema;
+    OrderStatus$.outboundSchema = OrderStatus$outboundSchema;
+  })(OrderStatus$ ||= {});
+});
+
 // src/models/components/customercancellationreason.ts
 var CustomerCancellationReason, CustomerCancellationReason$inboundSchema, CustomerCancellationReason$outboundSchema, CustomerCancellationReason$;
 var init_customercancellationreason = __esm(() => {
@@ -39772,6 +39819,7 @@ var init_order = __esm(() => {
   init_ordercustomer();
   init_orderitemschema();
   init_orderproduct();
+  init_orderstatus();
   init_ordersubscription();
   init_orderuser();
   init_productprice();
@@ -39836,7 +39884,8 @@ var init_order = __esm(() => {
       booleanType(),
       stringType().datetime({ offset: true }).transform((v2) => new Date(v2))
     ]))).optional(),
-    status: stringType(),
+    status: OrderStatus$inboundSchema,
+    paid: booleanType(),
     subtotal_amount: numberType().int(),
     discount_amount: numberType().int(),
     net_amount: numberType().int(),
@@ -39905,7 +39954,8 @@ var init_order = __esm(() => {
       booleanType(),
       dateType().transform((v2) => v2.toISOString())
     ]))).optional(),
-    status: stringType(),
+    status: OrderStatus$outboundSchema,
+    paid: booleanType(),
     subtotalAmount: numberType().int(),
     discountAmount: numberType().int(),
     netAmount: numberType().int(),
@@ -44198,7 +44248,7 @@ Update a subscription.
 function createMCPServer(deps) {
   const server = new McpServer({
     name: "Polar",
-    version: "0.31.0"
+    version: "0.32.0"
   });
   const client = new PolarCore({
     accessToken: deps.accessToken,
@@ -44210,7 +44260,8 @@ function createMCPServer(deps) {
   const tool = createRegisterTool(deps.logger, server, client, scopes, allowedTools);
   const resource = createRegisterResource(deps.logger, server, client, scopes);
   const resourceTemplate = createRegisterResourceTemplate(deps.logger, server, client, scopes);
-  const register = { tool, resource, resourceTemplate };
+  const prompt = createRegisterPrompt(deps.logger, server, client, scopes);
+  const register = { tool, resource, resourceTemplate, prompt };
   tool(tool$subscriptionsList);
   tool(tool$subscriptionsExport);
   tool(tool$subscriptionsGet);
@@ -45459,7 +45510,7 @@ var routes = rn({
 var app = Ve(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.31.0"
+    currentVersion: "0.32.0"
   }
 });
 _t(app, process3.argv.slice(2), buildContext(process3));
@@ -45467,5 +45518,5 @@ export {
   app
 };
 
-//# debugId=8983B3A39A7C81B464756E2164756E21
+//# debugId=69367A66FF791C5664756E2164756E21
 //# sourceMappingURL=mcp-server.js.map