@polar-sh/sdk 0.47.1 → 0.48.0

package/src/models/components/customerseatassign.ts

@@ -0,0 +1,102 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../../lib/primitives.js";
+
+export type CustomerSeatAssign = {
+  /**
+   * Subscription ID. Required if neither order_id nor checkout_id is provided.
+   */
+  subscriptionId?: string | null | undefined;
+  /**
+   * Order ID for one-time purchases. Required if subscription_id is not provided.
+   */
+  orderId?: string | null | undefined;
+  /**
+   * Email of the customer to assign the seat to
+   */
+  email?: string | null | undefined;
+  /**
+   * External customer ID for the seat assignment
+   */
+  externalCustomerId?: string | null | undefined;
+  /**
+   * Customer ID for the seat assignment
+   */
+  customerId?: string | null | undefined;
+  /**
+   * External member ID for the seat assignment. Can be used alone (lookup existing member) or with email (create/validate member).
+   */
+  externalMemberId?: string | null | undefined;
+  /**
+   * Member ID for the seat assignment.
+   */
+  memberId?: string | null | undefined;
+  /**
+   * Additional metadata for the seat (max 10 keys, 1KB total)
+   */
+  metadata?: { [k: string]: any } | null | undefined;
+  /**
+   * If true, the seat will be immediately claimed without sending an invitation email. API-only feature.
+   */
+  immediateClaim?: boolean | undefined;
+  /**
+   * Checkout ID. Resolves to the subscription or order produced by the checkout.
+   */
+  checkoutId?: string | null | undefined;
+};
+
+/** @internal */
+export type CustomerSeatAssign$Outbound = {
+  subscription_id?: string | null | undefined;
+  order_id?: string | null | undefined;
+  email?: string | null | undefined;
+  external_customer_id?: string | null | undefined;
+  customer_id?: string | null | undefined;
+  external_member_id?: string | null | undefined;
+  member_id?: string | null | undefined;
+  metadata?: { [k: string]: any } | null | undefined;
+  immediate_claim: boolean;
+  checkout_id?: string | null | undefined;
+};
+
+/** @internal */
+export const CustomerSeatAssign$outboundSchema: z.ZodMiniType<
+  CustomerSeatAssign$Outbound,
+  CustomerSeatAssign
+> = z.pipe(
+  z.object({
+    subscriptionId: z.optional(z.nullable(z.string())),
+    orderId: z.optional(z.nullable(z.string())),
+    email: z.optional(z.nullable(z.string())),
+    externalCustomerId: z.optional(z.nullable(z.string())),
+    customerId: z.optional(z.nullable(z.string())),
+    externalMemberId: z.optional(z.nullable(z.string())),
+    memberId: z.optional(z.nullable(z.string())),
+    metadata: z.optional(z.nullable(z.record(z.string(), z.any()))),
+    immediateClaim: z._default(z.boolean(), false),
+    checkoutId: z.optional(z.nullable(z.string())),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      subscriptionId: "subscription_id",
+      orderId: "order_id",
+      externalCustomerId: "external_customer_id",
+      customerId: "customer_id",
+      externalMemberId: "external_member_id",
+      memberId: "member_id",
+      immediateClaim: "immediate_claim",
+      checkoutId: "checkout_id",
+    });
+  }),
+);
+
+export function customerSeatAssignToJSON(
+  customerSeatAssign: CustomerSeatAssign,
+): string {
+  return JSON.stringify(
+    CustomerSeatAssign$outboundSchema.parse(customerSeatAssign),
+  );
+}

package/src/models/components/customerstateindividual.ts

@@ -96,6 +96,10 @@ export type CustomerStateIndividual = {
    * The ID of the organization owning the customer.
    */
   organizationId: string;
+  /**
+   * The ID of the customer's default payment method, if any. Use the payment methods endpoint to retrieve its details.
+   */
+  defaultPaymentMethodId?: string | null | undefined;
   /**
    * Timestamp for when the customer was soft deleted.
    */
@@ -174,6 +178,7 @@ export const CustomerStateIndividual$inboundSchema: z.ZodMiniType<
     ),
     locale: z.optional(z.nullable(z.string())),
     organization_id: z.string(),
+    default_payment_method_id: z.optional(z.nullable(z.string())),
     deleted_at: z.nullable(
       z.pipe(z.iso.datetime({ offset: true }), z.transform(v => new Date(v))),
     ),
@@ -191,6 +196,7 @@ export const CustomerStateIndividual$inboundSchema: z.ZodMiniType<
       "billing_address": "billingAddress",
       "tax_id": "taxId",
       "organization_id": "organizationId",
+      "default_payment_method_id": "defaultPaymentMethodId",
       "deleted_at": "deletedAt",
       "active_subscriptions": "activeSubscriptions",
       "granted_benefits": "grantedBenefits",
@@ -214,6 +220,7 @@ export type CustomerStateIndividual$Outbound = {
   tax_id: Array<string | string | null> | null;
   locale?: string | null | undefined;
   organization_id: string;
+  default_payment_method_id?: string | null | undefined;
   deleted_at: string | null;
   active_subscriptions: Array<CustomerStateSubscription$Outbound>;
   granted_benefits: Array<CustomerStateBenefitGrant$Outbound>;
@@ -242,6 +249,7 @@ export const CustomerStateIndividual$outboundSchema: z.ZodMiniType<
     ),
     locale: z.optional(z.nullable(z.string())),
     organizationId: z.string(),
+    defaultPaymentMethodId: z.optional(z.nullable(z.string())),
     deletedAt: z.nullable(z.pipe(z.date(), z.transform(v => v.toISOString()))),
     activeSubscriptions: z.array(CustomerStateSubscription$outboundSchema),
     grantedBenefits: z.array(CustomerStateBenefitGrant$outboundSchema),
@@ -257,6 +265,7 @@ export const CustomerStateIndividual$outboundSchema: z.ZodMiniType<
       billingAddress: "billing_address",
       taxId: "tax_id",
       organizationId: "organization_id",
+      defaultPaymentMethodId: "default_payment_method_id",
       deletedAt: "deleted_at",
       activeSubscriptions: "active_subscriptions",
       grantedBenefits: "granted_benefits",

package/src/models/components/customerstateteam.ts

@@ -96,6 +96,10 @@ export type CustomerStateTeam = {
    * The ID of the organization owning the customer.
    */
   organizationId: string;
+  /**
+   * The ID of the customer's default payment method, if any. Use the payment methods endpoint to retrieve its details.
+   */
+  defaultPaymentMethodId?: string | null | undefined;
   /**
    * Timestamp for when the customer was soft deleted.
    */
@@ -172,6 +176,7 @@ export const CustomerStateTeam$inboundSchema: z.ZodMiniType<
     ),
     locale: z.optional(z.nullable(z.string())),
     organization_id: z.string(),
+    default_payment_method_id: z.optional(z.nullable(z.string())),
     deleted_at: z.nullable(
       z.pipe(z.iso.datetime({ offset: true }), z.transform(v => new Date(v))),
     ),
@@ -189,6 +194,7 @@ export const CustomerStateTeam$inboundSchema: z.ZodMiniType<
       "billing_address": "billingAddress",
       "tax_id": "taxId",
       "organization_id": "organizationId",
+      "default_payment_method_id": "defaultPaymentMethodId",
       "deleted_at": "deletedAt",
       "active_subscriptions": "activeSubscriptions",
       "granted_benefits": "grantedBenefits",
@@ -212,6 +218,7 @@ export type CustomerStateTeam$Outbound = {
   tax_id: Array<string | string | null> | null;
   locale?: string | null | undefined;
   organization_id: string;
+  default_payment_method_id?: string | null | undefined;
   deleted_at: string | null;
   active_subscriptions: Array<CustomerStateSubscription$Outbound>;
   granted_benefits: Array<CustomerStateBenefitGrant$Outbound>;
@@ -240,6 +247,7 @@ export const CustomerStateTeam$outboundSchema: z.ZodMiniType<
     ),
     locale: z.optional(z.nullable(z.string())),
     organizationId: z.string(),
+    defaultPaymentMethodId: z.optional(z.nullable(z.string())),
     deletedAt: z.nullable(z.pipe(z.date(), z.transform(v => v.toISOString()))),
     activeSubscriptions: z.array(CustomerStateSubscription$outboundSchema),
     grantedBenefits: z.array(CustomerStateBenefitGrant$outboundSchema),
@@ -255,6 +263,7 @@ export const CustomerStateTeam$outboundSchema: z.ZodMiniType<
       billingAddress: "billing_address",
       taxId: "tax_id",
       organizationId: "organization_id",
+      defaultPaymentMethodId: "default_payment_method_id",
       deletedAt: "deleted_at",
       activeSubscriptions: "active_subscriptions",
       grantedBenefits: "granted_benefits",

package/src/models/components/customersubscriptionupdate.ts

@@ -9,6 +9,11 @@ import {
   CustomerSubscriptionCancel$Outbound,
   CustomerSubscriptionCancel$outboundSchema,
 } from "./customersubscriptioncancel.js";
+import {
+  CustomerSubscriptionUpdateClear,
+  CustomerSubscriptionUpdateClear$Outbound,
+  CustomerSubscriptionUpdateClear$outboundSchema,
+} from "./customersubscriptionupdateclear.js";
 import {
   CustomerSubscriptionUpdateProduct,
   CustomerSubscriptionUpdateProduct$Outbound,
@@ -23,12 +28,14 @@ import {
 export type CustomerSubscriptionUpdate =
   | CustomerSubscriptionUpdateProduct
   | CustomerSubscriptionUpdateSeats
+  | CustomerSubscriptionUpdateClear
   | CustomerSubscriptionCancel;
 
 /** @internal */
 export type CustomerSubscriptionUpdate$Outbound =
   | CustomerSubscriptionUpdateProduct$Outbound
   | CustomerSubscriptionUpdateSeats$Outbound
+  | CustomerSubscriptionUpdateClear$Outbound
   | CustomerSubscriptionCancel$Outbound;
 
 /** @internal */
@@ -38,6 +45,7 @@ export const CustomerSubscriptionUpdate$outboundSchema: z.ZodMiniType<
 > = smartUnion([
   CustomerSubscriptionUpdateProduct$outboundSchema,
   CustomerSubscriptionUpdateSeats$outboundSchema,
+  CustomerSubscriptionUpdateClear$outboundSchema,
   CustomerSubscriptionCancel$outboundSchema,
 ]);
 

package/src/models/components/customersubscriptionupdateclear.ts

@@ -0,0 +1,43 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { remap as remap$ } from "../../lib/primitives.js";
+
+export type CustomerSubscriptionUpdateClear = {
+  /**
+   * Clear the pending subscription update.
+   */
+  pendingUpdate: any | null;
+};
+
+/** @internal */
+export type CustomerSubscriptionUpdateClear$Outbound = {
+  pending_update: any | null;
+};
+
+/** @internal */
+export const CustomerSubscriptionUpdateClear$outboundSchema: z.ZodMiniType<
+  CustomerSubscriptionUpdateClear$Outbound,
+  CustomerSubscriptionUpdateClear
+> = z.pipe(
+  z.object({
+    pendingUpdate: z.nullable(z.any()),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      pendingUpdate: "pending_update",
+    });
+  }),
+);
+
+export function customerSubscriptionUpdateClearToJSON(
+  customerSubscriptionUpdateClear: CustomerSubscriptionUpdateClear,
+): string {
+  return JSON.stringify(
+    CustomerSubscriptionUpdateClear$outboundSchema.parse(
+      customerSubscriptionUpdateClear,
+    ),
+  );
+}

package/src/models/components/customerteam.ts

@@ -72,6 +72,10 @@ export type CustomerTeam = {
    * The ID of the organization owning the customer.
    */
   organizationId: string;
+  /**
+   * The ID of the customer's default payment method, if any. Use the payment methods endpoint to retrieve its details.
+   */
+  defaultPaymentMethodId?: string | null | undefined;
   /**
    * Timestamp for when the customer was soft deleted.
    */
@@ -136,6 +140,7 @@ export const CustomerTeam$inboundSchema: z.ZodMiniType<CustomerTeam, unknown> =
       ),
       locale: z.optional(z.nullable(z.string())),
       organization_id: z.string(),
+      default_payment_method_id: z.optional(z.nullable(z.string())),
       deleted_at: z.nullable(
         z.pipe(z.iso.datetime({ offset: true }), z.transform(v => new Date(v))),
       ),
@@ -150,6 +155,7 @@ export const CustomerTeam$inboundSchema: z.ZodMiniType<CustomerTeam, unknown> =
         "billing_address": "billingAddress",
         "tax_id": "taxId",
         "organization_id": "organizationId",
+        "default_payment_method_id": "defaultPaymentMethodId",
         "deleted_at": "deletedAt",
         "avatar_url": "avatarUrl",
       });
@@ -170,6 +176,7 @@ export type CustomerTeam$Outbound = {
   tax_id: Array<string | string | null> | null;
   locale?: string | null | undefined;
   organization_id: string;
+  default_payment_method_id?: string | null | undefined;
   deleted_at: string | null;
   avatar_url: string;
 };
@@ -195,6 +202,7 @@ export const CustomerTeam$outboundSchema: z.ZodMiniType<
     ),
     locale: z.optional(z.nullable(z.string())),
     organizationId: z.string(),
+    defaultPaymentMethodId: z.optional(z.nullable(z.string())),
     deletedAt: z.nullable(z.pipe(z.date(), z.transform(v => v.toISOString()))),
     avatarUrl: z.string(),
   }),
@@ -207,6 +215,7 @@ export const CustomerTeam$outboundSchema: z.ZodMiniType<
       billingAddress: "billing_address",
       taxId: "tax_id",
       organizationId: "organization_id",
+      defaultPaymentMethodId: "default_payment_method_id",
       deletedAt: "deleted_at",
       avatarUrl: "avatar_url",
     });

package/src/models/components/eventtypewithstats.ts

@@ -11,17 +11,17 @@ import { EventSource, EventSource$inboundSchema } from "./eventsource.js";
 
 export type EventTypeWithStats = {
   /**
-   * Creation timestamp of the object.
+   * The ID of the event type. Null for system event types.
    */
-  createdAt: Date;
+  id?: string | null | undefined;
   /**
-   * Last modification timestamp of the object.
+   * Creation timestamp of the event type. Null for system event types.
    */
-  modifiedAt: Date | null;
+  createdAt?: Date | null | undefined;
   /**
-   * The ID of the object.
+   * Last modification timestamp of the event type. Null for system event types.
    */
-  id: string;
+  modifiedAt?: Date | null | undefined;
   /**
    * The name of the event type.
    */
@@ -59,14 +59,19 @@ export const EventTypeWithStats$inboundSchema: z.ZodMiniType<
   unknown
 > = z.pipe(
   z.object({
-    created_at: z.pipe(
-      z.iso.datetime({ offset: true }),
-      z.transform(v => new Date(v)),
+    id: z.optional(z.nullable(z.string())),
+    created_at: z.optional(
+      z.nullable(z.pipe(
+        z.iso.datetime({ offset: true }),
+        z.transform(v => new Date(v)),
+      )),
     ),
-    modified_at: z.nullable(
-      z.pipe(z.iso.datetime({ offset: true }), z.transform(v => new Date(v))),
+    modified_at: z.optional(
+      z.nullable(z.pipe(
+        z.iso.datetime({ offset: true }),
+        z.transform(v => new Date(v)),
+      )),
     ),
-    id: z.string(),
     name: z.string(),
     label: z.string(),
     label_property_selector: z.optional(z.nullable(z.string())),

package/src/models/components/legacyrecurringproductpricecustom.ts

@@ -67,7 +67,7 @@ export type LegacyRecurringProductPriceCustom = {
   type: "recurring";
   recurringInterval: SubscriptionRecurringInterval;
   /**
-   * The minimum amount the customer can pay. If 0, the price is 'free or pay what you want'. Defaults to 50 cents.
+   * The minimum amount the customer can pay. If 0, the price is 'free or pay what you want'.
    */
   minimumAmount: number;
   /**

package/src/models/components/licensekeycustomer.ts

@@ -56,6 +56,10 @@ export type LicenseKeyCustomer = {
    * The ID of the organization owning the customer.
    */
   organizationId: string;
+  /**
+   * The ID of the customer's default payment method, if any. Use the payment methods endpoint to retrieve its details.
+   */
+  defaultPaymentMethodId?: string | null | undefined;
   /**
    * Timestamp for when the customer was soft deleted.
    */
@@ -105,6 +109,7 @@ export const LicenseKeyCustomer$inboundSchema: z.ZodMiniType<
     ),
     locale: z.optional(z.nullable(z.string())),
     organization_id: z.string(),
+    default_payment_method_id: z.optional(z.nullable(z.string())),
     deleted_at: z.nullable(
       z.pipe(z.iso.datetime({ offset: true }), z.transform(v => new Date(v))),
     ),
@@ -119,6 +124,7 @@ export const LicenseKeyCustomer$inboundSchema: z.ZodMiniType<
       "billing_address": "billingAddress",
       "tax_id": "taxId",
       "organization_id": "organizationId",
+      "default_payment_method_id": "defaultPaymentMethodId",
       "deleted_at": "deletedAt",
       "avatar_url": "avatarUrl",
     });

package/src/models/components/listresourcepaymentmethod.ts

@@ -0,0 +1,34 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import { Pagination, Pagination$inboundSchema } from "./pagination.js";
+import { PaymentMethod, PaymentMethod$inboundSchema } from "./paymentmethod.js";
+
+export type ListResourcePaymentMethod = {
+  items: Array<PaymentMethod>;
+  pagination: Pagination;
+};
+
+/** @internal */
+export const ListResourcePaymentMethod$inboundSchema: z.ZodMiniType<
+  ListResourcePaymentMethod,
+  unknown
+> = z.object({
+  items: z.array(PaymentMethod$inboundSchema),
+  pagination: Pagination$inboundSchema,
+});
+
+export function listResourcePaymentMethodFromJSON(
+  jsonString: string,
+): SafeParseResult<ListResourcePaymentMethod, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ListResourcePaymentMethod$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ListResourcePaymentMethod' from JSON`,
+  );
+}

package/src/models/components/order.ts

@@ -149,13 +149,17 @@ export type Order = {
   billingName: string | null;
   billingAddress: Address | null;
   /**
-   * The invoice number associated with this order.
+   * The invoice number associated with this order. `null` while the order is in `draft` status; assigned at finalize.
    */
-  invoiceNumber: string;
+  invoiceNumber: string | null;
   /**
    * Whether an invoice has been generated for this order.
    */
   isInvoiceGenerated: boolean;
+  /**
+   * The receipt number for this order. Set once the order is paid for organizations with receipts enabled. When set, a downloadable receipt PDF can be obtained via the receipt endpoint.
+   */
+  receiptNumber: string | null;
   /**
    * Number of seats purchased (for seat-based one-time orders).
    */
@@ -197,6 +201,14 @@ export type Order = {
    * A summary description of the order.
    */
   description: string;
+  /**
+   * Amount in cents that can still be refunded (net, before taxes). Accounts for any applied customer balance and previous refunds.
+   */
+  refundableAmount: number;
+  /**
+   * Sales tax in cents that would be refunded if the full refundable amount is refunded.
+   */
+  refundableTaxAmount: number;
 };
 
 /** @internal */
@@ -307,8 +319,9 @@ export const Order$inboundSchema: z.ZodMiniType<Order, unknown> = z.pipe(
     billing_reason: OrderBillingReason$inboundSchema,
     billing_name: z.nullable(z.string()),
     billing_address: z.nullable(Address$inboundSchema),
-    invoice_number: z.string(),
+    invoice_number: z.nullable(z.string()),
     is_invoice_generated: z.boolean(),
+    receipt_number: z.nullable(z.string()),
     seats: z.optional(z.nullable(z.int())),
     customer_id: z.string(),
     product_id: z.nullable(z.string()),
@@ -347,6 +360,8 @@ export const Order$inboundSchema: z.ZodMiniType<Order, unknown> = z.pipe(
     subscription: z.nullable(OrderSubscription$inboundSchema),
     items: z.array(OrderItemSchema$inboundSchema),
     description: z.string(),
+    refundable_amount: z.int(),
+    refundable_tax_amount: z.int(),
   }),
   z.transform((v) => {
     return remap$(v, {
@@ -366,6 +381,7 @@ export const Order$inboundSchema: z.ZodMiniType<Order, unknown> = z.pipe(
       "billing_address": "billingAddress",
       "invoice_number": "invoiceNumber",
       "is_invoice_generated": "isInvoiceGenerated",
+      "receipt_number": "receiptNumber",
       "customer_id": "customerId",
       "product_id": "productId",
       "discount_id": "discountId",
@@ -374,6 +390,8 @@ export const Order$inboundSchema: z.ZodMiniType<Order, unknown> = z.pipe(
       "custom_field_data": "customFieldData",
       "platform_fee_amount": "platformFeeAmount",
       "platform_fee_currency": "platformFeeCurrency",
+      "refundable_amount": "refundableAmount",
+      "refundable_tax_amount": "refundableTaxAmount",
     });
   }),
 );
@@ -397,8 +415,9 @@ export type Order$Outbound = {
   billing_reason: string;
   billing_name: string | null;
   billing_address: Address$Outbound | null;
-  invoice_number: string;
+  invoice_number: string | null;
   is_invoice_generated: boolean;
+  receipt_number: string | null;
   seats?: number | null | undefined;
   customer_id: string;
   product_id: string | null;
@@ -422,6 +441,8 @@ export type Order$Outbound = {
   subscription: OrderSubscription$Outbound | null;
   items: Array<OrderItemSchema$Outbound>;
   description: string;
+  refundable_amount: number;
+  refundable_tax_amount: number;
 };
 
 /** @internal */
@@ -448,8 +469,9 @@ export const Order$outboundSchema: z.ZodMiniType<Order$Outbound, Order> = z
       billingReason: OrderBillingReason$outboundSchema,
       billingName: z.nullable(z.string()),
       billingAddress: z.nullable(Address$outboundSchema),
-      invoiceNumber: z.string(),
+      invoiceNumber: z.nullable(z.string()),
       isInvoiceGenerated: z.boolean(),
+      receiptNumber: z.nullable(z.string()),
       seats: z.optional(z.nullable(z.int())),
       customerId: z.string(),
       productId: z.nullable(z.string()),
@@ -485,6 +507,8 @@ export const Order$outboundSchema: z.ZodMiniType<Order$Outbound, Order> = z
       subscription: z.nullable(OrderSubscription$outboundSchema),
       items: z.array(OrderItemSchema$outboundSchema),
       description: z.string(),
+      refundableAmount: z.int(),
+      refundableTaxAmount: z.int(),
     }),
     z.transform((v) => {
       return remap$(v, {
@@ -504,6 +528,7 @@ export const Order$outboundSchema: z.ZodMiniType<Order$Outbound, Order> = z
         billingAddress: "billing_address",
         invoiceNumber: "invoice_number",
         isInvoiceGenerated: "is_invoice_generated",
+        receiptNumber: "receipt_number",
         customerId: "customer_id",
         productId: "product_id",
         discountId: "discount_id",
@@ -512,6 +537,8 @@ export const Order$outboundSchema: z.ZodMiniType<Order$Outbound, Order> = z
         customFieldData: "custom_field_data",
         platformFeeAmount: "platform_fee_amount",
         platformFeeCurrency: "platform_fee_currency",
+        refundableAmount: "refundable_amount",
+        refundableTaxAmount: "refundable_tax_amount",
       });
     }),
   );