@tallyui/pos 0.1.0 → 3.0.0-next.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tallyui/pos",
-  "version": "0.1.0",
+  "version": "3.0.0-next.0",
   "type": "module",
   "description": "Shared POS business logic for Tally UI — tax, orders, payments, discounts, receipts",
   "main": "./dist/index.js",
@@ -15,25 +15,36 @@
   },
   "files": [
     "dist",
-    "src"
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/*.test-helper.ts"
   ],
   "license": "MIT",
-  "scripts": {
-    "build": "tsup",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run"
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TallyUI/tallyui.git",
+    "directory": "packages/pos"
   },
   "peerDependencies": {
-    "@tallyui/core": "workspace:*",
+    "@tallyui/core": "^3.0.0-next.0",
     "react": ">=18",
-    "rxdb": ">=16",
+    "rxdb": "~17.5.0",
     "rxjs": ">=7"
   },
   "devDependencies": {
-    "@tallyui/core": "workspace:*",
+    "@tallyui/core": "3.0.0-next.0",
     "@types/react": ">=18",
     "react": "^19.2.4",
-    "rxdb": "16.21.1",
-    "rxjs": "7.8.2"
+    "rxdb": "17.5.0",
+    "rxjs": "7.8.2",
+    "@tallyui/connector-medusa": "3.0.0-next.0",
+    "@tallyui/connector-woocommerce": "3.0.0-next.0",
+    "@tallyui/database": "3.0.0-next.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
   }
-}
+}

package/src/currency/currency-provider.tsx

@@ -1,6 +1,6 @@
 import { createContext, useContext, useMemo, useCallback } from 'react';
 import type { ReactNode } from 'react';
-import { formatCurrency } from './format-currency';
+import { formatMoney, type Money } from '@tallyui/core';
 
 interface CurrencyContext {
   currencyCode: string;
@@ -20,13 +20,21 @@ export function CurrencyProvider({ currencyCode, locale, children }: CurrencyPro
   return <CurrencyCtx.Provider value={value}>{children}</CurrencyCtx.Provider>;
 }
 
-export function useCurrencyFormatter(): (amount: number) => string {
+export function useCurrencyFormatter(): (money: Money) => string {
   const ctx = useContext(CurrencyCtx);
   if (!ctx) {
     throw new Error('useCurrencyFormatter() must be used within a <CurrencyProvider>');
   }
   return useCallback(
-    (amount: number) => formatCurrency(amount, ctx.currencyCode, ctx.locale),
-    [ctx.currencyCode, ctx.locale],
+    (money: Money) => formatMoney(money, ctx.locale) ?? `${money.amount} ${money.currency}`,
+    [ctx.locale],
   );
 }
+
+export function useCurrencyCode(): string {
+  const ctx = useContext(CurrencyCtx);
+  if (!ctx) {
+    throw new Error('useCurrencyCode() must be used within a <CurrencyProvider>');
+  }
+  return ctx.currencyCode;
+}

package/src/currency/index.ts

@@ -1,3 +1,2 @@
-export { formatCurrency } from './format-currency';
-export { CurrencyProvider, useCurrencyFormatter } from './currency-provider';
+export { CurrencyProvider, useCurrencyFormatter, useCurrencyCode } from './currency-provider';
 export type { CurrencyProviderProps } from './currency-provider';

package/src/index.ts

@@ -3,27 +3,42 @@ export { createLogger, consoleSink, callbackSink } from './logging';
 export type { Logger, LogSink, LogEntry, LogLevel } from './logging';
 
 // Currency
-export { formatCurrency, CurrencyProvider, useCurrencyFormatter } from './currency';
+export { CurrencyProvider, useCurrencyFormatter, useCurrencyCode } from './currency';
 export type { CurrencyProviderProps } from './currency';
 
 // Tax
-export { calculateTax, extractTax, addTax, TaxProvider, useTax } from './tax';
+export { TaxProvider, useTax, taxLogger } from './tax';
+export { MICROS_PER_MINOR, ratePpmFromPercent, taxMicros, roundMicrosToMinor, computeOrderTax, taxLinesByRate } from './tax';
+export type { TaxLineInput, OrderTaxTotals, RateTaxLine } from './tax';
 export type { TaxProviderProps } from './tax';
-export type { TaxResult, TaxRateMap, TaxContext } from './tax';
+export type { TaxRateMap, TaxContext } from './tax';
+
+// Store settings
+export { resolveStoreSettings, useStoreSettings, withPricingContext, taxProviderProps } from './store-settings';
+export type { StoreSettingsResolution, ResolveStoreSettingsOptions, StoreSettingsState } from './store-settings';
+
+// RxDB reads past the query cache, and live lists that can't leave it stale (RxDB 16.21.1 bug 4)
+export { readFresh, countFresh, watchFresh } from './rxdb';
 
 // Repository
 export { createRepository } from './repository';
 export type { Repository } from './repository';
 
 // Order
-export { createOrderBuilder, createOrderManager } from './order';
+export { createOrderBuilder, createOrderManager, allocateOrderDiscount, taxFiguresForBasket } from './order';
+export type { BasketLine } from './order';
 export type { OrderBuilder, OrderBuilderOptions } from './order';
 export type { OrderManager, OrderManagerOptions, ParkedOrderSummary } from './order';
 export type {
   Order,
+  SentOrder,
   LineItem,
+  LineTaxLine,
+  AddLineInput,
   Discount,
   AppliedDiscount,
+  DisplayTotals,
+  DisplayLine,
   Payment,
   CustomerSummary,
   PaymentMethod,
@@ -32,3 +47,37 @@ export type {
 // Receipt
 export { buildReceiptData } from './receipt';
 export type { ReceiptData, ReceiptLineItem, ReceiptConfig } from './receipt';
+
+// Product
+export { searchProducts, withStockOverlay, getProductStock, stockOverlay$, stockOverlayAsOf$ } from './product';
+
+// Sale
+export { useSale, DISCOUNTS_UNSUPPORTED, SALE_SAVING, saleLogger, addEntryToCart, CartError, catalogueEntries, findEntryByCode, variantPriceLabel } from './sale';
+export type { SaleStage, CatalogueEntry } from './sale';
+
+export { uuidv7, finalizeOrder, toOrderCreateEnvelope, UnsupportedOrderVersionError, posOrderSchema, posOrderCollection, addPosOrderCollection, PosOrderOpenClosedError, posOrdersLogger, getDeviceId, needsAttention, sameSale, OrderContentMismatchError } from './pos-order';
+export type { PosOrderSyncStatus, PosOrderLine, PosOrderPayment, PosOrderLocalWarning, PosOrderServerFailures, PosOrder, FinalizeOptions } from './pos-order';
+export { createHttpCommandTransport, createOrderOutbox, useOrderOutbox, outboxLogger } from './outbox';
+export { createRegisterOutbox } from './outbox';
+export type { RegisterOutboxOptions, RegisterOutbox } from './outbox';
+export { createBackendNotFound } from './outbox/backend-not-found';
+export type { BackendNotFound } from './outbox/backend-not-found';
+export type { HttpTransportOptions, OrderOutboxOptions, OrderOutbox, TransportOutcome, CommandTransport, OutboxState, UseOrderOutboxOptions, UseOrderOutboxResult } from './outbox';
+export { tenderReducer, initTenderState, initialTenderState, appliedMinor, changeMinor, quickTenderedAmounts, evenSplitShareMinor, activePlan, planLegs, MAX_TENDER_MINOR } from './tender';
+export type { PaymentTransport, TenderView, TenderLineId, TenderPlan, SplitTab, TenderState, TenderKey, TenderAction, PlanLeg } from './tender';
+
+// Register
+export { normalizeAmount, isServerDecimal, movementFieldError, deriveExpected, parseMinor, validAmount, countVariance, overThreshold, closeNeedsApproval, denominationTotal, varianceText, denominations } from './register';
+export type { MovementType, LedgerRow, Movement } from './register';
+export { registerSessionSchema, registerSessionCollection, cashMovementSchema, closureSchema } from './register';
+export type { RegisterSession, CashMovement, Closure } from './register';
+export { registerCommandSchema, registerCommandCollection, registerCommandsLogger, sessionOpenCommand, sessionTransitionCommand, movementCommand, closureCommand, reconcileRegisterCommands } from './register';
+export type { RegisterCommand, RegisterCommandCollection } from './register';
+export { mintUuid, readRegister, ensureRegister, observeRegister$, getBoundRegisterId, readBoundRegister, bindRegister, unbindRegister, nextSaleCounter, mintClosureNumber, advancePerpetual, RegisterIdInvalidError } from './register';
+export type { RegisterHost, RegisterCounters, RegisterBucket, RegisterStore, RegisterDocument } from './register';
+export { RegisterSessionRequiredError, RegisterSessionClosedError, RegisterMovementAmountError, RegisterMovementReasonError, RegisterMovementStrandedError, openSessionSelector, requireOpenSession, stampSession, openSession, startCounting, backToSelling, closeSession, recordMovement, voidMovement, writeClosure } from './register';
+export type { RegisterSessionCollection, CashMovementCollection, ClosureCollection } from './register';
+export { deriveSettled, exportCsv, labelKeys, clampClosureScope, selectClosureRows } from './register';
+export type { Correction, RecordedFigures, ClosureScope } from './register';
+export { minorToDecimal, formatClosureDate, buildClosureDocument, buildXReportDocument, TAX_ROUNDING_MIXED_NOTE, registerFactsLogger, recordRegisterFact, type ClosureContext, type Actor, type RegisterFact } from './register';
+export { useRegisterSession, RegisterTenderInProgressError, RegisterSessionAlreadyOpenError, RegisterCloseIncompleteError, RegisterApprovalRequiredError, type UseRegisterSessionOptions } from './register';

package/src/order/allocate-order-discount.ts

@@ -0,0 +1,34 @@
+/**
+ * Splits an order discount across lines in proportion to each line's pre-order-discount amount,
+ * in its own tax mode (ADR-062), with largest-remainder rounding to the minor unit.
+ *
+ * - The shares sum exactly to `totalMinor`, and no share exceeds its line's amount.
+ * - Leftover units go to the largest remainders; ties go to the earlier line, so the result is deterministic.
+ * - A line with a zero or negative amount gets 0.
+ *
+ * Throws RangeError unless every input is a safe integer and 0 ≤ totalMinor ≤ Σ positive amounts.
+ */
+export function allocateOrderDiscount(lineAmountsMinor: readonly number[], totalMinor: number): number[] {
+  if (!Number.isSafeInteger(totalMinor) || totalMinor < 0 || !lineAmountsMinor.every(Number.isSafeInteger)) {
+    throw new RangeError('Amounts must be safe integers and the discount non-negative');
+  }
+  const weights = lineAmountsMinor.map((amount) => BigInt(Math.max(0, amount)));
+  const weightTotal = weights.reduce((sum, weight) => sum + weight, 0n);
+  const total = BigInt(totalMinor);
+  if (total > weightTotal) throw new RangeError('Order discount exceeds the lines it applies to');
+  if (total === 0n) return weights.map(() => 0);
+
+  // BigInt keeps total × weight exact however large the order is.
+  const shares = weights.map((weight) => (total * weight) / weightTotal);
+  const remainders = weights.map((weight) => (total * weight) % weightTotal);
+  let leftover = total - shares.reduce((sum, share) => sum + share, 0n);
+  const ranked = remainders.map((_, index) => index)
+    .sort((a, b) => remainders[a] === remainders[b] ? a - b : remainders[a] > remainders[b] ? -1 : 1);
+  // Each leftover unit goes to a line with a non-zero remainder, whose share is still below its amount.
+  for (const index of ranked) {
+    if (leftover === 0n) break;
+    shares[index] += 1n;
+    leftover -= 1n;
+  }
+  return shares.map(Number);
+}

package/src/order/index.ts

@@ -1,12 +1,20 @@
 export { createOrderBuilder } from './order-builder';
+export { taxFiguresForBasket } from './tax-figures';
+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 type { OrderManager, OrderManagerOptions, ParkedOrderSummary } from './order-manager';
 export type {
   Order,
+  SentOrder,
   LineItem,
+  LineTaxLine,
+  AddLineInput,
   Discount,
   AppliedDiscount,
+  DisplayTotals,
+  DisplayLine,
   Payment,
   CustomerSummary,
   PaymentMethod,