@tallyui/pos 0.1.0 → 3.0.0-next.0

package/src/order/order-builder.test.ts

@@ -1,246 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { firstValueFrom } from 'rxjs';
-import { createOrderBuilder } from './order-builder';
-import type { ProductTraits } from '@tallyui/core';
-import type { TaxContext } from '../tax/types';
-
-const traits: ProductTraits = {
-  getId: (doc) => doc.id,
-  getName: (doc) => doc.name,
-  getSku: (doc) => doc.sku ?? '',
-  getPrice: (doc) => String(doc.price),
-  getRegularPrice: (doc) => String(doc.price),
-  getSalePrice: () => undefined,
-  isOnSale: () => false,
-  getImageUrl: (doc) => doc.imageUrl,
-  getImageUrls: (doc) => doc.imageUrl ? [doc.imageUrl] : [],
-  getDescription: () => undefined,
-  getStockStatus: () => 'instock',
-  getStockQuantity: () => null,
-  hasVariants: () => false,
-  getType: () => 'simple',
-  getBarcode: () => undefined,
-  getCategoryNames: () => [],
-};
-
-const taxContext: TaxContext = {
-  getTaxRate: () => 0.1,
-  pricesIncludeTax: false,
-};
-
-const productDoc = { id: 'p1', name: 'Espresso', sku: 'ESP-001', price: 4.50 };
-const productDoc2 = { id: 'p2', name: 'Latte', sku: 'LAT-001', price: 5.00 };
-
-describe('OrderBuilder', () => {
-  it('starts with an empty draft order', async () => {
-    const builder = createOrderBuilder({ currency: 'USD', taxContext });
-    const order = await firstValueFrom(builder.order$);
-    expect(order.status).toBe('draft');
-    expect(order.lineItems).toHaveLength(0);
-    expect(order.subtotal).toBe(0);
-    expect(order.total).toBe(0);
-  });
-
-  it('adds a product as a line item', async () => {
-    const builder = createOrderBuilder({ currency: 'USD', taxContext });
-    builder.addProduct(productDoc, traits);
-
-    const order = await firstValueFrom(builder.order$);
-    expect(order.lineItems).toHaveLength(1);
-    expect(order.lineItems[0].name).toBe('Espresso');
-    expect(order.lineItems[0].price).toBe(4.50);
-    expect(order.lineItems[0].quantity).toBe(1);
-    expect(order.lineItems[0].taxRate).toBe(0.1);
-  });
-
-  it('increments quantity when adding same product twice', async () => {
-    const builder = createOrderBuilder({ currency: 'USD', taxContext });
-    builder.addProduct(productDoc, traits);
-    builder.addProduct(productDoc, traits);
-
-    const order = await firstValueFrom(builder.order$);
-    expect(order.lineItems).toHaveLength(1);
-    expect(order.lineItems[0].quantity).toBe(2);
-  });
-
-  it('treats different products as separate line items', async () => {
-    const builder = createOrderBuilder({ currency: 'USD', taxContext });
-    builder.addProduct(productDoc, traits);
-    builder.addProduct(productDoc2, traits);
-
-    const order = await firstValueFrom(builder.order$);
-    expect(order.lineItems).toHaveLength(2);
-  });
-
-  it('calculates line totals with tax (exclusive)', async () => {
-    const builder = createOrderBuilder({ currency: 'USD', taxContext });
-    builder.addProduct(productDoc, traits);
-
-    const order = await firstValueFrom(builder.order$);
-    const line = order.lineItems[0];
-    expect(line.taxAmount).toBeCloseTo(0.45);
-    expect(line.lineTotal).toBeCloseTo(4.95);
-  });
-
-  it('calculates order totals', async () => {
-    const builder = createOrderBuilder({ currency: 'USD', taxContext });
-    builder.addProduct(productDoc, traits);
-    builder.addProduct(productDoc2, traits);
-
-    const order = await firstValueFrom(builder.order$);
-    expect(order.subtotal).toBeCloseTo(9.50);
-    expect(order.taxTotal).toBeCloseTo(0.95);
-    expect(order.total).toBeCloseTo(10.45);
-    expect(order.balanceDue).toBeCloseTo(10.45);
-  });
-
-  it('updates line item quantity', async () => {
-    const builder = createOrderBuilder({ currency: 'USD', taxContext });
-    const lineId = builder.addProduct(productDoc, traits);
-    builder.updateQuantity(lineId, 3);
-
-    const order = await firstValueFrom(builder.order$);
-    expect(order.lineItems[0].quantity).toBe(3);
-    expect(order.subtotal).toBeCloseTo(13.50);
-  });
-
-  it('removes a line item', async () => {
-    const builder = createOrderBuilder({ currency: 'USD', taxContext });
-    const lineId = builder.addProduct(productDoc, traits);
-    builder.addProduct(productDoc2, traits);
-    builder.removeItem(lineId);
-
-    const order = await firstValueFrom(builder.order$);
-    expect(order.lineItems).toHaveLength(1);
-    expect(order.lineItems[0].name).toBe('Latte');
-  });
-
-  it('sets and clears customer', async () => {
-    const builder = createOrderBuilder({ currency: 'USD', taxContext });
-    builder.setCustomer({ id: 'c1', name: 'Alice', email: 'alice@example.com' });
-
-    let order = await firstValueFrom(builder.order$);
-    expect(order.customer?.name).toBe('Alice');
-
-    builder.setCustomer(null);
-    order = await firstValueFrom(builder.order$);
-    expect(order.customer).toBeNull();
-  });
-
-  it('sets note', async () => {
-    const builder = createOrderBuilder({ currency: 'USD', taxContext });
-    builder.setNote('Extra hot');
-
-    const order = await firstValueFrom(builder.order$);
-    expect(order.note).toBe('Extra hot');
-  });
-
-  it('clears the order', async () => {
-    const builder = createOrderBuilder({ currency: 'USD', taxContext });
-    builder.addProduct(productDoc, traits);
-    builder.setNote('Test');
-    builder.clear();
-
-    const order = await firstValueFrom(builder.order$);
-    expect(order.lineItems).toHaveLength(0);
-    expect(order.note).toBe('');
-    expect(order.subtotal).toBe(0);
-  });
-
-  it('handles tax-inclusive pricing', async () => {
-    const inclTax: TaxContext = { getTaxRate: () => 0.1, pricesIncludeTax: true };
-    const builder = createOrderBuilder({ currency: 'USD', taxContext: inclTax });
-    builder.addProduct(productDoc, traits);
-
-    const order = await firstValueFrom(builder.order$);
-    const line = order.lineItems[0];
-    expect(line.taxAmount).toBeCloseTo(0.41, 1);
-    expect(line.lineTotal).toBeCloseTo(4.50);
-    expect(order.subtotal).toBeCloseTo(4.09, 1);
-    expect(order.total).toBeCloseTo(4.50);
-  });
-
-  it('adds product with specific quantity', async () => {
-    const builder = createOrderBuilder({ currency: 'USD', taxContext });
-    builder.addProduct(productDoc, traits, { quantity: 5 });
-
-    const order = await firstValueFrom(builder.order$);
-    expect(order.lineItems[0].quantity).toBe(5);
-  });
-
-  it('removes line item when quantity set to 0', async () => {
-    const builder = createOrderBuilder({ currency: 'USD', taxContext });
-    const lineId = builder.addProduct(productDoc, traits);
-    builder.updateQuantity(lineId, 0);
-
-    const order = await firstValueFrom(builder.order$);
-    expect(order.lineItems).toHaveLength(0);
-    expect(order.subtotal).toBe(0);
-  });
-
-  it('removes line item when quantity set to negative', async () => {
-    const builder = createOrderBuilder({ currency: 'USD', taxContext });
-    const lineId = builder.addProduct(productDoc, traits);
-    builder.updateQuantity(lineId, -1);
-
-    const order = await firstValueFrom(builder.order$);
-    expect(order.lineItems).toHaveLength(0);
-  });
-
-  it('getSnapshot() matches order$ emission', async () => {
-    const builder = createOrderBuilder({ currency: 'USD', taxContext });
-    builder.addProduct(productDoc, traits);
-
-    const fromObservable = await firstValueFrom(builder.order$);
-    const fromSnapshot = builder.getSnapshot();
-    expect(fromSnapshot.id).toBe(fromObservable.id);
-    expect(fromSnapshot.lineItems).toEqual(fromObservable.lineItems);
-    expect(fromSnapshot.total).toBe(fromObservable.total);
-  });
-
-  it('clear() resets payments, customer, and discounts', async () => {
-    const builder = createOrderBuilder({ currency: 'USD', taxContext });
-    const lineId = builder.addProduct(productDoc, traits);
-    builder.setCustomer({ id: 'c1', name: 'Alice' });
-    builder.addPayment({ method: 'cash', amount: 5 });
-    builder.applyLineDiscount(lineId, { type: 'fixed', value: 1 });
-    builder.applyOrderDiscount({ type: 'percentage', value: 10 });
-    builder.clear();
-
-    const order = await firstValueFrom(builder.order$);
-    expect(order.lineItems).toHaveLength(0);
-    expect(order.payments).toHaveLength(0);
-    expect(order.discounts).toHaveLength(0);
-    expect(order.customer).toBeNull();
-    expect(order.note).toBe('');
-  });
-
-  it('handles product with undefined price gracefully', async () => {
-    const noPriceTraits = { ...traits, getPrice: () => undefined };
-    const builder = createOrderBuilder({ currency: 'USD', taxContext });
-    builder.addProduct({ id: 'p1', name: 'Free Item' }, noPriceTraits);
-
-    const order = await firstValueFrom(builder.order$);
-    expect(order.lineItems[0].price).toBe(0);
-    expect(order.total).toBe(0);
-  });
-
-  it('adds same product with different variantIds as separate lines', async () => {
-    const builder = createOrderBuilder({ currency: 'USD', taxContext });
-    builder.addProduct(productDoc, traits, { variantId: 'small' });
-    builder.addProduct(productDoc, traits, { variantId: 'large' });
-
-    const order = await firstValueFrom(builder.order$);
-    expect(order.lineItems).toHaveLength(2);
-  });
-
-  it('merges same product+variant on second add', async () => {
-    const builder = createOrderBuilder({ currency: 'USD', taxContext });
-    builder.addProduct(productDoc, traits, { variantId: 'small' });
-    builder.addProduct(productDoc, traits, { variantId: 'small' });
-
-    const order = await firstValueFrom(builder.order$);
-    expect(order.lineItems).toHaveLength(1);
-    expect(order.lineItems[0].quantity).toBe(2);
-  });
-});

package/src/order/order-manager.test.ts

@@ -1,209 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from 'vitest';
-import { firstValueFrom } from 'rxjs';
-import { createRxDatabase, addRxPlugin, type RxDatabase } from 'rxdb';
-import { RxDBDevModePlugin } from 'rxdb/plugins/dev-mode';
-import { getRxStorageMemory } from 'rxdb/plugins/storage-memory';
-import { wrappedValidateAjvStorage } from 'rxdb/plugins/validate-ajv';
-import { createOrderManager } from './order-manager';
-import type { ProductTraits } from '@tallyui/core';
-import type { TaxContext } from '../tax/types';
-
-addRxPlugin(RxDBDevModePlugin);
-
-const storage = wrappedValidateAjvStorage({ storage: getRxStorageMemory() });
-
-const traits: ProductTraits = {
-  getId: (doc) => doc.id,
-  getName: (doc) => doc.name,
-  getSku: () => '',
-  getPrice: (doc) => String(doc.price),
-  getRegularPrice: (doc) => String(doc.price),
-  getSalePrice: () => undefined,
-  isOnSale: () => false,
-  getImageUrl: () => undefined,
-  getImageUrls: () => [],
-  getDescription: () => undefined,
-  getStockStatus: () => 'instock',
-  getStockQuantity: () => null,
-  hasVariants: () => false,
-  getType: () => 'simple',
-  getBarcode: () => undefined,
-  getCategoryNames: () => [],
-};
-
-const taxContext: TaxContext = { getTaxRate: () => 0, pricesIncludeTax: false };
-const product = { id: 'p1', name: 'Coffee', price: 5 };
-
-const draftsSchema = {
-  version: 0,
-  primaryKey: 'id',
-  type: 'object' as const,
-  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'] as const,
-};
-
-describe('OrderManager', () => {
-  let db: RxDatabase;
-
-  beforeEach(async () => {
-    db = await createRxDatabase({
-      name: `test_mgr_${Date.now()}`,
-      storage,
-      multiInstance: false,
-      ignoreDuplicate: true,
-    });
-    await db.addCollections({ pos_drafts: { schema: draftsSchema } });
-  });
-
-  afterEach(async () => {
-    await db?.close();
-  });
-
-  it('starts with an active order', async () => {
-    const mgr = createOrderManager({ currency: 'USD', taxContext, draftsCollection: db.pos_drafts });
-    const builder = await firstValueFrom(mgr.activeOrder$);
-    expect(builder).toBeDefined();
-
-    const order = await firstValueFrom(builder.order$);
-    expect(order.status).toBe('draft');
-  });
-
-  it('creates a new order and switches to it', async () => {
-    const mgr = createOrderManager({ currency: 'USD', taxContext, draftsCollection: db.pos_drafts });
-
-    const first = await firstValueFrom(mgr.activeOrder$);
-    const firstOrder = await firstValueFrom(first.order$);
-
-    mgr.newOrder();
-    const second = await firstValueFrom(mgr.activeOrder$);
-    const secondOrder = await firstValueFrom(second.order$);
-
-    expect(firstOrder.id).not.toBe(secondOrder.id);
-  });
-
-  it('parks an order to local storage and lists it', async () => {
-    const mgr = createOrderManager({ currency: 'USD', taxContext, draftsCollection: db.pos_drafts });
-
-    const builder = await firstValueFrom(mgr.activeOrder$);
-    builder.addProduct(product, traits);
-    builder.setCustomer({ id: 'c1', name: 'Alice' });
-
-    await mgr.parkCurrentOrder();
-
-    const parked = await firstValueFrom(mgr.parkedOrders$);
-    expect(parked).toHaveLength(1);
-    expect(parked[0].customerName).toBe('Alice');
-    expect(parked[0].itemCount).toBe(1);
-    expect(parked[0].source).toBe('local');
-  });
-
-  it('resumes a parked order', async () => {
-    const mgr = createOrderManager({ currency: 'USD', taxContext, draftsCollection: db.pos_drafts });
-
-    const builder = await firstValueFrom(mgr.activeOrder$);
-    builder.addProduct(product, traits);
-    const orderId = (await firstValueFrom(builder.order$)).id;
-
-    await mgr.parkCurrentOrder();
-    await mgr.resumeOrder(orderId);
-
-    const resumed = await firstValueFrom(mgr.activeOrder$);
-    const order = await firstValueFrom(resumed.order$);
-    expect(order.id).toBe(orderId);
-    expect(order.lineItems).toHaveLength(1);
-  });
-
-  it('deletes a parked order', async () => {
-    const mgr = createOrderManager({ currency: 'USD', taxContext, draftsCollection: db.pos_drafts });
-
-    const builder = await firstValueFrom(mgr.activeOrder$);
-    builder.addProduct(product, traits);
-    const orderId = (await firstValueFrom(builder.order$)).id;
-
-    await mgr.parkCurrentOrder();
-    await mgr.deleteParkedOrder(orderId);
-
-    const parked = await firstValueFrom(mgr.parkedOrders$);
-    expect(parked).toHaveLength(0);
-  });
-
-  it('preserves line-level discounts through park/resume', async () => {
-    const mgr = createOrderManager({ currency: 'USD', taxContext, draftsCollection: db.pos_drafts });
-
-    const builder = await firstValueFrom(mgr.activeOrder$);
-    const lineId = builder.addProduct(product, traits);
-    builder.applyLineDiscount(lineId, { type: 'percentage', value: 10, label: '10% off' });
-    const orderId = (await firstValueFrom(builder.order$)).id;
-
-    await mgr.parkCurrentOrder();
-    await mgr.resumeOrder(orderId);
-
-    const resumed = await firstValueFrom(mgr.activeOrder$);
-    const order = await firstValueFrom(resumed.order$);
-    expect(order.lineItems[0].discounts).toHaveLength(1);
-    expect(order.lineItems[0].discounts[0].label).toBe('10% off');
-    expect(order.lineItems[0].discountAmount).toBeCloseTo(0.50); // 10% of $5
-  });
-
-  it('preserves order-level discounts through park/resume', async () => {
-    const mgr = createOrderManager({ currency: 'USD', taxContext, draftsCollection: db.pos_drafts });
-
-    const builder = await firstValueFrom(mgr.activeOrder$);
-    builder.addProduct(product, traits);
-    builder.applyOrderDiscount({ type: 'fixed', value: 1, label: 'Loyalty' });
-    const orderId = (await firstValueFrom(builder.order$)).id;
-
-    await mgr.parkCurrentOrder();
-    await mgr.resumeOrder(orderId);
-
-    const resumed = await firstValueFrom(mgr.activeOrder$);
-    const order = await firstValueFrom(resumed.order$);
-    expect(order.discounts).toHaveLength(1);
-    expect(order.discounts[0].label).toBe('Loyalty');
-  });
-
-  it('preserves payments through park/resume', async () => {
-    const mgr = createOrderManager({ currency: 'USD', taxContext, draftsCollection: db.pos_drafts });
-
-    const builder = await firstValueFrom(mgr.activeOrder$);
-    builder.addProduct(product, traits);
-    builder.addPayment({ method: 'cash', amount: 3 });
-    const orderId = (await firstValueFrom(builder.order$)).id;
-
-    await mgr.parkCurrentOrder();
-    await mgr.resumeOrder(orderId);
-
-    const resumed = await firstValueFrom(mgr.activeOrder$);
-    const order = await firstValueFrom(resumed.order$);
-    expect(order.payments).toHaveLength(1);
-    expect(order.payments[0].method).toBe('cash');
-    expect(order.payments[0].amount).toBe(3);
-  });
-
-  it('throws when resuming non-existent order', async () => {
-    const mgr = createOrderManager({ currency: 'USD', taxContext, draftsCollection: db.pos_drafts });
-    await expect(mgr.resumeOrder('nonexistent')).rejects.toThrow('Parked order nonexistent not found');
-  });
-
-  it('parking creates a fresh active order', async () => {
-    const mgr = createOrderManager({ currency: 'USD', taxContext, draftsCollection: db.pos_drafts });
-
-    const builder = await firstValueFrom(mgr.activeOrder$);
-    builder.addProduct(product, traits);
-    const oldId = (await firstValueFrom(builder.order$)).id;
-
-    await mgr.parkCurrentOrder();
-
-    const newBuilder = await firstValueFrom(mgr.activeOrder$);
-    const newOrder = await firstValueFrom(newBuilder.order$);
-    expect(newOrder.id).not.toBe(oldId);
-    expect(newOrder.lineItems).toHaveLength(0);
-  });
-});

package/src/order/payment.test.ts

@@ -1,91 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { firstValueFrom } from 'rxjs';
-import { createOrderBuilder } from './order-builder';
-import type { ProductTraits } from '@tallyui/core';
-import type { TaxContext } from '../tax/types';
-
-const traits: ProductTraits = {
-  getId: (doc) => doc.id,
-  getName: (doc) => doc.name,
-  getSku: () => '',
-  getPrice: (doc) => String(doc.price),
-  getRegularPrice: (doc) => String(doc.price),
-  getSalePrice: () => undefined,
-  isOnSale: () => false,
-  getImageUrl: () => undefined,
-  getImageUrls: () => [],
-  getDescription: () => undefined,
-  getStockStatus: () => 'instock',
-  getStockQuantity: () => null,
-  hasVariants: () => false,
-  getType: () => 'simple',
-  getBarcode: () => undefined,
-  getCategoryNames: () => [],
-};
-
-const taxContext: TaxContext = { getTaxRate: () => 0, pricesIncludeTax: false };
-
-describe('payment splitting', () => {
-  it('tracks a single payment', async () => {
-    const builder = createOrderBuilder({ currency: 'USD', taxContext });
-    builder.addProduct({ id: 'p1', name: 'Item', price: 20 }, traits);
-    builder.addPayment({ method: 'cash', amount: 20 });
-
-    const order = await firstValueFrom(builder.order$);
-    expect(order.payments).toHaveLength(1);
-    expect(order.balanceDue).toBe(0);
-    expect(order.changeDue).toBe(0);
-  });
-
-  it('splits payment across two methods', async () => {
-    const builder = createOrderBuilder({ currency: 'USD', taxContext });
-    builder.addProduct({ id: 'p1', name: 'Item', price: 35.50 }, traits);
-    builder.addPayment({ method: 'cash', amount: 20 });
-    builder.addPayment({ method: 'card', amount: 15.50 });
-
-    const order = await firstValueFrom(builder.order$);
-    expect(order.payments).toHaveLength(2);
-    expect(order.balanceDue).toBe(0);
-    expect(order.changeDue).toBe(0);
-  });
-
-  it('calculates balance due when partially paid', async () => {
-    const builder = createOrderBuilder({ currency: 'USD', taxContext });
-    builder.addProduct({ id: 'p1', name: 'Item', price: 30 }, traits);
-    builder.addPayment({ method: 'card', amount: 10 });
-
-    const order = await firstValueFrom(builder.order$);
-    expect(order.balanceDue).toBeCloseTo(20);
-    expect(order.changeDue).toBe(0);
-  });
-
-  it('calculates change due when overpaid with cash', async () => {
-    const builder = createOrderBuilder({ currency: 'USD', taxContext });
-    builder.addProduct({ id: 'p1', name: 'Item', price: 17 }, traits);
-    builder.addPayment({ method: 'cash', amount: 20 });
-
-    const order = await firstValueFrom(builder.order$);
-    expect(order.balanceDue).toBe(0);
-    expect(order.changeDue).toBeCloseTo(3);
-  });
-
-  it('removes a payment', async () => {
-    const builder = createOrderBuilder({ currency: 'USD', taxContext });
-    builder.addProduct({ id: 'p1', name: 'Item', price: 20 }, traits);
-    const paymentId = builder.addPayment({ method: 'cash', amount: 20 });
-
-    builder.removePayment(paymentId);
-    const order = await firstValueFrom(builder.order$);
-    expect(order.payments).toHaveLength(0);
-    expect(order.balanceDue).toBe(20);
-  });
-
-  it('includes payment reference', async () => {
-    const builder = createOrderBuilder({ currency: 'USD', taxContext });
-    builder.addProduct({ id: 'p1', name: 'Item', price: 10 }, traits);
-    builder.addPayment({ method: 'card', amount: 10, reference: 'TXN-4567' });
-
-    const order = await firstValueFrom(builder.order$);
-    expect(order.payments[0].reference).toBe('TXN-4567');
-  });
-});