@polar-sh/sdk 0.32.13 → 0.32.15

package/src/funcs/checkoutsList.ts

@@ -111,11 +111,14 @@ async function $do(
   const path = pathToFunc("/v1/checkouts/")();
 
   const query = encodeFormQuery({
+    "customer_id": payload.customer_id,
     "limit": payload.limit,
     "organization_id": payload.organization_id,
     "page": payload.page,
     "product_id": payload.product_id,
+    "query": payload.query,
     "sorting": payload.sorting,
+    "status": payload.status,
   });
 
   const headers = new Headers(compactMap({

package/src/funcs/licenseKeysList.ts

@@ -120,7 +120,7 @@ async function $do(
   const payload = parsed.value;
   const body = null;
 
-  const path = pathToFunc("/v1/license-keys")();
+  const path = pathToFunc("/v1/license-keys/")();
 
   const query = encodeFormQuery({
     "benefit_id": payload.benefit_id,

package/src/funcs/ordersList.ts

@@ -4,7 +4,11 @@
 
 import { PolarCore } from "../core.js";
 import { dlv } from "../lib/dlv.js";
-import { encodeFormQuery } from "../lib/encodings.js";
+import {
+  encodeDeepObjectQuery,
+  encodeFormQuery,
+  queryJoin,
+} from "../lib/encodings.js";
 import * as M from "../lib/matchers.js";
 import { compactMap } from "../lib/primitives.js";
 import { safeParse } from "../lib/schemas.js";
@@ -110,17 +114,22 @@ async function $do(
 
   const path = pathToFunc("/v1/orders/")();
 
-  const query = encodeFormQuery({
-    "checkout_id": payload.checkout_id,
-    "customer_id": payload.customer_id,
-    "discount_id": payload.discount_id,
-    "limit": payload.limit,
-    "organization_id": payload.organization_id,
-    "page": payload.page,
-    "product_billing_type": payload.product_billing_type,
-    "product_id": payload.product_id,
-    "sorting": payload.sorting,
-  });
+  const query = queryJoin(
+    encodeDeepObjectQuery({
+      "metadata": payload.metadata,
+    }),
+    encodeFormQuery({
+      "checkout_id": payload.checkout_id,
+      "customer_id": payload.customer_id,
+      "discount_id": payload.discount_id,
+      "limit": payload.limit,
+      "organization_id": payload.organization_id,
+      "page": payload.page,
+      "product_billing_type": payload.product_billing_type,
+      "product_id": payload.product_id,
+      "sorting": payload.sorting,
+    }),
+  );
 
   const headers = new Headers(compactMap({
     Accept: "application/json",

package/src/funcs/paymentsGet.ts

@@ -0,0 +1,189 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { PolarCore } from "../core.js";
+import { encodeSimple } from "../lib/encodings.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import {
+  Payment,
+  Payment$inboundSchema,
+} from "../models/components/payment.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import {
+  HTTPValidationError,
+  HTTPValidationError$inboundSchema,
+} from "../models/errors/httpvalidationerror.js";
+import {
+  ResourceNotFound,
+  ResourceNotFound$inboundSchema,
+} from "../models/errors/resourcenotfound.js";
+import { SDKError } from "../models/errors/sdkerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import {
+  PaymentsGetRequest,
+  PaymentsGetRequest$outboundSchema,
+} from "../models/operations/paymentsget.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Get Payment
+ *
+ * @remarks
+ * Get a payment by ID.
+ *
+ * **Scopes**: `payments:read`
+ */
+export function paymentsGet(
+  client: PolarCore,
+  request: PaymentsGetRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    Payment,
+    | ResourceNotFound
+    | HTTPValidationError
+    | SDKError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: PolarCore,
+  request: PaymentsGetRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      Payment,
+      | ResourceNotFound
+      | HTTPValidationError
+      | SDKError
+      | SDKValidationError
+      | UnexpectedClientError
+      | InvalidRequestError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | ConnectionError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) => PaymentsGetRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    id: encodeSimple("id", payload.id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+
+  const path = pathToFunc("/v1/payments/{id}")(pathParams);
+
+  const headers = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.accessToken);
+  const securityInput = secConfig == null ? {} : { accessToken: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "payments:get",
+    oAuth2Scopes: [],
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.accessToken,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "GET",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    body: body,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    errorCodes: ["404", "422", "4XX", "5XX"],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result] = await M.match<
+    Payment,
+    | ResourceNotFound
+    | HTTPValidationError
+    | SDKError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >(
+    M.json(200, Payment$inboundSchema),
+    M.jsonErr(404, ResourceNotFound$inboundSchema),
+    M.jsonErr(422, HTTPValidationError$inboundSchema),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/funcs/paymentsList.ts

@@ -0,0 +1,257 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { PolarCore } from "../core.js";
+import { dlv } from "../lib/dlv.js";
+import { encodeFormQuery } from "../lib/encodings.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import {
+  HTTPValidationError,
+  HTTPValidationError$inboundSchema,
+} from "../models/errors/httpvalidationerror.js";
+import { SDKError } from "../models/errors/sdkerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import {
+  PaymentsListRequest,
+  PaymentsListRequest$outboundSchema,
+  PaymentsListResponse,
+  PaymentsListResponse$inboundSchema,
+} from "../models/operations/paymentslist.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+import {
+  createPageIterator,
+  haltIterator,
+  PageIterator,
+  Paginator,
+} from "../types/operations.js";
+
+/**
+ * List Payments
+ *
+ * @remarks
+ * List payments.
+ *
+ * **Scopes**: `payments:read`
+ */
+export function paymentsList(
+  client: PolarCore,
+  request: PaymentsListRequest,
+  options?: RequestOptions,
+): APIPromise<
+  PageIterator<
+    Result<
+      PaymentsListResponse,
+      | HTTPValidationError
+      | SDKError
+      | SDKValidationError
+      | UnexpectedClientError
+      | InvalidRequestError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | ConnectionError
+    >,
+    { page: number }
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: PolarCore,
+  request: PaymentsListRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    PageIterator<
+      Result<
+        PaymentsListResponse,
+        | HTTPValidationError
+        | SDKError
+        | SDKValidationError
+        | UnexpectedClientError
+        | InvalidRequestError
+        | RequestAbortedError
+        | RequestTimeoutError
+        | ConnectionError
+      >,
+      { page: number }
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) => PaymentsListRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [haltIterator(parsed), { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const path = pathToFunc("/v1/payments/")();
+
+  const query = encodeFormQuery({
+    "checkout_id": payload.checkout_id,
+    "customer_email": payload.customer_email,
+    "limit": payload.limit,
+    "method": payload.method,
+    "order_id": payload.order_id,
+    "organization_id": payload.organization_id,
+    "page": payload.page,
+    "sorting": payload.sorting,
+    "status": payload.status,
+  });
+
+  const headers = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.accessToken);
+  const securityInput = secConfig == null ? {} : { accessToken: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "payments:list",
+    oAuth2Scopes: [],
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.accessToken,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "GET",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    query: query,
+    body: body,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [haltIterator(requestRes), { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    errorCodes: ["422", "4XX", "5XX"],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [haltIterator(doResult), { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result, raw] = await M.match<
+    PaymentsListResponse,
+    | HTTPValidationError
+    | SDKError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >(
+    M.json(200, PaymentsListResponse$inboundSchema, { key: "Result" }),
+    M.jsonErr(422, HTTPValidationError$inboundSchema),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, { extraFields: responseFields });
+  if (!result.ok) {
+    return [haltIterator(result), {
+      status: "complete",
+      request: req,
+      response,
+    }];
+  }
+
+  const nextFunc = (
+    responseData: unknown,
+  ): {
+    next: Paginator<
+      Result<
+        PaymentsListResponse,
+        | HTTPValidationError
+        | SDKError
+        | SDKValidationError
+        | UnexpectedClientError
+        | InvalidRequestError
+        | RequestAbortedError
+        | RequestTimeoutError
+        | ConnectionError
+      >
+    >;
+    "~next"?: { page: number };
+  } => {
+    const page = request?.page ?? 1;
+    const nextPage = page + 1;
+    const numPages = dlv(responseData, "pagination.max_page");
+    if (typeof numPages !== "number" || numPages <= page) {
+      return { next: () => null };
+    }
+
+    if (!responseData) {
+      return { next: () => null };
+    }
+    const results = dlv(responseData, "items");
+    if (!Array.isArray(results) || !results.length) {
+      return { next: () => null };
+    }
+    const limit = request?.limit ?? 10;
+    if (results.length < limit) {
+      return { next: () => null };
+    }
+
+    const nextVal = () =>
+      paymentsList(
+        client,
+        {
+          ...request,
+          page: nextPage,
+        },
+        options,
+      );
+
+    return { next: nextVal, "~next": { page: nextPage } };
+  };
+
+  const page = { ...result, ...nextFunc(raw) };
+  return [{ ...page, ...createPageIterator(page, (v) => !v.ok) }, {
+    status: "complete",
+    request: req,
+    response,
+  }];
+}

package/src/funcs/subscriptionsList.ts

@@ -4,7 +4,11 @@
 
 import { PolarCore } from "../core.js";
 import { dlv } from "../lib/dlv.js";
-import { encodeFormQuery } from "../lib/encodings.js";
+import {
+  encodeDeepObjectQuery,
+  encodeFormQuery,
+  queryJoin,
+} from "../lib/encodings.js";
 import * as M from "../lib/matchers.js";
 import { compactMap } from "../lib/primitives.js";
 import { safeParse } from "../lib/schemas.js";
@@ -110,16 +114,21 @@ async function $do(
 
   const path = pathToFunc("/v1/subscriptions/")();
 
-  const query = encodeFormQuery({
-    "active": payload.active,
-    "customer_id": payload.customer_id,
-    "discount_id": payload.discount_id,
-    "limit": payload.limit,
-    "organization_id": payload.organization_id,
-    "page": payload.page,
-    "product_id": payload.product_id,
-    "sorting": payload.sorting,
-  });
+  const query = queryJoin(
+    encodeDeepObjectQuery({
+      "metadata": payload.metadata,
+    }),
+    encodeFormQuery({
+      "active": payload.active,
+      "customer_id": payload.customer_id,
+      "discount_id": payload.discount_id,
+      "limit": payload.limit,
+      "organization_id": payload.organization_id,
+      "page": payload.page,
+      "product_id": payload.product_id,
+      "sorting": payload.sorting,
+    }),
+  );
 
   const headers = new Headers(compactMap({
     Accept: "application/json",

package/src/lib/config.ts

@@ -60,7 +60,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "0.1.0",
-  sdkVersion: "0.32.13",
-  genVersion: "2.593.4",
-  userAgent: "speakeasy-sdk/typescript 0.32.13 2.593.4 0.1.0 @polar-sh/sdk",
+  sdkVersion: "0.32.15",
+  genVersion: "2.603.1",
+  userAgent: "speakeasy-sdk/typescript 0.32.15 2.603.1 0.1.0 @polar-sh/sdk",
 } as const;

package/src/lib/sdks.ts

@@ -47,12 +47,14 @@ export type RequestOptions = {
    */
   serverURL?: string | URL;
   /**
+   * @deprecated `fetchOptions` has been flattened into `RequestOptions`.
+   *
    * Sets various request options on the `fetch` call made by an SDK method.
    *
    * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options|Request}
    */
   fetchOptions?: Omit<RequestInit, "method" | "body">;
-};
+} & Omit<RequestInit, "method" | "body">;
 
 type RequestConfig = {
   method: string;
@@ -172,7 +174,9 @@ export class ClientSDK {
     cookie = cookie.startsWith("; ") ? cookie.slice(2) : cookie;
     headers.set("cookie", cookie);
 
-    const userHeaders = new Headers(options?.fetchOptions?.headers);
+    const userHeaders = new Headers(
+      options?.headers ?? options?.fetchOptions?.headers,
+    );
     for (const [k, v] of userHeaders) {
       headers.set(k, v);
     }
@@ -183,20 +187,16 @@ export class ClientSDK {
       headers.set(conf.uaHeader ?? "user-agent", SDK_METADATA.userAgent);
     }
 
-    let fetchOptions = options?.fetchOptions;
+    const fetchOptions: Omit<RequestInit, "method" | "body"> = {
+      ...options?.fetchOptions,
+      ...options,
+    };
     if (!fetchOptions?.signal && conf.timeoutMs && conf.timeoutMs > 0) {
       const timeoutSignal = AbortSignal.timeout(conf.timeoutMs);
-      if (!fetchOptions) {
-        fetchOptions = { signal: timeoutSignal };
-      } else {
-        fetchOptions.signal = timeoutSignal;
-      }
+      fetchOptions.signal = timeoutSignal;
     }
 
     if (conf.body instanceof ReadableStream) {
-      if (!fetchOptions) {
-        fetchOptions = {};
-      }
       Object.assign(fetchOptions, { duplex: "half" });
     }
 

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

@@ -19,7 +19,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.32.13",
+    currentVersion: "0.32.15",
   },
 });
 

package/src/mcp-server/scopes.ts

@@ -7,6 +7,7 @@ export const mcpScopes = [
   "customers",
   "metrics",
   "orders",
+  "payments",
   "products",
   "read",
   "subscriptions",

package/src/mcp-server/server.ts

@@ -30,6 +30,8 @@ import { tool$metricsLimits } from "./tools/metricsLimits.js";
 import { tool$ordersGet } from "./tools/ordersGet.js";
 import { tool$ordersInvoice } from "./tools/ordersInvoice.js";
 import { tool$ordersList } from "./tools/ordersList.js";
+import { tool$paymentsGet } from "./tools/paymentsGet.js";
+import { tool$paymentsList } from "./tools/paymentsList.js";
 import { tool$productsCreate } from "./tools/productsCreate.js";
 import { tool$productsGet } from "./tools/productsGet.js";
 import { tool$productsList } from "./tools/productsList.js";
@@ -51,7 +53,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "Polar",
-    version: "0.32.13",
+    version: "0.32.15",
   });
 
   const client = new PolarCore({
@@ -108,6 +110,8 @@ export function createMCPServer(deps: {
   tool(tool$customersGetStateExternal);
   tool(tool$customerMetersList);
   tool(tool$customerMetersGet);
+  tool(tool$paymentsList);
+  tool(tool$paymentsGet);
 
   return server;
 }