@purveyors/sdk 0.26.0 → 0.28.0

package/dist/index.d.ts

@@ -125,8 +125,8 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Request deletion of the authenticated user's account
-         * @description Idempotently creates or returns the durable deletion operation and quiesces owner writes. This destructive session-only route is dark-launched.
+         * Accept deletion of the authenticated account
+         * @description Cryptographically validates a recent purpose-bound coffee-app assertion and atomically creates or replays the permanent Parchment-owned deletion operation.
          */
         post: {
             parameters: {
@@ -135,9 +135,15 @@ interface paths {
                 path?: never;
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody: {
+                content: {
+                    "application/json": {
+                        assertion: string;
+                    };
+                };
+            };
             responses: {
-                /** @description Durable deletion operation */
+                /** @description Existing accepted deletion operation */
                 200: {
                     headers: {
                         /** @description Sensitive lifecycle responses are never cached */
@@ -148,6 +154,26 @@ interface paths {
                         "application/json": components["schemas"]["AccountDeletionOperation"];
                     };
                 };
+                /** @description Deletion accepted; the durable worker owns convergence */
+                202: {
+                    headers: {
+                        /** @description Sensitive lifecycle responses are never cached */
+                        "Cache-Control"?: string;
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["AccountDeletionOperation"];
+                    };
+                };
+                /** @description Malformed assertion request */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
                 /** @description A valid Supabase user session is required */
                 401: {
                     headers: {
@@ -157,8 +183,8 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Account deletion is blocked by account or billing state */
-                409: {
+                /** @description Recent account-deletion reauthentication is invalid */
+                403: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -166,8 +192,8 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description The owner mutation throttle was exceeded */
-                429: {
+                /** @description Account deletion is blocked by deterministic local work */
+                409: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -175,7 +201,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description The lifecycle is disabled or storage is unavailable */
+                /** @description The activated lifecycle or storage is unavailable */
                 503: {
                     headers: {
                         [name: string]: unknown;
@@ -192,7 +218,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/checkout-admissions": {
+    "/v1/billing/checkout-sessions": {
         parameters: {
             query?: never;
             header?: never;
@@ -201,10 +227,7 @@ interface paths {
         };
         get?: never;
         put?: never;
-        /**
-         * Acquire a durable Stripe Checkout admission
-         * @description Session-only dark-launch boundary. Acquire before creating Stripe state; replay the same request id after an ambiguous client failure and use admissionId as the Stripe idempotency key.
-         */
+        /** Create or replay an embedded Stripe Checkout Session */
         post: {
             parameters: {
                 query?: never;
@@ -217,20 +240,27 @@ interface paths {
                     "application/json": {
                         /** Format: uuid */
                         requestId: string;
+                        purchaseItems: {
+                            purchaseKey: string;
+                            /** @default 1 */
+                            quantity?: number;
+                        }[];
                     };
                 };
             };
             responses: {
-                /** @description Durable owner-bound Checkout admission */
+                /** @description Created or replayed Checkout Session */
                 200: {
                     headers: {
+                        /** @description Billing responses are never shared-cacheable */
+                        "Cache-Control"?: string;
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["CheckoutAdmission"];
+                        "application/json": components["schemas"]["BillingCheckoutSession"];
                     };
                 };
-                /** @description Malformed request */
+                /** @description Unknown product or definite provider rejection */
                 400: {
                     headers: {
                         [name: string]: unknown;
@@ -248,7 +278,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Checkout is fenced by account deletion */
+                /** @description The operation conflicts with current durable state */
                 409: {
                     headers: {
                         [name: string]: unknown;
@@ -257,8 +287,8 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description The owner mutation throttle was exceeded */
-                429: {
+                /** @description The billing JSON request body exceeds the maximum size */
+                413: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -266,7 +296,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Checkout admission storage is unavailable */
+                /** @description Billing storage or provider state is unavailable */
                 503: {
                     headers: {
                         [name: string]: unknown;
@@ -283,54 +313,34 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/checkout-admissions/{admissionId}/publish": {
+    "/v1/billing/checkout-sessions/{admissionId}": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
-        /**
-         * Publish the Stripe session created for an admission
-         * @description Dark-launch trusted coffee BFF boundary. Requires the owner session plus provider credential so an owner cannot attach an arbitrary Stripe Checkout Session to the admission ledger. Publication is idempotent for the same admission and Stripe session.
-         */
-        post: {
+        /** Read owner-bound Checkout admission state */
+        get: {
             parameters: {
                 query?: never;
-                header: {
-                    "x-account-deletion-provider-credential": string;
-                };
+                header?: never;
                 path: {
                     admissionId: string;
                 };
                 cookie?: never;
             };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        stripeSessionId: string;
-                    };
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description Published Checkout admission */
+                /** @description Checkout admission state */
                 200: {
                     headers: {
+                        /** @description Billing responses are never shared-cacheable */
+                        "Cache-Control"?: string;
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["CheckoutAdmission"];
-                    };
-                };
-                /** @description Malformed request */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                        "application/json": components["schemas"]["BillingCheckoutSession"];
                     };
                 };
                 /** @description A valid Supabase user session is required */
@@ -342,15 +352,6 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Trusted provider authorization is required */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
                 /** @description Admission not found */
                 404: {
                     headers: {
@@ -360,7 +361,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Checkout is fenced by account deletion */
+                /** @description The operation conflicts with current durable state */
                 409: {
                     headers: {
                         [name: string]: unknown;
@@ -369,16 +370,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description The owner mutation throttle was exceeded */
-                429: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Checkout admission storage is unavailable */
+                /** @description Billing storage or provider state is unavailable */
                 503: {
                     headers: {
                         [name: string]: unknown;
@@ -389,13 +381,15 @@ interface paths {
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/checkout-admissions/{admissionId}/abandon": {
+    "/v1/billing/checkout-sessions/{admissionId}/reconcile": {
         parameters: {
             query?: never;
             header?: never;
@@ -404,46 +398,27 @@ interface paths {
         };
         get?: never;
         put?: never;
-        /**
-         * Resolve a Checkout admission with definite no-session evidence
-         * @description Dark-launch trusted coffee BFF boundary. Requires the owner session plus provider credential. Call only after Stripe authoritatively proves no Checkout Session exists for the admission idempotency key; an ordinary user session cannot erase creating-state ambiguity.
-         */
+        /** Authoritatively reconcile a Checkout admission */
         post: {
             parameters: {
                 query?: never;
-                header: {
-                    "x-account-deletion-provider-credential": string;
-                };
+                header?: never;
                 path: {
                     admissionId: string;
                 };
                 cookie?: never;
             };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        /** @enum {string} */
-                        evidence: "stripe_creation_definitively_absent";
-                    };
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description Closed Checkout admission */
+                /** @description Reconciled Checkout admission */
                 200: {
                     headers: {
+                        /** @description Billing responses are never shared-cacheable */
+                        "Cache-Control"?: string;
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["CheckoutAdmission"];
-                    };
-                };
-                /** @description Malformed request or evidence */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                        "application/json": components["schemas"]["BillingCheckoutSession"];
                     };
                 };
                 /** @description A valid Supabase user session is required */
@@ -455,16 +430,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Trusted provider authorization is required */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Creating admission not found */
+                /** @description Admission not found */
                 404: {
                     headers: {
                         [name: string]: unknown;
@@ -473,8 +439,8 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description The owner mutation throttle was exceeded */
-                429: {
+                /** @description The operation conflicts with current durable state */
+                409: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -482,7 +448,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Checkout admission storage is unavailable */
+                /** @description Billing storage or provider state is unavailable */
                 503: {
                     headers: {
                         [name: string]: unknown;
@@ -499,7 +465,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/checkout-admissions/provider-eligibility": {
+    "/v1/billing/stripe/webhook": {
         parameters: {
             query?: never;
             header?: never;
@@ -509,42 +475,34 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Check whether provider writes remain eligible
-         * @description Dark-launch internal webhook boundary. Requires the shared provider-finalization credential and returns false for missing, closed, cross-owner, or deletion-fenced admissions.
+         * Receive verified Stripe billing deliveries
+         * @description Verifies the Stripe signature against the untouched raw body before parsing and settles through the canonical atomic billing RPC.
          */
         post: {
             parameters: {
                 query?: never;
                 header: {
-                    "x-account-deletion-provider-credential": string;
+                    "stripe-signature": string;
                 };
                 path?: never;
                 cookie?: never;
             };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        /** Format: uuid */
-                        ownerId: string;
-                        /** Format: uuid */
-                        admissionId: string;
-                        stripeSessionId: string;
-                    };
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description Provider write eligibility */
+                /** @description Delivery settled or deterministically ignored */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
                         "application/json": {
-                            eligible: boolean;
+                            /** @enum {boolean} */
+                            received: true;
+                            outcome: string;
                         };
                     };
                 };
-                /** @description Malformed request */
+                /** @description Signature or provider payload is invalid */
                 400: {
                     headers: {
                         [name: string]: unknown;
@@ -553,8 +511,8 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Trusted provider authorization is required */
-                403: {
+                /** @description Provider payload exceeds the bounded webhook body limit */
+                413: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -562,7 +520,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Eligibility storage is unavailable */
+                /** @description Retryable provider or storage failure */
                 503: {
                     headers: {
                         [name: string]: unknown;
@@ -579,71 +537,50 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/checkout-admissions/provider-terminalization": {
+    "/v1/billing/subscriptions": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
-        /**
-         * Close a provider-terminal Checkout admission
-         * @description Dark-launch trusted webhook boundary for an expired Checkout Session. Completed or paid sessions remain published until account deletion verifies their authoritative Stripe billing state.
-         */
-        post: {
+        /** List canonical subscription snapshots */
+        get: {
             parameters: {
                 query?: never;
-                header: {
-                    "x-account-deletion-provider-credential": string;
-                };
+                header?: never;
                 path?: never;
                 cookie?: never;
             };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        /** Format: uuid */
-                        ownerId: string;
-                        /** Format: uuid */
-                        admissionId: string;
-                        stripeSessionId: string;
-                        /** @enum {string} */
-                        terminalStatus: "expired";
-                    };
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description Closed provider-terminal Checkout admission */
+                /** @description Owner billing snapshots and bounded management state */
                 200: {
                     headers: {
+                        /** @description Billing responses are never shared-cacheable */
+                        "Cache-Control"?: string;
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["CheckoutAdmission"];
-                    };
-                };
-                /** @description Malformed request */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Trusted provider authorization is required */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                        "application/json": {
+                            subscriptions: {
+                                subscriptionId: string;
+                                status: string;
+                                cancelAtPeriodEnd: boolean;
+                                /** Format: date-time */
+                                currentPeriodEnd: string | null;
+                                items: {
+                                    subscriptionItemId: string;
+                                    priceId: string;
+                                    purchaseKey: string;
+                                    productFamily: string;
+                                }[];
+                            }[];
+                        };
                     };
                 };
-                /** @description Published admission not found */
-                404: {
+                /** @description A valid Supabase user session is required */
+                401: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -651,7 +588,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Account deletion owns Checkout reconciliation */
+                /** @description The operation conflicts with current durable state */
                 409: {
                     headers: {
                         [name: string]: unknown;
@@ -660,16 +597,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description The owner mutation throttle was exceeded */
-                429: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Checkout admission storage is unavailable */
+                /** @description Billing storage or provider state is unavailable */
                 503: {
                     headers: {
                         [name: string]: unknown;
@@ -680,13 +608,15 @@ interface paths {
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/account-deletion/provider-finalization": {
+    "/v1/billing/subscriptions/{subscriptionId}": {
         parameters: {
             query?: never;
             header?: never;
@@ -695,46 +625,50 @@ interface paths {
         };
         get?: never;
         put?: never;
-        /**
-         * Publish provider-finalized account deletion work
-         * @description Internal coffee-app BFF boundary. Requires the owner's Supabase session and a separately configured server credential. Missing and cross-owner operation ids are indistinguishable.
-         */
-        post: {
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /** Cancel or resume an owner subscription */
+        patch: {
             parameters: {
                 query?: never;
-                header: {
-                    "x-account-deletion-provider-credential": string;
+                header?: never;
+                path: {
+                    subscriptionId: string;
                 };
-                path?: never;
                 cookie?: never;
             };
             requestBody: {
                 content: {
                     "application/json": {
                         /** Format: uuid */
-                        operationId: string;
+                        requestId: string;
+                        cancelAtPeriodEnd: boolean;
                     };
                 };
             };
             responses: {
-                /** @description Owner-bound operation after provider finalization */
+                /** @description Succeeded, superseded, or replayed subscription operation */
                 200: {
                     headers: {
-                        /** @description Sensitive lifecycle responses are never cached */
+                        /** @description Billing responses are never shared-cacheable */
                         "Cache-Control"?: string;
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["AccountDeletionOperation"];
+                        "application/json": components["schemas"]["BillingSubscriptionOperation"];
                     };
                 };
-                /** @description The operation id is malformed */
-                400: {
+                /** @description Provider operation remains durable and unresolved */
+                202: {
                     headers: {
+                        /** @description Billing responses are never shared-cacheable */
+                        "Cache-Control"?: string;
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                        "application/json": components["schemas"]["BillingSubscriptionOperation"];
                     };
                 };
                 /** @description A valid Supabase user session is required */
@@ -746,16 +680,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Trusted provider authorization is required */
-                403: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description The owner-bound deletion operation was not found */
+                /** @description Subscription not found */
                 404: {
                     headers: {
                         [name: string]: unknown;
@@ -764,7 +689,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Account deletion is blocked by dependent account state */
+                /** @description The operation conflicts with current durable state */
                 409: {
                     headers: {
                         [name: string]: unknown;
@@ -773,8 +698,8 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description The owner mutation throttle was exceeded */
-                429: {
+                /** @description The billing JSON request body exceeds the maximum size */
+                413: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -782,7 +707,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description The lifecycle is disabled or storage is unavailable */
+                /** @description Billing storage or provider state is unavailable */
                 503: {
                     headers: {
                         [name: string]: unknown;
@@ -793,20 +718,16 @@ interface paths {
                 };
             };
         };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
         trace?: never;
     };
-    "/v1/api-keys": {
+    "/v1/admin/billing-entitlement-discrepancies": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** List API keys for the authenticated user */
+        /** Read billing entitlement discrepancies */
         get: {
             parameters: {
                 query?: never;
@@ -816,25 +737,28 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description API keys owned by the authenticated user */
+                /** @description Bounded discrepancy report */
                 200: {
                     headers: {
+                        /** @description Billing responses are never shared-cacheable */
+                        "Cache-Control"?: string;
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["ApiKeyListResponse"];
-                    };
-                };
-                /** @description Invalid API-key request */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                        "application/json": {
+                            summary: {
+                                totalDiscrepancies: number;
+                                totalTrackedAccounts: number;
+                                /** Format: date-time */
+                                checkedAt: string;
+                            };
+                            discrepancies: {
+                                [key: string]: unknown;
+                            }[];
+                        };
                     };
                 };
-                /** @description Authentication required */
+                /** @description A valid Supabase user session is required */
                 401: {
                     headers: {
                         [name: string]: unknown;
@@ -843,7 +767,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Insufficient entitlement (plan or role) */
+                /** @description Parchment administrator role required */
                 403: {
                     headers: {
                         [name: string]: unknown;
@@ -852,16 +776,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description API key not found for the authenticated user */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description API key storage is unavailable */
+                /** @description Billing storage or provider state is unavailable */
                 503: {
                     headers: {
                         [name: string]: unknown;
@@ -873,16 +788,281 @@ interface paths {
             };
         };
         put?: never;
-        /** Create an API key for the authenticated user */
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/admin/billing-entitlement-discrepancies/{ownerId}/recompute": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Recompute billing contribution without changing manual grants */
         post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
+                path: {
+                    ownerId: string;
+                };
                 cookie?: never;
             };
-            requestBody: {
-                content: {
+            requestBody?: never;
+            responses: {
+                /** @description Canonical resolved entitlement projection */
+                200: {
+                    headers: {
+                        /** @description Billing responses are never shared-cacheable */
+                        "Cache-Control"?: string;
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            [key: string]: unknown;
+                        };
+                    };
+                };
+                /** @description A valid Supabase user session is required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Parchment administrator role required */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Owner not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description The operation conflicts with current durable state */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Billing storage or provider state is unavailable */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/admin/billing-entitlements/{ownerId}/manual": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /** Update the manual entitlement baseline and recompute */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    ownerId: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** @enum {string} */
+                        role: "viewer" | "member" | "admin";
+                        /** @enum {string} */
+                        apiPlan: "viewer" | "member" | "enterprise";
+                        ppiAccess: boolean;
+                    };
+                };
+            };
+            responses: {
+                /** @description Updated manual baseline and resolved projection */
+                200: {
+                    headers: {
+                        /** @description Billing responses are never shared-cacheable */
+                        "Cache-Control"?: string;
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            [key: string]: unknown;
+                        };
+                    };
+                };
+                /** @description A valid Supabase user session is required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Parchment administrator role required */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Owner not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description The operation conflicts with current durable state */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Billing storage or provider state is unavailable */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        trace?: never;
+    };
+    "/v1/api-keys": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List API keys for the authenticated user */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description API keys owned by the authenticated user */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ApiKeyListResponse"];
+                    };
+                };
+                /** @description Invalid API-key request */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Insufficient entitlement (plan or role) */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description API key not found for the authenticated user */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description API key storage is unavailable */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        /** Create an API key for the authenticated user */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
                     "application/json": {
                         name: string;
                         scopes?: ("catalog:read" | "inventory:read" | "roast:read" | "sales:read" | "tasting:read" | "portfolio:read" | "inventory:write" | "roast:write" | "sales:write" | "tasting:write" | "portfolio:write")[];
@@ -5682,7 +5862,7 @@ interface components {
             /** Format: uuid */
             operationId: string;
             /** @enum {string} */
-            status: "fencing_checkout" | "awaiting_provider_finalization" | "ready" | "processing" | "retryable" | "completed";
+            status: "accepted" | "provider_deleting" | "local_cleaning" | "auth_deleting" | "post_auth_cleanup" | "retryable" | "conflict" | "completed";
         };
         ErrorResponse: {
             error: {
@@ -5690,12 +5870,23 @@ interface components {
                 message: string;
             };
         };
-        CheckoutAdmission: {
+        BillingCheckoutSession: {
             /** Format: uuid */
             admissionId: string;
             /** @enum {string} */
-            status: "creating" | "published" | "closed";
-            stripeSessionId: string | null;
+            status: "accepted" | "attempting" | "published" | "settled" | "closed" | "conflict";
+            clientSecret: string | null;
+        };
+        BillingSubscriptionOperation: {
+            /** Format: uuid */
+            operationId: string;
+            /** Format: uuid */
+            cutoverId: string;
+            subscriptionId: string;
+            cancelAtPeriodEnd: boolean;
+            /** @enum {string} */
+            status: "accepted" | "attempting" | "succeeded" | "superseded" | "conflict";
+            reason: string | null;
         };
         ApiKeyRecord: {
             /** Format: uuid */
@@ -7295,7 +7486,9 @@ interface components {
             id: number;
             rank: number | null;
             notes: string | null;
-            cupping_notes: string | null;
+            cupping_notes: string | number | boolean | unknown[] | {
+                [key: string]: unknown;
+            } | null;
             purchase_date: string | null;
             purchased_qty_lbs: number | null;
             bean_cost: number | null;
@@ -7471,6 +7664,14 @@ interface components {
             /** @description Tax and shipping cost. */
             taxShip?: number;
             notes?: string;
+            /** @description Owner-assigned integer ranking for this inventory lot (PostgreSQL integer range). */
+            rank?: number | null;
+            /** @description Explicit stock-state override. When omitted, stock is derived from purchased quantity. */
+            stocked?: boolean;
+            /** @description Owner cupping data stored as JSON. */
+            cuppingNotes?: string | number | boolean | unknown[] | {
+                [key: string]: unknown;
+            } | null;
             /** @description Existing coffee_catalog.id this inventory lot is bought from. */
             catalogId: number;
             /** @enum {string} */
@@ -7493,10 +7694,16 @@ interface components {
         InventoryCreateRequest: components["schemas"]["CatalogInventoryCreateRequest"] | components["schemas"]["ManualInventoryCreateRequest"];
         InventoryUpdateRequest: {
             qty?: number;
-            cost?: number;
-            taxShip?: number;
-            notes?: string;
+            purchaseDate?: string;
+            cost?: number | null;
+            taxShip?: number | null;
+            notes?: string | null;
             stocked?: boolean;
+            /** @description Owner-assigned integer ranking for this inventory lot (PostgreSQL integer range). */
+            rank?: number | null;
+            cuppingNotes?: string | number | boolean | unknown[] | {
+                [key: string]: unknown;
+            } | null;
         };
         InventoryDeleteResponse: {
             data: {
@@ -8328,14 +8535,18 @@ type OwnerApiUsage = components["schemas"]["OwnerApiUsageResponse"];
 type MarketReadPreferenceRequest = NonNullable<paths["/v1/email-subscriptions/market-read"]["put"]["requestBody"]>["content"]["application/json"];
 /** Durable state returned by an account-deletion request. */
 type AccountDeletionOperation = components["schemas"]["AccountDeletionOperation"];
-/** Idempotency input for acquiring a durable Stripe Checkout admission. */
-type CheckoutAdmissionAcquireRequest = NonNullable<paths["/v1/checkout-admissions"]["post"]["requestBody"]>["content"]["application/json"];
-/** Stripe publication input for an acquired Checkout admission. */
-type CheckoutAdmissionPublishRequest = NonNullable<paths["/v1/checkout-admissions/{admissionId}/publish"]["post"]["requestBody"]>["content"]["application/json"];
-/** Trusted provider header required when publishing a Checkout admission. */
-type CheckoutAdmissionPublishHeaders = NonNullable<paths["/v1/checkout-admissions/{admissionId}/publish"]["post"]["parameters"]["header"]>;
-/** Durable state returned by Checkout admission mutations. */
-type CheckoutAdmission = components["schemas"]["CheckoutAdmission"];
+/** Purpose-bound recent-reauthentication assertion for account deletion. */
+type AccountDeletionRequest = NonNullable<paths["/v1/account-deletion"]["post"]["requestBody"]>["content"]["application/json"];
+/** Purchase-key request for dormant direct Parchment Checkout creation/replay. */
+type BillingCheckoutCreateRequest = NonNullable<paths["/v1/billing/checkout-sessions"]["post"]["requestBody"]>["content"]["application/json"];
+/** Durable Checkout admission state; provider Session id stays server-side. */
+type BillingCheckoutSession = components["schemas"]["BillingCheckoutSession"];
+/** Durable cancellation/resume request. */
+type BillingSubscriptionMutationRequest = NonNullable<paths["/v1/billing/subscriptions/{subscriptionId}"]["patch"]["requestBody"]>["content"]["application/json"];
+/** Durable provider subscription-operation state. */
+type BillingSubscriptionOperation = components["schemas"]["BillingSubscriptionOperation"];
+/** Manual entitlement baseline update for administrators. */
+type BillingManualEntitlementsRequest = NonNullable<paths["/v1/admin/billing-entitlements/{ownerId}/manual"]["patch"]["requestBody"]>["content"]["application/json"];
 type CliAuthRequestCreate = NonNullable<paths["/v1/cli-auth/requests"]["post"]["requestBody"]>["content"]["application/json"];
 type CliAuthInspectRequest = NonNullable<paths["/v1/cli-auth/inspect"]["post"]["requestBody"]>["content"]["application/json"];
 type CliAuthApproveRequest = NonNullable<paths["/v1/cli-auth/approve"]["post"]["requestBody"]>["content"]["application/json"];
@@ -8433,12 +8644,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
             parameters: {
                 query?: never;
                 header?: never;
-                path? /**
-                 * Replace the Artisan import data on one of the caller's existing roasts,
-                 * re-deriving its curve, events, and computed metrics while preserving the
-                 * roast's identity. Pass `ifMatch` (the roast's `last_updated`) to enable
-                 * optimistic concurrency (409 on mismatch).
-                 */: never;
+                path?: never;
                 cookie?: never;
             };
             requestBody?: never;
@@ -8496,12 +8702,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
             parameters: {
                 query?: never;
                 header?: never;
-                path? /**
-                 * Replace the Artisan import data on one of the caller's existing roasts,
-                 * re-deriving its curve, events, and computed metrics while preserving the
-                 * roast's identity. Pass `ifMatch` (the roast's `last_updated`) to enable
-                 * optimistic concurrency (409 on mismatch).
-                 */: never;
+                path?: never;
                 cookie?: never;
             };
             requestBody?: never;
@@ -8902,95 +9103,583 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                403: {
-                    headers: {
-                        [name: string]: unknown;
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }> | undefined, `${string}/${string}`>>;
+        /** Idempotently set the authenticated session user's Market Read preference. */
+        setMarketRead: (body: MarketReadPreferenceRequest) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["MarketReadPreferenceInput"];
+                };
+            };
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["EmailSubscriptionResponse"];
+                    };
+                };
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            body: {
+                subscribed: true;
+                consentSource: "account_settings" | "signup";
+            } | {
+                subscribed: false;
+            };
+        }, `${string}/${string}`>>;
+    };
+    accountDeletion: {
+        /** Accept or replay deletion using a purpose-bound reauthentication assertion. */
+        request: (body: AccountDeletionRequest) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        assertion: string;
+                    };
+                };
+            };
+            responses: {
+                200: {
+                    headers: {
+                        "Cache-Control"?: string;
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["AccountDeletionOperation"];
+                    };
+                };
+                202: {
+                    headers: {
+                        "Cache-Control"?: string;
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["AccountDeletionOperation"];
+                    };
+                };
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            body: {
+                assertion: string;
+            };
+        }, `${string}/${string}`>>;
+    };
+    billing: {
+        checkout: {
+            /** Create or replay an embedded Checkout Session after activation. */
+            create: (body: BillingCheckoutCreateRequest) => Promise<openapi_fetch.FetchResponse<{
+                parameters: {
+                    query?: never;
+                    header?: never;
+                    path?: never;
+                    cookie?: never;
+                };
+                requestBody: {
+                    content: {
+                        "application/json": {
+                            requestId: string;
+                            purchaseItems: {
+                                purchaseKey: string;
+                                quantity?: number;
+                            }[];
+                        };
+                    };
+                };
+                responses: {
+                    200: {
+                        headers: {
+                            "Cache-Control"?: string;
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["BillingCheckoutSession"];
+                        };
+                    };
+                    400: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    401: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    409: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    413: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    503: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                };
+            }, {
+                body: {
+                    requestId: string;
+                    purchaseItems: {
+                        purchaseKey: string;
+                        quantity?: number;
+                    }[];
+                };
+            }, `${string}/${string}`>>;
+            /** Read owner-bound durable admission state. */
+            get: (admissionId: string) => Promise<openapi_fetch.FetchResponse<{
+                parameters: {
+                    query?: never;
+                    header?: never;
+                    path: {
+                        admissionId: string;
+                    };
+                    cookie?: never;
+                };
+                requestBody?: never;
+                responses: {
+                    200: {
+                        headers: {
+                            "Cache-Control"?: string;
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["BillingCheckoutSession"];
+                        };
+                    };
+                    401: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    404: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    409: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    503: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                };
+            }, {
+                params: {
+                    path: {
+                        admissionId: string;
+                    };
+                };
+            }, `${string}/${string}`>>;
+            /** Authoritatively reconcile an admission with Stripe. */
+            reconcile: (admissionId: string) => Promise<openapi_fetch.FetchResponse<{
+                parameters: {
+                    query?: never;
+                    header?: never;
+                    path: {
+                        admissionId: string;
+                    };
+                    cookie?: never;
+                };
+                requestBody?: never;
+                responses: {
+                    200: {
+                        headers: {
+                            "Cache-Control"?: string;
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"] /** Liveness and service identity. */["BillingCheckoutSession"];
+                        };
+                    };
+                    401: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    404: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    409: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    503: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                };
+            }, {
+                params: {
+                    path: {
+                        admissionId: string;
+                    };
+                };
+            }, `${string}/${string}`>>;
+        };
+        subscriptions: {
+            /** List canonical owner subscription snapshots. */
+            list: () => Promise<openapi_fetch.FetchResponse<{
+                parameters: {
+                    query?: never;
+                    header?: never;
+                    path?: never;
+                    cookie?: never;
+                };
+                requestBody?: never;
+                responses: {
+                    200: {
+                        headers: {
+                            "Cache-Control"?: string;
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": {
+                                subscriptions: {
+                                    subscriptionId: string;
+                                    status: string;
+                                    cancelAtPeriodEnd: boolean;
+                                    currentPeriodEnd: string | null;
+                                    items: {
+                                        subscriptionItemId: string;
+                                        priceId: string;
+                                        purchaseKey: string;
+                                        productFamily: string;
+                                    }[];
+                                }[];
+                            };
+                        };
+                    };
+                    401: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    409: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                    503: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
+                    };
+                };
+            }, openapi_fetch.FetchOptions<{
+                parameters: {
+                    query?: never;
+                    header?: never;
+                    path?: never;
+                    cookie?: never;
+                };
+                requestBody?: never;
+                responses: {
+                    200: {
+                        headers: {
+                            "Cache-Control"?: string;
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": {
+                                subscriptions: {
+                                    subscriptionId: string;
+                                    status: string;
+                                    cancelAtPeriodEnd: boolean;
+                                    currentPeriodEnd: string | null;
+                                    items: {
+                                        subscriptionItemId: string;
+                                        priceId: string;
+                                        purchaseKey: string;
+                                        productFamily: string;
+                                    }[];
+                                }[];
+                            };
+                        };
                     };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                    401: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
                     };
-                };
-                503: {
-                    headers: {
-                        [name: string]: unknown;
+                    409: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
                     };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                    503: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
                     };
                 };
-            };
-        }> | undefined, `${string}/${string}`>>;
-        /** Idempotently set the authenticated session user's Market Read preference. */
-        setMarketRead: (body: MarketReadPreferenceRequest) => Promise<openapi_fetch.FetchResponse<{
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": components["schemas"]["MarketReadPreferenceInput"];
-                };
-            };
-            responses: {
-                200: {
-                    headers: {
-                        [name: string]: unknown;
+            }> | undefined, `${string}/${string}`>>;
+            /** Durably cancel or resume the complete provider subscription. */
+            mutate: (subscriptionId: string, body: BillingSubscriptionMutationRequest) => Promise<openapi_fetch.FetchResponse<{
+                parameters: {
+                    query?: never;
+                    header?: never;
+                    path: {
+                        subscriptionId: string;
                     };
+                    cookie?: never;
+                };
+                requestBody: {
                     content: {
-                        "application/json": components["schemas"]["EmailSubscriptionResponse"];
+                        "application/json": {
+                            requestId: string;
+                            cancelAtPeriodEnd: boolean;
+                        };
                     };
                 };
-                400: {
-                    headers: {
-                        [name: string]: unknown;
+                responses: {
+                    200: {
+                        headers: {
+                            "Cache-Control"?: string;
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"] /** List the caller's saved sourcing briefs. */["BillingSubscriptionOperation"];
+                        };
                     };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                    202: {
+                        headers: {
+                            "Cache-Control"?: string;
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["BillingSubscriptionOperation"];
+                        };
                     };
-                };
-                401: {
-                    headers: {
-                        [name: string]: unknown;
+                    401: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
                     };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                    404: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
                     };
-                };
-                403: {
-                    headers: {
-                        [name: string]: unknown;
+                    409: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
                     };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                    413: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
                     };
-                };
-                503: {
-                    headers: {
-                        [name: string]: unknown;
+                    503: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["ErrorResponse"];
+                        };
                     };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                };
+            }, {
+                params: {
+                    path: {
+                        subscriptionId: string;
                     };
                 };
-            };
-        }, {
-            body: {
-                subscribed: true;
-                consentSource: "account_settings" | "signup";
-            } | {
-                subscribed: false;
-            };
-        }, `${string}/${string}`>>;
+                body: {
+                    requestId: string;
+                    cancelAtPeriodEnd: boolean;
+                };
+            }, `${string}/${string}`>>;
+        };
     };
-    accountDeletion: {
-        /**
-         * Idempotently request deletion for the authenticated session owner.
-         * Provider finalization is intentionally available only through `raw`
-         * because it also requires a trusted BFF server credential.
-         */
-        request: () => Promise<openapi_fetch.FetchResponse<{
+    billingAdministration: {
+        /** Read bounded canonical-entitlement discrepancies. */
+        discrepancies: () => Promise<openapi_fetch.FetchResponse<{
             parameters: {
                 query?: never;
                 header?: never;
@@ -9005,7 +9694,16 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["AccountDeletionOperation"];
+                        "application/json": {
+                            summary: {
+                                totalDiscrepancies: number;
+                                totalTrackedAccounts: number;
+                                checkedAt: string;
+                            };
+                            discrepancies: {
+                                [key: string]: unknown;
+                            }[];
+                        };
                     };
                 };
                 401: {
@@ -9016,15 +9714,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                409: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                429: {
+                403: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -9056,7 +9746,16 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["AccountDeletionOperation"];
+                        "application/json": {
+                            summary: {
+                                totalDiscrepancies: number;
+                                totalTrackedAccounts: number;
+                                checkedAt: string;
+                            };
+                            discrepancies: {
+                                [key: string]: unknown;
+                            }[];
+                        };
                     };
                 };
                 401: {
@@ -9067,15 +9766,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                409: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                429: {
+                403: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -9093,35 +9784,30 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 };
             };
         }> | undefined, `${string}/${string}`>>;
-    };
-    checkoutAdmissions: {
-        /** Acquire or replay an owner-bound admission before creating Stripe state. */
-        acquire: (body: CheckoutAdmissionAcquireRequest) => Promise<openapi_fetch.FetchResponse<{
+        /** Recompute billing contribution without changing manual grants. */
+        recompute: (ownerId: string) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        requestId: string;
-                    };
+                path: {
+                    ownerId: string;
                 };
+                cookie?: never;
             };
+            requestBody?: never;
             responses: {
                 200: {
                     headers: {
+                        "Cache-Control"?: string;
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": 
-                        /** Query parameters for {@link ParchmentClient.roasts.get}. */
-                        components["schemas"]["CheckoutAdmission"];
+                        "application/json": {
+                            [key: string]: unknown;
+                        };
                     };
                 };
-                400: {
+                401: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -9129,7 +9815,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                401: {
+                403: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -9137,7 +9823,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                409: {
+                404: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -9145,7 +9831,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                429: {
+                409: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -9163,44 +9849,55 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 };
             };
         }, {
-            body: {
-                requestId: string;
+            params: {
+                path: {
+                    ownerId: string;
+                };
             };
         }, `${string}/${string}`>>;
-        /** Publish a provider-verified Stripe Checkout Session for an admission. */
-        publish: (admissionId: string, body: CheckoutAdmissionPublishRequest, headers: CheckoutAdmissionPublishHeaders) => Promise<openapi_fetch.FetchResponse<{
+        /** Update the preserved manual entitlement baseline. */
+        setManual: (ownerId: string, body: BillingManualEntitlementsRequest) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
                 query?: never;
-                header: {
-                    "x-account-deletion-provider-credential": string;
-                };
+                header
+                /**
+                 * Record a sale against one of the caller's own green-coffee inventory
+                 * lots. Requires a session or an owner-bound API key carrying the exact
+                 * `sales:write` scope. Pass `idempotencyKey` to make retries safe: the
+                 * same key replays the original result, and a concurrent duplicate gets
+                 * 409 while the first is in flight.
+                 */
+                ? /**
+                 * Record a sale against one of the caller's own green-coffee inventory
+                 * lots. Requires a session or an owner-bound API key carrying the exact
+                 * `sales:write` scope. Pass `idempotencyKey` to make retries safe: the
+                 * same key replays the original result, and a concurrent duplicate gets
+                 * 409 while the first is in flight.
+                 */: never;
                 path: {
-                    admissionId: string;
+                    ownerId: string;
                 };
                 cookie?: never;
             };
             requestBody: {
                 content: {
                     "application/json": {
-                        stripeSessionId: string;
+                        role: "viewer" | "member" | "admin";
+                        apiPlan: "viewer" | "member" | "enterprise";
+                        ppiAccess: boolean;
                     };
                 };
             };
             responses: {
                 200: {
                     headers: {
+                        "Cache-Control"?: string;
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["CheckoutAdmission"];
-                    };
-                };
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
+                        "application/json": {
+                            [key: string]: unknown;
+                        };
                     };
                 };
                 401: {
@@ -9235,14 +9932,6 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                429: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
                 503: {
                     headers: {
                         [name: string]: unknown;
@@ -9255,14 +9944,13 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
         }, {
             params: {
                 path: {
-                    admissionId: string;
-                };
-                header: {
-                    "x-account-deletion-provider-credential": string;
+                    ownerId: string;
                 };
             };
             body: {
-                stripeSessionId: string;
+                role: "viewer" | "member" | "admin";
+                apiPlan: "viewer" | "member" | "enterprise";
+                ppiAccess: boolean;
             };
         }, `${string}/${string}`>>;
     };
@@ -11376,6 +12064,11 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     cost?: number;
                     taxShip?: number;
                     notes?: string;
+                    rank?: number | null;
+                    stocked?: boolean;
+                    cuppingNotes?: string | number | boolean | unknown[] | {
+                        [key: string]: unknown;
+                    } | null;
                     catalogId: number;
                     manualCoffee?: never;
                 } | {
@@ -11476,6 +12169,11 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     cost?: number;
                     taxShip?: number;
                     notes?: string;
+                    rank?: number | null;
+                    stocked?: boolean;
+                    cuppingNotes?: string | number | boolean | unknown[] | {
+                        [key: string]: unknown;
+                    } | null;
                     catalogId: number;
                     manualCoffee?: never;
                 } | {
@@ -11936,10 +12634,15 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
             };
             body: {
                 qty?: number;
-                cost?: number;
-                taxShip?: number;
-                notes?: string;
+                purchaseDate?: string;
+                cost?: number | null;
+                taxShip?: number | null;
+                notes?: string | null;
                 stocked?: boolean;
+                rank?: number | null;
+                cuppingNotes?: string | number | boolean | unknown[] | {
+                    [key: string]: unknown;
+                } | null;
             };
         }, `${string}/${string}`>>;
         /**
@@ -13489,4 +14192,4 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
 };
 type ParchmentClient = ReturnType<typeof createParchmentClient>;
 
-export { type AccountDeletionOperation, type BriefMatchesQuery, type CatalogItem, type CatalogListQuery, type CatalogProofSummary, type CatalogSimilarQuery, type CheckoutAdmission, type CheckoutAdmissionAcquireRequest, type CheckoutAdmissionPublishRequest, type InventoryCreateRequest, type InventoryUpdateRequest, type MarketSignalsQuery, type MetadataIndexQuery, type OwnerApiUsage, type OwnerApiUsageQuery, type ParchmentClient, type ParchmentClientOptions, type PriceIndexQuery, type PriceIndexStatsQuery, type ProfitItem, type ProfitListQuery, type RoastChartDataQuery, type SalesCreateRequest, type SalesListQuery, type SalesUpdateRequest, type SourcingBriefCreateRequest, type TrackedLotMutation, type TrackedLotSummary, type TrackedLotsListQuery, type components, createParchmentClient, type paths };
+export { type AccountDeletionOperation, type AccountDeletionRequest, type BillingCheckoutCreateRequest, type BillingCheckoutSession, type BillingManualEntitlementsRequest, type BillingSubscriptionMutationRequest, type BillingSubscriptionOperation, type BriefMatchesQuery, type CatalogItem, type CatalogListQuery, type CatalogProofSummary, type CatalogSimilarQuery, type InventoryCreateRequest, type InventoryUpdateRequest, type MarketSignalsQuery, type MetadataIndexQuery, type OwnerApiUsage, type OwnerApiUsageQuery, type ParchmentClient, type ParchmentClientOptions, type PriceIndexQuery, type PriceIndexStatsQuery, type ProfitItem, type ProfitListQuery, type RoastChartDataQuery, type SalesCreateRequest, type SalesListQuery, type SalesUpdateRequest, type SourcingBriefCreateRequest, type TrackedLotMutation, type TrackedLotSummary, type TrackedLotsListQuery, type components, createParchmentClient, type paths };