@isnap/sdk 1.3.0-next.97 → 1.3.0-next.98

package/dist/generated/openapi.d.ts

@@ -387,7 +387,7 @@ export interface paths {
         };
         /**
          * List available lines (public marketplace)
-         * @description Browse the marketplace inventory of unassigned lines. Filter by billing tier, area code, country code, status. Returns only `status: available` and never the iSnap-internal `shared_pool` tier. Unauthenticated — partners use this in prospecting / quote flows.
+         * @description Browse the marketplace inventory of unassigned lines. Filter by billing tier, area code, country code, state, country. Returns only `status: available` and never the iSnap-internal `shared_pool` tier — `?status=` therefore accepts `available` alone and refuses any other status with a 400, rather than answering with a list you did not ask for (WHA-2777). Unauthenticated — partners use this in prospecting / quote flows.
          */
         get: {
             parameters: {
@@ -399,6 +399,7 @@ export interface paths {
                     state?: string;
                     /** @description Country filter — ISO alpha-2 code or country name. */
                     country?: string;
+                    /** @description Comma-separated set of statuses to filter on. Every member must be one of: available — anything else is a 400, never an empty list. Omitted or blank means no status filter. */
                     status?: string;
                     page?: number;
                     limit?: number;
@@ -1059,7 +1060,7 @@ export interface paths {
         put?: never;
         /**
          * Activate a reserved line
-         * @description Commit a `reserved` line to `active`. Wholesale partners (no Stripe checkout surface) use this as the second phase of reserve→activate — they reserve, bill their own end-user, then activate within the 15-minute window with no per-line Stripe sub (EOM-metered), and may pick the inbound-only rental variant via `inbound_only`. Direct callers get the test/dev mock-sub shortcut (production direct activation happens via the Stripe webhook on `checkout.session.completed`); `inbound_only` is ignored for them (theirs comes from the checkout price).
+         * @description Commit a `reserved` line to `active`. **Wholesale partners only** (no Stripe checkout surface): this is the second phase of reserve→activate — they reserve, bill their own end-user, then activate within the 15-minute window with no per-line Stripe sub (EOM-metered), and may pick the INBOUND product via `inbound_only` (a line that cannot initiate — the contact must message first, after which the exchange is unrestricted; not receive-only). Direct customers get `402 checkout_required`: their line is activated by the `checkout.session.completed` webhook once `POST /v1/billing/checkout` is paid, which is what mints the Stripe subscription that bills them (§2.5 Flow A). `inbound_only` is meaningless for them — theirs comes from the checkout price.
          */
         post: {
             parameters: {
@@ -1109,6 +1110,15 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorEnvelope"];
                     };
                 };
+                /** @description Payment required — no billing relationship entitles this call */
+                402: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
                 /** @description Forbidden — caller authenticated but not allowed */
                 403: {
                     headers: {
@@ -1287,7 +1297,7 @@ export interface paths {
         put?: never;
         /**
          * Convert an owned rental line into a test line
-         * @description Flip a rental line you own into an owned test line that backs trials in your own pool (ownership → pool; the monthly price stays the rental-equivalent, not the $0 global-pool rate). Rejected on byod lines, lines you do not own, and lines carrying an active subscription.
+         * @description Flip a rental line you own into an owned test line that backs trials in your own pool (ownership → pool; test lines are free, so the deprecated monthly_price reads 0). Rejected on byod lines, lines you do not own, and lines carrying an active subscription.
          */
         post: {
             parameters: {
@@ -1397,7 +1407,7 @@ export interface paths {
         put?: never;
         /**
          * Revert an owned test line back to a rental line
-         * @description Symmetric to convert-to-test: flip an owned test line back to a rental line (ownership → rental, rental price re-stamped). Rejected while the test line still hosts live trials, since reverting would strand them.
+         * @description Symmetric to convert-to-test: flip an owned test line back to a rental line (ownership → rental; monthly_price reads the rental tier price again, derived — nothing is stored). Rejected while the test line still hosts live trials, since reverting would strand them.
          */
         post: {
             parameters: {
@@ -2073,12 +2083,12 @@ export interface paths {
         };
         /**
          * List pre-orders
-         * @description Cursor-paginated list of the caller's pre-orders. Filter by status (`pending`, `provisioning`, `ready`, `fulfilled`, `cancelled`, `refunded`) to surface only the ones the dashboard needs.
+         * @description Cursor-paginated list of the caller's pre-orders. Filter by status (`draft`, `provisioning`, `fulfilled`, `cancelled`) to surface only the ones the dashboard needs.
          */
         get: {
             parameters: {
                 query?: {
-                    status?: "draft" | "pending" | "provisioning" | "ready" | "fulfilled" | "cancelled" | "refunded";
+                    status?: "draft" | "provisioning" | "fulfilled" | "cancelled";
                     cursor?: string;
                     limit?: number;
                 };
@@ -2138,7 +2148,7 @@ export interface paths {
         put?: never;
         /**
          * Create a pre-order (draft)
-         * @description Place a pre-order as a `draft` (WHA-1155). A draft has NO side effects — no provisioning line, no procurement, no Stripe charge — so the partner can hold intent / bill its own end-user first. Call `POST /v1/pre-orders/{id}/confirm` to engage the month and start procurement. `inbound_only` is remembered for confirm.
+         * @description Place a pre-order as a `draft` (WHA-1155). A draft has NO side effects — no provisioning line, no procurement, no Stripe charge — so the partner can hold intent / bill its own end-user first. Call `POST /v1/pre-orders/{id}/confirm` to engage the month and start procurement. A pre-order carries exactly two inputs: the area codes you would accept, in order of preference, and the plan (`inbound_only`), which is remembered for confirm and read back on every response. The body is STRICT (WHA-2644) — any other property is a `400`, including `billing_tier`, `quantity` and `metadata`, which earlier revisions of this contract documented and the server silently discarded.
          */
         post: {
             parameters: {
@@ -2150,8 +2160,6 @@ export interface paths {
             requestBody?: {
                 content: {
                     "application/json": {
-                        /** @enum {string} */
-                        billing_tier: "rental_iphone" | "rental_android";
                         /** @default [] */
                         preferred_area_codes?: string[];
                         /** @default false */
@@ -2527,9 +2535,15 @@ export interface paths {
             requestBody?: {
                 content: {
                     "application/json": {
-                        /** Format: uuid */
+                        /**
+                         * @description Line to check out. Send the `line_<base62>` public ID returned by `POST /v1/lines/{id}/reserve`; the internal UUID is also accepted for backward compatibility. Must be status `reserved`.
+                         * @example line_2k9Qp7RtY4mNb8VcXs3Wd6Lf1
+                         */
                         line_id: string;
-                        /** @default false */
+                        /**
+                         * @description Buy the INBOUND rental product instead of the outbound one. An inbound line cannot INITIATE a conversation — the contact must message first, after which the exchange is unrestricted; it is NOT receive-only. Rental tiers only. The chosen Stripe price is the source of truth: `lines.inbound_only` is re-derived from its lookup_key on `customer.subscription.created/updated`.
+                         * @default false
+                         */
                         inbound_only?: boolean;
                     };
                 };
@@ -2676,33 +2690,39 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/billing/subscriptions": {
+    "/v1/billing/mac-checkout": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: never;
         /**
-         * List Stripe subscriptions
-         * @description Return every active Stripe subscription on the authenticated user's customer record — both per-line rental subs and BYOD slot subs. Period boundaries, line link, price ID, and cancellation flag are surfaced verbatim from Stripe.
+         * Start a Stripe Checkout for hosted macOS sessions
+         * @description Create a Stripe Checkout Session for `quantity` rented macOS sessions, priced on a graduated ladder ($35/$30/$25/$20 per session across the 1–10 / 11–30 / 31–50 / 51+ bands). Two rules are enforced here and nowhere else: the quantity must be a whole number of packs at or above the one-pack minimum (`422 mac_quantity_not_a_pack`, the divisor echoed as `issues[0].min`), and a rented session hosts the bridge for one BYOP iPhone so sessions may not exceed the account’s BYOP lines (`422 mac_sessions_exceed_byop_lines`). Stripe’s hosted UI cannot change the quantity afterwards — use `PATCH /v1/billing/subscriptions/{id}`, which applies the same two rules.
          */
-        get: {
+        post: {
             parameters: {
                 query?: never;
                 header?: never;
                 path?: never;
                 cookie?: never;
             };
-            requestBody?: never;
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["MacCheckoutBody"];
+                };
+            };
             responses: {
-                /** @description Subscription list */
+                /** @description macOS session checkout */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["SubscriptionListEnvelope"];
+                        "application/json": components["schemas"]["MacCheckoutEnvelope"];
                     };
                 };
                 /** @description Bad request — validation failed */
@@ -2723,6 +2743,24 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorEnvelope"];
                     };
                 };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Unprocessable — domain rule violation */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
                 /** @description Too many requests — rate limit exceeded */
                 429: {
                     headers: {
@@ -2743,41 +2781,44 @@ export interface paths {
                 };
             };
         };
-        put?: never;
-        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/billing/invoices": {
+    "/v1/billing/subscriptions/{id}": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: never;
+        post?: never;
         /**
-         * List Stripe invoices
-         * @description List the authenticated user's Stripe invoices in reverse-chronological order. Each invoice exposes the period boundaries (unix seconds), the integer-cent amounts, the hosted invoice URL, and the PDF link.
+         * Cancel a subscription
+         * @description Schedule the subscription to cancel at the end of the current billing period. The line remains active until the period rolls over; the partner sees the `cancel_at_period_end: true` flag in `GET /v1/billing/subscriptions` until then.
          */
-        get: {
+        delete: {
             parameters: {
                 query?: never;
                 header?: never;
-                path?: never;
+                path: {
+                    id: string;
+                };
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Invoice list */
+                /** @description Subscription cancelled */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["InvoiceListEnvelope"];
+                        "application/json": components["schemas"]["BillingMessage"];
                     };
                 };
                 /** @description Bad request — validation failed */
@@ -2798,6 +2839,24 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorEnvelope"];
                     };
                 };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Conflict — concurrent or terminal state */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
                 /** @description Too many requests — rate limit exceeded */
                 429: {
                     headers: {
@@ -2818,46 +2877,139 @@ export interface paths {
                 };
             };
         };
-        put?: never;
-        post?: never;
-        delete?: never;
         options?: never;
         head?: never;
-        patch?: never;
+        /**
+         * Change a subscription’s quantity
+         * @description Set the quantity on the subscription’s single quantity-adjustable item — hosted macOS sessions, or BYOP slots. Both directions of the 1:1 rule are enforced: raising sessions above the account’s BYOP lines is `422 mac_sessions_exceed_byop_lines`, and lowering BYOP below the macOS sessions already rented is `422 byop_reduction_strands_mac_sessions`. A macOS quantity must additionally be a whole pack (`422 mac_quantity_not_a_pack`). A subscription that does not carry exactly one adjustable item — a per-line rental, or a wholesale master subscription whose quantities are pushed by metering — is refused `409 subscription_not_quantity_adjustable`.
+         */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": components["schemas"]["SubscriptionQuantityBody"];
+                };
+            };
+            responses: {
+                /** @description Quantity updated */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["SubscriptionQuantityEnvelope"];
+                    };
+                };
+                /** @description Bad request — validation failed */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Unauthenticated — missing or invalid bearer token */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Forbidden — caller authenticated but not allowed */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Conflict — concurrent or terminal state */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Unprocessable — domain rule violation */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Too many requests — rate limit exceeded */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+            };
+        };
         trace?: never;
     };
-    "/v1/billing/subscriptions/{id}": {
+    "/v1/billing/subscriptions": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
-        post?: never;
         /**
-         * Cancel a subscription
-         * @description Schedule the subscription to cancel at the end of the current billing period. The line remains active until the period rolls over; the partner sees the `cancel_at_period_end: true` flag in `GET /v1/billing/subscriptions` until then.
+         * List Stripe subscriptions
+         * @description Return every active Stripe subscription on the authenticated user's customer record — both per-line rental subs and BYOD slot subs. Period boundaries, line link, price ID, and cancellation flag are surfaced verbatim from Stripe.
          */
-        delete: {
+        get: {
             parameters: {
                 query?: never;
                 header?: never;
-                path: {
-                    id: string;
-                };
+                path?: never;
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Subscription cancelled */
+                /** @description Subscription list */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["BillingMessage"];
+                        "application/json": components["schemas"]["SubscriptionListEnvelope"];
                     };
                 };
                 /** @description Bad request — validation failed */
@@ -2878,8 +3030,8 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorEnvelope"];
                     };
                 };
-                /** @description Not found */
-                404: {
+                /** @description Too many requests — rate limit exceeded */
+                429: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -2887,8 +3039,65 @@ export interface paths {
                         "application/json": components["schemas"]["ErrorEnvelope"];
                     };
                 };
-                /** @description Conflict — concurrent or terminal state */
-                409: {
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/billing/invoices": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List Stripe invoices
+         * @description List the authenticated user's Stripe invoices in reverse-chronological order. Each invoice exposes the period boundaries (unix seconds), the integer-cent amounts, the hosted invoice URL, and the PDF link.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Invoice list */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["InvoiceListEnvelope"];
+                    };
+                };
+                /** @description Bad request — validation failed */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Unauthenticated — missing or invalid bearer token */
+                401: {
                     headers: {
                         [name: string]: unknown;
                     };
@@ -2916,6 +3125,9 @@ export interface paths {
                 };
             };
         };
+        put?: never;
+        post?: never;
+        delete?: never;
         options?: never;
         head?: never;
         patch?: never;
@@ -3317,6 +3529,7 @@ export interface paths {
                 content: {
                     "application/json": {
                         line_id: string;
+                        /** @description Recipient phone number. E.164 preferred; loose national forms are normalized (US default region). Phone-only in v1 — an email / Apple-ID handle is rejected with 400 even when POST /v1/lookup reports it iMessage-capable. */
                         to: string;
                         body?: string;
                         /**
@@ -5872,6 +6085,72 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/apps": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get the app/bridge download manifest (public)
+         * @description Per-platform installer URL, published version, and availability. Requires no pairing and no auth — use it for setup guides, "add a device" flows, reinstalls, and update prompts. The URLs are the same stable 302-redirect endpoints `POST /v1/byod/pair` returns in `download_urls`, built by one shared builder so they cannot drift. `version` is read from the release feed beside the artifact the redirect resolves to, and is `null` when that feed publishes nothing — never a configured placeholder.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Per-platform download URL, version and availability */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["AppManifestEnvelope"];
+                    };
+                };
+                /** @description Bad request — validation failed */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Too many requests — rate limit exceeded */
+                429: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorEnvelope"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -5925,10 +6204,14 @@ export interface components {
             billing_tier: "rental_iphone" | "rental_android" | "byod_imessage" | "byod_android" | "shared_pool" | "shared_imessage";
             /** @description True when the customer owns the underlying hardware (BYOD billing tiers). BYOD lines expose the full line-health surface (offline/degraded events, GET /v1/lines/{id}/health). Rental lines (false) only emit durable, actionable events to keep customers out of transient infrastructure noise they cannot act on. */
             byod: boolean;
-            /** @description True when the line is inbound-only: it may only message a handle that has messaged it first (a recipient who has never contacted the line is rejected with 403 outbound_first_forbidden). Inbound-only is a cheaper rental-tier variant (Bloo parity); always false on BYOD/pool lines. */
+            /** @description True when the line cannot INITIATE a conversation: the contact must send the first message, after which the exchange is unrestricted in both directions. It is NOT receive-only — the line replies, reacts and sends attachments normally once contacted. Messaging a handle that has never contacted the line is rejected with 403 outbound_first_forbidden, per recipient and with no time limit once unlocked. Cheaper than the outbound tier; always false on BYOD/pool lines. */
             inbound_only: boolean;
             capabilities?: unknown;
             status: string;
+            /**
+             * @deprecated
+             * @description Deprecated — derived from the line tier (0 for pool and owned test lines). The price a customer actually pays lives on the Stripe subscription (GET /v1/billing/subscriptions) or the pre-order amount. Removed at the next MAJOR.
+             */
             monthly_price: number;
             stripe_subscription_id: string | null;
             activated_at: string | null;
@@ -5937,15 +6220,12 @@ export interface components {
             metadata: {
                 [key: string]: unknown;
             } | null;
-            /** @description True when the line is an owner-provisioned test line (ownership=pool with a set owner) that backs the owner's own trial pool. Its monthly_price is the rental-equivalent, not the $0 global pool rate. */
+            /** @description True when the line is an owner-provisioned test line (ownership=pool with a set owner) that backs the owner's own trial pool. Test lines are free: monthly_price is 0, like every pool line. */
             test_line: boolean;
             /** @description True when the line is a virtual shared-plan line (billing_tier shared_imessage): customer-owned, no dedicated hardware, phone_number empty — sends are proxied onto the shared physical iMessage fleet. Line-scoped API keys, webhooks and per-line quota apply to it like any other line. */
             shared: boolean;
             fulfillment_status?: string | null;
         };
-        ApiKeyCreate: components["schemas"]["ApiKey"] & {
-            key: string;
-        };
         ApiKey: {
             /** Format: uuid */
             id: string;
@@ -5957,6 +6237,9 @@ export interface components {
             created_at: string;
             last_used_at: string | null;
         };
+        ApiKeyCreate: components["schemas"]["ApiKey"] & {
+            key: string;
+        };
         ApiKeyList: {
             api_keys: components["schemas"]["ApiKey"][];
         };
@@ -6164,20 +6447,17 @@ export interface components {
         PreOrder: {
             /** Format: uuid */
             id: string;
-            /** @enum {string} */
-            billing_tier: "rental_iphone" | "rental_android";
             preferred_area_codes: string[];
+            inbound_only: boolean;
             status: components["schemas"]["PreOrderStatus"];
-            stripe_payment_intent_id: string | null;
             stripe_client_secret: string | null;
-            amount: number;
             estimated_fulfillment: string | null;
             device_status?: components["schemas"]["DeviceFulfillmentStatus"];
             created_at: string;
             updated_at: string;
         };
         /** @enum {string} */
-        PreOrderStatus: "draft" | "pending" | "provisioning" | "ready" | "fulfilled" | "cancelled" | "refunded";
+        PreOrderStatus: "draft" | "provisioning" | "fulfilled" | "cancelled";
         /** @enum {string|null} */
         DeviceFulfillmentStatus: "awaiting_hardware" | "received" | "setup_in_progress" | "ready" | "deployed" | null;
         PreOrderList: {
@@ -6227,6 +6507,66 @@ export interface components {
              */
             billing_cycle: "monthly" | "annual";
         };
+        MacCheckoutEnvelope: {
+            /** @enum {boolean} */
+            success: true;
+            data: components["schemas"]["MacCheckoutResponse"];
+            trace_id: string;
+            request_id: string;
+        };
+        MacCheckoutResponse: {
+            /**
+             * Format: uri
+             * @description Hosted Stripe Checkout URL — redirect the customer here.
+             */
+            checkout_url: string;
+            /**
+             * Format: date-time
+             * @description Session expiry (ISO-8601). Stripe default is 24h.
+             */
+            expires_at: string;
+            /** @description Sessions ordered — echoed back as accepted. */
+            quantity: number;
+            /** @description The pack divisor in force, read from the Stripe Price’s `pack_size` metadata. Quantities must be whole multiples of it, at or above it. */
+            pack_size: number;
+            /** @description Recurring total per period in integer cents, from the Price’s graduated tier ladder. Excludes tax, proration and coupons. */
+            estimated_total_cents: number;
+        };
+        MacCheckoutBody: {
+            /**
+             * @description Number of hosted macOS sessions to rent. Must be a whole number of packs at or above the one-pack minimum — the pack size is read from the Stripe Price and echoed as `pack_size` in the response and in the `422` error `issues[0].min`. A quantity that is not a whole pack is refused `422 mac_quantity_not_a_pack`.
+             * @example 5
+             */
+            quantity: number;
+            /**
+             * @description Stripe price cadence for the session subscription.
+             * @example monthly
+             * @enum {string}
+             */
+            billing_cycle: "monthly" | "quarterly" | "annual";
+        };
+        SubscriptionQuantityEnvelope: {
+            /** @enum {boolean} */
+            success: true;
+            data: components["schemas"]["SubscriptionQuantityResponse"];
+            trace_id: string;
+            request_id: string;
+        };
+        SubscriptionQuantityResponse: {
+            /** @description The Stripe subscription ID (`sub_*`). */
+            subscription_id: string;
+            /** @description The quantity now set on the adjustable item. */
+            quantity: number;
+            /** @description Recurring total per period in integer cents. `null` when the item’s Price carries no computable per-period total. Excludes tax, proration and coupons. */
+            estimated_total_cents: number | null;
+        };
+        SubscriptionQuantityBody: {
+            /**
+             * @description New quantity for the subscription’s single adjustable item — macOS sessions, or BYOP slots. Both products are subject to the 1:1 rule (see the `422` codes), and the macOS product additionally to the pack rule.
+             * @example 10
+             */
+            quantity: number;
+        };
         SubscriptionListEnvelope: {
             /** @enum {boolean} */
             success: true;
@@ -6438,7 +6778,7 @@ export interface components {
          * @description A concrete event type (e.g. `message.received`), a family wildcard (`line.*`), or the catch-all `*`.
          * @enum {string}
          */
-        WebhookEventName: "message.queued" | "message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.received" | "message.scheduled" | "message.cancelled" | "message.fallback_triggered" | "reaction.added" | "reaction.received" | "reaction.removed" | "line.connected" | "line.disconnected" | "line.offline" | "line.degraded" | "line.apple_id_flagged" | "line.quota_warning" | "line.quota_exceeded" | "line.capability_changed" | "typing_indicator.started" | "typing_indicator.stopped" | "trial.linked" | "trial.dormant" | "trial.reactivated" | "trial.bind_conflict" | "trial.revoked" | "binding.released" | "pre_order.fulfilled" | "pre_order.cancelled" | "pre_order.refunded" | "webhook.test" | "*" | "message.*" | "reaction.*" | "line.*" | "typing_indicator.*" | "trial.*" | "binding.*" | "pre_order.*" | "webhook.*";
+        WebhookEventName: "message.queued" | "message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.received" | "message.scheduled" | "message.cancelled" | "message.fallback_triggered" | "reaction.added" | "reaction.received" | "reaction.removed" | "line.connected" | "line.disconnected" | "line.offline" | "line.degraded" | "line.apple_id_flagged" | "line.quota_warning" | "line.quota_exceeded" | "line.capability_changed" | "typing_indicator.started" | "typing_indicator.stopped" | "trial.linked" | "trial.dormant" | "trial.reactivated" | "trial.bind_conflict" | "trial.revoked" | "binding.released" | "pre_order.fulfilled" | "pre_order.cancelled" | "webhook.test" | "*" | "message.*" | "reaction.*" | "line.*" | "typing_indicator.*" | "trial.*" | "binding.*" | "pre_order.*" | "webhook.*";
         WebhookList: {
             webhooks: components["schemas"]["Webhook"][];
         };
@@ -6604,6 +6944,27 @@ export interface components {
             region: string;
             /** @example US */
             country_code: string;
+            /**
+             * @description A ZIP code whose geography this area code serves — the postal address to use at purchase, and the address most likely to have the carrier assign this area code. `null` when no ZIP is on record for this code: choosing the address is then a judgement call for the operator, and this catalogue may not know of an overlay covering the code either, so no regional address can be assumed to yield it.
+             * @example 10019
+             */
+            purchase_zip: string | null;
+            /**
+             * @description Fallback ZIPs in the same geography, to retry with if the carrier rejects the primary. Empty when no ZIP is on record.
+             * @example [
+             *       "10021",
+             *       "10023"
+             *     ]
+             */
+            alt_zips: string[];
+            /**
+             * @description Other area codes IN THIS CATALOGUE that overlay the same geography. Non-empty means NO address can guarantee this specific code — the carrier may assign any code in the complex. An empty list is NOT the converse guarantee: it says only that no code this endpoint can offer is known to overlay this one, and an overlay outside the catalogue may still take the number.
+             * @example [
+             *       "646",
+             *       "917"
+             *     ]
+             */
+            shared_with: string[];
         };
         Country: {
             /** @example US */
@@ -6830,6 +7191,41 @@ export interface components {
                 [key: string]: unknown;
             };
         };
+        AppManifestEnvelope: {
+            /** @enum {boolean} */
+            success: true;
+            data: components["schemas"]["AppManifestResponse"];
+            trace_id: string;
+            request_id: string;
+        };
+        AppManifestResponse: {
+            macos: components["schemas"]["AppDownloadEntry"];
+            android: components["schemas"]["AppDownloadEntry"];
+        };
+        AppDownloadEntry: {
+            /**
+             * Format: uri
+             * @description Absolute URL of the installer redirect for this platform. Follow it (302) to the actual artifact.
+             * @example https://api.isnap.ai/device/apps/download/macos
+             */
+            url: string;
+            /**
+             * @description Version currently published for this platform, read from the release feed that sits beside the artifact `url` resolves to — so the number announced and the file served cannot name different releases. `null` when that feed publishes nothing or could not be read; `version_status` says which. Never a configured placeholder: a fabricated version makes a failed install and an uninformed console indistinguishable to whoever is checking. Compare it against an installed version to offer an update.
+             * @example 0.0.211
+             */
+            version: string | null;
+            /**
+             * @description Why `version` holds what it holds. `version` is non-null if and only if this is `published`, so a null is never ambiguous (WHA-2765). `none_published` — the feed answered and publishes no version (a 404, or a feed with no readable item): a real fact about the channel, render "version not published". `unreachable` — the feed could not be read (timeout, DNS failure, a body past the size cap): OUR fault or the update host's, and nobody knows what this channel publishes, so do not tell an operator the version is missing. `misconfigured` — an artifact URL is configured for the platform and no feed URL can be derived from it; someone must fix the deployment. `not_configured` — this deployment ships no artifact for the platform, which is the same fact `available: false` carries. Before this field the last three and the first were one indistinguishable `null`, so a broken appcast URL and a healthy pre-release channel rendered identically.
+             * @example published
+             * @enum {string}
+             */
+            version_status: "published" | "none_published" | "unreachable" | "misconfigured" | "not_configured";
+            /**
+             * @description False when this deployment has no artifact configured for the platform. The entry is still returned, so a consumer can hide the affordance instead of surfacing a link that 404s on click.
+             * @example true
+             */
+            available: boolean;
+        };
     };
     responses: never;
     parameters: never;