@aglyn/plugins-commerce 1.0.0-beta.230 → 1.0.0-beta.232

package/src/lib/model/shipstation.js

@@ -0,0 +1,399 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { PLATFORM_BRAND_NAME } from "@aglyn/aglyn/app-utils/platform-brand";
+import { lineRequiresShipping } from "./order-fulfillment.js";
+import { gramsToOunces, shippingLines, shippingOrderNumber } from "./order-shipping-export.js";
+/*
+ * SHIPSTATION'S CUSTOM STORE, AS PURE DATA (AGL-3613).
+ *
+ * ShipStation pulls a store's orders from one URL the merchant pastes into
+ * its Custom Store connection, and posts each shipment back to the same URL
+ * (Custom Store Development Guide, help.shipstation.com, read 2026-10-06):
+ *
+ * - `GET ?action=export&start_date=&end_date=&page=` answers an `<Orders
+ *   pages="n">` document of every order MODIFIED in the window, whatever its
+ *   status. Dates are UTC, `MM/dd/yyyy HH:mm`. Free text sits in CDATA.
+ * - `POST ?action=shipnotify&order_number=&carrier=&service=&tracking_number=`
+ *   carries a `<ShipNotice>` body naming the shipped items; any 2xx is
+ *   success.
+ *
+ * This module writes the feed and reads the notice. The route that serves
+ * them, its credentials and its query live in `server/shipstation.ts`.
+ *
+ * ## The status names a merchant types into ShipStation
+ *
+ * ShipStation maps a store's own status names onto its five, and the mapping
+ * is case-sensitive. These are the names this feed writes; the connection
+ * card and the guide print them for the merchant to copy.
+ */ export const SHIPSTATION_STATUS_NAMES = {
+    unpaid: 'unpaid',
+    paid: 'paid',
+    shipped: 'shipped',
+    canceled: 'canceled',
+    onHold: 'on_hold'
+};
+/** An Aglyn order status as the feed names it to ShipStation. */ export function shipStationOrderStatus(status) {
+    switch(status){
+        case 'pending':
+            return SHIPSTATION_STATUS_NAMES.unpaid;
+        case 'paid':
+        case 'partially_fulfilled':
+            return SHIPSTATION_STATUS_NAMES.paid;
+        case 'fulfilled':
+        case 'delivered':
+            return SHIPSTATION_STATUS_NAMES.shipped;
+        case 'cancelled':
+        case 'refunded':
+            return SHIPSTATION_STATUS_NAMES.canceled;
+    }
+}
+/** Orders per page of the feed. ShipStation follows `pages` until it has them all. */ export const SHIPSTATION_PAGE_SIZE = 100;
+/** The widest window one request may ask for: a year, which no import needs. */ export const SHIPSTATION_MAX_WINDOW_MS = 366 * 24 * 60 * 60 * 1000;
+const pad = (value)=>String(value).padStart(2, '0');
+/** Epoch milliseconds as ShipStation's `MM/dd/yyyy HH:mm`, in UTC. */ export function formatShipStationDate(ms) {
+    const date = new Date(ms);
+    return `${pad(date.getUTCMonth() + 1)}/${pad(date.getUTCDate())}/${date.getUTCFullYear()} ` + `${pad(date.getUTCHours())}:${pad(date.getUTCMinutes())}`;
+}
+/**
+ * ShipStation's `MM/dd/yyyy HH:mm` (UTC; seconds and AM/PM tolerated) as
+ * epoch milliseconds, or `null` when the text is not a date. An ISO date is
+ * read too, for a merchant testing the URL by hand.
+ */ export function parseShipStationDate(value) {
+    const text = String(value != null ? value : '').trim();
+    if (!text) return null;
+    const match = /^(\d{1,2})\/(\d{1,2})\/(\d{4})(?:[ T]+(\d{1,2}):(\d{2})(?::(\d{2}))?\s*([AaPp][Mm])?)?$/.exec(text);
+    if (match) {
+        const [, month, day, year, hourText, minute, second, meridiem] = match;
+        let hour = Number(hourText != null ? hourText : 0);
+        if (meridiem) {
+            const pm = meridiem.toLowerCase() === 'pm';
+            if (hour === 12) hour = pm ? 12 : 0;
+            else if (pm) hour += 12;
+        }
+        const ms = Date.UTC(Number(year), Number(month) - 1, Number(day), hour, Number(minute != null ? minute : 0), Number(second != null ? second : 0));
+        const check = new Date(ms);
+        if (check.getUTCMonth() !== Number(month) - 1 || check.getUTCDate() !== Number(day) || hour > 23) return null;
+        return ms;
+    }
+    if (/^\d{4}-\d{2}-\d{2}/.test(text)) {
+        const ms = Date.parse(text);
+        return Number.isFinite(ms) ? ms : null;
+    }
+    return null;
+}
+/** The weights the shared shipping reading takes, from the products' facts. */ export function weightsOfProducts(products) {
+    const weights = {};
+    for (const [productId, variants] of Object.entries(products)){
+        for (const [variantId, facts] of Object.entries(variants)){
+            if (typeof facts.grams === 'number' && facts.grams > 0) {
+                var _weights, _productId, _;
+                ;
+                ((_ = (_weights = weights)[_productId = productId]) != null ? _ : _weights[_productId] = {})[variantId] = facts.grams;
+            }
+        }
+    }
+    return weights;
+}
+function factsFor(line, products) {
+    var _products_line_productId, _variants_;
+    const variants = (_products_line_productId = products[line.productId]) != null ? _products_line_productId : {};
+    const own = line.variantId ? variants[line.variantId] : undefined;
+    const base = (_variants_ = variants['']) != null ? _variants_ : {};
+    return _extends({}, base, own != null ? own : {});
+}
+/** Characters XML 1.0 cannot carry at all, dropped before anything is written. */ // eslint-disable-next-line no-control-regex
+const XML_INVALID = /[\u0000-\u0008\u000B\u000C\u000E-\u001F￾￿]/g;
+/** Text bounded to `max` characters with every character XML refuses dropped. */ function bounded(value, max) {
+    const text = value === null || value === undefined ? '' : String(value);
+    return text.replace(XML_INVALID, '').trim().slice(0, max);
+}
+/**
+ * Free text as a CDATA section, as the guide asks. A `]]>` inside the text
+ * would end the section early, so it is split across two sections — the
+ * standard escape, which reads back as the same characters.
+ */ export function xmlCdata(value, max) {
+    const text = bounded(value, max);
+    return text ? `<![CDATA[${text.replace(/]]>/g, ']]]]><![CDATA[>')}]]>` : '';
+}
+/** A plain value (a number, a date, a code) with the five XML entities escaped. */ export function xmlText(value, max = 100) {
+    return bounded(value, max).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&apos;');
+}
+/** Cents as the feed's decimal dollars, `12.50`. */ function money(cents) {
+    const value = Math.round(Number(cents != null ? cents : 0));
+    return (Number.isFinite(value) ? value / 100 : 0).toFixed(2);
+}
+const element = (name, inner)=>`<${name}>${inner}</${name}>`;
+/**
+ * Whether ShipStation can take this order at all: it insists on a ship-to
+ * name, street, city, postal code and two-letter country. An order without
+ * them could never become a label, and one invalid `<Order>` fails the whole
+ * import, so it is left out of the feed rather than sent with a guess.
+ */ export function shipStationCanImport(order) {
+    var _address_country, _address_line1, _address_city, _address_postalCode, _ref, _address_name;
+    const address = order.shippingAddress;
+    if (!address) return false;
+    const country = String((_address_country = address.country) != null ? _address_country : '').trim();
+    return Boolean(String((_address_line1 = address.line1) != null ? _address_line1 : '').trim() && String((_address_city = address.city) != null ? _address_city : '').trim() && String((_address_postalCode = address.postalCode) != null ? _address_postalCode : '').trim() && /^[A-Za-z]{2}$/.test(country) && String((_ref = (_address_name = address.name) != null ? _address_name : order.customerName) != null ? _ref : '').trim());
+}
+/**
+ * The items an order sends ShipStation. An order still to be shipped sends
+ * what is LEFT — a partially fulfilled order asks for the rest, never the
+ * whole order twice. A shipped or canceled order sends its shippable lines
+ * whole, which ShipStation only reads to show the order it is moving.
+ */ function feedItems(source, products) {
+    var _order_status, _order_lineItems, _order_fulfillments, _ref;
+    var _order_totals;
+    const { order } = source;
+    const status = (_order_status = order.status) != null ? _order_status : 'paid';
+    const lineItems = (_order_lineItems = order.lineItems) != null ? _order_lineItems : [];
+    const open = status === 'paid' || status === 'partially_fulfilled' || status === 'pending';
+    const entries = open ? shippingLines({
+        lineItems,
+        fulfillments: (_order_fulfillments = order.fulfillments) != null ? _order_fulfillments : []
+    }, weightsOfProducts(products)).map((entry)=>({
+            lineItemId: entry.lineItemId,
+            line: entry.line,
+            quantity: entry.quantity
+        })) : lineItems.map((line, lineItemId)=>{
+        var _ref;
+        return {
+            lineItemId,
+            line,
+            quantity: Math.max(0, Math.floor(Number((_ref = line == null ? void 0 : line.quantity) != null ? _ref : 0)))
+        };
+    }).filter((entry)=>entry.line && lineRequiresShipping(entry.line) && entry.quantity > 0);
+    const items = entries.map(({ lineItemId, line, quantity })=>{
+        var _facts_options;
+        const facts = factsFor(line, products);
+        const ounces = typeof facts.grams === 'number' && facts.grams > 0 ? gramsToOunces(facts.grams) : null;
+        const options = Object.entries((_facts_options = facts.options) != null ? _facts_options : {}).filter(([name, value])=>String(name).trim() && String(value).trim()).slice(0, 10);
+        return element('Item', [
+            element('LineItemID', xmlText(String(lineItemId), 50)),
+            element('SKU', xmlCdata(line.sku || (line.variantId ? `${line.productId}-${line.variantId}` : line.productId), 100)),
+            element('Name', xmlCdata(`${line.name}${line.variantLabel ? ` (${line.variantLabel})` : ''}`, 200)),
+            facts.imageUrl && /^https:\/\//.test(facts.imageUrl) ? element('ImageUrl', xmlCdata(facts.imageUrl, 500)) : '',
+            ounces !== null ? element('Weight', ounces.toFixed(2)) + element('WeightUnits', 'Ounces') : '',
+            element('Quantity', String(quantity)),
+            element('UnitPrice', money(line.unitAmountCents)),
+            options.length ? element('Options', options.map(([name, value])=>element('Option', element('Name', xmlCdata(name, 100)) + element('Value', xmlCdata(value, 100)))).join('')) : ''
+        ].join(''));
+    });
+    // The order's discount, as the guide's adjustment line: negative and
+    // flagged, so ShipStation's totals agree with what the buyer paid.
+    const discountCents = Math.round(Number((_ref = (_order_totals = order.totals) == null ? void 0 : _order_totals.discountCents) != null ? _ref : 0));
+    if (discountCents > 0) {
+        items.push(element('Item', element('SKU', '') + element('Name', xmlCdata(order.couponCode ? `Discount (${order.couponCode})` : 'Discount', 200)) + element('Quantity', '1') + element('UnitPrice', `-${money(discountCents)}`) + element('Adjustment', 'true')));
+    }
+    return items;
+}
+/** One `<Order>` element of the feed. */ export function shipStationOrderXml(source, products = {}) {
+    var _order_status, _order_createdAtMs, _order_updatedAtMs, _order_shippingAddress, _order_billingAddress, _ref, _ship_country;
+    const { docId, order } = source;
+    const status = (_order_status = order.status) != null ? _order_status : 'paid';
+    const created = Number((_order_createdAtMs = order.createdAtMs) != null ? _order_createdAtMs : 0) || Date.now();
+    const modified = Number((_order_updatedAtMs = order.updatedAtMs) != null ? _order_updatedAtMs : created) || created;
+    const ship = (_order_shippingAddress = order.shippingAddress) != null ? _order_shippingAddress : {};
+    const bill = (_order_billingAddress = order.billingAddress) != null ? _order_billingAddress : {};
+    const email = bounded(order.customerEmail, 100);
+    const recipient = ship.name || order.customerName || '';
+    const totals = order.totals;
+    return element('Order', [
+        element('OrderID', xmlCdata(docId, 50)),
+        element('OrderNumber', xmlCdata(shippingOrderNumber(order, docId), 50)),
+        element('OrderDate', formatShipStationDate(created)),
+        element('OrderStatus', xmlCdata(shipStationOrderStatus(status), 50)),
+        element('LastModified', formatShipStationDate(modified)),
+        element('CurrencyCode', 'USD'),
+        element('OrderTotal', money((_ref = totals == null ? void 0 : totals.totalCents) != null ? _ref : order.amountCents)),
+        element('TaxAmount', money(totals == null ? void 0 : totals.taxCents)),
+        element('ShippingAmount', money(totals == null ? void 0 : totals.shippingCents)),
+        order.note ? element('InternalNotes', xmlCdata(order.note, 1000)) : '',
+        element('Source', xmlCdata(order.channel === 'pos' ? `${PLATFORM_BRAND_NAME} POS` : PLATFORM_BRAND_NAME, 50)),
+        element('Customer', [
+            element('CustomerCode', xmlCdata(email || docId, 100)),
+            element('BillTo', [
+                element('Name', xmlCdata(bill.name || order.customerName || recipient, 100)),
+                bill.phone || order.customerPhone ? element('Phone', xmlCdata(bill.phone || order.customerPhone, 50)) : '',
+                email ? element('Email', xmlCdata(email, 100)) : ''
+            ].join('')),
+            element('ShipTo', [
+                element('Name', xmlCdata(recipient, 100)),
+                element('Address1', xmlCdata(ship.line1, 200)),
+                ship.line2 ? element('Address2', xmlCdata(ship.line2, 200)) : '',
+                element('City', xmlCdata(ship.city, 100)),
+                ship.state ? element('State', xmlCdata(ship.state, 100)) : '',
+                element('PostalCode', xmlCdata(ship.postalCode, 50)),
+                element('Country', xmlCdata(String((_ship_country = ship.country) != null ? _ship_country : '').toUpperCase(), 2)),
+                ship.phone ? element('Phone', xmlCdata(ship.phone, 50)) : ''
+            ].join(''))
+        ].join('')),
+        element('Items', feedItems(source, products).join(''))
+    ].join(''));
+}
+/** The whole `<Orders>` document for one page. */ export function shipStationOrdersXml(orders, pages) {
+    return `<?xml version="1.0" encoding="utf-8"?>\n<Orders pages="${Math.max(1, Math.floor(pages))}">${orders.join('')}</Orders>`;
+}
+const XML_ENTITIES = {
+    lt: '<',
+    gt: '>',
+    amp: '&',
+    quot: '"',
+    apos: "'"
+};
+/** XML character data with its five entities and numeric references decoded. Nothing else expands. */ function decodeEntities(text) {
+    return text.replace(/&(#x[0-9a-fA-F]{1,6}|#\d{1,7}|lt|gt|amp|quot|apos);/g, (whole, code)=>{
+        var _XML_ENTITIES_code;
+        if (code[0] !== '#') return (_XML_ENTITIES_code = XML_ENTITIES[code]) != null ? _XML_ENTITIES_code : whole;
+        const point = code[1] === 'x' ? parseInt(code.slice(2), 16) : parseInt(code.slice(1), 10);
+        return Number.isFinite(point) && point > 0 && point <= 0x10ffff ? String.fromCodePoint(point) : '';
+    });
+}
+/** An element's content as text: CDATA sections taken as written, the rest entity-decoded. */ function contentText(raw) {
+    let out = '';
+    let at = 0;
+    const cdata = /<!\[CDATA\[([\s\S]*?)\]\]>/g;
+    for(let match = cdata.exec(raw); match; match = cdata.exec(raw)){
+        out += decodeEntities(raw.slice(at, match.index).replace(/<[^>]*>/g, ''));
+        out += match[1];
+        at = match.index + match[0].length;
+    }
+    out += decodeEntities(raw.slice(at).replace(/<[^>]*>/g, ''));
+    return out.trim();
+}
+/** The text of the first `<name>` element in `xml`, or `''`. */ function elementText(xml, name) {
+    const match = new RegExp(`<${name}(?:\\s[^>]*)?>([\\s\\S]*?)</${name}\\s*>`).exec(xml);
+    return match ? contentText(match[1]) : '';
+}
+/** The inner XML of every `<name>` element in `xml`. */ function elementBodies(xml, name) {
+    const pattern = new RegExp(`<${name}(?:\\s[^>]*)?>([\\s\\S]*?)</${name}\\s*>`, 'g');
+    const bodies = [];
+    for(let match = pattern.exec(xml); match; match = pattern.exec(xml))bodies.push(match[1]);
+    return bodies;
+}
+/**
+ * A `<ShipNotice>` body read into a notice, or the reason it cannot be.
+ *
+ * Read by name, not by a general parser: the notice is a fixed, flat set of
+ * elements, and a document type declaration is refused outright, so no
+ * entity is ever defined or expanded beyond XML's five. The query string's
+ * `order_number`, `carrier`, `service` and `tracking_number` win when
+ * present — the guide names them first — and the body fills the rest.
+ */ export function readShipNotice(xml, query) {
+    var _elementBodies_, _elementBodies_1, _query_order_number, _query_carrier, _query_service, _query_tracking_number;
+    const body = String(xml != null ? xml : '');
+    if (/<!DOCTYPE|<!ENTITY/i.test(body)) return {
+        problem: `The notice declares a document type, which ${PLATFORM_BRAND_NAME} does not read.`
+    };
+    const root = (_elementBodies_ = elementBodies(body, 'ShipNotice')[0]) != null ? _elementBodies_ : '';
+    if (body.trim() && !root) return {
+        problem: 'The notice is not a ShipNotice.'
+    };
+    const itemsBlock = (_elementBodies_1 = elementBodies(root, 'Items')[0]) != null ? _elementBodies_1 : '';
+    const items = elementBodies(itemsBlock, 'Item').map((entry)=>({
+            lineItemId: elementText(entry, 'LineItemID') || null,
+            sku: elementText(entry, 'SKU') || null,
+            name: elementText(entry, 'Name') || null,
+            quantity: Math.floor(Number(elementText(entry, 'Quantity')))
+        })).filter((entry)=>Number.isFinite(entry.quantity) && entry.quantity > 0);
+    // The order-level fields, read from the notice with its Items and
+    // Recipient taken out, so a recipient's or an item's element never
+    // answers for the order's.
+    const top = root.replace(/<Items(?:\s[^>]*)?>[\s\S]*?<\/Items\s*>/g, '').replace(/<Recipient(?:\s[^>]*)?>[\s\S]*?<\/Recipient\s*>/g, '');
+    return {
+        orderNumber: String((_query_order_number = query['order_number']) != null ? _query_order_number : '').trim() || elementText(top, 'OrderNumber') || null,
+        orderId: elementText(top, 'OrderID') || null,
+        carrier: String((_query_carrier = query['carrier']) != null ? _query_carrier : '').trim() || elementText(top, 'Carrier'),
+        service: String((_query_service = query['service']) != null ? _query_service : '').trim() || elementText(top, 'Service'),
+        trackingNumber: String((_query_tracking_number = query['tracking_number']) != null ? _query_tracking_number : '').trim() || elementText(top, 'TrackingNumber'),
+        items
+    };
+}
+/**
+ * ShipStation's carrier code as a name a buyer reads and `trackingUrlFor`
+ * knows — `usps` → `USPS`, `fedex` → `FedEx`. An unknown code is passed on
+ * as sent, upper-cased at the first letter.
+ */ export function shipStationCarrierName(code) {
+    const key = code.trim().toLowerCase();
+    const known = {
+        usps: 'USPS',
+        stamps_com: 'USPS',
+        endicia: 'USPS',
+        express_1: 'USPS',
+        ups: 'UPS',
+        ups_walleted: 'UPS',
+        ups_mail_innovations: 'UPS',
+        fedex: 'FedEx',
+        fedex_uk: 'FedEx',
+        fedex_walleted: 'FedEx',
+        dhl_express: 'DHL',
+        dhl_express_uk: 'DHL',
+        dhl_express_canada: 'DHL',
+        dhl_express_australia: 'DHL',
+        dhl_ecommerce: 'DHL eCommerce',
+        dhl_global_mail: 'DHL eCommerce',
+        canada_post: 'Canada Post',
+        canada_post_walleted: 'Canada Post',
+        royal_mail: 'Royal Mail',
+        australia_post: 'Australia Post',
+        ontrac: 'OnTrac',
+        lasership: 'LaserShip'
+    };
+    if (known[key]) return known[key];
+    if (!key) return '';
+    return code.trim().charAt(0).toUpperCase() + code.trim().slice(1);
+}
+/**
+ * Which order lines and how many units a notice ships, against the order.
+ * An item is found by the `LineItemID` the feed sent (the line's index),
+ * then by SKU among the lines still to ship. `null` lines means the notice
+ * named no items: everything still to ship went in this parcel. An item that
+ * names no line of this order is reported, not guessed at.
+ */ export function shipNoticeLines(order, items) {
+    var _order_lineItems;
+    if (!items.length) return {
+        lines: null,
+        unknown: []
+    };
+    const lineItems = (_order_lineItems = order.lineItems) != null ? _order_lineItems : [];
+    const lines = [];
+    const unknown = [];
+    for (const item of items){
+        const index = item.lineItemId !== null && /^\d+$/.test(item.lineItemId) ? Number(item.lineItemId) : NaN;
+        let lineItemId = Number.isInteger(index) && index < lineItems.length ? index : -1;
+        if (lineItemId < 0 && item.sku) {
+            const wanted = item.sku.trim().toLowerCase();
+            lineItemId = lineItems.findIndex((line)=>{
+                var _line_sku;
+                return ((_line_sku = line.sku) != null ? _line_sku : '').trim().toLowerCase() === wanted || (line.variantId ? `${line.productId}-${line.variantId}` : line.productId).toLowerCase() === wanted;
+            });
+        }
+        if (lineItemId < 0) {
+            unknown.push(item.sku || item.name || item.lineItemId || '?');
+            continue;
+        }
+        lines.push({
+            lineItemId,
+            quantity: item.quantity
+        });
+    }
+    return {
+        lines,
+        unknown
+    };
+}
+
+//# sourceMappingURL=shipstation.js.map

package/src/lib/model/shipstation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/shipstation.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { PLATFORM_BRAND_NAME } from '@aglyn/aglyn/app-utils/platform-brand'\nimport type { HostOrder, OrderLineItem, OrderStatus } from './commerce-orders'\nimport { lineRequiresShipping } from './order-fulfillment'\nimport {\n  gramsToOunces,\n  shippingLines,\n  shippingOrderNumber,\n  type ProductWeights,\n} from './order-shipping-export'\n\n/*\n * SHIPSTATION'S CUSTOM STORE, AS PURE DATA (AGL-3613).\n *\n * ShipStation pulls a store's orders from one URL the merchant pastes into\n * its Custom Store connection, and posts each shipment back to the same URL\n * (Custom Store Development Guide, help.shipstation.com, read 2026-10-06):\n *\n * - `GET ?action=export&start_date=&end_date=&page=` answers an `<Orders\n *   pages=\"n\">` document of every order MODIFIED in the window, whatever its\n *   status. Dates are UTC, `MM/dd/yyyy HH:mm`. Free text sits in CDATA.\n * - `POST ?action=shipnotify&order_number=&carrier=&service=&tracking_number=`\n *   carries a `<ShipNotice>` body naming the shipped items; any 2xx is\n *   success.\n *\n * This module writes the feed and reads the notice. The route that serves\n * them, its credentials and its query live in `server/shipstation.ts`.\n *\n * ## The status names a merchant types into ShipStation\n *\n * ShipStation maps a store's own status names onto its five, and the mapping\n * is case-sensitive. These are the names this feed writes; the connection\n * card and the guide print them for the merchant to copy.\n */\n\nexport const SHIPSTATION_STATUS_NAMES = {\n  unpaid: 'unpaid',\n  paid: 'paid',\n  shipped: 'shipped',\n  canceled: 'canceled',\n  onHold: 'on_hold',\n} as const\n\n/** An Aglyn order status as the feed names it to ShipStation. */\nexport function shipStationOrderStatus(status: OrderStatus): string {\n  switch (status) {\n    case 'pending':\n      return SHIPSTATION_STATUS_NAMES.unpaid\n    case 'paid':\n    case 'partially_fulfilled':\n      return SHIPSTATION_STATUS_NAMES.paid\n    case 'fulfilled':\n    case 'delivered':\n      return SHIPSTATION_STATUS_NAMES.shipped\n    case 'cancelled':\n    case 'refunded':\n      return SHIPSTATION_STATUS_NAMES.canceled\n  }\n}\n\n/** Orders per page of the feed. ShipStation follows `pages` until it has them all. */\nexport const SHIPSTATION_PAGE_SIZE = 100\n\n/** The widest window one request may ask for: a year, which no import needs. */\nexport const SHIPSTATION_MAX_WINDOW_MS = 366 * 24 * 60 * 60 * 1000\n\nconst pad = (value: number): string => String(value).padStart(2, '0')\n\n/** Epoch milliseconds as ShipStation's `MM/dd/yyyy HH:mm`, in UTC. */\nexport function formatShipStationDate(ms: number): string {\n  const date = new Date(ms)\n  return (\n    `${pad(date.getUTCMonth() + 1)}/${pad(date.getUTCDate())}/${date.getUTCFullYear()} ` +\n    `${pad(date.getUTCHours())}:${pad(date.getUTCMinutes())}`\n  )\n}\n\n/**\n * ShipStation's `MM/dd/yyyy HH:mm` (UTC; seconds and AM/PM tolerated) as\n * epoch milliseconds, or `null` when the text is not a date. An ISO date is\n * read too, for a merchant testing the URL by hand.\n */\nexport function parseShipStationDate(value: unknown): number | null {\n  const text = String(value ?? '').trim()\n  if (!text) return null\n  const match = /^(\\d{1,2})\\/(\\d{1,2})\\/(\\d{4})(?:[ T]+(\\d{1,2}):(\\d{2})(?::(\\d{2}))?\\s*([AaPp][Mm])?)?$/.exec(text)\n  if (match) {\n    const [, month, day, year, hourText, minute, second, meridiem] = match\n    let hour = Number(hourText ?? 0)\n    if (meridiem) {\n      const pm = meridiem.toLowerCase() === 'pm'\n      if (hour === 12) hour = pm ? 12 : 0\n      else if (pm) hour += 12\n    }\n    const ms = Date.UTC(Number(year), Number(month) - 1, Number(day), hour, Number(minute ?? 0), Number(second ?? 0))\n    const check = new Date(ms)\n    if (check.getUTCMonth() !== Number(month) - 1 || check.getUTCDate() !== Number(day) || hour > 23) return null\n    return ms\n  }\n  if (/^\\d{4}-\\d{2}-\\d{2}/.test(text)) {\n    const ms = Date.parse(text)\n    return Number.isFinite(ms) ? ms : null\n  }\n  return null\n}\n\n/*==========================================\n * THE ORDERS FEED\n *=========================================*/\n\n/** What the feed knows about one variant of a product, read once per page. */\nexport interface ShipStationProductFacts {\n  grams?: number\n  imageUrl?: string\n  /** The variant's option choices: `{ Size: 'L', Color: 'Blue' }`. */\n  options?: Readonly<Record<string, string>>\n}\n\n/** Product id → variant id (`''` for the product itself) → its facts. */\nexport type ShipStationProducts = Readonly<Record<string, Readonly<Record<string, ShipStationProductFacts>>>>\n\n/** The weights the shared shipping reading takes, from the products' facts. */\nexport function weightsOfProducts(products: ShipStationProducts): ProductWeights {\n  const weights: Record<string, Record<string, number>> = {}\n  for (const [productId, variants] of Object.entries(products)) {\n    for (const [variantId, facts] of Object.entries(variants)) {\n      if (typeof facts.grams === 'number' && facts.grams > 0) {\n        ;(weights[productId] ??= {})[variantId] = facts.grams\n      }\n    }\n  }\n  return weights\n}\n\nfunction factsFor(line: Pick<OrderLineItem, 'productId' | 'variantId'>, products: ShipStationProducts): ShipStationProductFacts {\n  const variants = products[line.productId] ?? {}\n  const own = line.variantId ? variants[line.variantId] : undefined\n  const base = variants[''] ?? {}\n  return { ...base, ...(own ?? {}) }\n}\n\n/** Characters XML 1.0 cannot carry at all, dropped before anything is written. */\n// eslint-disable-next-line no-control-regex\nconst XML_INVALID = /[\\u0000-\\u0008\\u000B\\u000C\\u000E-\\u001F￾￿]/g\n\n/** Text bounded to `max` characters with every character XML refuses dropped. */\nfunction bounded(value: unknown, max: number): string {\n  const text = value === null || value === undefined ? '' : String(value)\n  return text.replace(XML_INVALID, '').trim().slice(0, max)\n}\n\n/**\n * Free text as a CDATA section, as the guide asks. A `]]>` inside the text\n * would end the section early, so it is split across two sections — the\n * standard escape, which reads back as the same characters.\n */\nexport function xmlCdata(value: unknown, max: number): string {\n  const text = bounded(value, max)\n  return text ? `<![CDATA[${text.replace(/]]>/g, ']]]]><![CDATA[>')}]]>` : ''\n}\n\n/** A plain value (a number, a date, a code) with the five XML entities escaped. */\nexport function xmlText(value: unknown, max = 100): string {\n  return bounded(value, max)\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&apos;')\n}\n\n/** Cents as the feed's decimal dollars, `12.50`. */\nfunction money(cents: unknown): string {\n  const value = Math.round(Number(cents ?? 0))\n  return (Number.isFinite(value) ? value / 100 : 0).toFixed(2)\n}\n\nconst element = (name: string, inner: string): string => `<${name}>${inner}</${name}>`\n\n/** One order as the feed needs it: the stored order and its document id. */\nexport interface ShipStationOrderSource {\n  docId: string\n  order: Partial<HostOrder> & { createdAtMs?: number; updatedAtMs?: number }\n}\n\n/**\n * Whether ShipStation can take this order at all: it insists on a ship-to\n * name, street, city, postal code and two-letter country. An order without\n * them could never become a label, and one invalid `<Order>` fails the whole\n * import, so it is left out of the feed rather than sent with a guess.\n */\nexport function shipStationCanImport(order: Partial<HostOrder>): boolean {\n  const address = order.shippingAddress\n  if (!address) return false\n  const country = String(address.country ?? '').trim()\n  return Boolean(\n    String(address.line1 ?? '').trim() &&\n      String(address.city ?? '').trim() &&\n      String(address.postalCode ?? '').trim() &&\n      /^[A-Za-z]{2}$/.test(country) &&\n      String(address.name ?? order.customerName ?? '').trim(),\n  )\n}\n\n/**\n * The items an order sends ShipStation. An order still to be shipped sends\n * what is LEFT — a partially fulfilled order asks for the rest, never the\n * whole order twice. A shipped or canceled order sends its shippable lines\n * whole, which ShipStation only reads to show the order it is moving.\n */\nfunction feedItems(source: ShipStationOrderSource, products: ShipStationProducts): string[] {\n  const { order } = source\n  const status = (order.status ?? 'paid') as OrderStatus\n  const lineItems = order.lineItems ?? []\n  const open = status === 'paid' || status === 'partially_fulfilled' || status === 'pending'\n  const entries = open\n    ? shippingLines({ lineItems, fulfillments: order.fulfillments ?? [] }, weightsOfProducts(products)).map((entry) => ({\n        lineItemId: entry.lineItemId,\n        line: entry.line,\n        quantity: entry.quantity,\n      }))\n    : lineItems\n        .map((line, lineItemId) => ({ lineItemId, line, quantity: Math.max(0, Math.floor(Number(line?.quantity ?? 0))) }))\n        .filter((entry) => entry.line && lineRequiresShipping(entry.line) && entry.quantity > 0)\n  const items = entries.map(({ lineItemId, line, quantity }) => {\n    const facts = factsFor(line, products)\n    const ounces = typeof facts.grams === 'number' && facts.grams > 0 ? gramsToOunces(facts.grams) : null\n    const options = Object.entries(facts.options ?? {})\n      .filter(([name, value]) => String(name).trim() && String(value).trim())\n      .slice(0, 10)\n    return element(\n      'Item',\n      [\n        element('LineItemID', xmlText(String(lineItemId), 50)),\n        element('SKU', xmlCdata(line.sku || (line.variantId ? `${line.productId}-${line.variantId}` : line.productId), 100)),\n        element('Name', xmlCdata(`${line.name}${line.variantLabel ? ` (${line.variantLabel})` : ''}`, 200)),\n        facts.imageUrl && /^https:\\/\\//.test(facts.imageUrl) ? element('ImageUrl', xmlCdata(facts.imageUrl, 500)) : '',\n        ounces !== null ? element('Weight', ounces.toFixed(2)) + element('WeightUnits', 'Ounces') : '',\n        element('Quantity', String(quantity)),\n        element('UnitPrice', money(line.unitAmountCents)),\n        options.length\n          ? element(\n              'Options',\n              options\n                .map(([name, value]) => element('Option', element('Name', xmlCdata(name, 100)) + element('Value', xmlCdata(value, 100))))\n                .join(''),\n            )\n          : '',\n      ].join(''),\n    )\n  })\n  // The order's discount, as the guide's adjustment line: negative and\n  // flagged, so ShipStation's totals agree with what the buyer paid.\n  const discountCents = Math.round(Number(order.totals?.discountCents ?? 0))\n  if (discountCents > 0) {\n    items.push(\n      element(\n        'Item',\n        element('SKU', '') +\n          element('Name', xmlCdata(order.couponCode ? `Discount (${order.couponCode})` : 'Discount', 200)) +\n          element('Quantity', '1') +\n          element('UnitPrice', `-${money(discountCents)}`) +\n          element('Adjustment', 'true'),\n      ),\n    )\n  }\n  return items\n}\n\n/** One `<Order>` element of the feed. */\nexport function shipStationOrderXml(source: ShipStationOrderSource, products: ShipStationProducts = {}): string {\n  const { docId, order } = source\n  const status = (order.status ?? 'paid') as OrderStatus\n  const created = Number(order.createdAtMs ?? 0) || Date.now()\n  const modified = Number(order.updatedAtMs ?? created) || created\n  const ship = order.shippingAddress ?? {}\n  const bill = order.billingAddress ?? {}\n  const email = bounded(order.customerEmail, 100)\n  const recipient = ship.name || order.customerName || ''\n  const totals = order.totals\n  return element(\n    'Order',\n    [\n      element('OrderID', xmlCdata(docId, 50)),\n      element('OrderNumber', xmlCdata(shippingOrderNumber(order, docId), 50)),\n      element('OrderDate', formatShipStationDate(created)),\n      element('OrderStatus', xmlCdata(shipStationOrderStatus(status), 50)),\n      element('LastModified', formatShipStationDate(modified)),\n      element('CurrencyCode', 'USD'),\n      element('OrderTotal', money(totals?.totalCents ?? order.amountCents)),\n      element('TaxAmount', money(totals?.taxCents)),\n      element('ShippingAmount', money(totals?.shippingCents)),\n      order.note ? element('InternalNotes', xmlCdata(order.note, 1000)) : '',\n      element('Source', xmlCdata(order.channel === 'pos' ? `${PLATFORM_BRAND_NAME} POS` : PLATFORM_BRAND_NAME, 50)),\n      element(\n        'Customer',\n        [\n          element('CustomerCode', xmlCdata(email || docId, 100)),\n          element(\n            'BillTo',\n            [\n              element('Name', xmlCdata(bill.name || order.customerName || recipient, 100)),\n              bill.phone || order.customerPhone ? element('Phone', xmlCdata(bill.phone || order.customerPhone, 50)) : '',\n              email ? element('Email', xmlCdata(email, 100)) : '',\n            ].join(''),\n          ),\n          element(\n            'ShipTo',\n            [\n              element('Name', xmlCdata(recipient, 100)),\n              element('Address1', xmlCdata(ship.line1, 200)),\n              ship.line2 ? element('Address2', xmlCdata(ship.line2, 200)) : '',\n              element('City', xmlCdata(ship.city, 100)),\n              ship.state ? element('State', xmlCdata(ship.state, 100)) : '',\n              element('PostalCode', xmlCdata(ship.postalCode, 50)),\n              element('Country', xmlCdata(String(ship.country ?? '').toUpperCase(), 2)),\n              ship.phone ? element('Phone', xmlCdata(ship.phone, 50)) : '',\n            ].join(''),\n          ),\n        ].join(''),\n      ),\n      element('Items', feedItems(source, products).join('')),\n    ].join(''),\n  )\n}\n\n/** The whole `<Orders>` document for one page. */\nexport function shipStationOrdersXml(orders: readonly string[], pages: number): string {\n  return `<?xml version=\"1.0\" encoding=\"utf-8\"?>\\n<Orders pages=\"${Math.max(1, Math.floor(pages))}\">${orders.join('')}</Orders>`\n}\n\n/*==========================================\n * THE SHIP NOTICE\n *=========================================*/\n\n/** One shipped line of a notice. */\nexport interface ShipNoticeItem {\n  lineItemId: string | null\n  sku: string | null\n  name: string | null\n  quantity: number\n}\n\n/** What a ShipNotice says, from its query string and its body together. */\nexport interface ShipNotice {\n  orderNumber: string | null\n  orderId: string | null\n  carrier: string\n  service: string\n  trackingNumber: string\n  items: ShipNoticeItem[]\n}\n\nconst XML_ENTITIES: Readonly<Record<string, string>> = { lt: '<', gt: '>', amp: '&', quot: '\"', apos: \"'\" }\n\n/** XML character data with its five entities and numeric references decoded. Nothing else expands. */\nfunction decodeEntities(text: string): string {\n  return text.replace(/&(#x[0-9a-fA-F]{1,6}|#\\d{1,7}|lt|gt|amp|quot|apos);/g, (whole, code: string) => {\n    if (code[0] !== '#') return XML_ENTITIES[code] ?? whole\n    const point = code[1] === 'x' ? parseInt(code.slice(2), 16) : parseInt(code.slice(1), 10)\n    return Number.isFinite(point) && point > 0 && point <= 0x10ffff ? String.fromCodePoint(point) : ''\n  })\n}\n\n/** An element's content as text: CDATA sections taken as written, the rest entity-decoded. */\nfunction contentText(raw: string): string {\n  let out = ''\n  let at = 0\n  const cdata = /<!\\[CDATA\\[([\\s\\S]*?)\\]\\]>/g\n  for (let match = cdata.exec(raw); match; match = cdata.exec(raw)) {\n    out += decodeEntities(raw.slice(at, match.index).replace(/<[^>]*>/g, ''))\n    out += match[1]\n    at = match.index + match[0].length\n  }\n  out += decodeEntities(raw.slice(at).replace(/<[^>]*>/g, ''))\n  return out.trim()\n}\n\n/** The text of the first `<name>` element in `xml`, or `''`. */\nfunction elementText(xml: string, name: string): string {\n  const match = new RegExp(`<${name}(?:\\\\s[^>]*)?>([\\\\s\\\\S]*?)</${name}\\\\s*>`).exec(xml)\n  return match ? contentText(match[1]) : ''\n}\n\n/** The inner XML of every `<name>` element in `xml`. */\nfunction elementBodies(xml: string, name: string): string[] {\n  const pattern = new RegExp(`<${name}(?:\\\\s[^>]*)?>([\\\\s\\\\S]*?)</${name}\\\\s*>`, 'g')\n  const bodies: string[] = []\n  for (let match = pattern.exec(xml); match; match = pattern.exec(xml)) bodies.push(match[1])\n  return bodies\n}\n\n/**\n * A `<ShipNotice>` body read into a notice, or the reason it cannot be.\n *\n * Read by name, not by a general parser: the notice is a fixed, flat set of\n * elements, and a document type declaration is refused outright, so no\n * entity is ever defined or expanded beyond XML's five. The query string's\n * `order_number`, `carrier`, `service` and `tracking_number` win when\n * present — the guide names them first — and the body fills the rest.\n */\nexport function readShipNotice(\n  xml: string,\n  query: Readonly<Record<string, string | undefined>>,\n): ShipNotice | { problem: string } {\n  const body = String(xml ?? '')\n  if (/<!DOCTYPE|<!ENTITY/i.test(body)) return { problem: `The notice declares a document type, which ${PLATFORM_BRAND_NAME} does not read.` }\n  const root = elementBodies(body, 'ShipNotice')[0] ?? ''\n  if (body.trim() && !root) return { problem: 'The notice is not a ShipNotice.' }\n  const itemsBlock = elementBodies(root, 'Items')[0] ?? ''\n  const items: ShipNoticeItem[] = elementBodies(itemsBlock, 'Item')\n    .map((entry) => ({\n      lineItemId: elementText(entry, 'LineItemID') || null,\n      sku: elementText(entry, 'SKU') || null,\n      name: elementText(entry, 'Name') || null,\n      quantity: Math.floor(Number(elementText(entry, 'Quantity'))),\n    }))\n    .filter((entry) => Number.isFinite(entry.quantity) && entry.quantity > 0)\n  // The order-level fields, read from the notice with its Items and\n  // Recipient taken out, so a recipient's or an item's element never\n  // answers for the order's.\n  const top = root.replace(/<Items(?:\\s[^>]*)?>[\\s\\S]*?<\\/Items\\s*>/g, '').replace(/<Recipient(?:\\s[^>]*)?>[\\s\\S]*?<\\/Recipient\\s*>/g, '')\n  return {\n    orderNumber: String(query['order_number'] ?? '').trim() || elementText(top, 'OrderNumber') || null,\n    orderId: elementText(top, 'OrderID') || null,\n    carrier: String(query['carrier'] ?? '').trim() || elementText(top, 'Carrier'),\n    service: String(query['service'] ?? '').trim() || elementText(top, 'Service'),\n    trackingNumber: String(query['tracking_number'] ?? '').trim() || elementText(top, 'TrackingNumber'),\n    items,\n  }\n}\n\n/**\n * ShipStation's carrier code as a name a buyer reads and `trackingUrlFor`\n * knows — `usps` → `USPS`, `fedex` → `FedEx`. An unknown code is passed on\n * as sent, upper-cased at the first letter.\n */\nexport function shipStationCarrierName(code: string): string {\n  const key = code.trim().toLowerCase()\n  const known: Record<string, string> = {\n    usps: 'USPS',\n    stamps_com: 'USPS',\n    endicia: 'USPS',\n    express_1: 'USPS',\n    ups: 'UPS',\n    ups_walleted: 'UPS',\n    ups_mail_innovations: 'UPS',\n    fedex: 'FedEx',\n    fedex_uk: 'FedEx',\n    fedex_walleted: 'FedEx',\n    dhl_express: 'DHL',\n    dhl_express_uk: 'DHL',\n    dhl_express_canada: 'DHL',\n    dhl_express_australia: 'DHL',\n    dhl_ecommerce: 'DHL eCommerce',\n    dhl_global_mail: 'DHL eCommerce',\n    canada_post: 'Canada Post',\n    canada_post_walleted: 'Canada Post',\n    royal_mail: 'Royal Mail',\n    australia_post: 'Australia Post',\n    ontrac: 'OnTrac',\n    lasership: 'LaserShip',\n  }\n  if (known[key]) return known[key]\n  if (!key) return ''\n  return code.trim().charAt(0).toUpperCase() + code.trim().slice(1)\n}\n\n/**\n * Which order lines and how many units a notice ships, against the order.\n * An item is found by the `LineItemID` the feed sent (the line's index),\n * then by SKU among the lines still to ship. `null` lines means the notice\n * named no items: everything still to ship went in this parcel. An item that\n * names no line of this order is reported, not guessed at.\n */\nexport function shipNoticeLines(\n  order: Pick<HostOrder, 'lineItems' | 'fulfillments'>,\n  items: readonly ShipNoticeItem[],\n): { lines: Array<{ lineItemId: number; quantity: number }> | null; unknown: string[] } {\n  if (!items.length) return { lines: null, unknown: [] }\n  const lineItems = order.lineItems ?? []\n  const lines: Array<{ lineItemId: number; quantity: number }> = []\n  const unknown: string[] = []\n  for (const item of items) {\n    const index = item.lineItemId !== null && /^\\d+$/.test(item.lineItemId) ? Number(item.lineItemId) : NaN\n    let lineItemId = Number.isInteger(index) && index < lineItems.length ? index : -1\n    if (lineItemId < 0 && item.sku) {\n      const wanted = item.sku.trim().toLowerCase()\n      lineItemId = lineItems.findIndex(\n        (line) =>\n          (line.sku ?? '').trim().toLowerCase() === wanted ||\n          (line.variantId ? `${line.productId}-${line.variantId}` : line.productId).toLowerCase() === wanted,\n      )\n    }\n    if (lineItemId < 0) {\n      unknown.push(item.sku || item.name || item.lineItemId || '?')\n      continue\n    }\n    lines.push({ lineItemId, quantity: item.quantity })\n  }\n  return { lines, unknown }\n}\n"],"names":["PLATFORM_BRAND_NAME","lineRequiresShipping","gramsToOunces","shippingLines","shippingOrderNumber","SHIPSTATION_STATUS_NAMES","unpaid","paid","shipped","canceled","onHold","shipStationOrderStatus","status","SHIPSTATION_PAGE_SIZE","SHIPSTATION_MAX_WINDOW_MS","pad","value","String","padStart","formatShipStationDate","ms","date","Date","getUTCMonth","getUTCDate","getUTCFullYear","getUTCHours","getUTCMinutes","parseShipStationDate","text","trim","match","exec","month","day","year","hourText","minute","second","meridiem","hour","Number","pm","toLowerCase","UTC","check","test","parse","isFinite","weightsOfProducts","products","weights","productId","variants","Object","entries","variantId","facts","grams","factsFor","line","own","undefined","base","XML_INVALID","bounded","max","replace","slice","xmlCdata","xmlText","money","cents","Math","round","toFixed","element","name","inner","shipStationCanImport","order","address","shippingAddress","country","Boolean","line1","city","postalCode","customerName","feedItems","source","lineItems","open","fulfillments","map","entry","lineItemId","quantity","floor","filter","items","ounces","options","sku","variantLabel","imageUrl","unitAmountCents","length","join","discountCents","totals","push","couponCode","shipStationOrderXml","ship","docId","created","createdAtMs","now","modified","updatedAtMs","bill","billingAddress","email","customerEmail","recipient","totalCents","amountCents","taxCents","shippingCents","note","channel","phone","customerPhone","line2","state","toUpperCase","shipStationOrdersXml","orders","pages","XML_ENTITIES","lt","gt","amp","quot","apos","decodeEntities","whole","code","point","parseInt","fromCodePoint","contentText","raw","out","at","cdata","index","elementText","xml","RegExp","elementBodies","pattern","bodies","readShipNotice","query","body","problem","root","itemsBlock","top","orderNumber","orderId","carrier","service","trackingNumber","shipStationCarrierName","key","known","usps","stamps_com","endicia","express_1","ups","ups_walleted","ups_mail_innovations","fedex","fedex_uk","fedex_walleted","dhl_express","dhl_express_uk","dhl_express_canada","dhl_express_australia","dhl_ecommerce","dhl_global_mail","canada_post","canada_post_walleted","royal_mail","australia_post","ontrac","lasership","charAt","shipNoticeLines","lines","unknown","item","NaN","isInteger","wanted","findIndex"],"mappings":"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"}

package/src/lib/model/smart-collection-reads.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type Firestore } from 'firebase/firestore';
+import { productCollectionIds, type SmartCollectionRules } from './commerce';
+/**
+ * Every smart catalog collection on the host, with the rules membership is
+ * computed from. Two equalities, which Firestore's single-field indexes
+ * answer without a composite; content collections share the path and are
+ * excluded by `kind`.
+ */
+export declare function readSmartCollections(firestore: Firestore, hostId: string): Promise<SmartCollectionRules[]>;
+/**
+ * The `collectionIds` field for a product as it is about to be written.
+ * Spread it beside the rest of the payload.
+ */
+export declare function productCollectionFields(firestore: Firestore, hostId: string, product: Parameters<typeof productCollectionIds>[0], smartCollections?: readonly SmartCollectionRules[]): Promise<{
+    collectionIds: string[];
+}>;

package/src/lib/model/smart-collection-reads.js

@@ -0,0 +1,63 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { collection, getDocs, query, where } from "firebase/firestore";
+import { productCollectionIds } from "./commerce.js";
+/*
+ * THE HOST'S SMART COLLECTIONS, AS A PRODUCT WRITER NEEDS THEM (AGL-3321).
+ *
+ * A product carries `collectionIds` — the smart collections its rules
+ * answer — because the storefront reads a smart collection no query can
+ * express by that array. So every console path that writes a product's
+ * name, tags, categories, variants or type asks the STORE for the host's
+ * smart collections at the moment it writes, and stamps the membership
+ * `productCollectionIds` computes from them. Asked at write time rather
+ * than read off a listener: a listener's rows can be a cached picture, and a
+ * membership computed from a stale rule set is the drift this field exists
+ * to prevent. When a smart collection itself changes, the
+ * `commerce/collection-membership` route re-stamps every product instead.
+ *
+ * The native app's copy (AGL-3621). The console keeps its own in
+ * `components/console/smart-collections.ts`, untouched, because a web bundle
+ * may not grow by a byte for the app; `smart-collection-reads.spec.ts` holds
+ * the two to the same query and the same answer. Not in the model barrel: it
+ * reads through the browser SDK, and the barrel is server code's too.
+ */ /**
+ * Every smart catalog collection on the host, with the rules membership is
+ * computed from. Two equalities, which Firestore's single-field indexes
+ * answer without a composite; content collections share the path and are
+ * excluded by `kind`.
+ */ export async function readSmartCollections(firestore, hostId) {
+    const snapshot = await getDocs(query(collection(firestore, 'hosts', hostId, 'collections'), where('kind', '==', 'catalog'), where('mode', '==', 'smart')));
+    return snapshot.docs.map((entry)=>{
+        var _entry_get;
+        return {
+            id: entry.id,
+            rules: (_entry_get = entry.get('rules')) != null ? _entry_get : [],
+            matchAll: entry.get('matchAll')
+        };
+    });
+}
+/**
+ * The `collectionIds` field for a product as it is about to be written.
+ * Spread it beside the rest of the payload.
+ */ export async function productCollectionFields(firestore, hostId, product, smartCollections) {
+    const rules = smartCollections != null ? smartCollections : await readSmartCollections(firestore, hostId);
+    return {
+        collectionIds: productCollectionIds(product, rules)
+    };
+}
+
+//# sourceMappingURL=smart-collection-reads.js.map

package/src/lib/model/smart-collection-reads.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/model/smart-collection-reads.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  collection,\n  type Firestore,\n  getDocs,\n  query,\n  where,\n} from 'firebase/firestore'\nimport { productCollectionIds, type SmartCollectionRules } from './commerce'\n\n/*\n * THE HOST'S SMART COLLECTIONS, AS A PRODUCT WRITER NEEDS THEM (AGL-3321).\n *\n * A product carries `collectionIds` — the smart collections its rules\n * answer — because the storefront reads a smart collection no query can\n * express by that array. So every console path that writes a product's\n * name, tags, categories, variants or type asks the STORE for the host's\n * smart collections at the moment it writes, and stamps the membership\n * `productCollectionIds` computes from them. Asked at write time rather\n * than read off a listener: a listener's rows can be a cached picture, and a\n * membership computed from a stale rule set is the drift this field exists\n * to prevent. When a smart collection itself changes, the\n * `commerce/collection-membership` route re-stamps every product instead.\n *\n * The native app's copy (AGL-3621). The console keeps its own in\n * `components/console/smart-collections.ts`, untouched, because a web bundle\n * may not grow by a byte for the app; `smart-collection-reads.spec.ts` holds\n * the two to the same query and the same answer. Not in the model barrel: it\n * reads through the browser SDK, and the barrel is server code's too.\n */\n\n/**\n * Every smart catalog collection on the host, with the rules membership is\n * computed from. Two equalities, which Firestore's single-field indexes\n * answer without a composite; content collections share the path and are\n * excluded by `kind`.\n */\nexport async function readSmartCollections(\n  firestore: Firestore,\n  hostId: string,\n): Promise<SmartCollectionRules[]> {\n  const snapshot = await getDocs(\n    query(\n      collection(firestore, 'hosts', hostId, 'collections'),\n      where('kind', '==', 'catalog'),\n      where('mode', '==', 'smart'),\n    ),\n  )\n  return snapshot.docs.map((entry) => ({\n    id: entry.id,\n    rules: entry.get('rules') ?? [],\n    matchAll: entry.get('matchAll'),\n  }))\n}\n\n/**\n * The `collectionIds` field for a product as it is about to be written.\n * Spread it beside the rest of the payload.\n */\nexport async function productCollectionFields(\n  firestore: Firestore,\n  hostId: string,\n  product: Parameters<typeof productCollectionIds>[0],\n  smartCollections?: readonly SmartCollectionRules[],\n): Promise<{ collectionIds: string[] }> {\n  const rules = smartCollections ?? (await readSmartCollections(firestore, hostId))\n  return { collectionIds: productCollectionIds(product, rules) }\n}\n"],"names":["collection","getDocs","query","where","productCollectionIds","readSmartCollections","firestore","hostId","snapshot","docs","map","entry","id","rules","get","matchAll","productCollectionFields","product","smartCollections","collectionIds"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,UAAU,EAEVC,OAAO,EACPC,KAAK,EACLC,KAAK,QACA,qBAAoB;AAC3B,SAASC,oBAAoB,QAAmC,gBAAY;AAE5E;;;;;;;;;;;;;;;;;;;CAmBC,GAED;;;;;CAKC,GACD,OAAO,eAAeC,qBACpBC,SAAoB,EACpBC,MAAc;IAEd,MAAMC,WAAW,MAAMP,QACrBC,MACEF,WAAWM,WAAW,SAASC,QAAQ,gBACvCJ,MAAM,QAAQ,MAAM,YACpBA,MAAM,QAAQ,MAAM;IAGxB,OAAOK,SAASC,IAAI,CAACC,GAAG,CAAC,CAACC;YAEjBA;eAF4B;YACnCC,IAAID,MAAMC,EAAE;YACZC,KAAK,GAAEF,aAAAA,MAAMG,GAAG,CAAC,oBAAVH,aAAsB,EAAE;YAC/BI,UAAUJ,MAAMG,GAAG,CAAC;QACtB;;AACF;AAEA;;;CAGC,GACD,OAAO,eAAeE,wBACpBV,SAAoB,EACpBC,MAAc,EACdU,OAAmD,EACnDC,gBAAkD;IAElD,MAAML,QAAQK,2BAAAA,mBAAqB,MAAMb,qBAAqBC,WAAWC;IACzE,OAAO;QAAEY,eAAef,qBAAqBa,SAASJ;IAAO;AAC/D"}