autumn-js 0.1.11 → 0.1.12

package/dist/libraries/react/components/ui/button.d.ts

@@ -3,8 +3,8 @@ import * as React from 'react';
 import { VariantProps } from 'class-variance-authority';
 
 declare const buttonVariants: (props?: ({
-    variant?: "default" | "link" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
-    size?: "default" | "sm" | "lg" | "icon" | null | undefined;
+    variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
+    size?: "sm" | "lg" | "default" | "icon" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
     asChild?: boolean;

package/dist/libraries/react/components/ui/dialog.mjs

@@ -12,9 +12,9 @@ import {
   DialogPortal,
   DialogTitle,
   DialogTrigger
-} from "../../chunk-7JNU5ABT.mjs";
-import "../../chunk-QJPZFEVW.mjs";
+} from "../../chunk-FJWZPMWU.mjs";
 import "../../chunk-FEISQQNM.mjs";
+import "../../chunk-QJPZFEVW.mjs";
 import "../../chunk-I2A7PK2L.mjs";
 import "../../chunk-7TYAAD2T.mjs";
 import "../../chunk-RPEGNKJH.mjs";

package/dist/libraries/react/components/ui/popover.mjs

@@ -5,10 +5,10 @@ import {
   PopoverAnchor,
   PopoverContent,
   PopoverTrigger
-} from "../../chunk-LCWL3TIT.mjs";
+} from "../../chunk-OTZ65PCT.mjs";
+import "../../chunk-KUS3X33V.mjs";
 import "../../chunk-FEISQQNM.mjs";
 import "../../chunk-I2A7PK2L.mjs";
-import "../../chunk-KUS3X33V.mjs";
 import "../../chunk-7TYAAD2T.mjs";
 import "../../chunk-RPEGNKJH.mjs";
 import "../../chunk-4J6OC4ZQ.mjs";

package/dist/libraries/react/{cusTypes-CBapqjzm.d.mts → cusTypes-B2m4-oz4.d.mts}

@@ -1,4 +1,4 @@
-import { A as AppEnv, a as ProductItem, d as ProductItemInterval } from './prodTypes-B8NdKyKo.mjs';
+import { A as AppEnv, c as ProductItem, d as ProductItemInterval } from './prodTypes-C8xRoBP7.mjs';
 import { z } from 'zod/v4';
 
 declare enum ProductStatus {

package/dist/libraries/react/{cusTypes-D13MXEN7.d.ts → cusTypes-lMnznWYJ.d.ts}

@@ -1,4 +1,4 @@
-import { A as AppEnv, a as ProductItem, d as ProductItemInterval } from './prodTypes-B8NdKyKo.js';
+import { A as AppEnv, c as ProductItem, d as ProductItemInterval } from './prodTypes-C8xRoBP7.js';
 import { z } from 'zod/v4';
 
 declare enum ProductStatus {

package/dist/libraries/react/{entTypes-C1bM1Zpv.d.mts → entTypes-D-gn1jj2.d.mts}

@@ -1,5 +1,5 @@
 import { A as AutumnError } from './error-DHbclCVh.mjs';
-import { d as CustomerProduct, e as CustomerFeature, f as CustomerInvoice } from './cusTypes-CBapqjzm.mjs';
+import { d as CustomerProduct, e as CustomerFeature, f as CustomerInvoice } from './cusTypes-B2m4-oz4.mjs';
 
 type Success<T> = {
     data: T;

package/dist/libraries/react/{entTypes-DbIrfEpl.d.ts → entTypes-WMQRyYAv.d.ts}

@@ -1,5 +1,5 @@
 import { A as AutumnError } from './error-DHbclCVh.js';
-import { d as CustomerProduct, e as CustomerFeature, f as CustomerInvoice } from './cusTypes-D13MXEN7.js';
+import { d as CustomerProduct, e as CustomerFeature, f as CustomerInvoice } from './cusTypes-lMnznWYJ.js';
 
 type Success<T> = {
     data: T;

package/dist/libraries/react/{genTypes-C_ilxndU.d.mts → genTypes-DdYlVEah.d.mts}

@@ -1,4 +1,4 @@
-import { b as CheckFeatureResult, c as CheckProductResult } from './prodTypes-B8NdKyKo.mjs';
+import { a as CheckFeatureResult, b as CheckProductResult } from './prodTypes-C8xRoBP7.mjs';
 import { z } from 'zod/v4';
 
 declare const CancelResultSchema: z.ZodObject<{

package/dist/libraries/react/{genTypes-DjcQWIOM.d.ts → genTypes-aPPwPimh.d.ts}

@@ -1,4 +1,4 @@
-import { b as CheckFeatureResult, c as CheckProductResult } from './prodTypes-B8NdKyKo.js';
+import { a as CheckFeatureResult, b as CheckProductResult } from './prodTypes-C8xRoBP7.js';
 import { z } from 'zod/v4';
 
 declare const CancelResultSchema: z.ZodObject<{

package/dist/libraries/react/hooks/helpers/handleCheck.d.mts

@@ -1,14 +1,14 @@
 import { AutumnContextParams } from '../../AutumnContext.mjs';
 import { CheckParams } from '../../client/types/clientGenTypes.mjs';
-import { a as CheckResult } from '../../genTypes-C_ilxndU.mjs';
-import { b as Customer } from '../../cusTypes-CBapqjzm.mjs';
-import { E as Entity } from '../../entTypes-C1bM1Zpv.mjs';
+import { a as CheckResult } from '../../genTypes-DdYlVEah.mjs';
+import { b as Customer } from '../../cusTypes-B2m4-oz4.mjs';
+import { E as Entity } from '../../entTypes-D-gn1jj2.mjs';
 import 'react';
-import '../../ReactAutumnClient-IFdMWiu5.mjs';
+import '../../ReactAutumnClient-zBxnpPLM.mjs';
 import '../../client/types/clientEntTypes.mjs';
 import '../../error-DHbclCVh.mjs';
-import '../../attachTypes-C5gcbNrS.mjs';
-import '../../prodTypes-B8NdKyKo.mjs';
+import '../../attachTypes-Cuxn1ThG.mjs';
+import '../../prodTypes-C8xRoBP7.mjs';
 import 'zod/v4';
 
 interface AllowedParams {

package/dist/libraries/react/hooks/helpers/handleCheck.d.ts

@@ -1,14 +1,14 @@
 import { AutumnContextParams } from '../../AutumnContext.js';
 import { CheckParams } from '../../client/types/clientGenTypes.js';
-import { a as CheckResult } from '../../genTypes-DjcQWIOM.js';
-import { b as Customer } from '../../cusTypes-D13MXEN7.js';
-import { E as Entity } from '../../entTypes-DbIrfEpl.js';
+import { a as CheckResult } from '../../genTypes-aPPwPimh.js';
+import { b as Customer } from '../../cusTypes-lMnznWYJ.js';
+import { E as Entity } from '../../entTypes-WMQRyYAv.js';
 import 'react';
-import '../../ReactAutumnClient-CfDtucnL.js';
+import '../../ReactAutumnClient-CIAkiqwV.js';
 import '../../client/types/clientEntTypes.js';
 import '../../error-DHbclCVh.js';
-import '../../attachTypes-CLK4jfuj.js';
-import '../../prodTypes-B8NdKyKo.js';
+import '../../attachTypes-BQaZHr5e.js';
+import '../../prodTypes-C8xRoBP7.js';
 import 'zod/v4';
 
 interface AllowedParams {

package/dist/libraries/react/hooks/helpers/handleCheck.js

@@ -475,22 +475,92 @@ var Autumn = class {
   entities = entityMethods(this);
   referrals = referralMethods(this);
   features = featureMethods(this);
-  static checkout = (params) => staticWrapper(handleCheckout, void 0, { params });
+  /**
+   * 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 attach = (params) => staticWrapper(handleAttach, void 0, { 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,
@@ -498,6 +568,24 @@ var Autumn = class {
     });
   }
   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,
@@ -505,6 +593,29 @@ var Autumn = class {
     });
   }
   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,
@@ -512,12 +623,50 @@ var Autumn = class {
     });
   }
   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,
@@ -525,6 +674,25 @@ var Autumn = class {
     });
   }
   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,
@@ -740,6 +908,8 @@ var CheckoutParamsSchema = import_v47.z.object({
   product_id: import_v47.z.string(),
   entity_id: import_v47.z.string().optional(),
   options: import_v47.z.array(AttachFeatureOptionsSchema).optional(),
+  force_checkout: import_v47.z.boolean().optional(),
+  invoice: import_v47.z.boolean().optional(),
   success_url: import_v47.z.string().optional(),
   customer_data: CustomerDataSchema.optional(),
   entity_data: import_v47.z.any().optional(),

package/dist/libraries/react/hooks/helpers/handleCheck.mjs

@@ -3,8 +3,8 @@
 import {
   handleCheck,
   openDialog
-} from "../../chunk-KMYL54B4.mjs";
-import "../../chunk-WYQMHQUE.mjs";
+} from "../../chunk-DKOF357C.mjs";
+import "../../chunk-5O3IHYFF.mjs";
 export {
   handleCheck,
   openDialog

package/dist/libraries/react/hooks/helpers/useAutumnBase.d.mts

@@ -1,13 +1,13 @@
-import { R as Result, A as AutumnPromise } from '../../entTypes-C1bM1Zpv.mjs';
+import { R as Result, A as AutumnPromise } from '../../entTypes-D-gn1jj2.mjs';
 import { A as AutumnError } from '../../error-DHbclCVh.mjs';
-import { a as CheckResult, T as TrackResult, C as CancelResult, S as SetupPaymentResult } from '../../genTypes-C_ilxndU.mjs';
-import { C as CheckoutResult } from '../../attachTypes-C5gcbNrS.mjs';
-import { B as BillingPortalResult } from '../../cusTypes-CBapqjzm.mjs';
+import { a as CheckResult, T as TrackResult, C as CancelResult, S as SetupPaymentResult } from '../../genTypes-DdYlVEah.mjs';
+import { C as CheckoutResult } from '../../attachTypes-Cuxn1ThG.mjs';
+import { B as BillingPortalResult } from '../../cusTypes-B2m4-oz4.mjs';
 import { AutumnContextParams } from '../../AutumnContext.mjs';
 import { TrackParams, CancelParams, OpenBillingPortalParams, SetupPaymentParams } from '../../client/types/clientGenTypes.mjs';
 import { AttachParams, CheckoutParams } from '../../client/types/clientAttachTypes.mjs';
-import { A as AutumnClient } from '../../ReactAutumnClient-IFdMWiu5.mjs';
-import '../../prodTypes-B8NdKyKo.mjs';
+import { A as AutumnClient } from '../../ReactAutumnClient-zBxnpPLM.mjs';
+import '../../prodTypes-C8xRoBP7.mjs';
 import 'zod/v4';
 import 'react';
 import '../../client/types/clientEntTypes.mjs';

package/dist/libraries/react/hooks/helpers/useAutumnBase.d.ts

@@ -1,13 +1,13 @@
-import { R as Result, A as AutumnPromise } from '../../entTypes-DbIrfEpl.js';
+import { R as Result, A as AutumnPromise } from '../../entTypes-WMQRyYAv.js';
 import { A as AutumnError } from '../../error-DHbclCVh.js';
-import { a as CheckResult, T as TrackResult, C as CancelResult, S as SetupPaymentResult } from '../../genTypes-DjcQWIOM.js';
-import { C as CheckoutResult } from '../../attachTypes-CLK4jfuj.js';
-import { B as BillingPortalResult } from '../../cusTypes-D13MXEN7.js';
+import { a as CheckResult, T as TrackResult, C as CancelResult, S as SetupPaymentResult } from '../../genTypes-aPPwPimh.js';
+import { C as CheckoutResult } from '../../attachTypes-BQaZHr5e.js';
+import { B as BillingPortalResult } from '../../cusTypes-lMnznWYJ.js';
 import { AutumnContextParams } from '../../AutumnContext.js';
 import { TrackParams, CancelParams, OpenBillingPortalParams, SetupPaymentParams } from '../../client/types/clientGenTypes.js';
 import { AttachParams, CheckoutParams } from '../../client/types/clientAttachTypes.js';
-import { A as AutumnClient } from '../../ReactAutumnClient-CfDtucnL.js';
-import '../../prodTypes-B8NdKyKo.js';
+import { A as AutumnClient } from '../../ReactAutumnClient-CIAkiqwV.js';
+import '../../prodTypes-C8xRoBP7.js';
 import 'zod/v4';
 import 'react';
 import '../../client/types/clientEntTypes.js';

package/dist/libraries/react/hooks/helpers/useAutumnBase.js

@@ -487,22 +487,92 @@ var Autumn = class {
   entities = entityMethods(this);
   referrals = referralMethods(this);
   features = featureMethods(this);
-  static checkout = (params) => staticWrapper(handleCheckout, void 0, { params });
+  /**
+   * 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 attach = (params) => staticWrapper(handleAttach, void 0, { 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,
@@ -510,6 +580,24 @@ var Autumn = class {
     });
   }
   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,
@@ -517,6 +605,29 @@ var Autumn = class {
     });
   }
   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,
@@ -524,12 +635,50 @@ var Autumn = class {
     });
   }
   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,
@@ -537,6 +686,25 @@ var Autumn = class {
     });
   }
   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,
@@ -752,6 +920,8 @@ var CheckoutParamsSchema = import_v47.z.object({
   product_id: import_v47.z.string(),
   entity_id: import_v47.z.string().optional(),
   options: import_v47.z.array(AttachFeatureOptionsSchema).optional(),
+  force_checkout: import_v47.z.boolean().optional(),
+  invoice: import_v47.z.boolean().optional(),
   success_url: import_v47.z.string().optional(),
   customer_data: CustomerDataSchema.optional(),
   entity_data: import_v47.z.any().optional(),
@@ -1090,7 +1260,6 @@ var useAutumnBase = ({
   };
   return {
     attach,
-    // check,
     track,
     cancel,
     openBillingPortal,

package/dist/libraries/react/hooks/helpers/useAutumnBase.mjs

@@ -2,9 +2,9 @@
 
 import {
   useAutumnBase
-} from "../../chunk-6D6TYTTO.mjs";
-import "../../chunk-YHT2JUXO.mjs";
-import "../../chunk-WYQMHQUE.mjs";
+} from "../../chunk-P6CAHZVT.mjs";
+import "../../chunk-7HRCOEUW.mjs";
+import "../../chunk-5O3IHYFF.mjs";
 export {
   useAutumnBase
 };