@purveyors/sdk 0.24.0 → 0.26.0

package/dist/index.d.ts

@@ -115,6 +115,690 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/account-deletion": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        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.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Durable deletion operation */
+                200: {
+                    headers: {
+                        /** @description Sensitive lifecycle responses are never cached */
+                        "Cache-Control"?: string;
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["AccountDeletionOperation"];
+                    };
+                };
+                /** @description A valid Supabase user session is required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Account deletion is blocked by account or billing state */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description The owner mutation throttle was exceeded */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description The lifecycle is disabled or storage is unavailable */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/checkout-admissions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        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.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        requestId: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Durable owner-bound Checkout admission */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CheckoutAdmission"];
+                    };
+                };
+                /** @description Malformed request */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description A valid Supabase user session is required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Checkout is fenced by account deletion */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "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 */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/checkout-admissions/{admissionId}/publish": {
+        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: {
+            parameters: {
+                query?: never;
+                header: {
+                    "x-account-deletion-provider-credential": string;
+                };
+                path: {
+                    admissionId: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        stripeSessionId: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Published Checkout admission */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CheckoutAdmission"];
+                    };
+                };
+                /** @description Malformed request */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description A valid Supabase user session is required */
+                401: {
+                    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"];
+                    };
+                };
+                /** @description Admission not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Checkout is fenced by account deletion */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "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 */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/checkout-admissions/{admissionId}/abandon": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        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.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header: {
+                    "x-account-deletion-provider-credential": string;
+                };
+                path: {
+                    admissionId: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** @enum {string} */
+                        evidence: "stripe_creation_definitively_absent";
+                    };
+                };
+            };
+            responses: {
+                /** @description Closed Checkout admission */
+                200: {
+                    headers: {
+                        [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"];
+                    };
+                };
+                /** @description A valid Supabase user session is required */
+                401: {
+                    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"];
+                    };
+                };
+                /** @description Creating admission not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "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 */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/checkout-admissions/provider-eligibility": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        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.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header: {
+                    "x-account-deletion-provider-credential": string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        ownerId: string;
+                        /** Format: uuid */
+                        admissionId: string;
+                        stripeSessionId: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Provider write eligibility */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            eligible: boolean;
+                        };
+                    };
+                };
+                /** @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"];
+                    };
+                };
+                /** @description Eligibility storage is unavailable */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/checkout-admissions/provider-terminalization": {
+        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: {
+            parameters: {
+                query?: never;
+                header: {
+                    "x-account-deletion-provider-credential": string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        ownerId: string;
+                        /** Format: uuid */
+                        admissionId: string;
+                        stripeSessionId: string;
+                        /** @enum {string} */
+                        terminalStatus: "expired";
+                    };
+                };
+            };
+            responses: {
+                /** @description Closed provider-terminal Checkout admission */
+                200: {
+                    headers: {
+                        [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"];
+                    };
+                };
+                /** @description Published admission not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Account deletion owns Checkout reconciliation */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "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 */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/account-deletion/provider-finalization": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        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: {
+            parameters: {
+                query?: never;
+                header: {
+                    "x-account-deletion-provider-credential": string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        operationId: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Owner-bound operation after provider finalization */
+                200: {
+                    headers: {
+                        /** @description Sensitive lifecycle responses are never cached */
+                        "Cache-Control"?: string;
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["AccountDeletionOperation"];
+                    };
+                };
+                /** @description The operation id is malformed */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description A valid Supabase user session is required */
+                401: {
+                    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"];
+                    };
+                };
+                /** @description The owner-bound deletion operation was not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Account deletion is blocked by dependent account state */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description The owner mutation throttle was exceeded */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description The lifecycle is disabled or storage is unavailable */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/api-keys": {
         parameters: {
             query?: never;
@@ -4284,8 +4968,85 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Classification provider is unavailable or not configured */
-                503: {
+                /** @description Classification provider is unavailable or not configured */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/roasts/{id}/chart-data": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get sampled roast chart data
+         * @description Fetch a chart-ready, adaptively sampled temperature/event curve and metadata for one of the authenticated principal's roast profiles. Requires an authenticated session, or an owner-bound API key carrying the roast:read scope on an uncapped API plan.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    target_points?: number;
+                };
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Sampled chart points and chart metadata */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["RoastChartDataResponse"];
+                    };
+                };
+                /** @description Invalid query parameter */
+                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 No such roast for this principal */
+                404: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -4295,6 +5056,8 @@ interface paths {
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
@@ -4915,6 +5678,25 @@ interface components {
             ppiAccess: boolean;
             apiScopes: string[];
         };
+        AccountDeletionOperation: {
+            /** Format: uuid */
+            operationId: string;
+            /** @enum {string} */
+            status: "fencing_checkout" | "awaiting_provider_finalization" | "ready" | "processing" | "retryable" | "completed";
+        };
+        ErrorResponse: {
+            error: {
+                code: string;
+                message: string;
+            };
+        };
+        CheckoutAdmission: {
+            /** Format: uuid */
+            admissionId: string;
+            /** @enum {string} */
+            status: "creating" | "published" | "closed";
+            stripeSessionId: string | null;
+        };
         ApiKeyRecord: {
             /** Format: uuid */
             id: string;
@@ -4929,12 +5711,6 @@ interface components {
         ApiKeyListResponse: {
             data: components["schemas"]["ApiKeyRecord"][];
         };
-        ErrorResponse: {
-            error: {
-                code: string;
-                message: string;
-            };
-        };
         OwnerApiUsageDailySummary: {
             /** Format: date */
             date: string;
@@ -7152,6 +7928,53 @@ interface components {
                 };
             };
         };
+        RoastChartPoint: {
+            data_type: string;
+            time_milliseconds: number;
+            field_name: string;
+            value_numeric: number;
+            event_string: string;
+            category: string;
+            subcategory: string;
+        };
+        RoastChartMetadata: {
+            total_data_points: number;
+            /** @description Number of temperature rows returned by the sampling RPC; event points are not included. */
+            sampled_data_points: number;
+            roast_duration_minutes: number | null;
+            time_min_ms: number | null;
+            time_max_ms: number | null;
+            temp_min: number | null;
+            temp_max: number | null;
+            ror_min: number | null;
+            ror_max: number | null;
+            charge_time_ms: number | null;
+            target_points: number;
+            /** @description Largest time gap between consecutive sampled temperature rows, or null when fewer than two rows were sampled. */
+            sample_gap_max_ms: number | null;
+        };
+        RoastChartDataResponse: {
+            data: {
+                points: components["schemas"]["RoastChartPoint"][];
+                metadata: components["schemas"]["RoastChartMetadata"];
+            };
+            meta: {
+                /** @enum {string} */
+                resource: "roast-chart-data";
+                /** @enum {string} */
+                namespace: "/v1/roasts";
+                /** @enum {string} */
+                version: "v1";
+                auth: {
+                    /** @enum {string} */
+                    kind: "session" | "api-key";
+                    /** @enum {string|null} */
+                    role: "admin" | "member" | "viewer" | null;
+                    /** @enum {string|null} */
+                    apiPlan: "viewer" | "member" | "enterprise" | null;
+                };
+            };
+        };
         SaleResource: {
             id: number;
             green_coffee_inv_id: number;
@@ -7469,6 +8292,8 @@ type InventoryUpdateRequest = NonNullable<paths["/v1/inventory/{id}"]["patch"]["
 type RoastListQuery = NonNullable<paths["/v1/roasts"]["get"]["parameters"]["query"]>;
 /** Query parameters for {@link ParchmentClient.roasts.get}. */
 type RoastGetQuery = NonNullable<paths["/v1/roasts/{id}"]["get"]["parameters"]["query"]>;
+/** Query parameters for {@link ParchmentClient.roasts.chartData}. */
+type RoastChartDataQuery = NonNullable<paths["/v1/roasts/{id}/chart-data"]["get"]["parameters"]["query"]>;
 /** Request body for {@link ParchmentClient.roasts.classify}. */
 type RoastClassificationRequest = NonNullable<paths["/v1/roasts/classify"]["post"]["requestBody"]>["content"]["application/json"];
 /** Request body for {@link ParchmentClient.roasts.create}. */
@@ -7501,6 +8326,16 @@ type OwnerApiUsageQuery = NonNullable<paths["/v1/api-usage"]["get"]["parameters"
 type OwnerApiUsage = components["schemas"]["OwnerApiUsageResponse"];
 /** Request body for {@link ParchmentClient.emailSubscriptions.setMarketRead}. */
 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"];
 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"];
@@ -7598,7 +8433,12 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: 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;
                 cookie?: never;
             };
             requestBody?: never;
@@ -7656,7 +8496,12 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: 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;
                 cookie?: never;
             };
             requestBody?: never;
@@ -7800,10 +8645,222 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["ApiKeyMutationResponse"];
+                        "application/json": components["schemas"]["ApiKeyMutationResponse"];
+                    };
+                };
+                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"];
+                    };
+                };
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            params: {
+                path: {
+                    id: string;
+                };
+            };
+        }, `${string}/${string}`>>;
+        /** Rotate an API key and return the replacement secret once. */
+        rotate: (id: string) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ApiKeyCreateResponse"];
+                    };
+                };
+                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"];
+                    };
+                };
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            params: {
+                path: {
+                    id: string;
+                };
+            };
+        }, `${string}/${string}`>>;
+    };
+    apiUsage: {
+        /**
+         * Read bounded API-key traffic analytics for the authenticated session
+         * owner. Headline monthly/hourly counts are exact; daily/per-key series
+         * carry explicit truncation metadata.
+         */
+        get: (query?: OwnerApiUsageQuery) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: {
+                    days?: number;
+                    recentPerKey?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["OwnerApiUsageResponse"];
+                    };
+                };
+                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"];
+                    };
+                };
+            };
+        }, {
+            params: {
+                query: {
+                    days?: number;
+                    recentPerKey?: number;
+                } | undefined;
+            };
+        }, `${string}/${string}`>>;
+    };
+    emailSubscriptions: {
+        /** Get the authenticated session user's Market Read preference. */
+        get: () => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["EmailSubscriptionResponse"];
+                    };
+                };
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                400: {
+                403: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -7811,7 +8868,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                401: {
+                503: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -7819,7 +8876,25 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                403: {
+            };
+        }, openapi_fetch.FetchOptions<{
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["EmailSubscriptionResponse"];
+                    };
+                };
+                401: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -7827,7 +8902,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                404: {
+                403: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -7844,34 +8919,27 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     };
                 };
             };
-        }, {
-            params: {
-                path: {
-                    id: string;
-                };
-            };
-        }, `${string}/${string}`>>;
-        /** Rotate an API key and return the replacement secret once. */
-        rotate: (id: string) => Promise<openapi_fetch.FetchResponse<{
+        }> | 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: {
-                    id: string;
-                };
+                path?: never;
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["MarketReadPreferenceInput"];
+                };
+            };
             responses: {
-                201: {
+                200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"] /**
-                         * Catalog filter metadata and counted facets. Pass `headers` to send the
-                         * `Prefer: handling=lenient|strict` override (see {@link CatalogFacetsHeaders}).
-                         */["ApiKeyCreateResponse"];
+                        "application/json": components["schemas"]["EmailSubscriptionResponse"];
                     };
                 };
                 400: {
@@ -7898,14 +8966,6 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
                 503: {
                     headers: {
                         [name: string]: unknown;
@@ -7916,25 +8976,23 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 };
             };
         }, {
-            params: {
-                path: {
-                    id: string;
-                };
+            body: {
+                subscribed: true;
+                consentSource: "account_settings" | "signup";
+            } | {
+                subscribed: false;
             };
         }, `${string}/${string}`>>;
     };
-    apiUsage: {
+    accountDeletion: {
         /**
-         * Read bounded API-key traffic analytics for the authenticated session
-         * owner. Headline monthly/hourly counts are exact; daily/per-key series
-         * carry explicit truncation metadata.
+         * 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.
          */
-        get: (query?: OwnerApiUsageQuery) => Promise<openapi_fetch.FetchResponse<{
+        request: () => Promise<openapi_fetch.FetchResponse<{
             parameters: {
-                query?: {
-                    days?: number;
-                    recentPerKey?: number;
-                };
+                query?: never;
                 header?: never;
                 path?: never;
                 cookie?: never;
@@ -7943,13 +9001,14 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
             responses: {
                 200: {
                     headers: {
+                        "Cache-Control"?: string;
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["OwnerApiUsageResponse"];
+                        "application/json": components["schemas"]["AccountDeletionOperation"];
                     };
                 };
-                400: {
+                401: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -7957,7 +9016,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                401: {
+                409: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -7965,7 +9024,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                403: {
+                429: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -7982,18 +9041,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     };
                 };
             };
-        }, {
-            params: {
-                query: {
-                    days?: number;
-                    recentPerKey?: number;
-                } | undefined;
-            };
-        }, `${string}/${string}`>>;
-    };
-    emailSubscriptions: {
-        /** Get the authenticated session user's Market Read preference. */
-        get: () => Promise<openapi_fetch.FetchResponse<{
+        }, openapi_fetch.FetchOptions<{
             parameters: {
                 query?: never;
                 header?: never;
@@ -8004,10 +9052,11 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
             responses: {
                 200: {
                     headers: {
+                        "Cache-Control"?: string;
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["EmailSubscriptionResponse"];
+                        "application/json": components["schemas"]["AccountDeletionOperation"];
                     };
                 };
                 401: {
@@ -8018,7 +9067,15 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                403: {
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                429: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -8035,21 +9092,41 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     };
                 };
             };
-        }, openapi_fetch.FetchOptions<{
+        }> | undefined, `${string}/${string}`>>;
+    };
+    checkoutAdmissions: {
+        /** Acquire or replay an owner-bound admission before creating Stripe state. */
+        acquire: (body: CheckoutAdmissionAcquireRequest) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
                 query?: never;
                 header?: never;
                 path?: never;
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody: {
+                content: {
+                    "application/json": {
+                        requestId: string;
+                    };
+                };
+            };
             responses: {
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["EmailSubscriptionResponse"];
+                        "application/json": 
+                        /** Query parameters for {@link ParchmentClient.roasts.get}. */
+                        components["schemas"]["CheckoutAdmission"];
+                    };
+                };
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
                 401: {
@@ -8060,7 +9137,15 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                403: {
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                429: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -8077,18 +9162,28 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     };
                 };
             };
-        }> | undefined, `${string}/${string}`>>;
-        /** Idempotently set the authenticated session user's Market Read preference. */
-        setMarketRead: (body: MarketReadPreferenceRequest) => Promise<openapi_fetch.FetchResponse<{
+        }, {
+            body: {
+                requestId: string;
+            };
+        }, `${string}/${string}`>>;
+        /** Publish a provider-verified Stripe Checkout Session for an admission. */
+        publish: (admissionId: string, body: CheckoutAdmissionPublishRequest, headers: CheckoutAdmissionPublishHeaders) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
                 query?: never;
-                header?: never;
-                path?: never;
+                header: {
+                    "x-account-deletion-provider-credential": string;
+                };
+                path: {
+                    admissionId: string;
+                };
                 cookie?: never;
             };
             requestBody: {
                 content: {
-                    "application/json": components["schemas"]["MarketReadPreferenceInput"];
+                    "application/json": {
+                        stripeSessionId: string;
+                    };
                 };
             };
             responses: {
@@ -8097,7 +9192,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["EmailSubscriptionResponse"];
+                        "application/json": components["schemas"]["CheckoutAdmission"];
                     };
                 };
                 400: {
@@ -8113,7 +9208,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"] /** Return the durable terminal result for a manual inventory batch. */["ErrorResponse"];
+                        "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
                 403: {
@@ -8124,6 +9219,30 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         "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"];
+                    };
+                };
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
                 503: {
                     headers: {
                         [name: string]: unknown;
@@ -8134,11 +9253,16 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 };
             };
         }, {
+            params: {
+                path: {
+                    admissionId: string;
+                };
+                header: {
+                    "x-account-deletion-provider-credential": string;
+                };
+            };
             body: {
-                subscribed: true;
-                consentSource: "account_settings" | "signup";
-            } | {
-                subscribed: false;
+                stripeSessionId: string;
             };
         }, `${string}/${string}`>>;
     };
@@ -8203,7 +9327,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"] /** Delete one of the caller's own roast profiles. */["ErrorResponse"];
+                        "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
             };
@@ -8284,7 +9408,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
         approve: (body: CliAuthApproveRequest) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
                 query?: never;
-                header? /** Fetch supplier notes plus the caller's own latest tasting notes. */: never;
+                header?: never;
                 path?: never;
                 cookie?: never;
             };
@@ -11128,6 +12252,71 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 } | undefined;
             };
         }, `${string}/${string}`>>;
+        /** Fetch an owner roast's adaptively sampled chart curve and metadata. */
+        chartData: (id: string, query?: RoastChartDataQuery) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: {
+                    target_points?: number;
+                };
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["RoastChartDataResponse"];
+                    };
+                };
+                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"];
+                    };
+                };
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            params: {
+                path: {
+                    id: string;
+                };
+                query: {
+                    target_points?: number;
+                } | undefined;
+            };
+        }, `${string}/${string}`>>;
         /**
          * Create an owner roast profile, optionally with nested temperature/event
          * rows. Requires a session or an owner-bound API key carrying the exact
@@ -12300,4 +13489,4 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
 };
 type ParchmentClient = ReturnType<typeof createParchmentClient>;
 
-export { 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 SalesCreateRequest, type SalesListQuery, type SalesUpdateRequest, type SourcingBriefCreateRequest, type TrackedLotMutation, type TrackedLotSummary, type TrackedLotsListQuery, type components, createParchmentClient, type paths };
+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 };