@umxr/bagsy 0.0.0-stage → 0.2.0

package/dist/transport-Chh09xIP.d.ts

@@ -0,0 +1,1022 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+interface paths {
+    "/lists": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List the owner's lists */
+        get: operations["listLists"];
+        put?: never;
+        /** Create a named list */
+        post: operations["createList"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/lists/{listId}": {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Server key only. Customer GID of the logged-in shopper. */
+                "Bagsy-Customer-Id"?: components["parameters"]["CustomerId"];
+                /** @description Guest identity. Ignored when a customer is identified. */
+                "Bagsy-Visitor-Id"?: components["parameters"]["VisitorId"];
+            };
+            path: {
+                /** @description A list id, or `default`. */
+                listId: components["parameters"]["ListId"];
+            };
+            cookie?: never;
+        };
+        /** Get a list */
+        get: operations["getList"];
+        put?: never;
+        post?: never;
+        /**
+         * Delete a list and its items
+         * @description The default list cannot be deleted, only cleared.
+         */
+        delete: operations["deleteList"];
+        options?: never;
+        head?: never;
+        /**
+         * Rename a list
+         * @description Visibility changes go through the share endpoints.
+         */
+        patch: operations["updateList"];
+        trace?: never;
+    };
+    "/lists/{listId}/items": {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Server key only. Customer GID of the logged-in shopper. */
+                "Bagsy-Customer-Id"?: components["parameters"]["CustomerId"];
+                /** @description Guest identity. Ignored when a customer is identified. */
+                "Bagsy-Visitor-Id"?: components["parameters"]["VisitorId"];
+            };
+            path: {
+                /** @description A list id, or `default`. */
+                listId: components["parameters"]["ListId"];
+            };
+            cookie?: never;
+        };
+        /** List items, newest first */
+        get: operations["listItems"];
+        put?: never;
+        /**
+         * Save a product (idempotent)
+         * @description Saving the same `productId` + `variantId` twice is a no-op that
+         *     returns the existing item with `200`, so a double-tapped heart never
+         *     creates duplicates.
+         */
+        post: operations["addItem"];
+        /**
+         * Unsave by product
+         * @description With `variantId`, removes that variant's item. Without it, removes
+         *     every item for the product. Lets a heart button unsave without
+         *     knowing the item id.
+         */
+        delete: operations["removeItemByProduct"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/lists/{listId}/items/{itemId}": {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Server key only. Customer GID of the logged-in shopper. */
+                "Bagsy-Customer-Id"?: components["parameters"]["CustomerId"];
+                /** @description Guest identity. Ignored when a customer is identified. */
+                "Bagsy-Visitor-Id"?: components["parameters"]["VisitorId"];
+            };
+            path: {
+                /** @description A list id, or `default`. */
+                listId: components["parameters"]["ListId"];
+                itemId: string;
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /** Remove an item */
+        delete: operations["removeItem"];
+        options?: never;
+        head?: never;
+        /**
+         * Change an item's variant, quantity or note
+         * @description Fails with `validation_failed` if the list already holds the target variant.
+         */
+        patch: operations["updateItem"];
+        trace?: never;
+    };
+    "/saved": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Which of these products are saved?
+         * @description Batch lookup for rendering heart state on collection and search
+         *     pages in one request. Checks across all of the owner's lists.
+         */
+        get: operations["lookupSaved"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/identity/merge": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Merge a guest's lists into the logged-in customer
+         * @description Call once after login. Visitor items move into the customer's lists
+         *     (default into default, named lists by name), duplicates collapse, and
+         *     the visitor id is retired. Safe to retry.
+         */
+        post: operations["mergeVisitor"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/lists/{listId}/share": {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Server key only. Customer GID of the logged-in shopper. */
+                "Bagsy-Customer-Id"?: components["parameters"]["CustomerId"];
+                /** @description Guest identity. Ignored when a customer is identified. */
+                "Bagsy-Visitor-Id"?: components["parameters"]["VisitorId"];
+            };
+            path: {
+                /** @description A list id, or `default`. */
+                listId: components["parameters"]["ListId"];
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Share a list
+         * @description Returns the list's share token, creating one if the list isn't shared
+         *     yet. Calling it again returns the same token, so links already sent
+         *     keep working. Pass `rotate=true` to issue a new token and invalidate
+         *     the old one.
+         */
+        post: operations["shareList"];
+        /** Revoke sharing */
+        delete: operations["unshareList"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/shared/{shareToken}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Read a shared list (public) */
+        get: operations["getSharedList"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/insights/top-products": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Most-saved products */
+        get: operations["topProducts"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+interface components {
+    schemas: {
+        /** @example gid://shopify/Product/8123456789 */
+        ProductGid: string;
+        /** @example gid://shopify/ProductVariant/44123456789 */
+        VariantGid: string;
+        /** @example gid://shopify/Customer/7123456789 */
+        CustomerGid: string;
+        List: {
+            /** @example lst_01JB2Y9K3T7M */
+            id: string;
+            /** @example Wishlist */
+            name: string;
+            isDefault: boolean;
+            /** @enum {string} */
+            visibility: "private" | "shared";
+            itemCount: number;
+            /** @description The list's share token while it is shared. Only ever returned to the list's owner. */
+            shareToken?: string | null;
+            /** Format: date-time */
+            createdAt: string;
+            /** Format: date-time */
+            updatedAt: string;
+            /** @description Present only with `include=items`. */
+            items?: components["schemas"]["ItemPage"];
+        };
+        ListCreate: {
+            name: string;
+        };
+        ListUpdate: {
+            name?: string;
+        };
+        Item: {
+            /** @example itm_01JB2Z6Q8V4K */
+            id: string;
+            listId: string;
+            productId: components["schemas"]["ProductGid"];
+            /** @description Null means "any variant". */
+            variantId?: components["schemas"]["VariantGid"] | null;
+            /** @default 1 */
+            quantity: number;
+            note?: string | null;
+            /** Format: date-time */
+            addedAt: string;
+        };
+        ItemCreate: {
+            productId: components["schemas"]["ProductGid"];
+            variantId?: components["schemas"]["VariantGid"];
+            /** @default 1 */
+            quantity?: number;
+            note?: string;
+        };
+        ItemUpdate: {
+            variantId?: components["schemas"]["VariantGid"] | null;
+            quantity?: number;
+            note?: string | null;
+        };
+        ItemPage: {
+            data: components["schemas"]["Item"][];
+            pageInfo: {
+                hasNextPage: boolean;
+                endCursor?: string | null;
+            };
+        };
+        Problem: {
+            /**
+             * Format: uri
+             * @example https://bagsy.dev/errors/list_not_found
+             */
+            type: string;
+            /** @example List not found */
+            title: string;
+            /** @example 404 */
+            status: number;
+            /** @enum {string} */
+            code: "unauthorized" | "owner_required" | "list_not_found" | "item_not_found" | "list_limit_reached" | "default_list_protected" | "list_name_taken" | "item_limit_reached" | "not_found" | "validation_failed" | "rate_limited";
+            detail?: string;
+            /** @description Field-level detail for `validation_failed`. */
+            errors?: {
+                /** @example /productId */
+                path: string;
+                message: string;
+            }[];
+        };
+    };
+    responses: {
+        /** @description Missing or invalid credentials, or no owner identified. */
+        Unauthorized: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": components["schemas"]["Problem"];
+            };
+        };
+        /** @description Not found, or not owned by the caller (never distinguished). */
+        NotFound: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": components["schemas"]["Problem"];
+            };
+        };
+        /** @description A limit was reached, the name is taken, or the default list is protected. */
+        Conflict: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": components["schemas"]["Problem"];
+            };
+        };
+        /** @description Request failed validation. */
+        Invalid: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/problem+json": components["schemas"]["Problem"];
+            };
+        };
+    };
+    parameters: {
+        /** @description A list id, or `default`. */
+        ListId: string;
+        /** @description Server key only. Customer GID of the logged-in shopper. */
+        CustomerId: components["schemas"]["CustomerGid"];
+        /** @description Guest identity. Ignored when a customer is identified. */
+        VisitorId: string;
+        /** @description Replays within 24h return the original response. */
+        IdempotencyKey: string;
+        Limit: number;
+        /** @description Cursor from `pageInfo.endCursor`. */
+        After: string;
+    };
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+interface operations {
+    listLists: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Server key only. Customer GID of the logged-in shopper. */
+                "Bagsy-Customer-Id"?: components["parameters"]["CustomerId"];
+                /** @description Guest identity. Ignored when a customer is identified. */
+                "Bagsy-Visitor-Id"?: components["parameters"]["VisitorId"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The owner's lists, default first. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: components["schemas"]["List"][];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+        };
+    };
+    createList: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Server key only. Customer GID of the logged-in shopper. */
+                "Bagsy-Customer-Id"?: components["parameters"]["CustomerId"];
+                /** @description Guest identity. Ignored when a customer is identified. */
+                "Bagsy-Visitor-Id"?: components["parameters"]["VisitorId"];
+                /** @description Replays within 24h return the original response. */
+                "Idempotency-Key"?: components["parameters"]["IdempotencyKey"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ListCreate"];
+            };
+        };
+        responses: {
+            /** @description Created. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["List"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            409: components["responses"]["Conflict"];
+            422: components["responses"]["Invalid"];
+        };
+    };
+    getList: {
+        parameters: {
+            query?: {
+                /** @description Embed the first page of items. */
+                include?: "items"[];
+            };
+            header?: {
+                /** @description Server key only. Customer GID of the logged-in shopper. */
+                "Bagsy-Customer-Id"?: components["parameters"]["CustomerId"];
+                /** @description Guest identity. Ignored when a customer is identified. */
+                "Bagsy-Visitor-Id"?: components["parameters"]["VisitorId"];
+            };
+            path: {
+                /** @description A list id, or `default`. */
+                listId: components["parameters"]["ListId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The list. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["List"];
+                };
+            };
+            404: components["responses"]["NotFound"];
+        };
+    };
+    deleteList: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Server key only. Customer GID of the logged-in shopper. */
+                "Bagsy-Customer-Id"?: components["parameters"]["CustomerId"];
+                /** @description Guest identity. Ignored when a customer is identified. */
+                "Bagsy-Visitor-Id"?: components["parameters"]["VisitorId"];
+            };
+            path: {
+                /** @description A list id, or `default`. */
+                listId: components["parameters"]["ListId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Deleted. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+        };
+    };
+    updateList: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Server key only. Customer GID of the logged-in shopper. */
+                "Bagsy-Customer-Id"?: components["parameters"]["CustomerId"];
+                /** @description Guest identity. Ignored when a customer is identified. */
+                "Bagsy-Visitor-Id"?: components["parameters"]["VisitorId"];
+            };
+            path: {
+                /** @description A list id, or `default`. */
+                listId: components["parameters"]["ListId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ListUpdate"];
+            };
+        };
+        responses: {
+            /** @description Updated. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["List"];
+                };
+            };
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+            422: components["responses"]["Invalid"];
+        };
+    };
+    listItems: {
+        parameters: {
+            query?: {
+                limit?: components["parameters"]["Limit"];
+                /** @description Cursor from `pageInfo.endCursor`. */
+                after?: components["parameters"]["After"];
+            };
+            header?: {
+                /** @description Server key only. Customer GID of the logged-in shopper. */
+                "Bagsy-Customer-Id"?: components["parameters"]["CustomerId"];
+                /** @description Guest identity. Ignored when a customer is identified. */
+                "Bagsy-Visitor-Id"?: components["parameters"]["VisitorId"];
+            };
+            path: {
+                /** @description A list id, or `default`. */
+                listId: components["parameters"]["ListId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description A page of items. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ItemPage"];
+                };
+            };
+            404: components["responses"]["NotFound"];
+        };
+    };
+    addItem: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Server key only. Customer GID of the logged-in shopper. */
+                "Bagsy-Customer-Id"?: components["parameters"]["CustomerId"];
+                /** @description Guest identity. Ignored when a customer is identified. */
+                "Bagsy-Visitor-Id"?: components["parameters"]["VisitorId"];
+                /** @description Replays within 24h return the original response. */
+                "Idempotency-Key"?: components["parameters"]["IdempotencyKey"];
+            };
+            path: {
+                /** @description A list id, or `default`. */
+                listId: components["parameters"]["ListId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ItemCreate"];
+            };
+        };
+        responses: {
+            /** @description Already saved; existing item returned. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Item"];
+                };
+            };
+            /** @description Saved. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Item"];
+                };
+            };
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+            422: components["responses"]["Invalid"];
+        };
+    };
+    removeItemByProduct: {
+        parameters: {
+            query: {
+                productId: components["schemas"]["ProductGid"];
+                variantId?: components["schemas"]["VariantGid"];
+            };
+            header?: {
+                /** @description Server key only. Customer GID of the logged-in shopper. */
+                "Bagsy-Customer-Id"?: components["parameters"]["CustomerId"];
+                /** @description Guest identity. Ignored when a customer is identified. */
+                "Bagsy-Visitor-Id"?: components["parameters"]["VisitorId"];
+            };
+            path: {
+                /** @description A list id, or `default`. */
+                listId: components["parameters"]["ListId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Removed, or was not saved. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            404: components["responses"]["NotFound"];
+        };
+    };
+    removeItem: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Server key only. Customer GID of the logged-in shopper. */
+                "Bagsy-Customer-Id"?: components["parameters"]["CustomerId"];
+                /** @description Guest identity. Ignored when a customer is identified. */
+                "Bagsy-Visitor-Id"?: components["parameters"]["VisitorId"];
+            };
+            path: {
+                /** @description A list id, or `default`. */
+                listId: components["parameters"]["ListId"];
+                itemId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Removed. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            404: components["responses"]["NotFound"];
+        };
+    };
+    updateItem: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Server key only. Customer GID of the logged-in shopper. */
+                "Bagsy-Customer-Id"?: components["parameters"]["CustomerId"];
+                /** @description Guest identity. Ignored when a customer is identified. */
+                "Bagsy-Visitor-Id"?: components["parameters"]["VisitorId"];
+            };
+            path: {
+                /** @description A list id, or `default`. */
+                listId: components["parameters"]["ListId"];
+                itemId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ItemUpdate"];
+            };
+        };
+        responses: {
+            /** @description Updated. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Item"];
+                };
+            };
+            404: components["responses"]["NotFound"];
+            422: components["responses"]["Invalid"];
+        };
+    };
+    lookupSaved: {
+        parameters: {
+            query: {
+                productIds: components["schemas"]["ProductGid"][];
+            };
+            header?: {
+                /** @description Server key only. Customer GID of the logged-in shopper. */
+                "Bagsy-Customer-Id"?: components["parameters"]["CustomerId"];
+                /** @description Guest identity. Ignored when a customer is identified. */
+                "Bagsy-Visitor-Id"?: components["parameters"]["VisitorId"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Saved state per requested product. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Keyed by product GID. Unsaved products map to an empty array. */
+                        data: {
+                            [key: string]: {
+                                listId: string;
+                                itemId: string;
+                                variantId?: components["schemas"]["VariantGid"];
+                            }[];
+                        };
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            422: components["responses"]["Invalid"];
+        };
+    };
+    mergeVisitor: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Server key only. Customer GID of the logged-in shopper. */
+                "Bagsy-Customer-Id"?: components["parameters"]["CustomerId"];
+                /** @description Replays within 24h return the original response. */
+                "Idempotency-Key"?: components["parameters"]["IdempotencyKey"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** Format: uuid */
+                    visitorId: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Merged. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        mergedItems: number;
+                        lists: components["schemas"]["List"][];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+        };
+    };
+    shareList: {
+        parameters: {
+            query?: {
+                rotate?: boolean;
+            };
+            header?: {
+                /** @description Server key only. Customer GID of the logged-in shopper. */
+                "Bagsy-Customer-Id"?: components["parameters"]["CustomerId"];
+                /** @description Guest identity. Ignored when a customer is identified. */
+                "Bagsy-Visitor-Id"?: components["parameters"]["VisitorId"];
+            };
+            path: {
+                /** @description A list id, or `default`. */
+                listId: components["parameters"]["ListId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The list's share token. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example shr_7Hq2LmX9 */
+                        shareToken: string;
+                    };
+                };
+            };
+            404: components["responses"]["NotFound"];
+        };
+    };
+    unshareList: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Server key only. Customer GID of the logged-in shopper. */
+                "Bagsy-Customer-Id"?: components["parameters"]["CustomerId"];
+                /** @description Guest identity. Ignored when a customer is identified. */
+                "Bagsy-Visitor-Id"?: components["parameters"]["VisitorId"];
+            };
+            path: {
+                /** @description A list id, or `default`. */
+                listId: components["parameters"]["ListId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Revoked. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            404: components["responses"]["NotFound"];
+        };
+    };
+    getSharedList: {
+        parameters: {
+            query?: {
+                limit?: components["parameters"]["Limit"];
+                /** @description Cursor from `pageInfo.endCursor`. */
+                after?: components["parameters"]["After"];
+            };
+            header?: never;
+            path: {
+                shareToken: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Read-only view. Owner identity is never exposed. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        list: {
+                            name: string;
+                            itemCount: number;
+                        };
+                        items: components["schemas"]["ItemPage"];
+                    };
+                };
+            };
+            404: components["responses"]["NotFound"];
+        };
+    };
+    topProducts: {
+        parameters: {
+            query?: {
+                since?: string;
+                limit?: components["parameters"]["Limit"];
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Ranked by distinct owners who saved each product. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: {
+                            productId: components["schemas"]["ProductGid"];
+                            saves: number;
+                        }[];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+        };
+    };
+}
+
+/**
+ * Shopify IDs arrive in two shapes: numeric (Liquid's `product.id`) and GIDs
+ * (Storefront and Customer Account APIs). Bagsy accepts either and always
+ * sends GIDs on the wire.
+ */
+type ProductRef = string | number;
+type VariantRef = string | number;
+type CustomerRef = string | number;
+declare const productGid: (ref: ProductRef) => string;
+declare const variantGid: (ref: VariantRef) => string;
+declare const customerGid: (ref: CustomerRef) => string;
+
+type Schemas = components['schemas'];
+type Json<T> = T extends {
+    content: {
+        'application/json': infer B;
+    };
+} ? B : never;
+type List = Schemas['List'];
+type Item = components['schemas']['Item'];
+type ItemPage = components['schemas']['ItemPage'];
+type MergeResult = Json<operations['mergeVisitor']['responses']['200']>;
+type SharedList = Json<operations['getSharedList']['responses']['200']>;
+type TopProduct = Json<operations['topProducts']['responses']['200']>['data'][number];
+interface RequestOptions {
+    query?: Record<string, string | number | string[] | undefined>;
+    body?: unknown;
+}
+/** A list id, or `'default'` for the owner's default list. */
+type ListRef = string;
+interface Owner {
+    /** Server mode only. On the app proxy, Shopify supplies the customer. */
+    customerId?: CustomerRef;
+    /** Guest identity; see `getVisitorId()`. Ignored once a customer is known. */
+    visitorId?: string;
+}
+interface CommonOptions {
+    /** Override the API origin and path, e.g. for local development or tests. */
+    baseUrl?: string;
+    /** Custom fetch, e.g. Oxygen's or a test double. */
+    fetch?: typeof globalThis.fetch;
+}
+interface ProxyOptions extends CommonOptions {
+    /** Liquid themes. Requests go through the store's app proxy. */
+    mode: 'proxy';
+    /**
+     * Proxy path on the store. Pass `{{ routes.root_url }}apps/bagsy` from Liquid
+     * so Markets locale prefixes (`/en-gb/…`) are respected.
+     * @default '/apps/bagsy'
+     */
+    proxyPath?: string;
+    visitorId?: string;
+}
+interface ServerOptions extends CommonOptions, Owner {
+    /** Hydrogen, Node, Workers. Never in a browser. */
+    mode: 'server';
+    /** Per-shop secret key (`bsk_live_…` or `bsk_test_…`). */
+    apiKey: string;
+}
+interface AccountOptions extends CommonOptions {
+    /**
+     * Customer account UI extensions. Authenticates every request with a
+     * Shopify session token; the customer comes from the token. Use with
+     * createBagsy() or createAccountTransport(), not createTransport().
+     */
+    mode: 'account';
+    /** Returns a current session token, e.g. `() => shopify.sessionToken.get()`. */
+    sessionToken: () => Promise<string>;
+    visitorId?: undefined;
+}
+interface RelayOptions {
+    /**
+     * Browsers on headless storefronts (Hydrogen, other React apps). Calls go to
+     * one endpoint on your server, which adds the key and the shopper's identity.
+     * See `@umxr/bagsy/hydrogen`.
+     */
+    mode: 'relay';
+    /** Your server's relay endpoint. @default '/api/bagsy' */
+    endpoint?: string;
+    fetch?: typeof globalThis.fetch;
+    baseUrl?: undefined;
+    visitorId?: undefined;
+}
+type BagsyOptions = ProxyOptions | ServerOptions | AccountOptions | RelayOptions;
+interface SavedEntry {
+    listId: string;
+    itemId: string;
+    variantId?: string;
+}
+interface SavedLookup {
+    /** True if the product (optionally that exact variant) is saved in any list. */
+    has(product: ProductRef, variant?: VariantRef): boolean;
+    /** Every place the product is saved. Empty when it isn't. */
+    get(product: ProductRef): SavedEntry[];
+    /** Raw result keyed by product GID. */
+    readonly byProduct: Readonly<Record<string, SavedEntry[]>>;
+}
+interface PageOptions {
+    limit?: number;
+    after?: string;
+}
+interface ItemOptions {
+    listId?: ListRef;
+    variantId?: VariantRef;
+}
+
+/** How operations reach the API: base URL, identity headers and fetch. */
+interface Transport {
+    readonly options: BagsyOptions;
+    send<T>(method: string, path: string, init?: RequestOptions): Promise<{
+        status: number;
+        data: T;
+    }>;
+    request<T>(method: string, path: string, init?: RequestOptions): Promise<T>;
+}
+/** Proxy, server and account modes. Relay mode has its own: `createRelayTransport()`. */
+declare function createTransport(options: Exclude<BagsyOptions, RelayOptions>): Transport;
+
+export { createTransport as k, customerGid as l, productGid as m, variantGid as v };
+export type { AccountOptions as A, BagsyOptions as B, CustomerRef as C, ItemOptions as I, ListRef as L, MergeResult as M, Owner as O, PageOptions as P, RelayOptions as R, SavedLookup as S, Transport as T, VariantRef as V, ProductRef as a, SavedEntry as b, components as c, Item as d, List as e, SharedList as f, ItemPage as g, TopProduct as h, ProxyOptions as i, ServerOptions as j, operations as o, paths as p };