@polar-sh/sdk 0.32.13 → 0.32.14

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/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.14",
+  genVersion: "2.599.0",
+  userAgent: "speakeasy-sdk/typescript 0.32.14 2.599.0 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.14",
   },
 });
 

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.14",
   });
 
   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;
 }

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

@@ -0,0 +1,40 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { paymentsGet } from "../../funcs/paymentsGet.js";
+import { PaymentsGetRequest$inboundSchema } from "../../models/operations/paymentsget.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: PaymentsGetRequest$inboundSchema,
+};
+
+export const tool$paymentsGet: ToolDefinition<typeof args> = {
+  name: "payments-get",
+  description: `Get Payment
+
+Get a payment by ID.
+
+**Scopes**: \`payments:read\``,
+  scopes: ["read", "payments"],
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await paymentsGet(
+      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/paymentsList.ts

@@ -0,0 +1,40 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { paymentsList } from "../../funcs/paymentsList.js";
+import { PaymentsListRequest$inboundSchema } from "../../models/operations/paymentslist.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: PaymentsListRequest$inboundSchema,
+};
+
+export const tool$paymentsList: ToolDefinition<typeof args> = {
+  name: "payments-list",
+  description: `List Payments
+
+List payments.
+
+**Scopes**: \`payments:read\``,
+  scopes: ["read", "payments"],
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await paymentsList(
+      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/models/components/benefitmetercreditcreateproperties.ts

@@ -13,6 +13,7 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
  */
 export type BenefitMeterCreditCreateProperties = {
   units: number;
+  rollover: boolean;
   meterId: string;
 };
 
@@ -23,6 +24,7 @@ export const BenefitMeterCreditCreateProperties$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   units: z.number().int(),
+  rollover: z.boolean(),
   meter_id: z.string(),
 }).transform((v) => {
   return remap$(v, {
@@ -33,6 +35,7 @@ export const BenefitMeterCreditCreateProperties$inboundSchema: z.ZodType<
 /** @internal */
 export type BenefitMeterCreditCreateProperties$Outbound = {
   units: number;
+  rollover: boolean;
   meter_id: string;
 };
 
@@ -43,6 +46,7 @@ export const BenefitMeterCreditCreateProperties$outboundSchema: z.ZodType<
   BenefitMeterCreditCreateProperties
 > = z.object({
   units: z.number().int(),
+  rollover: z.boolean(),
   meterId: z.string(),
 }).transform((v) => {
   return remap$(v, {

package/src/models/components/benefitmetercreditproperties.ts

@@ -13,6 +13,7 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
  */
 export type BenefitMeterCreditProperties = {
   units: number;
+  rollover: boolean;
   meterId: string;
 };
 
@@ -23,6 +24,7 @@ export const BenefitMeterCreditProperties$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   units: z.number().int(),
+  rollover: z.boolean(),
   meter_id: z.string(),
 }).transform((v) => {
   return remap$(v, {
@@ -33,6 +35,7 @@ export const BenefitMeterCreditProperties$inboundSchema: z.ZodType<
 /** @internal */
 export type BenefitMeterCreditProperties$Outbound = {
   units: number;
+  rollover: boolean;
   meter_id: string;
 };
 
@@ -43,6 +46,7 @@ export const BenefitMeterCreditProperties$outboundSchema: z.ZodType<
   BenefitMeterCreditProperties
 > = z.object({
   units: z.number().int(),
+  rollover: z.boolean(),
   meterId: z.string(),
 }).transform((v) => {
   return remap$(v, {

package/src/models/components/benefitmetercreditsubscriberproperties.ts

@@ -13,6 +13,7 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
  */
 export type BenefitMeterCreditSubscriberProperties = {
   units: number;
+  rollover: boolean;
   meterId: string;
 };
 
@@ -23,6 +24,7 @@ export const BenefitMeterCreditSubscriberProperties$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   units: z.number().int(),
+  rollover: z.boolean(),
   meter_id: z.string(),
 }).transform((v) => {
   return remap$(v, {
@@ -33,6 +35,7 @@ export const BenefitMeterCreditSubscriberProperties$inboundSchema: z.ZodType<
 /** @internal */
 export type BenefitMeterCreditSubscriberProperties$Outbound = {
   units: number;
+  rollover: boolean;
   meter_id: string;
 };
 
@@ -43,6 +46,7 @@ export const BenefitMeterCreditSubscriberProperties$outboundSchema: z.ZodType<
   BenefitMeterCreditSubscriberProperties
 > = z.object({
   units: z.number().int(),
+  rollover: z.boolean(),
   meterId: z.string(),
 }).transform((v) => {
   return remap$(v, {