@polar-sh/sdk 0.26.0 → 0.27.0

package/src/mcp-server/tools/repositoriesGet.ts

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { repositoriesGet } from "../../funcs/repositoriesGet.js";
+import { RepositoriesGetRequest$inboundSchema } from "../../models/operations/repositoriesget.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: RepositoriesGetRequest$inboundSchema,
+};
+
+export const tool$repositoriesGet: ToolDefinition<typeof args> = {
+  name: "repositories_get",
+  description: `Get Repository
+
+Get a repository by ID.
+
+**Scopes**: \`repositories:read\` \`repositories:write\``,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await repositoriesGet(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/repositoriesList.ts

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { repositoriesList } from "../../funcs/repositoriesList.js";
+import { RepositoriesListRequest$inboundSchema } from "../../models/operations/repositorieslist.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: RepositoriesListRequest$inboundSchema,
+};
+
+export const tool$repositoriesList: ToolDefinition<typeof args> = {
+  name: "repositories_list",
+  description: `List Repositories
+
+List repositories.
+
+**Scopes**: \`repositories:read\` \`repositories:write\``,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await repositoriesList(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value.result;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/repositoriesUpdate.ts

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { repositoriesUpdate } from "../../funcs/repositoriesUpdate.js";
+import { RepositoriesUpdateRequest$inboundSchema } from "../../models/operations/repositoriesupdate.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: RepositoriesUpdateRequest$inboundSchema,
+};
+
+export const tool$repositoriesUpdate: ToolDefinition<typeof args> = {
+  name: "repositories_update",
+  description: `Update Repository
+
+Update a repository.
+
+**Scopes**: \`repositories:write\``,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await repositoriesUpdate(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/subscriptionsExport.ts

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { subscriptionsExport } from "../../funcs/subscriptionsExport.js";
+import { SubscriptionsExportRequest$inboundSchema } from "../../models/operations/subscriptionsexport.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: SubscriptionsExportRequest$inboundSchema,
+};
+
+export const tool$subscriptionsExport: ToolDefinition<typeof args> = {
+  name: "subscriptions_export",
+  description: `Export Subscriptions
+
+Export subscriptions as a CSV file.
+
+**Scopes**: \`subscriptions:read\` \`subscriptions:write\``,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await subscriptionsExport(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/subscriptionsGet.ts

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { subscriptionsGet } from "../../funcs/subscriptionsGet.js";
+import { SubscriptionsGetRequest$inboundSchema } from "../../models/operations/subscriptionsget.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: SubscriptionsGetRequest$inboundSchema,
+};
+
+export const tool$subscriptionsGet: ToolDefinition<typeof args> = {
+  name: "subscriptions_get",
+  description: `Get Subscription
+
+Get a subscription by ID.
+
+**Scopes**: \`subscriptions:write\``,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await subscriptionsGet(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/subscriptionsList.ts

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { subscriptionsList } from "../../funcs/subscriptionsList.js";
+import { SubscriptionsListRequest$inboundSchema } from "../../models/operations/subscriptionslist.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: SubscriptionsListRequest$inboundSchema,
+};
+
+export const tool$subscriptionsList: ToolDefinition<typeof args> = {
+  name: "subscriptions_list",
+  description: `List Subscriptions
+
+List subscriptions.
+
+**Scopes**: \`subscriptions:read\` \`subscriptions:write\``,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await subscriptionsList(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value.result;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/subscriptionsRevoke.ts

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { subscriptionsRevoke } from "../../funcs/subscriptionsRevoke.js";
+import { SubscriptionsRevokeRequest$inboundSchema } from "../../models/operations/subscriptionsrevoke.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: SubscriptionsRevokeRequest$inboundSchema,
+};
+
+export const tool$subscriptionsRevoke: ToolDefinition<typeof args> = {
+  name: "subscriptions_revoke",
+  description: `Revoke Subscription
+
+Revoke a subscription, i.e cancel immediately.
+
+**Scopes**: \`subscriptions:write\``,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await subscriptionsRevoke(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/subscriptionsUpdate.ts

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { subscriptionsUpdate } from "../../funcs/subscriptionsUpdate.js";
+import { SubscriptionsUpdateRequest$inboundSchema } from "../../models/operations/subscriptionsupdate.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: SubscriptionsUpdateRequest$inboundSchema,
+};
+
+export const tool$subscriptionsUpdate: ToolDefinition<typeof args> = {
+  name: "subscriptions_update",
+  description: `Update Subscription
+
+Update a subscription.
+
+**Scopes**: \`subscriptions:write\``,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await subscriptionsUpdate(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools.ts

@@ -0,0 +1,116 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { objectOutputType, ZodRawShape, ZodTypeAny } from "zod";
+import { PolarCore } from "../core.js";
+import { ConsoleLogger } from "./console-logger.js";
+import { MCPScope } from "./scopes.js";
+import { isAsyncIterable, isBinaryData, valueToBase64 } from "./shared.js";
+
+export type ToolDefinition<Args extends undefined | ZodRawShape = undefined> =
+  Args extends ZodRawShape ? {
+      name: string;
+      description: string;
+      scopes?: MCPScope[];
+      args: Args;
+      tool: (
+        client: PolarCore,
+        args: objectOutputType<Args, ZodTypeAny>,
+        extra: RequestHandlerExtra,
+      ) => CallToolResult | Promise<CallToolResult>;
+    }
+    : {
+      name: string;
+      description: string;
+      scopes?: MCPScope[];
+      args?: undefined;
+      tool: (
+        client: PolarCore,
+        extra: RequestHandlerExtra,
+      ) => CallToolResult | Promise<CallToolResult>;
+    };
+
+export async function formatResult(
+  value: unknown,
+  init: { response?: Response | undefined },
+): Promise<CallToolResult> {
+  if (typeof value === "undefined") {
+    return { content: [] };
+  }
+
+  const { response } = init;
+  const contentType = response?.headers.get("content-type") ?? "";
+  let content: CallToolResult["content"] = [];
+
+  if (contentType.search(/\bjson\b/g)) {
+    content = [{ type: "text", text: JSON.stringify(value) }];
+  } else if (
+    contentType.startsWith("text/event-stream")
+    && isAsyncIterable(value)
+  ) {
+    content = await consumeSSE(value);
+  } else if (contentType.startsWith("text/") && typeof value === "string") {
+    content = [{ type: "text", text: value }];
+  } else if (isBinaryData(value) && contentType.startsWith("image/")) {
+    const data = await valueToBase64(value);
+    content = data == null
+      ? []
+      : [{ type: "image", data, mimeType: contentType }];
+  } else {
+    return {
+      content: [{
+        type: "text",
+        text: `Unsupported content type: "${contentType}"`,
+      }],
+      isError: true,
+    };
+  }
+
+  return { content };
+}
+
+async function consumeSSE(
+  value: AsyncIterable<unknown>,
+): Promise<CallToolResult["content"]> {
+  const content: CallToolResult["content"] = [];
+
+  for await (const chunk of value) {
+    if (typeof chunk === "string") {
+      content.push({ type: "text", text: chunk });
+    } else {
+      content.push({ type: "text", text: JSON.stringify(chunk) });
+    }
+  }
+
+  return content;
+}
+
+export function createRegisterTool(
+  logger: ConsoleLogger,
+  server: McpServer,
+  sdk: PolarCore,
+  allowedScopes: Set<MCPScope>,
+): <A extends ZodRawShape | undefined>(tool: ToolDefinition<A>) => void {
+  return <A extends ZodRawShape | undefined>(tool: ToolDefinition<A>): void => {
+    const toolScopes = tool.scopes ?? [];
+    if (!toolScopes.every((s) => allowedScopes.has(s))) {
+      return;
+    }
+
+    if (tool.args) {
+      server.tool(tool.name, tool.description, tool.args, async (args, ctx) => {
+        return tool.tool(sdk, args, ctx);
+      });
+    } else {
+      server.tool(tool.name, tool.description, async (ctx) => {
+        return tool.tool(sdk, ctx);
+      });
+    }
+
+    logger.debug("Registered tool", { name: tool.name });
+  };
+}

package/src/models/components/checkout.ts

@@ -109,7 +109,7 @@ export type Checkout = {
    * Key-value object storing custom field values.
    */
   customFieldData?:
-    | { [k: string]: string | number | boolean | Date }
+    | { [k: string]: string | number | boolean | Date | null }
     | undefined;
   paymentProcessor: PaymentProcessor;
   status: CheckoutStatus;
@@ -511,12 +511,14 @@ export const Checkout$inboundSchema: z.ZodType<
   ),
   id: z.string(),
   custom_field_data: z.record(
-    z.union([
-      z.string(),
-      z.number().int(),
-      z.boolean(),
-      z.string().datetime({ offset: true }).transform(v => new Date(v)),
-    ]),
+    z.nullable(
+      z.union([
+        z.string(),
+        z.number().int(),
+        z.boolean(),
+        z.string().datetime({ offset: true }).transform(v => new Date(v)),
+      ]),
+    ),
   ).optional(),
   payment_processor: PaymentProcessor$inboundSchema,
   status: CheckoutStatus$inboundSchema,
@@ -608,7 +610,7 @@ export type Checkout$Outbound = {
   modified_at: string | null;
   id: string;
   custom_field_data?:
-    | { [k: string]: string | number | boolean | string }
+    | { [k: string]: string | number | boolean | string | null }
     | undefined;
   payment_processor: string;
   status: string;
@@ -663,12 +665,14 @@ export const Checkout$outboundSchema: z.ZodType<
   modifiedAt: z.nullable(z.date().transform(v => v.toISOString())),
   id: z.string(),
   customFieldData: z.record(
-    z.union([
-      z.string(),
-      z.number().int(),
-      z.boolean(),
-      z.date().transform(v => v.toISOString()),
-    ]),
+    z.nullable(
+      z.union([
+        z.string(),
+        z.number().int(),
+        z.boolean(),
+        z.date().transform(v => v.toISOString()),
+      ]),
+    ),
   ).optional(),
   paymentProcessor: PaymentProcessor$outboundSchema,
   status: CheckoutStatus$outboundSchema,

package/src/models/components/checkoutconfirmstripe.ts

@@ -28,7 +28,7 @@ export type CheckoutConfirmStripe = {
    * Key-value object storing custom field values.
    */
   customFieldData?:
-    | { [k: string]: string | number | boolean | Date }
+    | { [k: string]: string | number | boolean | Date | null }
     | undefined;
   /**
    * ID of the product to checkout. Must be present in the checkout's product list.
@@ -129,12 +129,14 @@ export const CheckoutConfirmStripe$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   custom_field_data: z.record(
-    z.union([
-      z.string(),
-      z.number().int(),
-      z.boolean(),
-      z.string().datetime({ offset: true }).transform(v => new Date(v)),
-    ]),
+    z.nullable(
+      z.union([
+        z.string(),
+        z.number().int(),
+        z.boolean(),
+        z.string().datetime({ offset: true }).transform(v => new Date(v)),
+      ]),
+    ),
   ).optional(),
   product_id: z.nullable(z.string()).optional(),
   product_price_id: z.nullable(z.string()).optional(),
@@ -162,7 +164,7 @@ export const CheckoutConfirmStripe$inboundSchema: z.ZodType<
 /** @internal */
 export type CheckoutConfirmStripe$Outbound = {
   custom_field_data?:
-    | { [k: string]: string | number | boolean | string }
+    | { [k: string]: string | number | boolean | string | null }
     | undefined;
   product_id?: string | null | undefined;
   product_price_id?: string | null | undefined;
@@ -182,12 +184,14 @@ export const CheckoutConfirmStripe$outboundSchema: z.ZodType<
   CheckoutConfirmStripe
 > = z.object({
   customFieldData: z.record(
-    z.union([
-      z.string(),
-      z.number().int(),
-      z.boolean(),
-      z.date().transform(v => v.toISOString()),
-    ]),
+    z.nullable(
+      z.union([
+        z.string(),
+        z.number().int(),
+        z.boolean(),
+        z.date().transform(v => v.toISOString()),
+      ]),
+    ),
   ).optional(),
   productId: z.nullable(z.string()).optional(),
   productPriceId: z.nullable(z.string()).optional(),

package/src/models/components/checkoutpricecreate.ts

@@ -54,7 +54,7 @@ export type CheckoutPriceCreate = {
    * Key-value object storing custom field values.
    */
   customFieldData?:
-    | { [k: string]: string | number | boolean | Date }
+    | { [k: string]: string | number | boolean | Date | null }
     | undefined;
   /**
    * ID of the discount to apply to the checkout.
@@ -288,12 +288,14 @@ export const CheckoutPriceCreate$inboundSchema: z.ZodType<
   metadata: z.record(z.union([z.string(), z.number().int(), z.boolean()]))
     .optional(),
   custom_field_data: z.record(
-    z.union([
-      z.string(),
-      z.number().int(),
-      z.boolean(),
-      z.string().datetime({ offset: true }).transform(v => new Date(v)),
-    ]),
+    z.nullable(
+      z.union([
+        z.string(),
+        z.number().int(),
+        z.boolean(),
+        z.string().datetime({ offset: true }).transform(v => new Date(v)),
+      ]),
+    ),
   ).optional(),
   discount_id: z.nullable(z.string()).optional(),
   allow_discount_codes: z.boolean().default(true),
@@ -334,7 +336,7 @@ export const CheckoutPriceCreate$inboundSchema: z.ZodType<
 export type CheckoutPriceCreate$Outbound = {
   metadata?: { [k: string]: string | number | boolean } | undefined;
   custom_field_data?:
-    | { [k: string]: string | number | boolean | string }
+    | { [k: string]: string | number | boolean | string | null }
     | undefined;
   discount_id?: string | null | undefined;
   allow_discount_codes: boolean;
@@ -361,12 +363,14 @@ export const CheckoutPriceCreate$outboundSchema: z.ZodType<
   metadata: z.record(z.union([z.string(), z.number().int(), z.boolean()]))
     .optional(),
   customFieldData: z.record(
-    z.union([
-      z.string(),
-      z.number().int(),
-      z.boolean(),
-      z.date().transform(v => v.toISOString()),
-    ]),
+    z.nullable(
+      z.union([
+        z.string(),
+        z.number().int(),
+        z.boolean(),
+        z.date().transform(v => v.toISOString()),
+      ]),
+    ),
   ).optional(),
   discountId: z.nullable(z.string()).optional(),
   allowDiscountCodes: z.boolean().default(true),

package/src/models/components/checkoutproductcreate.ts

@@ -54,7 +54,7 @@ export type CheckoutProductCreate = {
    * Key-value object storing custom field values.
    */
   customFieldData?:
-    | { [k: string]: string | number | boolean | Date }
+    | { [k: string]: string | number | boolean | Date | null }
     | undefined;
   /**
    * ID of the discount to apply to the checkout.
@@ -289,12 +289,14 @@ export const CheckoutProductCreate$inboundSchema: z.ZodType<
   metadata: z.record(z.union([z.string(), z.number().int(), z.boolean()]))
     .optional(),
   custom_field_data: z.record(
-    z.union([
-      z.string(),
-      z.number().int(),
-      z.boolean(),
-      z.string().datetime({ offset: true }).transform(v => new Date(v)),
-    ]),
+    z.nullable(
+      z.union([
+        z.string(),
+        z.number().int(),
+        z.boolean(),
+        z.string().datetime({ offset: true }).transform(v => new Date(v)),
+      ]),
+    ),
   ).optional(),
   discount_id: z.nullable(z.string()).optional(),
   allow_discount_codes: z.boolean().default(true),
@@ -335,7 +337,7 @@ export const CheckoutProductCreate$inboundSchema: z.ZodType<
 export type CheckoutProductCreate$Outbound = {
   metadata?: { [k: string]: string | number | boolean } | undefined;
   custom_field_data?:
-    | { [k: string]: string | number | boolean | string }
+    | { [k: string]: string | number | boolean | string | null }
     | undefined;
   discount_id?: string | null | undefined;
   allow_discount_codes: boolean;
@@ -362,12 +364,14 @@ export const CheckoutProductCreate$outboundSchema: z.ZodType<
   metadata: z.record(z.union([z.string(), z.number().int(), z.boolean()]))
     .optional(),
   customFieldData: z.record(
-    z.union([
-      z.string(),
-      z.number().int(),
-      z.boolean(),
-      z.date().transform(v => v.toISOString()),
-    ]),
+    z.nullable(
+      z.union([
+        z.string(),
+        z.number().int(),
+        z.boolean(),
+        z.date().transform(v => v.toISOString()),
+      ]),
+    ),
   ).optional(),
   discountId: z.nullable(z.string()).optional(),
   allowDiscountCodes: z.boolean().default(true),