@sixtyninecommerce/client 0.24.0 → 0.26.0

package/dist/commerce/customer.js

@@ -12,6 +12,21 @@ function unwrapResult(data, field) {
 }
 export function createCustomerMethods(http, ctx) {
     return {
+        // --- Auth ---
+        /**
+         * Authenticate a customer against the active channel.
+         *
+         * Returns a discriminated {@link LoginResult}: on success the current
+         * user, otherwise a typed signal for imported accounts that have no
+         * migrated password (`password_reset_required` — a reset link has already
+         * been emailed) or accounts that are not yet verified
+         * (`account_not_verified`). Only a *genuine* bad password throws a
+         * `MutationError('INVALID_CREDENTIALS_ERROR')`.
+         *
+         * The platform's per-channel auth strategy surfaces these signals through
+         * `InvalidCredentialsError.authenticationError`; we translate them here so
+         * an imported customer is not wrongly told their password is wrong.
+         */
         async login(email, password) {
             const data = await http.graphql(LOGIN, { email, password });
             const result = data.login;
@@ -39,6 +54,13 @@ export function createCustomerMethods(http, ctx) {
             const data = await http.graphql(REGISTER, { input });
             return unwrapResult(data, 'registerCustomerAccount');
         },
+        /**
+         * End the customer session. Runs the Vendure `logout` mutation, then clears
+         * the SDK's stored auth token and fires `onAuthCleared` (the inverse of the
+         * `onAuthToken` signal login raises) so the consumer can drop the persisted
+         * token — otherwise the token stays live and subsequent requests keep
+         * sending it.
+         */
         async logout() {
             await http.graphql(LOGOUT);
             if (ctx) {
@@ -59,6 +81,12 @@ export function createCustomerMethods(http, ctx) {
             });
             unwrapResult(data, 'refreshCustomerVerification');
         },
+        // --- Passwordless (magic link) ---
+        /**
+         * Request a passwordless sign-in email (clickable link + 6-digit code) for
+         * the given address. Resolves whether or not an account exists
+         * (anti-enumeration) — only a real error (e.g. misconfigured auth) throws.
+         */
         async requestMagicLink(emailAddress) {
             const data = await http.graphql(REQUEST_MAGIC_LINK, {
                 emailAddress,
@@ -68,10 +96,18 @@ export function createCustomerMethods(http, ctx) {
                 throw new MutationError(result.errorCode, result.message, result);
             }
         },
+        /**
+         * Consume a magic-link token (from the emailed link) and start a session.
+         * The auth token is captured automatically (fires `onAuthToken`), like login.
+         */
         async loginWithMagicLink(token) {
             const data = await http.graphql(LOGIN_WITH_MAGIC_LINK, { token });
             return unwrapResult(data, 'loginWithMagicLink');
         },
+        /**
+         * Consume a 6-digit magic-link code for the given email and start a session.
+         * Cross-device friendly: enter the code on the same device that requested it.
+         */
         async loginWithMagicCode(emailAddress, code) {
             const data = await http.graphql(LOGIN_WITH_MAGIC_CODE, {
                 emailAddress,
@@ -79,6 +115,7 @@ export function createCustomerMethods(http, ctx) {
             });
             return unwrapResult(data, 'loginWithMagicCode');
         },
+        // --- Password ---
         async updatePassword(currentPassword, newPassword) {
             const data = await http.graphql(UPDATE_PASSWORD, {
                 currentPassword,
@@ -102,6 +139,7 @@ export function createCustomerMethods(http, ctx) {
             });
             return unwrapResult(data, 'resetPassword');
         },
+        // --- Email ---
         async requestEmailUpdate(password, newEmailAddress) {
             const data = await http.graphql(REQUEST_EMAIL_UPDATE, {
                 password,
@@ -113,10 +151,18 @@ export function createCustomerMethods(http, ctx) {
             const data = await http.graphql(UPDATE_EMAIL, { token });
             unwrapResult(data, 'updateCustomerEmailAddress');
         },
+        // --- Profile ---
         async getCurrentCustomer() {
             const data = await http.graphql(GET_CURRENT_CUSTOMER);
             return data.activeCustomer;
         },
+        /**
+         * The price lists currently applying to the signed-in customer (contract,
+         * customer-direct, group, and channel-wide), sorted by resolution priority.
+         * Identity only — prices are already applied server-side; use this to label
+         * which lists the customer is on. Empty for anonymous visitors with no
+         * channel-wide lists.
+         */
         async getActiveCustomerPriceLists(options) {
             const data = await http.graphql(ACTIVE_CUSTOMER_PRICE_LISTS, undefined, options);
             return data.activeCustomerPriceLists;
@@ -137,6 +183,7 @@ export function createCustomerMethods(http, ctx) {
             const data = await http.graphql(GET_CUSTOMER_ORDERS, vars);
             return data.activeCustomer?.orders ?? { items: [], totalItems: 0 };
         },
+        // --- Addresses ---
         async createAddress(input) {
             const data = await http.graphql(CREATE_ADDRESS, {
                 input,
@@ -152,6 +199,7 @@ export function createCustomerMethods(http, ctx) {
         async deleteAddress(id) {
             await http.graphql(DELETE_ADDRESS, { id });
         },
+        // --- Utility Queries ---
         async getAvailableCountries() {
             const data = await http.graphql(AVAILABLE_COUNTRIES);
             return data.availableCountries;
@@ -163,18 +211,35 @@ export function createCustomerMethods(http, ctx) {
             }
             return data.orderByCode;
         },
+        /**
+         * Invoices issued for one of the signed-in customer's own orders.
+         * Requires authentication; other customers' order codes yield FORBIDDEN.
+         */
         async getMyOrderInvoices(orderCode) {
             const data = await http.graphql(MY_ORDER_INVOICES, {
                 orderCode,
             });
             return data.myOrderInvoices;
         },
+        /**
+         * Download one of the signed-in customer's own invoices. Returns the PDF
+         * bytes base64-encoded plus a suggested filename — decode with
+         * `atob`/`Buffer.from(base64, 'base64')` and serve as
+         * `application/pdf`.
+         */
         async getMyInvoicePdf(invoiceId) {
             const data = await http.graphql(MY_INVOICE_PDF, {
                 invoiceId,
             });
             return data.myInvoicePdf;
         },
+        /**
+         * Add every line of a previous order to the active cart ("buy again").
+         * Lines whose variants no longer exist or have insufficient stock are
+         * collected in `skipped` instead of throwing — the caller decides how to
+         * surface them. Lines are added sequentially so cart state is consistent
+         * if the caller aborts mid-way.
+         */
         async reorder(orderCode) {
             const previous = await this.getOrderByCode(orderCode);
             const skipped = [];

package/dist/commerce/customer.js.map

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

package/dist/commerce/pickup-location-parser.d.ts

@@ -1,6 +1,24 @@
 import type { PickupLocation } from '../types.js';
+/**
+ * Parse a single `PickupLocation` returned by the Vendure shop API. Throws
+ * `StorefrontError` on any shape violation so downstream consumers can rely
+ * on the typed shape.
+ */
 export declare function parsePickupLocation(value: unknown): PickupLocation;
+/**
+ * Parse an array of pickup locations. Returns `[]` for a `null`/`undefined`
+ * top-level (the Vendure shop API uses `null` only when there is no active
+ * order; the array form is always emitted).
+ */
 export declare function parsePickupLocations(value: unknown): PickupLocation[];
+/** Optional pickup location (`null` when no selection has been made). */
 export declare function parseOptionalPickupLocation(value: unknown): PickupLocation | null;
+/**
+ * Normalize a client-provided pickup location into the wire shape before
+ * sending it to `setActiveOrderPickupLocation`. The backend re-validates
+ * against the provider's current response, but parsing client-side first
+ * surfaces shape bugs at the SDK boundary instead of as opaque
+ * `MutationError`s later.
+ */
 export declare function normalizePickupLocationInput(value: unknown): PickupLocation;
 //# sourceMappingURL=pickup-location-parser.d.ts.map

package/dist/commerce/pickup-location-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pickup-location-parser.d.ts","sourceRoot":"","sources":["../../src/commerce/pickup-location-parser.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,cAAc,EAGf,MAAM,aAAa,CAAC;AA4DrB,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAiClE;AAOD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,EAAE,CAIrE;AAGD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAGjF;AASD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAE3E"}
+{"version":3,"file":"pickup-location-parser.d.ts","sourceRoot":"","sources":["../../src/commerce/pickup-location-parser.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,cAAc,EAGf,MAAM,aAAa,CAAC;AAuDrB;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAiClE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,EAAE,CAIrE;AAED,yEAAyE;AACzE,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAGjF;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAE3E"}

package/dist/commerce/pickup-location-parser.js

@@ -1,3 +1,10 @@
+/**
+ * Strict parsers for the `PickupLocation` shape returned by the Vendure shop
+ * API. The SDK persists pickup selections back to the order; per the project's
+ * data integrity rules, every external value must be parsed before downstream
+ * code touches it. Hand-written guards (no Zod) match the rest of the SDK,
+ * which keeps zero runtime dependencies.
+ */
 import { StorefrontError } from '../errors.js';
 function reject(field, message) {
     throw new StorefrontError(`Invalid PickupLocation payload at "${field}": ${message}`, 'vendure');
@@ -51,6 +58,11 @@ function parseOpeningHours(value, field) {
         close,
     };
 }
+/**
+ * Parse a single `PickupLocation` returned by the Vendure shop API. Throws
+ * `StorefrontError` on any shape violation so downstream consumers can rely
+ * on the typed shape.
+ */
 export function parsePickupLocation(value) {
     if (!isPlainObject(value))
         reject('pickupLocation', 'expected object');
@@ -75,10 +87,18 @@ export function parsePickupLocation(value) {
         out.openingHours = openingHoursRaw.map((entry, idx) => parseOpeningHours(entry, `pickupLocation.openingHours[${idx}]`));
     }
     if (isPlainObject(detailsRaw)) {
+        // `details` is a carrier-specific extras bag; the inner shape is opaque
+        // by design. We keep the keys verbatim — only the wrapper type is
+        // asserted here.
         out.details = detailsRaw;
     }
     return out;
 }
+/**
+ * Parse an array of pickup locations. Returns `[]` for a `null`/`undefined`
+ * top-level (the Vendure shop API uses `null` only when there is no active
+ * order; the array form is always emitted).
+ */
 export function parsePickupLocations(value) {
     if (value === null || value === undefined)
         return [];
@@ -86,11 +106,19 @@ export function parsePickupLocations(value) {
         reject('pickupLocations', 'expected array');
     return value.map((entry) => parsePickupLocation(entry));
 }
+/** Optional pickup location (`null` when no selection has been made). */
 export function parseOptionalPickupLocation(value) {
     if (value === null || value === undefined)
         return null;
     return parsePickupLocation(value);
 }
+/**
+ * Normalize a client-provided pickup location into the wire shape before
+ * sending it to `setActiveOrderPickupLocation`. The backend re-validates
+ * against the provider's current response, but parsing client-side first
+ * surfaces shape bugs at the SDK boundary instead of as opaque
+ * `MutationError`s later.
+ */
 export function normalizePickupLocationInput(value) {
     return parsePickupLocation(value);
 }

package/dist/commerce/pickup-location-parser.js.map

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

package/dist/commerce/placement-error.d.ts

@@ -1,6 +1,58 @@
+/**
+ * Hoisting the structured half of a refusal onto the thrown `MutationError`.
+ *
+ * Two different shapes carry "why" out of the Shop API, and a storefront
+ * should not have to know which one it got:
+ *
+ *  - A **placement rejection** (`OrderStateTransitionError.placement`,
+ *    `PaymentDeclinedError.placement`, `PaymentFailedError.placement`) — a
+ *    full payload with a stable `code`, a shopper-safe `customerMessage` and
+ *    per-code metadata. The operator prose stays on `transitionError` /
+ *    `paymentErrorMessage`, untouched, for merchant-facing surfaces.
+ *  - An **`InsufficientStockError`**, which is not a placement rejection at
+ *    all (it comes back from the CART mutations, long before any transition)
+ *    but answers the same question and carries its own identity fields.
+ *
+ * Both land on `MutationError` as `code` + `lines`, so `catch (e) { switch
+ * (e.code) }` is the single way to branch. This module is the only place that
+ * reads the wire shapes.
+ */
 import { MutationError } from '../errors.js';
 import type { PlacementRejection, PlacementRejectionLine } from '../types.js';
+/**
+ * The `placement` payload, when the document selected it AND the engine filled
+ * it in. Null/absent is the normal case for a core state-machine error, for a
+ * veto site that predates the envelope, and for any engine older than the
+ * placement-rejection schema.
+ *
+ * An unrecognised `code` is passed through unchanged rather than rewritten to
+ * `UNKNOWN`: the value is what a newer storefront branches on, and the engine
+ * already substitutes `UNKNOWN` for codes IT cannot decode.
+ */
 export declare function readPlacement(result: Record<string, unknown>): PlacementRejection | undefined;
+/**
+ * The line an `InsufficientStockError` is about, rebuilt from the fields the
+ * cart mutations fill in. `undefined` when the error names no variant — an
+ * error raised outside the overridden cart mutations answers null to all of
+ * them, and there is nothing to point the shopper at.
+ */
 export declare function insufficientStockLine(result: Record<string, unknown>): PlacementRejectionLine | undefined;
+/**
+ * Build the `MutationError` for one GraphQL ErrorResult.
+ *
+ * Message precedence is the whole point: the shopper-safe
+ * `placement.customerMessage` wins, then a vetted reason field
+ * (`transitionError` / `interceptorError`) exactly as before this existed,
+ * then the ErrorResult's generic `message` — which is a per-code i18n TEMPLATE
+ * ("Cannot transition Order from X to Y"), never a reason.
+ *
+ * @param result the ErrorResult object as it came off the wire
+ * @param fields what to attach as `error.fields`; defaults to `result`. The
+ *   bulk-add path passes a wider bag (the partially-mutated order, every
+ *   per-input error) so the caller can reconcile what actually landed.
+ * @param linesOverride the lines to attach when the CALLER can see more of
+ *   them than `result` alone: a bulk add throws about its first failing input,
+ *   but every failing input names a row the shopper has to fix.
+ */
 export declare function toMutationError(result: Record<string, unknown>, fields?: Record<string, unknown>, linesOverride?: PlacementRejectionLine[]): MutationError;
 //# sourceMappingURL=placement-error.d.ts.map

package/dist/commerce/placement-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"placement-error.d.ts","sourceRoot":"","sources":["../../src/commerce/placement-error.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EACV,kBAAkB,EAElB,sBAAsB,EACvB,MAAM,aAAa,CAAC;AAgFrB,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,kBAAkB,GAAG,SAAS,CAiB7F;AAQD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,sBAAsB,GAAG,SAAS,CAEpC;AAmBD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAU,EACxC,aAAa,CAAC,EAAE,sBAAsB,EAAE,GACvC,aAAa,CA+Bf"}
+{"version":3,"file":"placement-error.d.ts","sourceRoot":"","sources":["../../src/commerce/placement-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EACV,kBAAkB,EAElB,sBAAsB,EACvB,MAAM,aAAa,CAAC;AAsErB;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,kBAAkB,GAAG,SAAS,CAiB7F;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,sBAAsB,GAAG,SAAS,CAEpC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAU,EACxC,aAAa,CAAC,EAAE,sBAAsB,EAAE,GACvC,aAAa,CA+Bf"}

package/dist/commerce/placement-error.js

@@ -1,8 +1,49 @@
+/**
+ * Hoisting the structured half of a refusal onto the thrown `MutationError`.
+ *
+ * Two different shapes carry "why" out of the Shop API, and a storefront
+ * should not have to know which one it got:
+ *
+ *  - A **placement rejection** (`OrderStateTransitionError.placement`,
+ *    `PaymentDeclinedError.placement`, `PaymentFailedError.placement`) — a
+ *    full payload with a stable `code`, a shopper-safe `customerMessage` and
+ *    per-code metadata. The operator prose stays on `transitionError` /
+ *    `paymentErrorMessage`, untouched, for merchant-facing surfaces.
+ *  - An **`InsufficientStockError`**, which is not a placement rejection at
+ *    all (it comes back from the CART mutations, long before any transition)
+ *    but answers the same question and carries its own identity fields.
+ *
+ * Both land on `MutationError` as `code` + `lines`, so `catch (e) { switch
+ * (e.code) }` is the single way to branch. This module is the only place that
+ * reads the wire shapes.
+ */
 import { MutationError } from '../errors.js';
+/**
+ * ErrorResult fields whose prose may stand in for a missing `customerMessage`,
+ * most specific first. Each concrete error type has at most one, and a field
+ * the document did not select is simply absent — so this degrades to `message`
+ * rather than inventing detail.
+ *
+ * This is deliberately NOT the platform's `ERROR_REASON_FIELDS`. That list
+ * serves the audit trail and the merchant dashboard, where operator prose is
+ * exactly what is wanted; here every entry has to be prose a SHOPPER may read:
+ *
+ *  - `transitionError` — what an order-process guard answered. Merchant
+ *    English, but written about the order the shopper is placing.
+ *  - `interceptorError` — what an order interceptor answered when it vetoed a
+ *    cart mutation; likewise addressed at whoever tried the operation.
+ *
+ * `paymentErrorMessage` is excluded ON PURPOSE: a PSP or ERP decline carries
+ * internal detail ("the Exact Online customer has no payment condition
+ * assigned"). A payment refusal that carries no `placement` therefore keeps
+ * the generic Vendure `message`, and the raw text stays reachable on
+ * `error.fields.paymentErrorMessage` for merchant-facing surfaces.
+ */
 const REASON_FIELDS = ['transitionError', 'interceptorError'];
 function nonEmpty(value) {
     return typeof value === 'string' && value.trim().length > 0 ? value : undefined;
 }
+/** GraphQL `ID` may serialize as a string or a number depending on the engine's id strategy. */
 function readId(value) {
     if (typeof value === 'string' && value.length > 0)
         return value;
@@ -13,6 +54,12 @@ function readId(value) {
 function readInt(value) {
     return typeof value === 'number' ? value : undefined;
 }
+/**
+ * One implicated line, normalised the same way whatever carried it: a
+ * `placement.lines` entry or the flat identity fields an
+ * `InsufficientStockError` answers. `undefined` when the entry names no
+ * variant — there is then nothing to point the shopper at.
+ */
 function readLine(raw) {
     const productVariantId = readId(raw.productVariantId);
     if (!productVariantId)
@@ -38,6 +85,16 @@ function readLines(raw) {
     }
     return lines;
 }
+/**
+ * The `placement` payload, when the document selected it AND the engine filled
+ * it in. Null/absent is the normal case for a core state-machine error, for a
+ * veto site that predates the envelope, and for any engine older than the
+ * placement-rejection schema.
+ *
+ * An unrecognised `code` is passed through unchanged rather than rewritten to
+ * `UNKNOWN`: the value is what a newer storefront branches on, and the engine
+ * already substitutes `UNKNOWN` for codes IT cannot decode.
+ */
 export function readPlacement(result) {
     const raw = result.placement;
     if (!raw || typeof raw !== 'object')
@@ -49,15 +106,42 @@ export function readPlacement(result) {
     const placement = {
         ...payload,
         code,
+        // Declared non-nullable, so never let an unselected field type as `true`.
         linesTruncated: payload.linesTruncated === true,
     };
+    // Same normalisation as the stock path, so `line.productVariantId` is a
+    // string on BOTH — otherwise a numeric-ID engine makes `=== variant.id`
+    // fail on placement lines and hold on stock lines.
     if (Array.isArray(payload.lines))
         placement.lines = readLines(payload.lines);
     return placement;
 }
+/**
+ * The line an `InsufficientStockError` is about, rebuilt from the fields the
+ * cart mutations fill in. `undefined` when the error names no variant — an
+ * error raised outside the overridden cart mutations answers null to all of
+ * them, and there is nothing to point the shopper at.
+ */
 export function insufficientStockLine(result) {
     return readLine(result);
 }
+/**
+ * Build the `MutationError` for one GraphQL ErrorResult.
+ *
+ * Message precedence is the whole point: the shopper-safe
+ * `placement.customerMessage` wins, then a vetted reason field
+ * (`transitionError` / `interceptorError`) exactly as before this existed,
+ * then the ErrorResult's generic `message` — which is a per-code i18n TEMPLATE
+ * ("Cannot transition Order from X to Y"), never a reason.
+ *
+ * @param result the ErrorResult object as it came off the wire
+ * @param fields what to attach as `error.fields`; defaults to `result`. The
+ *   bulk-add path passes a wider bag (the partially-mutated order, every
+ *   per-input error) so the caller can reconcile what actually landed.
+ * @param linesOverride the lines to attach when the CALLER can see more of
+ *   them than `result` alone: a bulk add throws about its first failing input,
+ *   but every failing input names a row the shopper has to fix.
+ */
 export function toMutationError(result, fields = result, linesOverride) {
     const errorCode = nonEmpty(result.errorCode) ?? 'UNKNOWN_ERROR';
     const placement = readPlacement(result);
@@ -66,6 +150,9 @@ export function toMutationError(result, fields = result, linesOverride) {
     const lines = linesOverride?.length
         ? linesOverride
         : (placementLines ?? (stockLine ? [stockLine] : undefined));
+    // A stock refusal carries no envelope, so the code is synthesized — even
+    // when the identity fields are absent, because "which line" being unknown
+    // does not make "not enough stock" unknown.
     const code = placement?.code ??
         (errorCode === 'INSUFFICIENT_STOCK_ERROR'
             ? 'INSUFFICIENT_STOCK'

package/dist/commerce/placement-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"placement-error.js","sourceRoot":"","sources":["../../src/commerce/placement-error.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"placement-error.js","sourceRoot":"","sources":["../../src/commerce/placement-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAO7C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,aAAa,GAAG,CAAC,iBAAiB,EAAE,kBAAkB,CAAU,CAAC;AAEvE,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAClF,CAAC;AAED,gGAAgG;AAChG,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAChE,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,SAAS,QAAQ,CAAC,GAA4B;IAC5C,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACtD,IAAI,CAAC,gBAAgB;QAAE,OAAO,SAAS,CAAC;IACxC,OAAO;QACL,gBAAgB;QAChB,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC;QACpC,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;QACtB,WAAW,EAAE,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC;QACtC,kBAAkB,EAAE,QAAQ,CAAC,GAAG,CAAC,kBAAkB,CAAC;QACpD,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QACjD,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;KAClD,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,GAAc;IAC/B,MAAM,KAAK,GAA6B,EAAE,CAAC;IAC3C,KAAK,MAAM,KAAK,IAAI,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAS;QAClD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAgC,CAAC,CAAC;QACxD,IAAI,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,MAA+B;IAC3D,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC;IAC7B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACtD,MAAM,OAAO,GAAG,GAA8B,CAAC;IAC/C,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,MAAM,SAAS,GAAuB;QACpC,GAAI,OAAyC;QAC7C,IAAI;QACJ,0EAA0E;QAC1E,cAAc,EAAE,OAAO,CAAC,cAAc,KAAK,IAAI;KAChD,CAAC;IACF,wEAAwE;IACxE,wEAAwE;IACxE,mDAAmD;IACnD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,SAAS,CAAC,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7E,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAA+B;IAE/B,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe,CAC7B,MAA+B,EAC/B,SAAkC,MAAM,EACxC,aAAwC;IAExC,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,eAAe,CAAC;IAChE,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAExC,MAAM,SAAS,GACb,SAAS,KAAK,0BAA0B,CAAC,CAAC,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvF,MAAM,cAAc,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9E,MAAM,KAAK,GAAG,aAAa,EAAE,MAAM;QACjC,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAE9D,yEAAyE;IACzE,0EAA0E;IAC1E,4CAA4C;IAC5C,MAAM,IAAI,GACR,SAAS,EAAE,IAAI;QACf,CAAC,SAAS,KAAK,0BAA0B;YACvC,CAAC,CAAE,oBAAsD;YACzD,CAAC,CAAC,SAAS,CAAC,CAAC;IAEjB,IAAI,MAA0B,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,MAAM,KAAK,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACrC,CAAC;IACD,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC,IAAI,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAE3F,OAAO,IAAI,aAAa,CAAC,SAAS,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,EAAE;QAChE,IAAI;QACJ,SAAS;QACT,KAAK;KACN,CAAC,CAAC;AACL,CAAC"}

package/dist/commerce/products.d.ts

@@ -1,11 +1,59 @@
 import { type HttpClient } from '../core/http.js';
 import type { Collection, CollectionDetail, CollectionListOptions, CollectionProductListOptions, CollectionProductSummary, Facet, PaginatedList, Product, ProductListOptions, ProductPropertyGroupValues, ProductPropertyRecord, ProductSummary, PropertyGroup, RequestOptions } from '../types.js';
+/**
+ * Flatten `getProductProperties(...)` output into a `slug → value` record for
+ * the product-detail view. Walks every group's `properties` to recover each
+ * value's slug (values are keyed by `propertyId`, not slug), then attaches the
+ * stored value. Later groups win on the rare slug collision.
+ *
+ * Empty-string and falsy-but-valid values (`false`, `0`) are preserved — the
+ * caller decides what counts as "blank". `content_item` slugs (e.g.
+ * `producer_winehouse`) map to a CMS item id string, not a name; resolve it
+ * against the CMS before display (see `ProductPropertyRecord`).
+ */
 export declare function mapProductProperties(groups: ProductPropertyGroupValues[]): ProductPropertyRecord;
 export declare function createProductMethods(http: HttpClient): {
     getProduct(slug: string, options?: RequestOptions): Promise<Product>;
     getProductById(id: string, options?: RequestOptions): Promise<Product>;
+    /**
+     * List products for the active channel via the `products` list query.
+     * Defaults to `filter: { enabled: { eq: true } }` (and the Shop API forces
+     * the same server-side), so `totalItems` matches the browsable catalogue.
+     *
+     * Cannot sort by price — Vendure's `ProductSortParameter` has no price
+     * field. Price-sorted listings go through `getProductsInCollection` or
+     * `searchProducts`.
+     *
+     * The deprecated `{ collectionSlug }` option reroutes to the search
+     * backend with its flatter row shape — call `getProductsInCollection`
+     * instead, which returns that shape honestly typed. That branch returns
+     * before the document switch, so `detail` has no effect on it.
+     *
+     * Pass `{ detail: 'card' }` for listing pages: it swaps in a grid-tile
+     * selection that drops the per-VARIANT stock reads a tile never shows
+     * (`availabilityByLocation`, `stockOnHand`/`stockAllocated`, and the
+     * incoming-stock trio) plus the product `description`, including the
+     * per-language copy inside `translations`. Those variant fields are
+     * per-variant field resolvers server-side, so this cuts backend work and SQL
+     * statements, not only bytes.
+     *
+     * The collection tree, the translated slugs and `priceTiers` are KEPT, so a
+     * card row still drives canonical/hreflang URLs and quantity-break pricing —
+     * see `ProductListOptions.detail` for the full kept/dropped list and why.
+     * The default is unchanged, so existing callers keep the full shape.
+     */
     getProducts(listOptions?: ProductListOptions, options?: RequestOptions): Promise<PaginatedList<ProductSummary>>;
+    /**
+     * List the products of one collection, via the search backend — the only
+     * Shop API path that filters by collection. Returns the honest search-row
+     * shape (`CollectionProductSummary`): one synthesised variant per product,
+     * no `sku`/`facetValues`/`collections`, and a single preview image. Use
+     * `getProduct(slug)` for a product's full variant/asset tree. Supports
+     * `sort: { price }` (unlike `getProducts`). A search row with a
+     * missing/malformed price throws rather than defaulting to €0.
+     */
     getProductsInCollection(collectionSlug: string, listOptions?: CollectionProductListOptions, options?: RequestOptions): Promise<PaginatedList<CollectionProductSummary>>;
+    /** `getProductsInCollection` by id, tagged `collection:<id>`. */
     getProductsInCollectionById(collectionId: string, listOptions?: CollectionProductListOptions, options?: RequestOptions): Promise<PaginatedList<CollectionProductSummary>>;
     getFacets(options?: RequestOptions): Promise<Facet[]>;
     getCollections(listOptions?: CollectionListOptions, options?: RequestOptions): Promise<Collection[]>;

package/dist/commerce/products.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../../src/commerce/products.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAc,MAAM,iBAAiB,CAAC;AAG9D,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,qBAAqB,EACrB,4BAA4B,EAC5B,wBAAwB,EACxB,KAAK,EACL,aAAa,EACb,OAAO,EACP,kBAAkB,EAClB,0BAA0B,EAC1B,qBAAqB,EACrB,cAAc,EACd,aAAa,EACb,cAAc,EAEf,MAAM,aAAa,CAAC;AA0HrB,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,0BAA0B,EAAE,GAAG,qBAAqB,CAUhG;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU;qBAE1B,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;uBAYjD,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;8BAwC5D,kBAAkB,YACtB,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;4CAiFvB,MAAM,gBACR,4BAA4B,YAChC,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,wBAAwB,CAAC,CAAC;8CAsBnC,MAAM,gBACN,4BAA4B,YAChC,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,wBAAwB,CAAC,CAAC;wBAoBzB,cAAc,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;iCAU3C,qBAAqB,YACzB,cAAc,GACvB,OAAO,CAAC,UAAU,EAAE,CAAC;wBAWE,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;0BAY1D,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;gCAYtD,cAAc,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;oCAU9D,MAAM,YACP,cAAc,GACvB,OAAO,CAAC,0BAA0B,EAAE,CAAC;;EAa3C"}
+{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../../src/commerce/products.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAc,MAAM,iBAAiB,CAAC;AAG9D,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,qBAAqB,EACrB,4BAA4B,EAC5B,wBAAwB,EACxB,KAAK,EACL,aAAa,EACb,OAAO,EACP,kBAAkB,EAClB,0BAA0B,EAC1B,qBAAqB,EACrB,cAAc,EACd,aAAa,EACb,cAAc,EAEf,MAAM,aAAa,CAAC;AA+GrB;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,0BAA0B,EAAE,GAAG,qBAAqB,CAUhG;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU;qBAE1B,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;uBAYjD,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAY5E;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;8BAEa,kBAAkB,YACtB,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;IAuEzC;;;;;;;;OAQG;4CAEe,MAAM,gBACR,4BAA4B,YAChC,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,wBAAwB,CAAC,CAAC;IAoBnD,iEAAiE;8CAEjD,MAAM,gBACN,4BAA4B,YAChC,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,wBAAwB,CAAC,CAAC;wBAoBzB,cAAc,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;iCAU3C,qBAAqB,YACzB,cAAc,GACvB,OAAO,CAAC,UAAU,EAAE,CAAC;wBAWE,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;0BAY1D,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;gCAYtD,cAAc,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;oCAU9D,MAAM,YACP,cAAc,GACvB,OAAO,CAAC,0BAA0B,EAAE,CAAC;;EAa3C"}