@tallyui/pos 3.0.1 → 3.0.3

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { Money, TaxRounding, TallyConnector, SyncContext, StoreSettingsChoice, StoreSettings, StoreSettingsChoices, ProductTraits, PaymentMethodKind, CommandServerRefs, CommandWarning, CommandError, ServerCapabilities, OrderCreateEnvelope, RegisterCommandType, RegisterCommandResult, VariantSummary, CommandResult, AnyCommandEnvelope, CommandEnvelope, OrderCreatePayload, RegisterCommandEnvelope } from '@tallyui/core';
+import { Money, TaxRounding, TallyConnector, SyncContext, StoreSettingsChoice, StoreSettings, StoreSettingsChoices, ProductTraits, PaymentMethodKind, CommandServerRefs, CommandWarning, CommandError, ServerCapabilities, OrderCreateEnvelope, RegisterCommandType, RegisterCommandResult, VariantSummary, TraitContext, CommandResult, AnyCommandEnvelope, CommandEnvelope, OrderCreatePayload, RegisterCommandEnvelope } from '@tallyui/core';
 export { getProductStock, withStockOverlay } from '@tallyui/core';
 export { countFresh, readFresh, watchFresh } from '@tallyui/core/rxdb';
 import * as rxdb from 'rxdb';
@@ -376,6 +376,8 @@ interface OrderBuilder {
     }): string;
     addLine(input: AddLineInput): string;
     updateQuantity(lineId: string, quantity: number): void;
+    /** Sets a line's unit price (a till price edit), in minor units of the order's currency and the line's own tax mode; its discounts and tax are recomputed. */
+    setUnitPrice(lineId: string, amountMinor: number): void;
     removeItem(lineId: string): void;
     applyLineDiscount(lineId: string, discount: Discount): void;
     applyOrderDiscount(discount: Discount): void;
@@ -424,6 +426,15 @@ declare function taxFiguresForBasket(currency: string, pricesIncludeTax: boolean
  */
 declare function allocateOrderDiscount(lineAmountsMinor: readonly number[], totalMinor: number): number[];
 
+/** Apps create their drafts collection with this schema. */
+declare const orderDraftSchema: RxJsonSchema<{
+    id: string;
+    data: string;
+    customerName?: string;
+    itemCount?: number;
+    total?: number;
+    parkedAt?: string;
+}>;
 interface ParkedOrderSummary {
     id: string;
     customerName?: string;
@@ -432,6 +443,13 @@ interface ParkedOrderSummary {
     parkedAt: string;
     source: 'local' | 'server';
 }
+declare function writeOrderDraft(drafts: RxCollection, snapshot: Order): Promise<string>;
+declare function restoreOrderDraft(saved: Order, options: {
+    currency: string;
+    taxContext: TaxContext;
+}): OrderBuilder;
+declare function parkedOrderSummaries$(drafts: RxCollection): Observable<ParkedOrderSummary[]>;
+
 interface OrderManagerOptions {
     currency: string;
     taxContext: TaxContext;
@@ -1790,8 +1808,9 @@ type CatalogueEntry<Doc> = {
     product: Doc;
     variant: VariantSummary;
 };
-/** Every variant of every product, in product order then variant order. */
-declare function catalogueEntries<Doc>(products: Doc[], traits: ProductTraits<Doc>): CatalogueEntry<Doc>[];
+/** Variants in product/variant order, passing context through; without getVariants,
+ * simple products use their own traits and products with variants contribute no entries. */
+declare function catalogueEntries<Doc>(products: Doc[], traits: ProductTraits<Doc>, context?: TraitContext): CatalogueEntry<Doc>[];
 /** Barcode-then-SKU lookup across all products. */
 declare function findEntryByCode<Doc>(entries: CatalogueEntry<Doc>[], code: string): CatalogueEntry<Doc> | undefined;
 /** Display the resolved price in the requested currency. */
@@ -1818,6 +1837,8 @@ declare function useSale(settings: Pick<StoreSettings, 'currency'>, opts: {
     registerId: string;
     cashierRef: string;
     capabilities?: ServerCapabilities;
+    /** Where `park()` keeps parked carts; create it with `orderDraftSchema` */
+    drafts?: RxCollection;
     /**
      * When set, `complete()` stamps the finalized order with this session before `onSaleCompleted`.
      * `complete()` runs after the money is taken, so a refused stamp (the session closed or went
@@ -1850,6 +1871,8 @@ declare function useSale(settings: Pick<StoreSettings, 'currency'>, opts: {
     canContinue: boolean;
     add(entry: CatalogueEntry<any>, traits: ProductTraits<any>): void;
     setQuantity(lineId: string, quantity: number): void;
+    /** Sets a line's unit price in minor units of its own tax mode, recomputing discounts and tax; returns a refusal or null. */
+    setUnitPrice(lineId: string, amountMinor: number): string | null;
     remove(lineId: string): void;
     /** A line's discount, or the order's without a line; returns the refusal to show, or null once applied. */
     applyDiscount(lineId: string | null, discount: Discount): string | null;
@@ -1903,6 +1926,10 @@ declare function useSale(settings: Pick<StoreSettings, 'currency'>, opts: {
      * updates or requeues `pos_orders` itself.
      */
     newSale(): void;
+    /** Parks the cart in `drafts`; resolves to a refusal message, or null once parked. */
+    park(): Promise<string | null>;
+    /** Resumes a draft into an empty cart; resolves to a refusal message, or null once resumed. */
+    resume(draftId: string): Promise<string | null>;
     /**
      * Continue after a failed save whose order is confirmed stored (`canContinue`): exactly `newSale()`.
      * The order stays pending in the outbox, which will send it; it isn't handed to `onSaleCompleted` again, and
@@ -2277,4 +2304,4 @@ declare function planLegs(plan: TenderPlan, rowsSinceFrom: {
     };
 };
 
-export { type Actor, type AddLineInput, type AppliedDiscount, type BackendNotFound, type BasketLine, CartError, type CashMovement, type CashMovementCollection, type CatalogueEntry, type Closure, type ClosureCollection, type ClosureContext, type ClosureScope, type CommandTransport, type Correction, CurrencyProvider, type CurrencyProviderProps, type CustomerSummary, DISCOUNTS_UNSUPPORTED, type Discount, type DisplayLine, type DisplayTotals, type FinalizeOptions, type HttpTransportOptions, type LedgerRow, type LineItem, type LineTaxLine, type LogEntry, type LogLevel, type LogSink, type Logger, MAX_TENDER_MINOR, MICROS_PER_MINOR, type Movement$1 as Movement, type MovementType, type Order, type OrderBuilder, type OrderBuilderOptions, OrderContentMismatchError, type OrderManager, type OrderManagerOptions, type OrderOutbox, type OrderOutboxOptions, type OrderTaxTotals, type OutboxState, type ParkedOrderSummary, type Payment, type PaymentMethod, type PaymentTransport, type PlanLeg, type PosOrder, type PosOrderLine, type PosOrderLocalWarning, PosOrderOpenClosedError, type PosOrderPayment, type PosOrderServerFailures, type PosOrderSyncStatus, type RateTaxLine, type ReceiptConfig, type ReceiptData, type ReceiptLineItem, type RecordedFigures, RegisterApprovalRequiredError, type RegisterBucket, RegisterCloseIncompleteError, type RegisterCommand, type RegisterCommandCollection, type RegisterCounters, type RegisterDocument, type RegisterFact, type RegisterHost, RegisterIdInvalidError, RegisterMovementAmountError, RegisterMovementReasonError, RegisterMovementStrandedError, type RegisterOutbox, type RegisterOutboxOptions, type RegisterSession, RegisterSessionAlreadyOpenError, RegisterSessionClosedError, type RegisterSessionCollection, RegisterSessionRequiredError, type RegisterStore, RegisterTenderInProgressError, type Repository, type ResolveStoreSettingsOptions, SALE_SAVING, type SaleStage, type SentOrder, type SplitTab, type StoreSettingsResolution, type StoreSettingsState, TAX_ROUNDING_MIXED_NOTE, type TaxContext, type TaxLineInput, TaxProvider, type TaxProviderProps, type TaxRateMap, type TenderAction, type TenderKey, type TenderLineId, type TenderPlan, type TenderState, type TenderView, type TransportOutcome, UnsupportedOrderVersionError, type UseOrderOutboxOptions, type UseOrderOutboxResult, type UseRegisterOutboxOptions, type UseRegisterOutboxResult, type UseRegisterSessionOptions, activePlan, addEntryToCart, addPosOrderCollection, advancePerpetual, allocateOrderDiscount, appliedMinor, backToSelling, bindRegister, buildClosureDocument, buildReceiptData, buildXReportDocument, callbackSink, cashMovementSchema, catalogueEntries, changeMinor, clampClosureScope, closeNeedsApproval, closeSession, closureCommand, closureSchema, computeOrderTax, consoleSink, countVariance, createBackendNotFound, createHttpCommandTransport, createLogger, createOrderBuilder, createOrderManager, createOrderOutbox, createRegisterOutbox, createRepository, denominationTotal, denominations, deriveExpected, deriveSettled, ensureRegister, evenSplitShareMinor, exportCsv, finalizeOrder, findEntryByCode, formatClosureDate, getBoundRegisterId, getDeviceId, initTenderState, initialTenderState, isServerDecimal, labelKeys, minorToDecimal, mintClosureNumber, mintUuid, movementCommand, movementFieldError, needsAttention, nextSaleCounter, normalizeAmount, observeRegister$, openSession, openSessionSelector, outboxLogger, overThreshold, parseMinor, planLegs, posOrderCollection, posOrderSchema, posOrdersLogger, quickTenderedAmounts, ratePpmFromPercent, readBoundRegister, readRegister, reconcileRegisterCommands, recordMovement, recordRegisterFact, registerCommandCollection, registerCommandSchema, registerCommandsLogger, registerFactsLogger, registerSessionCollection, registerSessionSchema, requireOpenSession, resolveStoreSettings, roundMicrosToMinor, saleLogger, sameSale, searchProducts, selectClosureRows, sessionOpenCommand, sessionTransitionCommand, stampSession, startCounting, stockOverlay$, stockOverlayAsOf$, taxFiguresForBasket, taxLinesByRate, taxLogger, taxMicros, taxProviderProps, tenderReducer, toOrderCreateEnvelope, unbindRegister, useCurrencyCode, useCurrencyFormatter, useOrderOutbox, useRegisterOutbox, useRegisterSession, useSale, useStoreSettings, useTax, uuidv7, validAmount, varianceText, variantPriceLabel, voidMovement, withPricingContext, writeClosure };
+export { type Actor, type AddLineInput, type AppliedDiscount, type BackendNotFound, type BasketLine, CartError, type CashMovement, type CashMovementCollection, type CatalogueEntry, type Closure, type ClosureCollection, type ClosureContext, type ClosureScope, type CommandTransport, type Correction, CurrencyProvider, type CurrencyProviderProps, type CustomerSummary, DISCOUNTS_UNSUPPORTED, type Discount, type DisplayLine, type DisplayTotals, type FinalizeOptions, type HttpTransportOptions, type LedgerRow, type LineItem, type LineTaxLine, type LogEntry, type LogLevel, type LogSink, type Logger, MAX_TENDER_MINOR, MICROS_PER_MINOR, type Movement$1 as Movement, type MovementType, type Order, type OrderBuilder, type OrderBuilderOptions, OrderContentMismatchError, type OrderManager, type OrderManagerOptions, type OrderOutbox, type OrderOutboxOptions, type OrderTaxTotals, type OutboxState, type ParkedOrderSummary, type Payment, type PaymentMethod, type PaymentTransport, type PlanLeg, type PosOrder, type PosOrderLine, type PosOrderLocalWarning, PosOrderOpenClosedError, type PosOrderPayment, type PosOrderServerFailures, type PosOrderSyncStatus, type RateTaxLine, type ReceiptConfig, type ReceiptData, type ReceiptLineItem, type RecordedFigures, RegisterApprovalRequiredError, type RegisterBucket, RegisterCloseIncompleteError, type RegisterCommand, type RegisterCommandCollection, type RegisterCounters, type RegisterDocument, type RegisterFact, type RegisterHost, RegisterIdInvalidError, RegisterMovementAmountError, RegisterMovementReasonError, RegisterMovementStrandedError, type RegisterOutbox, type RegisterOutboxOptions, type RegisterSession, RegisterSessionAlreadyOpenError, RegisterSessionClosedError, type RegisterSessionCollection, RegisterSessionRequiredError, type RegisterStore, RegisterTenderInProgressError, type Repository, type ResolveStoreSettingsOptions, SALE_SAVING, type SaleStage, type SentOrder, type SplitTab, type StoreSettingsResolution, type StoreSettingsState, TAX_ROUNDING_MIXED_NOTE, type TaxContext, type TaxLineInput, TaxProvider, type TaxProviderProps, type TaxRateMap, type TenderAction, type TenderKey, type TenderLineId, type TenderPlan, type TenderState, type TenderView, type TransportOutcome, UnsupportedOrderVersionError, type UseOrderOutboxOptions, type UseOrderOutboxResult, type UseRegisterOutboxOptions, type UseRegisterOutboxResult, type UseRegisterSessionOptions, activePlan, addEntryToCart, addPosOrderCollection, advancePerpetual, allocateOrderDiscount, appliedMinor, backToSelling, bindRegister, buildClosureDocument, buildReceiptData, buildXReportDocument, callbackSink, cashMovementSchema, catalogueEntries, changeMinor, clampClosureScope, closeNeedsApproval, closeSession, closureCommand, closureSchema, computeOrderTax, consoleSink, countVariance, createBackendNotFound, createHttpCommandTransport, createLogger, createOrderBuilder, createOrderManager, createOrderOutbox, createRegisterOutbox, createRepository, denominationTotal, denominations, deriveExpected, deriveSettled, ensureRegister, evenSplitShareMinor, exportCsv, finalizeOrder, findEntryByCode, formatClosureDate, getBoundRegisterId, getDeviceId, initTenderState, initialTenderState, isServerDecimal, labelKeys, minorToDecimal, mintClosureNumber, mintUuid, movementCommand, movementFieldError, needsAttention, nextSaleCounter, normalizeAmount, observeRegister$, openSession, openSessionSelector, orderDraftSchema, outboxLogger, overThreshold, parkedOrderSummaries$, parseMinor, planLegs, posOrderCollection, posOrderSchema, posOrdersLogger, quickTenderedAmounts, ratePpmFromPercent, readBoundRegister, readRegister, reconcileRegisterCommands, recordMovement, recordRegisterFact, registerCommandCollection, registerCommandSchema, registerCommandsLogger, registerFactsLogger, registerSessionCollection, registerSessionSchema, requireOpenSession, resolveStoreSettings, restoreOrderDraft, roundMicrosToMinor, saleLogger, sameSale, searchProducts, selectClosureRows, sessionOpenCommand, sessionTransitionCommand, stampSession, startCounting, stockOverlay$, stockOverlayAsOf$, taxFiguresForBasket, taxLinesByRate, taxLogger, taxMicros, taxProviderProps, tenderReducer, toOrderCreateEnvelope, unbindRegister, useCurrencyCode, useCurrencyFormatter, useOrderOutbox, useRegisterOutbox, useRegisterSession, useSale, useStoreSettings, useTax, uuidv7, validAmount, varianceText, variantPriceLabel, voidMovement, withPricingContext, writeClosure, writeOrderDraft };

package/dist/index.js

@@ -745,6 +745,15 @@ function createOrderBuilder(options) {
       }
       emit();
     },
+    setUnitPrice(lineId, amountMinor) {
+      if (!Number.isInteger(amountMinor)) throw new RangeError("Price must be integer minor units");
+      if (amountMinor < 0) throw new RangeError("Price must be >= 0");
+      if (!lineItems.some((li) => li.id === lineId)) throw new Error(`Unknown line ${lineId}`);
+      lineItems = lineItems.map(
+        (li) => li.id === lineId ? recalculateLine({ ...li, unitPriceMinor: amountMinor }) : li
+      );
+      emit();
+    },
     removeItem(lineId) {
       lineItems = lineItems.filter((li) => li.id !== lineId);
       emit();
@@ -833,7 +842,10 @@ function taxFiguresForBasket(currency, pricesIncludeTax, lines, rounding) {
 }
 
 // src/order/order-manager.ts
-import { BehaviorSubject as BehaviorSubject2, map as map2 } from "rxjs";
+import { BehaviorSubject as BehaviorSubject2 } from "rxjs";
+
+// src/order/order-drafts.ts
+import { map as map2 } from "rxjs";
 
 // src/pos-order/command.ts
 var UnsupportedOrderVersionError = class extends Error {
@@ -934,13 +946,86 @@ function toOrderCreateEnvelope(order, deviceId, attempt2 = 1, options) {
   };
 }
 
-// src/order/order-manager.ts
-function createOrderManager(options) {
-  const { taxContext, draftsCollection } = options;
-  const currency = options.currency.toUpperCase();
-  let activeBuilder = createOrderBuilder({ currency, taxContext });
-  const activeSubject = new BehaviorSubject2(activeBuilder);
-  const parkedOrders$ = draftsCollection.find().$.pipe(
+// src/order/order-drafts.ts
+var orderDraftSchema = {
+  version: 0,
+  primaryKey: "id",
+  type: "object",
+  properties: {
+    id: { type: "string", maxLength: 100 },
+    data: { type: "string" },
+    customerName: { type: "string" },
+    itemCount: { type: "integer", minimum: 0, maximum: 2147483647, multipleOf: 1 },
+    total: { type: "number" },
+    parkedAt: { type: "string" }
+  },
+  required: ["id", "data"]
+};
+async function writeOrderDraft(drafts, snapshot) {
+  await drafts.upsert({
+    id: snapshot.id,
+    data: JSON.stringify(snapshot),
+    customerName: snapshot.customer?.name ?? "",
+    itemCount: snapshot.lineItems.length,
+    total: snapshot.totalMinor,
+    parkedAt: (/* @__PURE__ */ new Date()).toISOString()
+  });
+  return snapshot.id;
+}
+function restoreOrderDraft(saved, options) {
+  const { currency, taxContext } = options;
+  const builder = createOrderBuilder({
+    currency,
+    taxContext,
+    id: saved.id
+  });
+  if (saved.customer && !customerRefusal(saved.customer)) {
+    builder.setCustomer(saved.customer);
+  }
+  if (saved.note) {
+    builder.setNote(saved.note);
+  }
+  for (const line of saved.lineItems) {
+    const lineId = builder.addLine({
+      productId: line.productId,
+      variantId: line.variantId,
+      name: line.name,
+      sku: line.sku,
+      imageUrl: line.imageUrl,
+      unitPrice: { amount: line.unitPriceMinor, currency, taxInclusive: line.taxInclusive },
+      quantity: line.quantity,
+      taxRates: line.taxLines.map(({ code, ratePpm }) => ({ code, ratePpm }))
+    });
+    for (const discount of line.discounts) {
+      builder.applyLineDiscount(lineId, {
+        type: discount.type,
+        value: discount.value,
+        label: discount.label,
+        couponCode: discount.couponCode
+      });
+    }
+  }
+  for (const discount of saved.discounts) {
+    builder.applyOrderDiscount({
+      type: discount.type,
+      value: discount.value,
+      label: discount.label,
+      couponCode: discount.couponCode
+    });
+  }
+  for (const payment of saved.payments) {
+    builder.addPayment({
+      method: payment.method,
+      amountMinor: payment.amountMinor,
+      tenderedMinor: payment.tenderedMinor,
+      changeMinor: payment.changeMinor,
+      reference: payment.reference
+    });
+  }
+  return builder;
+}
+function parkedOrderSummaries$(drafts) {
+  return drafts.find().$.pipe(
     map2(
       (docs) => docs.map((doc) => {
         const json = doc.toJSON();
@@ -955,6 +1040,15 @@ function createOrderManager(options) {
       })
     )
   );
+}
+
+// src/order/order-manager.ts
+function createOrderManager(options) {
+  const { taxContext, draftsCollection } = options;
+  const currency = options.currency.toUpperCase();
+  let activeBuilder = createOrderBuilder({ currency, taxContext });
+  const activeSubject = new BehaviorSubject2(activeBuilder);
+  const parkedOrders$ = parkedOrderSummaries$(draftsCollection);
   return {
     activeOrder$: activeSubject.asObservable(),
     parkedOrders$,
@@ -965,14 +1059,7 @@ function createOrderManager(options) {
     },
     async parkCurrentOrder() {
       const snapshot = activeBuilder.getSnapshot();
-      await draftsCollection.upsert({
-        id: snapshot.id,
-        data: JSON.stringify(snapshot),
-        customerName: snapshot.customer?.name ?? "",
-        itemCount: snapshot.lineItems.length,
-        total: snapshot.totalMinor,
-        parkedAt: (/* @__PURE__ */ new Date()).toISOString()
-      });
+      await writeOrderDraft(draftsCollection, snapshot);
       activeBuilder = createOrderBuilder({ currency, taxContext });
       activeSubject.next(activeBuilder);
       return snapshot.id;
@@ -982,54 +1069,7 @@ function createOrderManager(options) {
       if (!doc) throw new Error(`Parked order ${orderId} not found`);
       const json = doc.toJSON();
       const savedOrder = JSON.parse(json.data);
-      const builder = createOrderBuilder({
-        currency,
-        taxContext,
-        id: savedOrder.id
-      });
-      if (savedOrder.customer && !customerRefusal(savedOrder.customer)) {
-        builder.setCustomer(savedOrder.customer);
-      }
-      if (savedOrder.note) {
-        builder.setNote(savedOrder.note);
-      }
-      for (const line of savedOrder.lineItems) {
-        const lineId = builder.addLine({
-          productId: line.productId,
-          variantId: line.variantId,
-          name: line.name,
-          sku: line.sku,
-          imageUrl: line.imageUrl,
-          unitPrice: { amount: line.unitPriceMinor, currency, taxInclusive: line.taxInclusive },
-          quantity: line.quantity,
-          taxRates: line.taxLines.map(({ code, ratePpm }) => ({ code, ratePpm }))
-        });
-        for (const discount of line.discounts) {
-          builder.applyLineDiscount(lineId, {
-            type: discount.type,
-            value: discount.value,
-            label: discount.label,
-            couponCode: discount.couponCode
-          });
-        }
-      }
-      for (const discount of savedOrder.discounts) {
-        builder.applyOrderDiscount({
-          type: discount.type,
-          value: discount.value,
-          label: discount.label,
-          couponCode: discount.couponCode
-        });
-      }
-      for (const payment of savedOrder.payments) {
-        builder.addPayment({
-          method: payment.method,
-          amountMinor: payment.amountMinor,
-          tenderedMinor: payment.tenderedMinor,
-          changeMinor: payment.changeMinor,
-          reference: payment.reference
-        });
-      }
+      const builder = restoreOrderDraft(savedOrder, { currency, taxContext });
       await doc.remove();
       activeBuilder = builder;
       activeSubject.next(activeBuilder);
@@ -3540,7 +3580,7 @@ function useSale(settings, opts) {
     if (active) setError(SALE_SAVING);
     return active;
   }
-  function resetSale(customer) {
+  function resetSale(customer, restored) {
     if (inFlight.current && !pending.current) return setError(SALE_SAVING);
     if (pending.current && confirmed.current !== pending.current) {
       if (inFlight.current) checkStored(pending.current);
@@ -3553,7 +3593,7 @@ function useSale(settings, opts) {
     droppedReference.current = null;
     setSaving(false);
     madeWith.current = { taxContext, currency: settings.currency };
-    const next = createOrderBuilder({ currency: settings.currency, taxContext });
+    const next = restored ?? createOrderBuilder({ currency: settings.currency, taxContext });
     if (customer !== null) next.setCustomer(customer);
     builderNow.current = next;
     setBuilder(next);
@@ -3683,6 +3723,17 @@ function useSale(settings, opts) {
     setQuantity(lineId, quantity) {
       if (!locked()) builderNow.current.updateQuantity(lineId, quantity);
     },
+    /** Sets a line's unit price in minor units of its own tax mode, recomputing discounts and tax; returns a refusal or null. */
+    setUnitPrice(lineId, amountMinor) {
+      if (locked()) return SALE_SAVING;
+      try {
+        builderNow.current.setUnitPrice(lineId, amountMinor);
+        return null;
+      } catch (error2) {
+        if (error2 instanceof RangeError || error2 instanceof Error && error2.message === `Unknown line ${lineId}`) return error2.message;
+        throw error2;
+      }
+    },
     remove(lineId) {
       if (!locked()) builderNow.current.removeItem(lineId);
     },
@@ -3814,6 +3865,39 @@ function useSale(settings, opts) {
     newSale() {
       resetSale(null);
     },
+    /** Parks the cart in `drafts`; resolves to a refusal message, or null once parked. */
+    async park() {
+      if (locked()) return SALE_SAVING;
+      if (!opts.drafts) throw new Error("useSale: park() needs the drafts option");
+      if (stageNow.current.kind !== "cart") return "Finish or cancel the payment before parking the sale";
+      const builder = builderNow.current;
+      const snapshot = builder.getSnapshot();
+      if (!snapshot.lineItems.length) return "There is nothing to park";
+      await writeOrderDraft(opts.drafts, snapshot);
+      if (builderNow.current !== builder || builder.getSnapshot() !== snapshot) return "The sale changed while it was being parked; park it again";
+      resetSale(null);
+      return null;
+    },
+    /** Resumes a draft into an empty cart; resolves to a refusal message, or null once resumed. */
+    async resume(draftId) {
+      if (locked()) return SALE_SAVING;
+      if (!opts.drafts) throw new Error("useSale: resume() needs the drafts option");
+      const live = builderNow.current;
+      const liveSnapshot = live.getSnapshot();
+      if (stageNow.current.kind !== "cart" || liveSnapshot.lineItems.length) return "Park or clear the current sale first";
+      const doc = await opts.drafts.findOne(draftId).exec();
+      if (!doc) return "That parked sale is no longer there";
+      const saved = JSON.parse(doc.toJSON().data);
+      if (saved.currency.toUpperCase() !== settings.currency.toUpperCase()) return "That parked sale is in another currency";
+      const builder = restoreOrderDraft(saved, { currency: settings.currency, taxContext });
+      await doc.remove();
+      if (builderNow.current !== live || live.getSnapshot() !== liveSnapshot) {
+        await writeOrderDraft(opts.drafts, saved);
+        return "The sale changed while it was being resumed; resume it again";
+      }
+      resetSale(null, builder);
+      return null;
+    },
     /**
      * Continue after a failed save whose order is confirmed stored (`canContinue`): exactly `newSale()`.
      * The order stays pending in the outbox, which will send it; it isn't handed to `onSaleCompleted` again, and
@@ -3828,8 +3912,17 @@ function useSale(settings, opts) {
 
 // src/sale/catalogue.ts
 import { findVariantByCode, formatMoney as formatMoney2, resolvePrice as resolvePrice3 } from "@tallyui/core";
-function catalogueEntries(products, traits) {
-  return products.flatMap((product) => traits.getVariants(product).map((variant) => ({ product, variant })));
+function catalogueEntries(products, traits, context) {
+  return products.flatMap((product) => {
+    const variants = traits.getVariants ? traits.getVariants(product, context) : traits.hasVariants(product) ? [] : [{
+      id: traits.getId(product),
+      sku: traits.getSku(product),
+      barcode: traits.getBarcode(product),
+      prices: traits.getPrices(product, context),
+      stock: traits.getStock(product)
+    }];
+    return variants.map((variant) => ({ product, variant }));
+  });
 }
 function findEntryByCode(entries, code) {
   const variant = findVariantByCode(entries.map((entry) => entry.variant), code);
@@ -5077,8 +5170,10 @@ export {
   observeRegister$,
   openSession,
   openSessionSelector,
+  orderDraftSchema,
   outboxLogger,
   overThreshold,
+  parkedOrderSummaries$,
   parseMinor,
   planLegs,
   posOrderCollection,
@@ -5100,6 +5195,7 @@ export {
   registerSessionSchema,
   requireOpenSession,
   resolveStoreSettings,
+  restoreOrderDraft,
   roundMicrosToMinor,
   saleLogger,
   sameSale,
@@ -5135,5 +5231,6 @@ export {
   watchFresh,
   withPricingContext,
   withStockOverlay,
-  writeClosure
+  writeClosure,
+  writeOrderDraft
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tallyui/pos",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "type": "module",
   "description": "Shared POS business logic for Tally UI — tax, orders, payments, discounts, receipts",
   "main": "./dist/index.js",
@@ -27,20 +27,20 @@
     "directory": "packages/pos"
   },
   "peerDependencies": {
-    "@tallyui/core": "^3.0.1",
+    "@tallyui/core": "^3.0.3",
     "react": ">=18",
     "rxdb": "~17.5.0",
     "rxjs": ">=7"
   },
   "devDependencies": {
-    "@tallyui/core": "3.0.1",
+    "@tallyui/core": "3.0.3",
     "@types/react": ">=18",
     "react": "^19.2.4",
     "rxdb": "17.5.0",
     "rxjs": "7.8.2",
-    "@tallyui/connector-medusa": "3.0.1",
-    "@tallyui/connector-woocommerce": "3.0.1",
-    "@tallyui/database": "3.0.1"
+    "@tallyui/connector-medusa": "3.0.3",
+    "@tallyui/connector-woocommerce": "3.0.3",
+    "@tallyui/database": "3.0.3"
   },
   "scripts": {
     "build": "tsup",

package/src/index.ts

@@ -26,6 +26,7 @@ export type { Repository } from './repository';
 
 // Order
 export { createOrderBuilder, createOrderManager, allocateOrderDiscount, taxFiguresForBasket } from './order';
+export { orderDraftSchema, writeOrderDraft, restoreOrderDraft, parkedOrderSummaries$ } from './order';
 export type { BasketLine } from './order';
 export type { OrderBuilder, OrderBuilderOptions } from './order';
 export type { OrderManager, OrderManagerOptions, ParkedOrderSummary } from './order';

package/src/order/index.ts

@@ -4,6 +4,7 @@ export type { BasketLine } from './tax-figures';
 export { allocateOrderDiscount } from './allocate-order-discount';
 export type { OrderBuilder, OrderBuilderOptions } from './order-builder';
 export { createOrderManager } from './order-manager';
+export { orderDraftSchema, writeOrderDraft, restoreOrderDraft, parkedOrderSummaries$ } from './order-drafts';
 export type { OrderManager, OrderManagerOptions, ParkedOrderSummary } from './order-manager';
 export type {
   Order,

package/src/order/order-builder.ts

@@ -71,6 +71,8 @@ export interface OrderBuilder {
   addProduct(doc: any, traits: ProductTraits, options?: { variantId?: string; quantity?: number }): string;
   addLine(input: AddLineInput): string;
   updateQuantity(lineId: string, quantity: number): void;
+  /** Sets a line's unit price (a till price edit), in minor units of the order's currency and the line's own tax mode; its discounts and tax are recomputed. */
+  setUnitPrice(lineId: string, amountMinor: number): void;
   removeItem(lineId: string): void;
   applyLineDiscount(lineId: string, discount: Discount): void;
   applyOrderDiscount(discount: Discount): void;
@@ -355,6 +357,16 @@ export function createOrderBuilder(options: OrderBuilderOptions): OrderBuilder {
       emit();
     },
 
+    setUnitPrice(lineId, amountMinor) {
+      if (!Number.isInteger(amountMinor)) throw new RangeError('Price must be integer minor units');
+      if (amountMinor < 0) throw new RangeError('Price must be >= 0');
+      if (!lineItems.some((li) => li.id === lineId)) throw new Error(`Unknown line ${lineId}`);
+      lineItems = lineItems.map((li) =>
+        li.id === lineId ? recalculateLine({ ...li, unitPriceMinor: amountMinor }) : li,
+      );
+      emit();
+    },
+
     removeItem(lineId) {
       lineItems = lineItems.filter((li) => li.id !== lineId);
       emit();

package/src/order/order-drafts.ts

@@ -0,0 +1,125 @@
+import { map, type Observable } from 'rxjs';
+import type { RxCollection, RxJsonSchema } from 'rxdb';
+import type { TaxContext } from '../tax/types';
+import { customerRefusal } from '../pos-order/command';
+import { createOrderBuilder, type OrderBuilder } from './order-builder';
+import type { Order } from './types';
+
+/** Apps create their drafts collection with this schema. */
+export const orderDraftSchema: RxJsonSchema<{
+  id: string; data: string; customerName?: string; itemCount?: number; total?: number; parkedAt?: string;
+}> = {
+  version: 0,
+  primaryKey: 'id',
+  type: 'object',
+  properties: {
+    id: { type: 'string', maxLength: 100 },
+    data: { type: 'string' },
+    customerName: { type: 'string' },
+    itemCount: { type: 'integer', minimum: 0, maximum: 2147483647, multipleOf: 1 },
+    total: { type: 'number' },
+    parkedAt: { type: 'string' },
+  },
+  required: ['id', 'data'],
+};
+
+export interface ParkedOrderSummary {
+  id: string;
+  customerName?: string;
+  itemCount: number;
+  totalMinor: number;
+  parkedAt: string;
+  source: 'local' | 'server';
+}
+
+export async function writeOrderDraft(drafts: RxCollection, snapshot: Order): Promise<string> {
+  await drafts.upsert({
+    id: snapshot.id,
+    data: JSON.stringify(snapshot),
+    customerName: snapshot.customer?.name ?? '',
+    itemCount: snapshot.lineItems.length,
+    total: snapshot.totalMinor,
+    parkedAt: new Date().toISOString(),
+  });
+  return snapshot.id;
+}
+
+export function restoreOrderDraft(saved: Order, options: { currency: string; taxContext: TaxContext }): OrderBuilder {
+  const { currency, taxContext } = options;
+  const builder = createOrderBuilder({
+    currency,
+    taxContext,
+    id: saved.id,
+  });
+
+  // Restore state from saved order
+  // A customer whose email or id order.create would refuse (see useSale's setCustomer) isn't restored.
+  if (saved.customer && !customerRefusal(saved.customer)) {
+    builder.setCustomer(saved.customer);
+  }
+  if (saved.note) {
+    builder.setNote(saved.note);
+  }
+
+  // Restore line items and their discounts
+  for (const line of saved.lineItems) {
+    const lineId = builder.addLine({
+      productId: line.productId,
+      variantId: line.variantId,
+      name: line.name,
+      sku: line.sku,
+      imageUrl: line.imageUrl,
+      unitPrice: { amount: line.unitPriceMinor, currency, taxInclusive: line.taxInclusive },
+      quantity: line.quantity,
+      taxRates: line.taxLines.map(({ code, ratePpm }) => ({ code, ratePpm })),
+    });
+    for (const discount of line.discounts) {
+      builder.applyLineDiscount(lineId, {
+        type: discount.type,
+        value: discount.value,
+        label: discount.label,
+        couponCode: discount.couponCode,
+      });
+    }
+  }
+
+  // Restore order-level discounts
+  for (const discount of saved.discounts) {
+    builder.applyOrderDiscount({
+      type: discount.type,
+      value: discount.value,
+      label: discount.label,
+      couponCode: discount.couponCode,
+    });
+  }
+
+  // Restore payments
+  for (const payment of saved.payments) {
+    builder.addPayment({
+      method: payment.method,
+      amountMinor: payment.amountMinor,
+      tenderedMinor: payment.tenderedMinor,
+      changeMinor: payment.changeMinor,
+      reference: payment.reference,
+    });
+  }
+  return builder;
+}
+
+export function parkedOrderSummaries$(drafts: RxCollection): Observable<ParkedOrderSummary[]> {
+  return drafts.find().$.pipe(
+    map((docs) =>
+      docs.map((doc) => {
+        const json = doc.toJSON() as any;
+        return {
+          id: json.id,
+          customerName: json.customerName || undefined,
+          itemCount: json.itemCount ?? 0,
+          totalMinor: json.total ?? 0,
+          parkedAt: json.parkedAt ?? '',
+          source: 'local' as const,
+        };
+      }),
+    ),
+  );
+}

package/src/order/order-manager.ts

@@ -1,18 +1,11 @@
-import { BehaviorSubject, map, type Observable } from 'rxjs';
+import { BehaviorSubject, type Observable } from 'rxjs';
 import type { RxCollection } from 'rxdb';
 import type { TaxContext } from '../tax/types';
-import { customerRefusal } from '../pos-order/command';
 import { createOrderBuilder, type OrderBuilder } from './order-builder';
 import type { Order } from './types';
+import { writeOrderDraft, restoreOrderDraft, parkedOrderSummaries$, type ParkedOrderSummary } from './order-drafts';
 
-export interface ParkedOrderSummary {
-  id: string;
-  customerName?: string;
-  itemCount: number;
-  totalMinor: number;
-  parkedAt: string;
-  source: 'local' | 'server';
-}
+export type { ParkedOrderSummary } from './order-drafts';
 
 export interface OrderManagerOptions {
   currency: string;
@@ -36,21 +29,7 @@ export function createOrderManager(options: OrderManagerOptions): OrderManager {
   let activeBuilder = createOrderBuilder({ currency, taxContext });
   const activeSubject = new BehaviorSubject<OrderBuilder>(activeBuilder);
 
-  const parkedOrders$: Observable<ParkedOrderSummary[]> = draftsCollection.find().$.pipe(
-    map((docs) =>
-      docs.map((doc) => {
-        const json = doc.toJSON() as any;
-        return {
-          id: json.id,
-          customerName: json.customerName || undefined,
-          itemCount: json.itemCount ?? 0,
-          totalMinor: json.total ?? 0,
-          parkedAt: json.parkedAt ?? '',
-          source: 'local' as const,
-        };
-      }),
-    ),
-  );
+  const parkedOrders$ = parkedOrderSummaries$(draftsCollection);
 
   return {
     activeOrder$: activeSubject.asObservable(),
@@ -64,14 +43,7 @@ export function createOrderManager(options: OrderManagerOptions): OrderManager {
 
     async parkCurrentOrder() {
       const snapshot = activeBuilder.getSnapshot();
-      await draftsCollection.upsert({
-        id: snapshot.id,
-        data: JSON.stringify(snapshot),
-        customerName: snapshot.customer?.name ?? '',
-        itemCount: snapshot.lineItems.length,
-        total: snapshot.totalMinor,
-        parkedAt: new Date().toISOString(),
-      });
+      await writeOrderDraft(draftsCollection, snapshot);
 
       activeBuilder = createOrderBuilder({ currency, taxContext });
       activeSubject.next(activeBuilder);
@@ -85,63 +57,7 @@ export function createOrderManager(options: OrderManagerOptions): OrderManager {
       const json = doc.toJSON() as any;
       const savedOrder: Order = JSON.parse(json.data);
 
-      const builder = createOrderBuilder({
-        currency,
-        taxContext,
-        id: savedOrder.id,
-      });
-
-      // Restore state from saved order
-      // A customer whose email or id order.create would refuse (see useSale's setCustomer) isn't restored.
-      if (savedOrder.customer && !customerRefusal(savedOrder.customer)) {
-        builder.setCustomer(savedOrder.customer);
-      }
-      if (savedOrder.note) {
-        builder.setNote(savedOrder.note);
-      }
-
-      // Restore line items and their discounts
-      for (const line of savedOrder.lineItems) {
-        const lineId = builder.addLine({
-          productId: line.productId,
-          variantId: line.variantId,
-          name: line.name,
-          sku: line.sku,
-          imageUrl: line.imageUrl,
-          unitPrice: { amount: line.unitPriceMinor, currency, taxInclusive: line.taxInclusive },
-          quantity: line.quantity,
-          taxRates: line.taxLines.map(({ code, ratePpm }) => ({ code, ratePpm })),
-        });
-        for (const discount of line.discounts) {
-          builder.applyLineDiscount(lineId, {
-            type: discount.type,
-            value: discount.value,
-            label: discount.label,
-            couponCode: discount.couponCode,
-          });
-        }
-      }
-
-      // Restore order-level discounts
-      for (const discount of savedOrder.discounts) {
-        builder.applyOrderDiscount({
-          type: discount.type,
-          value: discount.value,
-          label: discount.label,
-          couponCode: discount.couponCode,
-        });
-      }
-
-      // Restore payments
-      for (const payment of savedOrder.payments) {
-        builder.addPayment({
-          method: payment.method,
-          amountMinor: payment.amountMinor,
-          tenderedMinor: payment.tenderedMinor,
-          changeMinor: payment.changeMinor,
-          reference: payment.reference,
-        });
-      }
+      const builder = restoreOrderDraft(savedOrder, { currency, taxContext });
 
       await doc.remove();
 

package/src/sale/catalogue.ts

@@ -1,11 +1,19 @@
 import { findVariantByCode, formatMoney, resolvePrice } from '@tallyui/core';
-import type { ProductTraits, VariantSummary } from '@tallyui/core';
+import type { ProductTraits, TraitContext, VariantSummary } from '@tallyui/core';
 
 export type CatalogueEntry<Doc> = { product: Doc; variant: VariantSummary };
 
-/** Every variant of every product, in product order then variant order. */
-export function catalogueEntries<Doc>(products: Doc[], traits: ProductTraits<Doc>): CatalogueEntry<Doc>[] {
-  return products.flatMap((product) => traits.getVariants!(product).map((variant) => ({ product, variant })));
+/** Variants in product/variant order, passing context through; without getVariants,
+ * simple products use their own traits and products with variants contribute no entries. */
+export function catalogueEntries<Doc>(products: Doc[], traits: ProductTraits<Doc>, context?: TraitContext): CatalogueEntry<Doc>[] {
+  return products.flatMap((product) => {
+    const variants = traits.getVariants ? traits.getVariants(product, context)
+      : traits.hasVariants(product) ? [] : [{
+        id: traits.getId(product), sku: traits.getSku(product), barcode: traits.getBarcode(product),
+        prices: traits.getPrices(product, context), stock: traits.getStock(product),
+      }];
+    return variants.map((variant) => ({ product, variant }));
+  });
 }
 
 /** Barcode-then-SKU lookup across all products. */

package/src/sale/use-sale.ts

@@ -1,6 +1,7 @@
 import { useEffect, useLayoutEffect, useRef, useState } from 'react';
+import type { RxCollection } from 'rxdb';
 import type { ProductTraits, ServerCapabilities, StoreSettings } from '@tallyui/core';
-import { createOrderBuilder, type CustomerSummary, type Discount, type Order, type SentOrder } from '../order';
+import { createOrderBuilder, writeOrderDraft, restoreOrderDraft, type OrderBuilder, type CustomerSummary, type Discount, type Order, type SentOrder } from '../order';
 import { finalizeOrder, type PosOrder } from '../pos-order';
 import { MESSAGE_NAME_MAX, referenceError, referenceReason, withSentForm } from '../pos-order/finalize';
 import { CUSTOMER_REFUSALS, customerRefusal, cutText, PAYLOAD_STRING_MAX } from '../pos-order/command';
@@ -30,6 +31,8 @@ export const HUNG_SAVE_CHECK_MS = 5000;
 /** Call under a `TaxProvider`: its tax context and the settings' currency price every sale. */
 export function useSale(settings: Pick<StoreSettings, 'currency'>, opts: {
   registerId: string; cashierRef: string; capabilities?: ServerCapabilities;
+  /** Where `park()` keeps parked carts; create it with `orderDraftSchema` */
+  drafts?: RxCollection;
   /**
    * When set, `complete()` stamps the finalized order with this session before `onSaleCompleted`.
    * `complete()` runs after the money is taken, so a refused stamp (the session closed or went
@@ -103,7 +106,7 @@ export function useSale(settings: Pick<StoreSettings, 'currency'>, opts: {
     return active;
   }
   // newSale()'s body (see its doc comment for the guards): `newSale()` is `resetSale(null)`.
-  function resetSale(customer: CustomerSummary | null) {
+  function resetSale(customer: CustomerSummary | null, restored?: OrderBuilder) {
     if (inFlight.current && !pending.current) return setError(SALE_SAVING);
     if (pending.current && confirmed.current !== pending.current) {
       if (inFlight.current) checkStored(pending.current);
@@ -115,7 +118,7 @@ export function useSale(settings: Pick<StoreSettings, 'currency'>, opts: {
     droppedReference.current = null;
     setSaving(false);
     madeWith.current = { taxContext, currency: settings.currency };
-    const next = createOrderBuilder({ currency: settings.currency, taxContext });
+    const next = restored ?? createOrderBuilder({ currency: settings.currency, taxContext });
     if (customer !== null) next.setCustomer(customer);
     builderNow.current = next;
     setBuilder(next);
@@ -258,6 +261,17 @@ export function useSale(settings: Pick<StoreSettings, 'currency'>, opts: {
       }
     },
     setQuantity(lineId: string, quantity: number) { if (!locked()) builderNow.current.updateQuantity(lineId, quantity); },
+    /** Sets a line's unit price in minor units of its own tax mode, recomputing discounts and tax; returns a refusal or null. */
+    setUnitPrice(lineId: string, amountMinor: number): string | null {
+      if (locked()) return SALE_SAVING;
+      try {
+        builderNow.current.setUnitPrice(lineId, amountMinor);
+        return null;
+      } catch (error) {
+        if (error instanceof RangeError || (error instanceof Error && error.message === `Unknown line ${lineId}`)) return error.message;
+        throw error;
+      }
+    },
     remove(lineId: string) { if (!locked()) builderNow.current.removeItem(lineId); },
     /** A line's discount, or the order's without a line; returns the refusal to show, or null once applied. */
     applyDiscount(lineId: string | null, discount: Discount): string | null {
@@ -381,6 +395,39 @@ export function useSale(settings: Pick<StoreSettings, 'currency'>, opts: {
      * updates or requeues `pos_orders` itself.
      */
     newSale() { resetSale(null); },
+    /** Parks the cart in `drafts`; resolves to a refusal message, or null once parked. */
+    async park(): Promise<string | null> {
+      if (locked()) return SALE_SAVING;
+      if (!opts.drafts) throw new Error('useSale: park() needs the drafts option');
+      if (stageNow.current.kind !== 'cart') return 'Finish or cancel the payment before parking the sale';
+      const builder = builderNow.current;
+      const snapshot = builder.getSnapshot();
+      if (!snapshot.lineItems.length) return 'There is nothing to park';
+      await writeOrderDraft(opts.drafts, snapshot);
+      if (builderNow.current !== builder || builder.getSnapshot() !== snapshot) return 'The sale changed while it was being parked; park it again';
+      resetSale(null);
+      return null;
+    },
+    /** Resumes a draft into an empty cart; resolves to a refusal message, or null once resumed. */
+    async resume(draftId: string): Promise<string | null> {
+      if (locked()) return SALE_SAVING;
+      if (!opts.drafts) throw new Error('useSale: resume() needs the drafts option');
+      const live = builderNow.current;
+      const liveSnapshot = live.getSnapshot();
+      if (stageNow.current.kind !== 'cart' || liveSnapshot.lineItems.length) return 'Park or clear the current sale first';
+      const doc = await opts.drafts.findOne(draftId).exec();
+      if (!doc) return 'That parked sale is no longer there';
+      const saved: Order = JSON.parse(doc.toJSON().data);
+      if (saved.currency.toUpperCase() !== settings.currency.toUpperCase()) return 'That parked sale is in another currency';
+      const builder = restoreOrderDraft(saved, { currency: settings.currency, taxContext });
+      await doc.remove();
+      if (builderNow.current !== live || live.getSnapshot() !== liveSnapshot) {
+        await writeOrderDraft(opts.drafts, saved);
+        return 'The sale changed while it was being resumed; resume it again';
+      }
+      resetSale(null, builder);
+      return null;
+    },
     /**
      * Continue after a failed save whose order is confirmed stored (`canContinue`): exactly `newSale()`.
      * The order stays pending in the outbox, which will send it; it isn't handed to `onSaleCompleted` again, and