@unifiedcommerce/plugin-pos 0.0.1

package/dist/services/return-service.js

@@ -0,0 +1,51 @@
+import { eq } from "drizzle-orm";
+import { Ok, Err } from "@unifiedcommerce/core";
+import { posReturnItems } from "../schema";
+export class ReturnService {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Record return items linking back to an original order's line items.
+     * Called after a return transaction is created.
+     */
+    async addReturnItems(transactionId, items) {
+        if (items.length === 0)
+            return Err("At least one item is required");
+        const values = items.map((item) => ({
+            transactionId,
+            originalOrderId: item.originalOrderId,
+            originalLineItemId: item.originalLineItemId,
+            quantity: item.quantity,
+            reason: item.reason,
+            restockingFee: item.restockingFee ?? 0,
+            refundAmount: item.refundAmount,
+        }));
+        const rows = await this.db
+            .insert(posReturnItems)
+            .values(values)
+            .returning();
+        return Ok(rows);
+    }
+    /**
+     * Get all return items for a return transaction.
+     */
+    async getReturnItems(transactionId) {
+        const rows = await this.db
+            .select()
+            .from(posReturnItems)
+            .where(eq(posReturnItems.transactionId, transactionId));
+        return Ok(rows);
+    }
+    /**
+     * Calculate total refund amount for a return transaction.
+     */
+    async calculateRefundTotal(transactionId) {
+        const items = await this.db
+            .select()
+            .from(posReturnItems)
+            .where(eq(posReturnItems.transactionId, transactionId));
+        return items.reduce((sum, item) => sum + item.refundAmount, 0);
+    }
+}

package/dist/services/shift-service.d.ts

@@ -0,0 +1,36 @@
+import type { PluginResult } from "@unifiedcommerce/core";
+import type { Db, Shift, CashEvent } from "../types";
+export declare class ShiftService {
+    private db;
+    private transaction;
+    constructor(db: Db, transaction: (fn: (tx: Db) => Promise<unknown>) => Promise<unknown>);
+    open(orgId: string, input: {
+        terminalId: string;
+        operatorId: string;
+        openingFloat: number;
+    }): Promise<PluginResult<Shift>>;
+    close(orgId: string, shiftId: string, input: {
+        closingCount: number;
+    }): Promise<PluginResult<Shift>>;
+    getCurrent(orgId: string, operatorId: string): Promise<PluginResult<Shift | null>>;
+    getById(orgId: string, id: string): Promise<PluginResult<Shift>>;
+    addCashEvent(shiftId: string, input: {
+        type: "drop" | "pickup" | "paid_in" | "paid_out";
+        amount: number;
+        reason?: string;
+        performedBy: string;
+    }): Promise<PluginResult<CashEvent>>;
+    listCashEvents(shiftId: string): Promise<PluginResult<CashEvent[]>>;
+    getReport(orgId: string, shiftId: string): Promise<PluginResult<{
+        shift: Shift;
+        cashEvents: CashEvent[];
+        paymentMethodTotals: Array<{
+            method: string;
+            total: number;
+            count: number;
+        }>;
+        transactionCount: number;
+    }>>;
+    private calculateExpectedCash;
+}
+//# sourceMappingURL=shift-service.d.ts.map

package/dist/services/shift-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shift-service.d.ts","sourceRoot":"","sources":["../../src/services/shift-service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErD,qBAAa,YAAY;IAErB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,WAAW;gBADX,EAAE,EAAE,EAAE,EACN,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC;IAGvE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE;QAC/B,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAyC1B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE;QACjD,YAAY,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAmC1B,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAalF,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAYhE,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE;QACzC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;QACjD,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IA2B9B,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC;IAWnE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;QACpE,KAAK,EAAE,KAAK,CAAC;QACb,UAAU,EAAE,SAAS,EAAE,CAAC;QACxB,mBAAmB,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC7E,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC,CAAC;YAgDW,qBAAqB;CA4CpC"}

package/dist/services/shift-service.js

@@ -0,0 +1,198 @@
+import { eq, and, desc, sql } from "drizzle-orm";
+import { Ok, Err } from "@unifiedcommerce/core";
+import { posShifts, posCashEvents, posPayments, posTransactions } from "../schema";
+export class ShiftService {
+    db;
+    transaction;
+    constructor(db, transaction) {
+        this.db = db;
+        this.transaction = transaction;
+    }
+    async open(orgId, input) {
+        if (input.openingFloat < 0)
+            return Err("Opening float must be non-negative");
+        // Check no open shift on this terminal
+        const openShifts = await this.db
+            .select()
+            .from(posShifts)
+            .where(and(eq(posShifts.terminalId, input.terminalId), eq(posShifts.status, "open")));
+        if (openShifts.length > 0) {
+            return Err("Terminal already has an open shift");
+        }
+        const rows = await this.db
+            .insert(posShifts)
+            .values({
+            organizationId: orgId,
+            terminalId: input.terminalId,
+            operatorId: input.operatorId,
+            openingFloat: input.openingFloat,
+            status: "open",
+        })
+            .returning();
+        const shift = rows[0];
+        // Record the opening float as a cash event
+        await this.db.insert(posCashEvents).values({
+            shiftId: shift.id,
+            type: "float",
+            amount: input.openingFloat,
+            performedBy: input.operatorId,
+            performedAt: new Date(),
+        });
+        return Ok(shift);
+    }
+    async close(orgId, shiftId, input) {
+        const result = await this.transaction(async (tx) => {
+            const shifts = await tx
+                .select()
+                .from(posShifts)
+                .where(and(eq(posShifts.id, shiftId), eq(posShifts.organizationId, orgId)))
+                .for("update");
+            if (shifts.length === 0)
+                return Err("Shift not found");
+            const shift = shifts[0];
+            if (shift.status === "closed")
+                return Err("Shift is already closed");
+            // Calculate expected cash
+            const expectedCash = await this.calculateExpectedCash(tx, shiftId, shift.openingFloat);
+            const cashVariance = input.closingCount - expectedCash;
+            const updated = await tx
+                .update(posShifts)
+                .set({
+                status: "closed",
+                closingCount: input.closingCount,
+                expectedCash,
+                cashVariance,
+                closedAt: new Date(),
+                updatedAt: new Date(),
+            })
+                .where(eq(posShifts.id, shiftId))
+                .returning();
+            return Ok(updated[0]);
+        });
+        return result;
+    }
+    async getCurrent(orgId, operatorId) {
+        const rows = await this.db
+            .select()
+            .from(posShifts)
+            .where(and(eq(posShifts.organizationId, orgId), eq(posShifts.operatorId, operatorId), eq(posShifts.status, "open")));
+        return Ok(rows[0] ?? null);
+    }
+    async getById(orgId, id) {
+        const rows = await this.db
+            .select()
+            .from(posShifts)
+            .where(and(eq(posShifts.id, id), eq(posShifts.organizationId, orgId)));
+        if (rows.length === 0)
+            return Err("Shift not found");
+        return Ok(rows[0]);
+    }
+    // ─── Cash Events ───────────────────────────────────────────────────
+    async addCashEvent(shiftId, input) {
+        if (input.amount <= 0)
+            return Err("Amount must be positive");
+        // Verify shift is open
+        const shifts = await this.db
+            .select()
+            .from(posShifts)
+            .where(eq(posShifts.id, shiftId));
+        if (shifts.length === 0)
+            return Err("Shift not found");
+        if (shifts[0].status !== "open")
+            return Err("Shift is not open");
+        const rows = await this.db
+            .insert(posCashEvents)
+            .values({
+            shiftId,
+            type: input.type,
+            amount: input.amount,
+            reason: input.reason,
+            performedBy: input.performedBy,
+            performedAt: new Date(),
+        })
+            .returning();
+        return Ok(rows[0]);
+    }
+    async listCashEvents(shiftId) {
+        const rows = await this.db
+            .select()
+            .from(posCashEvents)
+            .where(eq(posCashEvents.shiftId, shiftId))
+            .orderBy(desc(posCashEvents.performedAt));
+        return Ok(rows);
+    }
+    // ─── Z-Report ──────────────────────────────────────────────────────
+    async getReport(orgId, shiftId) {
+        const shiftResult = await this.getById(orgId, shiftId);
+        if (!shiftResult.ok)
+            return shiftResult;
+        const shift = shiftResult.value;
+        const cashEvents = await this.db
+            .select()
+            .from(posCashEvents)
+            .where(eq(posCashEvents.shiftId, shiftId))
+            .orderBy(desc(posCashEvents.performedAt));
+        // Payment method totals
+        const paymentRows = await this.db
+            .select({
+            method: posPayments.method,
+            total: sql `SUM(${posPayments.amount})`.as("total"),
+            count: sql `COUNT(*)`.as("count"),
+        })
+            .from(posPayments)
+            .innerJoin(posTransactions, eq(posPayments.transactionId, posTransactions.id))
+            .where(and(eq(posTransactions.shiftId, shiftId), eq(posTransactions.status, "completed")))
+            .groupBy(posPayments.method);
+        const transactionCountRows = await this.db
+            .select({ count: sql `COUNT(*)`.as("count") })
+            .from(posTransactions)
+            .where(and(eq(posTransactions.shiftId, shiftId), eq(posTransactions.status, "completed")));
+        return Ok({
+            shift,
+            cashEvents,
+            paymentMethodTotals: paymentRows.map((r) => ({
+                method: r.method,
+                total: Number(r.total),
+                count: Number(r.count),
+            })),
+            transactionCount: Number(transactionCountRows[0]?.count ?? 0),
+        });
+    }
+    // ─── Helpers ───────────────────────────────────────────────────────
+    async calculateExpectedCash(db, shiftId, openingFloat) {
+        // Cash payments collected during this shift
+        const cashPaymentRows = await db
+            .select({
+            total: sql `COALESCE(SUM(${posPayments.amount} - ${posPayments.changeGiven}), 0)`.as("total"),
+        })
+            .from(posPayments)
+            .innerJoin(posTransactions, eq(posPayments.transactionId, posTransactions.id))
+            .where(and(eq(posTransactions.shiftId, shiftId), eq(posPayments.method, "cash"), eq(posPayments.status, "collected")));
+        const cashFromSales = Number(cashPaymentRows[0]?.total ?? 0);
+        // Cash events: drops reduce, pickups add to drawer
+        const cashEventRows = await db
+            .select({
+            type: posCashEvents.type,
+            total: sql `SUM(${posCashEvents.amount})`.as("total"),
+        })
+            .from(posCashEvents)
+            .where(eq(posCashEvents.shiftId, shiftId))
+            .groupBy(posCashEvents.type);
+        let cashAdjustment = 0;
+        for (const row of cashEventRows) {
+            const amount = Number(row.total);
+            switch (row.type) {
+                case "drop":
+                case "paid_out":
+                    cashAdjustment -= amount;
+                    break;
+                case "pickup":
+                case "paid_in":
+                    cashAdjustment += amount;
+                    break;
+                // float is already accounted for in openingFloat
+            }
+        }
+        return openingFloat + cashFromSales + cashAdjustment;
+    }
+}

package/dist/services/terminal-service.d.ts

@@ -0,0 +1,21 @@
+import type { PluginResult } from "@unifiedcommerce/core";
+import type { Db, Terminal } from "../types";
+export declare class TerminalService {
+    private db;
+    constructor(db: Db);
+    create(orgId: string, input: {
+        name: string;
+        code: string;
+        type?: "register" | "tablet" | "mobile" | "kiosk";
+        metadata?: Record<string, unknown>;
+    }): Promise<PluginResult<Terminal>>;
+    list(orgId: string): Promise<PluginResult<Terminal[]>>;
+    getById(orgId: string, id: string): Promise<PluginResult<Terminal>>;
+    update(orgId: string, id: string, input: {
+        name?: string;
+        isActive?: boolean;
+        metadata?: Record<string, unknown>;
+    }): Promise<PluginResult<Terminal>>;
+    deactivate(orgId: string, id: string): Promise<PluginResult<Terminal>>;
+}
+//# sourceMappingURL=terminal-service.d.ts.map

package/dist/services/terminal-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-service.d.ts","sourceRoot":"","sources":["../../src/services/terminal-service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAkB,MAAM,UAAU,CAAC;AAE7D,qBAAa,eAAe;IACd,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,EAAE;IAEpB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE;QACjC,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;QAClD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAyB7B,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC;IAQtD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAUnE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;QAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAW7B,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;CAG7E"}

package/dist/services/terminal-service.js

@@ -0,0 +1,59 @@
+import { eq, and } from "drizzle-orm";
+import { Ok, Err } from "@unifiedcommerce/core";
+import { posTerminals } from "../schema";
+export class TerminalService {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    async create(orgId, input) {
+        // Check for duplicate code in same org
+        const existing = await this.db
+            .select()
+            .from(posTerminals)
+            .where(and(eq(posTerminals.organizationId, orgId), eq(posTerminals.code, input.code)));
+        if (existing.length > 0) {
+            return Err(`Terminal with code '${input.code}' already exists`);
+        }
+        const rows = await this.db
+            .insert(posTerminals)
+            .values({
+            organizationId: orgId,
+            name: input.name,
+            code: input.code,
+            type: input.type ?? "register",
+            metadata: input.metadata ?? {},
+        })
+            .returning();
+        return Ok(rows[0]);
+    }
+    async list(orgId) {
+        const rows = await this.db
+            .select()
+            .from(posTerminals)
+            .where(eq(posTerminals.organizationId, orgId));
+        return Ok(rows);
+    }
+    async getById(orgId, id) {
+        const rows = await this.db
+            .select()
+            .from(posTerminals)
+            .where(and(eq(posTerminals.id, id), eq(posTerminals.organizationId, orgId)));
+        if (rows.length === 0)
+            return Err("Terminal not found");
+        return Ok(rows[0]);
+    }
+    async update(orgId, id, input) {
+        const rows = await this.db
+            .update(posTerminals)
+            .set({ ...input, updatedAt: new Date() })
+            .where(and(eq(posTerminals.id, id), eq(posTerminals.organizationId, orgId)))
+            .returning();
+        if (rows.length === 0)
+            return Err("Terminal not found");
+        return Ok(rows[0]);
+    }
+    async deactivate(orgId, id) {
+        return this.update(orgId, id, { isActive: false });
+    }
+}

package/dist/services/transaction-service.d.ts

@@ -0,0 +1,30 @@
+import type { PluginResult } from "@unifiedcommerce/core";
+import type { Db, Transaction } from "../types";
+export declare class TransactionService {
+    private db;
+    private transaction;
+    constructor(db: Db, transaction: (fn: (tx: Db) => Promise<unknown>) => Promise<unknown>);
+    create(orgId: string, input: {
+        shiftId: string;
+        terminalId: string;
+        operatorId: string;
+        cartId: string;
+        type?: "sale" | "return" | "exchange";
+        customerId?: string;
+    }): Promise<PluginResult<Transaction>>;
+    getById(orgId: string, id: string): Promise<PluginResult<Transaction>>;
+    hold(orgId: string, id: string, label: string): Promise<PluginResult<Transaction>>;
+    recall(orgId: string, id: string): Promise<PluginResult<Transaction>>;
+    listHeld(orgId: string, terminalId: string): Promise<PluginResult<Transaction[]>>;
+    void(orgId: string, id: string, reason: string): Promise<PluginResult<Transaction>>;
+    setCustomer(orgId: string, id: string, customerId: string): Promise<PluginResult<Transaction>>;
+    updateTotals(id: string, totals: {
+        subtotal: number;
+        taxTotal: number;
+        total: number;
+        discountTotal: number;
+    }): Promise<void>;
+    complete(id: string, orderId: string | null): Promise<PluginResult<Transaction>>;
+    private generateReceiptNumber;
+}
+//# sourceMappingURL=transaction-service.d.ts.map

package/dist/services/transaction-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-service.d.ts","sourceRoot":"","sources":["../../src/services/transaction-service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,KAAK,EAAE,EAAE,EAAE,WAAW,EAAqB,MAAM,UAAU,CAAC;AAEnE,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,WAAW;gBADX,EAAE,EAAE,EAAE,EACN,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC;IAGvE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE;QACjC,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;QACtC,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IA4BhC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IAUtE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IAclF,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IAcrE,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;IAcjF,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IAgCnF,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IAc9F,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;QACrC,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOX,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;YAgExE,qBAAqB;CA0BpC"}

package/dist/services/transaction-service.js

@@ -0,0 +1,202 @@
+import { eq, and, desc, sql } from "drizzle-orm";
+import { Ok, Err } from "@unifiedcommerce/core";
+import { posTransactions, posPayments, posShifts } from "../schema";
+export class TransactionService {
+    db;
+    transaction;
+    constructor(db, transaction) {
+        this.db = db;
+        this.transaction = transaction;
+    }
+    async create(orgId, input) {
+        // Verify shift is open
+        const shifts = await this.db
+            .select()
+            .from(posShifts)
+            .where(and(eq(posShifts.id, input.shiftId), eq(posShifts.status, "open")));
+        if (shifts.length === 0)
+            return Err("Shift is not open");
+        const receiptNumber = await this.generateReceiptNumber(input.terminalId);
+        const rows = await this.db
+            .insert(posTransactions)
+            .values({
+            organizationId: orgId,
+            shiftId: input.shiftId,
+            terminalId: input.terminalId,
+            operatorId: input.operatorId,
+            cartId: input.cartId,
+            type: input.type ?? "sale",
+            status: "open",
+            customerId: input.customerId,
+            receiptNumber,
+        })
+            .returning();
+        return Ok(rows[0]);
+    }
+    async getById(orgId, id) {
+        const rows = await this.db
+            .select()
+            .from(posTransactions)
+            .where(and(eq(posTransactions.id, id), eq(posTransactions.organizationId, orgId)));
+        if (rows.length === 0)
+            return Err("Transaction not found");
+        return Ok(rows[0]);
+    }
+    async hold(orgId, id, label) {
+        const txnResult = await this.getById(orgId, id);
+        if (!txnResult.ok)
+            return txnResult;
+        if (txnResult.value.status !== "open")
+            return Err("Only open transactions can be held");
+        const rows = await this.db
+            .update(posTransactions)
+            .set({ status: "held", holdLabel: label, updatedAt: new Date() })
+            .where(eq(posTransactions.id, id))
+            .returning();
+        return Ok(rows[0]);
+    }
+    async recall(orgId, id) {
+        const txnResult = await this.getById(orgId, id);
+        if (!txnResult.ok)
+            return txnResult;
+        if (txnResult.value.status !== "held")
+            return Err("Only held transactions can be recalled");
+        const rows = await this.db
+            .update(posTransactions)
+            .set({ status: "open", holdLabel: null, updatedAt: new Date() })
+            .where(eq(posTransactions.id, id))
+            .returning();
+        return Ok(rows[0]);
+    }
+    async listHeld(orgId, terminalId) {
+        const rows = await this.db
+            .select()
+            .from(posTransactions)
+            .where(and(eq(posTransactions.organizationId, orgId), eq(posTransactions.terminalId, terminalId), eq(posTransactions.status, "held")))
+            .orderBy(desc(posTransactions.createdAt));
+        return Ok(rows);
+    }
+    async void(orgId, id, reason) {
+        const result = await this.transaction(async (tx) => {
+            const txns = await tx
+                .select()
+                .from(posTransactions)
+                .where(and(eq(posTransactions.id, id), eq(posTransactions.organizationId, orgId)))
+                .for("update");
+            if (txns.length === 0)
+                return Err("Transaction not found");
+            const txn = txns[0];
+            if (txn.status === "completed")
+                return Err("Cannot void a completed transaction");
+            if (txn.status === "voided")
+                return Err("Transaction is already voided");
+            const updated = await tx
+                .update(posTransactions)
+                .set({ status: "voided", voidReason: reason, updatedAt: new Date() })
+                .where(eq(posTransactions.id, id))
+                .returning();
+            // Increment void count on shift
+            await tx
+                .update(posShifts)
+                .set({ voidsCount: sql `${posShifts.voidsCount} + 1`, updatedAt: new Date() })
+                .where(eq(posShifts.id, txn.shiftId));
+            return Ok(updated[0]);
+        });
+        return result;
+    }
+    async setCustomer(orgId, id, customerId) {
+        const txnResult = await this.getById(orgId, id);
+        if (!txnResult.ok)
+            return txnResult;
+        if (txnResult.value.status !== "open")
+            return Err("Can only set customer on open transactions");
+        const rows = await this.db
+            .update(posTransactions)
+            .set({ customerId, updatedAt: new Date() })
+            .where(eq(posTransactions.id, id))
+            .returning();
+        return Ok(rows[0]);
+    }
+    async updateTotals(id, totals) {
+        await this.db
+            .update(posTransactions)
+            .set({ ...totals, updatedAt: new Date() })
+            .where(eq(posTransactions.id, id));
+    }
+    async complete(id, orderId) {
+        const result = await this.transaction(async (tx) => {
+            // Lock and verify transaction is in a completable state
+            const existing = await tx
+                .select()
+                .from(posTransactions)
+                .where(eq(posTransactions.id, id))
+                .for("update");
+            if (existing.length === 0)
+                return Err("Transaction not found");
+            const current = existing[0];
+            if (current.status === "completed")
+                return Err("Transaction is already completed");
+            if (current.status === "voided")
+                return Err("Cannot complete a voided transaction");
+            if (current.status !== "open")
+                return Err(`Cannot complete transaction in '${current.status}' status`);
+            // Sum collected payments to derive transaction total
+            const paymentRows = await tx
+                .select({
+                total: sql `COALESCE(SUM(${posPayments.amount} - ${posPayments.changeGiven}), 0)`.as("total"),
+            })
+                .from(posPayments)
+                .where(and(eq(posPayments.transactionId, id), eq(posPayments.status, "collected")));
+            const paymentTotal = Number(paymentRows[0]?.total ?? 0);
+            const rows = await tx
+                .update(posTransactions)
+                .set({
+                status: "completed",
+                subtotal: paymentTotal,
+                total: paymentTotal,
+                ...(orderId != null ? { orderId } : {}),
+                completedAt: new Date(),
+                updatedAt: new Date(),
+            })
+                .where(eq(posTransactions.id, id))
+                .returning();
+            if (rows.length === 0)
+                return Err("Transaction not found");
+            const txn = rows[0];
+            // Update shift sales counters
+            if (txn.type === "sale" && paymentTotal > 0) {
+                await tx
+                    .update(posShifts)
+                    .set({
+                    salesCount: sql `${posShifts.salesCount} + 1`,
+                    salesTotal: sql `${posShifts.salesTotal} + ${paymentTotal}`,
+                    updatedAt: new Date(),
+                })
+                    .where(eq(posShifts.id, txn.shiftId));
+            }
+            return Ok(txn);
+        });
+        return result;
+    }
+    // ─── Receipt Number Generation ─────────────────────────────────────
+    // Sequential per terminal per day: {terminal_code}-{sequence}
+    async generateReceiptNumber(terminalId) {
+        const today = new Date();
+        const startOfDay = new Date(today.getFullYear(), today.getMonth(), today.getDate());
+        const startOfDayISO = startOfDay.toISOString();
+        // Get terminal code
+        const { posTerminals } = await import("../schema");
+        const terminals = await this.db
+            .select({ code: posTerminals.code })
+            .from(posTerminals)
+            .where(eq(posTerminals.id, terminalId));
+        const terminalCode = terminals[0]?.code ?? "POS";
+        // Count today's transactions for this terminal
+        const countRows = await this.db
+            .select({ count: sql `COUNT(*)`.as("count") })
+            .from(posTransactions)
+            .where(and(eq(posTransactions.terminalId, terminalId), sql `${posTransactions.createdAt} >= ${startOfDayISO}::timestamptz`));
+        const seq = Number(countRows[0]?.count ?? 0) + 1;
+        return `${terminalCode}-${String(seq).padStart(4, "0")}`;
+    }
+}

package/dist/types.d.ts

@@ -0,0 +1,30 @@
+export type { PluginDb as Db } from "@unifiedcommerce/core";
+import type { posTerminals, posShifts, posCashEvents, posTransactions, posPayments, posReturnItems } from "./schema";
+export type Terminal = typeof posTerminals.$inferSelect;
+export type TerminalInsert = typeof posTerminals.$inferInsert;
+export type Shift = typeof posShifts.$inferSelect;
+export type ShiftInsert = typeof posShifts.$inferInsert;
+export type CashEvent = typeof posCashEvents.$inferSelect;
+export type CashEventInsert = typeof posCashEvents.$inferInsert;
+export type Transaction = typeof posTransactions.$inferSelect;
+export type TransactionInsert = typeof posTransactions.$inferInsert;
+export type Payment = typeof posPayments.$inferSelect;
+export type PaymentInsert = typeof posPayments.$inferInsert;
+export type ReturnItem = typeof posReturnItems.$inferSelect;
+export type ReturnItemInsert = typeof posReturnItems.$inferInsert;
+export type TransactionStatus = "open" | "held" | "completed" | "voided";
+export type TransactionType = "sale" | "return" | "exchange";
+export type PaymentMethod = "cash" | "card" | "gift_card" | "store_credit" | "other";
+export type CashEventType = "float" | "drop" | "pickup" | "paid_in" | "paid_out";
+export type ShiftStatus = "open" | "closed";
+export type TerminalType = "register" | "tablet" | "mobile" | "kiosk";
+export interface POSPluginOptions {
+    /** Default currency for new transactions. Default: "USD" */
+    defaultCurrency?: string;
+    /** Maximum hold duration in hours before auto-void. Default: 24 */
+    maxHoldHours?: number;
+    /** Require manager override for discounts above this percentage. Default: 20 */
+    discountOverrideThreshold?: number;
+}
+export declare const DEFAULT_POS_OPTIONS: Required<POSPluginOptions>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,aAAa,EACb,eAAe,EACf,WAAW,EACX,cAAc,EACf,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,QAAQ,GAAG,OAAO,YAAY,CAAC,YAAY,CAAC;AACxD,MAAM,MAAM,cAAc,GAAG,OAAO,YAAY,CAAC,YAAY,CAAC;AAE9D,MAAM,MAAM,KAAK,GAAG,OAAO,SAAS,CAAC,YAAY,CAAC;AAClD,MAAM,MAAM,WAAW,GAAG,OAAO,SAAS,CAAC,YAAY,CAAC;AAExD,MAAM,MAAM,SAAS,GAAG,OAAO,aAAa,CAAC,YAAY,CAAC;AAC1D,MAAM,MAAM,eAAe,GAAG,OAAO,aAAa,CAAC,YAAY,CAAC;AAEhE,MAAM,MAAM,WAAW,GAAG,OAAO,eAAe,CAAC,YAAY,CAAC;AAC9D,MAAM,MAAM,iBAAiB,GAAG,OAAO,eAAe,CAAC,YAAY,CAAC;AAEpE,MAAM,MAAM,OAAO,GAAG,OAAO,WAAW,CAAC,YAAY,CAAC;AACtD,MAAM,MAAM,aAAa,GAAG,OAAO,WAAW,CAAC,YAAY,CAAC;AAE5D,MAAM,MAAM,UAAU,GAAG,OAAO,cAAc,CAAC,YAAY,CAAC;AAC5D,MAAM,MAAM,gBAAgB,GAAG,OAAO,cAAc,CAAC,YAAY,CAAC;AAElE,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AACzE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AAC7D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,cAAc,GAAG,OAAO,CAAC;AACrF,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AACjF,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC;AAC5C,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEtE,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,gBAAgB,CAI1D,CAAC"}

package/dist/types.js

@@ -0,0 +1,5 @@
+export const DEFAULT_POS_OPTIONS = {
+    defaultCurrency: "USD",
+    maxHoldHours: 24,
+    discountOverrideThreshold: 20,
+};