@tiledev/sdk-shopify 0.9.1 → 0.10.0

package/dist/orders.js

@@ -0,0 +1,439 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ORDER_CLOCK_LEEWAY_MS = exports.STOREFRONT_ORDER_DETAIL_QUERY = exports.STOREFRONT_ORDER_IDS_QUERY = exports.STOREFRONT_ORDER_HISTORY_QUERY = exports.ACCOUNT_ORDER_DETAIL_QUERY = exports.ACCOUNT_ORDER_HISTORY_QUERY = exports.ORDER_LINES_READ = exports.LIST_LINES_COUNTED = void 0;
+exports.orderProgress = orderProgress;
+exports.placedSince = placedSince;
+exports.customerAccountOrders = customerAccountOrders;
+exports.storefrontOrders = storefrontOrders;
+exports.withFreshFirstPage = withFreshFirstPage;
+exports.withNextPage = withNextPage;
+exports.planBuyAgain = planBuyAgain;
+/**
+ * The signed-in shopper's orders, for `useOrders` and `useOrder` (react/useOrders.ts), from the API
+ * their session reads (`CustomerState.sessionKind`):
+ *
+ * - `shopify`: the Customer Account API (`customer.orders`, `order(id:)`), as production Amber did.
+ * - `password`: the Storefront API (`customer(customerAccessToken:) { orders }`).
+ *
+ * Both answer in the same shapes (`OrderSummary`, `OrderDetails`), so a screen doesn't care which
+ * sign-in it was. Newest first on both, by `processedAt`: the date the screens show. (Production
+ * sorted by ID; an imported order's `processedAt` can be older than its ID suggests.)
+ *
+ * Framework-free. Tested in test/orders.test.mjs.
+ */
+const client_1 = require("./client");
+const productPage_1 = require("./productPage");
+const types_1 = require("./types");
+/**
+ * Lines counted per order in a list, for `itemCount`. A list needs only the quantities, and this keeps
+ * a page of 25 near 850 Customer Account API cost points by Shopify's published cost rules (that API
+ * charges per field read, from 7,500 points per shopper and store).
+ */
+exports.LIST_LINES_COUNTED = 30;
+/** Lines read for one order. */
+exports.ORDER_LINES_READ = 100;
+// ── Customer Account API (Shopify sign-in) ─────────────────────────────────
+exports.ACCOUNT_ORDER_HISTORY_QUERY = `
+  query OrderHistory($first: Int!, $after: String) {
+    customer {
+      orders(first: $first, after: $after, sortKey: PROCESSED_AT, reverse: true) {
+        pageInfo { hasNextPage endCursor }
+        nodes {
+          id
+          name
+          processedAt
+          cancelledAt
+          fulfillmentStatus
+          statusPageUrl
+          totalPrice { amount currencyCode }
+          lineItems(first: ${exports.LIST_LINES_COUNTED}) { nodes { quantity } }
+        }
+      }
+    }
+  }
+`;
+exports.ACCOUNT_ORDER_DETAIL_QUERY = `
+  query OrderDetail($id: ID!) {
+    order(id: $id) {
+      id
+      name
+      processedAt
+      cancelledAt
+      fulfillmentStatus
+      statusPageUrl
+      totalPrice { amount currencyCode }
+      subtotal { amount currencyCode }
+      totalShipping { amount currencyCode }
+      totalTax { amount currencyCode }
+      totalRefunded { amount currencyCode }
+      discountApplications(first: 10) { nodes { ... on DiscountCodeApplication { code } } }
+      lineItems(first: ${exports.ORDER_LINES_READ}) {
+        nodes {
+          title
+          variantTitle
+          quantity
+          variantId
+          image { url }
+          price { amount currencyCode }
+          totalPrice { amount currencyCode }
+        }
+      }
+    }
+  }
+`;
+// ── Storefront API (email and password) ────────────────────────────────────
+exports.STOREFRONT_ORDER_HISTORY_QUERY = `
+  query CustomerOrderHistory($accessToken: String!, $first: Int!, $after: String) {
+    customer(customerAccessToken: $accessToken) {
+      orders(first: $first, after: $after, sortKey: PROCESSED_AT, reverse: true) {
+        pageInfo { hasNextPage endCursor }
+        nodes {
+          id
+          name
+          processedAt
+          canceledAt
+          fulfillmentStatus
+          statusUrl
+          totalPrice { amount currencyCode }
+          lineItems(first: ${exports.LIST_LINES_COUNTED}) { nodes { quantity } }
+        }
+      }
+    }
+  }
+`;
+/**
+ * The Storefront API has no order-by-id query, so one order is found in two cheap reads: its place in
+ * the list (ids only, 250 a page), then that one order, read after the cursor of the one before it.
+ */
+exports.STOREFRONT_ORDER_IDS_QUERY = `
+  query CustomerOrderIds($accessToken: String!, $after: String) {
+    customer(customerAccessToken: $accessToken) {
+      orders(first: 250, after: $after, sortKey: PROCESSED_AT, reverse: true) {
+        pageInfo { hasNextPage endCursor }
+        edges { cursor node { id } }
+      }
+    }
+  }
+`;
+exports.STOREFRONT_ORDER_DETAIL_QUERY = `
+  query CustomerOrderDetail($accessToken: String!, $after: String) {
+    customer(customerAccessToken: $accessToken) {
+      orders(first: 1, after: $after, sortKey: PROCESSED_AT, reverse: true) {
+        nodes {
+          id
+          name
+          processedAt
+          canceledAt
+          fulfillmentStatus
+          statusUrl
+          totalPrice { amount currencyCode }
+          subtotalPrice { amount currencyCode }
+          totalShippingPrice { amount currencyCode }
+          totalTax { amount currencyCode }
+          totalRefunded { amount currencyCode }
+          discountApplications(first: 10) { nodes { ... on DiscountCodeApplication { code } } }
+          lineItems(first: ${exports.ORDER_LINES_READ}) {
+            nodes {
+              title
+              quantity
+              originalTotalPrice { amount currencyCode }
+              variant { id title image { url } }
+            }
+          }
+        }
+      }
+    }
+  }
+`;
+// ── Mapping ────────────────────────────────────────────────────────────────
+/** Production Amber's status card rule: cancelled wins, then the fulfilment status. */
+function orderProgress(cancelledAt, fulfillmentStatus) {
+    if (cancelledAt)
+        return 'cancelled';
+    if (fulfillmentStatus === 'FULFILLED')
+        return 'fulfilled';
+    if (fulfillmentStatus === 'PARTIALLY_FULFILLED')
+        return 'partiallyFulfilled';
+    return 'confirmed';
+}
+const nodesOf = (list) => { var _a; return ((_a = list === null || list === void 0 ? void 0 : list.nodes) !== null && _a !== void 0 ? _a : []).filter((node) => !!node); };
+const toCents = (m) => { var _a; return Math.round((Number.parseFloat((_a = m === null || m === void 0 ? void 0 : m.amount) !== null && _a !== void 0 ? _a : '0') || 0) * 100); };
+const fromCents = (cents, currencyCode) => ({ amount: (cents / 100).toFixed(2), currencyCode });
+const copyMoney = (m) => (m ? { amount: m.amount, currencyCode: m.currencyCode } : null);
+/** For the rows a screen shows only when they say something: a zero is null. */
+const unlessZero = (m) => (m && toCents(m) !== 0 ? copyMoney(m) : null);
+/** Shopify's name for the only variant of a product with one. */
+const variantTitleOf = (title) => (title && title !== 'Default Title' ? title : null);
+const codesOf = (list) => nodesOf(list).map((node) => node.code).filter((code) => !!code);
+function fromAccount(raw) {
+    var _a, _b, _c, _d, _e;
+    return {
+        id: raw.id,
+        name: (_a = raw.name) !== null && _a !== void 0 ? _a : '',
+        processedAt: (_b = raw.processedAt) !== null && _b !== void 0 ? _b : '',
+        cancelledAt: (_c = raw.cancelledAt) !== null && _c !== void 0 ? _c : null,
+        fulfillmentStatus: (_d = raw.fulfillmentStatus) !== null && _d !== void 0 ? _d : null,
+        statusPageUrl: (_e = raw.statusPageUrl) !== null && _e !== void 0 ? _e : null,
+        totalPrice: raw.totalPrice,
+        lines: nodesOf(raw.lineItems).map((line) => {
+            var _a, _b, _c, _d, _e;
+            return ({
+                title: (_a = line.title) !== null && _a !== void 0 ? _a : '',
+                variantTitle: variantTitleOf(line.variantTitle),
+                quantity: (_b = line.quantity) !== null && _b !== void 0 ? _b : 0,
+                imageUrl: (_d = (_c = line.image) === null || _c === void 0 ? void 0 : _c.url) !== null && _d !== void 0 ? _d : null,
+                unitPrice: copyMoney(line.price),
+                totalPrice: copyMoney(line.totalPrice),
+                variantId: (_e = line.variantId) !== null && _e !== void 0 ? _e : null,
+            });
+        }),
+        netSubtotal: raw.subtotal,
+        totalShipping: raw.totalShipping,
+        totalTax: raw.totalTax,
+        totalRefunded: raw.totalRefunded,
+        discountCodes: codesOf(raw.discountApplications),
+    };
+}
+function fromStorefront(raw) {
+    var _a, _b, _c, _d, _e;
+    return {
+        id: raw.id,
+        name: (_a = raw.name) !== null && _a !== void 0 ? _a : '',
+        processedAt: (_b = raw.processedAt) !== null && _b !== void 0 ? _b : '',
+        cancelledAt: (_c = raw.canceledAt) !== null && _c !== void 0 ? _c : null,
+        fulfillmentStatus: (_d = raw.fulfillmentStatus) !== null && _d !== void 0 ? _d : null,
+        statusPageUrl: (_e = raw.statusUrl) !== null && _e !== void 0 ? _e : null,
+        totalPrice: raw.totalPrice,
+        lines: nodesOf(raw.lineItems).map((line) => {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const quantity = (_a = line.quantity) !== null && _a !== void 0 ? _a : 0;
+            const total = line.originalTotalPrice;
+            return {
+                title: (_b = line.title) !== null && _b !== void 0 ? _b : '',
+                variantTitle: variantTitleOf((_c = line.variant) === null || _c === void 0 ? void 0 : _c.title),
+                quantity,
+                imageUrl: (_f = (_e = (_d = line.variant) === null || _d === void 0 ? void 0 : _d.image) === null || _e === void 0 ? void 0 : _e.url) !== null && _f !== void 0 ? _f : null,
+                // The Storefront API has no unit price on an order line; its pre-discount total is one times quantity.
+                unitPrice: total && quantity > 0 ? fromCents(Math.round(toCents(total) / quantity), total.currencyCode) : null,
+                totalPrice: copyMoney(total),
+                variantId: (_h = (_g = line.variant) === null || _g === void 0 ? void 0 : _g.id) !== null && _h !== void 0 ? _h : null,
+            };
+        }),
+        netSubtotal: raw.subtotalPrice,
+        totalShipping: raw.totalShippingPrice,
+        totalTax: raw.totalTax,
+        totalRefunded: raw.totalRefunded,
+        discountCodes: codesOf(raw.discountApplications),
+    };
+}
+function toSummary(order) {
+    var _a;
+    return {
+        id: order.id,
+        name: order.name,
+        processedAt: order.processedAt,
+        progress: orderProgress(order.cancelledAt, order.fulfillmentStatus),
+        cancelledAt: order.cancelledAt,
+        totalPrice: (_a = copyMoney(order.totalPrice)) !== null && _a !== void 0 ? _a : { amount: '0.00', currencyCode: '' },
+        itemCount: order.lines.reduce((sum, line) => sum + line.quantity, 0),
+        statusPageUrl: order.statusPageUrl,
+    };
+}
+/**
+ * Production Amber's totals: the subtotal shown is the lines before discounts, and the discount is the
+ * gap between that and Shopify's subtotal (which is after every discount, line or order level), so a
+ * whole-order code that lands on no single line is counted too.
+ */
+function toDetails(order) {
+    var _a, _b, _c, _d;
+    const currencyCode = (_d = (_b = (_a = order.totalPrice) === null || _a === void 0 ? void 0 : _a.currencyCode) !== null && _b !== void 0 ? _b : (_c = order.netSubtotal) === null || _c === void 0 ? void 0 : _c.currencyCode) !== null && _d !== void 0 ? _d : '';
+    const lineTotals = order.lines.map((line) => line.totalPrice).filter((total) => !!total);
+    const itemsCents = lineTotals.reduce((sum, total) => sum + toCents(total), 0);
+    const netCents = order.netSubtotal ? toCents(order.netSubtotal) : itemsCents;
+    const discountCents = Math.max(0, itemsCents - netCents);
+    return {
+        ...toSummary(order),
+        lineItems: order.lines,
+        subtotal: itemsCents > 0 ? fromCents(itemsCents, currencyCode) : copyMoney(order.netSubtotal),
+        totalShipping: copyMoney(order.totalShipping),
+        totalTax: unlessZero(order.totalTax),
+        totalDiscount: discountCents > 0 ? fromCents(discountCents, currencyCode) : null,
+        totalRefunded: unlessZero(order.totalRefunded),
+        discountCodes: order.discountCodes,
+    };
+}
+// ── Reading ────────────────────────────────────────────────────────────────
+/**
+ * Leeway for the phone's clock against Shopify's when telling a new order from the one before it: an
+ * order placed up to this long before `since` still counts (`useLatestOrderSince`). 2 minutes.
+ */
+exports.ORDER_CLOCK_LEEWAY_MS = 2 * 60 * 1000;
+/**
+ * Whether an order was placed at or after `since` (ms since 1970), less `clockLeewayMs`. Every order
+ * counts when `since` is null or undefined. An order whose date can't be read never counts.
+ */
+function placedSince(order, since, clockLeewayMs = exports.ORDER_CLOCK_LEEWAY_MS) {
+    if (since == null)
+        return true;
+    return Date.parse(order.processedAt) >= since - clockLeewayMs;
+}
+const sessionEnded = () => new types_1.ShopifyError('The customer session has ended');
+function toPage(raw, read) {
+    var _a, _b, _c, _d, _e;
+    return {
+        orders: ((_a = raw === null || raw === void 0 ? void 0 : raw.nodes) !== null && _a !== void 0 ? _a : []).filter((node) => !!node).map((node) => toSummary(read(node))),
+        endCursor: (_c = (_b = raw === null || raw === void 0 ? void 0 : raw.pageInfo) === null || _b === void 0 ? void 0 : _b.endCursor) !== null && _c !== void 0 ? _c : null,
+        hasNextPage: !!((_d = raw === null || raw === void 0 ? void 0 : raw.pageInfo) === null || _d === void 0 ? void 0 : _d.hasNextPage) && !!((_e = raw === null || raw === void 0 ? void 0 : raw.pageInfo) === null || _e === void 0 ? void 0 : _e.endCursor),
+    };
+}
+/** Shopify sign-in: the Customer Account API. */
+function customerAccountOrders(accountRequest) {
+    return {
+        async list(first, after) {
+            var _a;
+            const data = await accountRequest(exports.ACCOUNT_ORDER_HISTORY_QUERY, { first, after });
+            return toPage((_a = data.customer) === null || _a === void 0 ? void 0 : _a.orders, fromAccount);
+        },
+        async get(id) {
+            const data = await accountRequest(exports.ACCOUNT_ORDER_DETAIL_QUERY, { id });
+            return data.order ? toDetails(fromAccount(data.order)) : null;
+        },
+    };
+}
+/**
+ * Email and password: the Storefront API, with the session's token. A token Shopify no longer accepts
+ * reads `customer: null`, which is the session ending, not an empty history.
+ */
+function storefrontOrders(getAccessToken) {
+    async function token() {
+        const accessToken = await getAccessToken();
+        if (!accessToken)
+            throw sessionEnded();
+        return accessToken;
+    }
+    /** The cursor to read `id` after (null: it is the newest), or undefined when there is no such order. */
+    async function cursorBefore(accessToken, id) {
+        let after = null;
+        for (;;) {
+            const data = await (0, client_1.request)(exports.STOREFRONT_ORDER_IDS_QUERY, {
+                accessToken,
+                after,
+            });
+            if (!data.customer)
+                throw sessionEnded();
+            const { edges, pageInfo } = data.customer.orders;
+            const at = edges.findIndex((edge) => edge.node.id === id);
+            if (at >= 0)
+                return at === 0 ? after : edges[at - 1].cursor;
+            if (!pageInfo.hasNextPage || !pageInfo.endCursor)
+                return undefined;
+            after = pageInfo.endCursor;
+        }
+    }
+    return {
+        async list(first, after) {
+            const data = await (0, client_1.request)(exports.STOREFRONT_ORDER_HISTORY_QUERY, {
+                accessToken: await token(),
+                first,
+                after,
+            });
+            if (!data.customer)
+                throw sessionEnded();
+            return toPage(data.customer.orders, fromStorefront);
+        },
+        async get(id) {
+            const accessToken = await token();
+            // Twice at most: an order placed between the two reads moves the one asked for along by one.
+            for (let attempt = 0; attempt < 2; attempt += 1) {
+                const after = await cursorBefore(accessToken, id);
+                if (after === undefined)
+                    return null;
+                const data = await (0, client_1.request)(exports.STOREFRONT_ORDER_DETAIL_QUERY, { accessToken, after });
+                if (!data.customer)
+                    throw sessionEnded();
+                const node = data.customer.orders.nodes[0];
+                if ((node === null || node === void 0 ? void 0 : node.id) === id)
+                    return toDetails(fromStorefront(node));
+            }
+            throw new types_1.ShopifyError('The order list changed while it was being read; try again');
+        },
+    };
+}
+/**
+ * A refreshed first page laid over what is on screen. The pages loaded after it are kept, so a list
+ * scrolled down stays where it was (they aren't re-read). When the fresh page doesn't reach back to
+ * them (many new orders since), or it is the whole history, it replaces the list.
+ */
+function withFreshFirstPage(shown, page) {
+    const fresh = { orders: page.orders, endCursor: page.endCursor, hasMore: page.hasNextPage };
+    if (!page.hasNextPage || page.orders.length === 0)
+        return fresh;
+    const lastFresh = page.orders[page.orders.length - 1].id;
+    const at = shown.orders.findIndex((order) => order.id === lastFresh);
+    if (at < 0)
+        return fresh;
+    const freshIds = new Set(page.orders.map((order) => order.id));
+    const rest = shown.orders.slice(at + 1).filter((order) => !freshIds.has(order.id));
+    if (rest.length === 0)
+        return fresh;
+    return { orders: [...page.orders, ...rest], endCursor: shown.endCursor, hasMore: shown.hasMore };
+}
+/** The next page after what is shown, leaving out any order already there. */
+function withNextPage(shown, page) {
+    const ids = new Set(shown.orders.map((order) => order.id));
+    return {
+        orders: [...shown.orders, ...page.orders.filter((order) => !ids.has(order.id))],
+        endCursor: page.endCursor,
+        hasMore: page.hasNextPage,
+    };
+}
+/**
+ * Which of an order's lines can go back in the cart, and how many of each, by the cart's stock rule
+ * (`stockCeiling`, as `useAddToCart` checks it): a quantity over what is left is cut to what is left,
+ * counting what the cart already holds and what earlier lines of this order take. `variants` are read
+ * fresh; a line whose variant isn't among them no longer exists.
+ *
+ * A variant still sold out and enrolled in pre-order (a selling plan) goes back on that plan, at the
+ * ordered quantity: a pre-order isn't limited by stock. Everything else goes back as an ordinary line.
+ * The same "sold out and on a plan" rule as the Waitlist's pre-order add. Decided 2026-10-04 by the
+ * Head of Engineering: "if item is still out of stock with selling plan add them as pre order
+ * otherwise add it normally".
+ *
+ * `options.skipVariant` leaves out (and counts as skipped) every line whose variant it returns true
+ * for, before anything is added or claimed. The app passes Cart Hold's `isHeldOut`, so a size whose
+ * every unit was just found held in other carts isn't tried again. Decided 2026-10-04 by the Head of
+ * Engineering.
+ */
+function planBuyAgain(lines, variants, cart, options = {}) {
+    var _a, _b, _c, _d;
+    const byId = new Map(variants.map((variant) => [variant.id, variant]));
+    const planned = new Map();
+    const inputs = [];
+    let skipped = 0;
+    for (const line of lines) {
+        const variant = line.variantId ? byId.get(line.variantId) : undefined;
+        if (!variant || !variant.availableForSale || line.quantity <= 0) {
+            skipped += 1;
+            continue;
+        }
+        if ((_a = options.skipVariant) === null || _a === void 0 ? void 0 : _a.call(options, variant.id)) {
+            skipped += 1;
+            continue;
+        }
+        if (((_b = variant.quantityAvailable) !== null && _b !== void 0 ? _b : 0) <= 0 && variant.sellingPlan) {
+            inputs.push({ merchandiseId: variant.id, quantity: line.quantity, sellingPlanId: variant.sellingPlan.id });
+            continue;
+        }
+        const ceiling = (0, productPage_1.stockCeiling)(variant);
+        const taken = (0, productPage_1.quantityInCart)(cart, variant.id) + ((_c = planned.get(variant.id)) !== null && _c !== void 0 ? _c : 0);
+        const quantity = ceiling === null ? line.quantity : Math.min(line.quantity, ceiling - taken);
+        if (quantity <= 0) {
+            skipped += 1;
+            continue;
+        }
+        planned.set(variant.id, ((_d = planned.get(variant.id)) !== null && _d !== void 0 ? _d : 0) + quantity);
+        inputs.push({ merchandiseId: variant.id, quantity });
+    }
+    return { inputs, skipped };
+}
+//# sourceMappingURL=orders.js.map

package/dist/orders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orders.js","sourceRoot":"","sources":["../src/orders.ts"],"names":[],"mappings":"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"}

package/dist/productPage.d.ts

@@ -0,0 +1,100 @@
+import type { ProductBase } from './productStore';
+import type { Cart, Money, Product, ProductMedia, ProductOption, ProductVariant } from './types';
+/** What the page logic needs of a product: the full product, or the store's preview of it. */
+export type ProductLike = ProductBase & Partial<Pick<Product, 'media' | 'onlineStoreUrl' | 'images'>>;
+/** Chosen value per option name, e.g. `{ Size: 'SM', Color: 'Wine' }`. */
+export type OptionSelection = Record<string, string>;
+/** Selectors are shown Color, then Size, then anything else (case-insensitive). */
+export declare const DEFAULT_OPTION_ORDER: readonly string[];
+/**
+ * Shopify gives a single-variant product a placeholder option ("Title" with the one value "Default
+ * Title"). It is not a choice and must not become a selector.
+ */
+export declare function isPlaceholderOption(option: ProductOption): boolean;
+export interface SelectableOptionsConfig {
+    /** Option names in display order (case-insensitive); unlisted ones keep their order after these. */
+    order?: readonly string[];
+    /** Keep an option (default: everything but the placeholder). */
+    include?: (option: ProductOption) => boolean;
+}
+/** The options worth a selector, in display order. */
+export declare function selectableOptions(options: ProductOption[] | null | undefined, config?: SelectableOptionsConfig): ProductOption[];
+/** The variant matching every chosen value, or null for a combination Shopify doesn't sell. */
+export declare function findVariant(variants: ProductVariant[] | null | undefined, selection: OptionSelection): ProductVariant | null;
+/** The first purchasable combination, so Add to Cart works without touching a selector; else the first. */
+export declare function initialSelection(variants: ProductVariant[] | null | undefined): OptionSelection;
+/** The selection a variant represents, e.g. to preselect a variant from a link. */
+export declare function selectionForVariant(variant: ProductVariant | null | undefined): OptionSelection;
+/**
+ * Can't be bought now: no such combination, not for sale, or none left. A variant can be 0 left and
+ * still for sale (oversell / pre-order) only if `quantityAvailable` isn't 0, so 0 is treated as gone.
+ */
+export declare function isVariantUnavailable(variant: ProductVariant | null | undefined): boolean;
+export interface OptionValueState {
+    value: string;
+    selected: boolean;
+    /** The variant this value would select, keeping the other options as they are. */
+    variant: ProductVariant | null;
+    available: boolean;
+    /** Units left of that variant; null when Shopify doesn't track it. */
+    quantityAvailable: number | null;
+}
+export interface OptionState {
+    name: string;
+    selectedValue: string | null;
+    values: OptionValueState[];
+}
+/**
+ * Every value of every option with what choosing it would give. Stock is per combination, so a
+ * Size's count follows the selected Color and vice versa.
+ */
+export declare function optionStates(options: ProductOption[], variants: ProductVariant[] | null | undefined, selection: OptionSelection, isUnavailable?: (variant: ProductVariant | null) => boolean): OptionState[];
+/** "Ivory / L": the chosen values, in the options' order. */
+export declare function selectionLabel(options: ProductOption[], selection: OptionSelection, separator?: string): string;
+export interface VariantPrice {
+    price: Money | null;
+    /** Only when it is above `price`; Shopify returns "0.0" for "no compare-at". */
+    compareAtPrice: Money | null;
+    onSale: boolean;
+}
+/** The chosen variant's price; without a variant, the product's lowest. */
+export declare function variantPrice(variant: ProductVariant | null | undefined, product?: Pick<ProductBase, 'priceRange' | 'compareAtPriceRange'> | null): VariantPrice;
+/** "Hurry! Only a few pieces left." at or below this many units across the product. */
+export declare const DEFAULT_LOW_STOCK_THRESHOLD = 10;
+export declare function isLowStock(totalInventory: number | null | undefined, availableForSale: boolean | undefined, threshold?: number | null): boolean;
+/**
+ * The most of `variant` a cart may hold, or null for no ceiling. Shopify doesn't refuse an add past
+ * the stock level (it answers 200 and clamps silently), so the ceiling is checked before the write.
+ * null: untracked inventory, or overselling allowed (`<= 0` while still for sale, e.g. pre-order).
+ */
+export declare function stockCeiling(variant: Pick<ProductVariant, 'availableForSale' | 'quantityAvailable'> | null | undefined): number | null;
+/** How many of `variantId` the cart holds, across every line (one variant can fill several). */
+export declare function quantityInCart(cart: Pick<Cart, 'lines'> | null | undefined, variantId: string | null | undefined): number;
+/** Whether `current + by` stays within `ceiling` (null: always). */
+export declare function withinCeiling(ceiling: number | null, current: number, by?: number): boolean;
+/** The gallery's opening slide: the first video when asked for (and there is one), else the first image. */
+export declare function initialMediaIndex(media: ProductMedia[] | null | undefined, preferVideo?: boolean): number;
+/** The first still, for a thumbnail. Videos sort first, so `media[0]` is often a video frame. */
+export declare function firstImageUrl(product: Pick<ProductLike, 'media' | 'featuredImage'> | null | undefined): string | null;
+export declare function sizedImageUrl(url: string | null | undefined, pixels: number): string | null;
+export type DescriptionSpan = {
+    text: string;
+    bold: boolean;
+};
+/** A paragraph or a bullet. */
+export type DescriptionBlock = {
+    spans: DescriptionSpan[];
+    bullet: boolean;
+};
+/**
+ * Shopify's `descriptionHtml` as paragraphs and bullets with their bold runs (the "Details:" /
+ * "Fit:" labels), for nested Text rather than an HTML renderer. Plain text works too.
+ */
+export declare function parseDescriptionHtml(html: string | null | undefined): DescriptionBlock[];
+/**
+ * The link to share: Shopify's `onlineStoreUrl` (a page a shopper can open), else
+ * `https://<storeDomain>/products/<handle>`, which on a store not on the Online Store channel is the
+ * myshopify host. `storeDomain` defaults to the configured one.
+ */
+export declare function productShareUrl(product: Pick<ProductLike, 'handle' | 'onlineStoreUrl'> | null | undefined, storeDomain?: string): string | null;
+//# sourceMappingURL=productPage.d.ts.map

package/dist/productPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"productPage.d.ts","sourceRoot":"","sources":["../src/productPage.ts"],"names":[],"mappings":"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"}