@tallyui/pos 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,262 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { MangoQuery, RxCollection } from 'rxdb';
+import { Observable } from 'rxjs';
+import { ProductTraits } from '@tallyui/core';
+
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+interface LogEntry {
+    level: LogLevel;
+    scope: string;
+    message: string;
+    data?: Record<string, unknown>;
+    timestamp: number;
+}
+interface LogSink {
+    id: string;
+    levels: LogLevel[];
+    scopes?: string[];
+    write(entry: LogEntry): void;
+}
+interface Logger {
+    debug(message: string, data?: Record<string, unknown>): void;
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+    createScope(name: string): Logger;
+    addSink(sink: LogSink): void;
+    removeSink(sinkId: string): void;
+}
+
+declare function createLogger(scope?: string): Logger;
+
+interface ConsoleSinkOptions {
+    id?: string;
+    levels: LogLevel[];
+    scopes?: string[];
+}
+declare function consoleSink(options: ConsoleSinkOptions): LogSink;
+interface CallbackSinkOptions {
+    id: string;
+    levels: LogLevel[];
+    scopes?: string[];
+    callback: (entry: LogEntry) => void;
+}
+declare function callbackSink(options: CallbackSinkOptions): LogSink;
+
+declare function formatCurrency(amount: number, currencyCode: string, locale?: string): string;
+
+interface CurrencyProviderProps {
+    currencyCode: string;
+    locale?: string;
+    children: ReactNode;
+}
+declare function CurrencyProvider({ currencyCode, locale, children }: CurrencyProviderProps): react_jsx_runtime.JSX.Element;
+declare function useCurrencyFormatter(): (amount: number) => string;
+
+interface TaxResult {
+    priceExclTax: number;
+    priceInclTax: number;
+    taxAmount: number;
+}
+type TaxRateMap = {
+    default: number;
+    [taxClass: string]: number;
+};
+interface TaxContext {
+    getTaxRate(taxClass?: string): number;
+    pricesIncludeTax: boolean;
+}
+
+declare function addTax(priceExclTax: number, rate: number): number;
+declare function extractTax(priceInclTax: number, rate: number): number;
+declare function calculateTax(price: number, rate: number, pricesIncludeTax: boolean): TaxResult;
+
+interface TaxProviderProps {
+    rates: Record<string, number>;
+    pricesIncludeTax: boolean;
+    children: ReactNode;
+}
+declare function TaxProvider({ rates, pricesIncludeTax, children }: TaxProviderProps): react_jsx_runtime.JSX.Element;
+declare function useTax(): TaxContext;
+
+interface Repository<T> {
+    findById$(id: string): Observable<T | null>;
+    findAll$(query?: MangoQuery<T>): Observable<T[]>;
+    search$(term: string, fields: (keyof T)[]): Observable<T[]>;
+    count$(): Observable<number>;
+    create(data: Partial<T>): Promise<T>;
+    update(id: string, patch: Partial<T>): Promise<T>;
+    remove(id: string): Promise<void>;
+    bulkCreate(items: Partial<T>[]): Promise<T[]>;
+    bulkRemove(ids: string[]): Promise<void>;
+}
+
+declare function createRepository<T extends {
+    id: string;
+}>(collection: RxCollection<T>): Repository<T>;
+
+interface Order {
+    id: string;
+    status: 'draft' | 'parked' | 'saved' | 'completed';
+    lineItems: LineItem[];
+    discounts: AppliedDiscount[];
+    payments: Payment[];
+    customer: CustomerSummary | null;
+    note: string;
+    subtotal: number;
+    discountTotal: number;
+    taxTotal: number;
+    total: number;
+    balanceDue: number;
+    changeDue: number;
+    currency: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface LineItem {
+    id: string;
+    productId: string;
+    variantId?: string;
+    name: string;
+    sku: string;
+    imageUrl?: string;
+    price: number;
+    quantity: number;
+    taxRate: number;
+    taxAmount: number;
+    discounts: AppliedDiscount[];
+    discountAmount: number;
+    lineTotal: number;
+}
+interface Discount {
+    type: 'percentage' | 'fixed';
+    value: number;
+    label?: string;
+    couponCode?: string;
+}
+interface AppliedDiscount extends Discount {
+    id: string;
+    amount: number;
+}
+interface Payment {
+    id: string;
+    method: string;
+    amount: number;
+    reference?: string;
+}
+interface CustomerSummary {
+    id: string;
+    name: string;
+    email?: string;
+}
+interface PaymentMethod {
+    id: string;
+    label: string;
+    icon?: string;
+    requiresReference?: boolean;
+}
+
+interface OrderBuilderOptions {
+    currency: string;
+    taxContext: TaxContext;
+    id?: string;
+}
+interface OrderBuilder {
+    order$: Observable<Order>;
+    addProduct(doc: any, traits: ProductTraits, options?: {
+        variantId?: string;
+        quantity?: number;
+    }): string;
+    updateQuantity(lineId: string, quantity: number): void;
+    removeItem(lineId: string): void;
+    applyLineDiscount(lineId: string, discount: Discount): void;
+    applyOrderDiscount(discount: Discount): void;
+    removeDiscount(discountId: string): void;
+    addPayment(payment: Omit<Payment, 'id'>): string;
+    removePayment(paymentId: string): void;
+    setCustomer(customer: CustomerSummary | null): void;
+    setNote(note: string): void;
+    clear(): void;
+    getSnapshot(): Order;
+}
+declare function createOrderBuilder(options: OrderBuilderOptions): OrderBuilder;
+
+interface ParkedOrderSummary {
+    id: string;
+    customerName?: string;
+    itemCount: number;
+    total: number;
+    parkedAt: string;
+    source: 'local' | 'server';
+}
+interface OrderManagerOptions {
+    currency: string;
+    taxContext: TaxContext;
+    draftsCollection: RxCollection;
+}
+interface OrderManager {
+    activeOrder$: Observable<OrderBuilder>;
+    parkedOrders$: Observable<ParkedOrderSummary[]>;
+    newOrder(): OrderBuilder;
+    parkCurrentOrder(): Promise<string>;
+    resumeOrder(orderId: string): Promise<OrderBuilder>;
+    deleteParkedOrder(orderId: string): Promise<void>;
+}
+declare function createOrderManager(options: OrderManagerOptions): OrderManager;
+
+interface ReceiptLineItem {
+    name: string;
+    sku: string;
+    quantity: number;
+    unitPrice: number;
+    lineTotal: number;
+}
+interface ReceiptData {
+    header: {
+        storeName: string;
+        storeAddress?: string;
+        orderNumber: string;
+        date: string;
+        cashier?: string;
+        register?: string;
+    };
+    lineItems: ReceiptLineItem[];
+    discounts: {
+        label: string;
+        amount: number;
+    }[];
+    totals: {
+        subtotal: number;
+        discountTotal: number;
+        taxLines: {
+            label: string;
+            rate: number;
+            amount: number;
+        }[];
+        taxTotal: number;
+        total: number;
+    };
+    payments: {
+        method: string;
+        amount: number;
+        reference?: string;
+    }[];
+    changeDue: number;
+    footer: {
+        note?: string;
+        barcode?: string;
+    };
+    currency: string;
+}
+interface ReceiptConfig {
+    storeName: string;
+    storeAddress?: string;
+    cashier?: string;
+    register?: string;
+    taxLabels?: Record<number, string>;
+}
+
+declare function buildReceiptData(order: Order, config: ReceiptConfig): ReceiptData;
+
+export { type AppliedDiscount, CurrencyProvider, type CurrencyProviderProps, type CustomerSummary, type Discount, type LineItem, type LogEntry, type LogLevel, type LogSink, type Logger, type Order, type OrderBuilder, type OrderBuilderOptions, type OrderManager, type OrderManagerOptions, type ParkedOrderSummary, type Payment, type PaymentMethod, type ReceiptConfig, type ReceiptData, type ReceiptLineItem, type Repository, type TaxContext, TaxProvider, type TaxProviderProps, type TaxRateMap, type TaxResult, addTax, buildReceiptData, calculateTax, callbackSink, consoleSink, createLogger, createOrderBuilder, createOrderManager, createRepository, extractTax, formatCurrency, useCurrencyFormatter, useTax };