@polar-sh/sdk 0.43.0 → 0.44.0

package/src/funcs/customerPortalMembersListMembers.ts

@@ -4,15 +4,14 @@
 
 import * as z from "zod/v4-mini";
 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 {
-  CustomerPortalMember,
-  CustomerPortalMember$inboundSchema,
-} from "../models/components/customerportalmember.js";
 import {
   ConnectionError,
   InvalidRequestError,
@@ -20,11 +19,27 @@ import {
   RequestTimeoutError,
   UnexpectedClientError,
 } from "../models/errors/httpclienterrors.js";
+import {
+  HTTPValidationError,
+  HTTPValidationError$inboundSchema,
+} from "../models/errors/httpvalidationerror.js";
 import { PolarError } from "../models/errors/polarerror.js";
 import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
 import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import {
+  CustomerPortalMembersListMembersRequest,
+  CustomerPortalMembersListMembersRequest$outboundSchema,
+  CustomerPortalMembersListMembersResponse,
+  CustomerPortalMembersListMembersResponse$inboundSchema,
+} from "../models/operations/customerportalmemberslistmembers.js";
 import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
+import {
+  createPageIterator,
+  haltIterator,
+  PageIterator,
+  Paginator,
+} from "../types/operations.js";
 
 /**
  * List Members
@@ -36,47 +51,75 @@ import { Result } from "../types/fp.js";
  */
 export function customerPortalMembersListMembers(
   client: PolarCore,
+  request: CustomerPortalMembersListMembersRequest,
   options?: RequestOptions,
 ): APIPromise<
-  Result<
-    Array<CustomerPortalMember>,
-    | PolarError
-    | ResponseValidationError
-    | ConnectionError
-    | RequestAbortedError
-    | RequestTimeoutError
-    | InvalidRequestError
-    | UnexpectedClientError
-    | SDKValidationError
+  PageIterator<
+    Result<
+      CustomerPortalMembersListMembersResponse,
+      | HTTPValidationError
+      | PolarError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    { page: number }
   >
 > {
   return new APIPromise($do(
     client,
+    request,
     options,
   ));
 }
 
 async function $do(
   client: PolarCore,
+  request: CustomerPortalMembersListMembersRequest,
   options?: RequestOptions,
 ): Promise<
   [
-    Result<
-      Array<CustomerPortalMember>,
-      | PolarError
-      | ResponseValidationError
-      | ConnectionError
-      | RequestAbortedError
-      | RequestTimeoutError
-      | InvalidRequestError
-      | UnexpectedClientError
-      | SDKValidationError
+    PageIterator<
+      Result<
+        CustomerPortalMembersListMembersResponse,
+        | HTTPValidationError
+        | PolarError
+        | ResponseValidationError
+        | ConnectionError
+        | RequestAbortedError
+        | RequestTimeoutError
+        | InvalidRequestError
+        | UnexpectedClientError
+        | SDKValidationError
+      >,
+      { page: number }
     >,
     APICall,
   ]
 > {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      z.parse(CustomerPortalMembersListMembersRequest$outboundSchema, value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [haltIterator(parsed), { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
   const path = pathToFunc("/v1/customer-portal/members")();
 
+  const query = encodeFormQuery({
+    "limit": payload.limit,
+    "page": payload.page,
+  });
+
   const headers = new Headers(compactMap({
     Accept: "application/json",
   }));
@@ -106,27 +149,34 @@ async function $do(
     baseURL: options?.serverURL,
     path: path,
     headers: headers,
+    query: query,
+    body: body,
     userAgent: client._options.userAgent,
     timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
   }, options);
   if (!requestRes.ok) {
-    return [requestRes, { status: "invalid" }];
+    return [haltIterator(requestRes), { status: "invalid" }];
   }
   const req = requestRes.value;
 
   const doResult = await client._do(req, {
     context,
-    errorCodes: ["401", "403", "4XX", "5XX"],
+    errorCodes: ["401", "403", "422", "4XX", "5XX"],
     retryConfig: context.retryConfig,
     retryCodes: context.retryCodes,
   });
   if (!doResult.ok) {
-    return [doResult, { status: "request-error", request: req }];
+    return [haltIterator(doResult), { status: "request-error", request: req }];
   }
   const response = doResult.value;
 
-  const [result] = await M.match<
-    Array<CustomerPortalMember>,
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result, raw] = await M.match<
+    CustomerPortalMembersListMembersResponse,
+    | HTTPValidationError
     | PolarError
     | ResponseValidationError
     | ConnectionError
@@ -136,13 +186,76 @@ async function $do(
     | UnexpectedClientError
     | SDKValidationError
   >(
-    M.json(200, z.array(CustomerPortalMember$inboundSchema)),
+    M.json(200, CustomerPortalMembersListMembersResponse$inboundSchema, {
+      key: "Result",
+    }),
+    M.jsonErr(422, HTTPValidationError$inboundSchema),
     M.fail([401, 403, "4XX"]),
     M.fail("5XX"),
-  )(response, req);
+  )(response, req, { extraFields: responseFields });
   if (!result.ok) {
-    return [result, { status: "complete", request: req, response }];
+    return [haltIterator(result), {
+      status: "complete",
+      request: req,
+      response,
+    }];
   }
 
-  return [result, { status: "complete", request: req, response }];
+  const nextFunc = (
+    responseData: unknown,
+  ): {
+    next: Paginator<
+      Result<
+        CustomerPortalMembersListMembersResponse,
+        | HTTPValidationError
+        | PolarError
+        | ResponseValidationError
+        | ConnectionError
+        | RequestAbortedError
+        | RequestTimeoutError
+        | InvalidRequestError
+        | UnexpectedClientError
+        | SDKValidationError
+      >
+    >;
+    "~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 = () =>
+      customerPortalMembersListMembers(
+        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/customerPortalSeatsListClaimedSubscriptions.ts

@@ -4,15 +4,14 @@
 
 import * as z from "zod/v4-mini";
 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 { resolveSecurity } from "../lib/security.js";
 import { pathToFunc } from "../lib/url.js";
-import {
-  CustomerSubscription,
-  CustomerSubscription$inboundSchema,
-} from "../models/components/customersubscription.js";
 import {
   ConnectionError,
   InvalidRequestError,
@@ -20,12 +19,28 @@ import {
   RequestTimeoutError,
   UnexpectedClientError,
 } from "../models/errors/httpclienterrors.js";
+import {
+  HTTPValidationError,
+  HTTPValidationError$inboundSchema,
+} from "../models/errors/httpvalidationerror.js";
 import { PolarError } from "../models/errors/polarerror.js";
 import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
 import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
-import { CustomerPortalSeatsListClaimedSubscriptionsSecurity } from "../models/operations/customerportalseatslistclaimedsubscriptions.js";
+import {
+  CustomerPortalSeatsListClaimedSubscriptionsRequest,
+  CustomerPortalSeatsListClaimedSubscriptionsRequest$outboundSchema,
+  CustomerPortalSeatsListClaimedSubscriptionsResponse,
+  CustomerPortalSeatsListClaimedSubscriptionsResponse$inboundSchema,
+  CustomerPortalSeatsListClaimedSubscriptionsSecurity,
+} from "../models/operations/customerportalseatslistclaimedsubscriptions.js";
 import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
+import {
+  createPageIterator,
+  haltIterator,
+  PageIterator,
+  Paginator,
+} from "../types/operations.js";
 
 /**
  * List Claimed Subscriptions
@@ -38,23 +53,29 @@ import { Result } from "../types/fp.js";
 export function customerPortalSeatsListClaimedSubscriptions(
   client: PolarCore,
   security: CustomerPortalSeatsListClaimedSubscriptionsSecurity,
+  request: CustomerPortalSeatsListClaimedSubscriptionsRequest,
   options?: RequestOptions,
 ): APIPromise<
-  Result<
-    Array<CustomerSubscription>,
-    | PolarError
-    | ResponseValidationError
-    | ConnectionError
-    | RequestAbortedError
-    | RequestTimeoutError
-    | InvalidRequestError
-    | UnexpectedClientError
-    | SDKValidationError
+  PageIterator<
+    Result<
+      CustomerPortalSeatsListClaimedSubscriptionsResponse,
+      | HTTPValidationError
+      | PolarError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    { page: number }
   >
 > {
   return new APIPromise($do(
     client,
     security,
+    request,
     options,
   ));
 }
@@ -62,25 +83,50 @@ export function customerPortalSeatsListClaimedSubscriptions(
 async function $do(
   client: PolarCore,
   security: CustomerPortalSeatsListClaimedSubscriptionsSecurity,
+  request: CustomerPortalSeatsListClaimedSubscriptionsRequest,
   options?: RequestOptions,
 ): Promise<
   [
-    Result<
-      Array<CustomerSubscription>,
-      | PolarError
-      | ResponseValidationError
-      | ConnectionError
-      | RequestAbortedError
-      | RequestTimeoutError
-      | InvalidRequestError
-      | UnexpectedClientError
-      | SDKValidationError
+    PageIterator<
+      Result<
+        CustomerPortalSeatsListClaimedSubscriptionsResponse,
+        | HTTPValidationError
+        | PolarError
+        | ResponseValidationError
+        | ConnectionError
+        | RequestAbortedError
+        | RequestTimeoutError
+        | InvalidRequestError
+        | UnexpectedClientError
+        | SDKValidationError
+      >,
+      { page: number }
     >,
     APICall,
   ]
 > {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      z.parse(
+        CustomerPortalSeatsListClaimedSubscriptionsRequest$outboundSchema,
+        value,
+      ),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [haltIterator(parsed), { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
   const path = pathToFunc("/v1/customer-portal/seats/subscriptions")();
 
+  const query = encodeFormQuery({
+    "limit": payload.limit,
+    "page": payload.page,
+  });
+
   const headers = new Headers(compactMap({
     Accept: "application/json",
   }));
@@ -123,27 +169,34 @@ async function $do(
     baseURL: options?.serverURL,
     path: path,
     headers: headers,
+    query: query,
+    body: body,
     userAgent: client._options.userAgent,
     timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
   }, options);
   if (!requestRes.ok) {
-    return [requestRes, { status: "invalid" }];
+    return [haltIterator(requestRes), { status: "invalid" }];
   }
   const req = requestRes.value;
 
   const doResult = await client._do(req, {
     context,
-    errorCodes: ["401", "4XX", "5XX"],
+    errorCodes: ["401", "422", "4XX", "5XX"],
     retryConfig: context.retryConfig,
     retryCodes: context.retryCodes,
   });
   if (!doResult.ok) {
-    return [doResult, { status: "request-error", request: req }];
+    return [haltIterator(doResult), { status: "request-error", request: req }];
   }
   const response = doResult.value;
 
-  const [result] = await M.match<
-    Array<CustomerSubscription>,
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result, raw] = await M.match<
+    CustomerPortalSeatsListClaimedSubscriptionsResponse,
+    | HTTPValidationError
     | PolarError
     | ResponseValidationError
     | ConnectionError
@@ -153,13 +206,79 @@ async function $do(
     | UnexpectedClientError
     | SDKValidationError
   >(
-    M.json(200, z.array(CustomerSubscription$inboundSchema)),
+    M.json(
+      200,
+      CustomerPortalSeatsListClaimedSubscriptionsResponse$inboundSchema,
+      { key: "Result" },
+    ),
+    M.jsonErr(422, HTTPValidationError$inboundSchema),
     M.fail([401, "4XX"]),
     M.fail("5XX"),
-  )(response, req);
+  )(response, req, { extraFields: responseFields });
   if (!result.ok) {
-    return [result, { status: "complete", request: req, response }];
+    return [haltIterator(result), {
+      status: "complete",
+      request: req,
+      response,
+    }];
   }
 
-  return [result, { status: "complete", request: req, response }];
+  const nextFunc = (
+    responseData: unknown,
+  ): {
+    next: Paginator<
+      Result<
+        CustomerPortalSeatsListClaimedSubscriptionsResponse,
+        | HTTPValidationError
+        | PolarError
+        | ResponseValidationError
+        | ConnectionError
+        | RequestAbortedError
+        | RequestTimeoutError
+        | InvalidRequestError
+        | UnexpectedClientError
+        | SDKValidationError
+      >
+    >;
+    "~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 = () =>
+      customerPortalSeatsListClaimedSubscriptions(
+        client,
+        security,
+        {
+          ...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/customersExport.ts

@@ -28,10 +28,17 @@ import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
 import {
   CustomersExportRequest,
   CustomersExportRequest$outboundSchema,
+  CustomersExportResponse,
+  CustomersExportResponse$inboundSchema,
 } from "../models/operations/customersexport.js";
 import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
+export enum ExportAcceptEnum {
+  applicationJson = "application/json",
+  textCsv = "text/csv",
+}
+
 /**
  * Export Customers
  *
@@ -43,10 +50,10 @@ import { Result } from "../types/fp.js";
 export function customersExport(
   client: PolarCore,
   request: CustomersExportRequest,
-  options?: RequestOptions,
+  options?: RequestOptions & { acceptHeaderOverride?: ExportAcceptEnum },
 ): APIPromise<
   Result<
-    any,
+    CustomersExportResponse,
     | HTTPValidationError
     | PolarError
     | ResponseValidationError
@@ -68,11 +75,11 @@ export function customersExport(
 async function $do(
   client: PolarCore,
   request: CustomersExportRequest,
-  options?: RequestOptions,
+  options?: RequestOptions & { acceptHeaderOverride?: ExportAcceptEnum },
 ): Promise<
   [
     Result<
-      any,
+      CustomersExportResponse,
       | HTTPValidationError
       | PolarError
       | ResponseValidationError
@@ -104,7 +111,8 @@ async function $do(
   });
 
   const headers = new Headers(compactMap({
-    Accept: "application/json",
+    Accept: options?.acceptHeaderOverride
+      || "application/json;q=1, text/csv;q=0",
   }));
 
   const secConfig = await extractSecurity(client._options.accessToken);
@@ -158,7 +166,7 @@ async function $do(
   };
 
   const [result] = await M.match<
-    any,
+    CustomersExportResponse,
     | HTTPValidationError
     | PolarError
     | ResponseValidationError
@@ -169,7 +177,8 @@ async function $do(
     | UnexpectedClientError
     | SDKValidationError
   >(
-    M.json(200, z.any()),
+    M.json(200, CustomersExportResponse$inboundSchema),
+    M.text(200, CustomersExportResponse$inboundSchema, { ctype: "text/csv" }),
     M.jsonErr(422, HTTPValidationError$inboundSchema),
     M.fail("4XX"),
     M.fail("5XX"),

package/src/funcs/ordersExport.ts

@@ -28,12 +28,19 @@ import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
 import {
   OrdersExportRequest,
   OrdersExportRequest$outboundSchema,
+  OrdersExportResponse,
+  OrdersExportResponse$inboundSchema,
 } from "../models/operations/ordersexport.js";
 import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
+export enum ExportAcceptEnum {
+  applicationJson = "application/json",
+  textCsv = "text/csv",
+}
+
 /**
- * Export Subscriptions
+ * Export Orders
  *
  * @remarks
  * Export orders as a CSV file.
@@ -43,10 +50,10 @@ import { Result } from "../types/fp.js";
 export function ordersExport(
   client: PolarCore,
   request: OrdersExportRequest,
-  options?: RequestOptions,
+  options?: RequestOptions & { acceptHeaderOverride?: ExportAcceptEnum },
 ): APIPromise<
   Result<
-    any,
+    OrdersExportResponse,
     | HTTPValidationError
     | PolarError
     | ResponseValidationError
@@ -68,11 +75,11 @@ export function ordersExport(
 async function $do(
   client: PolarCore,
   request: OrdersExportRequest,
-  options?: RequestOptions,
+  options?: RequestOptions & { acceptHeaderOverride?: ExportAcceptEnum },
 ): Promise<
   [
     Result<
-      any,
+      OrdersExportResponse,
       | HTTPValidationError
       | PolarError
       | ResponseValidationError
@@ -105,7 +112,8 @@ async function $do(
   });
 
   const headers = new Headers(compactMap({
-    Accept: "application/json",
+    Accept: options?.acceptHeaderOverride
+      || "application/json;q=1, text/csv;q=0",
   }));
 
   const secConfig = await extractSecurity(client._options.accessToken);
@@ -159,7 +167,7 @@ async function $do(
   };
 
   const [result] = await M.match<
-    any,
+    OrdersExportResponse,
     | HTTPValidationError
     | PolarError
     | ResponseValidationError
@@ -170,7 +178,8 @@ async function $do(
     | UnexpectedClientError
     | SDKValidationError
   >(
-    M.json(200, z.any()),
+    M.json(200, OrdersExportResponse$inboundSchema),
+    M.text(200, OrdersExportResponse$inboundSchema, { ctype: "text/csv" }),
     M.jsonErr(422, HTTPValidationError$inboundSchema),
     M.fail("4XX"),
     M.fail("5XX"),