autumn-js 0.1.10 → 0.1.12

package/dist/libraries/backend/{referralTypes-DpLmOy8-.d.mts → referralTypes-BOsjdpOb.d.mts}

@@ -1,4 +1,5 @@
-import { z } from 'zod';
+import { z } from 'zod/v4';
+import { z as z$1 } from 'zod';
 import { R as Result, A as AutumnError } from './response-CV6KGWH5.mjs';
 
 declare const Infinite = "inf";
@@ -29,9 +30,8 @@ declare const CheckFeatureResultSchema: z.ZodObject<{
     customer_id: z.ZodString;
     entity_id: z.ZodOptional<z.ZodString>;
     required_balance: z.ZodNumber;
-} & {
     unlimited: z.ZodOptional<z.ZodBoolean>;
-    interval: z.ZodOptional<z.ZodNativeEnum<typeof ProductItemInterval>>;
+    interval: z.ZodOptional<z.ZodEnum<typeof ProductItemInterval>>;
     balance: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     usage: z.ZodOptional<z.ZodNumber>;
     included_usage: z.ZodOptional<z.ZodNumber>;
@@ -41,101 +41,19 @@ declare const CheckFeatureResultSchema: z.ZodObject<{
     rollovers: z.ZodOptional<z.ZodObject<{
         balance: z.ZodNumber;
         expires_at: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        balance: number;
-        expires_at: number;
-    }, {
-        balance: number;
-        expires_at: number;
-    }>>;
+    }, z.core.$strip>>;
     breakdown: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        interval: z.ZodNativeEnum<typeof ProductItemInterval>;
+        interval: z.ZodEnum<typeof ProductItemInterval>;
         balance: z.ZodOptional<z.ZodNumber>;
         usage: z.ZodOptional<z.ZodNumber>;
         included_usage: z.ZodOptional<z.ZodNumber>;
         next_reset_at: z.ZodOptional<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        interval: ProductItemInterval;
-        balance?: number | undefined;
-        usage?: number | undefined;
-        included_usage?: number | undefined;
-        next_reset_at?: number | undefined;
-    }, {
-        interval: ProductItemInterval;
-        balance?: number | undefined;
-        usage?: number | undefined;
-        included_usage?: number | undefined;
-        next_reset_at?: number | undefined;
-    }>, "many">>;
+    }, z.core.$strip>>>;
     credit_schema: z.ZodOptional<z.ZodArray<z.ZodObject<{
         feature_id: z.ZodString;
         credit_amount: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        feature_id: string;
-        credit_amount: number;
-    }, {
-        feature_id: string;
-        credit_amount: number;
-    }>, "many">>;
-}, "strip", z.ZodTypeAny, {
-    customer_id: string;
-    feature_id: string;
-    required_balance: number;
-    allowed: boolean;
-    entity_id?: string | undefined;
-    usage_limit?: number | undefined;
-    unlimited?: boolean | undefined;
-    interval?: ProductItemInterval | undefined;
-    balance?: number | null | undefined;
-    usage?: number | undefined;
-    included_usage?: number | undefined;
-    next_reset_at?: number | null | undefined;
-    overage_allowed?: boolean | undefined;
-    rollovers?: {
-        balance: number;
-        expires_at: number;
-    } | undefined;
-    breakdown?: {
-        interval: ProductItemInterval;
-        balance?: number | undefined;
-        usage?: number | undefined;
-        included_usage?: number | undefined;
-        next_reset_at?: number | undefined;
-    }[] | undefined;
-    credit_schema?: {
-        feature_id: string;
-        credit_amount: number;
-    }[] | undefined;
-}, {
-    customer_id: string;
-    feature_id: string;
-    required_balance: number;
-    allowed: boolean;
-    entity_id?: string | undefined;
-    usage_limit?: number | undefined;
-    unlimited?: boolean | undefined;
-    interval?: ProductItemInterval | undefined;
-    balance?: number | null | undefined;
-    usage?: number | undefined;
-    included_usage?: number | undefined;
-    next_reset_at?: number | null | undefined;
-    overage_allowed?: boolean | undefined;
-    rollovers?: {
-        balance: number;
-        expires_at: number;
-    } | undefined;
-    breakdown?: {
-        interval: ProductItemInterval;
-        balance?: number | undefined;
-        usage?: number | undefined;
-        included_usage?: number | undefined;
-        next_reset_at?: number | undefined;
-    }[] | undefined;
-    credit_schema?: {
-        feature_id: string;
-        credit_amount: number;
-    }[] | undefined;
-}>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
 type CheckFeatureResult = z.infer<typeof CheckFeatureResultSchema>;
 type ProductScenario = "scheduled" | "active" | "new" | "renew" | "upgrade" | "downgrade" | "cancel";
 interface CheckProductResult {
@@ -265,7 +183,7 @@ type CustomerExpandOption = "invoices" | "rewards" | "trials_used" | "entities"
 
 declare const CoreCusFeatureSchema: z.ZodObject<{
     unlimited: z.ZodOptional<z.ZodBoolean>;
-    interval: z.ZodOptional<z.ZodNativeEnum<typeof ProductItemInterval>>;
+    interval: z.ZodOptional<z.ZodEnum<typeof ProductItemInterval>>;
     balance: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     usage: z.ZodOptional<z.ZodNumber>;
     included_usage: z.ZodOptional<z.ZodNumber>;
@@ -275,91 +193,19 @@ declare const CoreCusFeatureSchema: z.ZodObject<{
     rollovers: z.ZodOptional<z.ZodObject<{
         balance: z.ZodNumber;
         expires_at: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        balance: number;
-        expires_at: number;
-    }, {
-        balance: number;
-        expires_at: number;
-    }>>;
+    }, z.core.$strip>>;
     breakdown: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        interval: z.ZodNativeEnum<typeof ProductItemInterval>;
+        interval: z.ZodEnum<typeof ProductItemInterval>;
         balance: z.ZodOptional<z.ZodNumber>;
         usage: z.ZodOptional<z.ZodNumber>;
         included_usage: z.ZodOptional<z.ZodNumber>;
         next_reset_at: z.ZodOptional<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        interval: ProductItemInterval;
-        balance?: number | undefined;
-        usage?: number | undefined;
-        included_usage?: number | undefined;
-        next_reset_at?: number | undefined;
-    }, {
-        interval: ProductItemInterval;
-        balance?: number | undefined;
-        usage?: number | undefined;
-        included_usage?: number | undefined;
-        next_reset_at?: number | undefined;
-    }>, "many">>;
+    }, z.core.$strip>>>;
     credit_schema: z.ZodOptional<z.ZodArray<z.ZodObject<{
         feature_id: z.ZodString;
         credit_amount: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        feature_id: string;
-        credit_amount: number;
-    }, {
-        feature_id: string;
-        credit_amount: number;
-    }>, "many">>;
-}, "strip", z.ZodTypeAny, {
-    usage_limit?: number | undefined;
-    unlimited?: boolean | undefined;
-    interval?: ProductItemInterval | undefined;
-    balance?: number | null | undefined;
-    usage?: number | undefined;
-    included_usage?: number | undefined;
-    next_reset_at?: number | null | undefined;
-    overage_allowed?: boolean | undefined;
-    rollovers?: {
-        balance: number;
-        expires_at: number;
-    } | undefined;
-    breakdown?: {
-        interval: ProductItemInterval;
-        balance?: number | undefined;
-        usage?: number | undefined;
-        included_usage?: number | undefined;
-        next_reset_at?: number | undefined;
-    }[] | undefined;
-    credit_schema?: {
-        feature_id: string;
-        credit_amount: number;
-    }[] | undefined;
-}, {
-    usage_limit?: number | undefined;
-    unlimited?: boolean | undefined;
-    interval?: ProductItemInterval | undefined;
-    balance?: number | null | undefined;
-    usage?: number | undefined;
-    included_usage?: number | undefined;
-    next_reset_at?: number | null | undefined;
-    overage_allowed?: boolean | undefined;
-    rollovers?: {
-        balance: number;
-        expires_at: number;
-    } | undefined;
-    breakdown?: {
-        interval: ProductItemInterval;
-        balance?: number | undefined;
-        usage?: number | undefined;
-        included_usage?: number | undefined;
-        next_reset_at?: number | undefined;
-    }[] | undefined;
-    credit_schema?: {
-        feature_id: string;
-        credit_amount: number;
-    }[] | undefined;
-}>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
 type CoreCustomerFeature = z.infer<typeof CoreCusFeatureSchema>;
 interface CustomerFeature extends CoreCustomerFeature {
     id: string;
@@ -401,15 +247,7 @@ declare const CustomerDataSchema: z.ZodObject<{
     name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     fingerprint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, "strip", z.ZodTypeAny, {
-    name?: string | null | undefined;
-    email?: string | null | undefined;
-    fingerprint?: string | null | undefined;
-}, {
-    name?: string | null | undefined;
-    email?: string | null | undefined;
-    fingerprint?: string | null | undefined;
-}>;
+}, z.core.$strip>;
 type CustomerData = z.infer<typeof CustomerDataSchema>;
 interface GetCustomerParams {
     expand?: CustomerExpandOption[];
@@ -420,22 +258,15 @@ declare const CreateCustomerParamsSchema: z.ZodObject<{
     name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     fingerprint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-    expand: z.ZodOptional<z.ZodArray<z.ZodEnum<["invoices", "rewards", "trials_used", "entities", "referrals", "payment_method"]>, "many">>;
-}, "strip", z.ZodTypeAny, {
-    metadata?: Record<string, any> | undefined;
-    expand?: ("invoices" | "rewards" | "trials_used" | "entities" | "referrals" | "payment_method")[] | undefined;
-    name?: string | null | undefined;
-    email?: string | null | undefined;
-    fingerprint?: string | null | undefined;
-    id?: string | null | undefined;
-}, {
-    metadata?: Record<string, any> | undefined;
-    expand?: ("invoices" | "rewards" | "trials_used" | "entities" | "referrals" | "payment_method")[] | undefined;
-    name?: string | null | undefined;
-    email?: string | null | undefined;
-    fingerprint?: string | null | undefined;
-    id?: string | null | undefined;
-}>;
+    expand: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        invoices: "invoices";
+        rewards: "rewards";
+        trials_used: "trials_used";
+        entities: "entities";
+        referrals: "referrals";
+        payment_method: "payment_method";
+    }>>>;
+}, z.core.$strip>;
 type CreateCustomerParams = z.infer<typeof CreateCustomerParamsSchema>;
 interface UpdateCustomerParams {
     id?: string | null;
@@ -445,11 +276,7 @@ interface UpdateCustomerParams {
 }
 declare const BillingPortalParamsSchema: z.ZodObject<{
     return_url: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    return_url?: string | undefined;
-}, {
-    return_url?: string | undefined;
-}>;
+}, z.core.$strip>;
 type BillingPortalParams = z.infer<typeof BillingPortalParamsSchema>;
 interface BillingPortalResult {
     customer_id: string;
@@ -467,22 +294,10 @@ interface CustomerInvoice {
 declare const UpdateBalancesParamsSchema: z.ZodUnion<[z.ZodObject<{
     feature_id: z.ZodString;
     balance: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    feature_id: string;
-    balance: number;
-}, {
-    feature_id: string;
-    balance: number;
-}>, z.ZodArray<z.ZodObject<{
+}, z.core.$strip>, z.ZodArray<z.ZodObject<{
     feature_id: z.ZodString;
     balance: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    feature_id: string;
-    balance: number;
-}, {
-    feature_id: string;
-    balance: number;
-}>, "many">]>;
+}, z.core.$strip>>]>;
 type UpdateBalancesParams = z.infer<typeof UpdateBalancesParamsSchema>;
 type UpdateBalancesResult = {
     success: boolean;
@@ -493,17 +308,7 @@ declare const CancelParamsSchema: z.ZodObject<{
     product_id: z.ZodString;
     entity_id: z.ZodOptional<z.ZodString>;
     cancel_immediately: z.ZodOptional<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
-    customer_id: string;
-    product_id: string;
-    entity_id?: string | undefined;
-    cancel_immediately?: boolean | undefined;
-}, {
-    customer_id: string;
-    product_id: string;
-    entity_id?: string | undefined;
-    cancel_immediately?: boolean | undefined;
-}>;
+}, z.core.$strip>;
 type CancelParams = z.infer<typeof CancelParamsSchema>;
 declare const TrackParamsSchema: z.ZodObject<{
     customer_id: z.ZodString;
@@ -514,25 +319,7 @@ declare const TrackParamsSchema: z.ZodObject<{
     customer_data: z.ZodOptional<z.ZodAny>;
     idempotency_key: z.ZodOptional<z.ZodString>;
     entity_data: z.ZodOptional<z.ZodAny>;
-}, "strip", z.ZodTypeAny, {
-    customer_id: string;
-    value?: number | undefined;
-    entity_id?: string | undefined;
-    feature_id?: string | undefined;
-    customer_data?: any;
-    entity_data?: any;
-    event_name?: string | undefined;
-    idempotency_key?: string | undefined;
-}, {
-    customer_id: string;
-    value?: number | undefined;
-    entity_id?: string | undefined;
-    feature_id?: string | undefined;
-    customer_data?: any;
-    entity_data?: any;
-    event_name?: string | undefined;
-    idempotency_key?: string | undefined;
-}>;
+}, z.core.$strip>;
 type TrackParams = z.infer<typeof TrackParamsSchema>;
 declare const CheckParamsSchema: z.ZodObject<{
     customer_id: z.ZodString;
@@ -546,40 +333,8 @@ declare const CheckParamsSchema: z.ZodObject<{
     entity_data: z.ZodOptional<z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         feature_id: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        feature_id: string;
-        name?: string | undefined;
-    }, {
-        feature_id: string;
-        name?: string | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    customer_id: string;
-    product_id?: string | undefined;
-    entity_id?: string | undefined;
-    feature_id?: string | undefined;
-    customer_data?: any;
-    entity_data?: {
-        feature_id: string;
-        name?: string | undefined;
-    } | undefined;
-    required_balance?: number | undefined;
-    send_event?: boolean | undefined;
-    with_preview?: boolean | undefined;
-}, {
-    customer_id: string;
-    product_id?: string | undefined;
-    entity_id?: string | undefined;
-    feature_id?: string | undefined;
-    customer_data?: any;
-    entity_data?: {
-        feature_id: string;
-        name?: string | undefined;
-    } | undefined;
-    required_balance?: number | undefined;
-    send_event?: boolean | undefined;
-    with_preview?: boolean | undefined;
-}>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 type CheckParams = z.infer<typeof CheckParamsSchema>;
 type CheckResult = CheckFeatureResult & CheckProductResult;
 interface UsageParams {
@@ -604,17 +359,15 @@ interface SetupPaymentResult {
 }
 declare const QueryParamsSchema: z.ZodObject<{
     customer_id: z.ZodString;
-    feature_id: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
-    range: z.ZodOptional<z.ZodEnum<["24h", "7d", "30d", "90d", "last_cycle"]>>;
-}, "strip", z.ZodTypeAny, {
-    customer_id: string;
-    feature_id: string | string[];
-    range?: "24h" | "7d" | "30d" | "90d" | "last_cycle" | undefined;
-}, {
-    customer_id: string;
-    feature_id: string | string[];
-    range?: "24h" | "7d" | "30d" | "90d" | "last_cycle" | undefined;
-}>;
+    feature_id: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString>]>;
+    range: z.ZodOptional<z.ZodEnum<{
+        "24h": "24h";
+        "7d": "7d";
+        "30d": "30d";
+        "90d": "90d";
+        last_cycle: "last_cycle";
+    }>>;
+}, z.core.$strip>;
 type QueryParams = z.infer<typeof QueryParamsSchema>;
 type QueryResult = {
     list: Array<{
@@ -627,13 +380,7 @@ type QueryResult = {
 declare const AttachFeatureOptionsSchema: z.ZodObject<{
     feature_id: z.ZodString;
     quantity: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    feature_id: string;
-    quantity: number;
-}, {
-    feature_id: string;
-    quantity: number;
-}>;
+}, z.core.$strip>;
 type AttachFeatureOptions = z.infer<typeof AttachFeatureOptionsSchema>;
 declare const AttachParamsSchema: z.ZodObject<{
     customer_id: z.ZodString;
@@ -642,14 +389,8 @@ declare const AttachParamsSchema: z.ZodObject<{
     options: z.ZodOptional<z.ZodArray<z.ZodObject<{
         feature_id: z.ZodString;
         quantity: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        feature_id: string;
-        quantity: number;
-    }, {
-        feature_id: string;
-        quantity: number;
-    }>, "many">>;
-    product_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.core.$strip>>>;
+    product_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
     free_trial: z.ZodOptional<z.ZodBoolean>;
     success_url: z.ZodOptional<z.ZodString>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -658,64 +399,12 @@ declare const AttachParamsSchema: z.ZodObject<{
         name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         fingerprint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        name?: string | null | undefined;
-        email?: string | null | undefined;
-        fingerprint?: string | null | undefined;
-    }, {
-        name?: string | null | undefined;
-        email?: string | null | undefined;
-        fingerprint?: string | null | undefined;
-    }>>;
+    }, z.core.$strip>>;
     entity_data: z.ZodOptional<z.ZodAny>;
     checkout_session_params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     reward: z.ZodOptional<z.ZodString>;
     invoice: z.ZodOptional<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
-    customer_id: string;
-    options?: {
-        feature_id: string;
-        quantity: number;
-    }[] | undefined;
-    metadata?: Record<string, string> | undefined;
-    product_id?: string | undefined;
-    entity_id?: string | undefined;
-    success_url?: string | undefined;
-    customer_data?: {
-        name?: string | null | undefined;
-        email?: string | null | undefined;
-        fingerprint?: string | null | undefined;
-    } | undefined;
-    entity_data?: any;
-    checkout_session_params?: Record<string, any> | undefined;
-    reward?: string | undefined;
-    product_ids?: string[] | undefined;
-    free_trial?: boolean | undefined;
-    force_checkout?: boolean | undefined;
-    invoice?: boolean | undefined;
-}, {
-    customer_id: string;
-    options?: {
-        feature_id: string;
-        quantity: number;
-    }[] | undefined;
-    metadata?: Record<string, string> | undefined;
-    product_id?: string | undefined;
-    entity_id?: string | undefined;
-    success_url?: string | undefined;
-    customer_data?: {
-        name?: string | null | undefined;
-        email?: string | null | undefined;
-        fingerprint?: string | null | undefined;
-    } | undefined;
-    entity_data?: any;
-    checkout_session_params?: Record<string, any> | undefined;
-    reward?: string | undefined;
-    product_ids?: string[] | undefined;
-    free_trial?: boolean | undefined;
-    force_checkout?: boolean | undefined;
-    invoice?: boolean | undefined;
-}>;
+}, z.core.$strip>;
 type AttachParams = z.infer<typeof AttachParamsSchema>;
 declare const CheckoutParamsSchema: z.ZodObject<{
     customer_id: z.ZodString;
@@ -724,65 +413,19 @@ declare const CheckoutParamsSchema: z.ZodObject<{
     options: z.ZodOptional<z.ZodArray<z.ZodObject<{
         feature_id: z.ZodString;
         quantity: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        feature_id: string;
-        quantity: number;
-    }, {
-        feature_id: string;
-        quantity: number;
-    }>, "many">>;
+    }, z.core.$strip>>>;
+    force_checkout: z.ZodOptional<z.ZodBoolean>;
+    invoice: z.ZodOptional<z.ZodBoolean>;
     success_url: z.ZodOptional<z.ZodString>;
     customer_data: z.ZodOptional<z.ZodObject<{
         name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         email: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         fingerprint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        name?: string | null | undefined;
-        email?: string | null | undefined;
-        fingerprint?: string | null | undefined;
-    }, {
-        name?: string | null | undefined;
-        email?: string | null | undefined;
-        fingerprint?: string | null | undefined;
-    }>>;
+    }, z.core.$strip>>;
     entity_data: z.ZodOptional<z.ZodAny>;
     checkout_session_params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     reward: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    customer_id: string;
-    product_id: string;
-    options?: {
-        feature_id: string;
-        quantity: number;
-    }[] | undefined;
-    entity_id?: string | undefined;
-    success_url?: string | undefined;
-    customer_data?: {
-        name?: string | null | undefined;
-        email?: string | null | undefined;
-        fingerprint?: string | null | undefined;
-    } | undefined;
-    entity_data?: any;
-    checkout_session_params?: Record<string, any> | undefined;
-    reward?: string | undefined;
-}, {
-    customer_id: string;
-    product_id: string;
-    options?: {
-        feature_id: string;
-        quantity: number;
-    }[] | undefined;
-    entity_id?: string | undefined;
-    success_url?: string | undefined;
-    customer_data?: {
-        name?: string | null | undefined;
-        email?: string | null | undefined;
-        fingerprint?: string | null | undefined;
-    } | undefined;
-    entity_data?: any;
-    checkout_session_params?: Record<string, any> | undefined;
-    reward?: string | undefined;
-}>;
+}, z.core.$strip>;
 type CheckoutParams = z.infer<typeof CheckoutParamsSchema>;
 type CheckoutResult = {
     url?: string;
@@ -810,33 +453,33 @@ declare enum FeatureType {
     ContinuousUse = "continuous_use",
     CreditSystem = "credit_system"
 }
-declare const FeatureSchema: z.ZodObject<{
-    id: z.ZodString;
-    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    type: z.ZodNativeEnum<typeof FeatureType>;
-    display: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        singular: z.ZodString;
-        plural: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
+declare const FeatureSchema: z$1.ZodObject<{
+    id: z$1.ZodString;
+    name: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodString>>;
+    type: z$1.ZodNativeEnum<typeof FeatureType>;
+    display: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodObject<{
+        singular: z$1.ZodString;
+        plural: z$1.ZodString;
+    }, "strip", z$1.ZodTypeAny, {
         singular: string;
         plural: string;
     }, {
         singular: string;
         plural: string;
     }>>>;
-    credit_schema: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
-        metered_feature_id: z.ZodString;
-        credit_cost: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
+    credit_schema: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodArray<z$1.ZodObject<{
+        metered_feature_id: z$1.ZodString;
+        credit_cost: z$1.ZodNumber;
+    }, "strip", z$1.ZodTypeAny, {
         metered_feature_id: string;
         credit_cost: number;
     }, {
         metered_feature_id: string;
         credit_cost: number;
     }>, "many">>>;
-}, "strip", z.ZodTypeAny, {
-    type: FeatureType;
+}, "strip", z$1.ZodTypeAny, {
     id: string;
+    type: FeatureType;
     name?: string | null | undefined;
     credit_schema?: {
         metered_feature_id: string;
@@ -847,8 +490,8 @@ declare const FeatureSchema: z.ZodObject<{
         plural: string;
     } | null | undefined;
 }, {
-    type: FeatureType;
     id: string;
+    type: FeatureType;
     name?: string | null | undefined;
     credit_schema?: {
         metered_feature_id: string;
@@ -859,7 +502,7 @@ declare const FeatureSchema: z.ZodObject<{
         plural: string;
     } | null | undefined;
 }>;
-type Feature = z.infer<typeof FeatureSchema>;
+type Feature = z$1.infer<typeof FeatureSchema>;
 
 declare class Autumn {
     private readonly secretKey;
@@ -938,13 +581,68 @@ declare class Autumn {
             list: Feature[];
         }, AutumnError>>;
     };
-    static checkout: (params: CheckoutParams) => Promise<Result<CheckoutResult, AutumnError>>;
+    /**
+     * Initiates a checkout flow for a product purchase.
+     *
+     * The checkout function handles the purchase process for products with pricing.
+     * It determines whether to show a dialog for user input or redirect directly
+     * to Stripe based on the customer's state and product requirements.
+     *
+     * @param params - Checkout parameters including product ID, customer data, and options
+     * @returns Promise resolving to checkout details including pricing, prorations, and URLs
+     *
+     * @example
+     * ```typescript
+     * const result = await autumn.checkout({
+     *   customer_id: "user_123",
+     *   product_id: "pro",
+     *   success_url: "https://myapp.com/success"
+     * });
+     *
+     * if (result.url) {
+     *   // Redirect to Stripe checkout
+     *   window.location.href = result.url;
+     * }
+     * ```
+     */
     checkout(params: CheckoutParams): Promise<Result<CheckoutResult, AutumnError>>;
-    static attach: (params: AttachParams) => Promise<Result<{
-        message: string;
-        code: string;
+    static checkout: (params: CheckoutParams) => Promise<Result<CheckoutResult, AutumnError>>;
+    static usage: (params: UsageParams) => Promise<Result<UsageResult, AutumnError>>;
+    /**
+     * Attaches a product to a customer, enabling access and handling billing.
+     *
+     * The attach function activates a product for a customer and applies all product items.
+     * When you attach a product:
+     * - The customer gains access to all features in the product
+     * - If the product has prices, the customer will be billed accordingly
+     * - If there's no existing payment method, a checkout URL will be generated
+     *
+     * @param params - Attach parameters including customer ID, product ID, and options
+     * @returns Promise resolving to attachment result with checkout URL if needed
+     *
+     * @example
+     * ```typescript
+     * const result = await autumn.attach({
+     *   customer_id: "user_123",
+     *   product_id: "pro",
+     *   success_url: "https://myapp.com/success"
+     * });
+     *
+     * if (result.checkout_url) {
+     *   // Payment required - redirect to checkout
+     *   window.location.href = result.checkout_url;
+     * } else {
+     *   // Product successfully attached
+     *   console.log("Access granted:", result.message);
+     * }
+     * ```
+     */
+    attach(params: AttachParams): Promise<Result<{
         customer_id: string;
         product_ids: string[];
+        code: string;
+        message: string;
+        checkout_url?: string | undefined;
         customer_data?: any;
         invoice?: {
             status: string;
@@ -953,14 +651,13 @@ declare class Autumn {
             total: number;
             currency: string;
         } | undefined;
-        checkout_url?: string | undefined;
     }, AutumnError>>;
-    static usage: (params: UsageParams) => Promise<Result<UsageResult, AutumnError>>;
-    attach(params: AttachParams): Promise<Result<{
-        message: string;
-        code: string;
+    static attach: (params: AttachParams) => Promise<Result<{
         customer_id: string;
         product_ids: string[];
+        code: string;
+        message: string;
+        checkout_url?: string | undefined;
         customer_data?: any;
         invoice?: {
             status: string;
@@ -969,38 +666,152 @@ declare class Autumn {
             total: number;
             currency: string;
         } | undefined;
-        checkout_url?: string | undefined;
     }, AutumnError>>;
     static setupPayment: (params: SetupPaymentParams) => Promise<Result<SetupPaymentResult, AutumnError>>;
+    /**
+     * Sets up a payment method for a customer.
+     *
+     * This method allows you to set up payment methods for customers without
+     * immediately charging them. Useful for collecting payment information
+     * before product attachment or for updating existing payment methods.
+     *
+     * @param params - Setup payment parameters including customer information
+     * @returns Promise resolving to setup payment result
+     *
+     * @example
+     * ```typescript
+     * const result = await autumn.setupPayment({
+     *   customer_id: "user_123"
+     * });
+     * ```
+     */
     setupPayment(params: SetupPaymentParams): Promise<Result<SetupPaymentResult, AutumnError>>;
     static cancel: (params: CancelParams) => Promise<Result<{
+        success: boolean;
         customer_id: string;
         product_id: string;
-        success: boolean;
     }, AutumnError>>;
+    /**
+     * Cancels a customer's subscription or product attachment.
+     *
+     * This method allows you to cancel a customer's subscription to a specific product.
+     * You can choose to cancel immediately or at the end of the billing cycle.
+     *
+     * @param params - Cancel parameters including customer ID and product ID
+     * @returns Promise resolving to cancellation result
+     *
+     * @example
+     * ```typescript
+     * const result = await autumn.cancel({
+     *   customer_id: "user_123",
+     *   product_id: "pro",
+     *   cancel_immediately: false // Cancel at end of billing cycle
+     * });
+     * ```
+     */
     cancel(params: CancelParams): Promise<Result<{
+        success: boolean;
         customer_id: string;
         product_id: string;
-        success: boolean;
     }, AutumnError>>;
     static check: (params: CheckParams) => Promise<Result<CheckResult, AutumnError>>;
+    /**
+     * Checks if a customer has access to a specific feature.
+     *
+     * This method verifies whether a customer has permission to use a feature
+     * and checks their remaining balance/usage limits. It can be used to gate
+     * features and determine when to show upgrade prompts.
+     *
+     * @param params - Check parameters including customer ID and feature ID
+     * @returns Promise resolving to access check result with allowed status and balance info
+     *
+     * @example
+     * ```typescript
+     * const result = await autumn.check({
+     *   customer_id: "user_123",
+     *   feature_id: "messages",
+     *   required_balance: 1
+     * });
+     *
+     * if (!result.allowed) {
+     *   console.log("Feature access denied - upgrade required");
+     * }
+     * ```
+     */
     check(params: CheckParams): Promise<Result<CheckResult, AutumnError>>;
     static track: (params: TrackParams) => Promise<Result<{
+        id: string;
         code: string;
         customer_id: string;
-        id: string;
         feature_id?: string | undefined;
         event_name?: string | undefined;
     }, AutumnError>>;
+    /**
+     * Tracks usage events for features or analytics.
+     *
+     * This method records usage events for metered features, updating the customer's
+     * balance and usage statistics. It's typically used server-side to ensure
+     * accurate tracking that cannot be manipulated by users.
+     *
+     * @param params - Track parameters including customer ID, feature ID, and usage value
+     * @returns Promise resolving to tracking result
+     *
+     * @example
+     * ```typescript
+     * const result = await autumn.track({
+     *   customer_id: "user_123",
+     *   feature_id: "messages",
+     *   value: 1 // Track 1 message sent
+     * });
+     * ```
+     */
     track(params: TrackParams): Promise<Result<{
+        id: string;
         code: string;
         customer_id: string;
-        id: string;
         feature_id?: string | undefined;
         event_name?: string | undefined;
     }, AutumnError>>;
+    /**
+     * Retrieves usage statistics and analytics for a customer.
+     *
+     * This method fetches detailed usage information for a customer's features,
+     * including current balances, usage history, and analytics data. Useful
+     * for displaying usage dashboards or generating reports.
+     *
+     * @param params - Usage parameters including customer ID and optional filters
+     * @returns Promise resolving to usage statistics and analytics data
+     *
+     * @example
+     * ```typescript
+     * const result = await autumn.usage({
+     *   customer_id: "user_123",
+     *   feature_id: "messages"
+     *   value: 20 // Usage value
+     * });
+     * ```
+     */
     usage(params: UsageParams): Promise<Result<UsageResult, AutumnError>>;
     static query: (params: QueryParams) => Promise<Result<QueryResult, AutumnError>>;
+    /**
+     * Performs advanced queries on customer data and analytics.
+     *
+     * This method allows you to run complex queries against customer data,
+     * usage patterns, and billing information. Useful for generating reports,
+     * analytics, and custom data insights.
+     *
+     * @param params - Query parameters including customer ID and query specifications
+     * @returns Promise resolving to query results with requested data
+     *
+     * @example
+     * ```typescript
+     * const result = await autumn.query({
+     *   customer_id: "user_123",
+     *   feature_id: "messages" // feature id to fetch for query, can also be an array
+     * });
+     *
+     * ```
+     */
     query(params: QueryParams): Promise<Result<QueryResult, AutumnError>>;
 }
 
@@ -1035,15 +846,7 @@ declare const TransferProductParamsSchema: z.ZodObject<{
     from_entity_id: z.ZodString;
     to_entity_id: z.ZodString;
     product_id: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    product_id: string;
-    from_entity_id: string;
-    to_entity_id: string;
-}, {
-    product_id: string;
-    from_entity_id: string;
-    to_entity_id: string;
-}>;
+}, z.core.$strip>;
 type TransferProductParams = z.infer<typeof TransferProductParamsSchema>;
 type TransferProductResult = {
     success: boolean;
@@ -1052,24 +855,12 @@ type TransferProductResult = {
 declare const CreateReferralCodeParamsSchema: z.ZodObject<{
     customer_id: z.ZodString;
     program_id: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    customer_id: string;
-    program_id: string;
-}, {
-    customer_id: string;
-    program_id: string;
-}>;
+}, z.core.$strip>;
 type CreateReferralCodeParams = z.infer<typeof CreateReferralCodeParamsSchema>;
 declare const RedeemReferralCodeParamsSchema: z.ZodObject<{
     code: z.ZodString;
     customer_id: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    code: string;
-    customer_id: string;
-}, {
-    code: string;
-    customer_id: string;
-}>;
+}, z.core.$strip>;
 type RedeemReferralCodeParams = z.infer<typeof RedeemReferralCodeParamsSchema>;
 
 export { Autumn as A, type CustomerData as C };