platform-types 1.10.853 → 1.10.854

package/dist/account.d.ts

@@ -188,6 +188,12 @@ declare global {
          * payment): the obligation whose refund the debit books. Absent on every other row.
          */
         refundObligationId?: string;
+        /**
+         * On a link-credit reversal row (SK `LINKREV#{reversedAccountId}`, `paymentRef*` naming the linked
+         * payment): the ledger row it reverses — the payment's credit, or that credit's FX adjustment.
+         * Absent on every other row.
+         */
+        reversesAccountId?: string;
     }
     /**
      * `POST /account` — a new customer-ledger movement. Mirrors the request side of

package/dist/accountAllocation.d.ts

@@ -0,0 +1,125 @@
+/**
+ * The cuenta-corriente allocator — which customer debits are still open, derived
+ * on read from `ACCOUNT#{storeId}` rows, in INTEGER MINOR UNITS. One
+ * implementation shared by the api, the operator app and the storefront, so the
+ * three agree on which debit a payment can still settle.
+ *
+ * No allocation entity is stored: a credit carries no pointer to the debit it
+ * paid, so every reader re-derives it, and two readers that derive it
+ * differently tell the customer two different things. The rules:
+ *
+ * 1. **Row order is `createdAt` ascending, NEVER `dated`.** A backdated row is
+ *    allocated where it was written. Ties: a debit before a credit (an order's
+ *    debit and its auto-linked payment can share a millisecond), then
+ *    `accountId`, so the result never depends on the order DynamoDB returned.
+ * 2. **A credit stamped with an `orderId` serves that order's open debits
+ *    first**, oldest first, and only debits already on the ledger — it cannot
+ *    reach a debit of that order written after it.
+ * 3. **Everything else applies oldest-first**: an unstamped credit, and the rest
+ *    of a stamped one once its order is paid (or has no debit yet).
+ * 4. **Credit with no open debit to land on waits unapplied** and is drained by
+ *    the next debit, so a deposit taken before the order is booked still pays
+ *    it. What is never drained is reported as `unappliedMinor`.
+ *
+ * Rows it reads, and how:
+ *
+ * - A `deleted` row, or one whose `createdAt` is past `asOf`, is skipped.
+ * - A synthesised opening row (`ACC000001`, `ACC000001-<suffix>` — the "Saldo
+ *   anterior" a statement leads with) is a movement of its `balance`: positive
+ *   is an orderless debit, negative an unstamped credit, and any `orderId` on
+ *   it is ignored. A `balance` on any OTHER row is a projected running total
+ *   and is ignored.
+ * - A row whose `debit` is above zero is a debit (its `credit` is then not
+ *   read); otherwise a row whose `credit` is above zero at the ledger scale is
+ *   a credit; anything else moves nothing. A stored `BALANCE-` checkpoint
+ *   carries neither, so it moves nothing — the ledger must be read from its
+ *   first row instead, because FIFO over a ledger with a missing debit is
+ *   wrong.
+ * - A refund-in-transit debit (`RIT#…`) is an ordinary debit stamped with its
+ *   order. It is reported like any other item; a consumer offering debits to
+ *   pay excludes it by its `accountId` if it must.
+ *
+ * ⚠️ **ONE ledger bucket — `ledgerCurrency` — never one per row label.** Every
+ * writer stores `debit`/`credit` already converted into the store's ledger
+ * denomination; a legacy manual row's `currency` labels what the operator
+ * TYPED, so bucketing by it files pesos as dollars. Opening rows follow the
+ * same rule, a legacy `ACC000001-usd` seed included. Every item therefore
+ * carries `ledgerCurrency`.
+ *
+ * ⚠️ **Exact, with no display tolerance.** An item is `paid` only at zero minor
+ * units. A reader that rounds to fewer decimals than the ledger scale (a store
+ * pricing in whole units on a two-decimal ledger) can call "paid" what this
+ * calls `partial`; that tolerance is the reader's to apply, on top of these
+ * figures. Amounts are quantised once per row — half away from zero after
+ * normalising the scaled value to 15 significant digits, the api ledger's own
+ * rule — and never summed as floats. A missing or non-finite amount is zero.
+ *
+ * Pure: no clock, no I/O, input rows never mutated.
+ */
+/** An item's allocation state, as a code — the reader owns the label. */
+export declare const ACCOUNT_ITEM_STATUSES: readonly ["open", "partial", "paid"];
+export type AccountItemStatus = (typeof ACCOUNT_ITEM_STATUSES)[number];
+/** The fields the allocator reads — a stored row and either wire projection all satisfy it. */
+export type AllocatableAccountRow = Pick<Account, 'accountId' | 'dated'> & Partial<Pick<Account, 'createdAt' | 'orderId' | 'dueDate' | 'details' | 'debit' | 'credit' | 'balance' | 'deleted'>>;
+export interface AccountAllocationOptions {
+    /** The store's ledger denomination (`store.config.displayCurrency` as a catalogId). Lowercased on output. */
+    ledgerCurrency: string;
+    /** Decimal places of `ledgerCurrency`'s minor unit, an integer 0–4. Defaults to 2. */
+    ledgerScale?: number;
+    /** Unix ms; rows written after it are left out. Omitted, every row counts. */
+    asOf?: number;
+}
+/** One debit row after allocation. */
+export interface AllocatedAccountItem {
+    /** The debit row's `Account.accountId`. */
+    accountId: string;
+    /** Absent for orderless debt — an empty `orderId` included, which allocation treats as orderless too. */
+    orderId?: string;
+    /** `AccountLedgerAllocation.currency`. */
+    currency: string;
+    /** `YYYYMMDD` ledger day the debit is dated — what an aging read buckets. */
+    dated: number;
+    /** `YYYYMMDD` due day stamped on the row. Absent means unspecified — never inferred from `dated`. */
+    dueDate?: number;
+    /** The row's `Account.details`, verbatim when the row carries the key. */
+    details?: string;
+    /** The row's `createdAt` — the axis allocation ran on. */
+    createdAt: number;
+    /** The debit, in minor units of `currency`. */
+    originalMinor: number;
+    /** How much of it credits have covered. */
+    paidMinor: number;
+    /** `originalMinor - paidMinor`, never negative. */
+    remainingMinor: number;
+    status: AccountItemStatus;
+}
+/** Every debit of one order, summed. */
+export interface AllocatedAccountOrder {
+    originalMinor: number;
+    paidMinor: number;
+    remainingMinor: number;
+    status: AccountItemStatus;
+}
+export interface AccountLedgerAllocation {
+    /** The ledger bucket every amount here is in: `ledgerCurrency`, lowercased. */
+    currency: string;
+    /** Decimal places of one minor unit of `currency`. */
+    scale: number;
+    /** Every debit row, in allocation order, paid ones included. */
+    items: AllocatedAccountItem[];
+    /** The items carrying an `orderId`, summed per order. */
+    orders: Record<string, AllocatedAccountOrder>;
+    /** Credit no debit absorbed — owed to the customer. Never negative. */
+    unappliedMinor: number;
+    /** Debits minus credits: positive is owed by the customer. Equals the open items' total minus `unappliedMinor`. */
+    saldoMinor: number;
+}
+/**
+ * Allocate a customer's ledger. Pass the WHOLE ledger — every movement from the
+ * first, or a synthesised opening row standing in for what precedes the rows —
+ * since a debit missing from the input leaves a later credit landing on the
+ * wrong one. Throws a `RangeError` on a scale outside 0–4.
+ */
+export declare const allocateAccountLedger: (rows: readonly AllocatableAccountRow[], options: AccountAllocationOptions) => AccountLedgerAllocation;
+/** The items of an allocation that still owe something, in allocation order. */
+export declare const openAccountItems: (allocation: AccountLedgerAllocation) => AllocatedAccountItem[];

package/dist/accountAllocation.js

@@ -0,0 +1,193 @@
+/**
+ * The cuenta-corriente allocator — which customer debits are still open, derived
+ * on read from `ACCOUNT#{storeId}` rows, in INTEGER MINOR UNITS. One
+ * implementation shared by the api, the operator app and the storefront, so the
+ * three agree on which debit a payment can still settle.
+ *
+ * No allocation entity is stored: a credit carries no pointer to the debit it
+ * paid, so every reader re-derives it, and two readers that derive it
+ * differently tell the customer two different things. The rules:
+ *
+ * 1. **Row order is `createdAt` ascending, NEVER `dated`.** A backdated row is
+ *    allocated where it was written. Ties: a debit before a credit (an order's
+ *    debit and its auto-linked payment can share a millisecond), then
+ *    `accountId`, so the result never depends on the order DynamoDB returned.
+ * 2. **A credit stamped with an `orderId` serves that order's open debits
+ *    first**, oldest first, and only debits already on the ledger — it cannot
+ *    reach a debit of that order written after it.
+ * 3. **Everything else applies oldest-first**: an unstamped credit, and the rest
+ *    of a stamped one once its order is paid (or has no debit yet).
+ * 4. **Credit with no open debit to land on waits unapplied** and is drained by
+ *    the next debit, so a deposit taken before the order is booked still pays
+ *    it. What is never drained is reported as `unappliedMinor`.
+ *
+ * Rows it reads, and how:
+ *
+ * - A `deleted` row, or one whose `createdAt` is past `asOf`, is skipped.
+ * - A synthesised opening row (`ACC000001`, `ACC000001-<suffix>` — the "Saldo
+ *   anterior" a statement leads with) is a movement of its `balance`: positive
+ *   is an orderless debit, negative an unstamped credit, and any `orderId` on
+ *   it is ignored. A `balance` on any OTHER row is a projected running total
+ *   and is ignored.
+ * - A row whose `debit` is above zero is a debit (its `credit` is then not
+ *   read); otherwise a row whose `credit` is above zero at the ledger scale is
+ *   a credit; anything else moves nothing. A stored `BALANCE-` checkpoint
+ *   carries neither, so it moves nothing — the ledger must be read from its
+ *   first row instead, because FIFO over a ledger with a missing debit is
+ *   wrong.
+ * - A refund-in-transit debit (`RIT#…`) is an ordinary debit stamped with its
+ *   order. It is reported like any other item; a consumer offering debits to
+ *   pay excludes it by its `accountId` if it must.
+ *
+ * ⚠️ **ONE ledger bucket — `ledgerCurrency` — never one per row label.** Every
+ * writer stores `debit`/`credit` already converted into the store's ledger
+ * denomination; a legacy manual row's `currency` labels what the operator
+ * TYPED, so bucketing by it files pesos as dollars. Opening rows follow the
+ * same rule, a legacy `ACC000001-usd` seed included. Every item therefore
+ * carries `ledgerCurrency`.
+ *
+ * ⚠️ **Exact, with no display tolerance.** An item is `paid` only at zero minor
+ * units. A reader that rounds to fewer decimals than the ledger scale (a store
+ * pricing in whole units on a two-decimal ledger) can call "paid" what this
+ * calls `partial`; that tolerance is the reader's to apply, on top of these
+ * figures. Amounts are quantised once per row — half away from zero after
+ * normalising the scaled value to 15 significant digits, the api ledger's own
+ * rule — and never summed as floats. A missing or non-finite amount is zero.
+ *
+ * Pure: no clock, no I/O, input rows never mutated.
+ */
+/** An item's allocation state, as a code — the reader owns the label. */
+export const ACCOUNT_ITEM_STATUSES = ['open', 'partial', 'paid'];
+const OPENING_ROW_ID = 'ACC000001';
+const DEFAULT_SCALE = 2;
+const MAX_SCALE = 4;
+const isOpeningRow = (accountId) => accountId === OPENING_ROW_ID || accountId.startsWith(`${OPENING_ROW_ID}-`);
+const finiteOrZero = (value) => (typeof value === 'number' && Number.isFinite(value) ? value : 0);
+const toMinorUnits = (amount, scale) => {
+    const rounded = Math.round(Number(Math.abs(amount * 10 ** scale).toPrecision(15)));
+    // Never `-0`.
+    return amount < 0 && rounded !== 0 ? -rounded : rounded;
+};
+const statusOf = (originalMinor, paidMinor) => {
+    if (originalMinor - paidMinor <= 0)
+        return 'paid';
+    return paidMinor > 0 ? 'partial' : 'open';
+};
+const toMove = (row, scale) => {
+    const createdAt = finiteOrZero(row.createdAt);
+    if (isOpeningRow(row.accountId)) {
+        const opening = toMinorUnits(finiteOrZero(row.balance), scale);
+        return {
+            row,
+            createdAt,
+            isDebit: opening > 0,
+            debitMinor: Math.max(opening, 0),
+            creditMinor: Math.max(-opening, 0),
+        };
+    }
+    const debit = finiteOrZero(row.debit);
+    return {
+        row,
+        createdAt,
+        // The RAW amount decides the kind, as the operator app does: a debit too small to reach one
+        // minor unit is still a (zero) debit, and its `credit` is still not read.
+        isDebit: debit > 0,
+        debitMinor: toMinorUnits(debit, scale),
+        creditMinor: toMinorUnits(finiteOrZero(row.credit), scale),
+        ...(row.orderId ? { orderId: row.orderId } : {}),
+    };
+};
+const compareMoves = (a, b) => a.createdAt - b.createdAt || Number(b.isDebit) - Number(a.isDebit) || a.row.accountId.localeCompare(b.row.accountId);
+/** Serves `debits` in order; returns the credit left over. */
+const applyFifo = (debits, creditMinor) => {
+    let remaining = creditMinor;
+    for (const debit of debits) {
+        if (remaining <= 0)
+            break;
+        const open = debit.totalMinor - debit.paidMinor;
+        if (open <= 0)
+            continue;
+        const applied = Math.min(open, remaining);
+        debit.paidMinor += applied;
+        remaining -= applied;
+    }
+    return remaining;
+};
+const toItem = (tracker, currency) => {
+    const { row } = tracker;
+    return {
+        accountId: row.accountId,
+        ...(tracker.orderId ? { orderId: tracker.orderId } : {}),
+        currency,
+        dated: row.dated,
+        ...(row.dueDate === undefined ? {} : { dueDate: row.dueDate }),
+        ...(row.details === undefined ? {} : { details: row.details }),
+        createdAt: tracker.createdAt,
+        originalMinor: tracker.totalMinor,
+        paidMinor: tracker.paidMinor,
+        remainingMinor: Math.max(tracker.totalMinor - tracker.paidMinor, 0),
+        status: statusOf(tracker.totalMinor, tracker.paidMinor),
+    };
+};
+const summariseOrders = (items) => {
+    const orders = {};
+    for (const item of items) {
+        if (!item.orderId)
+            continue;
+        const originalMinor = (orders[item.orderId]?.originalMinor ?? 0) + item.originalMinor;
+        const paidMinor = (orders[item.orderId]?.paidMinor ?? 0) + item.paidMinor;
+        orders[item.orderId] = {
+            originalMinor,
+            paidMinor,
+            remainingMinor: Math.max(originalMinor - paidMinor, 0),
+            status: statusOf(originalMinor, paidMinor),
+        };
+    }
+    return orders;
+};
+/**
+ * Allocate a customer's ledger. Pass the WHOLE ledger — every movement from the
+ * first, or a synthesised opening row standing in for what precedes the rows —
+ * since a debit missing from the input leaves a later credit landing on the
+ * wrong one. Throws a `RangeError` on a scale outside 0–4.
+ */
+export const allocateAccountLedger = (rows, options) => {
+    const scale = options.ledgerScale ?? DEFAULT_SCALE;
+    if (!Number.isInteger(scale) || scale < 0 || scale > MAX_SCALE) {
+        throw new RangeError(`Ledger scale must be an integer in 0-${MAX_SCALE}, got ${scale}`);
+    }
+    const currency = options.ledgerCurrency.toLowerCase();
+    const { asOf } = options;
+    const moves = rows
+        .filter((row) => !row.deleted && (asOf === undefined || finiteOrZero(row.createdAt) <= asOf))
+        .map((row) => toMove(row, scale))
+        .sort(compareMoves);
+    const debits = [];
+    let unappliedMinor = 0;
+    let saldoMinor = 0;
+    for (const move of moves) {
+        if (move.isDebit) {
+            saldoMinor += move.debitMinor;
+            debits.push({
+                row: move.row,
+                createdAt: move.createdAt,
+                ...(move.orderId ? { orderId: move.orderId } : {}),
+                totalMinor: move.debitMinor,
+                paidMinor: 0,
+            });
+            unappliedMinor = applyFifo(debits, unappliedMinor);
+            continue;
+        }
+        if (move.creditMinor <= 0)
+            continue;
+        saldoMinor -= move.creditMinor;
+        const spare = move.orderId
+            ? applyFifo(debits.filter((debit) => debit.orderId === move.orderId), move.creditMinor)
+            : move.creditMinor;
+        unappliedMinor = applyFifo(debits, unappliedMinor + spare);
+    }
+    const items = debits.map((tracker) => toItem(tracker, currency));
+    return { currency, scale, items, orders: summariseOrders(items), unappliedMinor, saldoMinor };
+};
+/** The items of an allocation that still owe something, in allocation order. */
+export const openAccountItems = (allocation) => allocation.items.filter((item) => item.remainingMinor > 0);

package/dist/cjs/accountAllocation.js

@@ -0,0 +1,198 @@
+"use strict";
+/**
+ * The cuenta-corriente allocator — which customer debits are still open, derived
+ * on read from `ACCOUNT#{storeId}` rows, in INTEGER MINOR UNITS. One
+ * implementation shared by the api, the operator app and the storefront, so the
+ * three agree on which debit a payment can still settle.
+ *
+ * No allocation entity is stored: a credit carries no pointer to the debit it
+ * paid, so every reader re-derives it, and two readers that derive it
+ * differently tell the customer two different things. The rules:
+ *
+ * 1. **Row order is `createdAt` ascending, NEVER `dated`.** A backdated row is
+ *    allocated where it was written. Ties: a debit before a credit (an order's
+ *    debit and its auto-linked payment can share a millisecond), then
+ *    `accountId`, so the result never depends on the order DynamoDB returned.
+ * 2. **A credit stamped with an `orderId` serves that order's open debits
+ *    first**, oldest first, and only debits already on the ledger — it cannot
+ *    reach a debit of that order written after it.
+ * 3. **Everything else applies oldest-first**: an unstamped credit, and the rest
+ *    of a stamped one once its order is paid (or has no debit yet).
+ * 4. **Credit with no open debit to land on waits unapplied** and is drained by
+ *    the next debit, so a deposit taken before the order is booked still pays
+ *    it. What is never drained is reported as `unappliedMinor`.
+ *
+ * Rows it reads, and how:
+ *
+ * - A `deleted` row, or one whose `createdAt` is past `asOf`, is skipped.
+ * - A synthesised opening row (`ACC000001`, `ACC000001-<suffix>` — the "Saldo
+ *   anterior" a statement leads with) is a movement of its `balance`: positive
+ *   is an orderless debit, negative an unstamped credit, and any `orderId` on
+ *   it is ignored. A `balance` on any OTHER row is a projected running total
+ *   and is ignored.
+ * - A row whose `debit` is above zero is a debit (its `credit` is then not
+ *   read); otherwise a row whose `credit` is above zero at the ledger scale is
+ *   a credit; anything else moves nothing. A stored `BALANCE-` checkpoint
+ *   carries neither, so it moves nothing — the ledger must be read from its
+ *   first row instead, because FIFO over a ledger with a missing debit is
+ *   wrong.
+ * - A refund-in-transit debit (`RIT#…`) is an ordinary debit stamped with its
+ *   order. It is reported like any other item; a consumer offering debits to
+ *   pay excludes it by its `accountId` if it must.
+ *
+ * ⚠️ **ONE ledger bucket — `ledgerCurrency` — never one per row label.** Every
+ * writer stores `debit`/`credit` already converted into the store's ledger
+ * denomination; a legacy manual row's `currency` labels what the operator
+ * TYPED, so bucketing by it files pesos as dollars. Opening rows follow the
+ * same rule, a legacy `ACC000001-usd` seed included. Every item therefore
+ * carries `ledgerCurrency`.
+ *
+ * ⚠️ **Exact, with no display tolerance.** An item is `paid` only at zero minor
+ * units. A reader that rounds to fewer decimals than the ledger scale (a store
+ * pricing in whole units on a two-decimal ledger) can call "paid" what this
+ * calls `partial`; that tolerance is the reader's to apply, on top of these
+ * figures. Amounts are quantised once per row — half away from zero after
+ * normalising the scaled value to 15 significant digits, the api ledger's own
+ * rule — and never summed as floats. A missing or non-finite amount is zero.
+ *
+ * Pure: no clock, no I/O, input rows never mutated.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openAccountItems = exports.allocateAccountLedger = exports.ACCOUNT_ITEM_STATUSES = void 0;
+/** An item's allocation state, as a code — the reader owns the label. */
+exports.ACCOUNT_ITEM_STATUSES = ['open', 'partial', 'paid'];
+const OPENING_ROW_ID = 'ACC000001';
+const DEFAULT_SCALE = 2;
+const MAX_SCALE = 4;
+const isOpeningRow = (accountId) => accountId === OPENING_ROW_ID || accountId.startsWith(`${OPENING_ROW_ID}-`);
+const finiteOrZero = (value) => (typeof value === 'number' && Number.isFinite(value) ? value : 0);
+const toMinorUnits = (amount, scale) => {
+    const rounded = Math.round(Number(Math.abs(amount * 10 ** scale).toPrecision(15)));
+    // Never `-0`.
+    return amount < 0 && rounded !== 0 ? -rounded : rounded;
+};
+const statusOf = (originalMinor, paidMinor) => {
+    if (originalMinor - paidMinor <= 0)
+        return 'paid';
+    return paidMinor > 0 ? 'partial' : 'open';
+};
+const toMove = (row, scale) => {
+    const createdAt = finiteOrZero(row.createdAt);
+    if (isOpeningRow(row.accountId)) {
+        const opening = toMinorUnits(finiteOrZero(row.balance), scale);
+        return {
+            row,
+            createdAt,
+            isDebit: opening > 0,
+            debitMinor: Math.max(opening, 0),
+            creditMinor: Math.max(-opening, 0),
+        };
+    }
+    const debit = finiteOrZero(row.debit);
+    return {
+        row,
+        createdAt,
+        // The RAW amount decides the kind, as the operator app does: a debit too small to reach one
+        // minor unit is still a (zero) debit, and its `credit` is still not read.
+        isDebit: debit > 0,
+        debitMinor: toMinorUnits(debit, scale),
+        creditMinor: toMinorUnits(finiteOrZero(row.credit), scale),
+        ...(row.orderId ? { orderId: row.orderId } : {}),
+    };
+};
+const compareMoves = (a, b) => a.createdAt - b.createdAt || Number(b.isDebit) - Number(a.isDebit) || a.row.accountId.localeCompare(b.row.accountId);
+/** Serves `debits` in order; returns the credit left over. */
+const applyFifo = (debits, creditMinor) => {
+    let remaining = creditMinor;
+    for (const debit of debits) {
+        if (remaining <= 0)
+            break;
+        const open = debit.totalMinor - debit.paidMinor;
+        if (open <= 0)
+            continue;
+        const applied = Math.min(open, remaining);
+        debit.paidMinor += applied;
+        remaining -= applied;
+    }
+    return remaining;
+};
+const toItem = (tracker, currency) => {
+    const { row } = tracker;
+    return {
+        accountId: row.accountId,
+        ...(tracker.orderId ? { orderId: tracker.orderId } : {}),
+        currency,
+        dated: row.dated,
+        ...(row.dueDate === undefined ? {} : { dueDate: row.dueDate }),
+        ...(row.details === undefined ? {} : { details: row.details }),
+        createdAt: tracker.createdAt,
+        originalMinor: tracker.totalMinor,
+        paidMinor: tracker.paidMinor,
+        remainingMinor: Math.max(tracker.totalMinor - tracker.paidMinor, 0),
+        status: statusOf(tracker.totalMinor, tracker.paidMinor),
+    };
+};
+const summariseOrders = (items) => {
+    const orders = {};
+    for (const item of items) {
+        if (!item.orderId)
+            continue;
+        const originalMinor = (orders[item.orderId]?.originalMinor ?? 0) + item.originalMinor;
+        const paidMinor = (orders[item.orderId]?.paidMinor ?? 0) + item.paidMinor;
+        orders[item.orderId] = {
+            originalMinor,
+            paidMinor,
+            remainingMinor: Math.max(originalMinor - paidMinor, 0),
+            status: statusOf(originalMinor, paidMinor),
+        };
+    }
+    return orders;
+};
+/**
+ * Allocate a customer's ledger. Pass the WHOLE ledger — every movement from the
+ * first, or a synthesised opening row standing in for what precedes the rows —
+ * since a debit missing from the input leaves a later credit landing on the
+ * wrong one. Throws a `RangeError` on a scale outside 0–4.
+ */
+const allocateAccountLedger = (rows, options) => {
+    const scale = options.ledgerScale ?? DEFAULT_SCALE;
+    if (!Number.isInteger(scale) || scale < 0 || scale > MAX_SCALE) {
+        throw new RangeError(`Ledger scale must be an integer in 0-${MAX_SCALE}, got ${scale}`);
+    }
+    const currency = options.ledgerCurrency.toLowerCase();
+    const { asOf } = options;
+    const moves = rows
+        .filter((row) => !row.deleted && (asOf === undefined || finiteOrZero(row.createdAt) <= asOf))
+        .map((row) => toMove(row, scale))
+        .sort(compareMoves);
+    const debits = [];
+    let unappliedMinor = 0;
+    let saldoMinor = 0;
+    for (const move of moves) {
+        if (move.isDebit) {
+            saldoMinor += move.debitMinor;
+            debits.push({
+                row: move.row,
+                createdAt: move.createdAt,
+                ...(move.orderId ? { orderId: move.orderId } : {}),
+                totalMinor: move.debitMinor,
+                paidMinor: 0,
+            });
+            unappliedMinor = applyFifo(debits, unappliedMinor);
+            continue;
+        }
+        if (move.creditMinor <= 0)
+            continue;
+        saldoMinor -= move.creditMinor;
+        const spare = move.orderId
+            ? applyFifo(debits.filter((debit) => debit.orderId === move.orderId), move.creditMinor)
+            : move.creditMinor;
+        unappliedMinor = applyFifo(debits, unappliedMinor + spare);
+    }
+    const items = debits.map((tracker) => toItem(tracker, currency));
+    return { currency, scale, items, orders: summariseOrders(items), unappliedMinor, saldoMinor };
+};
+exports.allocateAccountLedger = allocateAccountLedger;
+/** The items of an allocation that still owe something, in allocation order. */
+const openAccountItems = (allocation) => allocation.items.filter((item) => item.remainingMinor > 0);
+exports.openAccountItems = openAccountItems;

package/dist/cjs/index.js

@@ -23,6 +23,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 // the published ESM build keeps the extension Node's resolver demands — bare
 // `export * from "./account"` would throw ERR_MODULE_NOT_FOUND at import time.
 __exportStar(require("./account.js"), exports);
+__exportStar(require("./accountAllocation.js"), exports);
 __exportStar(require("./afip.js"), exports);
 __exportStar(require("./ai.js"), exports);
 __exportStar(require("./api.js"), exports);

package/dist/cjs/payment.js

@@ -1,2 +1,46 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.PAYMENT_CREDIT_REVERSAL_LOCK_REASONS = exports.PAYMENT_CREDIT_REVERSAL_ERROR_CODES = void 0;
+/**
+ * The credit reversal's refusals (`PaymentCreditReversalRequest`). Each writes nothing.
+ *
+ * - `ADMIN_REQUIRED` · 403 — the token is below the ADMIN tier (an `ACCOUNTANT` is `403 ROLE_FORBIDDEN`, earlier).
+ * - `INVALID_INPUT` · 400 — the path's `source` is not `mp`, `stripe` or `mp_movement`.
+ * - `VALIDATION_FAILED` · 400 — the body is not `{ mode, reason }` or the reason is refused.
+ * - `PAYMENT_NOT_FOUND` · 404 — the store has no such payment.
+ * - `LINK_LOCKED` · 409 — `reason` is one of {@link PAYMENT_CREDIT_REVERSAL_LOCK_REASONS}.
+ * - `CUSTOMER_MERGED` · 409 — the credit's owner is mid-merge (or the payment carries a historical
+ *   merged-refund flag); `data.mergedInto` names the survivor.
+ * - `CUSTOMER_ANONYMIZED` · 409 — a legacy credit naming no customer, on an erased customer.
+ * - `CUSTOMER_NOT_FOUND` · 404 — the customer whose balance the credit moved is gone.
+ */
+exports.PAYMENT_CREDIT_REVERSAL_ERROR_CODES = [
+    'ADMIN_REQUIRED',
+    'INVALID_INPUT',
+    'VALIDATION_FAILED',
+    'PAYMENT_NOT_FOUND',
+    'LINK_LOCKED',
+    'CUSTOMER_MERGED',
+    'CUSTOMER_ANONYMIZED',
+    'CUSTOMER_NOT_FOUND',
+];
+/**
+ * Every `reason` of the credit reversal's `409 LINK_LOCKED`:
+ *
+ * - `credit-reversed` — this credit was already reversed (`reversalAccountId` names the row): a second
+ *   reversal of the same credit, a replay included.
+ * - `not-credited` — the payment's `accountId` names no credit of its own (never credited, or a pointer to
+ *   a row this payment did not write), or the payment names no customer (un-linked by hand).
+ * - `refund-obligation` — a refund obligation already debited part of this credit as in transit
+ *   (`refundObligationId`); reversing it all would debit that share twice.
+ * - `edited-ledger-pointer` — the payment's `fxAdjustmentAccountId` names a row that is not its own FX
+ *   adjustment for the credit's customer, so the delta to reverse cannot be named.
+ * - `concurrent-link` — the payment or its ledger rows kept changing while the reversal ran; retry.
+ */
+exports.PAYMENT_CREDIT_REVERSAL_LOCK_REASONS = [
+    'credit-reversed',
+    'not-credited',
+    'refund-obligation',
+    'edited-ledger-pointer',
+    'concurrent-link',
+];

package/dist/cjs/storefrontWebLiteralKeys.js

@@ -26,6 +26,10 @@ const storefrontDesignRegistry_ts_1 = require("./storefrontDesignRegistry.js");
  * parameters.
  */
 exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
+    'ADDRESSES_IS_DEFAULT',
+    'ADDRESSES_LIMIT_REACHED',
+    'ADDRESSES_NOT_FOUND',
+    'ADDRESSES_WRITE_CONTENDED',
     'ALERT_INCLUDED_VAT',
     'APPOINTMENTS_BOOKED_DESC',
     'APPOINTMENTS_BOOKED_TITLE',
@@ -323,9 +327,11 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'BASKET_LINE_LIMIT_REACHED',
     'BASKET_LINE_NOT_LOADED',
     'BASKET_LINE_NOT_OFFERED',
+    'BASKET_LINE_NO_PRICE',
     'BASKET_LINE_OUT_OF_STOCK',
     'BASKET_LINE_STOCK_SHORT_HIDDEN',
     'BASKET_LINE_UNAVAILABLE',
+    'BASKET_LINE_WITHDRAWN',
     'BASKET_LOADING',
     'BASKET_MIN_BUY_MISSING',
     'BASKET_NEXT_BUTTON',
@@ -356,8 +362,28 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'BASKET_UNDO_ACTION',
     'BASKET_UPDATED_CONFIRMATION',
     'BASKET_VIEW_BASKET_ACTION',
+    'BRANDS_DIRECTORY_EMPTY',
     'BRANDS_ERR_LOAD',
+    'BRANDS_FILTER_ALL',
+    'BRANDS_JUMP_LABEL',
+    'BRANDS_LETTERS_LABEL',
+    'BRANDS_LETTER_OTHER',
+    'BRANDS_LETTER_OTHER_LABEL',
+    'BRANDS_SEARCH_CLEAR',
+    'BRANDS_SEARCH_LABEL',
+    'BRANDS_SHOW_MORE',
     'BRANDS_TITLE',
+    'BRAND_BREADCRUMB_LABEL',
+    'BRAND_DESCRIPTION_MORE',
+    'CATEGORY_DIRECTORY_EMPTY',
+    'CATEGORY_DIRECTORY_EMPTY_ACTION',
+    'CATEGORY_DIRECTORY_FAILED',
+    'CATEGORY_DIRECTORY_JUMP_LABEL',
+    'CATEGORY_MORE_ROOTS_TITLE',
+    'CATEGORY_SHOW_LESS',
+    'CATEGORY_SIBLINGS_LABEL',
+    'CATEGORY_SUBCATEGORIES_LABEL',
+    'CATEGORY_VIEW_ALL',
     'CHECKOUT_ACCESS_PENDING',
     'CHECKOUT_ACCESS_REJECTED',
     'CHECKOUT_ACCOUNT_DISABLED',
@@ -426,7 +452,6 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'CHECKOUT_DNI_REQUIRED_MESSAGE',
     'CHECKOUT_DNI_REQUIRED_MESSAGE_NO_THRESHOLD',
     'CHECKOUT_EDIT_BASKET',
-    'CHECKOUT_EMAIL_VERIFICATION_REQUIRED',
     'CHECKOUT_EMPTY_BASKET',
     'CHECKOUT_FX_NOTICE_PAYING',
     'CHECKOUT_FX_NOTICE_PREFERRED',
@@ -541,11 +566,13 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'DATA_RIGHTS_COLLECTION_CONTACTS',
     'DATA_RIGHTS_COLLECTION_FAVORITES',
     'DATA_RIGHTS_COLLECTION_INVOICES',
+    'DATA_RIGHTS_COLLECTION_LOYALTY',
     'DATA_RIGHTS_COLLECTION_NOTES',
     'DATA_RIGHTS_COLLECTION_ORDERS',
     'DATA_RIGHTS_COLLECTION_PAYMENTS',
     'DATA_RIGHTS_COLLECTION_QUOTE_REQUESTS',
     'DATA_RIGHTS_COLLECTION_RECENT_PURCHASES',
+    'DATA_RIGHTS_COLLECTION_SERVICE_ORDERS',
     'DATA_RIGHTS_COLLECTION_WHOLESALE_REQUESTS',
     'DATA_RIGHTS_DIALOG_ACK',
     'DATA_RIGHTS_DIALOG_CONFIRM',
@@ -626,6 +653,11 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'FAVORITES_TOGGLE_ARIA',
     'FAVORITES_TOGGLE_NAME',
     'FAVORITES_UNAVAILABLE',
+    'FOOTER_DEFAULT_ACCOUNT_TITLE',
+    'FOOTER_DEFAULT_CONTACT',
+    'FOOTER_DEFAULT_HELP_TITLE',
+    'FOOTER_DEFAULT_SHOP_TITLE',
+    'FOOTER_LEGAL_NAV_ARIA',
     'FOOTER_PRIVACY_POLICY',
     'FORMS_FIELD_DNI_LABEL',
     'FORMS_FIELD_PHONE_LABEL',
@@ -672,7 +704,6 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'FORMS_ZOD_VALUE_OPTIONS',
     'FORM_FIX_ERRORS',
     'GLOBALS_APPOINTMENTS',
-    'GLOBALS_APP_VERSION',
     'GLOBALS_BASKET',
     'GLOBALS_BRANDS',
     'GLOBALS_CATEGORIES',
@@ -744,6 +775,9 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'HEADER_SEARCH_INPUT',
     'HEADER_SEARCH_LABEL',
     'HEADER_SEARCH_RECENT',
+    'HEADER_SEARCH_RECENT_CLEAR',
+    'HEADER_SEARCH_RECENT_CLEAR_ARIA',
+    'HEADER_SEARCH_RECENT_REMOVE',
     'HEADER_SEARCH_SUGGESTIONS',
     'HEADER_SEARCH_SUGGESTION_BARCODE',
     'HEADER_SEARCH_SUGGESTION_SKU',
@@ -889,7 +923,9 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'MAINTENANCE_REDIRECT_TO_BASKET',
     'MAINTENANCE_SUPPORT_HINT_EMAIL',
     'MAINTENANCE_SURVEY_DISABLED',
+    'MAINTENANCE_WHATSAPP_OPT_IN_DISABLED',
     'MAINTENANCE_WHOLESALE_REQUEST_DISABLED',
+    'MAINTENANCE_WITHDRAWAL_DISABLED',
     'MARKETING_ACTIVATE_ALL',
     'MARKETING_ACTIVE_COUNT',
     'MARKETING_CHANNEL_ADS',
@@ -898,12 +934,6 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'MARKETING_CHANNEL_EMAIL',
     'MARKETING_CHANNEL_EMAIL_DESC',
     'MARKETING_CHANNEL_EMAIL_EXAMPLE',
-    'MARKETING_CHANNEL_SMS',
-    'MARKETING_CHANNEL_SMS_DESC',
-    'MARKETING_CHANNEL_SMS_EXAMPLE',
-    'MARKETING_CHANNEL_WHATSAPP',
-    'MARKETING_CHANNEL_WHATSAPP_DESC',
-    'MARKETING_CHANNEL_WHATSAPP_EXAMPLE',
     'MARKETING_DEACTIVATE_ALL',
     'MARKETING_ERROR_MESSAGE',
     'MARKETING_EXAMPLE_PREFIX',
@@ -923,6 +953,7 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'MOBILE_BUTTONS_BASKET',
     'MOBILE_BUTTONS_FAVORITES',
     'MOBILE_BUTTONS_INVOICES',
+    'MOBILE_BUTTONS_NAV_ARIA',
     'MOBILE_BUTTONS_ORDERS',
     'NETWORK_OFFLINE',
     'NETWORK_REQUEST_FAILED',
@@ -951,6 +982,10 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'NOTIFICATION_PREFS_SUBTITLE',
     'NOTIFICATION_PREFS_TITLE',
     'NOTIFICATION_PREFS_UNAVAILABLE_RETRY',
+    'NOTIFICATION_PREFS_WHATSAPP_ARIA',
+    'NOTIFICATION_PREFS_WHATSAPP_DESCRIPTION',
+    'NOTIFICATION_PREFS_WHATSAPP_LABEL',
+    'NOTIFICATION_PREFS_WHATSAPP_NOT_SAVED',
     'NOT_FOUND_BACK_HOME',
     'NOT_FOUND_PAGE_BODY',
     'NOT_FOUND_PAGE_TITLE',
@@ -1179,6 +1214,7 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'PREVIEW_UNAVAILABLE_ACTION',
     'PREVIEW_VARIANTS',
     'PREVIEW_WAITING',
+    'PRICING_NET_PLUS_IVA',
     'PRICING_TIER_CHIP',
     'PRICING_TIER_FROM',
     'PRICING_TIER_UNITS',
@@ -1189,10 +1225,14 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'PRODUCTS_CLEAR_FILTERS',
     'PRODUCTS_FILTERS_LABEL',
     'PRODUCTS_FILTER_ALL_BRANDS',
+    'PRODUCTS_FILTER_ALL_CATEGORIES',
     'PRODUCTS_FILTER_ALL_PRODUCTS',
     'PRODUCTS_FILTER_ALL_TAGS',
     'PRODUCTS_FILTER_AVAILABILITY',
     'PRODUCTS_FILTER_BRAND',
+    'PRODUCTS_FILTER_BRAND_UNAVAILABLE',
+    'PRODUCTS_FILTER_CATEGORY',
+    'PRODUCTS_FILTER_CATEGORY_UNAVAILABLE',
     'PRODUCTS_FILTER_IN_OFFER',
     'PRODUCTS_FILTER_IN_STOCK',
     'PRODUCTS_FILTER_TAG',
@@ -1203,10 +1243,14 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'PRODUCTS_NO_INCOMES',
     'PRODUCTS_NO_MATCHES',
     'PRODUCTS_NO_RESULTS',
+    'PRODUCTS_PICK_SUBCATEGORY',
     'PRODUCTS_SEARCH_TITLE',
-    'PRODUCTS_SELECT_CATEGORY',
     'PRODUCTS_SORT_LABEL',
+    'PRODUCTS_SORT_NAME_ASC',
+    'PRODUCTS_SORT_NAME_DESC',
     'PRODUCTS_SORT_NEWEST',
+    'PRODUCTS_SORT_PRICE_ASC',
+    'PRODUCTS_SORT_PRICE_DESC',
     'PRODUCTS_SORT_RELEVANCE',
     'PRODUCTS_TAG_NOT_FOUND',
     'PRODUCTS_TAG_TITLE',
@@ -1250,6 +1294,8 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'PRODUCT_INFO_TITLE',
     'PRODUCT_LOAD_FAILED',
     'PRODUCT_PAGE_TITLE',
+    'PRODUCT_PRICE_ON_REQUEST',
+    'PRODUCT_PRICE_ON_REQUEST_HINT',
     'PRODUCT_PRICE_PER_UNIT',
     'PRODUCT_PROMOTIONS_HINT',
     'PRODUCT_PROMOTIONS_TITLE',
@@ -1401,6 +1447,7 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'QUOTE_REQUEST_SIGNED_IN_HINT',
     'QUOTE_REQUEST_SUBMIT',
     'QUOTE_REQUEST_SUCCESS',
+    'REORDER_SHELF_TITLE',
     'SALE_BADGE_OFFER',
     'SALE_CHIP_ALL',
     'SALE_DISCOUNT_PERCENT',
@@ -1489,6 +1536,14 @@ exports.STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'SURVEY_TITLE',
     'SYNC_ALERT_ERROR_MESSAGE',
     'SYNC_ALERT_OFFLINE_MESSAGE',
+    'WHATSAPP_OPT_IN_ERROR',
+    'WHATSAPP_OPT_IN_HELP_GUEST',
+    'WHATSAPP_OPT_IN_HELP_SIGNED_IN',
+    'WHATSAPP_OPT_IN_OFFER_ACTION',
+    'WHATSAPP_OPT_IN_OFFER_TEXT',
+    'WHATSAPP_OPT_IN_PROFILE_LINK',
+    'WHATSAPP_OPT_IN_SUCCESS',
+    'WHATSAPP_OPT_IN_UNAVAILABLE',
     'WHOLESALE_REQUEST_ACTIVITY_LABEL',
     'WHOLESALE_REQUEST_ALREADY_PENDING',
     'WHOLESALE_REQUEST_APPROVED',

package/dist/customer.d.ts

@@ -731,6 +731,13 @@ declare global {
          * `balance` deltas. Those are arithmetic (`ADD balance :add`) precisely so
          * concurrent writers compose; replacing this array wholesale loses updates
          * the arithmetic next to it would have kept.
+         *
+         * ⚠️ **No wire carries it.** Every boundary that spreads a raw CUSTOMER row
+         * (the session responses, the operator point read, the write echo) strips
+         * it with `openDebitsOverflow`; only the server's own report reads it. A
+         * client showing a customer's open debits derives them from the ledger with
+         * `allocateAccountLedger` — this summary ignores order stamps and is capped,
+         * so the two can disagree.
          */
         openDebits?: OpenDebit[];
         /**
@@ -740,6 +747,7 @@ declare global {
          * ⚠️ Absence means "not overflowed", never "unknown" — but a reader must
          * still not treat a present-and-`false` value as proof the array is
          * complete on a row written before this field existed. Forward-only.
+         * Stripped from every wire with `openDebits`.
          */
         openDebitsOverflow?: boolean;
         /**

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './account.ts';
+export * from './accountAllocation.ts';
 export * from './afip.ts';
 export * from './ai.ts';
 export * from './api.ts';

package/dist/index.js

@@ -7,6 +7,7 @@
 // the published ESM build keeps the extension Node's resolver demands — bare
 // `export * from "./account"` would throw ERR_MODULE_NOT_FOUND at import time.
 export * from "./account.js";
+export * from "./accountAllocation.js";
 export * from "./afip.js";
 export * from "./ai.js";
 export * from "./api.js";

package/dist/payment.d.ts

@@ -199,5 +199,77 @@ declare global {
         customers: CustomerCandidate[];
         orders: OrderCandidate[];
     }
+    /**
+     * `POST /payments/{source}/{paymentId}/link` with `mode: 'reverse-credit'` — ADMIN tier only
+     * (`ADMIN`, `SUPERVISOR`, `MANAGER`; anyone else `403 ADMIN_REQUIRED` — an `ACCOUNTANT` token never reaches
+     * the route: the API's accountant gate answers it `403 ROLE_FORBIDDEN` first), refused under impersonation
+     * (`payment.creditReverse`). Writes an `ACCOUNT#` row reversing the ledger credit the payment's link
+     * booked — on any day, whoever linked it (an operator, the MercadoLibre auto-link) — and moves the
+     * customer's balance back in the same transaction. The amount is the stored credit's (and its FX
+     * sibling's), never the caller's: the body carries no amount, account or customer. The link itself
+     * (customer, order, `Order.linkedPayments`) stays as it is.
+     */
+    interface PaymentCreditReversalRequest {
+        mode: 'reverse-credit';
+        /**
+         * Required: 10–500 characters after trimming, refused when it carries an email, phone, DNI, CUIT/CUIL,
+         * CBU, card number or token in a recognisable shape (`400 VALIDATION_FAILED`). Stored on the payment's
+         * per-source row and projected onto no wire (not the response, not `GET /payments/received`); not stored
+         * at all when the customer was erased. The audit row records its presence only.
+         */
+        reason: string;
+    }
+    /** One committed reversal: what was reversed, on whose balance, by how much. */
+    interface PaymentCreditReversal {
+        source: PaymentReceivedSource;
+        paymentId: string;
+        /** The link credit's `accountId`, and the reversal row's (`LINKREV#{creditAccountId}`). */
+        creditAccountId: string;
+        reversalAccountId: string;
+        /** Present when the link also booked an FX adjustment: that row, and the row reversing it. */
+        fxAdjustmentAccountId?: string;
+        fxReversalAccountId?: string;
+        /** Whose balance moved — the survivor, when the payment's customer was merged into another since. */
+        customerId: string;
+        /** What the customer's balance rose by, in the ledger `currency` (the credit plus its FX sibling's delta). */
+        amount: number;
+        currency: string;
+        reversedAt: number;
+    }
+    /** `data` of a successful credit reversal. */
+    interface PaymentCreditReversalResponse {
+        reversal: PaymentCreditReversal;
+    }
+    /** Every `error` the credit reversal answers itself — see {@link PAYMENT_CREDIT_REVERSAL_ERROR_CODES}. */
+    type PaymentCreditReversalErrorCode = (typeof PAYMENT_CREDIT_REVERSAL_ERROR_CODES)[number];
+    /** Every `reason` of the credit reversal's `409 LINK_LOCKED` — see {@link PAYMENT_CREDIT_REVERSAL_LOCK_REASONS}. */
+    type PaymentCreditReversalLockReason = (typeof PAYMENT_CREDIT_REVERSAL_LOCK_REASONS)[number];
 }
-export {};
+/**
+ * The credit reversal's refusals (`PaymentCreditReversalRequest`). Each writes nothing.
+ *
+ * - `ADMIN_REQUIRED` · 403 — the token is below the ADMIN tier (an `ACCOUNTANT` is `403 ROLE_FORBIDDEN`, earlier).
+ * - `INVALID_INPUT` · 400 — the path's `source` is not `mp`, `stripe` or `mp_movement`.
+ * - `VALIDATION_FAILED` · 400 — the body is not `{ mode, reason }` or the reason is refused.
+ * - `PAYMENT_NOT_FOUND` · 404 — the store has no such payment.
+ * - `LINK_LOCKED` · 409 — `reason` is one of {@link PAYMENT_CREDIT_REVERSAL_LOCK_REASONS}.
+ * - `CUSTOMER_MERGED` · 409 — the credit's owner is mid-merge (or the payment carries a historical
+ *   merged-refund flag); `data.mergedInto` names the survivor.
+ * - `CUSTOMER_ANONYMIZED` · 409 — a legacy credit naming no customer, on an erased customer.
+ * - `CUSTOMER_NOT_FOUND` · 404 — the customer whose balance the credit moved is gone.
+ */
+export declare const PAYMENT_CREDIT_REVERSAL_ERROR_CODES: readonly ["ADMIN_REQUIRED", "INVALID_INPUT", "VALIDATION_FAILED", "PAYMENT_NOT_FOUND", "LINK_LOCKED", "CUSTOMER_MERGED", "CUSTOMER_ANONYMIZED", "CUSTOMER_NOT_FOUND"];
+/**
+ * Every `reason` of the credit reversal's `409 LINK_LOCKED`:
+ *
+ * - `credit-reversed` — this credit was already reversed (`reversalAccountId` names the row): a second
+ *   reversal of the same credit, a replay included.
+ * - `not-credited` — the payment's `accountId` names no credit of its own (never credited, or a pointer to
+ *   a row this payment did not write), or the payment names no customer (un-linked by hand).
+ * - `refund-obligation` — a refund obligation already debited part of this credit as in transit
+ *   (`refundObligationId`); reversing it all would debit that share twice.
+ * - `edited-ledger-pointer` — the payment's `fxAdjustmentAccountId` names a row that is not its own FX
+ *   adjustment for the credit's customer, so the delta to reverse cannot be named.
+ * - `concurrent-link` — the payment or its ledger rows kept changing while the reversal ran; retry.
+ */
+export declare const PAYMENT_CREDIT_REVERSAL_LOCK_REASONS: readonly ["credit-reversed", "not-credited", "refund-obligation", "edited-ledger-pointer", "concurrent-link"];

package/dist/payment.js

@@ -1 +1,43 @@
-export {};
+/**
+ * The credit reversal's refusals (`PaymentCreditReversalRequest`). Each writes nothing.
+ *
+ * - `ADMIN_REQUIRED` · 403 — the token is below the ADMIN tier (an `ACCOUNTANT` is `403 ROLE_FORBIDDEN`, earlier).
+ * - `INVALID_INPUT` · 400 — the path's `source` is not `mp`, `stripe` or `mp_movement`.
+ * - `VALIDATION_FAILED` · 400 — the body is not `{ mode, reason }` or the reason is refused.
+ * - `PAYMENT_NOT_FOUND` · 404 — the store has no such payment.
+ * - `LINK_LOCKED` · 409 — `reason` is one of {@link PAYMENT_CREDIT_REVERSAL_LOCK_REASONS}.
+ * - `CUSTOMER_MERGED` · 409 — the credit's owner is mid-merge (or the payment carries a historical
+ *   merged-refund flag); `data.mergedInto` names the survivor.
+ * - `CUSTOMER_ANONYMIZED` · 409 — a legacy credit naming no customer, on an erased customer.
+ * - `CUSTOMER_NOT_FOUND` · 404 — the customer whose balance the credit moved is gone.
+ */
+export const PAYMENT_CREDIT_REVERSAL_ERROR_CODES = [
+    'ADMIN_REQUIRED',
+    'INVALID_INPUT',
+    'VALIDATION_FAILED',
+    'PAYMENT_NOT_FOUND',
+    'LINK_LOCKED',
+    'CUSTOMER_MERGED',
+    'CUSTOMER_ANONYMIZED',
+    'CUSTOMER_NOT_FOUND',
+];
+/**
+ * Every `reason` of the credit reversal's `409 LINK_LOCKED`:
+ *
+ * - `credit-reversed` — this credit was already reversed (`reversalAccountId` names the row): a second
+ *   reversal of the same credit, a replay included.
+ * - `not-credited` — the payment's `accountId` names no credit of its own (never credited, or a pointer to
+ *   a row this payment did not write), or the payment names no customer (un-linked by hand).
+ * - `refund-obligation` — a refund obligation already debited part of this credit as in transit
+ *   (`refundObligationId`); reversing it all would debit that share twice.
+ * - `edited-ledger-pointer` — the payment's `fxAdjustmentAccountId` names a row that is not its own FX
+ *   adjustment for the credit's customer, so the delta to reverse cannot be named.
+ * - `concurrent-link` — the payment or its ledger rows kept changing while the reversal ran; retry.
+ */
+export const PAYMENT_CREDIT_REVERSAL_LOCK_REASONS = [
+    'credit-reversed',
+    'not-credited',
+    'refund-obligation',
+    'edited-ledger-pointer',
+    'concurrent-link',
+];

package/dist/print.d.ts

@@ -565,6 +565,12 @@ declare global {
         /** ms epoch of the LATEST transition. Plain assignment, moves every write — the recency value to display. */
         lastTransitionAt: number;
         useCase?: PrintUseCase;
+        /**
+         * The automatic-print event (`Store.config.autoPrint`) that minted this job — stamped once, on the
+         * job's first `queued` write by the automatic-print consumer, and never cleared. ABSENT means a
+         * manual print (or a job written before this field existed — forward-only, never backfilled).
+         */
+        autoPrintEvent?: keyof StoreAutoPrintConfig;
         agentId?: string;
         printerId?: string;
         orderId?: string;

package/dist/product.d.ts

@@ -59,6 +59,13 @@ declare global {
          * `netOfNationalTaxes` when the product is rated.
          */
         prices?: PublicPriceSlot[];
+        /**
+         * The product's GTIN, derived from its barcodes (never sent): the first one
+         * typed `EAN8`, `UPC`, `EAN13` or `GTIN14` that passes the GS1 check digit and
+         * is not restricted circulation (02/20–29, store-generated). Absent when none
+         * qualifies, and on a partial frame that did not carry the barcodes.
+         */
+        gtin?: string;
     };
     /** Anonymous Web GET /products lookup; the tenant comes from the public store context. */
     interface PublicProductsByIdsInput {

package/dist/storefrontWebLiteralKeys.js

@@ -23,6 +23,10 @@ import { STOREFRONT_DESIGN_LITERAL_MAX_CODE_POINTS } from "./storefrontDesignReg
  * parameters.
  */
 export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
+    'ADDRESSES_IS_DEFAULT',
+    'ADDRESSES_LIMIT_REACHED',
+    'ADDRESSES_NOT_FOUND',
+    'ADDRESSES_WRITE_CONTENDED',
     'ALERT_INCLUDED_VAT',
     'APPOINTMENTS_BOOKED_DESC',
     'APPOINTMENTS_BOOKED_TITLE',
@@ -320,9 +324,11 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'BASKET_LINE_LIMIT_REACHED',
     'BASKET_LINE_NOT_LOADED',
     'BASKET_LINE_NOT_OFFERED',
+    'BASKET_LINE_NO_PRICE',
     'BASKET_LINE_OUT_OF_STOCK',
     'BASKET_LINE_STOCK_SHORT_HIDDEN',
     'BASKET_LINE_UNAVAILABLE',
+    'BASKET_LINE_WITHDRAWN',
     'BASKET_LOADING',
     'BASKET_MIN_BUY_MISSING',
     'BASKET_NEXT_BUTTON',
@@ -353,8 +359,28 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'BASKET_UNDO_ACTION',
     'BASKET_UPDATED_CONFIRMATION',
     'BASKET_VIEW_BASKET_ACTION',
+    'BRANDS_DIRECTORY_EMPTY',
     'BRANDS_ERR_LOAD',
+    'BRANDS_FILTER_ALL',
+    'BRANDS_JUMP_LABEL',
+    'BRANDS_LETTERS_LABEL',
+    'BRANDS_LETTER_OTHER',
+    'BRANDS_LETTER_OTHER_LABEL',
+    'BRANDS_SEARCH_CLEAR',
+    'BRANDS_SEARCH_LABEL',
+    'BRANDS_SHOW_MORE',
     'BRANDS_TITLE',
+    'BRAND_BREADCRUMB_LABEL',
+    'BRAND_DESCRIPTION_MORE',
+    'CATEGORY_DIRECTORY_EMPTY',
+    'CATEGORY_DIRECTORY_EMPTY_ACTION',
+    'CATEGORY_DIRECTORY_FAILED',
+    'CATEGORY_DIRECTORY_JUMP_LABEL',
+    'CATEGORY_MORE_ROOTS_TITLE',
+    'CATEGORY_SHOW_LESS',
+    'CATEGORY_SIBLINGS_LABEL',
+    'CATEGORY_SUBCATEGORIES_LABEL',
+    'CATEGORY_VIEW_ALL',
     'CHECKOUT_ACCESS_PENDING',
     'CHECKOUT_ACCESS_REJECTED',
     'CHECKOUT_ACCOUNT_DISABLED',
@@ -423,7 +449,6 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'CHECKOUT_DNI_REQUIRED_MESSAGE',
     'CHECKOUT_DNI_REQUIRED_MESSAGE_NO_THRESHOLD',
     'CHECKOUT_EDIT_BASKET',
-    'CHECKOUT_EMAIL_VERIFICATION_REQUIRED',
     'CHECKOUT_EMPTY_BASKET',
     'CHECKOUT_FX_NOTICE_PAYING',
     'CHECKOUT_FX_NOTICE_PREFERRED',
@@ -538,11 +563,13 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'DATA_RIGHTS_COLLECTION_CONTACTS',
     'DATA_RIGHTS_COLLECTION_FAVORITES',
     'DATA_RIGHTS_COLLECTION_INVOICES',
+    'DATA_RIGHTS_COLLECTION_LOYALTY',
     'DATA_RIGHTS_COLLECTION_NOTES',
     'DATA_RIGHTS_COLLECTION_ORDERS',
     'DATA_RIGHTS_COLLECTION_PAYMENTS',
     'DATA_RIGHTS_COLLECTION_QUOTE_REQUESTS',
     'DATA_RIGHTS_COLLECTION_RECENT_PURCHASES',
+    'DATA_RIGHTS_COLLECTION_SERVICE_ORDERS',
     'DATA_RIGHTS_COLLECTION_WHOLESALE_REQUESTS',
     'DATA_RIGHTS_DIALOG_ACK',
     'DATA_RIGHTS_DIALOG_CONFIRM',
@@ -623,6 +650,11 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'FAVORITES_TOGGLE_ARIA',
     'FAVORITES_TOGGLE_NAME',
     'FAVORITES_UNAVAILABLE',
+    'FOOTER_DEFAULT_ACCOUNT_TITLE',
+    'FOOTER_DEFAULT_CONTACT',
+    'FOOTER_DEFAULT_HELP_TITLE',
+    'FOOTER_DEFAULT_SHOP_TITLE',
+    'FOOTER_LEGAL_NAV_ARIA',
     'FOOTER_PRIVACY_POLICY',
     'FORMS_FIELD_DNI_LABEL',
     'FORMS_FIELD_PHONE_LABEL',
@@ -669,7 +701,6 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'FORMS_ZOD_VALUE_OPTIONS',
     'FORM_FIX_ERRORS',
     'GLOBALS_APPOINTMENTS',
-    'GLOBALS_APP_VERSION',
     'GLOBALS_BASKET',
     'GLOBALS_BRANDS',
     'GLOBALS_CATEGORIES',
@@ -741,6 +772,9 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'HEADER_SEARCH_INPUT',
     'HEADER_SEARCH_LABEL',
     'HEADER_SEARCH_RECENT',
+    'HEADER_SEARCH_RECENT_CLEAR',
+    'HEADER_SEARCH_RECENT_CLEAR_ARIA',
+    'HEADER_SEARCH_RECENT_REMOVE',
     'HEADER_SEARCH_SUGGESTIONS',
     'HEADER_SEARCH_SUGGESTION_BARCODE',
     'HEADER_SEARCH_SUGGESTION_SKU',
@@ -886,7 +920,9 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'MAINTENANCE_REDIRECT_TO_BASKET',
     'MAINTENANCE_SUPPORT_HINT_EMAIL',
     'MAINTENANCE_SURVEY_DISABLED',
+    'MAINTENANCE_WHATSAPP_OPT_IN_DISABLED',
     'MAINTENANCE_WHOLESALE_REQUEST_DISABLED',
+    'MAINTENANCE_WITHDRAWAL_DISABLED',
     'MARKETING_ACTIVATE_ALL',
     'MARKETING_ACTIVE_COUNT',
     'MARKETING_CHANNEL_ADS',
@@ -895,12 +931,6 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'MARKETING_CHANNEL_EMAIL',
     'MARKETING_CHANNEL_EMAIL_DESC',
     'MARKETING_CHANNEL_EMAIL_EXAMPLE',
-    'MARKETING_CHANNEL_SMS',
-    'MARKETING_CHANNEL_SMS_DESC',
-    'MARKETING_CHANNEL_SMS_EXAMPLE',
-    'MARKETING_CHANNEL_WHATSAPP',
-    'MARKETING_CHANNEL_WHATSAPP_DESC',
-    'MARKETING_CHANNEL_WHATSAPP_EXAMPLE',
     'MARKETING_DEACTIVATE_ALL',
     'MARKETING_ERROR_MESSAGE',
     'MARKETING_EXAMPLE_PREFIX',
@@ -920,6 +950,7 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'MOBILE_BUTTONS_BASKET',
     'MOBILE_BUTTONS_FAVORITES',
     'MOBILE_BUTTONS_INVOICES',
+    'MOBILE_BUTTONS_NAV_ARIA',
     'MOBILE_BUTTONS_ORDERS',
     'NETWORK_OFFLINE',
     'NETWORK_REQUEST_FAILED',
@@ -948,6 +979,10 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'NOTIFICATION_PREFS_SUBTITLE',
     'NOTIFICATION_PREFS_TITLE',
     'NOTIFICATION_PREFS_UNAVAILABLE_RETRY',
+    'NOTIFICATION_PREFS_WHATSAPP_ARIA',
+    'NOTIFICATION_PREFS_WHATSAPP_DESCRIPTION',
+    'NOTIFICATION_PREFS_WHATSAPP_LABEL',
+    'NOTIFICATION_PREFS_WHATSAPP_NOT_SAVED',
     'NOT_FOUND_BACK_HOME',
     'NOT_FOUND_PAGE_BODY',
     'NOT_FOUND_PAGE_TITLE',
@@ -1176,6 +1211,7 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'PREVIEW_UNAVAILABLE_ACTION',
     'PREVIEW_VARIANTS',
     'PREVIEW_WAITING',
+    'PRICING_NET_PLUS_IVA',
     'PRICING_TIER_CHIP',
     'PRICING_TIER_FROM',
     'PRICING_TIER_UNITS',
@@ -1186,10 +1222,14 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'PRODUCTS_CLEAR_FILTERS',
     'PRODUCTS_FILTERS_LABEL',
     'PRODUCTS_FILTER_ALL_BRANDS',
+    'PRODUCTS_FILTER_ALL_CATEGORIES',
     'PRODUCTS_FILTER_ALL_PRODUCTS',
     'PRODUCTS_FILTER_ALL_TAGS',
     'PRODUCTS_FILTER_AVAILABILITY',
     'PRODUCTS_FILTER_BRAND',
+    'PRODUCTS_FILTER_BRAND_UNAVAILABLE',
+    'PRODUCTS_FILTER_CATEGORY',
+    'PRODUCTS_FILTER_CATEGORY_UNAVAILABLE',
     'PRODUCTS_FILTER_IN_OFFER',
     'PRODUCTS_FILTER_IN_STOCK',
     'PRODUCTS_FILTER_TAG',
@@ -1200,10 +1240,14 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'PRODUCTS_NO_INCOMES',
     'PRODUCTS_NO_MATCHES',
     'PRODUCTS_NO_RESULTS',
+    'PRODUCTS_PICK_SUBCATEGORY',
     'PRODUCTS_SEARCH_TITLE',
-    'PRODUCTS_SELECT_CATEGORY',
     'PRODUCTS_SORT_LABEL',
+    'PRODUCTS_SORT_NAME_ASC',
+    'PRODUCTS_SORT_NAME_DESC',
     'PRODUCTS_SORT_NEWEST',
+    'PRODUCTS_SORT_PRICE_ASC',
+    'PRODUCTS_SORT_PRICE_DESC',
     'PRODUCTS_SORT_RELEVANCE',
     'PRODUCTS_TAG_NOT_FOUND',
     'PRODUCTS_TAG_TITLE',
@@ -1247,6 +1291,8 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'PRODUCT_INFO_TITLE',
     'PRODUCT_LOAD_FAILED',
     'PRODUCT_PAGE_TITLE',
+    'PRODUCT_PRICE_ON_REQUEST',
+    'PRODUCT_PRICE_ON_REQUEST_HINT',
     'PRODUCT_PRICE_PER_UNIT',
     'PRODUCT_PROMOTIONS_HINT',
     'PRODUCT_PROMOTIONS_TITLE',
@@ -1398,6 +1444,7 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'QUOTE_REQUEST_SIGNED_IN_HINT',
     'QUOTE_REQUEST_SUBMIT',
     'QUOTE_REQUEST_SUCCESS',
+    'REORDER_SHELF_TITLE',
     'SALE_BADGE_OFFER',
     'SALE_CHIP_ALL',
     'SALE_DISCOUNT_PERCENT',
@@ -1486,6 +1533,14 @@ export const STOREFRONT_WEB_LITERAL_KEYS = Object.freeze([
     'SURVEY_TITLE',
     'SYNC_ALERT_ERROR_MESSAGE',
     'SYNC_ALERT_OFFLINE_MESSAGE',
+    'WHATSAPP_OPT_IN_ERROR',
+    'WHATSAPP_OPT_IN_HELP_GUEST',
+    'WHATSAPP_OPT_IN_HELP_SIGNED_IN',
+    'WHATSAPP_OPT_IN_OFFER_ACTION',
+    'WHATSAPP_OPT_IN_OFFER_TEXT',
+    'WHATSAPP_OPT_IN_PROFILE_LINK',
+    'WHATSAPP_OPT_IN_SUCCESS',
+    'WHATSAPP_OPT_IN_UNAVAILABLE',
     'WHOLESALE_REQUEST_ACTIVITY_LABEL',
     'WHOLESALE_REQUEST_ALREADY_PENDING',
     'WHOLESALE_REQUEST_APPROVED',

package/dist/userActivity.d.ts

@@ -939,6 +939,21 @@ declare global {
         payment_id: string;
         source: 'mp' | 'stripe' | 'mp_movement';
     }
+    /**
+     * ADMIN-tier staff reversed a linked payment's ledger credit (`POST /payments/{source}/{paymentId}/link`
+     * `{ mode: 'reverse-credit' }`). `user_id` is the acting operator; `customer_id` the customer whose
+     * balance rose by `amount` (in the ledger `currency`). Ids and figures only — never the operator's reason.
+     * BE-emitted, after the commit.
+     */
+    interface PaymentCreditReversedEvent extends UserActivityEventBase {
+        event: 'Payment Credit Reversed';
+        payment_id: string;
+        source: PaymentReceivedSource;
+        customer_id: string;
+        reversal_account_id: string;
+        amount: number;
+        currency: string;
+    }
     interface PaymentLinkageUpdatedEvent extends UserActivityEventBase {
         event: 'Payment Linkage Updated';
         payment_id: string;
@@ -1400,7 +1415,7 @@ declare global {
         event: 'Store Network Removed';
         network_id: string;
     }
-    type UserActivityEvent = CustomerConsentImportedEvent | CustomerConsentImportCompletedEvent | UserLoggedInEvent | UserLoggedOutEvent | UserPasswordChangedEvent | UserSuspendedEvent | TwoFactorEnrolledEvent | TwoFactorDisabledEvent | TwoFactorResetEvent | TwoFactorRecoveryCodesGeneratedEvent | PasskeyRegisteredEvent | PasskeyRevokedEvent | CustomerPasskeysRevokedEvent | StoreSettingsUpdatedEvent | PlanChangedEvent | InvoiceCreatedEvent | OrderCreatedEvent | OrderCancelledEvent | OrderEditedEvent | OrderReturnedEvent | ReturnLineRegradedEvent | ProductPriceChangedEvent | CustomerCreatedEvent | CustomerEditedEvent | CustomerRecordServedEvent | CustomerCreditCheckPerformedEvent | CustomersMergedEvent | CustomerMergeCancelledEvent | CashDrawerOpenedEvent | CashDrawerClosedEvent | TenantImpersonatedEvent | SecretRotatedEvent | UserCreatedEvent | UserUpdatedEvent | ProductCreatedEvent | ProductUpdatedEvent | StockIncomeCreatedEvent | StockAdjustedEvent | CategoryCreatedEvent | CategoryUpdatedEvent | BrandCreatedEvent | BrandUpdatedEvent | AttributeCreatedEvent | AttributeUpdatedEvent | SupplierCreatedEvent | SupplierUpdatedEvent | SupplierInvoiceCreatedEvent | SupplierInvoiceMatchOverriddenEvent | SupplierClaimRaisedEvent | SupplierClaimStatusChangedEvent | SupplierAccountCreatedEvent | SupplierAccountUpdatedEvent | AccountCreatedEvent | AccountDeletedEvent | CustomerBalanceReprojectedEvent | BasketUpdatedEvent | BasketDiscountGrantedEvent | BasketDeletedEvent | CashDrawerMovementEvent | CashDrawerReconciledEvent | PaymentCreatedEvent | PaymentLinkedEvent | PaymentUnlinkedEvent | PaymentLinkageUpdatedEvent | CreditLimitOverriddenEvent | AppointmentSelfBookingBlockOverriddenEvent | AppointmentSelfBookingBlockLiftedEvent | NotificationReadEvent | LogDeletedEvent | PlanCreatedEvent | StoreMaintenanceToggledEvent | PlatformMaintenanceToggledEvent | MaintenanceBroadcastSentEvent | TenantCreatedEvent | LiteralUpdatedEvent | SupportTicketCreatedEvent | SupportTicketUpdatedEvent | AuditTrailViewedEvent | ReportViewedEvent | CustomerPiiViewedEvent | CashDrawerUiOpenedEvent | CashDrawerUiClosedEvent | ExportInitiatedEvent | ImpersonationUiStartedEvent | ImpersonationUiEndedEvent | PaymentViewedEvent | InvoiceViewedEvent | CustomerDetailViewedEvent | SupplierAccountViewedEvent | SearchPerformedEvent | ActionDeniedEvent | TwoFactorChallengeShownEvent | TwoFactorCodeValidationFailedEvent | TwoFactorEnrollmentStartedEvent | TwoFactorRecoveryCodesRevealedEvent | TwoFactorResetInitiatedEvent | IntegrationTokenRefreshedEvent | WaitlistConvertedEvent | PlatformConfigUpdatedEvent | MlChannelStatusChangedEvent | IntegrationConnectionChangedEvent | PrintRuleCreatedEvent | PrintRuleEditedEvent | PrintRuleDeletedEvent | WebhookCreatedEvent | WebhookUpdatedEvent | WebhookDeletedEvent | PrinterActiveToggledEvent | PrinterRawFormatsUpdatedEvent | PrinterProfileUpdatedEvent | PlanTemplateUpdatedEvent | SupplierAccountDeletedEvent | CustomerPasswordResetInitiatedEvent | UserSessionsRevokedEvent | UserAnonymizedEvent | UserPasswordResetInitiatedByOperatorEvent | AgentCommandDispatchedEvent | PrintJobCancelledEvent | PrintAgentPairingCodeMintedEvent | PrintAgentPairedEvent | PrintAgentRevokedEvent | RmaRequestedEvent | RmaTransitionedEvent | RmaTrackingUpdatedEvent | ClockedInEvent | ClockedOutEvent | AttendanceCorrectedEvent | StoreNetworkRegisteredEvent | StoreNetworkRemovedEvent;
+    type UserActivityEvent = CustomerConsentImportedEvent | CustomerConsentImportCompletedEvent | UserLoggedInEvent | UserLoggedOutEvent | UserPasswordChangedEvent | UserSuspendedEvent | TwoFactorEnrolledEvent | TwoFactorDisabledEvent | TwoFactorResetEvent | TwoFactorRecoveryCodesGeneratedEvent | PasskeyRegisteredEvent | PasskeyRevokedEvent | CustomerPasskeysRevokedEvent | StoreSettingsUpdatedEvent | PlanChangedEvent | InvoiceCreatedEvent | OrderCreatedEvent | OrderCancelledEvent | OrderEditedEvent | OrderReturnedEvent | ReturnLineRegradedEvent | ProductPriceChangedEvent | CustomerCreatedEvent | CustomerEditedEvent | CustomerRecordServedEvent | CustomerCreditCheckPerformedEvent | CustomersMergedEvent | CustomerMergeCancelledEvent | CashDrawerOpenedEvent | CashDrawerClosedEvent | TenantImpersonatedEvent | SecretRotatedEvent | UserCreatedEvent | UserUpdatedEvent | ProductCreatedEvent | ProductUpdatedEvent | StockIncomeCreatedEvent | StockAdjustedEvent | CategoryCreatedEvent | CategoryUpdatedEvent | BrandCreatedEvent | BrandUpdatedEvent | AttributeCreatedEvent | AttributeUpdatedEvent | SupplierCreatedEvent | SupplierUpdatedEvent | SupplierInvoiceCreatedEvent | SupplierInvoiceMatchOverriddenEvent | SupplierClaimRaisedEvent | SupplierClaimStatusChangedEvent | SupplierAccountCreatedEvent | SupplierAccountUpdatedEvent | AccountCreatedEvent | AccountDeletedEvent | CustomerBalanceReprojectedEvent | BasketUpdatedEvent | BasketDiscountGrantedEvent | BasketDeletedEvent | CashDrawerMovementEvent | CashDrawerReconciledEvent | PaymentCreatedEvent | PaymentLinkedEvent | PaymentUnlinkedEvent | PaymentCreditReversedEvent | PaymentLinkageUpdatedEvent | CreditLimitOverriddenEvent | AppointmentSelfBookingBlockOverriddenEvent | AppointmentSelfBookingBlockLiftedEvent | NotificationReadEvent | LogDeletedEvent | PlanCreatedEvent | StoreMaintenanceToggledEvent | PlatformMaintenanceToggledEvent | MaintenanceBroadcastSentEvent | TenantCreatedEvent | LiteralUpdatedEvent | SupportTicketCreatedEvent | SupportTicketUpdatedEvent | AuditTrailViewedEvent | ReportViewedEvent | CustomerPiiViewedEvent | CashDrawerUiOpenedEvent | CashDrawerUiClosedEvent | ExportInitiatedEvent | ImpersonationUiStartedEvent | ImpersonationUiEndedEvent | PaymentViewedEvent | InvoiceViewedEvent | CustomerDetailViewedEvent | SupplierAccountViewedEvent | SearchPerformedEvent | ActionDeniedEvent | TwoFactorChallengeShownEvent | TwoFactorCodeValidationFailedEvent | TwoFactorEnrollmentStartedEvent | TwoFactorRecoveryCodesRevealedEvent | TwoFactorResetInitiatedEvent | IntegrationTokenRefreshedEvent | WaitlistConvertedEvent | PlatformConfigUpdatedEvent | MlChannelStatusChangedEvent | IntegrationConnectionChangedEvent | PrintRuleCreatedEvent | PrintRuleEditedEvent | PrintRuleDeletedEvent | WebhookCreatedEvent | WebhookUpdatedEvent | WebhookDeletedEvent | PrinterActiveToggledEvent | PrinterRawFormatsUpdatedEvent | PrinterProfileUpdatedEvent | PlanTemplateUpdatedEvent | SupplierAccountDeletedEvent | CustomerPasswordResetInitiatedEvent | UserSessionsRevokedEvent | UserAnonymizedEvent | UserPasswordResetInitiatedByOperatorEvent | AgentCommandDispatchedEvent | PrintJobCancelledEvent | PrintAgentPairingCodeMintedEvent | PrintAgentPairedEvent | PrintAgentRevokedEvent | RmaRequestedEvent | RmaTransitionedEvent | RmaTrackingUpdatedEvent | ClockedInEvent | ClockedOutEvent | AttendanceCorrectedEvent | StoreNetworkRegisteredEvent | StoreNetworkRemovedEvent;
 }
 /**
  * Canonical whitelist of UI-only `UserActivityEvent` variant names. Imported by

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "platform-types",
-	"version": "1.10.853",
+	"version": "1.10.854",
 	"description": "Shared wire and entity contracts for the platform.",
 	"type": "module",
 	"main": "dist/index.js",