priceos 1.0.21 → 1.0.23

package/dist/gen/openapi.d.ts

@@ -17,7 +17,10 @@ export interface paths {
          */
         get: {
             parameters: {
-                query?: never;
+                query?: {
+                    /** @description Optional fields to include in the response. */
+                    expand?: "subscriptions"[];
+                };
                 header: {
                     /** @description API key from your PriceOS dashboard. */
                     "x-api-key": string;
@@ -40,6 +43,7 @@ export interface paths {
                          * @example {
                          *       "customerId": "customer_123",
                          *       "stripeCustomerId": "cus_abc123",
+                         *       "hasPaymentMethod": true,
                          *       "name": "Ada Lovelace",
                          *       "email": "ada@example.com",
                          *       "created": 1735689600000,
@@ -118,14 +122,14 @@ export interface paths {
                             customerId?: string;
                             /** @description Stripe customer ID. */
                             stripeCustomerId?: string;
+                            /** @description Whether the Stripe customer has at least one saved payment method. */
+                            hasPaymentMethod: boolean;
                             /** @description Customer name. */
                             name?: string;
                             /** @description Customer email address. */
                             email?: string;
                             /** @description Unix timestamp (ms) when the customer was created. */
                             created?: number;
-                            /** @description Unix timestamp (ms) when usage tracking started. This will determine when usage gets reset for your limit features if a customer is assinged a custom product. */
-                            usageStartedAt?: number;
                             /**
                              * @description Customer environment.
                              * @enum {string}
@@ -252,6 +256,12 @@ export interface paths {
                                 /** @description Unix timestamp (ms) when the bonus was updated. */
                                 updatedAt: number;
                             }[];
+                            /** @description Resolved Unix timestamp (ms) usage reset anchor. For Stripe customers, this is derived from active Stripe product period start (or product startedAt) when available. Otherwise it uses stored usageStartedAt; if unset, it falls back to the customer created timestamp. */
+                            usageStartedAt?: number;
+                            /** @description Expanded Stripe subscriptions. Each item is raw Stripe subscription object. Included only when requested via expand=subscriptions. */
+                            subscriptions?: {
+                                [key: string]: unknown;
+                            }[];
                         } | null;
                     };
                 };
@@ -317,10 +327,10 @@ export interface paths {
                         name?: string;
                         /** @description Customer email address. */
                         email?: string;
-                        /** @description Unix timestamp (ms) when usage tracking started. This will determine when usage gets reset for your limit features if a customer is assinged a custom product. */
-                        usageStartedAt?: number;
                         /** @description Assigned custom product keys. */
                         customProductKeys?: string[];
+                        /** @description Optional usage reset anchor (unix timestamp in ms) for the account. Defines the start time from which usage is measured and limits are calculated. */
+                        usageStartedAt?: number;
                     };
                 };
             };
@@ -335,6 +345,7 @@ export interface paths {
                          * @example {
                          *       "customerId": "customer_123",
                          *       "stripeCustomerId": "cus_abc123",
+                         *       "hasPaymentMethod": true,
                          *       "name": "Ada Lovelace",
                          *       "email": "ada@example.com",
                          *       "created": 1735689600000,
@@ -413,14 +424,14 @@ export interface paths {
                             customerId?: string;
                             /** @description Stripe customer ID. */
                             stripeCustomerId?: string;
+                            /** @description Whether the Stripe customer has at least one saved payment method. */
+                            hasPaymentMethod: boolean;
                             /** @description Customer name. */
                             name?: string;
                             /** @description Customer email address. */
                             email?: string;
                             /** @description Unix timestamp (ms) when the customer was created. */
                             created?: number;
-                            /** @description Unix timestamp (ms) when usage tracking started. This will determine when usage gets reset for your limit features if a customer is assinged a custom product. */
-                            usageStartedAt?: number;
                             /**
                              * @description Customer environment.
                              * @enum {string}
@@ -547,6 +558,8 @@ export interface paths {
                                 /** @description Unix timestamp (ms) when the bonus was updated. */
                                 updatedAt: number;
                             }[];
+                            /** @description Resolved Unix timestamp (ms) usage reset anchor. For Stripe customers, this is derived from active Stripe product period start (or product startedAt) when available. Otherwise it uses stored usageStartedAt; if unset, it falls back to the customer created timestamp. */
+                            usageStartedAt?: number;
                         };
                     };
                 };
@@ -719,10 +732,10 @@ export interface paths {
                         name?: string;
                         /** @description Customer email address. */
                         email?: string;
-                        /** @description Unix timestamp (ms) when usage tracking started. This will determine when usage gets reset for your limit features if a customer is assinged a custom product. */
-                        usageStartedAt?: number;
                         /** @description Assigned custom product keys. */
                         customProductKeys?: string[];
+                        /** @description Optional usage reset anchor (unix timestamp in ms) for the account. Defines the start time from which usage is measured and limits are calculated. */
+                        usageStartedAt?: number;
                     };
                 };
             };
@@ -737,6 +750,7 @@ export interface paths {
                          * @example {
                          *       "customerId": "customer_123",
                          *       "stripeCustomerId": "cus_abc123",
+                         *       "hasPaymentMethod": true,
                          *       "name": "Ada Lovelace",
                          *       "email": "ada@example.com",
                          *       "created": 1735689600000,
@@ -815,14 +829,14 @@ export interface paths {
                             customerId?: string;
                             /** @description Stripe customer ID. */
                             stripeCustomerId?: string;
+                            /** @description Whether the Stripe customer has at least one saved payment method. */
+                            hasPaymentMethod: boolean;
                             /** @description Customer name. */
                             name?: string;
                             /** @description Customer email address. */
                             email?: string;
                             /** @description Unix timestamp (ms) when the customer was created. */
                             created?: number;
-                            /** @description Unix timestamp (ms) when usage tracking started. This will determine when usage gets reset for your limit features if a customer is assinged a custom product. */
-                            usageStartedAt?: number;
                             /**
                              * @description Customer environment.
                              * @enum {string}
@@ -949,6 +963,8 @@ export interface paths {
                                 /** @description Unix timestamp (ms) when the bonus was updated. */
                                 updatedAt: number;
                             }[];
+                            /** @description Resolved Unix timestamp (ms) usage reset anchor. For Stripe customers, this is derived from active Stripe product period start (or product startedAt) when available. Otherwise it uses stored usageStartedAt; if unset, it falls back to the customer created timestamp. */
+                            usageStartedAt?: number;
                         };
                     };
                 };
@@ -1052,6 +1068,7 @@ export interface paths {
                          * @example {
                          *       "customerId": "customer_123",
                          *       "stripeCustomerId": "cus_abc123",
+                         *       "hasPaymentMethod": true,
                          *       "name": "Ada Lovelace",
                          *       "email": "ada@example.com",
                          *       "created": 1735689600000,
@@ -1130,14 +1147,14 @@ export interface paths {
                             customerId?: string;
                             /** @description Stripe customer ID. */
                             stripeCustomerId?: string;
+                            /** @description Whether the Stripe customer has at least one saved payment method. */
+                            hasPaymentMethod: boolean;
                             /** @description Customer name. */
                             name?: string;
                             /** @description Customer email address. */
                             email?: string;
                             /** @description Unix timestamp (ms) when the customer was created. */
                             created?: number;
-                            /** @description Unix timestamp (ms) when usage tracking started. This will determine when usage gets reset for your limit features if a customer is assinged a custom product. */
-                            usageStartedAt?: number;
                             /**
                              * @description Customer environment.
                              * @enum {string}
@@ -1264,6 +1281,8 @@ export interface paths {
                                 /** @description Unix timestamp (ms) when the bonus was updated. */
                                 updatedAt: number;
                             }[];
+                            /** @description Resolved Unix timestamp (ms) usage reset anchor. For Stripe customers, this is derived from active Stripe product period start (or product startedAt) when available. Otherwise it uses stored usageStartedAt; if unset, it falls back to the customer created timestamp. */
+                            usageStartedAt?: number;
                         };
                     };
                 };
@@ -1345,7 +1364,7 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Create customer portal session
+         * Open customer portal
          * @description Create a Stripe customer portal session URL for a customer.
          */
         post: {
@@ -1451,7 +1470,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/usage/set": {
+    "/v1/customers/{customerId}/checkout": {
         parameters: {
             query?: never;
             header?: never;
@@ -1461,8 +1480,8 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Set usage
-         * @description Set absolute usage for the current period by recording an adjustment event.
+         * Checkout
+         * @description Create a Stripe checkout session URL for a customer and Stripe product key. Creates the customer in PriceOS if missing.
          */
         post: {
             parameters: {
@@ -1471,45 +1490,54 @@ export interface paths {
                     /** @description API key from your PriceOS dashboard. */
                     "x-api-key": string;
                 };
-                path?: never;
+                path: {
+                    /** @description Customer ID (internal or Stripe). */
+                    customerId: string;
+                };
                 cookie?: never;
             };
             requestBody: {
                 content: {
                     "application/json": {
-                        /** @description Customer ID (internal or Stripe). */
-                        customerId: string;
-                        /** @description Feature key to set usage for. */
-                        featureKey: string;
-                        /** @description Absolute usage value to set for the current usage period. */
-                        used: number;
-                        /** @description Stable unique identifier for this event. Reuse it on retries for idempotency and to reference the event later. */
-                        idempotencyKey?: string;
-                        /** @description Deprecated alias for idempotencyKey. Prefer idempotencyKey. */
-                        eventKey?: string;
-                        /** @description Optional metadata for the adjustment event (string key/value pairs). */
-                        metadata?: {
-                            [key: string]: string;
+                        /** @description Stripe product key configured in PriceOS. Must reference a Stripe product (not a custom product). */
+                        stripeProductKey: string;
+                        /**
+                         * Format: uri
+                         * @description Optional checkout success redirect URL.
+                         */
+                        successUrl?: string;
+                        /** @description Optional customer info used when creating/updating the customer. */
+                        customerInfo?: {
+                            /** @description Optional customer name. */
+                            name?: string | null;
+                            /** @description Optional customer email address. */
+                            email?: string | null;
+                        };
+                        /** @description Optional Stripe Checkout Session params to merge into the request. */
+                        checkoutParams?: {
+                            [key: string]: unknown;
                         };
                     };
                 };
             };
             responses: {
-                /** @description Usage set */
+                /** @description Customer checkout session */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
+                        /**
+                         * @example {
+                         *       "url": "https://checkout.stripe.com/c/pay/cs_test_123"
+                         *     }
+                         */
                         "application/json": {
-                            /** @description Whether the usage event was applied. */
-                            applied: boolean;
-                            /** @description Updated usage total, if applicable. */
-                            used: number | null;
-                            /** @description Reason the usage event was not applied. */
-                            reason?: string | null;
-                            /** @description Adjustment amount applied to reach the requested usage value. */
-                            adjustment: number;
+                            /**
+                             * Format: uri
+                             * @description Stripe checkout URL.
+                             */
+                            url: string;
                         };
                     };
                 };
@@ -1549,6 +1577,18 @@ export interface paths {
                         };
                     };
                 };
+                /** @description Conflict */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description Error message. */
+                            error: string;
+                        };
+                    };
+                };
                 /** @description Server error */
                 500: {
                     headers: {
@@ -1569,33 +1609,42 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/feature-access": {
+    "/v1/customers/{customerId}/custom-product/add": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: never;
         /**
-         * Get feature access
-         * @description Return feature access for a customer.
+         * Add custom product
+         * @description Add one custom product to a customer without removing existing custom products.
          */
-        get: {
+        post: {
             parameters: {
-                query: {
-                    /** @description Customer ID (internal or Stripe). */
-                    customerId: string;
-                };
+                query?: never;
                 header: {
                     /** @description API key from your PriceOS dashboard. */
                     "x-api-key": string;
                 };
-                path?: never;
+                path: {
+                    /** @description Customer ID (internal or Stripe). */
+                    customerId: string;
+                };
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** @description Custom product key to add or remove. */
+                        customProductKey: string;
+                    };
+                };
+            };
             responses: {
-                /** @description Feature access lookup */
+                /** @description Customer custom product updated */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -1603,83 +1652,228 @@ export interface paths {
                     content: {
                         /**
                          * @example {
-                         *       "api_calls": {
-                         *         "hasAccess": true,
-                         *         "type": "limit",
-                         *         "limit": 1000,
-                         *         "isUnlimited": false,
-                         *         "usage": {
-                         *           "used": 120,
-                         *           "remaining": 880,
-                         *           "bonusRemaining": 25,
-                         *           "hasReachedLimit": false,
-                         *           "bonusUsed": 5,
-                         *           "nextReset": 1738368000000,
-                         *           "lastReset": 1735689600000
+                         *       "customerId": "customer_123",
+                         *       "stripeCustomerId": "cus_abc123",
+                         *       "hasPaymentMethod": true,
+                         *       "name": "Ada Lovelace",
+                         *       "email": "ada@example.com",
+                         *       "created": 1735689600000,
+                         *       "usageStartedAt": 1735689600000,
+                         *       "enviroment": "test",
+                         *       "products": [
+                         *         {
+                         *           "id": "prod_123",
+                         *           "key": "starter",
+                         *           "name": "Starter",
+                         *           "type": "stripe",
+                         *           "isDefault": false,
+                         *           "status": "active",
+                         *           "version": 1,
+                         *           "metadata": {
+                         *             "tier": "starter"
+                         *           },
+                         *           "canceledAt": null,
+                         *           "startedAt": 1735689600000,
+                         *           "currentPeriodStart": 1735689600000,
+                         *           "currentPeriodEnd": 1738368000000,
+                         *           "prices": [
+                         *             {
+                         *               "stripePriceId": "price_123",
+                         *               "quantity": 1,
+                         *               "currency": "usd",
+                         *               "unitAmount": 2000,
+                         *               "recurringInterval": "month",
+                         *               "isActive": true,
+                         *               "isDefault": true,
+                         *               "recurringIntervalCount": 1
+                         *             }
+                         *           ]
+                         *         }
+                         *       ],
+                         *       "featureAccess": {
+                         *         "api_calls": {
+                         *           "hasAccess": true,
+                         *           "type": "limit",
+                         *           "limit": 1000,
+                         *           "isUnlimited": false,
+                         *           "usage": {
+                         *             "used": 120,
+                         *             "remaining": 880,
+                         *             "bonusRemaining": 25,
+                         *             "hasReachedLimit": false,
+                         *             "bonusUsed": 5,
+                         *             "nextReset": 1738368000000,
+                         *             "lastReset": 1735689600000
+                         *           }
+                         *         },
+                         *         "team_seats": {
+                         *           "hasAccess": true,
+                         *           "type": "boolean"
                          *         }
                          *       },
-                         *       "team_seats": {
-                         *         "hasAccess": true,
-                         *         "type": "boolean"
-                         *       }
+                         *       "bonuses": [
+                         *         {
+                         *           "bonusId": "9e9be7e5-55d2-4b44-93af-c3687f4b8af5",
+                         *           "featureKey": "api_calls",
+                         *           "amount": 50,
+                         *           "remainingAmount": 50,
+                         *           "expiresAt": 1738368000000,
+                         *           "reason": "Support credit",
+                         *           "metadata": {
+                         *             "source": "support"
+                         *           },
+                         *           "createdAt": 1735689600000,
+                         *           "updatedAt": 1735689600000
+                         *         }
+                         *       ]
                          *     }
                          */
                         "application/json": {
-                            [key: string]: {
+                            /** @description Customer ID (internal or Stripe). */
+                            customerId?: string;
+                            /** @description Stripe customer ID. */
+                            stripeCustomerId?: string;
+                            /** @description Whether the Stripe customer has at least one saved payment method. */
+                            hasPaymentMethod: boolean;
+                            /** @description Customer name. */
+                            name?: string;
+                            /** @description Customer email address. */
+                            email?: string;
+                            /** @description Unix timestamp (ms) when the customer was created. */
+                            created?: number;
+                            /**
+                             * @description Customer environment.
+                             * @enum {string}
+                             */
+                            enviroment: "test" | "live";
+                            /** @description Subscribed or assigned products. */
+                            products: {
+                                /** @description Product ID. */
+                                id: string;
+                                /** @description Product key. */
+                                key: string;
+                                /** @description Product name. */
+                                name: string;
                                 /**
-                                 * @description Feature access type.
+                                 * @description Product type.
                                  * @enum {string}
                                  */
-                                type: "boolean";
-                                /** @description Whether the customer has access. */
-                                hasAccess: boolean;
-                            } | {
+                                type: "stripe" | "custom";
+                                /** @description Whether this product is the default custom product. */
+                                isDefault: boolean;
                                 /**
-                                 * @description Feature access type.
+                                 * @description Stripe subscription status (Stripe customers only).
                                  * @enum {string}
                                  */
-                                type: "limit";
-                                /** @description Whether the customer has access. */
-                                hasAccess: boolean;
-                                /** @description Whether the feature is unlimited. */
-                                isUnlimited: boolean;
-                                /** @description Limit for the feature, when applicable. */
-                                limit: number | null;
-                                /** @description Usage details for tracked features. */
-                                usage?: {
-                                    /** @description Usage consumed for the feature. */
-                                    used: number;
-                                    /** @description Remaining base limit (limit - used). */
-                                    remaining: number | null;
-                                    /** @description Remaining bonus amount. */
-                                    bonusRemaining: number;
-                                    /** @description Whether base limit is met or exceeded and no bonus amount remains. */
-                                    hasReachedLimit: boolean;
-                                    /** @description Bonus amount consumed. */
-                                    bonusUsed: number;
-                                    /** @description Unix timestamp (ms) for the next reset, when applicable. */
-                                    nextReset: number | null;
-                                    /** @description Unix timestamp (ms) for the last reset, when applicable. */
-                                    lastReset: number | null;
+                                status: "incomplete" | "incomplete_expired" | "trialing" | "active" | "past_due" | "paused" | "unpaid" | "canceled";
+                                /** @description Product version number. */
+                                version: number;
+                                /** @description Custom product metadata (custom products only). */
+                                metadata?: {
+                                    [key: string]: string;
                                 };
-                            };
-                        };
-                    };
-                };
-                /** @description Bad request */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /** @description Error message. */
-                            error: string;
+                                /** @description Unix timestamp (ms) when the subscription was canceled (Stripe customers only). */
+                                canceledAt?: number | null;
+                                /** @description Unix timestamp (ms) when the subscription started (Stripe customers only). */
+                                startedAt?: number;
+                                /** @description Unix timestamp (ms) for the current period start (Stripe customers only). */
+                                currentPeriodStart?: number;
+                                /** @description Unix timestamp (ms) for the current period end (Stripe customers only). */
+                                currentPeriodEnd?: number;
+                                /** @description Prices tied to this product (Stripe customers only). */
+                                prices?: {
+                                    /** @description Stripe price ID. */
+                                    stripePriceId: string;
+                                    /** @description Price quantity. */
+                                    quantity: number;
+                                    /** @description ISO currency code. */
+                                    currency: string;
+                                    /** @description Unit amount in the smallest currency unit. */
+                                    unitAmount: number;
+                                    /** @description Recurring interval, if any. */
+                                    recurringInterval: string | null;
+                                    /** @description Whether the price is active. */
+                                    isActive: boolean;
+                                    /** @description Whether this is the default price. */
+                                    isDefault: boolean;
+                                    /** @description Number of intervals between charges. */
+                                    recurringIntervalCount: number;
+                                }[];
+                            }[];
+                            /** @description Feature access map. */
+                            featureAccess: {
+                                [key: string]: {
+                                    /**
+                                     * @description Feature access type.
+                                     * @enum {string}
+                                     */
+                                    type: "boolean";
+                                    /** @description Whether the customer has access. */
+                                    hasAccess: boolean;
+                                } | {
+                                    /**
+                                     * @description Feature access type.
+                                     * @enum {string}
+                                     */
+                                    type: "limit";
+                                    /** @description Whether the customer has access. */
+                                    hasAccess: boolean;
+                                    /** @description Whether the feature is unlimited. */
+                                    isUnlimited: boolean;
+                                    /** @description Limit for the feature, when applicable. */
+                                    limit: number | null;
+                                    /** @description Usage details for tracked features. */
+                                    usage?: {
+                                        /** @description Usage consumed for the feature. */
+                                        used: number;
+                                        /** @description Remaining base limit (limit - used). */
+                                        remaining: number | null;
+                                        /** @description Remaining bonus amount. */
+                                        bonusRemaining: number;
+                                        /** @description Whether base limit is met or exceeded and no bonus amount remains. */
+                                        hasReachedLimit: boolean;
+                                        /** @description Bonus amount consumed. */
+                                        bonusUsed: number;
+                                        /** @description Unix timestamp (ms) for the next reset, when applicable. */
+                                        nextReset: number | null;
+                                        /** @description Unix timestamp (ms) for the last reset, when applicable. */
+                                        lastReset: number | null;
+                                    };
+                                };
+                            };
+                            /** @description Customer bonuses. */
+                            bonuses: {
+                                /**
+                                 * Format: uuid
+                                 * @description Bonus ID.
+                                 */
+                                bonusId: string;
+                                /** @description Feature key. */
+                                featureKey: string;
+                                /** @description Bonus amount. */
+                                amount: number;
+                                /** @description Remaining bonus amount. */
+                                remainingAmount: number;
+                                /** @description Unix timestamp (ms) when the bonus expires. */
+                                expiresAt?: number | null;
+                                /** @description Bonus reason. */
+                                reason?: string | null;
+                                /** @description Bonus metadata. */
+                                metadata?: {
+                                    [key: string]: string;
+                                };
+                                /** @description Unix timestamp (ms) when the bonus was created. */
+                                createdAt: number;
+                                /** @description Unix timestamp (ms) when the bonus was updated. */
+                                updatedAt: number;
+                            }[];
+                            /** @description Resolved Unix timestamp (ms) usage reset anchor. For Stripe customers, this is derived from active Stripe product period start (or product startedAt) when available. Otherwise it uses stored usageStartedAt; if unset, it falls back to the customer created timestamp. */
+                            usageStartedAt?: number;
                         };
                     };
                 };
-                /** @description Unauthorized */
-                401: {
+                /** @description Bad request */
+                400: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -1690,8 +1884,8 @@ export interface paths {
                         };
                     };
                 };
-                /** @description Server error */
-                500: {
+                /** @description Unauthorized */
+                401: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -1702,76 +1896,8 @@ export interface paths {
                         };
                     };
                 };
-            };
-        };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/features": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get features
-         * @description List features for the workspace.
-         */
-        get: {
-            parameters: {
-                query?: never;
-                header: {
-                    /** @description API key from your PriceOS dashboard. */
-                    "x-api-key": string;
-                };
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Feature list */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /** @description Feature ID. */
-                            id: string;
-                            /** @description Feature key. */
-                            featureKey: string;
-                            /** @description Feature name. */
-                            name: string;
-                            /** @description Feature description. */
-                            description: string | null;
-                            /**
-                             * @description Feature access type.
-                             * @enum {string}
-                             */
-                            type: "boolean" | "limit";
-                            /** @description Whether the feature tracks usage. */
-                            tracksUsage: boolean;
-                            /**
-                             * @description Usage reset interval.
-                             * @enum {string}
-                             */
-                            usageResetInterval: "never" | "day" | "week" | "month" | "year";
-                            /**
-                             * @description Usage reset anchor.
-                             * @enum {string}
-                             */
-                            usageResetAnchor: "billing_period" | "calendar";
-                        }[];
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
+                /** @description Not found */
+                404: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -1796,43 +1922,48 @@ export interface paths {
                 };
             };
         };
-        put?: never;
-        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/pricing-table": {
+    "/v1/customers/{customerId}/custom-product/remove": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: never;
         /**
-         * Get pricing table
-         * @description List plans with PriceOS feature/limit definitions. Optionally include customer plan state and load a specific pricing table by key.
+         * Remove custom product
+         * @description Remove one custom product from a customer.
          */
-        get: {
+        post: {
             parameters: {
-                query?: {
-                    /** @description Optional customer ID (internal or Stripe). */
-                    customerId?: string | null;
-                    /** @description Optional pricing table key. */
-                    pricingTableKey?: string | null;
-                };
+                query?: never;
                 header: {
                     /** @description API key from your PriceOS dashboard. */
                     "x-api-key": string;
                 };
-                path?: never;
+                path: {
+                    /** @description Customer ID (internal or Stripe). */
+                    customerId: string;
+                };
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** @description Custom product key to add or remove. */
+                        customProductKey: string;
+                    };
+                };
+            };
             responses: {
-                /** @description Pricing table */
+                /** @description Customer custom product updated */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -1840,209 +1971,492 @@ export interface paths {
                     content: {
                         /**
                          * @example {
-                         *       "table": {
-                         *         "id": "11111111-1111-1111-1111-111111111111",
-                         *         "name": "Default pricing table",
-                         *         "tableKey": "default_table",
-                         *         "settings": {
-                         *           "defaultView": "monthly",
-                         *           "language": "en",
-                         *           "backgroundColor": "#ffffff",
-                         *           "buttonColor": "#0074d4",
-                         *           "fontFamily": "system",
-                         *           "buttonShape": "rounded",
-                         *           "highlightProduct": false,
-                         *           "pricingDisplay": "monthly_terms"
-                         *         }
-                         *       },
-                         *       "plans": [
+                         *       "customerId": "customer_123",
+                         *       "stripeCustomerId": "cus_abc123",
+                         *       "hasPaymentMethod": true,
+                         *       "name": "Ada Lovelace",
+                         *       "email": "ada@example.com",
+                         *       "created": 1735689600000,
+                         *       "usageStartedAt": 1735689600000,
+                         *       "enviroment": "test",
+                         *       "products": [
                          *         {
-                         *           "productId": "prod_123",
-                         *           "productKey": "starter",
+                         *           "id": "prod_123",
+                         *           "key": "starter",
                          *           "name": "Starter",
-                         *           "monthlyPrice": {
-                         *             "stripePriceId": "price_monthly_starter",
-                         *             "label": "$29/month",
-                         *             "currency": "usd",
-                         *             "unitAmount": 2900,
-                         *             "recurringInterval": "month",
-                         *             "recurringIntervalCount": 1
+                         *           "type": "stripe",
+                         *           "isDefault": false,
+                         *           "status": "active",
+                         *           "version": 1,
+                         *           "metadata": {
+                         *             "tier": "starter"
                          *           },
-                         *           "yearlyPrice": {
-                         *             "stripePriceId": "price_yearly_starter",
-                         *             "label": "$290/year",
-                         *             "currency": "usd",
-                         *             "unitAmount": 29000,
-                         *             "recurringInterval": "year",
-                         *             "recurringIntervalCount": 1
-                         *           },
-                         *           "features": [
-                         *             {
-                         *               "featureKey": "api_calls",
-                         *               "name": "API Calls",
-                         *               "type": "limit",
-                         *               "label": "10000 API Calls",
-                         *               "limit": 10000,
-                         *               "isUnlimited": false
-                         *             },
+                         *           "canceledAt": null,
+                         *           "startedAt": 1735689600000,
+                         *           "currentPeriodStart": 1735689600000,
+                         *           "currentPeriodEnd": 1738368000000,
+                         *           "prices": [
                          *             {
-                         *               "featureKey": "priority_support",
-                         *               "name": "Priority Support",
-                         *               "type": "boolean",
-                         *               "label": "Priority Support"
+                         *               "stripePriceId": "price_123",
+                         *               "quantity": 1,
+                         *               "currency": "usd",
+                         *               "unitAmount": 2000,
+                         *               "recurringInterval": "month",
+                         *               "isActive": true,
+                         *               "isDefault": true,
+                         *               "recurringIntervalCount": 1
                          *             }
-                         *           ],
-                         *           "isCurrent": true
+                         *           ]
                          *         }
                          *       ],
-                         *       "customer": {
-                         *         "customerId": "customer_123",
-                         *         "stripeCustomerId": "cus_abc123",
-                         *         "currentProductIds": [
-                         *           "prod_123"
-                         *         ],
-                         *         "currentPriceIds": [
-                         *           "price_monthly_starter"
-                         *         ]
-                         *       }
+                         *       "featureAccess": {
+                         *         "api_calls": {
+                         *           "hasAccess": true,
+                         *           "type": "limit",
+                         *           "limit": 1000,
+                         *           "isUnlimited": false,
+                         *           "usage": {
+                         *             "used": 120,
+                         *             "remaining": 880,
+                         *             "bonusRemaining": 25,
+                         *             "hasReachedLimit": false,
+                         *             "bonusUsed": 5,
+                         *             "nextReset": 1738368000000,
+                         *             "lastReset": 1735689600000
+                         *           }
+                         *         },
+                         *         "team_seats": {
+                         *           "hasAccess": true,
+                         *           "type": "boolean"
+                         *         }
+                         *       },
+                         *       "bonuses": [
+                         *         {
+                         *           "bonusId": "9e9be7e5-55d2-4b44-93af-c3687f4b8af5",
+                         *           "featureKey": "api_calls",
+                         *           "amount": 50,
+                         *           "remainingAmount": 50,
+                         *           "expiresAt": 1738368000000,
+                         *           "reason": "Support credit",
+                         *           "metadata": {
+                         *             "source": "support"
+                         *           },
+                         *           "createdAt": 1735689600000,
+                         *           "updatedAt": 1735689600000
+                         *         }
+                         *       ]
                          *     }
                          */
                         "application/json": {
-                            /** @description Pricing plans. */
-                            plans: {
+                            /** @description Customer ID (internal or Stripe). */
+                            customerId?: string;
+                            /** @description Stripe customer ID. */
+                            stripeCustomerId?: string;
+                            /** @description Whether the Stripe customer has at least one saved payment method. */
+                            hasPaymentMethod: boolean;
+                            /** @description Customer name. */
+                            name?: string;
+                            /** @description Customer email address. */
+                            email?: string;
+                            /** @description Unix timestamp (ms) when the customer was created. */
+                            created?: number;
+                            /**
+                             * @description Customer environment.
+                             * @enum {string}
+                             */
+                            enviroment: "test" | "live";
+                            /** @description Subscribed or assigned products. */
+                            products: {
                                 /** @description Product ID. */
-                                productId: string;
+                                id: string;
                                 /** @description Product key. */
-                                productKey: string;
-                                /** @description Product display name. */
+                                key: string;
+                                /** @description Product name. */
                                 name: string;
-                                /** @description Optional product description text shown in the pricing card. */
-                                description?: string;
-                                /** @description Optional subheader text shown above this plan's feature list. */
-                                featuresSubheader?: string;
-                                /** @description Monthly recurring price, when available. */
-                                monthlyPrice: {
-                                    /** @description Stripe price ID. */
-                                    stripePriceId: string;
-                                    /** @description Formatted display label. */
-                                    label: string;
-                                    /** @description ISO currency code. */
-                                    currency: string;
-                                    /** @description Unit amount in the smallest currency unit. */
-                                    unitAmount: number | null;
-                                    /** @description Recurring interval, if any. */
-                                    recurringInterval: string | null;
-                                    /** @description Recurring interval count, if any. */
-                                    recurringIntervalCount: number | null;
-                                } | null;
-                                /** @description Yearly recurring price, when available. */
-                                yearlyPrice: {
+                                /**
+                                 * @description Product type.
+                                 * @enum {string}
+                                 */
+                                type: "stripe" | "custom";
+                                /** @description Whether this product is the default custom product. */
+                                isDefault: boolean;
+                                /**
+                                 * @description Stripe subscription status (Stripe customers only).
+                                 * @enum {string}
+                                 */
+                                status: "incomplete" | "incomplete_expired" | "trialing" | "active" | "past_due" | "paused" | "unpaid" | "canceled";
+                                /** @description Product version number. */
+                                version: number;
+                                /** @description Custom product metadata (custom products only). */
+                                metadata?: {
+                                    [key: string]: string;
+                                };
+                                /** @description Unix timestamp (ms) when the subscription was canceled (Stripe customers only). */
+                                canceledAt?: number | null;
+                                /** @description Unix timestamp (ms) when the subscription started (Stripe customers only). */
+                                startedAt?: number;
+                                /** @description Unix timestamp (ms) for the current period start (Stripe customers only). */
+                                currentPeriodStart?: number;
+                                /** @description Unix timestamp (ms) for the current period end (Stripe customers only). */
+                                currentPeriodEnd?: number;
+                                /** @description Prices tied to this product (Stripe customers only). */
+                                prices?: {
                                     /** @description Stripe price ID. */
                                     stripePriceId: string;
-                                    /** @description Formatted display label. */
-                                    label: string;
+                                    /** @description Price quantity. */
+                                    quantity: number;
                                     /** @description ISO currency code. */
                                     currency: string;
                                     /** @description Unit amount in the smallest currency unit. */
-                                    unitAmount: number | null;
+                                    unitAmount: number;
                                     /** @description Recurring interval, if any. */
                                     recurringInterval: string | null;
-                                    /** @description Recurring interval count, if any. */
-                                    recurringIntervalCount: number | null;
-                                } | null;
-                                /** @description Feature and limit entries for the product. */
-                                features: {
-                                    /** @description Feature key. */
-                                    featureKey: string;
-                                    /** @description Feature name. */
-                                    name: string;
+                                    /** @description Whether the price is active. */
+                                    isActive: boolean;
+                                    /** @description Whether this is the default price. */
+                                    isDefault: boolean;
+                                    /** @description Number of intervals between charges. */
+                                    recurringIntervalCount: number;
+                                }[];
+                            }[];
+                            /** @description Feature access map. */
+                            featureAccess: {
+                                [key: string]: {
                                     /**
                                      * @description Feature access type.
                                      * @enum {string}
                                      */
-                                    type: "boolean" | "limit";
-                                    /** @description Human-readable feature label. */
-                                    label: string;
-                                    /** @description Configured numeric limit for limit features. */
-                                    limit?: number | null;
-                                    /** @description Whether the feature is unlimited. */
-                                    isUnlimited?: boolean;
-                                }[];
-                                /** @description Custom CTA configuration for non-checkout plans. */
-                                customCta?: {
+                                    type: "boolean";
+                                    /** @description Whether the customer has access. */
+                                    hasAccess: boolean;
+                                } | {
                                     /**
-                                     * @description Action triggered by the pricing table button.
+                                     * @description Feature access type.
                                      * @enum {string}
                                      */
-                                    buttonAction?: "stripe_checkout" | "custom_url";
-                                    /** @description Custom call-to-action button label. */
-                                    buttonText?: string;
-                                    /**
-                                     * Format: uri
-                                     * @description URL opened when the custom call-to-action button is clicked.
-                                     */
-                                    linkUrl?: string;
+                                    type: "limit";
+                                    /** @description Whether the customer has access. */
+                                    hasAccess: boolean;
+                                    /** @description Whether the feature is unlimited. */
+                                    isUnlimited: boolean;
+                                    /** @description Limit for the feature, when applicable. */
+                                    limit: number | null;
+                                    /** @description Usage details for tracked features. */
+                                    usage?: {
+                                        /** @description Usage consumed for the feature. */
+                                        used: number;
+                                        /** @description Remaining base limit (limit - used). */
+                                        remaining: number | null;
+                                        /** @description Remaining bonus amount. */
+                                        bonusRemaining: number;
+                                        /** @description Whether base limit is met or exceeded and no bonus amount remains. */
+                                        hasReachedLimit: boolean;
+                                        /** @description Bonus amount consumed. */
+                                        bonusUsed: number;
+                                        /** @description Unix timestamp (ms) for the next reset, when applicable. */
+                                        nextReset: number | null;
+                                        /** @description Unix timestamp (ms) for the last reset, when applicable. */
+                                        lastReset: number | null;
+                                    };
                                 };
-                                /** @description Whether this plan is currently assigned to the customer. */
-                                isCurrent?: boolean;
-                            }[];
-                            /** @description Current customer state when available. */
-                            customer: {
-                                /** @description Resolved customer ID. */
-                                customerId: string;
-                                /** @description Resolved Stripe customer ID. */
-                                stripeCustomerId?: string | null;
-                                /** @description Current Stripe product IDs assigned to the customer. */
-                                currentProductIds: string[];
-                                /** @description Current Stripe price IDs assigned to the customer. */
-                                currentPriceIds: string[];
-                            } | null;
-                            /** @description Selected pricing table when requested by key. */
-                            table: {
+                            };
+                            /** @description Customer bonuses. */
+                            bonuses: {
                                 /**
                                  * Format: uuid
-                                 * @description Pricing table ID.
+                                 * @description Bonus ID.
                                  */
-                                id: string;
-                                /** @description Pricing table name. */
-                                name: string;
-                                /** @description Pricing table key. */
-                                tableKey: string;
-                                /** @description Display settings. */
-                                settings: {
-                                    /**
-                                     * @description Default billing interval shown in the table.
-                                     * @enum {string}
-                                     */
-                                    defaultView: "monthly" | "yearly";
-                                    /** @description Display language. */
-                                    language: string;
-                                    /** @description Table background color hex code. */
-                                    backgroundColor: string;
-                                    /** @description Primary button color hex code. */
-                                    buttonColor: string;
-                                    /** @description Font family identifier. */
-                                    fontFamily: string;
-                                    /** @description Button shape. */
-                                    buttonShape: string;
-                                    /** @description Whether a highlighted product style is enabled. */
-                                    highlightProduct: boolean;
-                                    /** @description Product ID to highlight when highlight mode is enabled. */
-                                    highlightProductId?: string;
-                                    /** @description Label displayed on the highlighted product. */
-                                    highlightLabel?: string;
-                                    /**
-                                     * @description How yearly prices are displayed in the pricing table.
-                                     * @enum {string}
-                                     */
-                                    pricingDisplay: "monthly_terms" | "monthly_terms_only" | "annual_terms";
-                                    /**
-                                     * @description Whether custom CTA products are shown before or after priced products.
-                                     * @enum {string}
-                                     */
-                                    customProductPosition?: "first" | "last";
+                                bonusId: string;
+                                /** @description Feature key. */
+                                featureKey: string;
+                                /** @description Bonus amount. */
+                                amount: number;
+                                /** @description Remaining bonus amount. */
+                                remainingAmount: number;
+                                /** @description Unix timestamp (ms) when the bonus expires. */
+                                expiresAt?: number | null;
+                                /** @description Bonus reason. */
+                                reason?: string | null;
+                                /** @description Bonus metadata. */
+                                metadata?: {
+                                    [key: string]: string;
+                                };
+                                /** @description Unix timestamp (ms) when the bonus was created. */
+                                createdAt: number;
+                                /** @description Unix timestamp (ms) when the bonus was updated. */
+                                updatedAt: number;
+                            }[];
+                            /** @description Resolved Unix timestamp (ms) usage reset anchor. For Stripe customers, this is derived from active Stripe product period start (or product startedAt) when available. Otherwise it uses stored usageStartedAt; if unset, it falls back to the customer created timestamp. */
+                            usageStartedAt?: number;
+                        };
+                    };
+                };
+                /** @description Bad request */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description Error message. */
+                            error: string;
+                        };
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description Error message. */
+                            error: string;
+                        };
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description Error message. */
+                            error: string;
+                        };
+                    };
+                };
+                /** @description Server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description Error message. */
+                            error: string;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/usage/set": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Set usage
+         * @description Set absolute usage for the current period by recording an adjustment event.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header: {
+                    /** @description API key from your PriceOS dashboard. */
+                    "x-api-key": string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** @description Customer ID (internal or Stripe). */
+                        customerId: string;
+                        /** @description Feature key to set usage for. */
+                        featureKey: string;
+                        /** @description Absolute usage value to set for the current usage period. */
+                        used: number;
+                        /** @description Stable unique identifier for this event. Reuse it on retries for idempotency and to reference the event later. */
+                        idempotencyKey?: string;
+                        /** @description Optional metadata for the adjustment event (string key/value pairs). */
+                        metadata?: {
+                            [key: string]: string;
+                        };
+                    };
+                };
+            };
+            responses: {
+                /** @description Usage set */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description Whether the usage event was applied. */
+                            applied: boolean;
+                            /** @description Updated usage total, if applicable. */
+                            used: number | null;
+                            /** @description Reason the usage event was not applied. */
+                            reason?: string | null;
+                            /** @description Adjustment amount applied to reach the requested usage value. */
+                            adjustment: number;
+                        };
+                    };
+                };
+                /** @description Bad request */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description Error message. */
+                            error: string;
+                        };
+                    };
+                };
+                /** @description Unauthorized */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description Error message. */
+                            error: string;
+                        };
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description Error message. */
+                            error: string;
+                        };
+                    };
+                };
+                /** @description Server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description Error message. */
+                            error: string;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/feature-access": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get feature access
+         * @description Return feature access for a customer.
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description Customer ID (internal or Stripe). */
+                    customerId: string;
+                };
+                header: {
+                    /** @description API key from your PriceOS dashboard. */
+                    "x-api-key": string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Feature access lookup */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "api_calls": {
+                         *         "hasAccess": true,
+                         *         "type": "limit",
+                         *         "limit": 1000,
+                         *         "isUnlimited": false,
+                         *         "usage": {
+                         *           "used": 120,
+                         *           "remaining": 880,
+                         *           "bonusRemaining": 25,
+                         *           "hasReachedLimit": false,
+                         *           "bonusUsed": 5,
+                         *           "nextReset": 1738368000000,
+                         *           "lastReset": 1735689600000
+                         *         }
+                         *       },
+                         *       "team_seats": {
+                         *         "hasAccess": true,
+                         *         "type": "boolean"
+                         *       }
+                         *     }
+                         */
+                        "application/json": {
+                            [key: string]: {
+                                /**
+                                 * @description Feature access type.
+                                 * @enum {string}
+                                 */
+                                type: "boolean";
+                                /** @description Whether the customer has access. */
+                                hasAccess: boolean;
+                            } | {
+                                /**
+                                 * @description Feature access type.
+                                 * @enum {string}
+                                 */
+                                type: "limit";
+                                /** @description Whether the customer has access. */
+                                hasAccess: boolean;
+                                /** @description Whether the feature is unlimited. */
+                                isUnlimited: boolean;
+                                /** @description Limit for the feature, when applicable. */
+                                limit: number | null;
+                                /** @description Usage details for tracked features. */
+                                usage?: {
+                                    /** @description Usage consumed for the feature. */
+                                    used: number;
+                                    /** @description Remaining base limit (limit - used). */
+                                    remaining: number | null;
+                                    /** @description Remaining bonus amount. */
+                                    bonusRemaining: number;
+                                    /** @description Whether base limit is met or exceeded and no bonus amount remains. */
+                                    hasReachedLimit: boolean;
+                                    /** @description Bonus amount consumed. */
+                                    bonusUsed: number;
+                                    /** @description Unix timestamp (ms) for the next reset, when applicable. */
+                                    nextReset: number | null;
+                                    /** @description Unix timestamp (ms) for the last reset, when applicable. */
+                                    lastReset: number | null;
                                 };
-                            } | null;
+                            };
                         };
                     };
                 };
@@ -2092,20 +2506,18 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/checkout": {
+    "/v1/features": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
         /**
-         * Create checkout session
-         * @description Create a Stripe checkout session for a Stripe price linked to the workspace. Optionally links checkout to a PriceOS customer.
+         * Get features
+         * @description List features for the workspace.
          */
-        post: {
+        get: {
             parameters: {
                 query?: never;
                 header: {
@@ -2115,61 +2527,41 @@ export interface paths {
                 path?: never;
                 cookie?: never;
             };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        /** @description Stripe price ID. */
-                        stripePriceId: string;
-                        /**
-                         * Format: uri
-                         * @description Checkout success redirect URL.
-                         */
-                        successUrl: string;
-                        /**
-                         * Format: uri
-                         * @description Checkout cancel redirect URL. Defaults to successUrl when omitted.
-                         */
-                        cancelUrl?: string;
-                        /** @description Optional customer ID (internal or Stripe). */
-                        customerId?: string | null;
-                        /** @description Optional metadata to attach to the Stripe checkout session. */
-                        metadata?: {
-                            [key: string]: string;
-                        };
-                    };
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description Checkout session */
+                /** @description Feature list */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        /**
-                         * @example {
-                         *       "url": "https://checkout.stripe.com/c/pay/cs_test_123"
-                         *     }
-                         */
                         "application/json": {
+                            /** @description Feature ID. */
+                            id: string;
+                            /** @description Feature key. */
+                            featureKey: string;
+                            /** @description Feature name. */
+                            name: string;
+                            /** @description Feature description. */
+                            description: string | null;
                             /**
-                             * Format: uri
-                             * @description Stripe checkout URL.
+                             * @description Feature access type.
+                             * @enum {string}
                              */
-                            url: string;
-                        };
-                    };
-                };
-                /** @description Bad request */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /** @description Error message. */
-                            error: string;
-                        };
+                            type: "boolean" | "limit";
+                            /** @description Whether the feature tracks usage. */
+                            tracksUsage: boolean;
+                            /**
+                             * @description Usage reset interval.
+                             * @enum {string}
+                             */
+                            usageResetInterval: "never" | "day" | "week" | "month" | "year";
+                            /**
+                             * @description Usage reset anchor.
+                             * @enum {string}
+                             */
+                            usageResetAnchor: "billing_period" | "calendar";
+                        }[];
                     };
                 };
                 /** @description Unauthorized */
@@ -2184,30 +2576,6 @@ export interface paths {
                         };
                     };
                 };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /** @description Error message. */
-                            error: string;
-                        };
-                    };
-                };
-                /** @description Conflict */
-                409: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /** @description Error message. */
-                            error: string;
-                        };
-                    };
-                };
                 /** @description Server error */
                 500: {
                     headers: {
@@ -2222,28 +2590,33 @@ export interface paths {
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/usage": {
+    "/v1/pricing-table": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
         /**
-         * Track usage
-         * @description Record usage for a feature.
+         * Get pricing table
+         * @description List plans with PriceOS feature/limit definitions. Optionally include customer plan state and load a specific pricing table by key.
          */
-        post: {
+        get: {
             parameters: {
-                query?: never;
+                query?: {
+                    /** @description Optional customer ID (internal or Stripe). */
+                    customerId?: string | null;
+                    /** @description Optional pricing table key. */
+                    pricingTableKey?: string | null;
+                };
                 header: {
                     /** @description API key from your PriceOS dashboard. */
                     "x-api-key": string;
@@ -2251,45 +2624,219 @@ export interface paths {
                 path?: never;
                 cookie?: never;
             };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        /** @description Customer ID (internal or Stripe). */
-                        customerId: string;
-                        /** @description Feature key to track usage for. */
-                        featureKey: string;
-                        /**
-                         * @description Usage amount to record. Defaults to 1. Supports positive or negative values.
-                         * @default 1
-                         */
-                        amount?: number;
-                        /** @description Stable unique identifier for this event. Reuse it on retries for idempotency and to reference the event later. */
-                        idempotencyKey?: string;
-                        /** @description Deprecated alias for idempotencyKey. Prefer idempotencyKey. */
-                        eventKey?: string;
-                        /** @description Unix timestamp (ms) when the event occurred. */
-                        occurredAt?: number;
-                        /** @description Optional metadata for the event (string key/value pairs). */
-                        metadata?: {
-                            [key: string]: string;
-                        };
-                    };
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description Usage recorded */
+                /** @description Pricing table */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
+                        /**
+                         * @example {
+                         *       "table": {
+                         *         "id": "11111111-1111-1111-1111-111111111111",
+                         *         "name": "Default pricing table",
+                         *         "tableKey": "default_table",
+                         *         "settings": {
+                         *           "defaultView": "monthly",
+                         *           "language": "en",
+                         *           "backgroundColor": "#ffffff",
+                         *           "buttonColor": "#0074d4",
+                         *           "fontFamily": "system",
+                         *           "buttonShape": "rounded",
+                         *           "highlightProduct": false,
+                         *           "pricingDisplay": "monthly_terms"
+                         *         }
+                         *       },
+                         *       "plans": [
+                         *         {
+                         *           "productId": "prod_123",
+                         *           "productKey": "starter",
+                         *           "name": "Starter",
+                         *           "monthlyPrice": {
+                         *             "stripePriceId": "price_monthly_starter",
+                         *             "label": "$29/month",
+                         *             "currency": "usd",
+                         *             "unitAmount": 2900,
+                         *             "recurringInterval": "month",
+                         *             "recurringIntervalCount": 1
+                         *           },
+                         *           "yearlyPrice": {
+                         *             "stripePriceId": "price_yearly_starter",
+                         *             "label": "$290/year",
+                         *             "currency": "usd",
+                         *             "unitAmount": 29000,
+                         *             "recurringInterval": "year",
+                         *             "recurringIntervalCount": 1
+                         *           },
+                         *           "features": [
+                         *             {
+                         *               "featureKey": "api_calls",
+                         *               "name": "API Calls",
+                         *               "type": "limit",
+                         *               "label": "10000 API Calls",
+                         *               "limit": 10000,
+                         *               "isUnlimited": false
+                         *             },
+                         *             {
+                         *               "featureKey": "priority_support",
+                         *               "name": "Priority Support",
+                         *               "type": "boolean",
+                         *               "label": "Priority Support"
+                         *             }
+                         *           ],
+                         *           "isCurrent": true
+                         *         }
+                         *       ],
+                         *       "customer": {
+                         *         "customerId": "customer_123",
+                         *         "stripeCustomerId": "cus_abc123",
+                         *         "currentProductIds": [
+                         *           "prod_123"
+                         *         ],
+                         *         "currentPriceIds": [
+                         *           "price_monthly_starter"
+                         *         ]
+                         *       }
+                         *     }
+                         */
                         "application/json": {
-                            /** @description Whether the usage event was applied. */
-                            applied: boolean;
-                            /** @description Updated usage total, if applicable. */
-                            used: number | null;
-                            /** @description Reason the usage event was not applied. */
-                            reason?: string | null;
+                            /** @description Pricing plans. */
+                            plans: {
+                                /** @description Product ID. */
+                                productId: string;
+                                /** @description Product key. */
+                                productKey: string;
+                                /** @description Product display name. */
+                                name: string;
+                                /** @description Optional product description text shown in the pricing card. */
+                                description?: string;
+                                /** @description Optional subheader text shown above this plan's feature list. */
+                                featuresSubheader?: string;
+                                /** @description Monthly recurring price, when available. */
+                                monthlyPrice: {
+                                    /** @description Stripe price ID. */
+                                    stripePriceId: string;
+                                    /** @description Formatted display label. */
+                                    label: string;
+                                    /** @description ISO currency code. */
+                                    currency: string;
+                                    /** @description Unit amount in the smallest currency unit. */
+                                    unitAmount: number | null;
+                                    /** @description Recurring interval, if any. */
+                                    recurringInterval: string | null;
+                                    /** @description Recurring interval count, if any. */
+                                    recurringIntervalCount: number | null;
+                                } | null;
+                                /** @description Yearly recurring price, when available. */
+                                yearlyPrice: {
+                                    /** @description Stripe price ID. */
+                                    stripePriceId: string;
+                                    /** @description Formatted display label. */
+                                    label: string;
+                                    /** @description ISO currency code. */
+                                    currency: string;
+                                    /** @description Unit amount in the smallest currency unit. */
+                                    unitAmount: number | null;
+                                    /** @description Recurring interval, if any. */
+                                    recurringInterval: string | null;
+                                    /** @description Recurring interval count, if any. */
+                                    recurringIntervalCount: number | null;
+                                } | null;
+                                /** @description Feature and limit entries for the product. */
+                                features: {
+                                    /** @description Feature key. */
+                                    featureKey: string;
+                                    /** @description Feature name. */
+                                    name: string;
+                                    /**
+                                     * @description Feature access type.
+                                     * @enum {string}
+                                     */
+                                    type: "boolean" | "limit";
+                                    /** @description Human-readable feature label. */
+                                    label: string;
+                                    /** @description Configured numeric limit for limit features. */
+                                    limit?: number | null;
+                                    /** @description Whether the feature is unlimited. */
+                                    isUnlimited?: boolean;
+                                }[];
+                                /** @description Custom CTA configuration for non-checkout plans. */
+                                customCta?: {
+                                    /**
+                                     * @description Action triggered by the pricing table button.
+                                     * @enum {string}
+                                     */
+                                    buttonAction?: "stripe_checkout" | "custom_url";
+                                    /** @description Custom call-to-action button label. */
+                                    buttonText?: string;
+                                    /**
+                                     * Format: uri
+                                     * @description URL opened when the custom call-to-action button is clicked.
+                                     */
+                                    linkUrl?: string;
+                                };
+                                /** @description Whether this plan is currently assigned to the customer. */
+                                isCurrent?: boolean;
+                            }[];
+                            /** @description Current customer state when available. */
+                            customer: {
+                                /** @description Resolved customer ID. */
+                                customerId: string;
+                                /** @description Resolved Stripe customer ID. */
+                                stripeCustomerId?: string | null;
+                                /** @description Current Stripe product IDs assigned to the customer. */
+                                currentProductIds: string[];
+                                /** @description Current Stripe price IDs assigned to the customer. */
+                                currentPriceIds: string[];
+                            } | null;
+                            /** @description Selected pricing table when requested by key. */
+                            table: {
+                                /**
+                                 * Format: uuid
+                                 * @description Pricing table ID.
+                                 */
+                                id: string;
+                                /** @description Pricing table name. */
+                                name: string;
+                                /** @description Pricing table key. */
+                                tableKey: string;
+                                /** @description Display settings. */
+                                settings: {
+                                    /**
+                                     * @description Default billing interval shown in the table.
+                                     * @enum {string}
+                                     */
+                                    defaultView: "monthly" | "yearly";
+                                    /** @description Display language. */
+                                    language: string;
+                                    /** @description Table background color hex code. */
+                                    backgroundColor: string;
+                                    /** @description Primary button color hex code. */
+                                    buttonColor: string;
+                                    /** @description Font family identifier. */
+                                    fontFamily: string;
+                                    /** @description Button shape. */
+                                    buttonShape: string;
+                                    /** @description Whether a highlighted product style is enabled. */
+                                    highlightProduct: boolean;
+                                    /** @description Product ID to highlight when highlight mode is enabled. */
+                                    highlightProductId?: string;
+                                    /** @description Label displayed on the highlighted product. */
+                                    highlightLabel?: string;
+                                    /**
+                                     * @description How yearly prices are displayed in the pricing table.
+                                     * @enum {string}
+                                     */
+                                    pricingDisplay: "monthly_terms" | "monthly_terms_only" | "annual_terms";
+                                    /**
+                                     * @description Whether custom CTA products are shown before or after priced products.
+                                     * @enum {string}
+                                     */
+                                    customProductPosition?: "first" | "last";
+                                };
+                            } | null;
                         };
                     };
                 };
@@ -2317,18 +2864,6 @@ export interface paths {
                         };
                     };
                 };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /** @description Error message. */
-                            error: string;
-                        };
-                    };
-                };
                 /** @description Server error */
                 500: {
                     headers: {
@@ -2343,130 +2878,26 @@ export interface paths {
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/bonuses": {
+    "/v1/checkout": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /**
-         * List bonuses
-         * @description List bonuses for a customer, optionally filtered by feature key.
-         */
-        get: {
-            parameters: {
-                query: {
-                    /** @description Customer ID (internal or Stripe). */
-                    customerId: string;
-                    /** @description Optional feature key to filter bonuses. */
-                    featureKey?: string | null;
-                };
-                header: {
-                    /** @description API key from your PriceOS dashboard. */
-                    "x-api-key": string;
-                };
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Bonus list */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /** @description Bonuses. */
-                            bonuses: {
-                                /**
-                                 * Format: uuid
-                                 * @description Bonus ID.
-                                 */
-                                bonusId: string;
-                                /** @description Feature key. */
-                                featureKey: string;
-                                /** @description Bonus amount. */
-                                amount: number;
-                                /** @description Remaining bonus amount. */
-                                remainingAmount: number;
-                                /** @description Unix timestamp (ms) when the bonus expires. */
-                                expiresAt?: number | null;
-                                /** @description Bonus reason. */
-                                reason?: string | null;
-                                /** @description Bonus metadata. */
-                                metadata?: {
-                                    [key: string]: string;
-                                };
-                                /** @description Unix timestamp (ms) when the bonus was created. */
-                                createdAt: number;
-                                /** @description Unix timestamp (ms) when the bonus was last updated. */
-                                updatedAt: number;
-                            }[];
-                        };
-                    };
-                };
-                /** @description Bad request */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /** @description Error message. */
-                            error: string;
-                        };
-                    };
-                };
-                /** @description Unauthorized */
-                401: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /** @description Error message. */
-                            error: string;
-                        };
-                    };
-                };
-                /** @description Not found */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /** @description Error message. */
-                            error: string;
-                        };
-                    };
-                };
-                /** @description Server error */
-                500: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /** @description Error message. */
-                            error: string;
-                        };
-                    };
-                };
-            };
-        };
+        get?: never;
         put?: never;
         /**
-         * Create bonus
-         * @description Create a one-time bonus amount for a customer feature.
+         * Create checkout session
+         * @description Create a Stripe checkout session for a Stripe price linked to the workspace. Optionally links checkout to a PriceOS customer.
          */
         post: {
             parameters: {
@@ -2479,19 +2910,23 @@ export interface paths {
                 cookie?: never;
             };
             requestBody: {
-                content: {
-                    "application/json": {
-                        /** @description Customer ID (internal or Stripe). */
-                        customerId: string;
-                        /** @description Feature key to create bonus for. */
-                        featureKey: string;
-                        /** @description Bonus amount to create. */
-                        amount: number;
-                        /** @description Optional Unix timestamp (ms) when the bonus expires. */
-                        expiresAt?: number;
-                        /** @description Optional reason for the bonus. */
-                        reason?: string | null;
-                        /** @description Optional metadata for the bonus (string key/value pairs). */
+                content: {
+                    "application/json": {
+                        /** @description Stripe price ID. */
+                        stripePriceId: string;
+                        /**
+                         * Format: uri
+                         * @description Checkout success redirect URL.
+                         */
+                        successUrl: string;
+                        /**
+                         * Format: uri
+                         * @description Checkout cancel redirect URL. Defaults to successUrl when omitted.
+                         */
+                        cancelUrl?: string;
+                        /** @description Optional customer ID (internal or Stripe). */
+                        customerId?: string | null;
+                        /** @description Optional metadata to attach to the Stripe checkout session. */
                         metadata?: {
                             [key: string]: string;
                         };
@@ -2499,22 +2934,23 @@ export interface paths {
                 };
             };
             responses: {
-                /** @description Bonus created */
+                /** @description Checkout session */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
+                        /**
+                         * @example {
+                         *       "url": "https://checkout.stripe.com/c/pay/cs_test_123"
+                         *     }
+                         */
                         "application/json": {
                             /**
-                             * Format: uuid
-                             * @description Bonus ID.
+                             * Format: uri
+                             * @description Stripe checkout URL.
                              */
-                            bonusId: string;
-                            /** @description Remaining amount for the newly created grant. */
-                            remainingAmount: number;
-                            /** @description Total remaining bonus amount for this customer + feature. */
-                            counterRemaining: number;
+                            url: string;
                         };
                     };
                 };
@@ -2554,6 +2990,18 @@ export interface paths {
                         };
                     };
                 };
+                /** @description Conflict */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @description Error message. */
+                            error: string;
+                        };
+                    };
+                };
                 /** @description Server error */
                 500: {
                     headers: {
@@ -2574,7 +3022,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/bonuses/{bonusId}": {
+    "/v1/usage": {
         parameters: {
             query?: never;
             header?: never;
@@ -2582,75 +3030,58 @@ export interface paths {
             cookie?: never;
         };
         get?: never;
+        put?: never;
         /**
-         * Update bonus
-         * @description Update an existing bonus.
+         * Track usage
+         * @description Record usage for a feature.
          */
-        put: {
+        post: {
             parameters: {
                 query?: never;
                 header: {
                     /** @description API key from your PriceOS dashboard. */
                     "x-api-key": string;
                 };
-                path: {
-                    /** @description Bonus ID. */
-                    bonusId: string;
-                };
+                path?: never;
                 cookie?: never;
             };
             requestBody: {
                 content: {
                     "application/json": {
-                        /** @description Optional updated bonus amount. */
+                        /** @description Customer ID (internal or Stripe). */
+                        customerId: string;
+                        /** @description Feature key to track usage for. */
+                        featureKey: string;
+                        /**
+                         * @description Usage amount to record. Defaults to 1. Supports positive or negative values.
+                         * @default 1
+                         */
                         amount?: number;
-                        /** @description Optional Unix timestamp (ms) when the bonus expires. Use null to clear. */
-                        expiresAt?: number | null;
-                        /** @description Optional reason for the bonus. Use null to clear. */
-                        reason?: string | null;
-                        /** @description Optional metadata for the bonus (string key/value pairs). Use null to clear. */
+                        /** @description Stable unique identifier for this event. Reuse it on retries for idempotency and to reference the event later. */
+                        idempotencyKey?: string;
+                        /** @description Unix timestamp (ms) when the event occurred. */
+                        occurredAt?: number;
+                        /** @description Optional metadata for the event (string key/value pairs). */
                         metadata?: {
                             [key: string]: string;
-                        } | null;
+                        };
                     };
                 };
             };
             responses: {
-                /** @description Bonus updated */
+                /** @description Usage recorded */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            /** @description Updated bonus. */
-                            bonus: {
-                                /**
-                                 * Format: uuid
-                                 * @description Bonus ID.
-                                 */
-                                bonusId: string;
-                                /** @description Feature key. */
-                                featureKey: string;
-                                /** @description Bonus amount. */
-                                amount: number;
-                                /** @description Remaining bonus amount. */
-                                remainingAmount: number;
-                                /** @description Unix timestamp (ms) when the bonus expires. */
-                                expiresAt?: number | null;
-                                /** @description Bonus reason. */
-                                reason?: string | null;
-                                /** @description Bonus metadata. */
-                                metadata?: {
-                                    [key: string]: string;
-                                };
-                                /** @description Unix timestamp (ms) when the bonus was created. */
-                                createdAt: number;
-                                /** @description Unix timestamp (ms) when the bonus was last updated. */
-                                updatedAt: number;
-                            };
-                            /** @description Total remaining bonus amount for this customer + feature. */
-                            counterRemaining: number;
+                            /** @description Whether the usage event was applied. */
+                            applied: boolean;
+                            /** @description Updated usage total, if applicable. */
+                            used: number | null;
+                            /** @description Reason the usage event was not applied. */
+                            reason?: string | null;
                         };
                     };
                 };
@@ -2704,45 +3135,73 @@ export interface paths {
                 };
             };
         };
-        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/bonuses": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
         /**
-         * Delete bonus
-         * @description Delete an existing bonus that has not been consumed.
+         * List bonuses
+         * @description List bonuses for a customer, optionally filtered by feature key.
          */
-        delete: {
+        get: {
             parameters: {
-                query?: never;
+                query: {
+                    /** @description Customer ID (internal or Stripe). */
+                    customerId: string;
+                    /** @description Optional feature key to filter bonuses. */
+                    featureKey?: string | null;
+                };
                 header: {
                     /** @description API key from your PriceOS dashboard. */
                     "x-api-key": string;
                 };
-                path: {
-                    /** @description Bonus ID. */
-                    bonusId: string;
-                };
+                path?: never;
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Bonus deleted */
+                /** @description Bonus list */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            /**
-                             * @description Whether the bonus was deleted.
-                             * @enum {boolean}
-                             */
-                            deleted: true;
-                            /**
-                             * Format: uuid
-                             * @description Deleted bonus ID.
-                             */
-                            bonusId: string;
-                            /** @description Total remaining bonus amount for this customer + feature. */
-                            counterRemaining: number;
+                            /** @description Bonuses. */
+                            bonuses: {
+                                /**
+                                 * Format: uuid
+                                 * @description Bonus ID.
+                                 */
+                                bonusId: string;
+                                /** @description Feature key. */
+                                featureKey: string;
+                                /** @description Bonus amount. */
+                                amount: number;
+                                /** @description Remaining bonus amount. */
+                                remainingAmount: number;
+                                /** @description Unix timestamp (ms) when the bonus expires. */
+                                expiresAt?: number | null;
+                                /** @description Bonus reason. */
+                                reason?: string | null;
+                                /** @description Bonus metadata. */
+                                metadata?: {
+                                    [key: string]: string;
+                                };
+                                /** @description Unix timestamp (ms) when the bonus was created. */
+                                createdAt: number;
+                                /** @description Unix timestamp (ms) when the bonus was last updated. */
+                                updatedAt: number;
+                            }[];
                         };
                     };
                 };
@@ -2796,72 +3255,58 @@ export interface paths {
                 };
             };
         };
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/usage/{id}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
+        put?: never;
         /**
-         * Get usage event
-         * @description Get a usage event by ID.
+         * Create bonus
+         * @description Create a one-time bonus amount for a customer feature.
          */
-        get: {
+        post: {
             parameters: {
                 query?: never;
                 header: {
                     /** @description API key from your PriceOS dashboard. */
                     "x-api-key": string;
                 };
-                path: {
-                    /** @description Usage event ID. */
-                    id: string;
-                };
+                path?: never;
                 cookie?: never;
             };
-            requestBody?: never;
-            responses: {
-                /** @description Usage event */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** @description Customer ID (internal or Stripe). */
+                        customerId: string;
+                        /** @description Feature key to create bonus for. */
+                        featureKey: string;
+                        /** @description Bonus amount to create. */
+                        amount: number;
+                        /** @description Optional Unix timestamp (ms) when the bonus expires. */
+                        expiresAt?: number;
+                        /** @description Optional reason for the bonus. */
+                        reason?: string | null;
+                        /** @description Optional metadata for the bonus (string key/value pairs). */
+                        metadata?: {
+                            [key: string]: string;
+                        };
                     };
-                    content: {
-                        "application/json": {
-                            /** @description Usage event. */
-                            usageEvent: {
-                                /** @description Usage event ID. */
-                                id: string;
-                                /** @description Usage amount recorded. */
-                                amount: number;
-                                /** @description Unix timestamp (ms) when the event occurred. */
-                                occurredAt: number;
-                                /** @description Stable unique identifier for this event. Reuse it on retries for idempotency and to reference the event later. */
-                                idempotencyKey?: string | null;
-                                /** @description Deprecated alias for idempotencyKey. Prefer idempotencyKey. */
-                                eventKey?: string | null;
-                                /**
-                                 * @description Usage event source.
-                                 * @enum {string}
-                                 */
-                                source: "usage" | "usage_set_adjustment";
-                                /** @description Event metadata (string key/value pairs). */
-                                metadata?: {
-                                    [key: string]: string;
-                                };
-                                /** @description Whether the usage event is voided. */
-                                isVoid: boolean;
-                                /** @description Unix timestamp (ms) when the event was voided. */
-                                voidedAt?: number | null;
-                                /** @description Reason the event was voided. */
-                                voidedReason?: string | null;
-                            };
+                };
+            };
+            responses: {
+                /** @description Bonus created */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /**
+                             * Format: uuid
+                             * @description Bonus ID.
+                             */
+                            bonusId: string;
+                            /** @description Remaining amount for the newly created grant. */
+                            remainingAmount: number;
+                            /** @description Total remaining bonus amount for this customer + feature. */
+                            counterRemaining: number;
                         };
                     };
                 };
@@ -2915,9 +3360,23 @@ export interface paths {
                 };
             };
         };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/bonuses/{bonusId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
         /**
-         * Update usage event
-         * @description Update a usage event by ID.
+         * Update bonus
+         * @description Update an existing bonus.
          */
         put: {
             parameters: {
@@ -2927,23 +3386,21 @@ export interface paths {
                     "x-api-key": string;
                 };
                 path: {
-                    /** @description Usage event ID. */
-                    id: string;
+                    /** @description Bonus ID. */
+                    bonusId: string;
                 };
                 cookie?: never;
             };
             requestBody: {
                 content: {
                     "application/json": {
-                        /** @description Optional updated usage amount. */
+                        /** @description Optional updated bonus amount. */
                         amount?: number;
-                        /** @description Optional updated Unix timestamp (ms) when the event occurred. */
-                        occurredAt?: number;
-                        /** @description Stable unique identifier for this event. Reuse it on retries for idempotency and to reference the event later. Use null to clear. */
-                        idempotencyKey?: string | null;
-                        /** @description Deprecated alias for idempotencyKey. Prefer idempotencyKey. Use null to clear. */
-                        eventKey?: string | null;
-                        /** @description Optional updated metadata (string key/value pairs). Use null to clear. */
+                        /** @description Optional Unix timestamp (ms) when the bonus expires. Use null to clear. */
+                        expiresAt?: number | null;
+                        /** @description Optional reason for the bonus. Use null to clear. */
+                        reason?: string | null;
+                        /** @description Optional metadata for the bonus (string key/value pairs). Use null to clear. */
                         metadata?: {
                             [key: string]: string;
                         } | null;
@@ -2951,41 +3408,41 @@ export interface paths {
                 };
             };
             responses: {
-                /** @description Usage event updated */
+                /** @description Bonus updated */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            /** @description Usage event. */
-                            usageEvent: {
-                                /** @description Usage event ID. */
-                                id: string;
-                                /** @description Usage amount recorded. */
-                                amount: number;
-                                /** @description Unix timestamp (ms) when the event occurred. */
-                                occurredAt: number;
-                                /** @description Stable unique identifier for this event. Reuse it on retries for idempotency and to reference the event later. */
-                                idempotencyKey?: string | null;
-                                /** @description Deprecated alias for idempotencyKey. Prefer idempotencyKey. */
-                                eventKey?: string | null;
+                            /** @description Updated bonus. */
+                            bonus: {
                                 /**
-                                 * @description Usage event source.
-                                 * @enum {string}
+                                 * Format: uuid
+                                 * @description Bonus ID.
                                  */
-                                source: "usage" | "usage_set_adjustment";
-                                /** @description Event metadata (string key/value pairs). */
+                                bonusId: string;
+                                /** @description Feature key. */
+                                featureKey: string;
+                                /** @description Bonus amount. */
+                                amount: number;
+                                /** @description Remaining bonus amount. */
+                                remainingAmount: number;
+                                /** @description Unix timestamp (ms) when the bonus expires. */
+                                expiresAt?: number | null;
+                                /** @description Bonus reason. */
+                                reason?: string | null;
+                                /** @description Bonus metadata. */
                                 metadata?: {
                                     [key: string]: string;
                                 };
-                                /** @description Whether the usage event is voided. */
-                                isVoid: boolean;
-                                /** @description Unix timestamp (ms) when the event was voided. */
-                                voidedAt?: number | null;
-                                /** @description Reason the event was voided. */
-                                voidedReason?: string | null;
+                                /** @description Unix timestamp (ms) when the bonus was created. */
+                                createdAt: number;
+                                /** @description Unix timestamp (ms) when the bonus was last updated. */
+                                updatedAt: number;
                             };
+                            /** @description Total remaining bonus amount for this customer + feature. */
+                            counterRemaining: number;
                         };
                     };
                 };
@@ -3041,8 +3498,8 @@ export interface paths {
         };
         post?: never;
         /**
-         * Delete usage event
-         * @description Delete a usage event by ID.
+         * Delete bonus
+         * @description Delete an existing bonus that has not been consumed.
          */
         delete: {
             parameters: {
@@ -3052,22 +3509,32 @@ export interface paths {
                     "x-api-key": string;
                 };
                 path: {
-                    /** @description Usage event ID. */
-                    id: string;
+                    /** @description Bonus ID. */
+                    bonusId: string;
                 };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Usage event deleted */
+                /** @description Bonus deleted */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            /** @description Number of usage events deleted. */
-                            deletedCount: number;
+                            /**
+                             * @description Whether the bonus was deleted.
+                             * @enum {boolean}
+                             */
+                            deleted: true;
+                            /**
+                             * Format: uuid
+                             * @description Deleted bonus ID.
+                             */
+                            bonusId: string;
+                            /** @description Total remaining bonus amount for this customer + feature. */
+                            counterRemaining: number;
                         };
                     };
                 };
@@ -3126,7 +3593,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/usage/idempotency-key/{idempotencyKey}": {
+    "/v1/usage/{id}": {
         parameters: {
             query?: never;
             header?: never;
@@ -3134,8 +3601,8 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get usage event by idempotency key
-         * @description Get a usage event by idempotency key.
+         * Get usage event
+         * @description Get a usage event by ID.
          */
         get: {
             parameters: {
@@ -3145,8 +3612,8 @@ export interface paths {
                     "x-api-key": string;
                 };
                 path: {
-                    /** @description Usage event idempotency key. */
-                    idempotencyKey: string;
+                    /** @description Usage event ID. */
+                    id: string;
                 };
                 cookie?: never;
             };
@@ -3159,33 +3626,22 @@ export interface paths {
                     };
                     content: {
                         "application/json": {
-                            /** @description Usage event. */
-                            usageEvent: {
-                                /** @description Usage event ID. */
-                                id: string;
-                                /** @description Usage amount recorded. */
-                                amount: number;
-                                /** @description Unix timestamp (ms) when the event occurred. */
-                                occurredAt: number;
-                                /** @description Stable unique identifier for this event. Reuse it on retries for idempotency and to reference the event later. */
-                                idempotencyKey?: string | null;
-                                /** @description Deprecated alias for idempotencyKey. Prefer idempotencyKey. */
-                                eventKey?: string | null;
-                                /**
-                                 * @description Usage event source.
-                                 * @enum {string}
-                                 */
-                                source: "usage" | "usage_set_adjustment";
-                                /** @description Event metadata (string key/value pairs). */
-                                metadata?: {
-                                    [key: string]: string;
-                                };
-                                /** @description Whether the usage event is voided. */
-                                isVoid: boolean;
-                                /** @description Unix timestamp (ms) when the event was voided. */
-                                voidedAt?: number | null;
-                                /** @description Reason the event was voided. */
-                                voidedReason?: string | null;
+                            /** @description Usage event ID. */
+                            id: string;
+                            /** @description Usage amount recorded. */
+                            amount: number;
+                            /** @description Unix timestamp (ms) when the event occurred. */
+                            occurredAt: number;
+                            /** @description Stable unique identifier for this event. Reuse it on retries for idempotency and to reference the event later. */
+                            idempotencyKey?: string | null;
+                            /**
+                             * @description Usage event source.
+                             * @enum {string}
+                             */
+                            source: "usage" | "usage_set_adjustment";
+                            /** @description Event metadata (string key/value pairs). */
+                            metadata?: {
+                                [key: string]: string;
                             };
                         };
                     };
@@ -3240,27 +3696,11 @@ export interface paths {
                 };
             };
         };
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/usage/event-key/{eventKey}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
         /**
-         * Get usage event by event key (legacy)
-         * @deprecated
-         * @description Legacy alias for get usage event by idempotency key.
+         * Update usage event
+         * @description Update a usage event by ID.
          */
-        get: {
+        put: {
             parameters: {
                 query?: never;
                 header: {
@@ -3268,47 +3708,51 @@ export interface paths {
                     "x-api-key": string;
                 };
                 path: {
-                    /** @description Legacy usage event key. */
-                    eventKey: string;
+                    /** @description Usage event ID. */
+                    id: string;
                 };
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** @description Optional updated usage amount. */
+                        amount?: number;
+                        /** @description Optional updated Unix timestamp (ms) when the event occurred. */
+                        occurredAt?: number;
+                        /** @description Stable unique identifier for this event. Reuse it on retries for idempotency and to reference the event later. Use null to clear. */
+                        idempotencyKey?: string | null;
+                        /** @description Optional updated metadata (string key/value pairs). Use null to clear. */
+                        metadata?: {
+                            [key: string]: string;
+                        } | null;
+                    };
+                };
+            };
             responses: {
-                /** @description Usage event */
+                /** @description Usage event updated */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            /** @description Usage event. */
-                            usageEvent: {
-                                /** @description Usage event ID. */
-                                id: string;
-                                /** @description Usage amount recorded. */
-                                amount: number;
-                                /** @description Unix timestamp (ms) when the event occurred. */
-                                occurredAt: number;
-                                /** @description Stable unique identifier for this event. Reuse it on retries for idempotency and to reference the event later. */
-                                idempotencyKey?: string | null;
-                                /** @description Deprecated alias for idempotencyKey. Prefer idempotencyKey. */
-                                eventKey?: string | null;
-                                /**
-                                 * @description Usage event source.
-                                 * @enum {string}
-                                 */
-                                source: "usage" | "usage_set_adjustment";
-                                /** @description Event metadata (string key/value pairs). */
-                                metadata?: {
-                                    [key: string]: string;
-                                };
-                                /** @description Whether the usage event is voided. */
-                                isVoid: boolean;
-                                /** @description Unix timestamp (ms) when the event was voided. */
-                                voidedAt?: number | null;
-                                /** @description Reason the event was voided. */
-                                voidedReason?: string | null;
+                            /** @description Usage event ID. */
+                            id: string;
+                            /** @description Usage amount recorded. */
+                            amount: number;
+                            /** @description Unix timestamp (ms) when the event occurred. */
+                            occurredAt: number;
+                            /** @description Stable unique identifier for this event. Reuse it on retries for idempotency and to reference the event later. */
+                            idempotencyKey?: string | null;
+                            /**
+                             * @description Usage event source.
+                             * @enum {string}
+                             */
+                            source: "usage" | "usage_set_adjustment";
+                            /** @description Event metadata (string key/value pairs). */
+                            metadata?: {
+                                [key: string]: string;
                             };
                         };
                     };
@@ -3363,28 +3807,12 @@ export interface paths {
                 };
             };
         };
-        put?: never;
         post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/v1/usage/{id}/void": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
         /**
-         * Void usage event
-         * @description Void a single usage event by ID.
+         * Delete usage event
+         * @description Delete a usage event by ID.
          */
-        post: {
+        delete: {
             parameters: {
                 query?: never;
                 header: {
@@ -3397,50 +3825,17 @@ export interface paths {
                 };
                 cookie?: never;
             };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        /** @description Optional reason for voiding the usage event. */
-                        reason?: string | null;
-                    };
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description Usage event voided */
+                /** @description Usage event deleted */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            /** @description Usage event. */
-                            usageEvent: {
-                                /** @description Usage event ID. */
-                                id: string;
-                                /** @description Usage amount recorded. */
-                                amount: number;
-                                /** @description Unix timestamp (ms) when the event occurred. */
-                                occurredAt: number;
-                                /** @description Stable unique identifier for this event. Reuse it on retries for idempotency and to reference the event later. */
-                                idempotencyKey?: string | null;
-                                /** @description Deprecated alias for idempotencyKey. Prefer idempotencyKey. */
-                                eventKey?: string | null;
-                                /**
-                                 * @description Usage event source.
-                                 * @enum {string}
-                                 */
-                                source: "usage" | "usage_set_adjustment";
-                                /** @description Event metadata (string key/value pairs). */
-                                metadata?: {
-                                    [key: string]: string;
-                                };
-                                /** @description Whether the usage event is voided. */
-                                isVoid: boolean;
-                                /** @description Unix timestamp (ms) when the event was voided. */
-                                voidedAt?: number | null;
-                                /** @description Reason the event was voided. */
-                                voidedReason?: string | null;
-                            };
+                            /** @description Number of usage events deleted. */
+                            deletedCount: number;
                         };
                     };
                 };
@@ -3494,7 +3889,6 @@ export interface paths {
                 };
             };
         };
-        delete?: never;
         options?: never;
         head?: never;
         patch?: never;
@@ -3655,8 +4049,6 @@ export interface paths {
                             amount?: number;
                             /** @description Stable unique identifier for this event. Reuse it on retries for idempotency and to reference the event later. */
                             idempotencyKey?: string;
-                            /** @description Deprecated alias for idempotencyKey. Prefer idempotencyKey. */
-                            eventKey?: string;
                             /** @description Unix timestamp (ms) when the event occurred. */
                             occurredAt?: number;
                             /** @description Optional metadata for the event (string key/value pairs). */
@@ -3836,8 +4228,6 @@ export interface paths {
                                 occurredAt: number;
                                 /** @description Stable unique identifier for this event. Reuse it on retries for idempotency and to reference the event later. */
                                 idempotencyKey?: string | null;
-                                /** @description Deprecated alias for idempotencyKey. Prefer idempotencyKey. */
-                                eventKey?: string | null;
                                 /**
                                  * @description Usage event source.
                                  * @enum {string}