@stardeckai/autumn-js 0.1.85

package/dist/libraries/react/chunk-ZJPIZX24.mjs

@@ -0,0 +1,1736 @@
+"use client";
+
+
+// src/sdk/error.ts
+var AutumnError = class _AutumnError extends Error {
+  message;
+  code;
+  constructor(response) {
+    super(response.message);
+    this.message = response.message;
+    this.code = response.code;
+  }
+  static fromError(error) {
+    return new _AutumnError({
+      message: error.message || "Unknown error",
+      code: error.code || "unknown_error"
+    });
+  }
+  toString() {
+    return `${this.message} (code: ${this.code})`;
+  }
+  toJSON() {
+    return {
+      message: this.message,
+      code: this.code
+    };
+  }
+};
+
+// src/sdk/response.ts
+var toContainerResult = async ({
+  response,
+  logger: logger2,
+  logError = true
+}) => {
+  if (response.status < 200 || response.status >= 300) {
+    let error;
+    try {
+      error = await response.json();
+      if (logError) {
+        logger2.error(`[Autumn] ${error.message}`);
+      }
+    } catch (error2) {
+      throw error2;
+    }
+    return {
+      data: null,
+      error: new AutumnError({
+        message: error.message,
+        code: error.code
+      }),
+      statusCode: response.status
+    };
+  }
+  try {
+    const data = await response.json();
+    return {
+      data,
+      error: null,
+      statusCode: response?.status
+    };
+  } catch (error) {
+    throw error;
+  }
+};
+
+// src/sdk/general/pageTypes.ts
+import { z } from "zod/v4";
+var PagePaginationDefaults = {
+  Limit: 100,
+  MaxLimit: 1e3
+};
+var PagePaginationQuerySchema = z.object({
+  offset: z.coerce.number().int().min(0).default(0).describe("Number of items to skip"),
+  limit: z.coerce.number().int().min(1).max(PagePaginationDefaults.MaxLimit).default(PagePaginationDefaults.Limit).describe(
+    `Number of items to return. Default ${PagePaginationDefaults.Limit}, max ${PagePaginationDefaults.MaxLimit}.`
+  )
+});
+var createPagePaginatedResponseSchema = (itemSchema) => z.object({
+  list: z.array(itemSchema).describe("Array of items for current page"),
+  has_more: z.boolean().describe("Whether more results exist after this page"),
+  offset: z.number().describe("Current offset position"),
+  limit: z.number().describe("Limit passed in the request"),
+  total: z.number().describe("Total number of items returned in the current page")
+});
+
+// src/sdk/events/eventTypes.ts
+import { z as z2 } from "zod/v4";
+var QueryRangeEnum = z2.enum([
+  "24h",
+  "7d",
+  "30d",
+  "90d",
+  "last_cycle",
+  "1bc",
+  "3bc"
+]);
+var BinSizeEnum = z2.enum(["day", "hour"]);
+var QueryParamsSchema = z2.object({
+  customer_id: z2.string(),
+  feature_id: z2.string().or(z2.array(z2.string())),
+  range: QueryRangeEnum.optional(),
+  group_by: z2.string().startsWith("properties.").optional(),
+  bin_size: BinSizeEnum.optional(),
+  custom_range: z2.object({
+    start: z2.number(),
+    end: z2.number()
+  }).optional()
+});
+var EventsListParamsSchema = PagePaginationQuerySchema.extend({
+  customer_id: z2.string(),
+  feature_id: z2.string().or(z2.array(z2.string())),
+  custom_range: z2.object({
+    start: z2.coerce.number().optional(),
+    end: z2.coerce.number().optional()
+  }).optional()
+});
+var EventsListItemSchema = z2.object({
+  id: z2.string().describe("Event ID (KSUID)"),
+  timestamp: z2.number().describe("Event timestamp (epoch milliseconds)"),
+  feature_id: z2.string().describe("Name of the event"),
+  customer_id: z2.string().describe("Customer identifier"),
+  value: z2.number().describe("Event value/count"),
+  properties: z2.object({}).describe("Event properties (JSONB)")
+});
+var EventsListResponseSchema = createPagePaginatedResponseSchema(EventsListItemSchema);
+
+// src/sdk/customers/cusTypes.ts
+import { z as z4 } from "zod/v4";
+
+// src/sdk/products/prodEnums.ts
+var ProductItemInterval = /* @__PURE__ */ ((ProductItemInterval2) => {
+  ProductItemInterval2["Minute"] = "minute";
+  ProductItemInterval2["Hour"] = "hour";
+  ProductItemInterval2["Day"] = "day";
+  ProductItemInterval2["Week"] = "week";
+  ProductItemInterval2["Month"] = "month";
+  ProductItemInterval2["Quarter"] = "quarter";
+  ProductItemInterval2["SemiAnnual"] = "semi_annual";
+  ProductItemInterval2["Year"] = "year";
+  ProductItemInterval2["Multiple"] = "multiple";
+  return ProductItemInterval2;
+})(ProductItemInterval || {});
+
+// src/sdk/customers/cusEnums.ts
+import { z as z3 } from "zod/v4";
+var CustomerExpandEnum = z3.enum([
+  "invoices",
+  "rewards",
+  "trials_used",
+  "entities",
+  "referrals",
+  "payment_method"
+]);
+
+// src/sdk/customers/cusTypes.ts
+var PurchaseLimitInterval = ["hour", "day", "week", "month"];
+var PurchaseLimitIntervalEnum = z4.enum(PurchaseLimitInterval);
+var AutoTopupPurchaseLimitSchema = z4.object({
+  interval: PurchaseLimitIntervalEnum,
+  interval_count: z4.number().min(1).default(1),
+  limit: z4.number().min(1)
+});
+var AutoTopupSchema = z4.object({
+  feature_id: z4.string(),
+  enabled: z4.boolean().default(false),
+  threshold: z4.number().min(0),
+  quantity: z4.number().min(1),
+  purchase_limit: AutoTopupPurchaseLimitSchema.optional()
+});
+var CustomerBillingControlsSchema = z4.object({
+  auto_topups: z4.array(AutoTopupSchema).optional()
+});
+var CoreCusFeatureSchema = z4.object({
+  unlimited: z4.boolean().optional(),
+  interval: z4.enum(ProductItemInterval).optional(),
+  balance: z4.number().nullish(),
+  usage: z4.number().optional(),
+  included_usage: z4.number().optional(),
+  next_reset_at: z4.number().nullish(),
+  overage_allowed: z4.boolean().optional(),
+  usage_limit: z4.number().optional(),
+  rollovers: z4.object({
+    balance: z4.number(),
+    expires_at: z4.number()
+  }).optional(),
+  breakdown: z4.array(
+    z4.object({
+      interval: z4.enum(ProductItemInterval),
+      balance: z4.number().optional(),
+      usage: z4.number().optional(),
+      included_usage: z4.number().optional(),
+      next_reset_at: z4.number().optional()
+    })
+  ).optional(),
+  credit_schema: z4.array(
+    z4.object({
+      feature_id: z4.string(),
+      credit_amount: z4.number()
+    })
+  ).optional()
+});
+var CustomerDataSchema = z4.object({
+  name: z4.string().nullish(),
+  email: z4.string().nullish(),
+  fingerprint: z4.string().nullish()
+});
+var CreateCustomerParamsSchema = z4.object({
+  id: z4.string().nullish(),
+  email: z4.string().nullish(),
+  name: z4.string().nullish(),
+  fingerprint: z4.string().nullish(),
+  metadata: z4.record(z4.string(), z4.any()).optional(),
+  expand: z4.array(CustomerExpandEnum).optional(),
+  stripe_id: z4.string().nullish(),
+  auto_enable_plan_id: z4.string().optional(),
+  billing_controls: CustomerBillingControlsSchema.optional()
+});
+var BillingPortalParamsSchema = z4.object({
+  return_url: z4.string().optional()
+});
+var UpdateBalancesParamsSchema = z4.object({
+  feature_id: z4.string(),
+  balance: z4.number()
+}).or(
+  z4.array(
+    z4.object({
+      feature_id: z4.string(),
+      balance: z4.number()
+    })
+  )
+).or(
+  z4.object({
+    entity_id: z4.string().optional(),
+    balances: z4.array(
+      z4.object({
+        feature_id: z4.string(),
+        balance: z4.number()
+      })
+    )
+  })
+);
+var DeleteCustomerParamsSchema = z4.object({
+  delete_in_stripe: z4.boolean().optional()
+});
+var ListCustomersParamsSchema = z4.object({
+  limit: z4.number().optional(),
+  offset: z4.number().optional()
+});
+
+// src/sdk/general/checkTypes.ts
+import { z as z5 } from "zod/v4";
+var CheckFeatureResultSchema = z5.object({
+  allowed: z5.boolean(),
+  feature_id: z5.string(),
+  customer_id: z5.string(),
+  entity_id: z5.string().optional(),
+  required_balance: z5.number()
+}).extend(CoreCusFeatureSchema.shape);
+
+// src/libraries/backend/constants.ts
+var autumnApiUrl = "https://api.useautumn.com/v1";
+
+// src/utils/logger.ts
+var getTime = () => {
+  const timeString = (/* @__PURE__ */ new Date()).toISOString();
+  return `[${timeString.split("T")[1].split(".")[0]}]`;
+};
+var greaterThanLevel = (level) => {
+  return levels.indexOf(level) >= levels.indexOf(logger.level);
+};
+var levels = ["debug", "info", "warn", "error", "fatal"];
+var logger = {
+  ...console,
+  level: "info",
+  debug: (...args) => {
+    if (greaterThanLevel("debug")) {
+      console.log(getTime(), "DEBUG", ...args);
+    }
+  },
+  log: (...args) => {
+    console.log(getTime(), "INFO", ...args);
+  },
+  info: (...args) => {
+    if (greaterThanLevel("info")) {
+      console.log(getTime(), "INFO", ...args);
+    }
+  },
+  warn: (...args) => {
+    if (greaterThanLevel("warn")) {
+      console.log(getTime(), "WARN", ...args);
+    }
+  },
+  error: (...args) => {
+    if (greaterThanLevel("error")) {
+      console.log(getTime(), "ERROR", ...args);
+    }
+  }
+};
+
+// src/sdk/utils.ts
+import queryString from "query-string";
+var staticWrapper = (callback, instance, args) => {
+  if (!instance) {
+    instance = new Autumn();
+  }
+  return callback({ instance, ...args });
+};
+var buildQueryString = (params) => {
+  if (!params) return "";
+  return queryString.stringify(params, {
+    skipNull: true,
+    skipEmptyString: true
+  });
+};
+var buildPathWithQuery = (basePath, params) => {
+  const query = buildQueryString(params);
+  return query ? `${basePath}?${query}` : basePath;
+};
+
+// src/sdk/balances/balancesMethods.ts
+var balanceMethods = (instance) => {
+  return {
+    create: (params) => staticWrapper(handleCreateBalance, instance, { params })
+  };
+};
+var handleCreateBalance = async ({
+  instance,
+  params
+}) => {
+  return instance.post("/balances/create", params);
+};
+
+// src/sdk/customers/cusMethods.ts
+var customerMethods = (instance) => {
+  return {
+    list: (params) => staticWrapper(listCustomers, instance, { params }),
+    get: (id, params) => staticWrapper(getCustomer, instance, { id, params }),
+    create: (params) => staticWrapper(createCustomer, instance, { params }),
+    update: (id, params) => staticWrapper(updateCustomer, instance, { id, params }),
+    delete: (id, params) => staticWrapper(deleteCustomer, instance, { id, params }),
+    billingPortal: (id, params) => staticWrapper(billingPortal, instance, { id, params }),
+    updateBalances: (id, params) => staticWrapper(updateBalances, instance, { id, params })
+  };
+};
+var getExpandStr = (expand) => {
+  if (!expand) {
+    return "";
+  }
+  return `expand=${expand.join(",")}`;
+};
+var listCustomers = async ({
+  instance,
+  params
+}) => {
+  const path = buildPathWithQuery("/customers", params);
+  return instance.get(path);
+};
+var getCustomer = async ({
+  instance,
+  id,
+  params
+}) => {
+  if (!id) {
+    return {
+      data: null,
+      error: new AutumnError({
+        message: "Customer ID is required",
+        code: "CUSTOMER_ID_REQUIRED"
+      })
+    };
+  }
+  return instance.get(`/customers/${id}?${getExpandStr(params?.expand)}`);
+};
+var createCustomer = async ({
+  instance,
+  params
+}) => {
+  return instance.post(`/customers?${getExpandStr(params?.expand)}`, params);
+};
+var updateCustomer = async ({
+  instance,
+  id,
+  params
+}) => {
+  return instance.post(`/customers/${id}`, params);
+};
+var deleteCustomer = async ({
+  instance,
+  id,
+  params
+}) => {
+  return instance.delete(`/customers/${id}${params?.delete_in_stripe ? "?delete_in_stripe=true" : ""}`);
+};
+var billingPortal = async ({
+  instance,
+  id,
+  params
+}) => {
+  const finalParams = {
+    ...params,
+    return_url: params?.return_url ?? instance.defaultReturnUrl
+  };
+  return instance.post(`/customers/${id}/billing_portal`, finalParams);
+};
+var updateBalances = async ({
+  instance,
+  id,
+  params
+}) => {
+  return instance.post(`/customers/${id}/balances`, {
+    balances: Array.isArray(params) ? params : [params]
+  });
+};
+
+// src/sdk/customers/entities/entMethods.ts
+var entityMethods = (instance) => {
+  return {
+    get: (customer_id, entity_id, params) => staticWrapper(getEntity, instance, {
+      customer_id,
+      entity_id,
+      params
+    }),
+    create: (customer_id, params) => staticWrapper(createEntity, instance, { customer_id, params }),
+    transfer: (customer_id, params) => staticWrapper(transferProduct, instance, { customer_id, params }),
+    delete: (customer_id, entity_id) => staticWrapper(deleteEntity, instance, { customer_id, entity_id })
+  };
+};
+var getExpandStr2 = (expand) => {
+  if (!expand) {
+    return "";
+  }
+  return `expand=${expand.join(",")}`;
+};
+var getEntity = async ({
+  instance,
+  customer_id,
+  entity_id,
+  params
+}) => {
+  return instance.get(
+    `/customers/${customer_id}/entities/${entity_id}?${getExpandStr2(
+      params?.expand
+    )}`
+  );
+};
+var createEntity = async ({
+  instance,
+  customer_id,
+  params
+}) => {
+  return instance.post(`/customers/${customer_id}/entities`, params);
+};
+var deleteEntity = async ({
+  instance,
+  customer_id,
+  entity_id
+}) => {
+  return instance.delete(`/customers/${customer_id}/entities/${entity_id}`);
+};
+var transferProduct = async ({
+  instance,
+  customer_id,
+  params
+}) => {
+  return instance.post(`/customers/${customer_id}/transfer`, params);
+};
+
+// src/sdk/events/eventMethods.ts
+var eventMethods = (instance) => {
+  return {
+    list: (params) => staticWrapper(handleEventList, instance, { params }),
+    aggregate: (params) => staticWrapper(handleEventAggregate, instance, { params })
+  };
+};
+var handleEventList = async ({
+  instance,
+  params
+}) => {
+  return instance.post("/events/list", params);
+};
+var handleEventAggregate = async ({
+  instance,
+  params
+}) => {
+  return instance.post("/events/aggregate", params);
+};
+
+// src/sdk/features/featureMethods.ts
+var featureMethods = (instance) => {
+  return {
+    list: () => staticWrapper(listFeatures, instance, {}),
+    get: (id) => staticWrapper(getFeature, instance, { id })
+  };
+};
+var listFeatures = async ({
+  instance,
+  params
+}) => {
+  let path = "/features";
+  if (params) {
+    const queryParams = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+      if (value !== void 0) {
+        queryParams.append(key, String(value));
+      }
+    }
+    const queryString2 = queryParams.toString();
+    if (queryString2) {
+      path += `?${queryString2}`;
+    }
+  }
+  return instance.get(path);
+};
+var getFeature = async ({
+  instance,
+  id
+}) => {
+  return instance.get(`/features/${id}`);
+};
+
+// src/sdk/general/genMethods.ts
+var handleCheckout = async ({
+  instance,
+  params
+}) => {
+  const finalParams = {
+    ...params,
+    success_url: params.success_url ?? instance.defaultReturnUrl
+  };
+  return instance.post("/checkout", finalParams);
+};
+var handleAttach = async ({
+  instance,
+  params
+}) => {
+  const finalParams = {
+    ...params,
+    success_url: params.success_url ?? instance.defaultReturnUrl
+  };
+  return instance.post("/attach", finalParams);
+};
+var handleSetupPayment = async ({
+  instance,
+  params
+}) => {
+  const finalParams = {
+    ...params,
+    success_url: params.success_url ?? instance.defaultReturnUrl
+  };
+  return instance.post("/setup_payment", finalParams);
+};
+var handleCancel = async ({
+  instance,
+  params
+}) => {
+  return instance.post("/cancel", params);
+};
+var handleTrack = async ({
+  instance,
+  params
+}) => {
+  return instance.post("/track", params);
+};
+var handleUsage = async ({
+  instance,
+  params
+}) => {
+  return instance.post("/usage", params);
+};
+var handleCheck = async ({
+  instance,
+  params
+}) => {
+  return instance.post("/check", params);
+};
+var handleQuery = async ({
+  instance,
+  params
+}) => {
+  return instance.post("/query", params);
+};
+
+// src/sdk/products/prodMethods.ts
+var productMethods = (instance) => {
+  return {
+    get: (id) => staticWrapper(getProduct, instance, { id }),
+    create: (params) => staticWrapper(createProduct, instance, { params }),
+    list: (params) => staticWrapper(listProducts, instance, { params }),
+    delete: (id) => staticWrapper(deleteProduct, instance, { id })
+  };
+};
+var listProducts = async ({
+  instance,
+  params
+}) => {
+  let path = "/products_beta";
+  if (params) {
+    const queryParams = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+      if (value !== void 0) {
+        queryParams.append(key, String(value));
+      }
+    }
+    const queryString2 = queryParams.toString();
+    if (queryString2) {
+      path += `?${queryString2}`;
+    }
+  }
+  return instance.get(path);
+};
+var getProduct = async ({
+  instance,
+  id
+}) => {
+  return instance.get(`/products/${id}`);
+};
+var createProduct = async ({
+  instance,
+  params
+}) => {
+  return instance.post("/products", params);
+};
+var deleteProduct = async ({
+  instance,
+  id,
+  params
+}) => {
+  const path = buildPathWithQuery(`/products/${id}`, params);
+  return instance.delete(path);
+};
+
+// src/sdk/referrals/referralMethods.ts
+var referralMethods = (instance) => {
+  return {
+    createCode: (params) => staticWrapper(createReferralCode, instance, { params }),
+    redeemCode: (params) => staticWrapper(redeemReferralCode, instance, { params })
+  };
+};
+var createReferralCode = async ({
+  instance,
+  params
+}) => {
+  return instance.post("/referrals/code", params);
+};
+var redeemReferralCode = async ({
+  instance,
+  params
+}) => {
+  return instance.post("/referrals/redeem", params);
+};
+
+// src/sdk/v2/balancesMethods.ts
+var V2_API_VERSION = "2.1.0";
+var handleBalancesUpdate = async ({
+  instance,
+  params
+}) => {
+  return instance.postWithVersion("/balances.update", params, V2_API_VERSION);
+};
+var handleBalancesFinalize = async ({
+  instance,
+  params
+}) => {
+  return instance.postWithVersion("/balances.finalize", params, V2_API_VERSION);
+};
+var v2BalancesMethods = (instance) => {
+  const wrapper = (handler, params) => {
+    const inst = instance || new Autumn();
+    return handler({ instance: inst, params });
+  };
+  return {
+    /**
+     * Updates a customer's balance for a specific feature.
+     *
+     * @param params - Update balance parameters
+     * @returns Promise resolving to update balance response
+     *
+     * @example
+     * ```typescript
+     * // Set remaining balance to exact value
+     * await autumn.v2.balances.update({
+     *   customer_id: "cus_123",
+     *   feature_id: "api_calls",
+     *   remaining: 1000,
+     * });
+     *
+     * // Add to existing balance
+     * await autumn.v2.balances.update({
+     *   customer_id: "cus_123",
+     *   feature_id: "credits",
+     *   add_to_balance: 500,
+     * });
+     *
+     * // Update usage
+     * await autumn.v2.balances.update({
+     *   customer_id: "cus_123",
+     *   feature_id: "api_calls",
+     *   usage: 100,
+     * });
+     *
+     * // Target specific balance by interval or balance_id
+     * await autumn.v2.balances.update({
+     *   customer_id: "cus_123",
+     *   feature_id: "api_calls",
+     *   balance_id: "bal_xyz",
+     *   remaining: 500,
+     * });
+     * ```
+     */
+    update: (params) => wrapper(handleBalancesUpdate, params),
+    /**
+     * Finalizes a balance lock by confirming or releasing it.
+     *
+     * @param params - Finalize lock parameters
+     * @returns Promise resolving to finalize lock response
+     *
+     * @example
+     * ```typescript
+     * // Confirm a lock (deduct the reserved balance)
+     * await autumn.v2.balances.finalize({
+     *   lock_id: "lock_abc123",
+     *   action: "confirm",
+     * });
+     *
+     * // Release a lock (return the reserved balance)
+     * await autumn.v2.balances.finalize({
+     *   lock_id: "lock_abc123",
+     *   action: "release",
+     * });
+     *
+     * // Confirm with a different value than originally reserved
+     * await autumn.v2.balances.finalize({
+     *   lock_id: "lock_abc123",
+     *   action: "confirm",
+     *   override_value: 5,
+     * });
+     * ```
+     */
+    finalize: (params) => wrapper(handleBalancesFinalize, params)
+  };
+};
+
+// src/sdk/v2/billingMethods.ts
+var V2_API_VERSION2 = "2.1.0";
+var handleBillingAttach = async ({
+  instance,
+  params
+}) => {
+  const finalParams = {
+    ...params,
+    success_url: params.success_url ?? instance.defaultReturnUrl,
+    redirect_mode: params.redirect_mode ?? "if_required"
+  };
+  return instance.postWithVersion(
+    "/billing.attach",
+    finalParams,
+    V2_API_VERSION2
+  );
+};
+var handleBillingUpdate = async ({
+  instance,
+  params
+}) => {
+  return instance.postWithVersion("/billing.update", params, V2_API_VERSION2);
+};
+var handleBillingPreviewAttach = async ({
+  instance,
+  params
+}) => {
+  return instance.postWithVersion(
+    "/billing.preview_attach",
+    params,
+    V2_API_VERSION2
+  );
+};
+var handleBillingPreviewUpdate = async ({
+  instance,
+  params
+}) => {
+  return instance.postWithVersion(
+    "/billing.preview_update",
+    params,
+    V2_API_VERSION2
+  );
+};
+var handleBillingMultiAttach = async ({
+  instance,
+  params
+}) => {
+  const finalParams = {
+    ...params,
+    success_url: params.success_url ?? instance.defaultReturnUrl,
+    redirect_mode: params.redirect_mode ?? "if_required"
+  };
+  return instance.postWithVersion(
+    "/billing.multi_attach",
+    finalParams,
+    V2_API_VERSION2
+  );
+};
+var handleBillingPreviewMultiAttach = async ({
+  instance,
+  params
+}) => {
+  return instance.postWithVersion(
+    "/billing.preview_multi_attach",
+    params,
+    V2_API_VERSION2
+  );
+};
+var handleBillingSetupPayment = async ({
+  instance,
+  params
+}) => {
+  const finalParams = {
+    ...params,
+    success_url: params.success_url ?? instance.defaultReturnUrl
+  };
+  return instance.postWithVersion(
+    "/billing.setup_payment",
+    finalParams,
+    V2_API_VERSION2
+  );
+};
+var v2BillingMethods = (instance) => {
+  const wrapper = (handler, params) => {
+    const inst = instance || new Autumn();
+    return handler({ instance: inst, params });
+  };
+  return {
+    /**
+     * Attaches a plan to a customer, enabling access and handling billing.
+     *
+     * @param params - Attach parameters including customer ID, plan ID, and options
+     * @returns Promise resolving to billing response with checkout URL if needed
+     *
+     * @example
+     * ```typescript
+     * const result = await autumn.v2.billing.attach({
+     *   customer_id: "cus_123",
+     *   plan_id: "pro_plan",
+     *   success_url: "https://myapp.com/success"
+     * });
+     *
+     * if (result.payment_url) {
+     *   // Payment required - redirect to checkout
+     *   window.location.href = result.payment_url;
+     * }
+     * ```
+     */
+    attach: (params) => wrapper(handleBillingAttach, params),
+    /**
+     * Updates a customer's subscription, handling plan changes and cancellations.
+     *
+     * @param params - Update parameters including customer ID, plan ID, and cancel action
+     * @returns Promise resolving to billing response with invoice details
+     *
+     * @example
+     * ```typescript
+     * // Update to a new plan
+     * const result = await autumn.v2.billing.update({
+     *   customer_id: "cus_123",
+     *   plan_id: "enterprise_plan",
+     *   feature_quantities: [{ feature_id: "seats", quantity: 10 }]
+     * });
+     *
+     * // Cancel at end of billing cycle
+     * const cancelResult = await autumn.v2.billing.update({
+     *   customer_id: "cus_123",
+     *   plan_id: "pro_plan",
+     *   cancel_action: "cancel_end_of_cycle"
+     * });
+     * ```
+     */
+    update: (params) => wrapper(handleBillingUpdate, params),
+    /**
+     * Preview what attaching a plan would cost without actually attaching it.
+     *
+     * @param params - Same parameters as attach
+     * @returns Promise resolving to preview response with line items and totals
+     *
+     * @example
+     * ```typescript
+     * const preview = await autumn.v2.billing.previewAttach({
+     *   customer_id: "cus_123",
+     *   plan_id: "pro_plan"
+     * });
+     *
+     * console.log(`Total: $${preview.total / 100}`);
+     * preview.line_items.forEach(item => {
+     *   console.log(`${item.title}: $${item.amount / 100}`);
+     * });
+     * ```
+     */
+    previewAttach: (params) => wrapper(handleBillingPreviewAttach, params),
+    /**
+     * Preview what updating a subscription would cost without actually updating it.
+     *
+     * @param params - Same parameters as update
+     * @returns Promise resolving to preview response with line items and totals
+     *
+     * @example
+     * ```typescript
+     * const preview = await autumn.v2.billing.previewUpdate({
+     *   customer_id: "cus_123",
+     *   plan_id: "enterprise_plan",
+     *   feature_quantities: [{ feature_id: "seats", quantity: 20 }]
+     * });
+     *
+     * console.log(`Prorated charge: $${preview.total / 100}`);
+     * ```
+     */
+    previewUpdate: (params) => wrapper(handleBillingPreviewUpdate, params),
+    /**
+     * Attaches multiple plans to a customer in a single request.
+     *
+     * @param params - Multi-attach parameters including customer ID and array of plans
+     * @returns Promise resolving to billing response with checkout URL if needed
+     *
+     * @example
+     * ```typescript
+     * const result = await autumn.v2.billing.multiAttach({
+     *   customer_id: "cus_123",
+     *   plans: [
+     *     { plan_id: "base_plan" },
+     *     { plan_id: "addon_plan", feature_quantities: [{ feature_id: "seats", quantity: 5 }] }
+     *   ],
+     *   success_url: "https://myapp.com/success"
+     * });
+     * ```
+     */
+    multiAttach: (params) => wrapper(handleBillingMultiAttach, params),
+    /**
+     * Preview what attaching multiple plans would cost without actually attaching them.
+     *
+     * @param params - Same parameters as multiAttach
+     * @returns Promise resolving to preview response with line items and totals
+     *
+     * @example
+     * ```typescript
+     * const preview = await autumn.v2.billing.previewMultiAttach({
+     *   customer_id: "cus_123",
+     *   plans: [
+     *     { plan_id: "base_plan" },
+     *     { plan_id: "addon_plan" }
+     *   ]
+     * });
+     *
+     * console.log(`Total: $${preview.total / 100}`);
+     * ```
+     */
+    previewMultiAttach: (params) => wrapper(handleBillingPreviewMultiAttach, params),
+    /**
+     * Sets up a payment method for a customer. Optionally attach a plan after setup.
+     *
+     * @param params - Setup payment parameters including customer ID and optional plan
+     * @returns Promise resolving to setup payment response with redirect URL
+     *
+     * @example
+     * ```typescript
+     * // Just setup payment method
+     * const result = await autumn.v2.billing.setupPayment({
+     *   customer_id: "cus_123",
+     *   success_url: "https://myapp.com/account"
+     * });
+     *
+     * // Setup payment and attach a plan after
+     * const result = await autumn.v2.billing.setupPayment({
+     *   customer_id: "cus_123",
+     *   plan_id: "pro_plan",
+     *   success_url: "https://myapp.com/success"
+     * });
+     *
+     * // Redirect to Stripe
+     * window.location.href = result.url;
+     * ```
+     */
+    setupPayment: (params) => wrapper(handleBillingSetupPayment, params)
+  };
+};
+
+// src/sdk/client.ts
+var LATEST_API_VERSION = "1.2";
+var Autumn = class {
+  secretKey;
+  publishableKey;
+  headers;
+  url;
+  logger = console;
+  defaultReturnUrl;
+  constructor(options) {
+    try {
+      this.secretKey = options?.secretKey || process.env.AUTUMN_SECRET_KEY;
+      this.publishableKey = options?.publishableKey || process.env.AUTUMN_PUBLISHABLE_KEY;
+    } catch (error) {
+    }
+    if (!this.secretKey && !this.publishableKey && !options?.headers) {
+      throw new Error("Autumn secret key or publishable key is required");
+    }
+    this.headers = options?.headers || {
+      Authorization: `Bearer ${this.secretKey || this.publishableKey}`,
+      "Content-Type": "application/json"
+    };
+    const version = options?.version || LATEST_API_VERSION;
+    this.headers["x-api-version"] = version;
+    this.url = options?.url || autumnApiUrl;
+    this.logger = logger;
+    this.logger.level = options?.logLevel || "info";
+    this.defaultReturnUrl = options?.defaultReturnUrl;
+  }
+  async get(path) {
+    const response = await fetch(`${this.url}${path}`, {
+      headers: this.headers
+    });
+    return toContainerResult({ response, logger: this.logger });
+  }
+  async post(path, body) {
+    try {
+      const response = await fetch(`${this.url}${path}`, {
+        method: "POST",
+        headers: this.headers,
+        body: JSON.stringify(body)
+      });
+      return toContainerResult({ response, logger: this.logger });
+    } catch (error) {
+      console.error("Error sending request:", error);
+      throw error;
+    }
+  }
+  async postWithVersion(path, body, version) {
+    try {
+      const headers = {
+        ...this.headers,
+        "x-api-version": version
+      };
+      const response = await fetch(`${this.url}${path}`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(body)
+      });
+      return toContainerResult({ response, logger: this.logger });
+    } catch (error) {
+      console.error("Error sending request:", error);
+      throw error;
+    }
+  }
+  async delete(path) {
+    const response = await fetch(`${this.url}${path}`, {
+      method: "DELETE",
+      headers: this.headers
+    });
+    return toContainerResult({ response, logger: this.logger });
+  }
+  static customers = customerMethods();
+  static products = productMethods();
+  static entities = entityMethods();
+  static referrals = referralMethods();
+  static features = featureMethods();
+  static events = eventMethods();
+  static balances = balanceMethods();
+  static v2 = {
+    billing: v2BillingMethods(),
+    balances: v2BalancesMethods()
+  };
+  customers = customerMethods(this);
+  products = productMethods(this);
+  entities = entityMethods(this);
+  referrals = referralMethods(this);
+  features = featureMethods(this);
+  events = eventMethods(this);
+  balances = balanceMethods(this);
+  v2 = {
+    billing: v2BillingMethods(this),
+    balances: v2BalancesMethods(this)
+  };
+  /**
+   * 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;
+   * }
+   * ```
+   */
+  async checkout(params) {
+    return handleCheckout({
+      instance: this,
+      params
+    });
+  }
+  static checkout = (params) => staticWrapper(handleCheckout, void 0, { params });
+  static usage = (params) => staticWrapper(handleUsage, void 0, { params });
+  /**
+   * 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);
+   * }
+   * ```
+   */
+  async attach(params) {
+    return handleAttach({
+      instance: this,
+      params
+    });
+  }
+  static attach = (params) => staticWrapper(handleAttach, void 0, { params });
+  static setupPayment = (params) => staticWrapper(handleSetupPayment, void 0, { params });
+  /**
+   * 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"
+   * });
+   * ```
+   */
+  async setupPayment(params) {
+    return handleSetupPayment({
+      instance: this,
+      params
+    });
+  }
+  static cancel = (params) => staticWrapper(handleCancel, void 0, { params });
+  /**
+   * 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
+   * });
+   * ```
+   */
+  async cancel(params) {
+    return handleCancel({
+      instance: this,
+      params
+    });
+  }
+  static check = (params) => staticWrapper(handleCheck, void 0, { params });
+  /**
+   * 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");
+   * }
+   * ```
+   */
+  async check(params) {
+    return handleCheck({
+      instance: this,
+      params
+    });
+  }
+  static track = (params) => staticWrapper(handleTrack, void 0, { params });
+  /**
+   * 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
+   * });
+   * ```
+   */
+  async track(params) {
+    return handleTrack({
+      instance: this,
+      params
+    });
+  }
+  /**
+   * 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
+   * });
+   * ```
+   */
+  async usage(params) {
+    return handleUsage({
+      instance: this,
+      params
+    });
+  }
+  static query = (params) => staticWrapper(handleQuery, void 0, { params });
+  /**
+   * 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
+   * });
+   *
+   * ```
+   */
+  async query(params) {
+    return handleQuery({
+      instance: this,
+      params
+    });
+  }
+};
+
+// src/sdk/customers/entities/entTypes.ts
+import { z as z6 } from "zod/v4";
+var EntityDataSchema = z6.object({
+  name: z6.string().optional(),
+  feature_id: z6.string()
+});
+var TransferProductParamsSchema = z6.object({
+  from_entity_id: z6.string(),
+  to_entity_id: z6.string(),
+  product_id: z6.string()
+});
+
+// src/sdk/features/featureTypes.ts
+import { z as z7 } from "zod/v4";
+var FeatureType = /* @__PURE__ */ ((FeatureType2) => {
+  FeatureType2["Boolean"] = "boolean";
+  FeatureType2["SingleUse"] = "single_use";
+  FeatureType2["ContinuousUse"] = "continuous_use";
+  FeatureType2["CreditSystem"] = "credit_system";
+  return FeatureType2;
+})(FeatureType || {});
+var FeatureSchema = z7.object({
+  id: z7.string(),
+  name: z7.string(),
+  type: z7.enum(FeatureType),
+  display: z7.object({
+    singular: z7.string(),
+    plural: z7.string()
+  }).nullish(),
+  credit_schema: z7.array(
+    z7.object({
+      metered_feature_id: z7.string(),
+      credit_cost: z7.number()
+    })
+  ).nullish(),
+  archived: z7.boolean()
+});
+
+// src/sdk/general/attachTypes.ts
+import { z as z8 } from "zod/v4";
+var AttachFeatureOptionsSchema = z8.object({
+  feature_id: z8.string(),
+  quantity: z8.number()
+});
+var AttachParamsSchema = z8.object({
+  customer_id: z8.string(),
+  product_id: z8.string().optional(),
+  entity_id: z8.string().optional(),
+  options: z8.array(AttachFeatureOptionsSchema).optional(),
+  product_ids: z8.array(z8.string()).optional(),
+  free_trial: z8.boolean().optional(),
+  success_url: z8.string().optional(),
+  metadata: z8.record(z8.string(), z8.string()).optional(),
+  force_checkout: z8.boolean().optional(),
+  customer_data: CustomerDataSchema.optional(),
+  entity_data: z8.any().optional(),
+  checkout_session_params: z8.record(z8.string(), z8.any()).optional(),
+  reward: z8.string().optional(),
+  invoice: z8.boolean().optional(),
+  new_billing_subscription: z8.boolean().optional()
+});
+var AttachResultSchema = z8.object({
+  checkout_url: z8.string().optional(),
+  customer_id: z8.string(),
+  product_ids: z8.array(z8.string()),
+  code: z8.string(),
+  message: z8.string(),
+  customer_data: z8.any().optional(),
+  invoice: z8.object({
+    status: z8.string(),
+    stripe_id: z8.string(),
+    hosted_invoice_url: z8.string().nullable(),
+    total: z8.number(),
+    currency: z8.string()
+  }).optional()
+});
+var CheckoutParamsSchema = z8.object({
+  customer_id: z8.string(),
+  product_id: z8.string(),
+  product_ids: z8.array(z8.string()).optional(),
+  entity_id: z8.string().optional(),
+  options: z8.array(AttachFeatureOptionsSchema).optional(),
+  force_checkout: z8.boolean().optional(),
+  invoice: z8.boolean().optional(),
+  success_url: z8.string().optional(),
+  customer_data: CustomerDataSchema.optional(),
+  entity_data: z8.any().optional(),
+  checkout_session_params: z8.record(z8.string(), z8.any()).optional(),
+  reward: z8.string().optional(),
+  new_billing_subscription: z8.boolean().optional()
+});
+
+// src/sdk/general/genTypes.ts
+import { z as z9 } from "zod/v4";
+var LockParamsSchema = z9.object({
+  lock_id: z9.string().max(256),
+  enabled: z9.literal(true),
+  expires_at: z9.number().optional()
+});
+var CancelParamsSchema = z9.object({
+  customer_id: z9.string(),
+  product_id: z9.string(),
+  entity_id: z9.string().optional(),
+  cancel_immediately: z9.boolean().optional(),
+  prorate: z9.boolean().optional()
+});
+var CancelResultSchema = z9.object({
+  success: z9.boolean(),
+  customer_id: z9.string(),
+  product_id: z9.string()
+});
+var TrackParamsSchema = z9.object({
+  customer_id: z9.string(),
+  value: z9.number().optional(),
+  feature_id: z9.string().optional(),
+  event_name: z9.string().optional(),
+  entity_id: z9.string().optional(),
+  customer_data: z9.any().optional(),
+  idempotency_key: z9.string().optional(),
+  entity_data: z9.any().optional(),
+  properties: z9.record(z9.string(), z9.any()).optional(),
+  lock: LockParamsSchema.optional()
+});
+var TrackResultSchema = z9.object({
+  id: z9.string(),
+  code: z9.string(),
+  customer_id: z9.string(),
+  feature_id: z9.string().optional(),
+  event_name: z9.string().optional()
+});
+var CheckParamsSchema = z9.object({
+  customer_id: z9.string(),
+  feature_id: z9.string().optional(),
+  product_id: z9.string().optional(),
+  entity_id: z9.string().optional(),
+  customer_data: z9.any().optional(),
+  required_balance: z9.number().optional(),
+  send_event: z9.boolean().optional(),
+  with_preview: z9.boolean().optional(),
+  entity_data: EntityDataSchema.optional(),
+  lock: LockParamsSchema.optional()
+});
+
+// src/sdk/referrals/referralTypes.ts
+import { z as z10 } from "zod/v4";
+var CreateReferralCodeParamsSchema = z10.object({
+  customer_id: z10.string(),
+  program_id: z10.string()
+});
+var RedeemReferralCodeParamsSchema = z10.object({
+  code: z10.string(),
+  customer_id: z10.string()
+});
+
+// src/sdk/balances/balancesTypes.ts
+import { z as z11 } from "zod/v4";
+var ResetInterval = [
+  "one_off",
+  "minute",
+  "hour",
+  "day",
+  "week",
+  "month",
+  "quarter",
+  "semi_annual",
+  "year"
+];
+var CreateBalanceParamsSchema = z11.object({
+  feature_id: z11.string().describe("The feature ID to create the balance for"),
+  customer_id: z11.string().describe("The customer ID to assign the balance to"),
+  entity_id: z11.string().optional().describe("Entity ID for entity-scoped balances"),
+  granted_balance: z11.number().optional().describe("The initial balance amount to grant"),
+  unlimited: z11.boolean().optional().describe("Whether the balance is unlimited"),
+  reset: z11.object({
+    interval: z11.enum(ResetInterval),
+    interval_count: z11.number().optional()
+  }).optional().describe("Reset configuration for the balance"),
+  expires_at: z11.number().optional().describe("Unix timestamp (milliseconds) when the balance expires")
+});
+
+// src/sdk/v2/billingTypes.ts
+import { z as z12 } from "zod/v4";
+var BillingIntervalSchema = z12.enum([
+  "one_off",
+  "week",
+  "month",
+  "quarter",
+  "semi_annual",
+  "year"
+]);
+var ResetIntervalSchema = z12.enum([
+  "one_off",
+  "minute",
+  "hour",
+  "day",
+  "week",
+  "month",
+  "quarter",
+  "semi_annual",
+  "year"
+]);
+var BillingMethodSchema = z12.enum(["prepaid", "usage_based"]);
+var OnIncreaseSchema = z12.enum([
+  "bill_immediately",
+  "prorate_immediately",
+  "prorate_next_cycle",
+  "bill_next_cycle"
+]);
+var OnDecreaseSchema = z12.enum([
+  "prorate",
+  "prorate_immediately",
+  "prorate_next_cycle",
+  "none",
+  "no_prorations"
+]);
+var RolloverExpiryDurationTypeSchema = z12.enum(["month", "forever"]);
+var FeatureQuantityParamsSchema = z12.object({
+  feature_id: z12.string(),
+  quantity: z12.number().min(0).optional(),
+  adjustable: z12.boolean().optional()
+});
+var FreeTrialParamsSchema = z12.object({
+  duration_length: z12.number(),
+  duration_type: z12.enum(["day", "month", "year"]).default("month"),
+  card_required: z12.boolean().default(true)
+});
+var AttachDiscountSchema = z12.union([
+  z12.object({ reward_id: z12.string() }),
+  z12.object({ promotion_code: z12.string() })
+]);
+var InvoiceModeParamsSchema = z12.object({
+  enabled: z12.boolean(),
+  enable_plan_immediately: z12.boolean().default(false),
+  finalize: z12.boolean().default(true)
+});
+var ProrationBehaviorSchema = z12.enum(["prorate_immediately", "none"]);
+var RedirectModeSchema = z12.enum(["always", "if_required", "never"]);
+var PlanScheduleSchema = z12.enum(["immediate", "end_of_cycle"]);
+var CancelActionSchema = z12.enum([
+  "cancel_immediately",
+  "cancel_end_of_cycle",
+  "uncancel"
+]);
+var UsageTierSchema = z12.object({
+  to: z12.number().or(z12.literal("inf")),
+  amount: z12.number()
+});
+var BasePriceParamsSchema = z12.object({
+  amount: z12.number(),
+  interval: BillingIntervalSchema,
+  interval_count: z12.number().optional()
+});
+var CreatePlanItemParamsSchema = z12.object({
+  feature_id: z12.string(),
+  included: z12.number().optional(),
+  unlimited: z12.boolean().optional(),
+  reset: z12.object({
+    interval: ResetIntervalSchema,
+    interval_count: z12.number().optional()
+  }).optional(),
+  price: z12.object({
+    amount: z12.number().optional(),
+    tiers: z12.array(UsageTierSchema).optional(),
+    interval: BillingIntervalSchema,
+    interval_count: z12.number().default(1).optional(),
+    billing_units: z12.number().default(1).optional(),
+    billing_method: BillingMethodSchema,
+    max_purchase: z12.number().optional()
+  }).optional(),
+  proration: z12.object({
+    on_increase: OnIncreaseSchema,
+    on_decrease: OnDecreaseSchema
+  }).optional(),
+  rollover: z12.object({
+    max: z12.number().optional(),
+    expiry_duration_type: RolloverExpiryDurationTypeSchema,
+    expiry_duration_length: z12.number().optional()
+  }).optional()
+});
+var CustomizePlanSchema = z12.object({
+  price: BasePriceParamsSchema.nullable().optional(),
+  items: z12.array(CreatePlanItemParamsSchema).optional(),
+  free_trial: FreeTrialParamsSchema.nullable().optional()
+});
+var CustomLineItemSchema = z12.object({
+  amount: z12.number(),
+  description: z12.string()
+});
+var BillingParamsBaseSchema = z12.object({
+  customer_id: z12.string(),
+  entity_id: z12.string().optional(),
+  feature_quantities: z12.array(FeatureQuantityParamsSchema).optional(),
+  version: z12.number().optional(),
+  customize: CustomizePlanSchema.optional(),
+  invoice_mode: InvoiceModeParamsSchema.optional(),
+  proration_behavior: ProrationBehaviorSchema.optional(),
+  subscription_id: z12.string().optional()
+});
+var BillingAttachParamsSchema = BillingParamsBaseSchema.extend({
+  plan_id: z12.string(),
+  discounts: z12.array(AttachDiscountSchema).optional(),
+  success_url: z12.string().optional(),
+  redirect_mode: RedirectModeSchema.optional(),
+  new_billing_subscription: z12.boolean().optional(),
+  plan_schedule: PlanScheduleSchema.optional(),
+  checkout_session_params: z12.record(z12.string(), z12.unknown()).optional(),
+  custom_line_items: z12.array(CustomLineItemSchema).optional()
+});
+var BillingUpdateParamsSchema = BillingParamsBaseSchema.extend({
+  plan_id: z12.string().optional(),
+  cancel_action: CancelActionSchema.optional()
+});
+var PaymentFailureCodeSchema = z12.enum([
+  "3ds_required",
+  "payment_method_required",
+  "payment_failed"
+]);
+var BillingRequiredActionSchema = z12.object({
+  code: PaymentFailureCodeSchema,
+  reason: z12.string()
+});
+var BillingResponseSchema = z12.object({
+  customer_id: z12.string(),
+  entity_id: z12.string().optional(),
+  invoice: z12.object({
+    status: z12.string().nullable(),
+    stripe_id: z12.string(),
+    total: z12.number(),
+    currency: z12.string(),
+    hosted_invoice_url: z12.string().nullable()
+  }).optional(),
+  payment_url: z12.string().nullable(),
+  required_action: BillingRequiredActionSchema.optional()
+});
+var MultiAttachCustomizePlanSchema = z12.object({
+  price: BasePriceParamsSchema.nullable().optional(),
+  items: z12.array(CreatePlanItemParamsSchema).optional()
+});
+var MultiAttachPlanSchema = z12.object({
+  plan_id: z12.string(),
+  customize: MultiAttachCustomizePlanSchema.optional(),
+  feature_quantities: z12.array(FeatureQuantityParamsSchema).optional(),
+  version: z12.number().optional(),
+  subscription_id: z12.string().optional()
+});
+var MultiAttachParamsSchema = z12.object({
+  customer_id: z12.string(),
+  entity_id: z12.string().optional(),
+  plans: z12.array(MultiAttachPlanSchema).min(1),
+  free_trial: FreeTrialParamsSchema.nullable().optional(),
+  invoice_mode: InvoiceModeParamsSchema.optional(),
+  discounts: z12.array(AttachDiscountSchema).optional(),
+  success_url: z12.string().optional(),
+  checkout_session_params: z12.record(z12.string(), z12.unknown()).optional(),
+  redirect_mode: RedirectModeSchema.optional(),
+  new_billing_subscription: z12.boolean().optional()
+});
+var SetupPaymentParamsSchema = z12.object({
+  customer_id: z12.string(),
+  entity_id: z12.string().optional(),
+  plan_id: z12.string().optional(),
+  feature_quantities: z12.array(FeatureQuantityParamsSchema).optional(),
+  version: z12.number().optional(),
+  customize: CustomizePlanSchema.optional(),
+  discounts: z12.array(AttachDiscountSchema).optional(),
+  success_url: z12.string().optional(),
+  checkout_session_params: z12.record(z12.string(), z12.unknown()).optional()
+});
+var SetupPaymentResponseSchema = z12.object({
+  customer_id: z12.string(),
+  entity_id: z12.string().optional(),
+  url: z12.string()
+});
+var PreviewLineItemSchema = z12.object({
+  title: z12.string(),
+  description: z12.string(),
+  amount: z12.number()
+});
+var BillingPreviewResponseSchema = z12.object({
+  customer_id: z12.string(),
+  line_items: z12.array(PreviewLineItemSchema),
+  total: z12.number(),
+  currency: z12.string(),
+  next_cycle: z12.object({
+    starts_at: z12.number(),
+    total: z12.number()
+  }).optional()
+});
+
+// src/sdk/v2/balancesTypes.ts
+import { z as z13 } from "zod/v4";
+var V2ResetIntervalSchema = z13.enum([
+  "one_off",
+  "minute",
+  "hour",
+  "day",
+  "week",
+  "month",
+  "quarter",
+  "semi_annual",
+  "year"
+]);
+var V2UpdateBalanceParamsSchema = z13.object({
+  customer_id: z13.string(),
+  feature_id: z13.string(),
+  entity_id: z13.string().optional(),
+  remaining: z13.number().optional(),
+  add_to_balance: z13.number().optional(),
+  usage: z13.number().optional(),
+  interval: V2ResetIntervalSchema.optional(),
+  included_grant: z13.number().optional(),
+  balance_id: z13.string().optional(),
+  next_reset_at: z13.number().optional()
+});
+var V2UpdateBalanceResponseSchema = z13.object({
+  message: z13.string()
+});
+var V2FinalizeLockActionSchema = z13.enum(["confirm", "release"]);
+var V2FinalizeLockParamsSchema = z13.object({
+  lock_id: z13.string(),
+  action: V2FinalizeLockActionSchema,
+  override_value: z13.number().optional(),
+  properties: z13.record(z13.string(), z13.any()).optional()
+});
+var V2FinalizeLockResponseSchema = z13.object({
+  success: z13.literal(true)
+});
+
+export {
+  AutumnError,
+  toContainerResult,
+  QueryRangeEnum,
+  CheckFeatureResultSchema
+};