@purveyors/sdk 0.28.0 → 0.29.0

package/dist/index.d.ts

@@ -537,6 +537,176 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/webhooks/resend/market-brief": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Receive verified Market Brief provider events
+         * @description Verifies the Resend Svix signature against the untouched raw body, then idempotently settles provider opt-out or suppression state under Parchment authority.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header: {
+                    "svix-id": string;
+                    "svix-timestamp": string;
+                    "svix-signature": string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The authentic delivery was settled or ignored */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @enum {boolean} */
+                            received: true;
+                        };
+                    };
+                };
+                /** @description The signature or provider payload is invalid */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description The provider payload exceeds the bounded body limit */
+                413: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Provider configuration or durable settlement is unavailable */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/market-brief/drafts": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Accept or replay one deployed Market Brief draft
+         * @description Authenticates the dedicated coffee-app machine credential, verifies the exact deployed Market Brief projection, and creates or recovers one unsent provider draft under Parchment authority.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["MarketBriefDraftInput"];
+                };
+            };
+            responses: {
+                /** @description The exact immutable draft already exists */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["MarketBriefDraftResponse"];
+                    };
+                };
+                /** @description Draft creation or ambiguity recovery remains durable */
+                202: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["MarketBriefDraftResponse"];
+                    };
+                };
+                /** @description The submitted deployment or projection is invalid */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description The dedicated machine credential is absent or invalid */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description The deployment, immutable version, or provider draft conflicts with durable state */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description The request body exceeds the bounded projection limit */
+                413: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Draft admission, deployed verification, storage, or provider recovery is unavailable */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/billing/subscriptions": {
         parameters: {
             query?: never;
@@ -1521,6 +1691,67 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/email-subscriptions/market-read/unsubscribe": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Unsubscribe from Market Read without a user session
+         * @description Accepts an opaque account-lifetime capability and idempotently reduces Market Read consent. The response does not reveal whether the capability exists or whether consent changed.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["MarketReadUnsubscribeInput"];
+                };
+            };
+            responses: {
+                /** @description The unsubscribe request was accepted */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["MarketReadUnsubscribeResponse"];
+                    };
+                };
+                /** @description Invalid unsubscribe request */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Email preference 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/cli-auth/requests": {
         parameters: {
             query?: never;
@@ -4169,7 +4400,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/inventory/{id}": {
+    "/v1/inventory/catalog-batches/reservations": {
         parameters: {
             query?: never;
             header?: never;
@@ -4178,29 +4409,30 @@ interface paths {
         };
         get?: never;
         put?: never;
-        post?: never;
         /**
-         * Delete an owner inventory item
-         * @description Delete one of the caller's own inventory rows. Returns 409 if dependent roast profiles or sales exist (no force-cascade). Requires an authenticated session, or an owner-bound API key carrying the exact inventory:write scope.
+         * Reserve a catalog inventory batch
+         * @description Durably accept complete canonical intent for 1–50 existing visible catalog coffees before mutation starts. After acceptance, clients retain only batchId. Requires an authenticated session, or an owner-bound API key carrying the exact inventory:write scope.
          */
-        delete: {
+        post: {
             parameters: {
                 query?: never;
                 header?: never;
-                path: {
-                    id: number;
-                };
+                path?: never;
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["CatalogInventoryBatchReserveRequest"];
+                };
+            };
             responses: {
-                /** @description The inventory row was deleted */
-                200: {
+                /** @description The durable accepted lifecycle */
+                201: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["InventoryDeleteResponse"];
+                        "application/json": components["schemas"]["CatalogInventoryBatchLifecycleResponse"];
                     };
                 };
                 /** @description Invalid query parameter */
@@ -4230,16 +4462,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description No such inventory item owned by the caller */
-                404: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ErrorResponse"];
-                    };
-                };
-                /** @description Write conflict: dependent roast/sales rows exist, or an If-Match precondition failed */
+                /** @description The batch UUID is already reserved for different canonical catalog inventory intent */
                 409: {
                     headers: {
                         [name: string]: unknown;
@@ -4257,7 +4480,7 @@ interface paths {
                         "application/json": components["schemas"]["ErrorResponse"];
                     };
                 };
-                /** @description Inventory writes are not enabled in this environment */
+                /** @description Catalog inventory batch writes are disabled or lifecycle storage is temporarily unavailable */
                 503: {
                     headers: {
                         [name: string]: unknown;
@@ -4268,24 +4491,301 @@ interface paths {
                 };
             };
         };
+        delete?: never;
         options?: never;
         head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inventory/catalog-batches/{batchId}/commit": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
         /**
-         * Update an owner inventory item
-         * @description Update fields on one of the caller's own inventory rows. Optional `If-Match: <last_updated>` enables optimistic concurrency (409 on mismatch). Requires an authenticated session, or an owner-bound API key carrying the exact inventory:write scope.
+         * Commit a reserved catalog inventory batch
+         * @description Claim and atomically commit the server-owned request for a reserved batch UUID. Concurrent commits serialize through the durable lifecycle; callers may safely retry with no request body.
          */
-        patch: {
+        post: {
             parameters: {
                 query?: never;
-                header?: {
-                    "if-match"?: string;
-                };
+                header?: never;
                 path: {
-                    id: number;
+                    batchId: string;
                 };
                 cookie?: never;
             };
-            requestBody?: {
+            requestBody?: never;
+            responses: {
+                /** @description The current identity-only lifecycle, including completion or terminal rejection */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogInventoryBatchLifecycleResponse"];
+                    };
+                };
+                /** @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 reserved catalog inventory batch exists for this owner and batch UUID */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Per-user mutation throttle exceeded; retry after a short wait */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Catalog inventory batch writes are disabled or lifecycle storage is temporarily unavailable */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inventory/catalog-batches/{batchId}/status": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get catalog inventory batch lifecycle
+         * @description Return unknown, accepted, in_progress, completed, or terminal_rejected for owner-scoped durable intent. Missing and cross-tenant UUIDs are the same nonterminal unknown state.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    batchId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The identity-only catalog inventory batch lifecycle */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogInventoryBatchLifecycleResponse"];
+                    };
+                };
+                /** @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 Catalog inventory batch writes are disabled or lifecycle storage is temporarily unavailable */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/inventory/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete an owner inventory item
+         * @description Delete one of the caller's own inventory rows. Returns 409 if dependent roast profiles or sales exist (no force-cascade). Requires an authenticated session, or an owner-bound API key carrying the exact inventory:write scope.
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: number;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description The inventory row was deleted */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["InventoryDeleteResponse"];
+                    };
+                };
+                /** @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 inventory item owned by the caller */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Write conflict: dependent roast/sales rows exist, or an If-Match precondition failed */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Per-user mutation throttle exceeded; retry after a short wait */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Inventory writes are not enabled in this environment */
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        options?: never;
+        head?: never;
+        /**
+         * Update an owner inventory item
+         * @description Update fields on one of the caller's own inventory rows. Optional `If-Match: <last_updated>` enables optimistic concurrency (409 on mismatch). Requires an authenticated session, or an owner-bound API key carrying the exact inventory:write scope.
+         */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: {
+                    "if-match"?: string;
+                };
+                path: {
+                    id: number;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
                 content: {
                     "application/json": components["schemas"]["InventoryUpdateRequest"];
                 };
@@ -5877,6 +6377,34 @@ interface components {
             status: "accepted" | "attempting" | "published" | "settled" | "closed" | "conflict";
             clientSecret: string | null;
         };
+        MarketBriefDraftState: {
+            /** Format: uuid */
+            draftId: string;
+            edition: number;
+            productionCommit: string;
+            /** @enum {string} */
+            status: "creating" | "uncertain" | "created" | "conflict";
+        };
+        MarketBriefDraftResponse: {
+            data: components["schemas"]["MarketBriefDraftState"];
+        };
+        MarketBriefDraftInput: {
+            /** @enum {number} */
+            schemaVersion: 1;
+            /** @enum {string} */
+            publication: "market-brief";
+            edition: number;
+            slug: string;
+            /** Format: uri */
+            canonicalUrl: string;
+            productionCommit: string;
+            /** @enum {string} */
+            rendererVersion: "market-brief-email-v1";
+            projectionSha256: string;
+            subject: string;
+            html: string;
+            text: string;
+        };
         BillingSubscriptionOperation: {
             /** Format: uuid */
             operationId: string;
@@ -6024,6 +6552,16 @@ interface components {
             /** @enum {boolean} */
             subscribed: false;
         };
+        MarketReadUnsubscribeResponse: {
+            data: {
+                /** @enum {boolean} */
+                accepted: true;
+            };
+        };
+        MarketReadUnsubscribeInput: {
+            /** Format: uuid */
+            capability: string;
+        };
         CatalogAccessResponse: {
             visibility: {
                 isPrivilegedSession: boolean;
@@ -7635,6 +8173,82 @@ interface components {
             notes?: string;
             items: components["schemas"]["ManualInventoryBatchItem"][];
         };
+        CatalogInventoryBatchResult: {
+            /** Format: uuid */
+            batchId: string;
+            items: {
+                /** Format: uuid */
+                rowId: string;
+                inventoryId: number;
+            }[];
+        };
+        CatalogInventoryBatchTerminalError: {
+            code: string;
+            message: string;
+        };
+        CatalogInventoryBatchLifecycle: {
+            /** Format: uuid */
+            batchId: string;
+            /** @enum {string} */
+            status: "unknown" | "accepted" | "in_progress" | "completed" | "terminal_rejected";
+            result: components["schemas"]["CatalogInventoryBatchResult"] | null;
+            error: components["schemas"]["CatalogInventoryBatchTerminalError"] | null;
+            /** Format: date-time */
+            updatedAt: string | null;
+        };
+        CatalogInventoryBatchLifecycleResponse: {
+            data: components["schemas"]["CatalogInventoryBatchLifecycle"];
+            meta: {
+                /** @enum {string} */
+                resource: "inventory-catalog-batch-lifecycle";
+                /** @enum {string} */
+                namespace: "/v1/inventory/catalog-batches";
+                /** @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;
+                };
+            };
+        };
+        CatalogInventoryBatchItem: {
+            /**
+             * Format: uuid
+             * @description Stable client-generated row identity returned unchanged with the created inventory id.
+             */
+            rowId: string;
+            /** @description Visible coffee_catalog.id to add to owner inventory. */
+            catalogId: number;
+            /** @description Purchased quantity in pounds. */
+            qty: number;
+            /** @description Total bean cost for this inventory lot. */
+            cost?: number;
+            /** @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;
+        };
+        CatalogInventoryBatchReserveRequest: {
+            /**
+             * Format: uuid
+             * @description Stable client-generated batch identity. Persist only this UUID after reservation succeeds.
+             */
+            batchId: string;
+            /** @description Purchase date (YYYY-MM-DD); defaults to today (UTC). */
+            purchaseDate?: string;
+            /** @description Shared tax and shipping total. Parchment normalizes exact cents before reservation and allocates them by input order. */
+            taxShipTotal?: number;
+            notes?: string;
+            items: components["schemas"]["CatalogInventoryBatchItem"][];
+        };
         InventoryItemResponse: {
             data: components["schemas"]["InventoryResource"];
             meta: {
@@ -8416,9 +9030,10 @@ interface ParchmentClientOptions {
     /** Base URL of the Parchment API, e.g. https://api.purveyors.io */
     baseUrl: string;
     /**
-     * Optional bearer token (a Supabase JWT or, later, an API key). Sent as
-     * `Authorization: Bearer <token>`. Auth is resolved server-side against the
-     * unified principal model; the SDK only forwards the credential.
+     * Optional bearer token (a Supabase JWT, API key, or dedicated machine
+     * credential). Sent as
+     * `Authorization: Bearer <token>`. Auth is resolved server-side at the route
+     * boundary; the SDK only forwards the credential.
      */
     token?: string;
     /** Override the fetch implementation (useful for tests or custom runtimes). */
@@ -8493,6 +9108,12 @@ type ManualInventoryCreateRequest = components["schemas"]["ManualInventoryCreate
 type ManualInventoryBatchCreateRequest = NonNullable<paths["/v1/inventory/manual-batches"]["post"]["requestBody"]>["content"]["application/json"];
 /** Request body for reserving durable server-owned manual-batch intent. */
 type ManualInventoryBatchReserveRequest = NonNullable<paths["/v1/inventory/manual-batches/reservations"]["post"]["requestBody"]>["content"]["application/json"];
+/** Complete canonical intent accepted by the catalog-batch reservation lane. */
+type CatalogInventoryBatchReserveRequest = NonNullable<paths["/v1/inventory/catalog-batches/reservations"]["post"]["requestBody"]>["content"]["application/json"];
+/** Durable catalog-batch state returned by reserve, commit, and status. */
+type CatalogInventoryBatchLifecycle = components["schemas"]["CatalogInventoryBatchLifecycle"];
+/** Identity-only terminal result; catalog resources remain a separate read. */
+type CatalogInventoryBatchResult = components["schemas"]["CatalogInventoryBatchResult"];
 /** Request body for {@link ParchmentClient.inventory.update}. */
 type InventoryUpdateRequest = NonNullable<paths["/v1/inventory/{id}"]["patch"]["requestBody"]>["content"]["application/json"];
 /** Query parameters for {@link ParchmentClient.roasts.list}. */
@@ -8533,6 +9154,10 @@ 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"];
+/** Request body for {@link ParchmentClient.emailSubscriptions.unsubscribeMarketRead}. */
+type MarketReadUnsubscribeRequest = NonNullable<paths["/v1/email-subscriptions/market-read/unsubscribe"]["post"]["requestBody"]>["content"]["application/json"];
+/** Immutable deployed projection accepted by {@link ParchmentClient.marketBrief.drafts.create}. */
+type MarketBriefDraftCreateRequest = NonNullable<paths["/v1/market-brief/drafts"]["post"]["requestBody"]>["content"]["application/json"];
 /** Durable state returned by an account-deletion request. */
 type AccountDeletionOperation = components["schemas"]["AccountDeletionOperation"];
 /** Purpose-bound recent-reauthentication assertion for account deletion. */
@@ -9163,27 +9788,161 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                     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"];
+                    };
+                };
+            };
+        }, {
+            body: {
+                subscribed: true;
+                consentSource: "account_settings" | "signup";
+            } | {
+                subscribed: false;
+            };
+        }, `${string}/${string}`>>;
+        /** Idempotently unsubscribe using an opaque capability without requiring a session. */
+        unsubscribeMarketRead: (body: MarketReadUnsubscribeRequest) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": components["schemas"]["MarketReadUnsubscribeInput"];
+                };
+            };
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["MarketReadUnsubscribeResponse"];
+                    };
+                };
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            body: {
+                capability: string;
+            };
+        }, `${string}/${string}`>>;
+    };
+    marketBrief: {
+        drafts: {
+            /** Accept, create, or recover one immutable deployed edition version. */
+            create: (body: MarketBriefDraftCreateRequest) => Promise<openapi_fetch.FetchResponse<{
+                parameters: {
+                    query?: never;
+                    header?: never;
+                    path?: never;
+                    cookie?: never;
+                };
+                requestBody: {
+                    content: {
+                        "application/json": components["schemas"]["MarketBriefDraftInput"];
+                    };
+                };
+                responses: {
+                    200: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["MarketBriefDraftResponse"];
+                        };
+                    };
+                    202: {
+                        headers: {
+                            [name: string]: unknown;
+                        };
+                        content: {
+                            "application/json": components["schemas"]["MarketBriefDraftResponse"];
+                        };
+                    };
+                    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"];
+                        };
                     };
-                };
-                503: {
-                    headers: {
-                        [name: string]: unknown;
+                    413: {
+                        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"];
+                        };
                     };
                 };
-            };
-        }, {
-            body: {
-                subscribed: true;
-                consentSource: "account_settings" | "signup";
-            } | {
-                subscribed: false;
-            };
-        }, `${string}/${string}`>>;
+            }, {
+                body: {
+                    schemaVersion: 1;
+                    publication: "market-brief";
+                    edition: number;
+                    slug: string;
+                    canonicalUrl: string;
+                    productionCommit: string;
+                    rendererVersion: "market-brief-email-v1";
+                    projectionSha256: string;
+                    subject: string;
+                    html: string;
+                    text: string;
+                };
+            }, `${string}/${string}`>>;
+        };
     };
     accountDeletion: {
         /** Accept or replay deletion using a purpose-bound reauthentication assertion. */
@@ -9427,7 +10186,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                             [name: string]: unknown;
                         };
                         content: {
-                            "application/json": components["schemas"] /** Liveness and service identity. */["BillingCheckoutSession"];
+                            "application/json": components["schemas"]["BillingCheckoutSession"];
                         };
                     };
                     401: {
@@ -9611,7 +10370,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                             [name: string]: unknown;
                         };
                         content: {
-                            "application/json": components["schemas"] /** List the caller's saved sourcing briefs. */["BillingSubscriptionOperation"];
+                            "application/json": components["schemas"]["BillingSubscriptionOperation"];
                         };
                     };
                     202: {
@@ -9859,21 +10618,7 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
         setManual: (ownerId: string, body: BillingManualEntitlementsRequest) => Promise<openapi_fetch.FetchResponse<{
             parameters: {
                 query?: never;
-                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;
+                header?: never;
                 path: {
                     ownerId: string;
                 };
@@ -12535,6 +13280,222 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
                 };
             };
         }, `${string}/${string}`>>;
+        /** Durably reserve canonical catalog-backed inventory intent. */
+        reserveCatalogBatch: (body: CatalogInventoryBatchReserveRequest) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["CatalogInventoryBatchReserveRequest"];
+                };
+            };
+            responses: {
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogInventoryBatchLifecycleResponse"];
+                    };
+                };
+                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"];
+                    };
+                };
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            body: {
+                batchId: string;
+                purchaseDate?: string;
+                taxShipTotal?: number;
+                notes?: string;
+                items: components["schemas"]["CatalogInventoryBatchItem"][];
+            };
+        }, `${string}/${string}`>>;
+        /** Atomically commit a reserved catalog batch by UUID, with no body. */
+        commitCatalogBatch: (batchId: string) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    batchId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogInventoryBatchLifecycleResponse"];
+                    };
+                };
+                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"];
+                    };
+                };
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                503: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        }, {
+            params: {
+                path: {
+                    batchId: string;
+                };
+            };
+        }, `${string}/${string}`>>;
+        /** Recover the owner-scoped lifecycle; missing batches remain unknown. */
+        getCatalogBatchStatus: (batchId: string) => Promise<openapi_fetch.FetchResponse<{
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    batchId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["CatalogInventoryBatchLifecycleResponse"];
+                    };
+                };
+                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: {
+                path: {
+                    batchId: string;
+                };
+            };
+        }, `${string}/${string}`>>;
         /**
          * Update one of the caller's own inventory rows. Pass `ifMatch` (the
          * row's `last_updated`) to enable optimistic concurrency (409 on mismatch).
@@ -14192,4 +15153,4 @@ declare function createParchmentClient(options: ParchmentClientOptions): {
 };
 type ParchmentClient = ReturnType<typeof createParchmentClient>;
 
-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 };
+export { type AccountDeletionOperation, type AccountDeletionRequest, type BillingCheckoutCreateRequest, type BillingCheckoutSession, type BillingManualEntitlementsRequest, type BillingSubscriptionMutationRequest, type BillingSubscriptionOperation, type BriefMatchesQuery, type CatalogInventoryBatchLifecycle, type CatalogInventoryBatchReserveRequest, type CatalogInventoryBatchResult, 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 };