@unifiedcommerce/plugin-pos 0.0.1

package/dist/hooks/checkout-pos.d.ts

@@ -0,0 +1,29 @@
+/**
+ * POS-specific checkout hooks.
+ *
+ * checkout.beforePayment: Sets shippingTotal = 0 for POS transactions (no shipping).
+ * checkout.afterCreate: Updates POS transaction with orderId, increments shift counters.
+ */
+import type { Db } from "../types";
+interface CheckoutData {
+    metadata?: Record<string, unknown> | null;
+    shippingTotal: number;
+    shippingAddress?: unknown;
+    [key: string]: unknown;
+}
+/**
+ * Before payment hook: zero out shipping for POS transactions.
+ */
+export declare function buildPOSShippingHook(): {
+    key: string;
+    handler: (...args: unknown[]) => Promise<CheckoutData>;
+};
+/**
+ * After create hook: finalize POS transaction with order details.
+ */
+export declare function buildPOSFinalizationHook(getDb: () => Db): {
+    key: string;
+    handler: (...args: unknown[]) => Promise<void>;
+};
+export {};
+//# sourceMappingURL=checkout-pos.d.ts.map

package/dist/hooks/checkout-pos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout-pos.d.ts","sourceRoot":"","sources":["../../src/hooks/checkout-pos.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEnC,UAAU,YAAY;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAaD;;GAEG;AACH,wBAAgB,oBAAoB;;uBAGP,OAAO,EAAE;EAWrC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE;;uBAG3B,OAAO,EAAE;EAsCrC"}

package/dist/hooks/checkout-pos.js

@@ -0,0 +1,69 @@
+/**
+ * POS-specific checkout hooks.
+ *
+ * checkout.beforePayment: Sets shippingTotal = 0 for POS transactions (no shipping).
+ * checkout.afterCreate: Updates POS transaction with orderId, increments shift counters.
+ */
+import { eq, sql } from "drizzle-orm";
+import { posTransactions, posShifts } from "../schema";
+/**
+ * Before payment hook: zero out shipping for POS transactions.
+ */
+export function buildPOSShippingHook() {
+    return {
+        key: "checkout.beforePayment",
+        handler: async (...args) => {
+            const hook = args[0];
+            const posTransactionId = hook.data.metadata?.posTransactionId;
+            if (!posTransactionId)
+                return hook.data;
+            // POS transactions have no shipping
+            hook.data.shippingTotal = 0;
+            hook.data.shippingAddress = undefined;
+            return hook.data;
+        },
+    };
+}
+/**
+ * After create hook: finalize POS transaction with order details.
+ */
+export function buildPOSFinalizationHook(getDb) {
+    return {
+        key: "checkout.afterCreate",
+        handler: async (...args) => {
+            const hook = args[0];
+            const result = hook.result;
+            if (!result)
+                return;
+            // Check if this checkout was initiated by a POS transaction
+            // The metadata is on the order, not directly on the hook result
+            const metadata = result.metadata;
+            const posTransactionId = metadata?.posTransactionId;
+            if (!posTransactionId)
+                return;
+            const db = getDb();
+            // Update transaction with orderId and status
+            await db
+                .update(posTransactions)
+                .set({
+                orderId: result.id,
+                status: "completed",
+                completedAt: new Date(),
+                updatedAt: new Date(),
+            })
+                .where(eq(posTransactions.id, posTransactionId));
+            // Increment shift sales counters
+            const posShiftId = metadata?.posShiftId;
+            if (posShiftId) {
+                await db
+                    .update(posShifts)
+                    .set({
+                    salesCount: sql `${posShifts.salesCount} + 1`,
+                    salesTotal: sql `${posShifts.salesTotal} + ${result.grandTotal ?? 0}`,
+                    updatedAt: new Date(),
+                })
+                    .where(eq(posShifts.id, posShiftId));
+            }
+        },
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+import type { POSPluginOptions } from "./types";
+export type { POSPluginOptions } from "./types";
+export { TerminalService } from "./services/terminal-service";
+export { ShiftService } from "./services/shift-service";
+export { TransactionService } from "./services/transaction-service";
+export { PaymentService } from "./services/payment-service";
+export { ReturnService } from "./services/return-service";
+export { LookupService } from "./services/lookup-service";
+export { ReceiptService } from "./services/receipt-service";
+export { createPOSPaymentAdapter } from "./payment-adapter";
+/**
+ * POS Plugin — Tier 0 Core Primitives (RFC-023)
+ *
+ * Provides:
+ * - Terminal management (register, tablet, mobile, kiosk)
+ * - Shift management (open/close with cash tracking, Z-report)
+ * - Transaction lifecycle (create, hold/recall, void, complete)
+ * - Split payment support (cash, card, gift card, store credit)
+ * - Returns with original order linkage
+ * - Barcode/SKU lookup via indexed queries
+ * - Receipt data assembly + email
+ * - POS payment adapter for checkout pipeline
+ * - Checkout hooks (zero shipping, transaction finalization)
+ */
+export declare function posPlugin(userOptions?: POSPluginOptions): import("@unifiedcommerce/core").CommercePlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,gBAAgB,EAAM,MAAM,SAAS,CAAC;AAGpD,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,WAAW,GAAE,gBAAqB,kDA+E3D"}

package/dist/index.js

@@ -0,0 +1,109 @@
+import { defineCommercePlugin } from "@unifiedcommerce/core";
+import { posTerminals, posShifts, posCashEvents, posTransactions, posPayments, posReturnItems, } from "./schema";
+import { TerminalService } from "./services/terminal-service";
+import { ShiftService } from "./services/shift-service";
+import { TransactionService } from "./services/transaction-service";
+import { PaymentService } from "./services/payment-service";
+import { ReturnService } from "./services/return-service";
+import { LookupService } from "./services/lookup-service";
+import { ReceiptService } from "./services/receipt-service";
+import { buildTerminalRoutes } from "./routes/terminals";
+import { buildShiftRoutes } from "./routes/shifts";
+import { buildTransactionRoutes } from "./routes/transactions";
+import { buildPaymentRoutes } from "./routes/payments";
+import { buildReturnRoutes } from "./routes/returns";
+import { buildLookupRoutes } from "./routes/lookup";
+import { buildReceiptRoutes } from "./routes/receipts";
+import { buildPOSShippingHook, buildPOSFinalizationHook } from "./hooks/checkout-pos";
+import { DEFAULT_POS_OPTIONS } from "./types";
+export { TerminalService } from "./services/terminal-service";
+export { ShiftService } from "./services/shift-service";
+export { TransactionService } from "./services/transaction-service";
+export { PaymentService } from "./services/payment-service";
+export { ReturnService } from "./services/return-service";
+export { LookupService } from "./services/lookup-service";
+export { ReceiptService } from "./services/receipt-service";
+export { createPOSPaymentAdapter } from "./payment-adapter";
+/**
+ * POS Plugin — Tier 0 Core Primitives (RFC-023)
+ *
+ * Provides:
+ * - Terminal management (register, tablet, mobile, kiosk)
+ * - Shift management (open/close with cash tracking, Z-report)
+ * - Transaction lifecycle (create, hold/recall, void, complete)
+ * - Split payment support (cash, card, gift card, store credit)
+ * - Returns with original order linkage
+ * - Barcode/SKU lookup via indexed queries
+ * - Receipt data assembly + email
+ * - POS payment adapter for checkout pipeline
+ * - Checkout hooks (zero shipping, transaction finalization)
+ */
+export function posPlugin(userOptions = {}) {
+    const options = {
+        ...DEFAULT_POS_OPTIONS,
+        ...userOptions,
+    };
+    // Shared DB reference for hooks (populated in routes())
+    const dbRef = { current: null };
+    return defineCommercePlugin({
+        id: "pos",
+        version: "1.0.0",
+        permissions: [
+            {
+                scope: "pos:admin",
+                description: "Register terminals, view all shifts, Z-reports, configure POS settings.",
+            },
+            {
+                scope: "pos:manage",
+                description: "Void transactions, apply discounts, process returns, override price.",
+            },
+            {
+                scope: "pos:operate",
+                description: "Open/close shifts, ring up sales, accept payment, hold/recall, reprint receipts.",
+            },
+        ],
+        schema: () => ({
+            posTerminals,
+            posShifts,
+            posCashEvents,
+            posTransactions,
+            posPayments,
+            posReturnItems,
+        }),
+        hooks: () => [
+            buildPOSShippingHook(),
+            buildPOSFinalizationHook(() => {
+                if (!dbRef.current)
+                    throw new Error("POS plugin DB not initialized — hooks ran before routes()");
+                return dbRef.current;
+            }),
+        ],
+        routes: (ctx) => {
+            const db = ctx.database.db;
+            if (!db)
+                return [];
+            // Populate the shared DB reference for hooks
+            dbRef.current = db;
+            const transactionFn = ctx.database.transaction;
+            // Initialize services
+            const terminalService = new TerminalService(db);
+            const shiftService = new ShiftService(db, transactionFn);
+            const transactionService = new TransactionService(db, transactionFn);
+            const paymentService = new PaymentService(db, transactionFn);
+            const returnService = new ReturnService(db);
+            const lookupService = new LookupService(db, ctx.services);
+            const receiptService = new ReceiptService(db, ctx.services);
+            // Cart service from core (for creating POS transaction carts)
+            const cartService = ctx.services.cart;
+            return [
+                ...buildTerminalRoutes(terminalService, ctx),
+                ...buildShiftRoutes(shiftService, ctx),
+                ...buildTransactionRoutes(transactionService, cartService, ctx),
+                ...buildPaymentRoutes(paymentService, transactionService, ctx),
+                ...buildReturnRoutes(returnService, transactionService, paymentService, cartService, ctx),
+                ...buildLookupRoutes(lookupService, ctx),
+                ...buildReceiptRoutes(receiptService, ctx),
+            ];
+        },
+    });
+}

package/dist/payment-adapter.d.ts

@@ -0,0 +1,33 @@
+/**
+ * POS Payment Adapter for the checkout pipeline.
+ *
+ * POS payments are collected at the terminal before checkout is called.
+ * The adapter acts as a pass-through: payment has already been tendered,
+ * so authorize/capture are no-ops.
+ */
+export interface PaymentAdapter {
+    providerId: string;
+    createPaymentIntent(params: {
+        amount: number;
+        currency: string;
+        orderId?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<{
+        id: string;
+        status: string;
+        amount: number;
+        clientSecret?: string;
+    }>;
+    capturePayment(intentId: string, amount: number): Promise<{
+        id: string;
+        status: string;
+        amountCaptured: number;
+    }>;
+    refundPayment(paymentId: string, amount: number): Promise<{
+        id: string;
+        status: string;
+        amountRefunded: number;
+    }>;
+}
+export declare function createPOSPaymentAdapter(): PaymentAdapter;
+//# sourceMappingURL=payment-adapter.d.ts.map

package/dist/payment-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-adapter.d.ts","sourceRoot":"","sources":["../src/payment-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,MAAM,EAAE;QAC1B,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnF,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnH;AAED,wBAAgB,uBAAuB,IAAI,cAAc,CAgCxD"}

package/dist/payment-adapter.js

@@ -0,0 +1,37 @@
+/**
+ * POS Payment Adapter for the checkout pipeline.
+ *
+ * POS payments are collected at the terminal before checkout is called.
+ * The adapter acts as a pass-through: payment has already been tendered,
+ * so authorize/capture are no-ops.
+ */
+export function createPOSPaymentAdapter() {
+    return {
+        providerId: "pos",
+        async createPaymentIntent(params) {
+            // POS payments are already collected at the terminal.
+            // The "intent" represents the sum of pos_payments rows.
+            return {
+                id: `pos_${params.orderId ?? crypto.randomUUID()}`,
+                status: "requires_capture",
+                amount: params.amount,
+            };
+        },
+        async capturePayment(intentId, amount) {
+            // POS payments are already collected. Capture is a no-op.
+            return {
+                id: intentId,
+                status: "succeeded",
+                amountCaptured: amount,
+            };
+        },
+        async refundPayment(paymentId, amount) {
+            // POS refunds are handled by the return transaction flow.
+            return {
+                id: `ref_${paymentId}`,
+                status: "succeeded",
+                amountRefunded: amount,
+            };
+        },
+    };
+}

package/dist/routes/lookup.d.ts

@@ -0,0 +1,9 @@
+import type { LookupService } from "../services/lookup-service";
+import type { PluginRouteRegistration } from "@unifiedcommerce/core";
+export declare function buildLookupRoutes(service: LookupService, ctx: {
+    services?: Record<string, unknown>;
+    database?: {
+        db: unknown;
+    };
+}): PluginRouteRegistration[];
+//# sourceMappingURL=lookup.d.ts.map

package/dist/routes/lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../../src/routes/lookup.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,aAAa,EACtB,GAAG,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GACtE,uBAAuB,EAAE,CAmC3B"}

package/dist/routes/lookup.js

@@ -0,0 +1,37 @@
+import { router } from "@unifiedcommerce/core";
+import { z } from "@hono/zod-openapi";
+export function buildLookupRoutes(service, ctx) {
+    const r = router("POS Lookup", "/pos/lookup", ctx);
+    r.get("/barcode/{code}")
+        .summary("Lookup by barcode")
+        .permission("pos:operate")
+        .handler(async ({ params, orgId }) => {
+        const result = await service.byBarcode(orgId, params.code);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.get("/sku/{sku}")
+        .summary("Lookup by SKU")
+        .permission("pos:operate")
+        .handler(async ({ params, orgId }) => {
+        const result = await service.bySku(orgId, params.sku);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.get("/search")
+        .summary("Search items")
+        .permission("pos:operate")
+        .query(z.object({
+        q: z.string().min(1).max(200),
+    }))
+        .handler(async ({ query, orgId }) => {
+        const q = query;
+        const result = await service.search(orgId, q.q);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    return r.routes();
+}

package/dist/routes/payments.d.ts

@@ -0,0 +1,10 @@
+import type { PaymentService } from "../services/payment-service";
+import type { TransactionService } from "../services/transaction-service";
+import type { PluginRouteRegistration } from "@unifiedcommerce/core";
+export declare function buildPaymentRoutes(paymentService: PaymentService, transactionService: TransactionService, ctx: {
+    services?: Record<string, unknown>;
+    database?: {
+        db: unknown;
+    };
+}): PluginRouteRegistration[];
+//# sourceMappingURL=payments.d.ts.map

package/dist/routes/payments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments.d.ts","sourceRoot":"","sources":["../../src/routes/payments.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE,wBAAgB,kBAAkB,CAChC,cAAc,EAAE,cAAc,EAC9B,kBAAkB,EAAE,kBAAkB,EACtC,GAAG,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GACtE,uBAAuB,EAAE,CAuE3B"}

package/dist/routes/payments.js

@@ -0,0 +1,62 @@
+import { router } from "@unifiedcommerce/core";
+import { z } from "@hono/zod-openapi";
+export function buildPaymentRoutes(paymentService, transactionService, ctx) {
+    const r = router("POS Payments", "/pos/transactions", ctx);
+    r.post("/{id}/payments")
+        .summary("Add payment")
+        .permission("pos:operate")
+        .input(z.object({
+        method: z.enum(["cash", "card", "gift_card", "store_credit", "other"]),
+        amount: z.number().int().positive(),
+        changeGiven: z.number().int().min(0).optional(),
+        reference: z.string().max(200).optional(),
+        metadata: z.record(z.string(), z.unknown()).optional(),
+    }))
+        .handler(async ({ params, input, orgId }) => {
+        const body = input;
+        const result = await paymentService.addPayment(orgId, params.id, body);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.post("/{id}/complete")
+        .summary("Complete transaction")
+        .description("Validates total payments >= total, then calls checkout pipeline.")
+        .permission("pos:operate")
+        .handler(async ({ params, services, orgId }) => {
+        // Validate payments cover the total
+        const validation = await paymentService.validateForCompletion(orgId, params.id);
+        if (!validation.ok)
+            throw new Error(validation.error);
+        const { transaction } = validation.value;
+        // Call checkout pipeline via the checkout service
+        // The POS payment adapter handles the payment side
+        const checkout = services;
+        // Build checkout request — POS goes through the same pipeline as online
+        const checkoutBody = {
+            cartId: transaction.cartId,
+            currency: "USD",
+            paymentMethodId: "pos",
+            metadata: {
+                posTransactionId: transaction.id,
+                posShiftId: transaction.shiftId,
+                posTerminalId: transaction.terminalId,
+            },
+            ...(transaction.customerId != null ? { customerId: transaction.customerId } : {}),
+        };
+        // We need to make an internal call to the checkout pipeline
+        // This is handled by POSCheckoutAdapter in hooks/checkout-pos.ts
+        // For now, return the transaction with payment status
+        // The plugin entry point wires the checkout hook
+        // Mark transaction as completed (the afterCreate hook will set orderId)
+        const result = await transactionService.complete(params.id, null);
+        if (!result.ok)
+            throw new Error(result.error);
+        return {
+            transaction: result.value,
+            checkoutRequest: checkoutBody,
+            message: "Transaction completed. Use POST /api/checkout with the checkoutRequest body to finalize.",
+        };
+    });
+    return r.routes();
+}

package/dist/routes/receipts.d.ts

@@ -0,0 +1,9 @@
+import type { ReceiptService } from "../services/receipt-service";
+import type { PluginRouteRegistration } from "@unifiedcommerce/core";
+export declare function buildReceiptRoutes(service: ReceiptService, ctx: {
+    services?: Record<string, unknown>;
+    database?: {
+        db: unknown;
+    };
+}): PluginRouteRegistration[];
+//# sourceMappingURL=receipts.d.ts.map

package/dist/routes/receipts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipts.d.ts","sourceRoot":"","sources":["../../src/routes/receipts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GACtE,uBAAuB,EAAE,CA0B3B"}

package/dist/routes/receipts.js

@@ -0,0 +1,28 @@
+import { router } from "@unifiedcommerce/core";
+import { z } from "@hono/zod-openapi";
+export function buildReceiptRoutes(service, ctx) {
+    const r = router("POS Receipts", "/pos/transactions", ctx);
+    r.get("/{id}/receipt")
+        .summary("Get receipt")
+        .permission("pos:operate")
+        .handler(async ({ params, orgId }) => {
+        const result = await service.getReceipt(orgId, params.id);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.post("/{id}/receipt/email")
+        .summary("Email receipt")
+        .permission("pos:operate")
+        .input(z.object({
+        email: z.string().email(),
+    }))
+        .handler(async ({ params, input, orgId }) => {
+        const body = input;
+        const result = await service.emailReceipt(orgId, params.id, body.email);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    return r.routes();
+}

package/dist/routes/returns.d.ts

@@ -0,0 +1,21 @@
+import type { ReturnService } from "../services/return-service";
+import type { TransactionService } from "../services/transaction-service";
+import type { PaymentService } from "../services/payment-service";
+import type { PluginRouteRegistration } from "@unifiedcommerce/core";
+export declare function buildReturnRoutes(returnService: ReturnService, transactionService: TransactionService, paymentService: PaymentService, cartService: {
+    create: (input: {
+        currency?: string;
+        metadata?: Record<string, unknown>;
+    }, actor: unknown) => Promise<{
+        ok: boolean;
+        value?: {
+            id: string;
+        };
+    }>;
+}, ctx: {
+    services?: Record<string, unknown>;
+    database?: {
+        db: unknown;
+    };
+}): PluginRouteRegistration[];
+//# sourceMappingURL=returns.d.ts.map

package/dist/routes/returns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"returns.d.ts","sourceRoot":"","sources":["../../src/routes/returns.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,aAAa,EAC5B,kBAAkB,EAAE,kBAAkB,EACtC,cAAc,EAAE,cAAc,EAC9B,WAAW,EAAE;IAAE,MAAM,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAA;CAAE,EAC/J,GAAG,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GACtE,uBAAuB,EAAE,CAsG3B"}

package/dist/routes/returns.js

@@ -0,0 +1,83 @@
+import { router } from "@unifiedcommerce/core";
+import { z } from "@hono/zod-openapi";
+export function buildReturnRoutes(returnService, transactionService, paymentService, cartService, ctx) {
+    const r = router("POS Returns", "/pos/returns", ctx);
+    r.post("/")
+        .summary("Create return")
+        .permission("pos:manage")
+        .input(z.object({
+        shiftId: z.string().uuid(),
+        terminalId: z.string().uuid(),
+        originalOrderId: z.string().uuid(),
+        items: z.array(z.object({
+            originalLineItemId: z.string().uuid(),
+            quantity: z.number().int().positive(),
+            reason: z.enum(["defective", "wrong_item", "changed_mind", "other"]),
+            restockingFee: z.number().int().min(0).optional(),
+            refundAmount: z.number().int().positive(),
+        })).min(1),
+    }))
+        .handler(async ({ input, actor, orgId }) => {
+        const body = input;
+        // Create a cart for the return transaction
+        const cartResult = await cartService.create({ currency: "USD", metadata: { posReturn: true } }, actor);
+        if (!cartResult.ok || !cartResult.value) {
+            throw new Error("Failed to create cart for return");
+        }
+        // Create return transaction
+        const txnResult = await transactionService.create(orgId, {
+            shiftId: body.shiftId,
+            terminalId: body.terminalId,
+            operatorId: actor.userId,
+            cartId: cartResult.value.id,
+            type: "return",
+        });
+        if (!txnResult.ok)
+            throw new Error(txnResult.error);
+        // Record return items
+        const itemsResult = await returnService.addReturnItems(txnResult.value.id, body.items.map((item) => ({
+            ...item,
+            originalOrderId: body.originalOrderId,
+        })));
+        if (!itemsResult.ok)
+            throw new Error(itemsResult.error);
+        // Update transaction totals
+        const refundTotal = body.items.reduce((sum, i) => sum + i.refundAmount, 0);
+        await transactionService.updateTotals(txnResult.value.id, {
+            subtotal: refundTotal,
+            taxTotal: 0,
+            total: refundTotal,
+            discountTotal: 0,
+        });
+        return {
+            transaction: txnResult.value,
+            returnItems: itemsResult.value,
+            refundTotal,
+        };
+    });
+    r.post("/{id}/payments")
+        .summary("Add refund payment")
+        .permission("pos:operate")
+        .input(z.object({
+        method: z.enum(["cash", "card", "gift_card", "store_credit", "other"]),
+        amount: z.number().int().positive(),
+        reference: z.string().max(200).optional(),
+    }))
+        .handler(async ({ params, input, orgId }) => {
+        const body = input;
+        const result = await paymentService.addPayment(orgId, params.id, body);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.post("/{id}/complete")
+        .summary("Complete return")
+        .permission("pos:operate")
+        .handler(async ({ params, actor }) => {
+        const result = await transactionService.complete(params.id, null);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    return r.routes();
+}

package/dist/routes/shifts.d.ts

@@ -0,0 +1,9 @@
+import type { ShiftService } from "../services/shift-service";
+import type { PluginRouteRegistration } from "@unifiedcommerce/core";
+export declare function buildShiftRoutes(service: ShiftService, ctx: {
+    services?: Record<string, unknown>;
+    database?: {
+        db: unknown;
+    };
+}): PluginRouteRegistration[];
+//# sourceMappingURL=shifts.d.ts.map

package/dist/routes/shifts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shifts.d.ts","sourceRoot":"","sources":["../../src/routes/shifts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GACtE,uBAAuB,EAAE,CA2F3B"}