@porulle/plugin-pos-restaurant 0.1.0

package/dist/routes/modifiers.js

@@ -0,0 +1,117 @@
+import { router } from "@porulle/core";
+import { z } from "@hono/zod-openapi";
+export function buildModifierRoutes(service, ctx) {
+    const r = router("POS Restaurant Modifiers", "/pos/restaurant/modifier-groups", ctx);
+    r.post("/")
+        .summary("Create modifier group")
+        .permission("pos-restaurant:admin")
+        .input(z.object({
+        name: z.string().min(1).max(200),
+        entityId: z.string().uuid().optional(),
+        itemGroup: z.string().optional(),
+        isRequired: z.boolean().optional(),
+        minSelect: z.number().int().min(0).optional(),
+        maxSelect: z.number().int().min(1).optional(),
+        sortOrder: z.number().int().optional(),
+    }))
+        .handler(async ({ input, orgId }) => {
+        const body = input;
+        const result = await service.createGroup(orgId, body);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.get("/")
+        .summary("List modifier groups")
+        .permission("pos:operate")
+        .query(z.object({ entityId: z.string().uuid().optional() }))
+        .handler(async ({ query, orgId }) => {
+        const q = query;
+        const result = await service.listGroups(orgId, q.entityId);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.get("/{id}")
+        .summary("Get modifier group with options")
+        .permission("pos:operate")
+        .handler(async ({ params, orgId }) => {
+        const result = await service.getGroupWithOptions(orgId, params.id);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.patch("/{id}")
+        .summary("Update modifier group")
+        .permission("pos-restaurant:admin")
+        .input(z.object({
+        name: z.string().min(1).max(200).optional(),
+        isRequired: z.boolean().optional(),
+        minSelect: z.number().int().min(0).optional(),
+        maxSelect: z.number().int().min(1).optional(),
+        sortOrder: z.number().int().optional(),
+    }))
+        .handler(async ({ params, input, orgId }) => {
+        const body = input;
+        const result = await service.updateGroup(orgId, params.id, body);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.delete("/{id}")
+        .summary("Delete modifier group")
+        .permission("pos-restaurant:admin")
+        .handler(async ({ params, orgId }) => {
+        const result = await service.deleteGroup(orgId, params.id);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.post("/{id}/options")
+        .summary("Add modifier option")
+        .permission("pos-restaurant:admin")
+        .input(z.object({
+        name: z.string().min(1).max(200),
+        priceAdjustment: z.number().int().optional(),
+        isDefault: z.boolean().optional(),
+        sortOrder: z.number().int().optional(),
+    }))
+        .handler(async ({ params, input }) => {
+        const body = input;
+        const result = await service.addOption(params.id, body);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    return r.routes();
+}
+export function buildModifierOptionRoutes(service, ctx) {
+    const r = router("POS Restaurant Modifier Options", "/pos/restaurant/modifier-options", ctx);
+    r.patch("/{id}")
+        .summary("Update modifier option")
+        .permission("pos-restaurant:admin")
+        .input(z.object({
+        name: z.string().min(1).max(200).optional(),
+        priceAdjustment: z.number().int().optional(),
+        isDefault: z.boolean().optional(),
+        isAvailable: z.boolean().optional(),
+        sortOrder: z.number().int().optional(),
+    }))
+        .handler(async ({ params, input }) => {
+        const body = input;
+        const result = await service.updateOption(params.id, body);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.delete("/{id}")
+        .summary("Delete modifier option")
+        .permission("pos-restaurant:admin")
+        .handler(async ({ params }) => {
+        const result = await service.deleteOption(params.id);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    return r.routes();
+}

package/dist/routes/operations.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Operational routes: checklists, alerts, recipes, combos, menu availability,
+ * analytics, customer favorites.
+ */
+import type { ChecklistService } from "../services/checklist-service.js";
+import type { AlertService } from "../services/alert-service.js";
+import type { RecipeService } from "../services/recipe-service.js";
+import type { RestaurantAnalyticsService } from "../services/analytics-service.js";
+import type { PluginRouteRegistration } from "@porulle/core";
+export declare function buildChecklistRoutes(service: ChecklistService, ctx: {
+    services?: Record<string, unknown>;
+    database?: {
+        db: unknown;
+    };
+}): PluginRouteRegistration[];
+export declare function buildAlertRoutes(service: AlertService, ctx: {
+    services?: Record<string, unknown>;
+    database?: {
+        db: unknown;
+    };
+}): PluginRouteRegistration[];
+export declare function buildRecipeRoutes(service: RecipeService, ctx: {
+    services?: Record<string, unknown>;
+    database?: {
+        db: unknown;
+    };
+}): PluginRouteRegistration[];
+export declare function buildAnalyticsRoutes(service: RestaurantAnalyticsService, ctx: {
+    services?: Record<string, unknown>;
+    database?: {
+        db: unknown;
+    };
+}): PluginRouteRegistration[];
+//# sourceMappingURL=operations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/routes/operations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAE7D,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,gBAAgB,EACzB,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,CA+D3B;AAED,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,CA+D3B;AAED,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,CA2C3B;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,0BAA0B,EACnC,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,CA2E3B"}

package/dist/routes/operations.js

@@ -0,0 +1,249 @@
+/**
+ * Operational routes: checklists, alerts, recipes, combos, menu availability,
+ * analytics, customer favorites.
+ */
+import { router } from "@porulle/core";
+import { z } from "@hono/zod-openapi";
+export function buildChecklistRoutes(service, ctx) {
+    const r = router("POS Restaurant Checklists", "/pos/restaurant/checklists", ctx);
+    r.post("/")
+        .summary("Create checklist")
+        .permission("pos-restaurant:admin")
+        .input(z.object({
+        name: z.string().min(1),
+        type: z.enum(["pre_billing", "shift_open", "shift_close"]),
+        items: z.array(z.object({ label: z.string().min(1), isRequired: z.boolean().optional() })).min(1),
+    }))
+        .handler(async ({ input, orgId }) => {
+        const body = input;
+        const result = await service.createChecklist(orgId, body);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.get("/")
+        .summary("List checklists")
+        .permission("pos:operate")
+        .query(z.object({ type: z.enum(["pre_billing", "shift_open", "shift_close"]).optional() }))
+        .handler(async ({ query, orgId }) => {
+        const q = query;
+        const result = await service.listChecklists(orgId, q.type);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.get("/{id}")
+        .summary("Get checklist with items")
+        .permission("pos:operate")
+        .handler(async ({ params, orgId }) => {
+        const result = await service.getChecklistWithItems(params.id, orgId);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.post("/{id}/complete")
+        .summary("Complete a checklist")
+        .permission("pos:operate")
+        .input(z.object({
+        referenceType: z.enum(["transaction", "shift"]),
+        referenceId: z.string().uuid(),
+        completedItems: z.array(z.object({
+            itemId: z.string().uuid(),
+            checked: z.boolean(),
+            note: z.string().optional(),
+        })),
+    }))
+        .handler(async ({ params, input, actor }) => {
+        const body = input;
+        const result = await service.completeChecklist({
+            checklistId: params.id,
+            ...body,
+            operatorId: actor.userId,
+        });
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    return r.routes();
+}
+export function buildAlertRoutes(service, ctx) {
+    const r = router("POS Restaurant Alerts", "/pos/restaurant/alerts", ctx);
+    r.get("/")
+        .summary("List active alerts")
+        .permission("pos:operate")
+        .query(z.object({
+        type: z.string().optional(),
+        unresolvedOnly: z.string().optional(),
+    }))
+        .handler(async ({ query, orgId }) => {
+        const q = query;
+        const result = await service.listAlerts(orgId, {
+            type: q.type,
+            unresolvedOnly: q.unresolvedOnly === "true",
+        });
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.post("/detect")
+        .summary("Run alert detection scan")
+        .permission("pos-restaurant:admin")
+        .handler(async ({ orgId }) => {
+        const result = await service.runAllDetections(orgId);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.post("/{id}/resolve")
+        .summary("Resolve an alert")
+        .permission("pos:operate")
+        .handler(async ({ params, actor }) => {
+        const result = await service.resolveAlert(params.id, actor.userId);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.post("/config")
+        .summary("Set alert threshold")
+        .permission("pos-restaurant:admin")
+        .input(z.object({
+        alertType: z.string().min(1),
+        thresholdMinutes: z.number().int().min(1),
+        notifyRoles: z.array(z.string()).optional(),
+    }))
+        .handler(async ({ input, orgId }) => {
+        const body = input;
+        const result = await service.setThreshold(orgId, body.alertType, body.thresholdMinutes, body.notifyRoles);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.get("/config")
+        .summary("Get alert configuration")
+        .permission("pos-restaurant:admin")
+        .handler(async ({ orgId }) => {
+        const result = await service.getConfig(orgId);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    return r.routes();
+}
+export function buildRecipeRoutes(service, ctx) {
+    const r = router("POS Restaurant Recipes", "/pos/restaurant/recipes", ctx);
+    r.post("/")
+        .summary("Create recipe (BOM)")
+        .permission("pos-restaurant:admin")
+        .input(z.object({
+        entityId: z.string().uuid(),
+        name: z.string().min(1),
+        yieldQuantity: z.number().int().min(1).optional(),
+        ingredients: z.array(z.object({
+            ingredientName: z.string().min(1),
+            quantity: z.number().int().positive(),
+            unit: z.string().min(1),
+            costPerUnit: z.number().int().min(0),
+        })).min(1),
+    }))
+        .handler(async ({ input, orgId }) => {
+        const body = input;
+        const result = await service.createRecipe(orgId, body);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.get("/")
+        .summary("List recipes")
+        .permission("pos-restaurant:admin")
+        .handler(async ({ orgId }) => {
+        const result = await service.listRecipes(orgId);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.get("/{id}")
+        .summary("Get recipe with ingredients")
+        .permission("pos-restaurant:admin")
+        .handler(async ({ params }) => {
+        const result = await service.getRecipeWithIngredients(params.id);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    return r.routes();
+}
+export function buildAnalyticsRoutes(service, ctx) {
+    const r = router("POS Restaurant Analytics", "/pos/restaurant/analytics", ctx);
+    r.post("/daily-pnl")
+        .summary("Create daily P&L")
+        .permission("pos-restaurant:admin")
+        .input(z.object({
+        date: z.string(),
+        grossSales: z.number().int(),
+        netSales: z.number().int(),
+        costOfGoods: z.number().int(),
+        directExpenses: z.number().int(),
+        indirectExpenses: z.number().int(),
+        employeeCosts: z.number().int(),
+        transactionCount: z.number().int(),
+        expenses: z.array(z.object({
+            category: z.enum(["cogs", "direct", "indirect", "employee"]),
+            name: z.string(),
+            amount: z.number().int(),
+            percentage: z.number().int().optional(),
+        })).optional(),
+    }))
+        .handler(async ({ input, orgId }) => {
+        const body = input;
+        const result = await service.createDailyPnl(orgId, {
+            ...body,
+            date: new Date(body.date),
+        });
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.get("/daily-pnl")
+        .summary("List daily P&L records")
+        .permission("pos-restaurant:admin")
+        .handler(async ({ orgId }) => {
+        const result = await service.listDailyPnl(orgId);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.get("/station-performance/{id}")
+        .summary("Station performance metrics")
+        .permission("pos-restaurant:admin")
+        .query(z.object({ from: z.string(), to: z.string() }))
+        .handler(async ({ params, query, orgId }) => {
+        const q = query;
+        const result = await service.getStationPerformance(orgId, params.id, new Date(q.from), new Date(q.to));
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.get("/course-performance")
+        .summary("Course-wise performance")
+        .permission("pos-restaurant:admin")
+        .query(z.object({ from: z.string(), to: z.string() }))
+        .handler(async ({ query, orgId }) => {
+        const q = query;
+        const result = await service.getCoursePerformance(orgId, new Date(q.from), new Date(q.to));
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.get("/operator-performance")
+        .summary("Staff/captain performance")
+        .permission("pos-restaurant:admin")
+        .query(z.object({ from: z.string(), to: z.string() }))
+        .handler(async ({ query, orgId }) => {
+        const q = query;
+        const result = await service.getOperatorPerformance(orgId, new Date(q.from), new Date(q.to));
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    return r.routes();
+}

package/dist/routes/tables.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../../src/routes/tables.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAE7D,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,CA4G3B"}

package/dist/routes/tables.js

@@ -0,0 +1,110 @@
+import { router } from "@porulle/core";
+import { z } from "@hono/zod-openapi";
+export function buildTableRoutes(service, ctx) {
+    const r = router("POS Restaurant Tables", "/pos/restaurant/tables", ctx);
+    r.post("/")
+        .summary("Create table")
+        .permission("pos-restaurant:admin")
+        .input(z.object({
+        number: z.string().min(1).max(50),
+        zone: z.string().min(1).max(100),
+        capacity: z.number().int().min(1).max(100).optional(),
+        minimumSeats: z.number().int().min(1).optional(),
+        shape: z.enum(["rectangle", "square", "circle"]).optional(),
+        isTakeaway: z.boolean().optional(),
+        layoutX: z.number().int().optional(),
+        layoutY: z.number().int().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("/zones")
+        .summary("List zones with table counts")
+        .permission("pos:operate")
+        .handler(async ({ orgId }) => {
+        const result = await service.listZones(orgId);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.get("/")
+        .summary("List tables")
+        .permission("pos:operate")
+        .query(z.object({ zone: z.string().optional() }))
+        .handler(async ({ query, orgId }) => {
+        const q = query;
+        const result = await service.list(orgId, q.zone);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.patch("/{id}")
+        .summary("Update table")
+        .permission("pos-restaurant:admin")
+        .input(z.object({
+        number: z.string().min(1).max(50).optional(),
+        zone: z.string().min(1).max(100).optional(),
+        capacity: z.number().int().min(1).optional(),
+        shape: z.enum(["rectangle", "square", "circle"]).optional(),
+        assignedOperatorId: z.string().nullable().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.post("/{id}/assign")
+        .summary("Assign table to transaction")
+        .permission("pos:operate")
+        .input(z.object({ transactionId: z.string().uuid() }))
+        .handler(async ({ params, input, orgId }) => {
+        const body = input;
+        const result = await service.assignToTransaction(orgId, params.id, body.transactionId);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.post("/{id}/clear")
+        .summary("Clear table")
+        .permission("pos:operate")
+        .handler(async ({ params, orgId }) => {
+        const result = await service.clear(orgId, params.id);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.post("/{id}/transfer")
+        .summary("Transfer to another table")
+        .permission("pos:operate")
+        .input(z.object({ toTableId: z.string().uuid() }))
+        .handler(async ({ params, input, orgId }) => {
+        const body = input;
+        const result = await service.transfer(orgId, params.id, body.toTableId);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    r.patch("/{id}/layout")
+        .summary("Update floor plan layout")
+        .permission("pos-restaurant:admin")
+        .input(z.object({
+        layoutX: z.number().int().optional(),
+        layoutY: z.number().int().optional(),
+        layoutWidth: z.number().int().optional(),
+        layoutHeight: z.number().int().optional(),
+    }))
+        .handler(async ({ params, input, orgId }) => {
+        const body = input;
+        const result = await service.updateLayout(orgId, params.id, body);
+        if (!result.ok)
+            throw new Error(result.error);
+        return result.value;
+    });
+    return r.routes();
+}