@stardeckai/autumn-js 0.1.85

package/dist/next/client/hooks/useCustomer.d.ts

@@ -0,0 +1,89 @@
+import { b as CustomerExpandOption, c as ExpandedCustomer, B as BillingPortalResult, E as Entity } from '../cusTypes-BgJmgZt6.js';
+import { A as AttachParams, f as CheckResult, T as TrackParams, a as TrackResult, C as CancelParams, b as CancelResult, S as SetupPaymentParams, c as SetupPaymentResult, O as OpenBillingPortalParams, d as CheckoutParams, e as CheckParams } from '../clientAttachTypes-Dczm087t.js';
+import { A as AttachResult, C as CheckoutResult, a as CreateEntityParams, b as CreateReferralCodeResult, R as RedeemReferralCodeResult } from '../clientEntTypes-CeaZbrIq.js';
+import { A as AutumnPromise, S as Success } from '../response-CLgEplsF.js';
+import { A as AutumnError } from '../error-DHbclCVh.js';
+import { SWRConfiguration } from 'swr';
+import { z } from 'zod/v4';
+import '../prodTypes-G6W3NUPg.js';
+
+declare const CreateReferralCodeParamsSchema: z.ZodObject<{
+    programId: z.ZodString;
+}, z.core.$strip>;
+type CreateReferralCodeParams = z.infer<typeof CreateReferralCodeParamsSchema>;
+declare const RedeemReferralCodeParamsSchema: z.ZodObject<{
+    code: z.ZodString;
+}, z.core.$strip>;
+type RedeemReferralCodeParams = z.infer<typeof RedeemReferralCodeParamsSchema>;
+
+interface UseCustomerResult<T extends readonly CustomerExpandOption[] = readonly []> {
+    /** The current customer data including subscription and feature information */
+    customer: ExpandedCustomer<T> | null;
+    /** Whether customer data is currently being loaded */
+    isLoading: boolean;
+    /** Any error that occurred while fetching customer data */
+    error: AutumnError | null;
+    /**
+     * Attaches a product to the current customer, enabling access and handling billing.
+     * Activates a product and applies all product items with automatic payment handling.
+     */
+    attach: (params: AttachParams) => AutumnPromise<AttachResult | CheckResult>;
+    /**
+     * Tracks usage events for metered features.
+     * Records feature usage and updates customer balances server-side.
+     */
+    track: (params: TrackParams) => AutumnPromise<TrackResult>;
+    /**
+     * Cancels a customer's subscription or product attachment.
+     * Can cancel immediately or at the end of the billing cycle.
+     */
+    cancel: (params: CancelParams) => AutumnPromise<CancelResult>;
+    /**
+     * Sets up a payment method for the customer.
+     * Collects payment information without immediately charging.
+     */
+    setupPayment: (params?: SetupPaymentParams) => AutumnPromise<SetupPaymentResult>;
+    /**
+     * Opens the Stripe billing portal for the customer.
+     * Allows customers to manage their subscription and payment methods.
+     */
+    openBillingPortal: (params?: OpenBillingPortalParams) => AutumnPromise<BillingPortalResult>;
+    /**
+     * Initiates a checkout flow for product purchase.
+     * Handles payment collection and redirects to Stripe checkout when needed.
+     */
+    checkout: (params: CheckoutParams) => AutumnPromise<CheckoutResult>;
+    /** Refetches the customer data from the server */
+    refetch: () => Promise<ExpandedCustomer<T> | null>;
+    /**
+     * Creates new entities for granular feature tracking.
+     * Entities allow per-user or per-workspace feature limits.
+     */
+    createEntity: (params: CreateEntityParams | CreateEntityParams[]) => AutumnPromise<Entity | Entity[]>;
+    /**
+     * Creates a referral code for the customer.
+     * Generates codes that can be shared for referral programs.
+     */
+    createReferralCode: (params: CreateReferralCodeParams) => AutumnPromise<CreateReferralCodeResult>;
+    /**
+     * Redeems a referral code for the customer.
+     * Applies referral benefits when a valid code is provided.
+     */
+    redeemReferralCode: (params: RedeemReferralCodeParams) => AutumnPromise<RedeemReferralCodeResult>;
+    /**
+     * Checks if a customer has access to a feature and shows paywalls if needed.
+     * Client-side feature gating with optional dialog display for upgrades.
+     */
+    check: (params: CheckParams) => Success<CheckResult>;
+}
+interface UseCustomerParams<T extends readonly CustomerExpandOption[] = readonly []> {
+    errorOnNotFound?: boolean;
+    expand?: T;
+    swrConfig?: SWRConfiguration;
+    /** Extra key(s) appended to the SWR query key that trigger a refetch when any value changes. */
+    extraQueryKeys?: (string | null | undefined)[];
+}
+
+declare const useCustomer: <const T extends readonly CustomerExpandOption[] = readonly []>(params?: UseCustomerParams<T>) => UseCustomerResult<T>;
+
+export { useCustomer };

package/dist/next/client/hooks/useCustomer.js

@@ -0,0 +1,15 @@
+"use client";
+
+import { AutumnContext } from "../../../libraries/react/AutumnContext";
+import {
+  useCustomerBase
+} from "../../../libraries/react/hooks/useCustomerBase";
+const useCustomer = (params) => {
+  return useCustomerBase({
+    params,
+    AutumnContext
+  });
+};
+export {
+  useCustomer
+};

package/dist/next/client/hooks/useCustomer.mjs

@@ -0,0 +1,15 @@
+"use client";
+
+import { AutumnContext } from "../../../libraries/react/AutumnContext";
+import {
+  useCustomerBase
+} from "../../../libraries/react/hooks/useCustomerBase";
+const useCustomer = (params) => {
+  return useCustomerBase({
+    params,
+    AutumnContext
+  });
+};
+export {
+  useCustomer
+};

package/dist/next/client/hooks/useEntity.d.mts

@@ -0,0 +1,27 @@
+import { e as CheckParams, f as CheckResult, A as AttachParams, C as CancelParams, T as TrackParams } from '../clientAttachTypes-CZ0FmsbF.mjs';
+import { A as AutumnError } from '../error-DHbclCVh.mjs';
+import { G as GetEntityParams, E as Entity } from '../cusTypes-BngiltFz.mjs';
+import '../prodTypes-G6W3NUPg.mjs';
+import 'zod/v4';
+
+declare const useEntity: (entityId: string | null, params?: GetEntityParams & {
+    /** Extra key(s) appended to the SWR query key that trigger a refetch when any value changes. */
+    extraQueryKeys?: (string | null | undefined)[];
+}) => {
+    entity: Entity | null;
+    isLoading: boolean;
+    error: AutumnError | undefined | null;
+    refetch: () => void;
+    check: (params: CheckParams) => {
+        data: CheckResult;
+        error: null;
+    } | {
+        data: null;
+        error: AutumnError;
+    };
+    attach: (params: AttachParams) => void;
+    cancel: (params: CancelParams) => void;
+    track: (params: TrackParams) => void;
+};
+
+export { useEntity };

package/dist/next/client/hooks/useEntity.d.ts

@@ -0,0 +1,27 @@
+import { e as CheckParams, f as CheckResult, A as AttachParams, C as CancelParams, T as TrackParams } from '../clientAttachTypes-Dczm087t.js';
+import { A as AutumnError } from '../error-DHbclCVh.js';
+import { G as GetEntityParams, E as Entity } from '../cusTypes-BgJmgZt6.js';
+import '../prodTypes-G6W3NUPg.js';
+import 'zod/v4';
+
+declare const useEntity: (entityId: string | null, params?: GetEntityParams & {
+    /** Extra key(s) appended to the SWR query key that trigger a refetch when any value changes. */
+    extraQueryKeys?: (string | null | undefined)[];
+}) => {
+    entity: Entity | null;
+    isLoading: boolean;
+    error: AutumnError | undefined | null;
+    refetch: () => void;
+    check: (params: CheckParams) => {
+        data: CheckResult;
+        error: null;
+    } | {
+        data: null;
+        error: AutumnError;
+    };
+    attach: (params: AttachParams) => void;
+    cancel: (params: CancelParams) => void;
+    track: (params: TrackParams) => void;
+};
+
+export { useEntity };

package/dist/next/client/hooks/useEntity.js

@@ -0,0 +1,11 @@
+"use client";
+
+import { useEntityBase } from "../../../libraries/react/hooks/useEntityBase";
+import { AutumnContext } from "../../../libraries/react/AutumnContext";
+const useEntity = (entityId, params) => {
+  const { extraQueryKeys, ...restParams } = params ?? {};
+  return useEntityBase({ AutumnContext, entityId, params: restParams, extraQueryKeys });
+};
+export {
+  useEntity
+};

package/dist/next/client/hooks/useEntity.mjs

@@ -0,0 +1,11 @@
+"use client";
+
+import { useEntityBase } from "../../../libraries/react/hooks/useEntityBase";
+import { AutumnContext } from "../../../libraries/react/AutumnContext";
+const useEntity = (entityId, params) => {
+  const { extraQueryKeys, ...restParams } = params ?? {};
+  return useEntityBase({ AutumnContext, entityId, params: restParams, extraQueryKeys });
+};
+export {
+  useEntity
+};

package/dist/next/client/hooks/usePricingTable.d.mts

@@ -0,0 +1,33 @@
+import { P as Product } from '../prodTypes-G6W3NUPg.mjs';
+import { A as AutumnError } from '../error-DHbclCVh.mjs';
+import 'zod/v4';
+
+interface ProductDetails {
+    id?: string;
+    name?: string;
+    description?: string;
+    buttonText?: string;
+    buttonUrl?: string;
+    recommendText?: string;
+    everythingFrom?: string;
+    price?: {
+        primaryText: string;
+        secondaryText?: string;
+    };
+    items?: {
+        featureId?: string;
+        primaryText?: string;
+        secondaryText?: string;
+    }[];
+}
+
+declare const usePricingTable: (params?: {
+    productDetails?: ProductDetails[];
+}) => {
+    products: Product[] | null;
+    isLoading: boolean;
+    error: AutumnError | undefined;
+    refetch: () => void;
+};
+
+export { usePricingTable };

package/dist/next/client/hooks/usePricingTable.d.ts

@@ -0,0 +1,33 @@
+import { P as Product } from '../prodTypes-G6W3NUPg.js';
+import { A as AutumnError } from '../error-DHbclCVh.js';
+import 'zod/v4';
+
+interface ProductDetails {
+    id?: string;
+    name?: string;
+    description?: string;
+    buttonText?: string;
+    buttonUrl?: string;
+    recommendText?: string;
+    everythingFrom?: string;
+    price?: {
+        primaryText: string;
+        secondaryText?: string;
+    };
+    items?: {
+        featureId?: string;
+        primaryText?: string;
+        secondaryText?: string;
+    }[];
+}
+
+declare const usePricingTable: (params?: {
+    productDetails?: ProductDetails[];
+}) => {
+    products: Product[] | null;
+    isLoading: boolean;
+    error: AutumnError | undefined;
+    refetch: () => void;
+};
+
+export { usePricingTable };

package/dist/next/client/hooks/usePricingTable.js

@@ -0,0 +1,14 @@
+"use client";
+
+import { usePricingTableBase } from "../../../libraries/react/hooks/usePricingTableBase";
+import { AutumnContext, useAutumnContext } from "../../../libraries/react/AutumnContext";
+const usePricingTable = (params) => {
+  const context = useAutumnContext({
+    AutumnContext,
+    name: "usePricingTable"
+  });
+  return usePricingTableBase({ client: context.client, params });
+};
+export {
+  usePricingTable
+};

package/dist/next/client/hooks/usePricingTable.mjs

@@ -0,0 +1,14 @@
+"use client";
+
+import { usePricingTableBase } from "../../../libraries/react/hooks/usePricingTableBase";
+import { AutumnContext, useAutumnContext } from "../../../libraries/react/AutumnContext";
+const usePricingTable = (params) => {
+  const context = useAutumnContext({
+    AutumnContext,
+    name: "usePricingTable"
+  });
+  return usePricingTableBase({ client: context.client, params });
+};
+export {
+  usePricingTable
+};

package/dist/next/client/prodTypes-G6W3NUPg.d.mts

@@ -0,0 +1,162 @@
+import { z } from 'zod/v4';
+
+declare const Infinite = "inf";
+declare enum FreeTrialDuration {
+    Day = "day"
+}
+declare enum UsageModel {
+    Prepaid = "prepaid",
+    PayPerUse = "pay_per_use"
+}
+type UsageModelType = "prepaid" | "pay_per_use";
+declare enum ProductItemInterval {
+    Minute = "minute",
+    Hour = "hour",
+    Day = "day",
+    Week = "week",
+    Month = "month",
+    Quarter = "quarter",
+    SemiAnnual = "semi_annual",
+    Year = "year",
+    Multiple = "multiple"
+}
+type ProductItemIntervalType = "minute" | "hour" | "day" | "week" | "month" | "quarter" | "semi_annual" | "year" | "multiple";
+
+declare const CheckFeatureResultSchema: z.ZodObject<{
+    allowed: z.ZodBoolean;
+    feature_id: z.ZodString;
+    customer_id: z.ZodString;
+    entity_id: z.ZodOptional<z.ZodString>;
+    required_balance: z.ZodNumber;
+    unlimited: z.ZodOptional<z.ZodBoolean>;
+    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>;
+    next_reset_at: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    overage_allowed: z.ZodOptional<z.ZodBoolean>;
+    usage_limit: z.ZodOptional<z.ZodNumber>;
+    rollovers: z.ZodOptional<z.ZodObject<{
+        balance: z.ZodNumber;
+        expires_at: z.ZodNumber;
+    }, z.core.$strip>>;
+    breakdown: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        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>;
+    }, z.core.$strip>>>;
+    credit_schema: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        feature_id: z.ZodString;
+        credit_amount: z.ZodNumber;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+type CheckFeatureResult = z.infer<typeof CheckFeatureResultSchema>;
+type ProductScenario = "scheduled" | "active" | "new" | "renew" | "upgrade" | "downgrade" | "cancel";
+interface CheckProductResult {
+    allowed: boolean;
+    customer_id: string;
+    product_id: string;
+    entity_id?: string;
+    status?: string;
+    preview?: CheckProductPreview;
+}
+interface CheckProductPreview {
+    scenario: ProductScenario;
+    product_id: string;
+    product_name: string;
+    recurring: boolean;
+    error_on_attach?: boolean;
+    next_cycle_at?: number;
+    current_product_name?: string;
+    items?: {
+        price: string;
+        description: string;
+        usage_model?: UsageModelType;
+    }[];
+    options?: {
+        feature_id: string;
+        feature_name: string;
+        billing_units: number;
+        price?: number;
+        tiers?: {
+            to: number | string;
+            amount: number;
+        }[];
+    }[];
+    due_today?: {
+        price: number;
+        currency: string;
+    };
+    due_next_cycle?: {
+        price: number;
+        currency: string;
+    };
+}
+
+declare enum AppEnv {
+    Sandbox = "sandbox",
+    Live = "live"
+}
+
+interface Feature {
+    id: string;
+    name: string;
+    type: "boolean" | "continuous_use" | "single_use" | "credit_system";
+}
+interface ProductItem {
+    type?: "feature" | "priced_feature" | "price";
+    feature_id?: string;
+    included_usage?: number | typeof Infinite;
+    interval?: ProductItemIntervalType;
+    feature?: Feature;
+    usage_model?: UsageModel;
+    price?: number;
+    billing_units?: number;
+    entity_feature_id?: string;
+    reset_usage_when_enabled?: boolean;
+    quantity?: number;
+    next_cycle_quantity?: number;
+    display?: {
+        primary_text?: string;
+        secondary_text?: string;
+    };
+}
+interface FreeTrial {
+    duration: FreeTrialDuration;
+    length: number;
+    unique_fingerprint: boolean;
+    trial_available?: boolean;
+}
+interface Product {
+    id: string;
+    created_at: number;
+    name: string;
+    env: AppEnv;
+    is_add_on: boolean;
+    is_default: boolean;
+    group: string;
+    version: number;
+    items: ProductItem[];
+    free_trial: FreeTrial | null;
+    scenario?: ProductScenario;
+    base_variant_id: string | null;
+    properties: {
+        is_free: boolean;
+        is_one_off: boolean;
+        interval_group: string;
+        has_trial: boolean;
+        updateable: boolean;
+    };
+    display?: {
+        name?: string;
+        description?: string;
+        button_text?: string;
+        recommend_text?: string;
+        everything_from?: string;
+        button_url?: string;
+    };
+}
+
+export { AppEnv as A, type CheckFeatureResult as C, type Product as P, type ProductItem as a, type CheckProductResult as b, ProductItemInterval as c };

package/dist/next/client/prodTypes-G6W3NUPg.d.ts

@@ -0,0 +1,162 @@
+import { z } from 'zod/v4';
+
+declare const Infinite = "inf";
+declare enum FreeTrialDuration {
+    Day = "day"
+}
+declare enum UsageModel {
+    Prepaid = "prepaid",
+    PayPerUse = "pay_per_use"
+}
+type UsageModelType = "prepaid" | "pay_per_use";
+declare enum ProductItemInterval {
+    Minute = "minute",
+    Hour = "hour",
+    Day = "day",
+    Week = "week",
+    Month = "month",
+    Quarter = "quarter",
+    SemiAnnual = "semi_annual",
+    Year = "year",
+    Multiple = "multiple"
+}
+type ProductItemIntervalType = "minute" | "hour" | "day" | "week" | "month" | "quarter" | "semi_annual" | "year" | "multiple";
+
+declare const CheckFeatureResultSchema: z.ZodObject<{
+    allowed: z.ZodBoolean;
+    feature_id: z.ZodString;
+    customer_id: z.ZodString;
+    entity_id: z.ZodOptional<z.ZodString>;
+    required_balance: z.ZodNumber;
+    unlimited: z.ZodOptional<z.ZodBoolean>;
+    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>;
+    next_reset_at: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    overage_allowed: z.ZodOptional<z.ZodBoolean>;
+    usage_limit: z.ZodOptional<z.ZodNumber>;
+    rollovers: z.ZodOptional<z.ZodObject<{
+        balance: z.ZodNumber;
+        expires_at: z.ZodNumber;
+    }, z.core.$strip>>;
+    breakdown: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        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>;
+    }, z.core.$strip>>>;
+    credit_schema: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        feature_id: z.ZodString;
+        credit_amount: z.ZodNumber;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+type CheckFeatureResult = z.infer<typeof CheckFeatureResultSchema>;
+type ProductScenario = "scheduled" | "active" | "new" | "renew" | "upgrade" | "downgrade" | "cancel";
+interface CheckProductResult {
+    allowed: boolean;
+    customer_id: string;
+    product_id: string;
+    entity_id?: string;
+    status?: string;
+    preview?: CheckProductPreview;
+}
+interface CheckProductPreview {
+    scenario: ProductScenario;
+    product_id: string;
+    product_name: string;
+    recurring: boolean;
+    error_on_attach?: boolean;
+    next_cycle_at?: number;
+    current_product_name?: string;
+    items?: {
+        price: string;
+        description: string;
+        usage_model?: UsageModelType;
+    }[];
+    options?: {
+        feature_id: string;
+        feature_name: string;
+        billing_units: number;
+        price?: number;
+        tiers?: {
+            to: number | string;
+            amount: number;
+        }[];
+    }[];
+    due_today?: {
+        price: number;
+        currency: string;
+    };
+    due_next_cycle?: {
+        price: number;
+        currency: string;
+    };
+}
+
+declare enum AppEnv {
+    Sandbox = "sandbox",
+    Live = "live"
+}
+
+interface Feature {
+    id: string;
+    name: string;
+    type: "boolean" | "continuous_use" | "single_use" | "credit_system";
+}
+interface ProductItem {
+    type?: "feature" | "priced_feature" | "price";
+    feature_id?: string;
+    included_usage?: number | typeof Infinite;
+    interval?: ProductItemIntervalType;
+    feature?: Feature;
+    usage_model?: UsageModel;
+    price?: number;
+    billing_units?: number;
+    entity_feature_id?: string;
+    reset_usage_when_enabled?: boolean;
+    quantity?: number;
+    next_cycle_quantity?: number;
+    display?: {
+        primary_text?: string;
+        secondary_text?: string;
+    };
+}
+interface FreeTrial {
+    duration: FreeTrialDuration;
+    length: number;
+    unique_fingerprint: boolean;
+    trial_available?: boolean;
+}
+interface Product {
+    id: string;
+    created_at: number;
+    name: string;
+    env: AppEnv;
+    is_add_on: boolean;
+    is_default: boolean;
+    group: string;
+    version: number;
+    items: ProductItem[];
+    free_trial: FreeTrial | null;
+    scenario?: ProductScenario;
+    base_variant_id: string | null;
+    properties: {
+        is_free: boolean;
+        is_one_off: boolean;
+        interval_group: string;
+        has_trial: boolean;
+        updateable: boolean;
+    };
+    display?: {
+        name?: string;
+        description?: string;
+        button_text?: string;
+        recommend_text?: string;
+        everything_from?: string;
+        button_url?: string;
+    };
+}
+
+export { AppEnv as A, type CheckFeatureResult as C, type Product as P, type ProductItem as a, type CheckProductResult as b, ProductItemInterval as c };

package/dist/next/client/response-CLgEplsF.d.ts

@@ -0,0 +1,16 @@
+import { A as AutumnError } from './error-DHbclCVh.js';
+
+type Success<T> = {
+    data: T;
+    error: null;
+    statusCode?: number;
+};
+type Failure<E> = {
+    data: null;
+    error: E;
+    statusCode?: number;
+};
+type Result<T, E> = Success<T> | Failure<E>;
+type AutumnPromise<T> = Promise<Result<T, AutumnError>>;
+
+export type { AutumnPromise as A, Result as R, Success as S };

package/dist/next/client/response-DKQ_cb7U.d.mts

@@ -0,0 +1,16 @@
+import { A as AutumnError } from './error-DHbclCVh.mjs';
+
+type Success<T> = {
+    data: T;
+    error: null;
+    statusCode?: number;
+};
+type Failure<E> = {
+    data: null;
+    error: E;
+    statusCode?: number;
+};
+type Result<T, E> = Success<T> | Failure<E>;
+type AutumnPromise<T> = Promise<Result<T, AutumnError>>;
+
+export type { AutumnPromise as A, Result as R, Success as S };