autumn-js 1.2.26 → 1.2.28

package/dist/backend/{routeTypes-BcR8yEXe.d.mts → routeTypes-924R85Bn.d.mts}

@@ -1,5 +1,6 @@
-import { b as ClosedEnum, O as OpenEnum, c as CustomerExpand, G as GetOrCreateCustomerParams, R as ResolvedIdentity } from './authTypes-B7b2mex1.mjs';
+import { C as ClosedEnum, O as OpenEnum, b as CustomerExpand, G as GetOrCreateCustomerParams, R as ResolvedIdentity } from './authTypes-CxFcWXh3.mjs';
 import { z } from 'zod/v4';
+import { ProtectedBodyField } from './core/utils/sanitizeBody.mjs';
 import { BackendResult } from './core/types/responseTypes.mjs';
 
 type Fetcher = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
@@ -113,7 +114,7 @@ type SDKOptions = {
  * and break out of regular control flow of programs making them harder to
  * inspect and more verbose work with due to try-catch blocks.
  */
-type Result<T, E = unknown> = {
+type Result$1<T, E = unknown> = {
     ok: true;
     value: T;
     error?: never;
@@ -801,7 +802,7 @@ type AttachCustomize = {
      */
     price?: AttachBasePrice | null | undefined;
     /**
-     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items.
+     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / update_items.
      */
     items?: Array<AttachItemPlanItem> | undefined;
     /**
@@ -833,6 +834,14 @@ type AttachInvoiceMode = {
      * If true, finalizes the invoice so it can be sent to the customer. If false, keeps it as a draft for manual review.
      */
     finalize?: boolean | undefined;
+    /**
+     * ID of an invoice template (configured in billing settings) whose footer (e.g. bank details) is applied to the invoice.
+     */
+    invoiceTemplateId?: string | undefined;
+    /**
+     * Number of days the customer has to pay the invoice before it is due (Stripe days_until_due).
+     */
+    netTermsDays?: number | undefined;
 };
 /**
  * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
@@ -1348,6 +1357,60 @@ type Balance = {
     rollovers?: Array<BalanceRollover> | undefined;
 };
 
+type BatchTrackLock = {
+    /**
+     * A unique identifier for this lock. Used to finalize the lock later via balances.finalize.
+     */
+    lockId: string;
+    /**
+     * Must be true to enable locking.
+     */
+    enabled: true;
+    /**
+     * Unix timestamp (ms) when the lock automatically expires and releases the held balance.
+     */
+    expiresAt?: number | undefined;
+};
+type RequestBody = {
+    /**
+     * The ID of the customer.
+     */
+    customerId: string;
+    /**
+     * The ID of the feature to track usage for. Required if event_name is not provided.
+     */
+    featureId?: string | undefined;
+    /**
+     * The ID of the entity for entity-scoped balances (e.g., per-seat limits).
+     */
+    entityId?: string | undefined;
+    /**
+     * Event name to track usage for. Use instead of feature_id when multiple features should be tracked from a single event.
+     */
+    eventName?: string | undefined;
+    /**
+     * The amount of usage to record. Defaults to 1. Use negative values to credit balance (e.g., when removing a seat).
+     */
+    value?: number | undefined;
+    /**
+     * Additional properties to attach to this usage event.
+     */
+    properties?: {
+        [k: string]: any;
+    } | undefined;
+    /**
+     * If true, enqueue the event for asynchronous processing and return 202 immediately. The response will not include balance information.
+     */
+    async?: boolean | undefined;
+    lock?: BatchTrackLock | undefined;
+};
+/**
+ * Batch accepted. All items passed synchronous validation. Enqueue is best-effort: partial failures (some items enqueued, some not) are logged server-side and are NOT surfaced in the response body; clients must not retry on 202. See the endpoint description for full partial-failure semantics.
+ */
+type BatchTrackResponse = {
+    success: true;
+};
+
 /**
  * Quantity configuration for a prepaid feature.
  */
@@ -1905,7 +1968,7 @@ type BillingUpdateCustomize = {
      */
     price?: BillingUpdateBasePrice | null | undefined;
     /**
-     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items.
+     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / update_items.
      */
     items?: Array<BillingUpdateItemPlanItem> | undefined;
     /**
@@ -1937,6 +2000,14 @@ type BillingUpdateInvoiceMode = {
      * If true, finalizes the invoice so it can be sent to the customer. If false, keeps it as a draft for manual review.
      */
     finalize?: boolean | undefined;
+    /**
+     * ID of an invoice template (configured in billing settings) whose footer (e.g. bank details) is applied to the invoice.
+     */
+    invoiceTemplateId?: string | undefined;
+    /**
+     * Number of days the customer has to pay the invoice before it is due (Stripe days_until_due).
+     */
+    netTermsDays?: number | undefined;
 };
 /**
  * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
@@ -2528,7 +2599,7 @@ type Properties2 = {
      */
     updateable?: boolean | null | undefined;
 };
-type Product2 = {
+type CheckProduct2 = {
     /**
      * The ID of the product you set when creating the product
      */
@@ -2610,7 +2681,7 @@ type Preview2 = {
     /**
      * Products that would grant access to this feature. Use to display upgrade options.
      */
-    products: Array<Product2>;
+    products: Array<CheckProduct2>;
 };
 /**
  * Accepted. Autumn is experiencing degraded service from a downstream provider, so access was allowed fail-open.
@@ -2993,7 +3064,7 @@ type Properties1 = {
      */
     updateable?: boolean | null | undefined;
 };
-type Product1 = {
+type CheckProduct1 = {
     /**
      * The ID of the product you set when creating the product
      */
@@ -3075,7 +3146,7 @@ type Preview1 = {
     /**
      * Products that would grant access to this feature. Use to display upgrade options.
      */
-    products: Array<Product1>;
+    products: Array<CheckProduct1>;
 };
 /**
  * OK
@@ -3972,6 +4043,17 @@ declare const CreateEntityStatus: {
  * Current status of the subscription.
  */
 type CreateEntityStatus = OpenEnum<typeof CreateEntityStatus>;
+/**
+ * Whether this subscription is attached at the customer level or entity level.
+ */
+declare const CreateEntitySubscriptionScope: {
+    readonly Customer: "customer";
+    readonly Entity: "entity";
+};
+/**
+ * Whether this subscription is attached at the customer level or entity level.
+ */
+type CreateEntitySubscriptionScope = OpenEnum<typeof CreateEntitySubscriptionScope>;
 type CreateEntitySubscription = {
     /**
      * The unique identifier of this subscription. If a subscription_id was provided at attach time, it is used; otherwise, falls back to the internal ID.
@@ -4026,7 +4108,22 @@ type CreateEntitySubscription = {
      * Number of units of this subscription (for per-seat plans).
      */
     quantity: number;
+    /**
+     * Whether this subscription is attached at the customer level or entity level.
+     */
+    scope?: CreateEntitySubscriptionScope | undefined;
+};
+/**
+ * Whether this purchase is attached at the customer level or entity level.
+ */
+declare const CreateEntityPurchaseScope: {
+    readonly Customer: "customer";
+    readonly Entity: "entity";
 };
+/**
+ * Whether this purchase is attached at the customer level or entity level.
+ */
+type CreateEntityPurchaseScope = OpenEnum<typeof CreateEntityPurchaseScope>;
 type CreateEntityPurchase = {
     plan?: Plan | undefined;
     /**
@@ -4045,6 +4142,10 @@ type CreateEntityPurchase = {
      * Number of units purchased.
      */
     quantity: number;
+    /**
+     * Whether this purchase is attached at the customer level or entity level.
+     */
+    scope?: CreateEntityPurchaseScope | undefined;
 };
 /**
  * Feature type: 'boolean' for on/off access, 'metered' for usage-tracked features, 'credit_system' for unified credit pools.
@@ -5258,6 +5359,27 @@ type CreateScheduleInvoiceMode = {
      * If true, finalizes the invoice so it can be sent to the customer. If false, keeps it as a draft for manual review.
      */
     finalize?: boolean | undefined;
+    /**
+     * ID of an invoice template (configured in billing settings) whose footer (e.g. bank details) is applied to the invoice.
+     */
+    invoiceTemplateId?: string | undefined;
+    /**
+     * Number of days the customer has to pay the invoice before it is due (Stripe days_until_due).
+     */
+    netTermsDays?: number | undefined;
+};
+/**
+ * A discount to apply. Can be either a reward ID or a promotion code.
+ */
+type CreateScheduleAttachDiscount = {
+    /**
+     * The ID of the reward to apply as a discount.
+     */
+    rewardId?: string | undefined;
+    /**
+     * The promotion code to apply as a discount.
+     */
+    promotionCode?: string | undefined;
 };
 /**
  * Controls when to return a checkout URL for the immediate phase. 'always' forces a confirmation or checkout flow, 'if_required' only redirects when needed, and 'never' disables redirects.
@@ -5595,6 +5717,10 @@ type CreateScheduleParams = {
      * Invoice mode creates and sends an invoice instead of charging the customer's payment method immediately for the first phase.
      */
     invoiceMode?: CreateScheduleInvoiceMode | undefined;
+    /**
+     * List of discounts to apply to the immediate phase. Each discount can be an Autumn reward ID, Stripe coupon ID, or Stripe promotion code.
+     */
+    discounts?: Array<CreateScheduleAttachDiscount> | undefined;
     /**
      * URL to redirect to after successful checkout.
      */
@@ -5917,6 +6043,17 @@ declare const CustomerStatus: {
  * Current status of the subscription.
  */
 type CustomerStatus = OpenEnum<typeof CustomerStatus>;
+/**
+ * Whether this subscription is attached at the customer level or entity level.
+ */
+declare const SubscriptionScope: {
+    readonly Customer: "customer";
+    readonly Entity: "entity";
+};
+/**
+ * Whether this subscription is attached at the customer level or entity level.
+ */
+type SubscriptionScope = OpenEnum<typeof SubscriptionScope>;
 type Subscription = {
     /**
      * The unique identifier of this subscription. If a subscription_id was provided at attach time, it is used; otherwise, falls back to the internal ID.
@@ -5971,7 +6108,22 @@ type Subscription = {
      * Number of units of this subscription (for per-seat plans).
      */
     quantity: number;
+    /**
+     * Whether this subscription is attached at the customer level or entity level.
+     */
+    scope?: SubscriptionScope | undefined;
 };
+/**
+ * Whether this purchase is attached at the customer level or entity level.
+ */
+declare const PurchaseScope: {
+    readonly Customer: "customer";
+    readonly Entity: "entity";
+};
+/**
+ * Whether this purchase is attached at the customer level or entity level.
+ */
+type PurchaseScope = OpenEnum<typeof PurchaseScope>;
 type Purchase = {
     plan?: Plan | undefined;
     /**
@@ -5990,6 +6142,10 @@ type Purchase = {
      * Number of units purchased.
      */
     quantity: number;
+    /**
+     * Whether this purchase is attached at the customer level or entity level.
+     */
+    scope?: PurchaseScope | undefined;
 };
 /**
  * Feature type: 'boolean' for on/off access, 'metered' for usage-tracked features, 'credit_system' for unified credit pools.
@@ -6769,6 +6925,17 @@ declare const GetCustomerStatus: {
  * Current status of the subscription.
  */
 type GetCustomerStatus = OpenEnum<typeof GetCustomerStatus>;
+/**
+ * Whether this subscription is attached at the customer level or entity level.
+ */
+declare const GetCustomerSubscriptionScope: {
+    readonly Customer: "customer";
+    readonly Entity: "entity";
+};
+/**
+ * Whether this subscription is attached at the customer level or entity level.
+ */
+type GetCustomerSubscriptionScope = OpenEnum<typeof GetCustomerSubscriptionScope>;
 type GetCustomerSubscription = {
     /**
      * The unique identifier of this subscription. If a subscription_id was provided at attach time, it is used; otherwise, falls back to the internal ID.
@@ -6823,7 +6990,22 @@ type GetCustomerSubscription = {
      * Number of units of this subscription (for per-seat plans).
      */
     quantity: number;
+    /**
+     * Whether this subscription is attached at the customer level or entity level.
+     */
+    scope?: GetCustomerSubscriptionScope | undefined;
 };
+/**
+ * Whether this purchase is attached at the customer level or entity level.
+ */
+declare const GetCustomerPurchaseScope: {
+    readonly Customer: "customer";
+    readonly Entity: "entity";
+};
+/**
+ * Whether this purchase is attached at the customer level or entity level.
+ */
+type GetCustomerPurchaseScope = OpenEnum<typeof GetCustomerPurchaseScope>;
 type GetCustomerPurchase = {
     plan?: Plan | undefined;
     /**
@@ -6842,6 +7024,10 @@ type GetCustomerPurchase = {
      * Number of units purchased.
      */
     quantity: number;
+    /**
+     * Whether this purchase is attached at the customer level or entity level.
+     */
+    scope?: GetCustomerPurchaseScope | undefined;
 };
 /**
  * Feature type: 'boolean' for on/off access, 'metered' for usage-tracked features, 'credit_system' for unified credit pools.
@@ -7302,6 +7488,17 @@ declare const GetEntityStatus: {
  * Current status of the subscription.
  */
 type GetEntityStatus = OpenEnum<typeof GetEntityStatus>;
+/**
+ * Whether this subscription is attached at the customer level or entity level.
+ */
+declare const GetEntitySubscriptionScope: {
+    readonly Customer: "customer";
+    readonly Entity: "entity";
+};
+/**
+ * Whether this subscription is attached at the customer level or entity level.
+ */
+type GetEntitySubscriptionScope = OpenEnum<typeof GetEntitySubscriptionScope>;
 type GetEntitySubscription = {
     /**
      * The unique identifier of this subscription. If a subscription_id was provided at attach time, it is used; otherwise, falls back to the internal ID.
@@ -7356,7 +7553,22 @@ type GetEntitySubscription = {
      * Number of units of this subscription (for per-seat plans).
      */
     quantity: number;
+    /**
+     * Whether this subscription is attached at the customer level or entity level.
+     */
+    scope?: GetEntitySubscriptionScope | undefined;
+};
+/**
+ * Whether this purchase is attached at the customer level or entity level.
+ */
+declare const GetEntityPurchaseScope: {
+    readonly Customer: "customer";
+    readonly Entity: "entity";
 };
+/**
+ * Whether this purchase is attached at the customer level or entity level.
+ */
+type GetEntityPurchaseScope = OpenEnum<typeof GetEntityPurchaseScope>;
 type GetEntityPurchase = {
     plan?: Plan | undefined;
     /**
@@ -7375,6 +7587,10 @@ type GetEntityPurchase = {
      * Number of units purchased.
      */
     quantity: number;
+    /**
+     * Whether this purchase is attached at the customer level or entity level.
+     */
+    scope?: GetEntityPurchaseScope | undefined;
 };
 /**
  * Feature type: 'boolean' for on/off access, 'metered' for usage-tracked features, 'credit_system' for unified credit pools.
@@ -8176,6 +8392,59 @@ type GetPlanResponse = {
     customerEligibility?: GetPlanCustomerEligibility | undefined;
 };
 
+/**
+ * "test" and "sandbox" both target the sandbox environment
+ */
+declare const GetRevenueCatKeysEnv: {
+    readonly Test: "test";
+    readonly Sandbox: "sandbox";
+    readonly Live: "live";
+};
+/**
+ * "test" and "sandbox" both target the sandbox environment
+ */
+type GetRevenueCatKeysEnv = ClosedEnum<typeof GetRevenueCatKeysEnv>;
+type GetRevenueCatKeysParams = {
+    organizationSlug: string;
+    /**
+     * "test" and "sandbox" both target the sandbox environment
+     */
+    env: GetRevenueCatKeysEnv;
+};
+type ApiKey = {
+    id: string;
+    /**
+     * The public SDK API key value
+     */
+    key: string;
+    /**
+     * e.g. "production" / "sandbox"
+     */
+    environment?: string | null | undefined;
+    appId?: string | null | undefined;
+    createdAt?: number | undefined;
+    [additionalProperties: string]: unknown;
+};
+type GetRevenueCatKeysApp = {
+    appId: string;
+    /**
+     * RevenueCat store type, e.g. test_store / app_store / play_store
+     */
+    appType: string;
+    name: string;
+    apiKeys: Array<ApiKey>;
+};
+/**
+ * OK
+ */
+type GetRevenueCatKeysResponse = {
+    apps: Array<GetRevenueCatKeysApp>;
+    /**
+     * Freshly-refreshed RevenueCat OAuth access token for the org (null for api-key orgs). The refresh token is never exposed — call this endpoint again for a new access token.
+     */
+    oauthAccessToken: string | null;
+};
+
 /**
  * Base class for all HTTP errors.
  */
@@ -8220,6 +8489,24 @@ declare class ConnectionError extends HTTPClientError {
     readonly name = "ConnectionError";
 }
 
+declare const LinkRevenueCatEnv: {
+    readonly Test: "test";
+    readonly Live: "live";
+};
+type LinkRevenueCatEnv = ClosedEnum<typeof LinkRevenueCatEnv>;
+type LinkRevenueCatParams = {
+    organizationSlug: string;
+    env: LinkRevenueCatEnv;
+    projectName: string;
+    redirectUrl: string;
+};
+/**
+ * OK
+ */
+type LinkRevenueCatResponse = {
+    oauthUrl: string;
+};
+
 type ListCustomersPlan = {
     id: string;
     versions?: Array<number> | undefined;
@@ -8451,6 +8738,17 @@ declare const ListCustomersStatus: {
  * Current status of the subscription.
  */
 type ListCustomersStatus = OpenEnum<typeof ListCustomersStatus>;
+/**
+ * Whether this subscription is attached at the customer level or entity level.
+ */
+declare const ListCustomersSubscriptionScope: {
+    readonly Customer: "customer";
+    readonly Entity: "entity";
+};
+/**
+ * Whether this subscription is attached at the customer level or entity level.
+ */
+type ListCustomersSubscriptionScope = OpenEnum<typeof ListCustomersSubscriptionScope>;
 type ListCustomersSubscription = {
     /**
      * The unique identifier of this subscription. If a subscription_id was provided at attach time, it is used; otherwise, falls back to the internal ID.
@@ -8505,7 +8803,22 @@ type ListCustomersSubscription = {
      * Number of units of this subscription (for per-seat plans).
      */
     quantity: number;
+    /**
+     * Whether this subscription is attached at the customer level or entity level.
+     */
+    scope?: ListCustomersSubscriptionScope | undefined;
 };
+/**
+ * Whether this purchase is attached at the customer level or entity level.
+ */
+declare const ListCustomersPurchaseScope: {
+    readonly Customer: "customer";
+    readonly Entity: "entity";
+};
+/**
+ * Whether this purchase is attached at the customer level or entity level.
+ */
+type ListCustomersPurchaseScope = OpenEnum<typeof ListCustomersPurchaseScope>;
 type ListCustomersPurchase = {
     plan?: Plan | undefined;
     /**
@@ -8524,6 +8837,10 @@ type ListCustomersPurchase = {
      * Number of units purchased.
      */
     quantity: number;
+    /**
+     * Whether this purchase is attached at the customer level or entity level.
+     */
+    scope?: ListCustomersPurchaseScope | undefined;
 };
 /**
  * Feature type: 'boolean' for on/off access, 'metered' for usage-tracked features, 'credit_system' for unified credit pools.
@@ -8808,6 +9125,10 @@ type ListEntitiesParams = {
      * Filter by parent customer processor type (stripe, revenuecat, vercel).
      */
     processors?: Array<ListEntitiesProcessor> | undefined;
+    /**
+     * Restrict the response to entities owned by this customer id. Use to bulk-fetch all entities for one customer in a single paginated call instead of iterating entities.get.
+     */
+    customerId?: string | undefined;
 };
 /**
  * The environment (sandbox/live)
@@ -8831,6 +9152,17 @@ declare const ListEntitiesStatus: {
  * Current status of the subscription.
  */
 type ListEntitiesStatus = OpenEnum<typeof ListEntitiesStatus>;
+/**
+ * Whether this subscription is attached at the customer level or entity level.
+ */
+declare const ListEntitiesSubscriptionScope: {
+    readonly Customer: "customer";
+    readonly Entity: "entity";
+};
+/**
+ * Whether this subscription is attached at the customer level or entity level.
+ */
+type ListEntitiesSubscriptionScope = OpenEnum<typeof ListEntitiesSubscriptionScope>;
 type ListEntitiesSubscription = {
     /**
      * The unique identifier of this subscription. If a subscription_id was provided at attach time, it is used; otherwise, falls back to the internal ID.
@@ -8885,7 +9217,22 @@ type ListEntitiesSubscription = {
      * Number of units of this subscription (for per-seat plans).
      */
     quantity: number;
+    /**
+     * Whether this subscription is attached at the customer level or entity level.
+     */
+    scope?: ListEntitiesSubscriptionScope | undefined;
 };
+/**
+ * Whether this purchase is attached at the customer level or entity level.
+ */
+declare const ListEntitiesPurchaseScope: {
+    readonly Customer: "customer";
+    readonly Entity: "entity";
+};
+/**
+ * Whether this purchase is attached at the customer level or entity level.
+ */
+type ListEntitiesPurchaseScope = OpenEnum<typeof ListEntitiesPurchaseScope>;
 type ListEntitiesPurchase = {
     plan?: Plan | undefined;
     /**
@@ -8904,6 +9251,10 @@ type ListEntitiesPurchase = {
      * Number of units purchased.
      */
     quantity: number;
+    /**
+     * Whether this purchase is attached at the customer level or entity level.
+     */
+    scope?: ListEntitiesPurchaseScope | undefined;
 };
 /**
  * Feature type: 'boolean' for on/off access, 'metered' for usage-tracked features, 'credit_system' for unified credit pools.
@@ -10206,6 +10557,14 @@ type MultiAttachInvoiceMode = {
      * If true, finalizes the invoice so it can be sent to the customer. If false, keeps it as a draft for manual review.
      */
     finalize?: boolean | undefined;
+    /**
+     * ID of an invoice template (configured in billing settings) whose footer (e.g. bank details) is applied to the invoice.
+     */
+    invoiceTemplateId?: string | undefined;
+    /**
+     * Number of days the customer has to pay the invoice before it is due (Stripe days_until_due).
+     */
+    netTermsDays?: number | undefined;
 };
 /**
  * A discount to apply. Can be either a reward ID or a promotion code.
@@ -11036,7 +11395,7 @@ type PreviewAttachCustomize = {
      */
     price?: PreviewAttachBasePrice | null | undefined;
     /**
-     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items.
+     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / update_items.
      */
     items?: Array<PreviewAttachItemPlanItem> | undefined;
     /**
@@ -11068,6 +11427,14 @@ type PreviewAttachInvoiceMode = {
      * If true, finalizes the invoice so it can be sent to the customer. If false, keeps it as a draft for manual review.
      */
     finalize?: boolean | undefined;
+    /**
+     * ID of an invoice template (configured in billing settings) whose footer (e.g. bank details) is applied to the invoice.
+     */
+    invoiceTemplateId?: string | undefined;
+    /**
+     * Number of days the customer has to pay the invoice before it is due (Stripe days_until_due).
+     */
+    netTermsDays?: number | undefined;
 };
 /**
  * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
@@ -11957,6 +12324,14 @@ type PreviewMultiAttachInvoiceMode = {
      * If true, finalizes the invoice so it can be sent to the customer. If false, keeps it as a draft for manual review.
      */
     finalize?: boolean | undefined;
+    /**
+     * ID of an invoice template (configured in billing settings) whose footer (e.g. bank details) is applied to the invoice.
+     */
+    invoiceTemplateId?: string | undefined;
+    /**
+     * Number of days the customer has to pay the invoice before it is due (Stripe days_until_due).
+     */
+    netTermsDays?: number | undefined;
 };
 /**
  * A discount to apply. Can be either a reward ID or a promotion code.
@@ -13028,7 +13403,7 @@ type PreviewUpdateCustomize = {
      */
     price?: PreviewUpdateBasePrice | null | undefined;
     /**
-     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items.
+     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / update_items.
      */
     items?: Array<PreviewUpdateItemPlanItem> | undefined;
     /**
@@ -13060,6 +13435,14 @@ type PreviewUpdateInvoiceMode = {
      * If true, finalizes the invoice so it can be sent to the customer. If false, keeps it as a draft for manual review.
      */
     finalize?: boolean | undefined;
+    /**
+     * ID of an invoice template (configured in billing settings) whose footer (e.g. bank details) is applied to the invoice.
+     */
+    invoiceTemplateId?: string | undefined;
+    /**
+     * Number of days the customer has to pay the invoice before it is due (Stripe days_until_due).
+     */
+    netTermsDays?: number | undefined;
 };
 /**
  * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
@@ -14144,7 +14527,7 @@ type SetupPaymentCustomize = {
      */
     price?: SetupPaymentBasePrice | null | undefined;
     /**
-     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items.
+     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / update_items.
      */
     items?: Array<SetupPaymentItemPlanItem> | undefined;
     /**
@@ -14332,6 +14715,75 @@ type SetupPaymentResponse = {
     url: string;
 };
 
+/**
+ * "test" and "sandbox" both target the sandbox environment
+ */
+declare const SyncRevenueCatEnv: {
+    readonly Test: "test";
+    readonly Sandbox: "sandbox";
+    readonly Live: "live";
+};
+/**
+ * "test" and "sandbox" both target the sandbox environment
+ */
+type SyncRevenueCatEnv = ClosedEnum<typeof SyncRevenueCatEnv>;
+type SyncRevenueCatParams = {
+    organizationSlug: string;
+    /**
+     * "test" and "sandbox" both target the sandbox environment
+     */
+    env: SyncRevenueCatEnv;
+    /**
+     * Plans to push. Omit to sync every plan in the org/env.
+     */
+    productIds?: Array<string> | undefined;
+};
+declare const SyncRevenueCatStatus: {
+    readonly Synced: "synced";
+    readonly Skipped: "skipped";
+    readonly Error: "error";
+};
+type SyncRevenueCatStatus = OpenEnum<typeof SyncRevenueCatStatus>;
+declare const SyncRevenueCatProduct: {
+    readonly Created: "created";
+    readonly Updated: "updated";
+    readonly Exists: "exists";
+};
+type SyncRevenueCatProduct = OpenEnum<typeof SyncRevenueCatProduct>;
+declare const StorePush: {
+    readonly Pushed: "pushed";
+    readonly Failed: "failed";
+    readonly Skipped: "skipped";
+};
+type StorePush = OpenEnum<typeof StorePush>;
+declare const SyncRevenueCatPrice: {
+    readonly Set: "set";
+    readonly Skipped: "skipped";
+    readonly Failed: "failed";
+};
+type SyncRevenueCatPrice = OpenEnum<typeof SyncRevenueCatPrice>;
+type SyncRevenueCatApp = {
+    appId: string;
+    appType: string;
+    product: SyncRevenueCatProduct;
+    storePush?: StorePush | undefined;
+    price?: SyncRevenueCatPrice | undefined;
+    message?: string | undefined;
+};
+type Result = {
+    planId: string;
+    status: SyncRevenueCatStatus;
+    storeIdentifier?: string | undefined;
+    apps?: Array<SyncRevenueCatApp> | undefined;
+    message?: string | undefined;
+};
+/**
+ * OK
+ */
+type SyncRevenueCatResponse = {
+    results: Array<Result>;
+};
+
 type TrackLock = {
     /**
      * A unique identifier for this lock. Used to finalize the lock later via balances.finalize.
@@ -14373,6 +14825,10 @@ type TrackParams = {
     properties?: {
         [k: string]: any;
     } | undefined;
+    /**
+     * If true, enqueue the event for asynchronous processing and return 202 immediately. The response will not include balance information.
+     */
+    async?: boolean | undefined;
     lock?: TrackLock | undefined;
 };
 declare const TrackIntervalEnum2: {
@@ -14983,6 +15439,17 @@ declare const UpdateCustomerStatus: {
  * Current status of the subscription.
  */
 type UpdateCustomerStatus = OpenEnum<typeof UpdateCustomerStatus>;
+/**
+ * Whether this subscription is attached at the customer level or entity level.
+ */
+declare const UpdateCustomerSubscriptionScope: {
+    readonly Customer: "customer";
+    readonly Entity: "entity";
+};
+/**
+ * Whether this subscription is attached at the customer level or entity level.
+ */
+type UpdateCustomerSubscriptionScope = OpenEnum<typeof UpdateCustomerSubscriptionScope>;
 type UpdateCustomerSubscription = {
     /**
      * The unique identifier of this subscription. If a subscription_id was provided at attach time, it is used; otherwise, falls back to the internal ID.
@@ -15037,7 +15504,22 @@ type UpdateCustomerSubscription = {
      * Number of units of this subscription (for per-seat plans).
      */
     quantity: number;
+    /**
+     * Whether this subscription is attached at the customer level or entity level.
+     */
+    scope?: UpdateCustomerSubscriptionScope | undefined;
+};
+/**
+ * Whether this purchase is attached at the customer level or entity level.
+ */
+declare const UpdateCustomerPurchaseScope: {
+    readonly Customer: "customer";
+    readonly Entity: "entity";
 };
+/**
+ * Whether this purchase is attached at the customer level or entity level.
+ */
+type UpdateCustomerPurchaseScope = OpenEnum<typeof UpdateCustomerPurchaseScope>;
 type UpdateCustomerPurchase = {
     plan?: Plan | undefined;
     /**
@@ -15056,6 +15538,10 @@ type UpdateCustomerPurchase = {
      * Number of units purchased.
      */
     quantity: number;
+    /**
+     * Whether this purchase is attached at the customer level or entity level.
+     */
+    scope?: UpdateCustomerPurchaseScope | undefined;
 };
 /**
  * Feature type: 'boolean' for on/off access, 'metered' for usage-tracked features, 'credit_system' for unified credit pools.
@@ -15396,6 +15882,17 @@ declare const UpdateEntityStatus: {
  * Current status of the subscription.
  */
 type UpdateEntityStatus = OpenEnum<typeof UpdateEntityStatus>;
+/**
+ * Whether this subscription is attached at the customer level or entity level.
+ */
+declare const UpdateEntitySubscriptionScope: {
+    readonly Customer: "customer";
+    readonly Entity: "entity";
+};
+/**
+ * Whether this subscription is attached at the customer level or entity level.
+ */
+type UpdateEntitySubscriptionScope = OpenEnum<typeof UpdateEntitySubscriptionScope>;
 type UpdateEntitySubscription = {
     /**
      * The unique identifier of this subscription. If a subscription_id was provided at attach time, it is used; otherwise, falls back to the internal ID.
@@ -15450,7 +15947,22 @@ type UpdateEntitySubscription = {
      * Number of units of this subscription (for per-seat plans).
      */
     quantity: number;
+    /**
+     * Whether this subscription is attached at the customer level or entity level.
+     */
+    scope?: UpdateEntitySubscriptionScope | undefined;
 };
+/**
+ * Whether this purchase is attached at the customer level or entity level.
+ */
+declare const UpdateEntityPurchaseScope: {
+    readonly Customer: "customer";
+    readonly Entity: "entity";
+};
+/**
+ * Whether this purchase is attached at the customer level or entity level.
+ */
+type UpdateEntityPurchaseScope = OpenEnum<typeof UpdateEntityPurchaseScope>;
 type UpdateEntityPurchase = {
     plan?: Plan | undefined;
     /**
@@ -15469,6 +15981,10 @@ type UpdateEntityPurchase = {
      * Number of units purchased.
      */
     quantity: number;
+    /**
+     * Whether this purchase is attached at the customer level or entity level.
+     */
+    scope?: UpdateEntityPurchaseScope | undefined;
 };
 /**
  * Feature type: 'boolean' for on/off access, 'metered' for usage-tracked features, 'credit_system' for unified credit pools.
@@ -16810,13 +17326,13 @@ declare class ClientSDK {
         hooks?: SDKHooks;
     };
     constructor(options?: SDKOptions);
-    _createRequest(context: HookContext, conf: RequestConfig, options?: RequestOptions): Result<Request, InvalidRequestError | UnexpectedClientError>;
+    _createRequest(context: HookContext, conf: RequestConfig, options?: RequestOptions): Result$1<Request, InvalidRequestError | UnexpectedClientError>;
     _do(request: Request, options: {
         context: HookContext;
         isErrorStatusCode: (statusCode: number) => boolean;
         retryConfig: RetryConfig;
         retryCodes: string[];
-    }): Promise<Result<Response, RequestAbortedError | RequestTimeoutError | ConnectionError | UnexpectedClientError>>;
+    }): Promise<Result$1<Response, RequestAbortedError | RequestTimeoutError | ConnectionError | UnexpectedClientError>>;
 }
 
 declare class Balances extends ClientSDK {
@@ -16900,12 +17416,13 @@ declare class Billing extends ClientSDK {
      * @example
      * ```typescript
      * // Schedule a transition from a trial plan to a paid plan
-     * const response = await client.billing.createSchedule({ customerId: "cus_123", phases: [{"startsAt":1779303143711,"plans":[{"planId":"trial_plan"}]},{"startsAt":1780512743711,"plans":[{"planId":"pro_plan"}]}] });
+     * const response = await client.billing.createSchedule({ customerId: "cus_123", phases: [{"startsAt":1780512803523,"plans":[{"planId":"trial_plan"}]},{"startsAt":1781722403523,"plans":[{"planId":"pro_plan"}]}] });
      * ```
      *
      * @param customerId - The ID of the customer to create the schedule for.
      * @param entityId - Optional entity ID for an entity-scoped schedule. (optional)
      * @param invoiceMode - Invoice mode creates and sends an invoice instead of charging the customer's payment method immediately for the first phase. (optional)
+     * @param discounts - List of discounts to apply to the immediate phase. Each discount can be an Autumn reward ID, Stripe coupon ID, or Stripe promotion code. (optional)
      * @param successUrl - URL to redirect to after successful checkout. (optional)
      * @param checkoutSessionParams - Additional parameters to pass into the creation of the Stripe checkout session. (optional)
      * @param redirectMode - Controls when to return a checkout URL for the immediate phase. 'always' forces a confirmation or checkout flow, 'if_required' only redirects when needed, and 'never' disables redirects. (optional)
@@ -17239,6 +17756,7 @@ declare class Entities extends ClientSDK {
      * @param subscriptionStatus - Filter customer products used for entity hydration and plan matching. Defaults to active and scheduled. (optional)
      * @param search - Search entities by id or name. (optional)
      * @param processors - Filter by parent customer processor type (stripe, revenuecat, vercel). (optional)
+     * @param customerId - Restrict the response to entities owned by this customer id. Use to bulk-fetch all entities for one customer in a single paginated call instead of iterating entities.get. (optional)
      *
      * @returns A paginated list of entity objects including their current subscriptions, purchases, balances, and flags.
      */
@@ -17597,6 +18115,21 @@ declare class Plans extends ClientSDK {
     delete(request: DeletePlanParams, options?: RequestOptions): Promise<DeletePlanResponse>;
 }
 
+declare class Platform extends ClientSDK {
+    /**
+     * Generate a RevenueCat OAuth URL for linking a project to an organization.
+     */
+    linkRevenueCat(request: LinkRevenueCatParams, options?: RequestOptions): Promise<LinkRevenueCatResponse>;
+    /**
+     * Push an organization's plans into RevenueCat as products (creating or renaming them across the project's apps) and set test-store prices from each plan's price. Requires the org to have linked RevenueCat via OAuth.
+     */
+    syncRevenueCat(request: SyncRevenueCatParams, options?: RequestOptions): Promise<SyncRevenueCatResponse>;
+    /**
+     * Retrieve a managed organization's RevenueCat public (SDK) API keys, grouped by app — for the test store, App Store, and Google Play Store. Use these to configure the RevenueCat SDK in the org's mobile app.
+     */
+    getRevenueCatKeys(request: GetRevenueCatKeysParams, options?: RequestOptions): Promise<GetRevenueCatKeysResponse>;
+}
+
 declare class Referrals extends ClientSDK {
     /**
      * Create or fetch a referral code for a customer in a referral program.
@@ -17634,6 +18167,8 @@ declare class Autumn extends ClientSDK {
     get referrals(): Referrals;
     private _rewards?;
     get rewards(): Rewards;
+    private _platform?;
+    get platform(): Platform;
     /**
      * Checks whether a customer currently has enough balance to use a feature.
      *
@@ -17692,10 +18227,15 @@ declare class Autumn extends ClientSDK {
      * @param eventName - Event name to track usage for. Use instead of feature_id when multiple features should be tracked from a single event. (optional)
      * @param value - The amount of usage to record. Defaults to 1. Use negative values to credit balance (e.g., when removing a seat). (optional)
      * @param properties - Additional properties to attach to this usage event. (optional)
+     * @param async - If true, enqueue the event for asynchronous processing and return 202 immediately. The response will not include balance information. (optional)
      *
      * @returns The usage value recorded, with either a single updated balance or a map of updated balances. If Autumn is experiencing degraded service from a downstream provider, the API may return 202 after accepting the event for replay so it can be tracked as soon as the service is restored.
      */
     track(request: TrackParams, options?: RequestOptions): Promise<TrackResponse>;
+    /**
+     * Enqueue up to 1000 usage events for asynchronous processing. Items are validated synchronously up front; validated items are then enqueued via SQS for background deduction by workers. The response returns 202 immediately and does not include balance information. On partial enqueue failure (some items fail to enqueue, others succeed), the endpoint still returns 202 and logs the failures server-side; clients should NOT retry, because retrying re-enqueues the already-succeeded items. A 503 is returned only when zero items were successfully enqueued (queue entirely unavailable) — that case is safe to retry.
+     */
+    batchTrack(request: Array<RequestBody>, options?: RequestOptions): Promise<BatchTrackResponse>;
 }
 
 /** All supported route names as const for type safety */
@@ -17736,8 +18276,10 @@ type RouteDefinition<T extends RouteName = RouteName> = {
     customHandler?: CustomHandlerFn;
     /** Whether customer ID is required (default: true) */
     requireCustomer?: boolean;
+    /** Body fields that must come from identity, not frontend */
+    protectedBodyFields?: readonly ProtectedBodyField[];
     /** Zod schema for request body validation (used by better-auth plugin) */
     bodySchema?: z.ZodTypeAny;
 };
 
-export { Autumn as A, type CustomHandlerArgs as C, type RouteDefinition as R, type CustomHandlerFn as a, type RouteName as b, ROUTE_NAMES as c };
+export { Autumn as A, type CustomHandlerArgs as C, ROUTE_NAMES as R, type CustomHandlerFn as a, type RouteDefinition as b, type RouteName as c };