@tallyui/pos 3.2.0 → 3.3.0

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, TraitContext, CommandResult, AnyCommandEnvelope, CommandEnvelope, OrderCreatePayload, RegisterCommandEnvelope } from '@tallyui/core';
+import { Money, TaxRounding, StoreSettings, TallyConnector, SyncContext, StoreSettingsChoice, StoreSettingsChoices, ProductTraits, OrderCreateLine, 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';
@@ -97,6 +97,7 @@ interface RateTaxLine {
 }
 type TaxedLine = {
     netMinor: number;
+    netMicros?: string;
     discountMinor?: number;
     taxInclusive: boolean;
     taxLines: readonly {
@@ -117,12 +118,16 @@ type TaxedLine = {
  */
 declare function taxLinesByRate(lines: readonly TaxedLine[], orderTaxMinor: number, taxLabels?: Record<number, string>, rounding?: TaxRounding): RateTaxLine[];
 
+type WooRate = NonNullable<StoreSettings['taxRates']>[string][number];
 /** Tax rates as integer parts per million (19% = 190000). */
 type TaxRateMap = {
     default: number;
     [taxClass: string]: number;
 };
 interface TaxContext {
+    getTaxRates?(taxClass?: string, options?: {
+        shipping?: boolean;
+    }): readonly WooRate[];
     /** Tax rate for a tax class as integer parts per million (19% = 190000); the default class when omitted or unknown. */
     getTaxRatePpm(taxClass?: string): number;
     /** The backend's name for that class's rate, when mapped: a `per_rate_group_items` store groups by name and value (#287). */
@@ -133,7 +138,8 @@ interface TaxContext {
 }
 
 declare const taxLogger: Logger;
-interface TaxProviderProps {
+interface TaxProviderProps extends Pick<StoreSettings, 'taxRoundAtSubtotal' | 'shippingTaxClass' | 'taxClassSlugs'> {
+    taxRates?: StoreSettings['taxRates'];
     ratesPpm: Record<string, number>;
     pricesIncludeTax: boolean;
     /** `ServerCapabilities.taxRounding` (#287); a change restarts an idle sale under it. */
@@ -142,7 +148,7 @@ interface TaxProviderProps {
     rateCodes?: Record<string, string>;
     children: ReactNode;
 }
-declare function TaxProvider({ ratesPpm, pricesIncludeTax, rounding, rateCodes, children }: TaxProviderProps): react_jsx_runtime.JSX.Element;
+declare function TaxProvider({ ratesPpm, pricesIncludeTax, rounding, rateCodes, taxRates, children }: TaxProviderProps): react_jsx_runtime.JSX.Element;
 declare function useTax(): TaxContext;
 
 type StoreSettingsResolution = {
@@ -245,6 +251,8 @@ interface Order {
     id: string;
     status: 'draft' | 'parked' | 'saved' | 'completed';
     lineItems: LineItem[];
+    fees?: FeeLine[];
+    shipping?: ShippingLine[];
     discounts: AppliedDiscount[];
     payments: Payment[];
     customer: CustomerSummary | null;
@@ -281,6 +289,16 @@ interface DisplayTotals {
     taxMinor: number;
     totalMinor: number;
     lines: DisplayLine[];
+    fees?: Array<{
+        id: string;
+        name: string;
+        amountMinor: number;
+    }>;
+    shipping?: Array<{
+        id: string;
+        name: string;
+        amountMinor: number;
+    }>;
     orderDiscountMinor: number;
 }
 /** One line in the display mode (ADR-063): before any discount, with its own discounts as sub-rows. */
@@ -295,6 +313,12 @@ interface DisplayLine {
 }
 interface LineItem {
     id: string;
+    taxClass?: string;
+    /** WooCommerce's stored net at rounding precision, in integer micro-minor units, and its rounded gross. */
+    netMicros?: string;
+    totalMinor?: number;
+    custom?: true;
+    taxStatus?: 'none';
     productId: string;
     variantId?: string;
     name: string;
@@ -312,8 +336,33 @@ interface LineItem {
     /** Set only when the price's tax mode differs from the order's; named price mode → order mode. */
     priceTaxModeConverted?: 'inclusive-to-exclusive' | 'exclusive-to-inclusive';
 }
+interface ChargeLine {
+    id: string;
+    netMicros?: string;
+    totalMinor?: number;
+    name: string;
+    amountMinor: number;
+    taxClass?: string;
+    taxStatus: 'taxable' | 'none';
+    taxLines: LineItem['taxLines'];
+    netMinor: number;
+    taxMicros: string;
+}
+interface FeeLine extends ChargeLine {
+}
+interface ShippingLine extends ChargeLine {
+    methodId?: string;
+}
+interface ChargeInput {
+    name: string;
+    amountMinor: number;
+    taxClass?: string;
+    taxStatus?: 'taxable' | 'none';
+}
 interface LineTaxLine {
     code?: string;
+    rateId?: number;
+    compound?: boolean;
     ratePpm: number;
     taxMicros: string;
 }
@@ -348,6 +397,8 @@ interface PaymentMethod {
 }
 interface AddLineInput {
     productId: string;
+    custom?: true;
+    taxStatus?: 'taxable' | 'none';
     variantId?: string;
     name: string;
     sku?: string;
@@ -375,6 +426,16 @@ interface OrderBuilder {
         quantity?: number;
     }): string;
     addLine(input: AddLineInput): string;
+    addFee(input: ChargeInput): string;
+    updateFee(id: string, patch: Partial<ChargeInput>): void;
+    removeFee(id: string): void;
+    addShipping(input: ChargeInput & {
+        methodId?: string;
+    }): string;
+    updateShipping(id: string, patch: Partial<ChargeInput & {
+        methodId?: string;
+    }>): void;
+    removeShipping(id: string): void;
     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;
@@ -496,6 +557,14 @@ interface ReceiptData {
         register?: string;
     };
     lineItems: ReceiptLineItem[];
+    fees: Array<{
+        name: string;
+        amountMinor: number;
+    }>;
+    shipping: Array<{
+        name: string;
+        amountMinor: number;
+    }>;
     discounts: {
         label: string;
         amountMinor: number;
@@ -577,6 +646,8 @@ interface PosOrderLine {
     id: string;
     productId: string;
     variantId?: string;
+    custom?: OrderCreateLine['custom'];
+    taxStatus?: 'taxable' | 'none';
     name: string;
     sku: string;
     quantity: number;
@@ -584,6 +655,7 @@ interface PosOrderLine {
     /** Line discounts plus the allocated order-discount share, in the line's own tax mode (ADR-062). */
     discountMinor: number;
     netMinor: number;
+    netMicros?: string;
     taxLines: Array<{
         code?: string;
         ratePpm: number;
@@ -608,6 +680,8 @@ interface PosOrder {
     currency: string;
     pricesIncludeTax: boolean;
     lines: PosOrderLine[];
+    fees?: FeeLine[];
+    shipping?: ShippingLine[];
     subtotalMinor: number;
     discountMinor: number;
     taxMinor: number;
@@ -635,9 +709,9 @@ interface PosOrder {
      * The order.create version every attempt under this `commandId` goes out at: the outbox records it before the first
      * send, and lowers it only on a downgrade (ADR-065 amendment). Absent means not sent yet (or requeued).
      */
-    sentVersion?: 1 | 2 | 3 | 4;
+    sentVersion?: 1 | 2 | 3 | 4 | 5;
     /** The version first tried, before the downgrade (the order's audit). */
-    downgradedFrom?: 1 | 2 | 3 | 4;
+    downgradedFrom?: 1 | 2 | 3 | 4 | 5;
     /** ADR-065: the receipt's display figures, in integer minor units of `currency` at `exponent`. */
     display?: DisplayTotals & {
         currency: string;
@@ -721,6 +795,9 @@ declare function toOrderCreateEnvelope(order: PosOrder, deviceId: string, attemp
  * nothing else. Its migration sets it on every older row. It is one-way like version 5.
  * Version 7 adds `saleId`, the sale order's id (ADR-072; never sent), and changes nothing else. Its migration is the
  * identity: older orders have no `saleId`. It is one-way like version 6.
+ * Version 8 adds fees, shipping, custom lines (ADR-075) and the woocommerce tax rounding (ADR-076), and changes nothing else.
+ * It also stores the WooCommerce 6dp net (`netMicros`) under the woocommerce rounding (ADR-076 amendment).
+ * Its migration is the identity. It is one-way like version 7.
  */
 declare const posOrderSchema: RxJsonSchema<PosOrder>;
 /**
@@ -1886,6 +1963,37 @@ declare function useSale(settings: Pick<StoreSettings, 'currency'>, opts: {
     canContinue: boolean;
     add(entry: CatalogueEntry<any>, traits: ProductTraits<any>): void;
     setQuantity(lineId: string, quantity: number): void;
+    /** ADR-075: adds a fee; returns its id or the builder's refusal. */
+    addFee(input: ChargeInput): {
+        id: string;
+    } | string;
+    /** ADR-075: updates a fee; returns a refusal or null. */
+    updateFee(id: string, patch: Partial<ChargeInput>): string | null;
+    /** ADR-075: removes a fee; returns a refusal or null. */
+    removeFee(id: string): string | null;
+    /** ADR-075: adds shipping; returns its id or the builder's refusal. */
+    addShipping(input: ChargeInput & {
+        methodId?: string;
+    }): {
+        id: string;
+    } | string;
+    /** ADR-075: updates shipping; returns a refusal or null. */
+    updateShipping(id: string, patch: Partial<ChargeInput & {
+        methodId?: string;
+    }>): string | null;
+    /** ADR-075: removes shipping; returns a refusal or null. */
+    removeShipping(id: string): string | null;
+    /** ADR-075: adds a distinct custom product line; returns its id or the builder's refusal. */
+    addCustomLine(input: {
+        name: string;
+        priceMinor: number;
+        quantity?: number;
+        taxClass?: string;
+        taxStatus?: "taxable" | "none";
+        sku?: string;
+    }): {
+        id: string;
+    } | string;
     /** 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;
@@ -1967,6 +2075,13 @@ declare class CartError extends Error {
 }
 declare function addEntryToCart<Doc>(builder: OrderBuilder, entry: CatalogueEntry<Doc>, traits: ProductTraits<Doc>, currency: string): string;
 
+/** Local-only context for a transport (ADR-076 amendment 1): never serialised, never part of a payload. */
+interface OrderTransportContext {
+    /** The stored (frozen) order of each envelope in the batch, keyed by the envelope's `id` (its commandId). */
+    local: {
+        orders: ReadonlyMap<string, PosOrder>;
+    };
+}
 type TransportOutcome = {
     kind: 'results';
     results: CommandResult[];
@@ -1985,7 +2100,7 @@ type TransportOutcome = {
     retryAfterMs?: number;
 };
 interface CommandTransport<E extends AnyCommandEnvelope = CommandEnvelope<OrderCreatePayload>> {
-    send(batch: E[]): Promise<TransportOutcome>;
+    send(batch: E[], context?: OrderTransportContext): Promise<TransportOutcome>;
 }
 interface OutboxState {
     pending: number;
@@ -2329,4 +2444,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, 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, useParkedSales, useRegisterOutbox, useRegisterSession, useSale, useStoreSettings, useTax, uuidv7, validAmount, varianceText, variantPriceLabel, voidMovement, withPricingContext, writeClosure, writeOrderDraft };
+export { type Actor, type AddLineInput, type AppliedDiscount, type BackendNotFound, type BasketLine, CartError, type CashMovement, type CashMovementCollection, type CatalogueEntry, type ChargeInput, type ChargeLine, 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 FeeLine, 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 OrderTransportContext, 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 ShippingLine, 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, useParkedSales, useRegisterOutbox, useRegisterSession, useSale, useStoreSettings, useTax, uuidv7, validAmount, varianceText, variantPriceLabel, voidMovement, withPricingContext, writeClosure, writeOrderDraft };