@polar-sh/sdk 0.47.1 → 0.48.0

package/src/models/components/ordercreate.ts

@@ -0,0 +1,166 @@
+/*
+ * 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";
+import { smartUnion } from "../../types/smartUnion.js";
+
+export type OrderCreateCustomFieldData = string | number | boolean | Date;
+
+export type OrderCreateMetadata = string | number | number | boolean;
+
+/**
+ * Schema to create a draft order for an off-session charge.
+ */
+export type OrderCreate = {
+  /**
+   * Key-value object storing custom field values.
+   */
+  customFieldData?:
+    | { [k: string]: string | number | boolean | Date | null }
+    | undefined;
+  /**
+   * Key-value object allowing you to store additional information.
+   *
+   * @remarks
+   *
+   * The key must be a string with a maximum length of **40 characters**.
+   * The value must be either:
+   *
+   * * A string with a maximum length of **500 characters**
+   * * An integer
+   * * A floating-point number
+   * * A boolean
+   *
+   * You can store up to **50 key-value pairs**.
+   */
+  metadata?: { [k: string]: string | number | number | boolean } | undefined;
+  /**
+   * The ID of the organization the order belongs to. **Required unless you use an organization token.** The customer and product must belong to this organization.
+   */
+  organizationId?: string | null | undefined;
+  /**
+   * The ID of the customer the order is for. Must belong to the order's organization.
+   */
+  customerId: string;
+  /**
+   * The ID of the one-time product to charge for. Must belong to the order's organization. Only fixed-price and free products are supported.
+   */
+  productId: string;
+  /**
+   * The currency to charge in (ISO 4217, lowercase, e.g. `usd`). Defaults to the organization's default currency; specify it to force a different one, or when the product isn't priced in the organization's default currency.
+   */
+  currency?: string | null | undefined;
+  /**
+   * A custom amount to charge, in the smallest currency unit. Overrides the product's price; defaults to the product's configured price (0 for free products). A positive amount must be at least the currency's minimum.
+   */
+  amount?: number | null | undefined;
+  /**
+   * A custom description for the order's line item, shown on the invoice and receipt (e.g. `5,000 tokens`). Defaults to the product name.
+   */
+  description?: string | null | undefined;
+};
+
+/** @internal */
+export type OrderCreateCustomFieldData$Outbound =
+  | string
+  | number
+  | boolean
+  | string;
+
+/** @internal */
+export const OrderCreateCustomFieldData$outboundSchema: z.ZodMiniType<
+  OrderCreateCustomFieldData$Outbound,
+  OrderCreateCustomFieldData
+> = smartUnion([
+  z.string(),
+  z.int(),
+  z.boolean(),
+  z.pipe(z.date(), z.transform(v => v.toISOString())),
+]);
+
+export function orderCreateCustomFieldDataToJSON(
+  orderCreateCustomFieldData: OrderCreateCustomFieldData,
+): string {
+  return JSON.stringify(
+    OrderCreateCustomFieldData$outboundSchema.parse(orderCreateCustomFieldData),
+  );
+}
+
+/** @internal */
+export type OrderCreateMetadata$Outbound = string | number | number | boolean;
+
+/** @internal */
+export const OrderCreateMetadata$outboundSchema: z.ZodMiniType<
+  OrderCreateMetadata$Outbound,
+  OrderCreateMetadata
+> = smartUnion([z.string(), z.int(), z.number(), z.boolean()]);
+
+export function orderCreateMetadataToJSON(
+  orderCreateMetadata: OrderCreateMetadata,
+): string {
+  return JSON.stringify(
+    OrderCreateMetadata$outboundSchema.parse(orderCreateMetadata),
+  );
+}
+
+/** @internal */
+export type OrderCreate$Outbound = {
+  custom_field_data?:
+    | { [k: string]: string | number | boolean | string | null }
+    | undefined;
+  metadata?: { [k: string]: string | number | number | boolean } | undefined;
+  organization_id?: string | null | undefined;
+  customer_id: string;
+  product_id: string;
+  currency?: string | null | undefined;
+  amount?: number | null | undefined;
+  description?: string | null | undefined;
+};
+
+/** @internal */
+export const OrderCreate$outboundSchema: z.ZodMiniType<
+  OrderCreate$Outbound,
+  OrderCreate
+> = z.pipe(
+  z.object({
+    customFieldData: z.optional(
+      z.record(
+        z.string(),
+        z.nullable(
+          smartUnion([
+            z.string(),
+            z.int(),
+            z.boolean(),
+            z.pipe(z.date(), z.transform(v => v.toISOString())),
+          ]),
+        ),
+      ),
+    ),
+    metadata: z.optional(
+      z.record(
+        z.string(),
+        smartUnion([z.string(), z.int(), z.number(), z.boolean()]),
+      ),
+    ),
+    organizationId: z.optional(z.nullable(z.string())),
+    customerId: z.string(),
+    productId: z.string(),
+    currency: z.optional(z.nullable(z.string())),
+    amount: z.optional(z.nullable(z.int())),
+    description: z.optional(z.nullable(z.string())),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      customFieldData: "custom_field_data",
+      organizationId: "organization_id",
+      customerId: "customer_id",
+      productId: "product_id",
+    });
+  }),
+);
+
+export function orderCreateToJSON(orderCreate: OrderCreate): string {
+  return JSON.stringify(OrderCreate$outboundSchema.parse(orderCreate));
+}

package/src/models/components/ordercustomer.ts

@@ -71,6 +71,10 @@ export type OrderCustomer = {
    * 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.
    */
@@ -135,6 +139,7 @@ export const OrderCustomer$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))),
     ),
@@ -149,6 +154,7 @@ export const OrderCustomer$inboundSchema: z.ZodMiniType<
       "billing_address": "billingAddress",
       "tax_id": "taxId",
       "organization_id": "organizationId",
+      "default_payment_method_id": "defaultPaymentMethodId",
       "deleted_at": "deletedAt",
       "avatar_url": "avatarUrl",
     });
@@ -169,6 +175,7 @@ export type OrderCustomer$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;
 };
@@ -194,6 +201,7 @@ export const OrderCustomer$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(),
   }),
@@ -206,6 +214,7 @@ export const OrderCustomer$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/orderfinalize.ts

@@ -0,0 +1,40 @@
+/*
+ * 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";
+
+/**
+ * Schema to finalize a draft order and trigger an off-session charge.
+ */
+export type OrderFinalize = {
+  /**
+   * ID of the payment method to charge. Must belong to the order's customer. Falls back to the customer's default payment method when unset.
+   */
+  paymentMethodId?: string | null | undefined;
+};
+
+/** @internal */
+export type OrderFinalize$Outbound = {
+  payment_method_id?: string | null | undefined;
+};
+
+/** @internal */
+export const OrderFinalize$outboundSchema: z.ZodMiniType<
+  OrderFinalize$Outbound,
+  OrderFinalize
+> = z.pipe(
+  z.object({
+    paymentMethodId: z.optional(z.nullable(z.string())),
+  }),
+  z.transform((v) => {
+    return remap$(v, {
+      paymentMethodId: "payment_method_id",
+    });
+  }),
+);
+
+export function orderFinalizeToJSON(orderFinalize: OrderFinalize): string {
+  return JSON.stringify(OrderFinalize$outboundSchema.parse(orderFinalize));
+}

package/src/models/components/orderreceipt.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";
+
+/**
+ * Order's receipt data.
+ */
+export type OrderReceipt = {
+  /**
+   * The URL to the receipt PDF.
+   */
+  url: string;
+};
+
+/** @internal */
+export const OrderReceipt$inboundSchema: z.ZodMiniType<OrderReceipt, unknown> =
+  z.object({
+    url: z.string(),
+  });
+
+export function orderReceiptFromJSON(
+  jsonString: string,
+): SafeParseResult<OrderReceipt, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => OrderReceipt$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'OrderReceipt' from JSON`,
+  );
+}

package/src/models/components/orderstatus.ts

@@ -7,6 +7,7 @@ import * as openEnums from "../../types/enums.js";
 import { OpenEnum } from "../../types/enums.js";
 
 export const OrderStatus = {
+  Draft: "draft",
   Pending: "pending",
   Paid: "paid",
   Refunded: "refunded",

package/src/models/components/organizationfeaturesettings.ts

@@ -25,18 +25,14 @@ export type OrganizationFeatureSettings = {
    * If this organization has the Member model enabled
    */
   memberModelEnabled?: boolean | undefined;
-  /**
-   * If this organization reads from Tinybird
-   */
-  tinybirdRead?: boolean | undefined;
-  /**
-   * If this organization compares Tinybird results with database
-   */
-  tinybirdCompare?: boolean | undefined;
   /**
    * If this organization has checkout localization enabled
    */
   checkoutLocalizationEnabled?: boolean | undefined;
+  /**
+   * If this organization sees the new account review checklist UI.
+   */
+  accountReviewV2Enabled?: boolean | undefined;
   /**
    * Ordered list of metric slugs shown on the dashboard overview.
    */
@@ -45,6 +41,14 @@ export type OrganizationFeatureSettings = {
    * If this organization has access to reset proration behavior.
    */
   resetProrationBehaviorEnabled?: boolean | undefined;
+  /**
+   * If this organization can create and finalize draft orders via the API (off-session charges against a saved payment method).
+   */
+  offSessionChargesEnabled?: boolean | undefined;
+  /**
+   * If this organization has billing enabled
+   */
+  billingEnabled?: boolean | undefined;
 };
 
 /** @internal */
@@ -57,11 +61,12 @@ export const OrganizationFeatureSettings$inboundSchema: z.ZodMiniType<
     seat_based_pricing_enabled: z._default(z.boolean(), false),
     wallets_enabled: z._default(z.boolean(), false),
     member_model_enabled: z._default(z.boolean(), false),
-    tinybird_read: z._default(z.boolean(), false),
-    tinybird_compare: z._default(z.boolean(), false),
     checkout_localization_enabled: z._default(z.boolean(), false),
+    account_review_v2_enabled: z._default(z.boolean(), false),
     overview_metrics: z.optional(z.nullable(z.array(z.string()))),
     reset_proration_behavior_enabled: z._default(z.boolean(), false),
+    off_session_charges_enabled: z._default(z.boolean(), false),
+    billing_enabled: z._default(z.boolean(), false),
   }),
   z.transform((v) => {
     return remap$(v, {
@@ -69,11 +74,12 @@ export const OrganizationFeatureSettings$inboundSchema: z.ZodMiniType<
       "seat_based_pricing_enabled": "seatBasedPricingEnabled",
       "wallets_enabled": "walletsEnabled",
       "member_model_enabled": "memberModelEnabled",
-      "tinybird_read": "tinybirdRead",
-      "tinybird_compare": "tinybirdCompare",
       "checkout_localization_enabled": "checkoutLocalizationEnabled",
+      "account_review_v2_enabled": "accountReviewV2Enabled",
       "overview_metrics": "overviewMetrics",
       "reset_proration_behavior_enabled": "resetProrationBehaviorEnabled",
+      "off_session_charges_enabled": "offSessionChargesEnabled",
+      "billing_enabled": "billingEnabled",
     });
   }),
 );
@@ -83,11 +89,12 @@ export type OrganizationFeatureSettings$Outbound = {
   seat_based_pricing_enabled: boolean;
   wallets_enabled: boolean;
   member_model_enabled: boolean;
-  tinybird_read: boolean;
-  tinybird_compare: boolean;
   checkout_localization_enabled: boolean;
+  account_review_v2_enabled: boolean;
   overview_metrics?: Array<string> | null | undefined;
   reset_proration_behavior_enabled: boolean;
+  off_session_charges_enabled: boolean;
+  billing_enabled: boolean;
 };
 
 /** @internal */
@@ -100,11 +107,12 @@ export const OrganizationFeatureSettings$outboundSchema: z.ZodMiniType<
     seatBasedPricingEnabled: z._default(z.boolean(), false),
     walletsEnabled: z._default(z.boolean(), false),
     memberModelEnabled: z._default(z.boolean(), false),
-    tinybirdRead: z._default(z.boolean(), false),
-    tinybirdCompare: z._default(z.boolean(), false),
     checkoutLocalizationEnabled: z._default(z.boolean(), false),
+    accountReviewV2Enabled: z._default(z.boolean(), false),
     overviewMetrics: z.optional(z.nullable(z.array(z.string()))),
     resetProrationBehaviorEnabled: z._default(z.boolean(), false),
+    offSessionChargesEnabled: z._default(z.boolean(), false),
+    billingEnabled: z._default(z.boolean(), false),
   }),
   z.transform((v) => {
     return remap$(v, {
@@ -112,11 +120,12 @@ export const OrganizationFeatureSettings$outboundSchema: z.ZodMiniType<
       seatBasedPricingEnabled: "seat_based_pricing_enabled",
       walletsEnabled: "wallets_enabled",
       memberModelEnabled: "member_model_enabled",
-      tinybirdRead: "tinybird_read",
-      tinybirdCompare: "tinybird_compare",
       checkoutLocalizationEnabled: "checkout_localization_enabled",
+      accountReviewV2Enabled: "account_review_v2_enabled",
       overviewMetrics: "overview_metrics",
       resetProrationBehaviorEnabled: "reset_proration_behavior_enabled",
+      offSessionChargesEnabled: "off_session_charges_enabled",
+      billingEnabled: "billing_enabled",
     });
   }),
 );

package/src/models/components/paymentmethod.ts

@@ -0,0 +1,40 @@
+/*
+ * 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 { smartUnion } from "../../types/smartUnion.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  CustomerPaymentMethodCard,
+  CustomerPaymentMethodCard$inboundSchema,
+} from "./customerpaymentmethodcard.js";
+import {
+  CustomerPaymentMethodGeneric,
+  CustomerPaymentMethodGeneric$inboundSchema,
+} from "./customerpaymentmethodgeneric.js";
+
+export type PaymentMethod =
+  | CustomerPaymentMethodCard
+  | CustomerPaymentMethodGeneric;
+
+/** @internal */
+export const PaymentMethod$inboundSchema: z.ZodMiniType<
+  PaymentMethod,
+  unknown
+> = smartUnion([
+  CustomerPaymentMethodCard$inboundSchema,
+  CustomerPaymentMethodGeneric$inboundSchema,
+]);
+
+export function paymentMethodFromJSON(
+  jsonString: string,
+): SafeParseResult<PaymentMethod, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PaymentMethod$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PaymentMethod' from JSON`,
+  );
+}

package/src/models/components/productpricecustom.ts

@@ -53,7 +53,7 @@ export type ProductPriceCustom = {
    */
   productId: string;
   /**
-   * 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;
   /**