@viewrium/sdk 0.1.0 → 2.1.0

package/dist/index.d.ts

@@ -1,350 +1,3535 @@
 /**
- * Typed error hierarchy for the Viewrium SDK.
- *
- * All API-originated failures inherit from `ViewriumError`. Network-level
- * failures (connection reset, DNS) bubble up as the underlying fetch error
- * unchanged.
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
  */
-declare class ViewriumError extends Error {
-    readonly statusCode: number | undefined;
-    readonly responseBody: unknown;
-    constructor(message: string, options?: {
-        statusCode?: number;
-        responseBody?: unknown;
-    });
-}
-declare class AuthError extends ViewriumError {
-    constructor(message: string, options?: {
-        statusCode?: number;
-        responseBody?: unknown;
-    });
-}
-declare class NotFoundError extends ViewriumError {
-    constructor(message: string, options?: {
-        statusCode?: number;
-        responseBody?: unknown;
-    });
+interface paths {
+    "/v1/products": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List Products
+         * @description The catalog (D54): one org, the principal's only org when `org_id` is omitted, or
+         *     `scope=all` for every org an agency member or staff reaches. Filters AND together.
+         */
+        get: operations["list_products_v1_products_get"];
+        put?: never;
+        /**
+         * Create Product
+         * @description Exactly one source (image_paths | image_urls | video_url | source_url | model_url |
+         *     resume_token).
+         *
+         *     - 200 {ProductParkedResponse} - the gate ALWAYS parks a fresh request (D24): the
+         *       analysis ran synchronously and NOTHING was written; the plan, the flags and the cost
+         *       come back with the token the Summary posts to commit.
+         *     - 202 {ProductResponse} - resume_token or model_url: the product and its asset rows
+         *       exist and the run has started. 409 on a replayed token or a duplicate custom_id.
+         *
+         *     D76: the plan is IMMUTABLE once the token exists. A resume commits the plan, the model
+         *     verdict and the price it was quoted for, and may still edit the `draft` (product
+         *     columns, none of which reaches the plan). A resume that states a different `order`, or
+         *     any `overrides`, is a 400 - changing what is generated means a new request.
+         */
+        post: operations["create_product_v1_products_post"];
+        /**
+         * Batch Delete Products
+         * @description 200 with per-id affected/not_found/forbidden buckets.
+         */
+        delete: operations["batch_delete_products_v1_products_delete"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/products/publish": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Publish Products
+         * @description The bulk publish toggle (D52). Single products toggle through PATCH. 402 when the org's
+         *     plan does not allow publishing, or the batch would pass its active-product cap.
+         */
+        post: operations["publish_products_v1_products_publish_post"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/products/export": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Export Products
+         * @description A ZIP of finished images (D52): select by `ids` or by the list's filters, choose which
+         *     image review statuses (default accepted and pending). Each image is finished on demand -
+         *     composited onto its background with its shadow - and reused while its settings are
+         *     unchanged. The root `manifest.json` names every entry and every image skipped. The 3D
+         *     model is never included.
+         *
+         *     - 200 - the archive streams.
+         *     - 202 {ProductExportQueuedResponse} - too many images need finishing for one request:
+         *       they are finished in the background, a download link is emailed, and the same request
+         *       streams the ZIP once they are done.
+         *
+         *     400 past 200 products.
+         */
+        get: operations["export_products_v1_products_export_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/products/tags": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List Product Tags
+         * @description Distinct tags across the same scope the list takes (`org_id` / `scope=all`).
+         */
+        get: operations["list_product_tags_v1_products_tags_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/products/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Product
+         * @description Two response shapes by principal kind: session/sk get the product with its assets; a
+         *     pk key gets PublicProductResponse, the allow-listed subset safe to expose in
+         *     browser-visible storefront JS, and only for a published product with a ready model.
+         */
+        get: operations["get_product_v1_products__id__get"];
+        put?: never;
+        post?: never;
+        /** Delete Product */
+        delete: operations["delete_product_v1_products__id__delete"];
+        options?: never;
+        head?: never;
+        /**
+         * Update Product
+         * @description The customer's fields, the user-set status and the publish toggle. 409 on a duplicate
+         *     custom_id; 400 for `awaiting_review`; 402 when the publish toggle is refused by the plan.
+         */
+        patch: operations["update_product_v1_products__id__patch"];
+        trace?: never;
+    };
+    "/v1/products/{id}/order": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Order Product
+         * @description Order the missing half - images onto a model-only product, or a model onto an images
+         *     product. PARKS (D24): the additions and their cost come back inside a `resume_token`
+         *     that `POST /v1/products` commits; nothing is written here. 409 with `details.reason`
+         *     (`no_analysis`, `generating`, `images_ordered`, `model_exists`, `model_failed`) when the
+         *     order cannot be placed; a failed model is never re-ordered through this route.
+         */
+        post: operations["order_product_v1_products__id__order_post"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/products/{id}/review": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Review Product
+         * @description The review flush (E4 P5): the coalesced patches the UI batched - image review
+         *     decisions and settings, the model's decision, the product's user-set status - validated
+         *     together and written in order. Review records decisions only; the finished images are
+         *     made by the export.
+         */
+        post: operations["review_product_v1_products__id__review_post"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/products/{id}/images/{image_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * Update Product Image
+         * @description One image: its review decision (one way out of pending), its shadow and background
+         *     overrides, its filename and alt text. Answers the image as it now reads. 404 for a
+         *     position the customer does not own.
+         */
+        patch: operations["update_product_image_v1_products__id__images__image_id__patch"];
+        trace?: never;
+    };
+    "/v1/products/{id}/model/rescale": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Rescale Product Model
+         * @description Re-apply real-world scale to the GLB in place; the product keeps the axes the
+         *     customer stated. 409 without a ready model, or for one with no measurable geometry; 502
+         *     when the resize itself fails.
+         */
+        post: operations["rescale_product_model_v1_products__id__model_rescale_post"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/products/{id}/tickets": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Create Product Ticket
+         * @description A single-use URL for the product's 3D file - the ONLY way to its bytes (there is no
+         *     model file URL in any response). It answers `model/gltf-binary` ONCE, until `expires_at`
+         *     (60 s for `view`, 30 s for `ar`). Mint it right before the viewer loads, never store it.
+         *
+         *     - publishable key: a PUBLISHED product only; the ticket is bound to the page's Origin (one
+         *       of the org's allowed domains).
+         *     - secret key / session: the org's own products, drafts included; bound to `origin` (the
+         *       page that will fetch the file), else the request's Origin.
+         *
+         *     A `view` ticket streams only to its bound origin; an `ar` ticket also to Android's Scene
+         *     Viewer, which sends none. 404 for a product the caller cannot see (or, for a pk, one that is
+         *     not published); 409 without a ready model; 400 for an origin outside the allowed domains;
+         *     429 past the mint limits.
+         */
+        post: operations["create_product_ticket_v1_products__id__tickets_post"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/products/{id}/model": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * Update Product Model
+         * @description The model's review decision (D14: independent of the images and of the product).
+         */
+        patch: operations["update_product_model_v1_products__id__model_patch"];
+        trace?: never;
+    };
+    "/v1/api_keys": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List Api Keys
+         * @description sk auth sees only its own project's keys.
+         */
+        get: operations["list_api_keys_v1_api_keys_get"];
+        put?: never;
+        /**
+         * Create Api Key
+         * @description 201 - the full key is returned exactly once.
+         */
+        post: operations["create_api_key_v1_api_keys_post"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/api_keys/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Revoke Api Key
+         * @description Soft revoke (sets revoked_at); the row is kept for usage attribution.
+         */
+        delete: operations["revoke_api_key_v1_api_keys__id__delete"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/usage": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Usage
+         * @description Buckets and totals over a window. One org (`org_id`, or the principal's only org), every
+         *     org the session reaches (`scope=all`), or one product (`product_id`, which needs no
+         *     `org_id`). Org-internal traffic is excluded unless `include_internal`.
+         *
+         *     `group_by=product` adds `by_product`: the window's best-performing products, ranked by 3D
+         *     views then AR entries and capped, each with its title. The buckets are unchanged - to break
+         *     one period down, ask again with the window narrowed to it.
+         */
+        get: operations["get_usage_v1_usage_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/beacon": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Ingest Beacon
+         * @description 204 No Content - never errors to the embed beyond 4xx auth/validation.
+         */
+        post: operations["ingest_beacon_v1_beacon_post"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/webhooks": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List Webhook Endpoints */
+        get: operations["list_webhook_endpoints_v1_webhooks_get"];
+        put?: never;
+        /**
+         * Create Webhook Endpoint
+         * @description 201 - includes signing_secret (readable later too; parity with today).
+         */
+        post: operations["create_webhook_endpoint_v1_webhooks_post"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/webhooks/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get Webhook Endpoint */
+        get: operations["get_webhook_endpoint_v1_webhooks__id__get"];
+        put?: never;
+        post?: never;
+        /** Delete Webhook Endpoint */
+        delete: operations["delete_webhook_endpoint_v1_webhooks__id__delete"];
+        options?: never;
+        head?: never;
+        /** Update Webhook Endpoint */
+        patch: operations["update_webhook_endpoint_v1_webhooks__id__patch"];
+        trace?: never;
+    };
+    "/v1/webhooks/{id}/deliveries": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List Webhook Deliveries */
+        get: operations["list_webhook_deliveries_v1_webhooks__id__deliveries_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/projects": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List Projects
+         * @description sk auth: returns its one project.
+         */
+        get: operations["list_projects_v1_projects_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/projects/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get Project */
+        get: operations["get_project_v1_projects__id__get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/health": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Health */
+        get: operations["health_v1_health_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
-declare class ValidationError extends ViewriumError {
-    constructor(message: string, options?: {
-        statusCode?: number;
-        responseBody?: unknown;
-    });
+interface components {
+    schemas: {
+        /** ApiKeyCreateRequest */
+        ApiKeyCreateRequest: {
+            key_type: components["schemas"]["KeyType"];
+            /** Org Id */
+            org_id?: string | null;
+            /** Project Id */
+            project_id?: string | null;
+            /** Name */
+            name?: string | null;
+            /**
+             * Scopes
+             * @default []
+             */
+            scopes: string[];
+        };
+        /**
+         * ApiKeyCreateResponse
+         * @description 201. `key` is the full key material. For secret keys this is the only time
+         *     it is ever returned; publishable keys stay retrievable on later reads.
+         */
+        ApiKeyCreateResponse: {
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            /** Org Id */
+            org_id?: string | null;
+            /** Project Id */
+            project_id?: string | null;
+            key_type: components["schemas"]["KeyType"];
+            /** Key Prefix */
+            key_prefix: string;
+            /** Name */
+            name?: string | null;
+            /**
+             * Scopes
+             * @default []
+             */
+            scopes: string[];
+            /** Last Used At */
+            last_used_at?: string | null;
+            /** Revoked At */
+            revoked_at?: string | null;
+            /**
+             * Created At
+             * Format: date-time
+             */
+            created_at: string;
+            /** Key */
+            key: string;
+        };
+        /** ApiKeyListResponse */
+        ApiKeyListResponse: {
+            /** Data */
+            data: components["schemas"]["ApiKeyResponse"][];
+        };
+        /** ApiKeyResponse */
+        ApiKeyResponse: {
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            /** Org Id */
+            org_id?: string | null;
+            /** Project Id */
+            project_id?: string | null;
+            key_type: components["schemas"]["KeyType"];
+            /** Key Prefix */
+            key_prefix: string;
+            /** Name */
+            name?: string | null;
+            /**
+             * Scopes
+             * @default []
+             */
+            scopes: string[];
+            /** Last Used At */
+            last_used_at?: string | null;
+            /** Revoked At */
+            revoked_at?: string | null;
+            /**
+             * Created At
+             * Format: date-time
+             */
+            created_at: string;
+            /** Key */
+            key?: string | null;
+        };
+        /**
+         * AssetStatus
+         * @description product_images.status and product_models.status (CHECK-enforced). `skipped` is an
+         *     image position nothing produced; a model row never carries it. Under E4 §6.1 a customer's
+         *     WITHHELD position also reads `skipped` - the projection, not the row, says so.
+         * @enum {string}
+         */
+        AssetStatus: "planned" | "generating" | "ready" | "failed" | "skipped";
+        /**
+         * BeaconEventType
+         * @description The subset of UsageEventType that POST /v1/beacon may ingest.
+         *     generation.* events are recorded server-side only, never via beacon.
+         * @enum {string}
+         */
+        BeaconEventType: "view" | "ar_enter" | "ar_session_ended";
+        /**
+         * BeaconRequest
+         * @description ONE ingest path, two auth modes (pk + Origin check for embeds; the first-party
+         *     viewer posts without a key). DECIDED (Dave, 2026-07-20): anonymous first-party
+         *     ingest is an accepted, signed-off risk. Writes usage_records; org/project/key
+         *     attribution resolved server-side. Response: 204 No Content.
+         */
+        BeaconRequest: {
+            /**
+             * Model Id
+             * Format: uuid
+             */
+            model_id: string;
+            event_type: components["schemas"]["BeaconEventType"];
+            /** Session Id */
+            session_id?: string | null;
+            /** Duration Ms */
+            duration_ms?: number | null;
+            /** Metadata */
+            metadata?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        /**
+         * DimensionUnit
+         * @description The unit `ModelCreateRequest.dimensions` is expressed in. API-boundary only:
+         *     the endpoint converts to canonical cm (lib/units) before anything downstream sees
+         *     the numbers - the DB, the workflow, and the SDKs' stored dims are always cm.
+         * @enum {string}
+         */
+        DimensionUnit: "mm" | "cm" | "m" | "in" | "ft";
+        /**
+         * DisplayStatus
+         * @description What a product LOOKS like, D13's vocabulary: the stored status, overridden by
+         *     Generating while any asset is in flight and by Published once it is live. Values are
+         *     the machine vocabulary; the customer copy is written from them on the surface.
+         * @enum {string}
+         */
+        DisplayStatus: "published" | "generating" | "failed" | "awaiting_review" | "needs_attention" | "ready_to_publish" | "complete";
+        /**
+         * GateFlags
+         * @description describe's structured read of the product (D25). `source_quality: poor` warns on both
+         *     layers and gates neither.
+         */
+        GateFlags: {
+            /**
+             * Transparent
+             * @default false
+             */
+            transparent: boolean;
+            /**
+             * Geometry Risk
+             * @default false
+             */
+            geometry_risk: boolean;
+            /**
+             * Texture Risk
+             * @default false
+             */
+            texture_risk: boolean;
+            /**
+             * Source Quality
+             * @default ok
+             * @enum {string}
+             */
+            source_quality: "ok" | "poor";
+            /** Reasons */
+            reasons?: components["schemas"]["GateReason"][];
+        };
+        /**
+         * GateReason
+         * @description One raised flag, in describe's own words. Shown to the customer VERBATIM (D25).
+         */
+        GateReason: {
+            /** Code */
+            code: string;
+            /** Sentence */
+            sentence: string;
+        };
+        /** HTTPValidationError */
+        HTTPValidationError: {
+            /** Detail */
+            detail?: components["schemas"]["ValidationError"][];
+        };
+        /** HealthResponse */
+        HealthResponse: {
+            /**
+             * Status
+             * @default ok
+             * @constant
+             */
+            status: "ok";
+            /** Version */
+            version?: string | null;
+        };
+        /**
+         * KeyType
+         * @description api_keys.key_type (CHECK-enforced). Prefixes: pk_ (publishable), sk_ (secret).
+         * @enum {string}
+         */
+        KeyType: "publishable" | "secret";
+        /**
+         * ListScope
+         * @description GET /v1/products scope (II.4, D44): one org, or every org the principal reaches -
+         *     an agency's clients, or everything for staff. Writes always name one org.
+         * @enum {string}
+         */
+        ListScope: "org" | "all";
+        /**
+         * ModelDimensions
+         * @description Real-world dimensions in cm (DB: products.height/width/depth numeric).
+         */
+        ModelDimensions: {
+            /** Height */
+            height?: number | null;
+            /** Width */
+            width?: number | null;
+            /** Depth */
+            depth?: number | null;
+        };
+        /**
+         * ModelPlanResponse
+         * @description The models layer's verdict. `views` is the D28 set for this form, in submission
+         *     order; internal gap-fills are machinery and are deliberately NOT listed (D33).
+         *
+         *     `unseen_views` are the views the model will be built from INVENTED rows (generated with
+         *     `evidence: unseen`, the D28 fill excepted - `gate.invented_model_views`), listed whether or
+         *     not they refuse it. Two or more put `unseen_views` in `blocked_by` (`gate.UNSEEN_BLOCK_AT`).
+         */
+        ModelPlanResponse: {
+            /** Ordered */
+            ordered: boolean;
+            /** Allowed */
+            allowed: boolean;
+            /** Blocked By */
+            blocked_by?: string[];
+            /** Views */
+            views?: string[];
+            /** Unseen Views */
+            unseen_views?: string[];
+        };
+        /**
+         * PlannedView
+         * @description One page position as it will be committed - a `product_images` row, pre-shaped.
+         *
+         *     `reason_code` is the closed vocabulary of `lib/gate.py`; `reason` is routing's own
+         *     factual sentence. The customer copy is written from the CODE on the surface that shows
+         *     it (E6), never from this string.
+         */
+        PlannedView: {
+            /** View */
+            view: string;
+            /**
+             * Kind
+             * @enum {string}
+             */
+            kind: "wanted" | "extra";
+            /** Stands For */
+            stands_for: string;
+            /**
+             * Status
+             * @enum {string}
+             */
+            status: "planned" | "skipped";
+            /** Evidence */
+            evidence: string;
+            /** Reason Code */
+            reason_code: string;
+            /** Reason */
+            reason: string;
+            /** Deliverable */
+            deliverable: boolean;
+            /** Route */
+            route?: ("reuse" | "edit" | "generate") | null;
+            /** Photo */
+            photo?: number | null;
+            /** Pins */
+            pins?: number[];
+            /** Azimuth */
+            azimuth: string;
+            /** Tilt */
+            tilt: string;
+            /**
+             * Flagged
+             * @default false
+             */
+            flagged: boolean;
+        };
+        /**
+         * ProductBatchResponse
+         * @description Per-id outcome; 200 even when some ids were missing.
+         */
+        ProductBatchResponse: {
+            /** Affected */
+            affected: string[];
+            /** Not Found */
+            not_found: string[];
+            /** Forbidden */
+            forbidden: string[];
+        };
+        /**
+         * ProductCost
+         * @description What an order costs, in CREDITS (1 credit = $0.50): 1 per deliverable image, a flat 10
+         *     for a model. Internal 3D gap-fills never enter the maths.
+         */
+        ProductCost: {
+            /** Images */
+            images: number;
+            /** Image Credits */
+            image_credits: number;
+            /** Model Credits */
+            model_credits: number;
+            /** Total Credits */
+            total_credits: number;
+        };
+        /**
+         * ProductCreateRequest
+         * @description POST /v1/products - park (200) or, with `resume_token`, commit (202).
+         *
+         *     Exactly ONE source: image_paths | image_urls | video_url | source_url | model_url |
+         *     resume_token.
+         *     `image_paths` are UPLOADS-BUCKET object paths, not URLs: the wizard uploads
+         *     direct-to-storage before any row exists (D24), so the gate is handed paths inside the
+         *     caller's own org folder and re-hosts nothing (E1 P5).
+         */
+        ProductCreateRequest: {
+            /** Image Paths */
+            image_paths?: string[] | null;
+            /** Image Urls */
+            image_urls?: string[] | null;
+            /** Video Url */
+            video_url?: string | null;
+            /** Source Url */
+            source_url?: string | null;
+            /** Model Url */
+            model_url?: string | null;
+            /** Resume Token */
+            resume_token?: string | null;
+            /** Org Id */
+            org_id?: string | null;
+            draft?: components["schemas"]["ProductDraft"];
+            order?: components["schemas"]["ProductOrder"];
+            overrides?: components["schemas"]["ProductOverrides"];
+        };
+        /**
+         * ProductDraft
+         * @description The customer-editable half of a product, sent at park and again at resume.
+         *
+         *     A resume may CHANGE these (D24: the wizard Summary is the park state, so its fields are
+         *     still live when Generate is pressed), which is why they ride in the token rather than
+         *     being frozen at the first call.
+         */
+        ProductDraft: {
+            /** Title */
+            title?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Price */
+            price?: number | null;
+            /** Currency */
+            currency?: string | null;
+            /** Custom Id */
+            custom_id?: string | null;
+            /** Tags */
+            tags?: string[] | null;
+            /** Metadata */
+            metadata?: {
+                [key: string]: unknown;
+            } | null;
+            dimensions?: components["schemas"]["ModelDimensions"] | null;
+            unit?: components["schemas"]["DimensionUnit"] | null;
+            /** Wall Mounted */
+            wall_mounted?: boolean | null;
+        };
+        /**
+         * ProductExportQueuedResponse
+         * @description 202 from the export: more images need finishing than one request can do, so they are
+         *     being finished in the background and nothing streamed. A download link is emailed to
+         *     `notify_email` when they are done; repeating the same request then streams the ZIP
+         *     (and repeating it earlier simply queues what is still missing).
+         */
+        ProductExportQueuedResponse: {
+            /**
+             * Status
+             * @default queued
+             * @constant
+             */
+            status: "queued";
+            /** Products */
+            products: number;
+            /** Images */
+            images: number;
+            /** To Finish */
+            to_finish: number;
+            /** Notify Email */
+            notify_email?: string | null;
+        };
+        /**
+         * ProductImagePatch
+         * @description PATCH /v1/products/{id}/images/{image_id}, and one item of the review flush.
+         *
+         *     An explicit null CLEARS an override (the field is in `model_fields_set`); an omitted
+         *     field leaves it alone. `review_status` is one way out of `pending` (Q7).
+         */
+        ProductImagePatch: {
+            review_status?: components["schemas"]["ReviewStatus"] | null;
+            shadow_override?: components["schemas"]["ShadowOverride"] | null;
+            /** Background Override */
+            background_override?: number[] | null;
+            /** Filename Override */
+            filename_override?: string | null;
+            /** Alt Override */
+            alt_override?: string | null;
+        };
+        /**
+         * ProductImageResponse
+         * @description One customer-visible image position (E4 plan §6.1). A withheld position reads
+         *     `status: skipped` with a `skip_reason` and no files; a 3D-only row never appears.
+         *     `filename` / `alt_text` are the override when set, else `lib/naming.py`'s.
+         */
+        ProductImageResponse: {
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            /** View */
+            view: string;
+            /**
+             * Kind
+             * @enum {string}
+             */
+            kind: "wanted" | "extra";
+            /** Stands For */
+            stands_for: string;
+            status: components["schemas"]["AssetStatus"];
+            /** Skip Reason */
+            skip_reason?: string | null;
+            /** Route */
+            route?: ("reuse" | "edit" | "generate") | null;
+            /** Source */
+            source?: ("photograph" | "edited" | "generated") | null;
+            /** Evidence */
+            evidence?: string | null;
+            /** Azimuth */
+            azimuth?: string | null;
+            /** Tilt */
+            tilt?: string | null;
+            /** Source Photo Id */
+            source_photo_id?: string | null;
+            /**
+             * Attempts
+             * @default 0
+             */
+            attempts: number;
+            /**
+             * Flagged
+             * @default false
+             */
+            flagged: boolean;
+            /**
+             * Cut Flagged
+             * @default false
+             */
+            cut_flagged: boolean;
+            /** Cut Problems */
+            cut_problems?: string | null;
+            /** @default pending */
+            review_status: components["schemas"]["ReviewStatus"];
+            /** Filename */
+            filename: string;
+            /** Alt Text */
+            alt_text: string;
+            /** Filename Override */
+            filename_override?: string | null;
+            /** Alt Override */
+            alt_override?: string | null;
+            shadow_override?: components["schemas"]["ShadowOverride"] | null;
+            /** Background Override */
+            background_override?: number[] | null;
+            /** Frame Scale */
+            frame_scale?: number | null;
+            /** Contact Regions */
+            contact_regions?: number[][];
+            /** Raw Url */
+            raw_url?: string | null;
+            /** Cutout Url */
+            cutout_url?: string | null;
+            /** Warnings */
+            warnings?: components["schemas"]["ProductWarning"][];
+            /**
+             * Created At
+             * Format: date-time
+             */
+            created_at: string;
+            /** Updated At */
+            updated_at?: string | null;
+        };
+        /** ProductListResponse */
+        ProductListResponse: {
+            /** Data */
+            data: components["schemas"]["ProductSummary"][];
+            /** Total */
+            total: number;
+            /** Limit */
+            limit: number;
+            /** Offset */
+            offset: number;
+        };
+        /** ProductModelPatch */
+        ProductModelPatch: {
+            review_status?: components["schemas"]["ReviewStatus"] | null;
+        };
+        /**
+         * ProductModelResponse
+         * @description The product's 3D model. There is NO file URL here, on purpose (Dave, 2026-10-16: no
+         *     model file URL anywhere, merchants included): the bytes are reached only through a
+         *     single-use ticket, `POST /v1/products/{id}/tickets`.
+         */
+        ProductModelResponse: {
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            status: components["schemas"]["AssetStatus"];
+            /** @default pending */
+            review_status: components["schemas"]["ReviewStatus"];
+            /** Thumbnail Url */
+            thumbnail_url?: string | null;
+            /** Scale Factor */
+            scale_factor?: number | null;
+            /** Width Axis */
+            width_axis?: ("x" | "z") | null;
+            flags?: components["schemas"]["GateFlags"];
+            /** Warnings */
+            warnings?: components["schemas"]["ProductWarning"][];
+            /**
+             * Created At
+             * Format: date-time
+             */
+            created_at: string;
+            /** Completed At */
+            completed_at?: string | null;
+        };
+        /**
+         * ProductOrder
+         * @description What the customer asked to be produced. Either half may be ordered alone (plan §2.3).
+         */
+        ProductOrder: {
+            /**
+             * Images
+             * @default true
+             */
+            images: boolean;
+            /**
+             * Model
+             * @default false
+             */
+            model: boolean;
+        };
+        /**
+         * ProductOrderParkedResponse
+         * @description 200 from the order park: the ADDITIONS the commit will make, priced, inside a token.
+         *     Nothing was written.
+         */
+        ProductOrderParkedResponse: {
+            /**
+             * Status
+             * @default parked
+             * @constant
+             */
+            status: "parked";
+            /** Resume Token */
+            resume_token: string;
+            /**
+             * Expires At
+             * Format: date-time
+             */
+            expires_at: string;
+            order: components["schemas"]["ProductOrder"];
+            flags: components["schemas"]["GateFlags"];
+            /** Plan */
+            plan?: components["schemas"]["PlannedView"][];
+            model: components["schemas"]["ModelPlanResponse"];
+            cost: components["schemas"]["ProductCost"];
+            /** Warnings */
+            warnings?: string[];
+            /**
+             * Generate Unseen
+             * @default false
+             */
+            generate_unseen: boolean;
+            /**
+             * Force Model
+             * @default false
+             */
+            force_model: boolean;
+        };
+        /**
+         * ProductOrderRequest
+         * @description POST /v1/products/{id}/order - the missing half (E4 plan §6.4). Parks; the commit is
+         *     POST /v1/products with the returned resume_token.
+         */
+        ProductOrderRequest: {
+            order: components["schemas"]["ProductOrder"];
+            overrides?: components["schemas"]["ProductOverrides"];
+        };
+        /**
+         * ProductOverrides
+         * @description The wizard's per-run answers. None = no answer, and the org preference stands - that
+         *     is the whole of D25's `wizard override ?? org preference`.
+         */
+        ProductOverrides: {
+            /** Generate Unseen */
+            generate_unseen?: boolean | null;
+            /** Force Model */
+            force_model?: boolean | null;
+        };
+        /**
+         * ProductOwner
+         * @description The profile that created a product, for a created-by initials badge (D54). Carries an
+         *     email, so it never reaches a pk principal - `PublicProductResponse` has no owner.
+         */
+        ProductOwner: {
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            /** Display Name */
+            display_name?: string | null;
+            /** Email */
+            email: string;
+        };
+        /**
+         * ProductParkedResponse
+         * @description 200 from POST /v1/products - the gate ALWAYS parks (D24).
+         *
+         *     No product row exists, nothing was written, and nothing can orphan: the analysis lives
+         *     only inside `resume_token`, which the Summary posts back to commit. `expires_at` mirrors
+         *     the Fernet TTL (7 days, fal's URL retention floor).
+         */
+        ProductParkedResponse: {
+            /**
+             * Status
+             * @default parked
+             * @constant
+             */
+            status: "parked";
+            /** Resume Token */
+            resume_token: string;
+            /**
+             * Expires At
+             * Format: date-time
+             */
+            expires_at: string;
+            /** Form */
+            form: string;
+            /** Title */
+            title?: string | null;
+            /** Description */
+            description?: string | null;
+            /**
+             * Subject
+             * @default
+             */
+            subject: string;
+            /**
+             * Wall Mounted
+             * @default false
+             */
+            wall_mounted: boolean;
+            dimensions?: components["schemas"]["ModelDimensions"] | null;
+            display_unit?: components["schemas"]["DimensionUnit"] | null;
+            flags: components["schemas"]["GateFlags"];
+            /** Warnings */
+            warnings?: string[];
+            /** Plan */
+            plan?: components["schemas"]["PlannedView"][];
+            model: components["schemas"]["ModelPlanResponse"];
+            cost: components["schemas"]["ProductCost"];
+            /**
+             * Generate Unseen
+             * @default false
+             */
+            generate_unseen: boolean;
+            /**
+             * Force Model
+             * @default false
+             */
+            force_model: boolean;
+        };
+        /**
+         * ProductPublishRequest
+         * @description POST /v1/products/publish - the bulk publish toggle (D52, E8).
+         */
+        ProductPublishRequest: {
+            /** Ids */
+            ids: string[];
+            /** Published */
+            published: boolean;
+        };
+        /**
+         * ProductRescaleRequest
+         * @description POST /v1/products/{id}/model/rescale. At least one axis; every supplied axis is applied
+         *     to the GEOMETRY; `unit` covers the values (absent = cm) and becomes the product's
+         *     display_unit; `width_axis` skips the ruler render and the VLM call.
+         */
+        ProductRescaleRequest: {
+            /** Height */
+            height?: number | null;
+            /** Width */
+            width?: number | null;
+            /** Depth */
+            depth?: number | null;
+            unit?: components["schemas"]["DimensionUnit"] | null;
+            /** Width Axis */
+            width_axis?: ("x" | "z") | null;
+        };
+        /**
+         * ProductResponse
+         * @description The product WITH its assets: 202 from a committed POST, and GET /v1/products/{id}.
+         *
+         *     `status` is the STORED review status; `display_status` is D13's fold of it with
+         *     `published` and whether any asset is still in flight - the one a surface shows.
+         *     `images` is the customer's list (§6.1), in page order; `warnings` is every warning for
+         *     the product, image ones first.
+         */
+        ProductResponse: {
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            /**
+             * Org Id
+             * Format: uuid
+             */
+            org_id: string;
+            /** Title */
+            title: string;
+            /** Custom Id */
+            custom_id?: string | null;
+            /** Tags */
+            tags?: string[];
+            status: components["schemas"]["ProductStatus"];
+            display_status: components["schemas"]["DisplayStatus"];
+            /**
+             * Published
+             * @default false
+             */
+            published: boolean;
+            /** Form */
+            form?: string | null;
+            source_type?: components["schemas"]["SourceType"] | null;
+            /** Price */
+            price?: number | null;
+            /** Currency */
+            currency?: string | null;
+            /** Height */
+            height?: number | null;
+            /** Width */
+            width?: number | null;
+            /** Depth */
+            depth?: number | null;
+            display_unit?: components["schemas"]["DimensionUnit"] | null;
+            /**
+             * Images Ordered
+             * @default false
+             */
+            images_ordered: boolean;
+            /** Thumbnail Url */
+            thumbnail_url?: string | null;
+            /**
+             * Has Warnings
+             * @default false
+             */
+            has_warnings: boolean;
+            /**
+             * Warning Count
+             * @default 0
+             */
+            warning_count: number;
+            /**
+             * Comment Count
+             * @default 0
+             */
+            comment_count: number;
+            /**
+             * Image Count
+             * @default 0
+             */
+            image_count: number;
+            model_status?: components["schemas"]["AssetStatus"] | null;
+            owner?: components["schemas"]["ProductOwner"] | null;
+            /**
+             * Created At
+             * Format: date-time
+             */
+            created_at: string;
+            /** Updated At */
+            updated_at?: string | null;
+            /** Description */
+            description?: string | null;
+            /**
+             * Wall Mounted
+             * @default false
+             */
+            wall_mounted: boolean;
+            /** Product Type */
+            product_type?: string | null;
+            /** Material Words */
+            material_words?: string | null;
+            /**
+             * Transparent
+             * @default false
+             */
+            transparent: boolean;
+            /** Metadata */
+            metadata?: {
+                [key: string]: unknown;
+            };
+            /** Sources */
+            sources?: components["schemas"]["ProductSourceResponse"][];
+            /** Images */
+            images?: components["schemas"]["ProductImageResponse"][];
+            model?: components["schemas"]["ProductModelResponse"] | null;
+            /** Warnings */
+            warnings?: components["schemas"]["ProductWarning"][];
+            /**
+             * Open Request Count
+             * @default 0
+             */
+            open_request_count: number;
+        };
+        /** ProductReviewImagePatch */
+        ProductReviewImagePatch: {
+            review_status?: components["schemas"]["ReviewStatus"] | null;
+            shadow_override?: components["schemas"]["ShadowOverride"] | null;
+            /** Background Override */
+            background_override?: number[] | null;
+            /** Filename Override */
+            filename_override?: string | null;
+            /** Alt Override */
+            alt_override?: string | null;
+            /**
+             * Image Id
+             * Format: uuid
+             */
+            image_id: string;
+        };
+        /**
+         * ProductReviewRequest
+         * @description POST /v1/products/{id}/review - the write-behind flush (E4 P5): the coalesced patches
+         *     the UI batched, applied in order after every one has been validated.
+         */
+        ProductReviewRequest: {
+            status?: components["schemas"]["ProductStatus"] | null;
+            /** Images */
+            images?: components["schemas"]["ProductReviewImagePatch"][];
+            model?: components["schemas"]["ProductModelPatch"] | null;
+        };
+        /** ProductReviewResponse */
+        ProductReviewResponse: {
+            /**
+             * Product Id
+             * Format: uuid
+             */
+            product_id: string;
+            /** Applied */
+            applied: number;
+            display_status: components["schemas"]["DisplayStatus"];
+        };
+        /**
+         * ProductSortField
+         * @description Sortable columns for GET /v1/products. D54's four sorts are these two, each way;
+         *     restricted to a closed set because the value reaches PostgREST's `order` as a column.
+         * @enum {string}
+         */
+        ProductSortField: "created_at" | "title";
+        /** ProductSourceResponse */
+        ProductSourceResponse: {
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            /**
+             * Kind
+             * @enum {string}
+             */
+            kind: "photo" | "video";
+            /** Url */
+            url: string;
+            /** Original Name */
+            original_name?: string | null;
+            /**
+             * Position
+             * @default 0
+             */
+            position: number;
+            /** Azimuth */
+            azimuth?: string | null;
+            /** Tilt */
+            tilt?: string | null;
+            /** Clean */
+            clean?: boolean | null;
+            /**
+             * Created At
+             * Format: date-time
+             */
+            created_at: string;
+        };
+        /**
+         * ProductStatus
+         * @description products.status (CHECK-enforced, E1 WP3). The STORED review lifecycle only - what a
+         *     surface DISPLAYS also folds in `published` and whether any asset is still generating
+         *     (D13); `lib.product_status.displayed_status` is the one place that fold happens.
+         * @enum {string}
+         */
+        ProductStatus: "awaiting_review" | "needs_attention" | "ready_to_publish" | "complete";
+        /**
+         * ProductSummary
+         * @description A catalog row (D54): the product plus what its card needs. No nested assets.
+         */
+        ProductSummary: {
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            /**
+             * Org Id
+             * Format: uuid
+             */
+            org_id: string;
+            /** Title */
+            title: string;
+            /** Custom Id */
+            custom_id?: string | null;
+            /** Tags */
+            tags?: string[];
+            status: components["schemas"]["ProductStatus"];
+            display_status: components["schemas"]["DisplayStatus"];
+            /**
+             * Published
+             * @default false
+             */
+            published: boolean;
+            /** Form */
+            form?: string | null;
+            source_type?: components["schemas"]["SourceType"] | null;
+            /** Price */
+            price?: number | null;
+            /** Currency */
+            currency?: string | null;
+            /** Height */
+            height?: number | null;
+            /** Width */
+            width?: number | null;
+            /** Depth */
+            depth?: number | null;
+            display_unit?: components["schemas"]["DimensionUnit"] | null;
+            /**
+             * Images Ordered
+             * @default false
+             */
+            images_ordered: boolean;
+            /** Thumbnail Url */
+            thumbnail_url?: string | null;
+            /**
+             * Has Warnings
+             * @default false
+             */
+            has_warnings: boolean;
+            /**
+             * Warning Count
+             * @default 0
+             */
+            warning_count: number;
+            /**
+             * Comment Count
+             * @default 0
+             */
+            comment_count: number;
+            /**
+             * Image Count
+             * @default 0
+             */
+            image_count: number;
+            model_status?: components["schemas"]["AssetStatus"] | null;
+            owner?: components["schemas"]["ProductOwner"] | null;
+            /**
+             * Created At
+             * Format: date-time
+             */
+            created_at: string;
+            /** Updated At */
+            updated_at?: string | null;
+        };
+        /**
+         * ProductUpdateRequest
+         * @description PATCH /v1/products/{id} - the customer's fields, the user-set status (D13; never
+         *     back to `awaiting_review`) and the publish toggle. Dimensions are stored WITHOUT a
+         *     rescale; `POST .../model/rescale` rewrites the GLB.
+         */
+        ProductUpdateRequest: {
+            /** Title */
+            title?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Price */
+            price?: number | null;
+            /** Currency */
+            currency?: string | null;
+            /** Custom Id */
+            custom_id?: string | null;
+            /** Tags */
+            tags?: string[] | null;
+            /** Metadata */
+            metadata?: {
+                [key: string]: unknown;
+            } | null;
+            dimensions?: components["schemas"]["ModelDimensions"] | null;
+            unit?: components["schemas"]["DimensionUnit"] | null;
+            display_unit?: components["schemas"]["DimensionUnit"] | null;
+            /** Wall Mounted */
+            wall_mounted?: boolean | null;
+            status?: components["schemas"]["ProductStatus"] | null;
+            /** Published */
+            published?: boolean | null;
+        };
+        /**
+         * ProductWarning
+         * @description One customer-facing warning, derived at read time (D21) by `lib/warnings.py`.
+         */
+        ProductWarning: {
+            kind: components["schemas"]["WarningKind"];
+            /**
+             * Scope
+             * @enum {string}
+             */
+            scope: "image" | "product";
+            /** Title */
+            title: string;
+            /** Detail */
+            detail: string;
+            /** View */
+            view?: string | null;
+        };
+        /** ProjectListResponse */
+        ProjectListResponse: {
+            /** Data */
+            data: components["schemas"]["ProjectResponse"][];
+        };
+        /** ProjectResponse */
+        ProjectResponse: {
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            /**
+             * Org Id
+             * Format: uuid
+             */
+            org_id: string;
+            /** Name */
+            name: string;
+            /**
+             * Allowed Domains
+             * @default []
+             */
+            allowed_domains: string[];
+            /**
+             * Always Generate
+             * @default false
+             */
+            always_generate: boolean;
+            /**
+             * Created At
+             * Format: date-time
+             */
+            created_at: string;
+        };
+        /**
+         * PublicProductResponse
+         * @description What a PUBLISHABLE key receives from GET /v1/products/{id} - an explicit ALLOW-LIST,
+         *     deliberately a separate model rather than a filtered ProductResponse.
+         *
+         *     pk keys ship inside the embed script in browser-visible JS on merchants' public
+         *     storefronts, so anything here is world-readable. An allow-list fails closed: a field
+         *     added to ProductResponse tomorrow is NOT exposed here until someone adds it on purpose.
+         *     Only a PUBLISHED product with a READY model is served at all (the `public_products()`
+         *     gate, D72); the images half is post-launch backlog #4. The model file itself is NOT here:
+         *     the embed mints a single-use ticket for it (`POST /v1/products/{id}/tickets`).
+         */
+        PublicProductResponse: {
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            /** Title */
+            title: string;
+            /** Thumbnail Url */
+            thumbnail_url?: string | null;
+            model_status?: components["schemas"]["AssetStatus"] | null;
+            /**
+             * Wall Mounted
+             * @default false
+             */
+            wall_mounted: boolean;
+        };
+        /**
+         * ReviewStatus
+         * @description product_images.review_status and product_models.review_status (CHECK-enforced, E1
+         *     WP3). One way out of `pending` (Dave, 2026-09-09): accepted and rejected swap freely,
+         *     nothing goes back to pending.
+         * @enum {string}
+         */
+        ReviewStatus: "pending" | "accepted" | "rejected";
+        /** ShadowContact */
+        ShadowContact: {
+            /** Trailpx */
+            trailPx?: number | null;
+            /** Dark */
+            dark?: number | null;
+            /** End */
+            end?: number | null;
+            /** Midpoint */
+            midpoint?: number | null;
+            /** Regionheight */
+            regionHeight?: number | null;
+        };
+        /** ShadowGround */
+        ShadowGround: {
+            /** Nudge */
+            nudge?: number | null;
+            /** Tilt */
+            tilt?: number | null;
+        };
+        /**
+         * ShadowOverride
+         * @description A per-image shadow override in the RENDERER'S own shape (`@repo/heinimex-render`'s
+         *     `ShadowSettings` minus `background`), every field optional: the compositor merges it over
+         *     CALIBRATED field by field, so a caller sends only what it overrides. Background is its
+         *     own column (`background_override`), as the review app keeps it.
+         */
+        ShadowOverride: {
+            /** Mode */
+            mode?: ("silhouette" | "contact" | "both") | null;
+            /** Tone */
+            tone?: number[] | null;
+            silhouette?: components["schemas"]["ShadowSilhouette"] | null;
+            contact?: components["schemas"]["ShadowContact"] | null;
+            ground?: components["schemas"]["ShadowGround"] | null;
+        };
+        /** ShadowSilhouette */
+        ShadowSilhouette: {
+            /** Length */
+            length?: number | null;
+            /** Lean */
+            lean?: number | null;
+            /** Blurnear */
+            blurNear?: number | null;
+            /** Blurfar */
+            blurFar?: number | null;
+            /** Opacity */
+            opacity?: number | null;
+            /** Distancefade */
+            distanceFade?: number | null;
+        };
+        /**
+         * SortOrder
+         * @enum {string}
+         */
+        SortOrder: "asc" | "desc";
+        /**
+         * SourceType
+         * @description scans.source_type (unconstrained text in prod, default 'scan').
+         *
+         *     DECIDED (Dave, 2026-07-20): v2 vocabulary is image | video | url | model with a
+         *     CHECK; legacy mapping upload -> model and scan -> video. Backfill drafted in the
+         *     pending migration (section 3); the CHECK itself waits for cutover because the live
+         *     v1 app still writes 'upload' and defaults to 'scan'.
+         * @enum {string}
+         */
+        SourceType: "image" | "video" | "url" | "model" | "scan" | "upload";
+        /** TagCount */
+        TagCount: {
+            /** Tag */
+            tag: string;
+            /** Count */
+            count: number;
+        };
+        /**
+         * TagMatch
+         * @description How repeated ?tag= values combine (Dave ruling, 2026-07-22: caller-selectable,
+         *     the dashboard exposes an All/Any control inside the Tags dropdown).
+         * @enum {string}
+         */
+        TagMatch: "all" | "any";
+        /**
+         * TagsResponse
+         * @description Distinct tags across the list's scope (GET /v1/products/tags).
+         */
+        TagsResponse: {
+            /** Data */
+            data: components["schemas"]["TagCount"][];
+        };
+        /**
+         * TicketKind
+         * @description `model_tickets.kind` (migration section 46): what one single-use model ticket is for.
+         *     `view` streams to the page that minted it (its Origin must match); `ar` is Android's Scene
+         *     Viewer, which re-downloads the file outside the page and sends no Origin.
+         * @enum {string}
+         */
+        TicketKind: "view" | "ar";
+        /**
+         * TicketRequest
+         * @description POST /v1/products/{id}/tickets - one single-use ticket for the product's 3D file.
+         *
+         *     `view` is for the page itself: the redeem streams the file only to a request whose Origin
+         *     is the one the ticket is bound to. `ar` is for Android's Scene Viewer, which downloads the
+         *     file outside the page (it sends no Origin) - mint it on the AR tap, it lives 30 s.
+         *
+         *     `origin` is for a SERVER minting on a page's behalf (a secret key, or our dashboard's own
+         *     server): the origin of the page that will fetch the file. It must be one of the org's
+         *     allowed domains (or ours). A publishable key never sends it - a pk ticket is bound to the
+         *     request's own Origin, which the key's allowed domains already gated.
+         */
+        TicketRequest: {
+            kind: components["schemas"]["TicketKind"];
+            /** Origin */
+            origin?: string | null;
+        };
+        /**
+         * TicketResponse
+         * @description A single-use URL for the product's 3D file (`model/gltf-binary`). It works ONCE, until
+         *     `expires_at`, and for a view ticket only from its bound origin. Do not store it.
+         */
+        TicketResponse: {
+            /** Url */
+            url: string;
+            kind: components["schemas"]["TicketKind"];
+            /**
+             * Expires At
+             * Format: date-time
+             */
+            expires_at: string;
+        };
+        /** UsageBucket */
+        UsageBucket: {
+            /**
+             * Period Start
+             * Format: date-time
+             */
+            period_start: string;
+            event_type: components["schemas"]["UsageEventType"];
+            /** Count */
+            count: number;
+            /** Cost Cents */
+            cost_cents?: number | null;
+            duration?: components["schemas"]["UsageDuration"] | null;
+        };
+        /**
+         * UsageDuration
+         * @description AR session length, as a SUM plus its own divisor - never a pre-computed average.
+         *
+         *     The average is `total_ms / count`, so the same object serves a per-bucket mean (the
+         *     temporal distribution) and a window mean (the summary tile) from one response: a
+         *     pre-computed average could not be re-aggregated across buckets, a sum can.
+         *
+         *     `count` is NOT UsageBucket.count. Only `ar_session_ended` carries a duration, and even
+         *     there `duration_ms` is optional on the beacon and arrives from an untrusted body, so
+         *     the events that contributed a usable value are counted separately and are the only
+         *     correct divisor.
+         */
+        UsageDuration: {
+            /** Total Ms */
+            total_ms: number;
+            /** Count */
+            count: number;
+        };
+        /**
+         * UsageEventType
+         * @description usage_records.event_type (CHECK-enforced, exact prod list - all six live in data).
+         * @enum {string}
+         */
+        UsageEventType: "generation.created" | "generation.completed" | "generation.failed" | "view" | "ar_enter" | "ar_session_ended";
+        /**
+         * UsageProductTotals
+         * @description One product's counts over the window - the `group_by=product` row.
+         *
+         *     `title` is read from the product itself, so a caller ranking products needs no second request
+         *     to name them. A subject with no product row is a v1 SCAN and is left out entirely: v2 serves
+         *     no scan, and a ranking whose rows cannot be opened is a list of dead ends.
+         */
+        UsageProductTotals: {
+            /**
+             * Product Id
+             * Format: uuid
+             */
+            product_id: string;
+            /** Title */
+            title?: string | null;
+            /** Totals */
+            totals: {
+                [key: string]: number;
+            };
+        };
+        /** UsageResponse */
+        UsageResponse: {
+            /**
+             * Start
+             * Format: date-time
+             */
+            start: string;
+            /**
+             * End
+             * Format: date-time
+             */
+            end: string;
+            /**
+             * Granularity
+             * @enum {string}
+             */
+            granularity: "hour" | "day";
+            /** Buckets */
+            buckets: components["schemas"]["UsageBucket"][];
+            /** Totals */
+            totals: {
+                [key: string]: number;
+            };
+            /** Durations */
+            durations?: {
+                [key: string]: components["schemas"]["UsageDuration"];
+            };
+            /** By Product */
+            by_product?: components["schemas"]["UsageProductTotals"][];
+        };
+        /** ValidationError */
+        ValidationError: {
+            /** Location */
+            loc: (string | number)[];
+            /** Message */
+            msg: string;
+            /** Error Type */
+            type: string;
+            /** Input */
+            input?: unknown;
+            /** Context */
+            ctx?: Record<string, never>;
+        };
+        /**
+         * WarningKind
+         * @description The customer-facing warnings derived at read time (D21) - `lib/warnings.py` is the
+         *     rule, this is its vocabulary on the wire.
+         * @enum {string}
+         */
+        WarningKind: "cut" | "generation" | "missing" | "lighting" | "model_failed" | "model_risk";
+        /** WebhookDeliveryListResponse */
+        WebhookDeliveryListResponse: {
+            /** Data */
+            data: components["schemas"]["WebhookDeliveryResponse"][];
+            /** Limit */
+            limit: number;
+            /** Offset */
+            offset: number;
+        };
+        /** WebhookDeliveryResponse */
+        WebhookDeliveryResponse: {
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            /**
+             * Endpoint Id
+             * Format: uuid
+             */
+            endpoint_id: string;
+            event_type: components["schemas"]["WebhookEventType"];
+            /**
+             * Event Id
+             * Format: uuid
+             */
+            event_id: string;
+            /** Http Status */
+            http_status?: number | null;
+            /** Attempts */
+            attempts: number;
+            /** Succeeded At */
+            succeeded_at?: string | null;
+            /** Last Attempt At */
+            last_attempt_at?: string | null;
+            /** Last Error */
+            last_error?: string | null;
+            /** Payload Json */
+            payload_json?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        /** WebhookEndpointCreateRequest */
+        WebhookEndpointCreateRequest: {
+            /** Url */
+            url: string;
+            /** Events */
+            events: components["schemas"]["WebhookEventType"][];
+            /** Description */
+            description?: string | null;
+            /** Org Id */
+            org_id?: string | null;
+            /** Project Id */
+            project_id?: string | null;
+        };
+        /**
+         * WebhookEndpointCreateResponse
+         * @description 201. signing_secret returned on create; also readable later by org members
+         *     (DB stores it plaintext; dashboard shows it). PROPOSED: keep parity with current
+         *     behavior rather than show-once.
+         */
+        WebhookEndpointCreateResponse: {
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            /** Org Id */
+            org_id?: string | null;
+            /** Project Id */
+            project_id?: string | null;
+            /** Url */
+            url: string;
+            /** Description */
+            description?: string | null;
+            /** Events */
+            events: components["schemas"]["WebhookEventType"][];
+            /** Enabled */
+            enabled: boolean;
+            /**
+             * Created At
+             * Format: date-time
+             */
+            created_at: string;
+            /**
+             * Updated At
+             * Format: date-time
+             */
+            updated_at: string;
+            /** Signing Secret */
+            signing_secret: string;
+        };
+        /** WebhookEndpointListResponse */
+        WebhookEndpointListResponse: {
+            /** Data */
+            data: components["schemas"]["WebhookEndpointResponse"][];
+        };
+        /** WebhookEndpointResponse */
+        WebhookEndpointResponse: {
+            /**
+             * Id
+             * Format: uuid
+             */
+            id: string;
+            /** Org Id */
+            org_id?: string | null;
+            /** Project Id */
+            project_id?: string | null;
+            /** Url */
+            url: string;
+            /** Description */
+            description?: string | null;
+            /** Events */
+            events: components["schemas"]["WebhookEventType"][];
+            /** Enabled */
+            enabled: boolean;
+            /**
+             * Created At
+             * Format: date-time
+             */
+            created_at: string;
+            /**
+             * Updated At
+             * Format: date-time
+             */
+            updated_at: string;
+        };
+        /** WebhookEndpointUpdateRequest */
+        WebhookEndpointUpdateRequest: {
+            /** Url */
+            url?: string | null;
+            /** Events */
+            events?: components["schemas"]["WebhookEventType"][] | null;
+            /** Description */
+            description?: string | null;
+            /** Enabled */
+            enabled?: boolean | null;
+        };
+        /**
+         * WebhookEventType
+         * @description webhook_endpoints.events / webhook_deliveries.event_type (unconstrained text).
+         *
+         *     App-enforced vocabulary (docs + dashboard). Both prod tables are empty, so v2 can
+         *     rename/constrain freely with zero migration risk.
+         * @enum {string}
+         */
+        WebhookEventType: "model.ready" | "model.failed" | "product.completed" | "product.failed";
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
 }
-declare class RateLimitError extends ViewriumError {
-    readonly retryAfter: number | undefined;
-    constructor(message: string, options?: {
-        statusCode?: number;
-        responseBody?: unknown;
-        retryAfter?: number;
-    });
-}
-declare class APIError extends ViewriumError {
-    constructor(message: string, options?: {
-        statusCode?: number;
-        responseBody?: unknown;
-    });
+interface operations {
+    list_products_v1_products_get: {
+        parameters: {
+            query?: {
+                limit?: number;
+                offset?: number;
+                org_id?: string | null;
+                scope?: components["schemas"]["ListScope"];
+                q?: string | null;
+                custom_id?: string | null;
+                status?: components["schemas"]["DisplayStatus"][] | null;
+                tag?: string[] | null;
+                tag_match?: components["schemas"]["TagMatch"];
+                created_after?: string | null;
+                created_before?: string | null;
+                created_by?: string[] | null;
+                has_comments?: boolean | null;
+                has_warnings?: boolean | null;
+                form?: string[] | null;
+                source_type?: components["schemas"]["SourceType"][] | null;
+                sort?: components["schemas"]["ProductSortField"];
+                order?: components["schemas"]["SortOrder"];
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProductListResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    create_product_v1_products_post: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ProductCreateRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProductParkedResponse"];
+                };
+            };
+            /** @description Accepted */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProductResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    batch_delete_products_v1_products_delete: {
+        parameters: {
+            query: {
+                ids: string[];
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProductBatchResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    publish_products_v1_products_publish_post: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ProductPublishRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProductBatchResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    export_products_v1_products_export_get: {
+        parameters: {
+            query?: {
+                org_id?: string | null;
+                scope?: components["schemas"]["ListScope"];
+                q?: string | null;
+                custom_id?: string | null;
+                status?: components["schemas"]["DisplayStatus"][] | null;
+                tag?: string[] | null;
+                tag_match?: components["schemas"]["TagMatch"];
+                created_after?: string | null;
+                created_before?: string | null;
+                created_by?: string[] | null;
+                has_comments?: boolean | null;
+                has_warnings?: boolean | null;
+                form?: string[] | null;
+                source_type?: components["schemas"]["SourceType"][] | null;
+                ids?: string[] | null;
+                image_review_status?: components["schemas"]["ReviewStatus"][];
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The archive */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": unknown;
+                    "application/zip": unknown;
+                };
+            };
+            /** @description Accepted */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProductExportQueuedResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    list_product_tags_v1_products_tags_get: {
+        parameters: {
+            query?: {
+                org_id?: string | null;
+                scope?: components["schemas"]["ListScope"];
+                q?: string | null;
+                custom_id?: string | null;
+                status?: components["schemas"]["DisplayStatus"][] | null;
+                tag?: string[] | null;
+                tag_match?: components["schemas"]["TagMatch"];
+                created_after?: string | null;
+                created_before?: string | null;
+                created_by?: string[] | null;
+                has_comments?: boolean | null;
+                has_warnings?: boolean | null;
+                form?: string[] | null;
+                source_type?: components["schemas"]["SourceType"][] | null;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TagsResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    get_product_v1_products__id__get: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProductResponse"] | components["schemas"]["PublicProductResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    delete_product_v1_products__id__delete: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    update_product_v1_products__id__patch: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ProductUpdateRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProductResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    order_product_v1_products__id__order_post: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ProductOrderRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProductOrderParkedResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    review_product_v1_products__id__review_post: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ProductReviewRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProductReviewResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    update_product_image_v1_products__id__images__image_id__patch: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+                image_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ProductImagePatch"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProductImageResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    rescale_product_model_v1_products__id__model_rescale_post: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ProductRescaleRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProductResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    create_product_ticket_v1_products__id__tickets_post: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["TicketRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TicketResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    update_product_model_v1_products__id__model_patch: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ProductModelPatch"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProductModelResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    list_api_keys_v1_api_keys_get: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiKeyListResponse"];
+                };
+            };
+        };
+    };
+    create_api_key_v1_api_keys_post: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ApiKeyCreateRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiKeyCreateResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    revoke_api_key_v1_api_keys__id__delete: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    get_usage_v1_usage_get: {
+        parameters: {
+            query?: {
+                start?: string | null;
+                end?: string | null;
+                org_id?: string | null;
+                scope?: components["schemas"]["ListScope"];
+                product_id?: string | null;
+                project_id?: string | null;
+                model_id?: string | null;
+                event_type?: components["schemas"]["UsageEventType"] | null;
+                granularity?: "hour" | "day";
+                include_internal?: boolean;
+                group_by?: "product" | null;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["UsageResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    ingest_beacon_v1_beacon_post: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["BeaconRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    list_webhook_endpoints_v1_webhooks_get: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebhookEndpointListResponse"];
+                };
+            };
+        };
+    };
+    create_webhook_endpoint_v1_webhooks_post: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["WebhookEndpointCreateRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebhookEndpointCreateResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    get_webhook_endpoint_v1_webhooks__id__get: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebhookEndpointResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    delete_webhook_endpoint_v1_webhooks__id__delete: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    update_webhook_endpoint_v1_webhooks__id__patch: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["WebhookEndpointUpdateRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebhookEndpointResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    list_webhook_deliveries_v1_webhooks__id__deliveries_get: {
+        parameters: {
+            query?: {
+                limit?: number;
+                offset?: number;
+            };
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebhookDeliveryListResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    list_projects_v1_projects_get: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProjectListResponse"];
+                };
+            };
+        };
+    };
+    get_project_v1_projects__id__get: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProjectResponse"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    health_v1_health_get: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HealthResponse"];
+                };
+            };
+        };
+    };
 }
 
 /**
- * Public types for the Viewrium SDK.
+ * Typed errors for the Viewrium SDK.
  *
- * Response shapes mirror the backend JSON contract (snake_case). Request
- * param interfaces use camelCase; the SDK maps camelCase → snake_case on
- * the wire.
+ * The API returns one error envelope: `{ "error": { code, message, details } }`.
+ * Non-2xx responses are parsed into a `ViewriumError` subclass keyed by HTTP status;
+ * consumers branch with `instanceof`.
  */
-interface ViewriumOptions {
-    /** Override the API key. Defaults to the value passed to `new Viewrium(...)`. */
-    apiKey?: string;
-    /** Base URL. Defaults to `process.env.VIEWRIUM_API_BASE` or `https://api.viewrium.com`. */
-    apiBase?: string;
-    /** Per-request timeout in milliseconds. Default 60_000. */
-    timeoutMs?: number;
-    /** Retries on 429 / 5xx. Default 3. */
-    maxRetries?: number;
-    /** Override `globalThis.fetch` (test seams / custom transports). */
-    fetch?: typeof fetch;
-}
-type SizeUnit = "cm" | "in";
-type ModelStatus = "uploading" | "processing" | "queueing" | "successful" | "failed" | "expired";
-type SourceType = "scan" | "upload" | "image";
-type UsageEventType = "generation.created" | "generation.completed" | "generation.failed" | "view" | "ar_enter" | "ar_session_ended";
-interface Model {
-    id: string;
-    project_id: string | null;
-    custom_id: string | null;
-    title: string | null;
-    description: string | null;
-    price: number | null;
-    currency: string | null;
-    status: ModelStatus;
-    source_type: SourceType | null;
-    model_url: string | null;
-    thumbnail_url: string | null;
-    height: number | null;
-    width: number | null;
-    depth: number | null;
-    scale_factor: number | null;
-    tags: string[];
-    metadata: Record<string, unknown>;
-    display_enabled: boolean;
-    created_at: string;
-    completed_at: string | null;
-    [key: string]: unknown;
-}
-interface ModelListResponse {
-    data: Model[];
-    limit: number;
-    offset: number;
+interface ViewriumErrorOptions {
+    status?: number | null;
+    code?: string;
+    details?: unknown;
+    cause?: unknown;
 }
-interface ModelEvent {
-    id: string;
-    event_type: UsageEventType;
-    timestamp: string;
-    metadata: Record<string, unknown>;
-}
-interface ModelEventListResponse {
-    data: ModelEvent[];
-    limit: number;
-    offset: number;
-}
-interface DeletedResponse {
-    id: string;
-    deleted: true;
+declare class ViewriumError extends Error {
+    /** HTTP status, or `null` for transport/connection failures. */
+    readonly status: number | null;
+    /** Machine-readable code from the error envelope. */
+    readonly code: string;
+    /** Optional structured details from the error envelope. */
+    readonly details: unknown;
+    constructor(message: string, options?: ViewriumErrorOptions);
 }
-interface ApiKey {
-    id: string;
-    name: string | null;
-    key_type: "secret" | "publishable";
-    key_prefix: string;
-    last_used_at: string | null;
-    revoked_at: string | null;
-    created_at: string;
+/** 400 - malformed request. */
+declare class BadRequestError extends ViewriumError {
 }
-/** Returned by `apiKeys.create` - `key` is plaintext, shown once. */
-interface ApiKeyWithSecret extends Omit<ApiKey, "last_used_at" | "revoked_at"> {
-    key: string;
+/** 401 - missing or invalid API key. */
+declare class AuthenticationError extends ViewriumError {
 }
-interface ApiKeyListResponse {
-    data: ApiKey[];
+/**
+ * 402 - the organization's plan does not allow this: no plan, a used free trial, a failed payment,
+ * or past the plan's active-product cap. `details.reason` says which.
+ */
+declare class PaymentRequiredError extends ViewriumError {
 }
-interface RevokedResponse {
-    id: string;
-    revoked: true;
+/** 403 - the key is valid but not allowed (scope, origin, or role). */
+declare class PermissionError extends ViewriumError {
 }
-interface UsageSummary {
-    org_id: string;
-    plan_tier: "free" | "pro" | "enterprise";
-    since: string | null;
-    until: string | null;
-    counts: Partial<Record<UsageEventType, number>>;
+/** 404 - no such resource. */
+declare class NotFoundError extends ViewriumError {
 }
-interface TagSummary {
-    tag: string;
-    count: number;
+/** 409 - conflict (e.g. duplicate `custom_id`, model not in a rescalable state). */
+declare class ConflictError extends ViewriumError {
 }
-interface TagListResponse {
-    data: TagSummary[];
+/** 422 - request failed validation. */
+declare class UnprocessableEntityError extends ViewriumError {
 }
-interface ModelCreateParams {
-    customId?: string;
-    title?: string;
-    description?: string;
-    /** Provide one of `images` (URL list) or `sourceUrl` - not both. */
-    images?: string[];
-    /** Product page URL. Server extracts candidate images. */
-    sourceUrl?: string;
-    height?: number;
-    sizeUnit?: SizeUnit;
-    tags?: string[];
-    price?: number;
-    currency?: string;
-    metadata?: Record<string, unknown>;
-    displayEnabled?: boolean;
+/** 429 - rate limited, or not enough credits (`code: "quota_exceeded"`, `details.shortfall_credits`). */
+declare class RateLimitError extends ViewriumError {
 }
-interface ModelCreateFromImagesParams {
-    title?: string;
-    customId?: string;
-    description?: string;
-    height?: number;
-    sizeUnit?: SizeUnit;
-    tags?: string[];
-    displayEnabled?: boolean;
+/** 5xx - the API failed to handle the request. */
+declare class ServerError extends ViewriumError {
 }
-interface ModelCreateFromVideoParams extends ModelCreateFromImagesParams {
+/** The request never reached the API (DNS/TLS/offline/abort). */
+declare class ConnectionError extends ViewriumError {
 }
-interface ModelUpdateParams {
-    customId?: string;
-    title?: string;
-    description?: string;
-    price?: number;
-    currency?: string;
-    height?: number;
-    sizeUnit?: SizeUnit;
-    tags?: string[];
-    metadata?: Record<string, unknown>;
-    displayEnabled?: boolean;
+interface ApiErrorPayload {
+    code: string;
+    message: string;
+    details?: unknown;
 }
-interface ModelListParams {
-    tag?: string;
-    tags?: string[] | string;
-    customId?: string;
-    status?: ModelStatus;
-    limit?: number;
-    offset?: number;
+/** Build the right `ViewriumError` subclass for an HTTP status + parsed envelope. */
+declare function createApiError(status: number, payload: ApiErrorPayload): ViewriumError;
+
+type JsonContent<T> = T extends {
+    content: {
+        "application/json": infer B;
+    };
+} ? B : never;
+/** GET /v1/products/{id} resolves to one of two shapes by principal: the full product for a
+ *  session or `sk_` key, the allow-listed public projection for a `pk_` key. */
+type ProductGetResult = JsonContent<paths["/v1/products/{id}"]["get"]["responses"][200]>;
+/** A product with its assets (`sk_` view). */
+type Product = Extract<ProductGetResult, {
+    org_id: string;
+}>;
+/** The `pk_` view of a published product: id, title, thumbnail_url, model_status, wall_mounted. The model
+ *  file itself is reached through `products.createTicket`. */
+type PublicProduct = Exclude<ProductGetResult, {
+    org_id: string;
+}>;
+type ProductList = JsonContent<paths["/v1/products"]["get"]["responses"][200]>;
+/** A catalog row - the product plus what its card needs, with no nested assets. */
+type ProductSummary = ProductList["data"][number];
+type ProductListParams = NonNullable<paths["/v1/products"]["get"]["parameters"]["query"]>;
+type ProductCreateParams = JsonContent<paths["/v1/products"]["post"]["requestBody"]>;
+/** POST /v1/products 200 - the gate parked; resume by POSTing `resume_token`. */
+type ProductParked = JsonContent<paths["/v1/products"]["post"]["responses"][200]>;
+/** One page position of a parked plan. Both park shapes carry the same row type. */
+type PlannedView = NonNullable<ProductParked["plan"]>[number];
+/** describe's structured read of the product (D25), with its verbatim reasons. */
+type GateFlags = ProductParked["flags"];
+/** The models layer's verdict: whether a model is allowed, what blocks it, and the views it
+ *  would be built from - including `unseen_views`, the invented ones. */
+type ModelPlan = ProductParked["model"];
+/** The priced bundle, in credits (1 credit = $0.50): 1 per deliverable image, a flat 10 for a model. */
+type ProductCost = ProductParked["cost"];
+/** POST /v1/products 202 - a committed product whose run has started. */
+type ProductCreated = JsonContent<paths["/v1/products"]["post"]["responses"][202]>;
+/** POST /v1/products resolves to one of the two (discriminate on `status === "parked"`). */
+type ProductCreateResult = ProductParked | ProductCreated;
+type ProductUpdateParams = JsonContent<NonNullable<paths["/v1/products/{id}"]["patch"]["requestBody"]>>;
+type ProductBatchResult = JsonContent<paths["/v1/products"]["delete"]["responses"][200]>;
+type ProductPublishParams = JsonContent<paths["/v1/products/publish"]["post"]["requestBody"]>;
+type Tags = JsonContent<paths["/v1/products/tags"]["get"]["responses"][200]>;
+type TagsParams = NonNullable<paths["/v1/products/tags"]["get"]["parameters"]["query"]>;
+/** POST /v1/products/{id}/review - the write-behind flush (image + model decisions, the
+ *  product's user-set status). It records decisions only. */
+type ProductReviewParams = JsonContent<paths["/v1/products/{id}/review"]["post"]["requestBody"]>;
+type ProductReviewResult = JsonContent<paths["/v1/products/{id}/review"]["post"]["responses"][200]>;
+type ProductImagePatchParams = JsonContent<NonNullable<paths["/v1/products/{id}/images/{image_id}"]["patch"]["requestBody"]>>;
+type ProductImage = JsonContent<paths["/v1/products/{id}/images/{image_id}"]["patch"]["responses"][200]>;
+type ProductModelPatchParams = JsonContent<NonNullable<paths["/v1/products/{id}/model"]["patch"]["requestBody"]>>;
+type ProductModel = JsonContent<paths["/v1/products/{id}/model"]["patch"]["responses"][200]>;
+type ProductRescaleParams = JsonContent<paths["/v1/products/{id}/model/rescale"]["post"]["requestBody"]>;
+/** POST /v1/products/{id}/tickets - `{ kind: "view" | "ar", origin? }`. */
+type TicketParams = JsonContent<paths["/v1/products/{id}/tickets"]["post"]["requestBody"]>;
+/** A single-use model URL: `{ url, kind, expires_at }`. */
+type Ticket = JsonContent<paths["/v1/products/{id}/tickets"]["post"]["responses"][200]>;
+/** POST /v1/products/{id}/order - the missing half; parks like a create, commits through
+ *  `products.create({ resume_token })`. */
+type ProductOrderParams = JsonContent<paths["/v1/products/{id}/order"]["post"]["requestBody"]>;
+type ProductOrderParked = JsonContent<paths["/v1/products/{id}/order"]["post"]["responses"][200]>;
+type ProductExportParams = NonNullable<paths["/v1/products/export"]["get"]["parameters"]["query"]>;
+/** 202 from the export: the images are being finished in the background and a download link
+ *  is emailed; the same request streams the ZIP once they are done. */
+type ProductExportQueued = JsonContent<paths["/v1/products/export"]["get"]["responses"][202]>;
+type ApiKeyList = JsonContent<paths["/v1/api_keys"]["get"]["responses"][200]>;
+type ApiKeyCreateParams = JsonContent<paths["/v1/api_keys"]["post"]["requestBody"]>;
+type ApiKeyCreated = JsonContent<paths["/v1/api_keys"]["post"]["responses"][201]>;
+type Usage = JsonContent<paths["/v1/usage"]["get"]["responses"][200]>;
+type UsageParams = NonNullable<paths["/v1/usage"]["get"]["parameters"]["query"]>;
+/** One `group_by: "product"` row: a product's counts over the window, with its title. */
+type UsageProductTotals = NonNullable<Usage["by_product"]>[number];
+type WebhookEndpoint = JsonContent<paths["/v1/webhooks/{id}"]["get"]["responses"][200]>;
+type WebhookEndpointList = JsonContent<paths["/v1/webhooks"]["get"]["responses"][200]>;
+type WebhookEndpointCreateParams = JsonContent<paths["/v1/webhooks"]["post"]["requestBody"]>;
+type WebhookEndpointCreated = JsonContent<paths["/v1/webhooks"]["post"]["responses"][201]>;
+type WebhookEndpointUpdateParams = JsonContent<NonNullable<paths["/v1/webhooks/{id}"]["patch"]["requestBody"]>>;
+type WebhookDeliveryList = JsonContent<paths["/v1/webhooks/{id}/deliveries"]["get"]["responses"][200]>;
+type WebhookDeliveriesParams = NonNullable<paths["/v1/webhooks/{id}/deliveries"]["get"]["parameters"]["query"]>;
+type Project = JsonContent<paths["/v1/projects/{id}"]["get"]["responses"][200]>;
+type ProjectList = JsonContent<paths["/v1/projects"]["get"]["responses"][200]>;
+type BeaconParams = JsonContent<paths["/v1/beacon"]["post"]["requestBody"]>;
+type Health = JsonContent<paths["/v1/health"]["get"]["responses"][200]>;
+type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
+interface ViewriumOptions {
+    /** `sk_` secret key (server) or `pk_` publishable key (browser). */
+    apiKey: string;
+    /** API origin; defaults to `https://api.viewrium.com`. Trailing slash is stripped. */
+    baseUrl?: string;
+    /** Injectable fetch (tests, custom agents). Defaults to `globalThis.fetch`. */
+    fetch?: FetchLike;
 }
-interface ModelListEventsParams {
-    limit?: number;
-    offset?: number;
+type QueryValue = string | number | boolean | readonly string[] | null | undefined;
+type QueryParams = Record<string, QueryValue>;
+interface RequestOptions {
+    query?: QueryParams;
+    body?: unknown;
 }
-interface ApiKeyCreateParams {
-    name?: string;
+type RequestFn = <T>(method: string, path: string, options?: RequestOptions) => Promise<T>;
+/** The escape hatch for the one route that answers bytes rather than JSON (the export ZIP) -
+ *  or, on a 202, JSON after all. */
+type BlobRequestFn = (method: string, path: string, options?: RequestOptions) => Promise<Blob | ProductExportQueued>;
+declare function createProducts(request: RequestFn, requestBlob: BlobRequestFn): {
     /**
-     * Type of key to create. Defaults to `"secret"`.
-     * - `"secret"` (sk_*): server-only, authenticates /v1/* calls.
-     * - `"publishable"` (pk_*): client-safe, used by the embed tag. Origin
-     *   restrictions inherit from the project's allowed_domains.
+     * POST /v1/products - the single generation entrypoint. Supply exactly one source
+     * (`image_paths` | `image_urls` | `video_url` | `source_url` | `model_url` |
+     * `resume_token`). A fresh request ALWAYS parks (200, `status === "parked"`, nothing
+     * written): the plan, the model verdict and the price come back inside `resume_token`,
+     * which you POST back to commit (202, `ProductCreated`). A `model_url` commits at once.
      */
-    keyType?: "secret" | "publishable";
-}
-interface UsageRetrieveParams {
-    /** ISO 8601 lower bound (inclusive). */
-    since?: string;
-    /** ISO 8601 upper bound (inclusive). */
-    until?: string;
-}
-/**
- * A file passed to multipart endpoints.
- *
- * - In Node: a path string (SDK reads it via `fs.readFile`) or a `Blob`/`File`.
- * - In browsers / edge runtimes: `Blob` / `File` (native).
- * - Anywhere: a `{ data, filename, contentType? }` record with raw bytes.
- */
-type FileInput = string | Blob | {
-    data: Uint8Array | ArrayBuffer | Blob;
-    filename?: string;
-    contentType?: string;
+    create: (params: ProductCreateParams) => Promise<ProductCreateResult>;
+    /**
+     * GET /v1/products - the catalog: one org (`org_id`, or the caller's only org), or
+     * `scope: "all"` for every org an agency member or staff reaches. Filters AND together.
+     */
+    list: (params?: ProductListParams) => Promise<{
+        data: components["schemas"]["ProductSummary"][];
+        total: number;
+        limit: number;
+        offset: number;
+    }>;
+    /** GET /v1/products/{id} - the product with its assets (a `pk_` key gets `PublicProduct`). */
+    retrieve: (id: string) => Promise<{
+        id: string;
+        org_id: string;
+        title: string;
+        custom_id?: string | null;
+        tags?: string[];
+        status: components["schemas"]["ProductStatus"];
+        display_status: components["schemas"]["DisplayStatus"];
+        published: boolean;
+        form?: string | null;
+        source_type?: components["schemas"]["SourceType"] | null;
+        price?: number | null;
+        currency?: string | null;
+        height?: number | null;
+        width?: number | null;
+        depth?: number | null;
+        display_unit?: components["schemas"]["DimensionUnit"] | null;
+        images_ordered: boolean;
+        thumbnail_url?: string | null;
+        has_warnings: boolean;
+        warning_count: number;
+        comment_count: number;
+        image_count: number;
+        model_status?: components["schemas"]["AssetStatus"] | null;
+        owner?: components["schemas"]["ProductOwner"] | null;
+        created_at: string;
+        updated_at?: string | null;
+        description?: string | null;
+        wall_mounted: boolean;
+        product_type?: string | null;
+        material_words?: string | null;
+        transparent: boolean;
+        metadata?: {
+            [key: string]: unknown;
+        };
+        sources?: components["schemas"]["ProductSourceResponse"][];
+        images?: components["schemas"]["ProductImageResponse"][];
+        model?: components["schemas"]["ProductModelResponse"] | null;
+        warnings?: components["schemas"]["ProductWarning"][];
+        open_request_count: number;
+    }>;
+    /**
+     * PATCH /v1/products/{id} - the customer's fields, the user-set status and the publish
+     * toggle. 409 on a `custom_id` another product in the org already holds.
+     */
+    update: (id: string, params: ProductUpdateParams) => Promise<{
+        id: string;
+        org_id: string;
+        title: string;
+        custom_id?: string | null;
+        tags?: string[];
+        status: components["schemas"]["ProductStatus"];
+        display_status: components["schemas"]["DisplayStatus"];
+        published: boolean;
+        form?: string | null;
+        source_type?: components["schemas"]["SourceType"] | null;
+        price?: number | null;
+        currency?: string | null;
+        height?: number | null;
+        width?: number | null;
+        depth?: number | null;
+        display_unit?: components["schemas"]["DimensionUnit"] | null;
+        images_ordered: boolean;
+        thumbnail_url?: string | null;
+        has_warnings: boolean;
+        warning_count: number;
+        comment_count: number;
+        image_count: number;
+        model_status?: components["schemas"]["AssetStatus"] | null;
+        owner?: components["schemas"]["ProductOwner"] | null;
+        created_at: string;
+        updated_at?: string | null;
+        description?: string | null;
+        wall_mounted: boolean;
+        product_type?: string | null;
+        material_words?: string | null;
+        transparent: boolean;
+        metadata?: {
+            [key: string]: unknown;
+        };
+        sources?: components["schemas"]["ProductSourceResponse"][];
+        images?: components["schemas"]["ProductImageResponse"][];
+        model?: components["schemas"]["ProductModelResponse"] | null;
+        warnings?: components["schemas"]["ProductWarning"][];
+        open_request_count: number;
+    }>;
+    /** DELETE /v1/products/{id} */
+    delete: (id: string) => Promise<void>;
+    /** DELETE /v1/products?ids=... - per-id affected/not_found/forbidden buckets. */
+    batchDelete: (ids: readonly string[]) => Promise<{
+        affected: string[];
+        not_found: string[];
+        forbidden: string[];
+    }>;
+    /** POST /v1/products/publish - the bulk publish toggle; one product toggles through `update`. */
+    publish: (params: ProductPublishParams) => Promise<{
+        affected: string[];
+        not_found: string[];
+        forbidden: string[];
+    }>;
+    /** GET /v1/products/tags - distinct tags across the same scope the list takes. */
+    tags: (params?: TagsParams) => Promise<{
+        data: components["schemas"]["TagCount"][];
+    }>;
+    /** POST /v1/products/{id}/review - the review flush: image and model decisions plus the
+     *  product's user-set status, validated together and applied in order. */
+    review: (id: string, params: ProductReviewParams) => Promise<{
+        product_id: string;
+        applied: number;
+        display_status: components["schemas"]["DisplayStatus"];
+    }>;
+    /** PATCH /v1/products/{id}/images/{image_id} - one image's decision and overrides. */
+    updateImage: (id: string, imageId: string, params: ProductImagePatchParams) => Promise<{
+        id: string;
+        view: string;
+        kind: "wanted" | "extra";
+        stands_for: string;
+        status: components["schemas"]["AssetStatus"];
+        skip_reason?: string | null;
+        route?: ("reuse" | "edit" | "generate") | null;
+        source?: ("photograph" | "edited" | "generated") | null;
+        evidence?: string | null;
+        azimuth?: string | null;
+        tilt?: string | null;
+        source_photo_id?: string | null;
+        attempts: number;
+        flagged: boolean;
+        cut_flagged: boolean;
+        cut_problems?: string | null;
+        review_status: components["schemas"]["ReviewStatus"];
+        filename: string;
+        alt_text: string;
+        filename_override?: string | null;
+        alt_override?: string | null;
+        shadow_override?: components["schemas"]["ShadowOverride"] | null;
+        background_override?: number[] | null;
+        frame_scale?: number | null;
+        contact_regions?: number[][];
+        raw_url?: string | null;
+        cutout_url?: string | null;
+        warnings?: components["schemas"]["ProductWarning"][];
+        created_at: string;
+        updated_at?: string | null;
+    }>;
+    /** PATCH /v1/products/{id}/model - the model's review decision. */
+    updateModel: (id: string, params: ProductModelPatchParams) => Promise<{
+        id: string;
+        status: components["schemas"]["AssetStatus"];
+        review_status: components["schemas"]["ReviewStatus"];
+        thumbnail_url?: string | null;
+        scale_factor?: number | null;
+        width_axis?: ("x" | "z") | null;
+        flags?: components["schemas"]["GateFlags"];
+        warnings?: components["schemas"]["ProductWarning"][];
+        created_at: string;
+        completed_at?: string | null;
+    }>;
+    /**
+     * POST /v1/products/{id}/model/rescale - re-apply real-world scale to the GLB in place.
+     * Every supplied axis is applied to the geometry; `unit` covers them (omitted = cm) and is
+     * remembered as the product's `display_unit`. The result carries the ACHIEVED dimensions.
+     */
+    rescale: (id: string, params: ProductRescaleParams) => Promise<{
+        id: string;
+        org_id: string;
+        title: string;
+        custom_id?: string | null;
+        tags?: string[];
+        status: components["schemas"]["ProductStatus"];
+        display_status: components["schemas"]["DisplayStatus"];
+        published: boolean;
+        form?: string | null;
+        source_type?: components["schemas"]["SourceType"] | null;
+        price?: number | null;
+        currency?: string | null;
+        height?: number | null;
+        width?: number | null;
+        depth?: number | null;
+        display_unit?: components["schemas"]["DimensionUnit"] | null;
+        images_ordered: boolean;
+        thumbnail_url?: string | null;
+        has_warnings: boolean;
+        warning_count: number;
+        comment_count: number;
+        image_count: number;
+        model_status?: components["schemas"]["AssetStatus"] | null;
+        owner?: components["schemas"]["ProductOwner"] | null;
+        created_at: string;
+        updated_at?: string | null;
+        description?: string | null;
+        wall_mounted: boolean;
+        product_type?: string | null;
+        material_words?: string | null;
+        transparent: boolean;
+        metadata?: {
+            [key: string]: unknown;
+        };
+        sources?: components["schemas"]["ProductSourceResponse"][];
+        images?: components["schemas"]["ProductImageResponse"][];
+        model?: components["schemas"]["ProductModelResponse"] | null;
+        warnings?: components["schemas"]["ProductWarning"][];
+        open_request_count: number;
+    }>;
+    /**
+     * POST /v1/products/{id}/tickets - a single-use URL for the product's 3D file, the ONLY way
+     * to its bytes (no response carries a model file URL). It works once, until `expires_at`
+     * (60 s for `view`, 30 s for `ar`); a `view` ticket only from its bound origin. With a `pk_`
+     * key the product must be published and the ticket is bound to the page's Origin; with an
+     * `sk_` key pass `origin` (the page that will load the model, one of your allowed domains).
+     */
+    createTicket: (id: string, params: TicketParams) => Promise<{
+        url: string;
+        kind: components["schemas"]["TicketKind"];
+        expires_at: string;
+    }>;
+    /** POST /v1/products/{id}/order - park the missing half (images or a model); commit the
+     *  returned `resume_token` with `create`. */
+    order: (id: string, params: ProductOrderParams) => Promise<{
+        status: "parked";
+        resume_token: string;
+        expires_at: string;
+        order: components["schemas"]["ProductOrder"];
+        flags: components["schemas"]["GateFlags"];
+        plan?: components["schemas"]["PlannedView"][];
+        model: components["schemas"]["ModelPlanResponse"];
+        cost: components["schemas"]["ProductCost"];
+        warnings?: string[];
+        generate_unseen: boolean;
+        force_model: boolean;
+    }>;
+    /** GET /v1/products/export - a ZIP of finished images (never the 3D model), resolved as a
+     *  `Blob`; or `ProductExportQueued` (202) when the images are being finished in the
+     *  background and a download link is emailed - repeat the request later to stream it. */
+    export: (params?: ProductExportParams) => Promise<{
+        status: "queued";
+        products: number;
+        images: number;
+        to_finish: number;
+        notify_email?: string | null;
+    } | Blob>;
+};
+declare function createApiKeys(request: RequestFn): {
+    /** GET /v1/api_keys */
+    list: () => Promise<{
+        data: components["schemas"]["ApiKeyResponse"][];
+    }>;
+    /** POST /v1/api_keys - the full key is returned exactly once. */
+    create: (params: ApiKeyCreateParams) => Promise<{
+        id: string;
+        org_id?: string | null;
+        project_id?: string | null;
+        key_type: components["schemas"] /** PATCH /v1/webhooks/{id} */["KeyType"];
+        key_prefix: string;
+        name?: string | null;
+        scopes: string[];
+        last_used_at?: string | null;
+        revoked_at?: string | null;
+        created_at: string;
+        key: string;
+    }>;
+    /** DELETE /v1/api_keys/{id} - soft revoke. */
+    revoke: (id: string) => Promise<void>;
+};
+declare function createUsage(request: RequestFn): {
+    /** GET /v1/usage - buckets and totals over the window; `group_by: "product"` adds the
+     *  window's best-performing products in `by_product`. */
+    get: (params?: UsageParams) => Promise<{
+        start: string;
+        end: string;
+        granularity: "hour" | "day";
+        buckets: components["schemas"]["UsageBucket"][];
+        totals: {
+            [key: string]: number;
+        };
+        durations?: {
+            [key: string]: components["schemas"]["UsageDuration"];
+        };
+        by_product?: components["schemas"]["UsageProductTotals"][];
+    }>;
+};
+declare function createWebhooks(request: RequestFn): {
+    /** GET /v1/webhooks */
+    list: () => Promise<{
+        data: components["schemas"]["WebhookEndpointResponse"][];
+    }>;
+    /** POST /v1/webhooks - includes the signing secret. */
+    create: (params: WebhookEndpointCreateParams) => Promise<{
+        id: string;
+        org_id?: string | null;
+        project_id?: string | null;
+        url: string;
+        description?: string | null;
+        events: components["schemas"]["WebhookEventType"][];
+        enabled: boolean;
+        created_at: string;
+        updated_at: string;
+        signing_secret: string;
+    }>;
+    /** GET /v1/webhooks/{id} */
+    retrieve: (id: string) => Promise<{
+        id: string;
+        org_id?: string | null;
+        project_id?: string | null;
+        url: string;
+        description?: string | null;
+        events: components["schemas"]["WebhookEventType"][];
+        enabled: boolean;
+        created_at: string;
+        updated_at: string;
+    }>;
+    /** PATCH /v1/webhooks/{id} */
+    update: (id: string, params: WebhookEndpointUpdateParams) => Promise<{
+        id: string;
+        org_id?: string | null;
+        project_id?: string | null;
+        url: string;
+        description?: string | null;
+        events: components["schemas"]["WebhookEventType"][];
+        enabled: boolean;
+        created_at: string;
+        updated_at: string;
+    }>;
+    /** DELETE /v1/webhooks/{id} */
+    delete: (id: string) => Promise<void>;
+    /** GET /v1/webhooks/{id}/deliveries */
+    listDeliveries: (id: string, params?: WebhookDeliveriesParams) => Promise<{
+        data: components["schemas"]["WebhookDeliveryResponse"][];
+        limit: number;
+        offset: number;
+    }>;
+};
+declare function createProjects(request: RequestFn): {
+    /** GET /v1/projects */
+    list: () => Promise<{
+        data: components["schemas"]["ProjectResponse"][];
+    }>;
+    /** GET /v1/projects/{id} */
+    retrieve: (id: string) => Promise<{
+        id: string;
+        org_id: string;
+        name: string;
+        allowed_domains: string[];
+        always_generate: boolean;
+        created_at: string;
+    }>;
+};
+declare function createBeacon(request: RequestFn): {
+    /** POST /v1/beacon - ingest a view/AR analytics event (204). */
+    send: (params: BeaconParams) => Promise<void>;
 };
-
-/**
- * Models resource - 3D models (backed by the `scans` table).
- *
- * Mirrors the 8 `/v1/models*` endpoints. camelCase param names are mapped
- * to the snake_case wire contract on the way out; response shapes pass
- * through as-is.
- */
-
-declare class ModelsResource {
-    private readonly client;
-    constructor(client: Viewrium);
-    create(params: ModelCreateParams): Promise<Model>;
-    createFromImages(images: FileInput[], params?: ModelCreateFromImagesParams): Promise<Model>;
-    createFromVideo(video: FileInput, params?: ModelCreateFromVideoParams): Promise<Model>;
-    retrieve(modelId: string): Promise<Model>;
-    list(params?: ModelListParams): Promise<ModelListResponse>;
-    modify(modelId: string, params: ModelUpdateParams): Promise<Model>;
-    delete(modelId: string): Promise<DeletedResponse>;
-    listEvents(modelId: string, params?: ModelListEventsParams): Promise<ModelEventListResponse>;
-}
-
-/**
- * Api keys resource.
- *
- * Creates secret (`sk_*`) or publishable (`pk_*`) keys. pk keys inherit
- * origin restrictions from their project's `allowed_domains`. The plaintext
- * key is returned ONCE from `create()`; store it securely on your side.
- */
-
-declare class ApiKeysResource {
-    private readonly client;
-    constructor(client: Viewrium);
-    create(params?: ApiKeyCreateParams): Promise<ApiKeyWithSecret>;
-    list(): Promise<ApiKeyListResponse>;
-    delete(keyId: string): Promise<RevokedResponse>;
-}
-
-/**
- * Usage resource.
- *
- * Returns aggregated event counts for the caller's organization. Internal
- * service events (rodin / gemini / scrape / convert / store) are never
- * exposed here.
- */
-
-declare class UsageResource {
-    private readonly client;
-    constructor(client: Viewrium);
-    retrieve(params?: UsageRetrieveParams): Promise<UsageSummary>;
-}
-
-/**
- * Tags resource.
- *
- * Lists unique tags across the caller's organization with per-tag model
- * counts. Tags are created implicitly when assigned to a model; there is
- * no POST /v1/tags endpoint.
- */
-
-declare class TagsResource {
-    private readonly client;
-    constructor(client: Viewrium);
-    list(): Promise<TagListResponse>;
-}
-
-/**
- * Viewrium client.
- *
- * Instantiate once per api key:
- *
- *     const viewrium = new Viewrium(process.env.VIEWRIUM_API_KEY!);
- *     const model = await viewrium.models.create({ images: [...] });
- *
- * The client uses `globalThis.fetch` by default (Node 18+, browsers, edge
- * runtimes all provide it). Pass `fetch` in options for custom transports
- * or testing.
- */
-
-interface RequestOptions {
-    method: string;
-    path: string;
-    query?: Record<string, unknown>;
-    json?: unknown;
-    body?: BodyInit;
-    headers?: Record<string, string>;
-    /** Override per-request timeout in ms. */
-    timeoutMs?: number;
-}
 declare class Viewrium {
-    readonly models: ModelsResource;
-    readonly apiKeys: ApiKeysResource;
-    readonly usage: UsageResource;
-    readonly tags: TagsResource;
-    private readonly apiKey;
-    private readonly apiBase;
-    private readonly timeoutMs;
-    private readonly maxRetries;
-    private readonly fetchImpl;
-    constructor(apiKey?: string, options?: ViewriumOptions);
-    /** Low-level request. Resources delegate here. */
-    request<T = unknown>(options: RequestOptions): Promise<T>;
-    private buildUrl;
-    private buildHeaders;
-    private buildBody;
+    #private;
+    readonly baseUrl: string;
+    readonly products: ReturnType<typeof createProducts>;
+    readonly apiKeys: ReturnType<typeof createApiKeys>;
+    readonly usage: ReturnType<typeof createUsage>;
+    readonly webhooks: ReturnType<typeof createWebhooks>;
+    readonly projects: ReturnType<typeof createProjects>;
+    readonly beacon: ReturnType<typeof createBeacon>;
+    constructor(options: ViewriumOptions);
+    /** GET /v1/health */
+    health(): Promise<Health>;
 }
+/** Convenience factory: `createViewrium({ apiKey })` is `new Viewrium({ apiKey })`. */
+declare function createViewrium(options: ViewriumOptions): Viewrium;
 
-/**
- * Official JavaScript / TypeScript SDK for the Viewrium API.
- *
- *     import Viewrium from "@viewrium/sdk";
- *
- *     const viewrium = new Viewrium(process.env.VIEWRIUM_API_KEY!);
- *
- *     const model = await viewrium.models.create({
- *       customId: "sku-1",
- *       images: ["https://example.com/img1.jpg"],
- *       height: 90,
- *       tags: ["chair", "summer-2026"],
- *     });
- */
-
-export { APIError, type ApiKey, type ApiKeyCreateParams, type ApiKeyListResponse, type ApiKeyWithSecret, ApiKeysResource, AuthError, type DeletedResponse, type FileInput, type Model, type ModelCreateFromImagesParams, type ModelCreateFromVideoParams, type ModelCreateParams, type ModelEvent, type ModelEventListResponse, type ModelListEventsParams, type ModelListParams, type ModelListResponse, type ModelStatus, type ModelUpdateParams, ModelsResource, NotFoundError, RateLimitError, type RequestOptions, type RevokedResponse, type SizeUnit, type SourceType, type TagListResponse, type TagSummary, TagsResource, type UsageEventType, UsageResource, type UsageRetrieveParams, type UsageSummary, ValidationError, Viewrium, ViewriumError, type ViewriumOptions, Viewrium as default };
+export { type ApiErrorPayload, type ApiKeyCreateParams, type ApiKeyCreated, type ApiKeyList, AuthenticationError, BadRequestError, type BeaconParams, ConflictError, ConnectionError, type FetchLike, type GateFlags, type Health, type ModelPlan, NotFoundError, PaymentRequiredError, PermissionError, type PlannedView, type Product, type ProductBatchResult, type ProductCost, type ProductCreateParams, type ProductCreateResult, type ProductCreated, type ProductExportParams, type ProductExportQueued, type ProductImage, type ProductImagePatchParams, type ProductList, type ProductListParams, type ProductModel, type ProductModelPatchParams, type ProductOrderParams, type ProductOrderParked, type ProductParked, type ProductPublishParams, type ProductRescaleParams, type ProductReviewParams, type ProductReviewResult, type ProductSummary, type ProductUpdateParams, type Project, type ProjectList, type PublicProduct, RateLimitError, ServerError, type Tags, type TagsParams, type Ticket, type TicketParams, UnprocessableEntityError, type Usage, type UsageParams, type UsageProductTotals, Viewrium, ViewriumError, type ViewriumErrorOptions, type ViewriumOptions, type WebhookDeliveriesParams, type WebhookDeliveryList, type WebhookEndpoint, type WebhookEndpointCreateParams, type WebhookEndpointCreated, type WebhookEndpointList, type WebhookEndpointUpdateParams, createApiError, createViewrium };