@unifiedcommerce/plugin-pos 0.0.1

package/dist/routes/shifts.js

@@ -0,0 +1,91 @@
+import { router } from "@unifiedcommerce/core";
+import { z } from "@hono/zod-openapi";
+export function buildShiftRoutes(service, ctx) {
+    const r = router("POS Shifts", "/pos/shifts", ctx);
+    r.post("/open")
+        .summary("Open shift")
+        .permission("pos:operate")
+        .input(z.object({
+        terminalId: z.string().uuid(),
+        openingFloat: z.number().int().min(0),
+    }))
+        .handler(async ({ input, actor, orgId }) => {
+        const body = input;
+        const result = await service.open(orgId, {
+            ...body,
+            operatorId: actor.userId,
+        });
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.post("/{id}/close")
+        .summary("Close shift")
+        .permission("pos:operate")
+        .input(z.object({
+        closingCount: z.number().int().min(0),
+    }))
+        .handler(async ({ params, input, orgId }) => {
+        const body = input;
+        const result = await service.close(orgId, params.id, body);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.get("/current")
+        .summary("Get current open shift")
+        .permission("pos:operate")
+        .handler(async ({ actor, orgId }) => {
+        const result = await service.getCurrent(orgId, actor.userId);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.get("/{id}")
+        .summary("Get shift details")
+        .permission("pos:operate")
+        .handler(async ({ params, orgId }) => {
+        const result = await service.getById(orgId, params.id);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.get("/{id}/report")
+        .summary("Z-report")
+        .permission("pos:admin")
+        .handler(async ({ params, orgId }) => {
+        const result = await service.getReport(orgId, params.id);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    // ─── Cash Events ───────────────────────────────────────────────────
+    r.post("/{id}/cash-events")
+        .summary("Record cash event")
+        .permission("pos:operate")
+        .input(z.object({
+        type: z.enum(["drop", "pickup", "paid_in", "paid_out"]),
+        amount: z.number().int().positive(),
+        reason: z.string().max(500).optional(),
+    }))
+        .handler(async ({ params, input, actor }) => {
+        const body = input;
+        const result = await service.addCashEvent(params.id, {
+            ...body,
+            performedBy: actor.userId,
+        });
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.get("/{id}/cash-events")
+        .summary("List cash events")
+        .permission("pos:operate")
+        .handler(async ({ params }) => {
+        const result = await service.listCashEvents(params.id);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    return r.routes();
+}

package/dist/routes/terminals.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"terminals.d.ts","sourceRoot":"","sources":["../../src/routes/terminals.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,eAAe,EACxB,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,CAqD3B"}

package/dist/routes/terminals.js

@@ -0,0 +1,55 @@
+import { router } from "@unifiedcommerce/core";
+import { z } from "@hono/zod-openapi";
+export function buildTerminalRoutes(service, ctx) {
+    const r = router("POS Terminals", "/pos/terminals", ctx);
+    r.post("/")
+        .summary("Register terminal")
+        .permission("pos:admin")
+        .input(z.object({
+        name: z.string().min(1).max(100),
+        code: z.string().min(1).max(20),
+        type: z.enum(["register", "tablet", "mobile", "kiosk"]).optional(),
+        metadata: z.record(z.string(), z.unknown()).optional(),
+    }))
+        .handler(async ({ input, orgId }) => {
+        const body = input;
+        const result = await service.create(orgId, body);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.get("/")
+        .summary("List terminals")
+        .permission("pos:admin")
+        .handler(async ({ orgId }) => {
+        const result = await service.list(orgId);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.patch("/{id}")
+        .summary("Update terminal")
+        .permission("pos:admin")
+        .input(z.object({
+        name: z.string().min(1).max(100).optional(),
+        isActive: z.boolean().optional(),
+        metadata: z.record(z.string(), z.unknown()).optional(),
+    }))
+        .handler(async ({ params, input, orgId }) => {
+        const body = input;
+        const result = await service.update(orgId, params.id, body);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.delete("/{id}")
+        .summary("Deactivate terminal")
+        .permission("pos:admin")
+        .handler(async ({ params, orgId }) => {
+        const result = await service.deactivate(orgId, params.id);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    return r.routes();
+}

package/dist/routes/transactions.d.ts

@@ -0,0 +1,19 @@
+import type { TransactionService } from "../services/transaction-service";
+import type { PluginRouteRegistration } from "@unifiedcommerce/core";
+export declare function buildTransactionRoutes(service: TransactionService, 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=transactions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.d.ts","sourceRoot":"","sources":["../../src/routes/transactions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,kBAAkB,EAC3B,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,CAsL3B"}

package/dist/routes/transactions.js

@@ -0,0 +1,175 @@
+import { router } from "@unifiedcommerce/core";
+import { z } from "@hono/zod-openapi";
+export function buildTransactionRoutes(service, cartService, ctx) {
+    const r = router("POS Transactions", "/pos/transactions", ctx);
+    r.post("/")
+        .summary("Start transaction")
+        .permission("pos:operate")
+        .input(z.object({
+        shiftId: z.string().uuid(),
+        terminalId: z.string().uuid(),
+        type: z.enum(["sale", "return", "exchange"]).optional(),
+        customerId: z.string().uuid().optional(),
+        currency: z.string().min(3).max(3).optional(),
+    }))
+        .handler(async ({ input, actor, orgId }) => {
+        const body = input;
+        // Create a cart for this transaction
+        const cartResult = await cartService.create({ currency: body.currency ?? "USD", metadata: { posTransaction: true } }, actor);
+        if (!cartResult.ok || !cartResult.value) {
+            throw new Error("Failed to create cart for POS transaction");
+        }
+        const result = await service.create(orgId, {
+            shiftId: body.shiftId,
+            terminalId: body.terminalId,
+            operatorId: actor.userId,
+            cartId: cartResult.value.id,
+            ...(body.type != null ? { type: body.type } : {}),
+            ...(body.customerId != null ? { customerId: body.customerId } : {}),
+        });
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    // NOTE: /held must be registered BEFORE /{id} to avoid UUID validation catching "held"
+    r.get("/held")
+        .summary("List held transactions")
+        .permission("pos:operate")
+        .query(z.object({
+        terminalId: z.string().uuid(),
+    }))
+        .handler(async ({ query, orgId }) => {
+        const q = query;
+        const result = await service.listHeld(orgId, q.terminalId);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.get("/{id}")
+        .summary("Get transaction")
+        .permission("pos:operate")
+        .handler(async ({ params, orgId }) => {
+        const result = await service.getById(orgId, params.id);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.post("/{id}/items")
+        .summary("Add item to transaction")
+        .permission("pos:operate")
+        .input(z.object({
+        entityId: z.string().uuid(),
+        variantId: z.string().uuid().optional(),
+        quantity: z.number().int().min(1).max(9999).optional(),
+        notes: z.string().max(500).optional(),
+    }))
+        .handler(async ({ params, input, actor, services, orgId }) => {
+        const body = input;
+        const txnResult = await service.getById(orgId, params.id);
+        if (!txnResult.ok)
+            throw new Error(txnResult.error);
+        if (txnResult.value.status !== "open")
+            throw new Error("Transaction is not open");
+        // Delegate to cart service
+        const cart = services.cart;
+        const addResult = await cart.addItem({
+            cartId: txnResult.value.cartId,
+            entityId: body.entityId,
+            variantId: body.variantId,
+            quantity: body.quantity ?? 1,
+            notes: body.notes,
+        }, actor);
+        if (!addResult.ok)
+            throw new Error("Failed to add item");
+        return addResult.value;
+    });
+    r.patch("/{id}/items/{itemId}")
+        .summary("Update line item")
+        .permission("pos:operate")
+        .input(z.object({
+        quantity: z.number().int().min(1).max(9999).optional(),
+        notes: z.string().max(500).optional(),
+    }))
+        .handler(async ({ params, input, actor, services, orgId }) => {
+        const body = input;
+        const txnResult = await service.getById(orgId, params.id);
+        if (!txnResult.ok)
+            throw new Error(txnResult.error);
+        if (txnResult.value.status !== "open")
+            throw new Error("Transaction is not open");
+        const cart = services.cart;
+        if (body.quantity != null) {
+            const updateResult = await cart.updateQuantity({
+                cartId: txnResult.value.cartId,
+                itemId: params.itemId,
+                quantity: body.quantity,
+            }, actor);
+            if (!updateResult.ok)
+                throw new Error("Failed to update item");
+            return updateResult.value;
+        }
+        return { updated: true };
+    });
+    r.delete("/{id}/items/{itemId}")
+        .summary("Remove line item")
+        .permission("pos:operate")
+        .handler(async ({ params, actor, services, orgId }) => {
+        const txnResult = await service.getById(orgId, params.id);
+        if (!txnResult.ok)
+            throw new Error(txnResult.error);
+        if (txnResult.value.status !== "open")
+            throw new Error("Transaction is not open");
+        const cart = services.cart;
+        await cart.removeItem(txnResult.value.cartId, params.itemId, actor);
+        return { removed: true };
+    });
+    r.post("/{id}/customer")
+        .summary("Associate customer")
+        .permission("pos:operate")
+        .input(z.object({
+        customerId: z.string().uuid(),
+    }))
+        .handler(async ({ params, input, orgId }) => {
+        const body = input;
+        const result = await service.setCustomer(orgId, params.id, body.customerId);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.post("/{id}/hold")
+        .summary("Hold transaction")
+        .permission("pos:operate")
+        .input(z.object({
+        label: z.string().min(1).max(200),
+    }))
+        .handler(async ({ params, input, orgId }) => {
+        const body = input;
+        const result = await service.hold(orgId, params.id, body.label);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.post("/{id}/recall")
+        .summary("Recall held transaction")
+        .permission("pos:operate")
+        .handler(async ({ params, orgId }) => {
+        const result = await service.recall(orgId, params.id);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.post("/{id}/void")
+        .summary("Void transaction")
+        .permission("pos:manage")
+        .input(z.object({
+        reason: z.string().min(1).max(500),
+    }))
+        .handler(async ({ params, input, orgId }) => {
+        const body = input;
+        const result = await service.void(orgId, params.id, body.reason);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    return r.routes();
+}