@porulle/plugin-pos-restaurant 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"kds-service.d.ts","sourceRoot":"","sources":["../../src/services/kds-service.ts"],"names":[],"mappings":"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"}

package/dist/services/kds-service.js

@@ -0,0 +1,246 @@
+/**
+ * KDSService — Kitchen Display System station management, ticket generation,
+ * and status tracking.
+ *
+ * Informed by URY's KOT system:
+ * - URY Production Unit: item-group-based routing, per-station printers
+ * - URY KOT: submittable ticket per production unit, type enum, order_status,
+ *   production_time tracking, Socket.IO broadcasting
+ * - URY KOT Items: course (Menu Course link), serve_priority, indicate_course,
+ *   cancelled_qty
+ * - kot_execute(): compares previous vs current items, generates New Order,
+ *   Order Modified, Partially cancelled KOTs per production unit
+ * - multi_print_kot(): production printer > room printer > POS printer cascade
+ *
+ * Improvements over URY:
+ * - Item-level status persisted to DB (not browser localStorage)
+ * - 4-state ticket status (pending -> preparing -> ready -> served)
+ *   instead of URY's 2-state (Ready For Prepare -> Served)
+ * - prep_duration_seconds calculated and stored for analytics
+ * - Structured course priority on ticket items (not just display ordering)
+ */
+import { eq, and, sql } from "@porulle/core/drizzle";
+import { kdsStations, kdsStationItemGroups, kdsTickets, kdsTicketItems, } from "../schema.js";
+import { Ok, Err } from "@porulle/core";
+export class KDSService {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    // ─── Station CRUD ──────────────────────────────────────────────────
+    async createStation(orgId, input) {
+        const existing = await this.db
+            .select()
+            .from(kdsStations)
+            .where(and(eq(kdsStations.organizationId, orgId), eq(kdsStations.name, input.name)));
+        if (existing.length > 0)
+            return Err(`Station '${input.name}' already exists`);
+        const rows = await this.db
+            .insert(kdsStations)
+            .values({
+            organizationId: orgId,
+            name: input.name,
+            alertThresholdMinutes: input.alertThresholdMinutes ?? 15,
+            metadata: input.metadata ?? {},
+        })
+            .returning();
+        return Ok(rows[0]);
+    }
+    async listStations(orgId) {
+        const rows = await this.db
+            .select()
+            .from(kdsStations)
+            .where(eq(kdsStations.organizationId, orgId));
+        return Ok(rows);
+    }
+    async updateStation(orgId, id, input) {
+        const rows = await this.db
+            .update(kdsStations)
+            .set({ ...input, updatedAt: new Date() })
+            .where(and(eq(kdsStations.id, id), eq(kdsStations.organizationId, orgId)))
+            .returning();
+        if (rows.length === 0)
+            return Err("Station not found");
+        return Ok(rows[0]);
+    }
+    // ─── Station Item Groups ──────────────────────────────────────────
+    // URY equivalent: URY Production Item Groups child table.
+    async addItemGroup(stationId, itemGroup) {
+        const rows = await this.db
+            .insert(kdsStationItemGroups)
+            .values({ stationId, itemGroup })
+            .returning();
+        return Ok(rows[0]);
+    }
+    async removeItemGroup(stationId, itemGroup) {
+        const rows = await this.db
+            .delete(kdsStationItemGroups)
+            .where(and(eq(kdsStationItemGroups.stationId, stationId), eq(kdsStationItemGroups.itemGroup, itemGroup)))
+            .returning();
+        if (rows.length === 0)
+            return Err("Item group not found on station");
+        return Ok({ removed: true });
+    }
+    async getStationItemGroups(stationId) {
+        const rows = await this.db
+            .select({ itemGroup: kdsStationItemGroups.itemGroup })
+            .from(kdsStationItemGroups)
+            .where(eq(kdsStationItemGroups.stationId, stationId));
+        return rows.map((r) => r.itemGroup);
+    }
+    // ─── Ticket Generation ─────────────────────────────────────────────
+    // URY equivalent: kot_execute() + process_items_for_kot() + create_kot_doc().
+    //
+    // For each station, filter items matching station's item groups.
+    // If matching items exist, create a ticket for that station.
+    // If a ticket already exists for this transaction+station, set type="modified".
+    async generateTickets(orgId, input) {
+        // Get all active stations with their item groups
+        const stations = await this.db
+            .select()
+            .from(kdsStations)
+            .where(and(eq(kdsStations.organizationId, orgId), eq(kdsStations.isActive, true)));
+        const tickets = [];
+        for (const station of stations) {
+            const stationGroups = await this.getStationItemGroups(station.id);
+            const matchingItems = input.items.filter((item) => stationGroups.includes(item.itemGroup));
+            if (matchingItems.length === 0)
+                continue;
+            // Check if ticket already exists for this transaction+station
+            const existingTickets = await this.db
+                .select()
+                .from(kdsTickets)
+                .where(and(eq(kdsTickets.transactionId, input.transactionId), eq(kdsTickets.stationId, station.id)));
+            const ticketType = existingTickets.length > 0 ? "modified" : "new_order";
+            const ticketNumber = await this.generateTicketNumber(station.id);
+            const ticketRows = await this.db
+                .insert(kdsTickets)
+                .values({
+                organizationId: orgId,
+                transactionId: input.transactionId,
+                stationId: station.id,
+                type: ticketType,
+                status: "pending",
+                tableNumber: input.tableNumber,
+                orderType: input.orderType ?? "dine_in",
+                operatorName: input.operatorName,
+                ticketNumber,
+                comments: input.comments,
+            })
+                .returning();
+            const ticket = ticketRows[0];
+            // Add items to ticket
+            for (const item of matchingItems) {
+                await this.db.insert(kdsTicketItems).values({
+                    ticketId: ticket.id,
+                    entityId: item.entityId,
+                    variantId: item.variantId,
+                    itemName: item.itemName,
+                    quantity: item.quantity,
+                    courseName: item.courseName,
+                    coursePriority: item.coursePriority ?? 0,
+                    showCourseLabel: item.showCourseLabel ?? false,
+                    modifiers: item.modifiers ?? [],
+                    notes: item.notes,
+                });
+            }
+            tickets.push(ticket);
+        }
+        return Ok(tickets);
+    }
+    // ─── Ticket Status Updates ─────────────────────────────────────────
+    // URY equivalent: serve_kot() — sets order_status="Served", production_time.
+    // We add intermediate states (preparing, ready) for finer-grained tracking.
+    async startTicket(id) {
+        return this.updateTicketStatus(id, "preparing", { firedAt: new Date() });
+    }
+    async readyTicket(id) {
+        const ticket = await this.getTicketById(id);
+        if (!ticket.ok)
+            return ticket;
+        const prepDuration = ticket.value.firedAt
+            ? Math.round((Date.now() - ticket.value.firedAt.getTime()) / 1000)
+            : undefined;
+        return this.updateTicketStatus(id, "ready", {
+            readyAt: new Date(),
+            ...(prepDuration != null ? { prepDurationSeconds: prepDuration } : {}),
+        });
+    }
+    async serveTicket(id) {
+        return this.updateTicketStatus(id, "served", { servedAt: new Date() });
+    }
+    static VALID_TRANSITIONS = {
+        pending: ["preparing"],
+        preparing: ["ready"],
+        ready: ["served"],
+        served: [], // terminal state
+    };
+    async updateTicketStatus(id, newStatus, extra = {}) {
+        // Validate state transition
+        const existing = await this.db.select().from(kdsTickets).where(eq(kdsTickets.id, id));
+        if (existing.length === 0)
+            return Err("Ticket not found");
+        const current = existing[0];
+        const allowed = KDSService.VALID_TRANSITIONS[current.status] ?? [];
+        if (!allowed.includes(newStatus)) {
+            return Err(`Cannot transition ticket from '${current.status}' to '${newStatus}'`);
+        }
+        const rows = await this.db
+            .update(kdsTickets)
+            .set({ status: newStatus, ...extra, updatedAt: new Date() })
+            .where(eq(kdsTickets.id, id))
+            .returning();
+        if (rows.length === 0)
+            return Err("Ticket not found");
+        return Ok(rows[0]);
+    }
+    // ─── Item Status Updates ───────────────────────────────────────────
+    // URY stored item strikethrough in browser localStorage only.
+    // We persist item status to the database.
+    async markItemDone(ticketId, itemId) {
+        const rows = await this.db
+            .update(kdsTicketItems)
+            .set({ status: "done" })
+            .where(and(eq(kdsTicketItems.id, itemId), eq(kdsTicketItems.ticketId, ticketId)))
+            .returning();
+        if (rows.length === 0)
+            return Err("Ticket item not found");
+        return Ok(rows[0]);
+    }
+    // ─── Queries ───────────────────────────────────────────────────────
+    async getTicketById(id) {
+        const rows = await this.db.select().from(kdsTickets).where(eq(kdsTickets.id, id));
+        if (rows.length === 0)
+            return Err("Ticket not found");
+        return Ok(rows[0]);
+    }
+    async listPendingTickets(orgId, stationId) {
+        const tickets = await this.db
+            .select()
+            .from(kdsTickets)
+            .where(and(eq(kdsTickets.organizationId, orgId), eq(kdsTickets.stationId, stationId), sql `${kdsTickets.status} != 'served'`))
+            .orderBy(kdsTickets.createdAt);
+        const result = [];
+        for (const ticket of tickets) {
+            const items = await this.db
+                .select()
+                .from(kdsTicketItems)
+                .where(eq(kdsTicketItems.ticketId, ticket.id))
+                .orderBy(kdsTicketItems.coursePriority);
+            result.push({ ...ticket, items });
+        }
+        return Ok(result);
+    }
+    // ─── Helpers ───────────────────────────────────────────────────────
+    async generateTicketNumber(stationId) {
+        const today = new Date();
+        const startOfDay = new Date(today.getFullYear(), today.getMonth(), today.getDate());
+        const startOfDayISO = startOfDay.toISOString();
+        const countRows = await this.db
+            .select({ count: sql `COUNT(*)`.as("count") })
+            .from(kdsTickets)
+            .where(and(eq(kdsTickets.stationId, stationId), sql `${kdsTickets.createdAt} >= ${startOfDayISO}::timestamptz`));
+        const seq = Number(countRows[0]?.count ?? 0) + 1;
+        return `KDS-${String(seq).padStart(4, "0")}`;
+    }
+}

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

@@ -0,0 +1,74 @@
+/**
+ * ModifierService — CRUD and validation for item modifier groups and options.
+ *
+ * URY uses a flat "Item Add On" child table with no grouping, no required/optional
+ * flags, no min/max constraints, and no price adjustments. This service implements
+ * structured modifier groups with full constraint validation.
+ *
+ * Validation logic (used by cart.beforeAddItem hook):
+ * - Required groups must have at least minSelect selections
+ * - No group may exceed maxSelect selections
+ * - Unavailable options are rejected
+ * - Price adjustments are summed and returned for line item total calculation
+ */
+import type { PluginResult } from "@porulle/core";
+import type { Db, ModifierGroup, ModifierOption } from "../types.js";
+export declare class ModifierService {
+    private db;
+    constructor(db: Db);
+    createGroup(orgId: string, input: {
+        name: string;
+        entityId?: string;
+        itemGroup?: string;
+        isRequired?: boolean;
+        minSelect?: number;
+        maxSelect?: number;
+        sortOrder?: number;
+    }): Promise<PluginResult<ModifierGroup>>;
+    listGroups(orgId: string, entityId?: string): Promise<PluginResult<ModifierGroup[]>>;
+    getGroupWithOptions(orgId: string, groupId: string): Promise<PluginResult<{
+        group: ModifierGroup;
+        options: ModifierOption[];
+    }>>;
+    updateGroup(orgId: string, groupId: string, input: {
+        name?: string;
+        isRequired?: boolean;
+        minSelect?: number;
+        maxSelect?: number;
+        sortOrder?: number;
+    }): Promise<PluginResult<ModifierGroup>>;
+    deleteGroup(orgId: string, groupId: string): Promise<PluginResult<{
+        deleted: boolean;
+    }>>;
+    addOption(groupId: string, input: {
+        name: string;
+        priceAdjustment?: number;
+        isDefault?: boolean;
+        sortOrder?: number;
+    }): Promise<PluginResult<ModifierOption>>;
+    updateOption(optionId: string, input: {
+        name?: string;
+        priceAdjustment?: number;
+        isDefault?: boolean;
+        isAvailable?: boolean;
+        sortOrder?: number;
+    }): Promise<PluginResult<ModifierOption>>;
+    deleteOption(optionId: string): Promise<PluginResult<{
+        deleted: boolean;
+    }>>;
+    validateModifiers(orgId: string, entityId: string, selections: Array<{
+        groupId: string;
+        optionIds: string[];
+    }>): Promise<PluginResult<{
+        totalAdjustment: number;
+        validatedModifiers: Array<{
+            name: string;
+            priceAdjustment: number;
+        }>;
+    }>>;
+    getModifiersForEntity(orgId: string, entityId: string): Promise<PluginResult<Array<{
+        group: ModifierGroup;
+        options: ModifierOption[];
+    }>>>;
+}
+//# sourceMappingURL=modifier-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"modifier-service.d.ts","sourceRoot":"","sources":["../../src/services/modifier-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,KAAK,EAAE,EAAE,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAErE,qBAAa,eAAe;IACd,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,EAAE;IAIpB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE;QACtC,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;IAsBlC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,aAAa,EAAE,CAAC,CAAC;IAapF,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;QAC9E,KAAK,EAAE,aAAa,CAAC;QACrB,OAAO,EAAE,cAAc,EAAE,CAAC;KAC3B,CAAC,CAAC;IAiBG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE;QACvD,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;IAWlC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAYxF,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE;QACtC,IAAI,EAAE,MAAM,CAAC;QACb,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;IAenC,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE;QAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;IAWnC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAa3E,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC;QACzE,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,eAAe,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IAsDvH,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC;QACvF,KAAK,EAAE,aAAa,CAAC;QACrB,OAAO,EAAE,cAAc,EAAE,CAAC;KAC3B,CAAC,CAAC,CAAC;CAuBL"}

package/dist/services/modifier-service.js

@@ -0,0 +1,180 @@
+/**
+ * ModifierService — CRUD and validation for item modifier groups and options.
+ *
+ * URY uses a flat "Item Add On" child table with no grouping, no required/optional
+ * flags, no min/max constraints, and no price adjustments. This service implements
+ * structured modifier groups with full constraint validation.
+ *
+ * Validation logic (used by cart.beforeAddItem hook):
+ * - Required groups must have at least minSelect selections
+ * - No group may exceed maxSelect selections
+ * - Unavailable options are rejected
+ * - Price adjustments are summed and returned for line item total calculation
+ */
+import { eq, and } from "@porulle/core/drizzle";
+import { Ok, Err } from "@porulle/core";
+import { posModifierGroups, posModifierOptions } from "../schema.js";
+export class ModifierService {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    // ─── Group CRUD ────────────────────────────────────────────────────
+    async createGroup(orgId, input) {
+        if (input.minSelect != null && input.maxSelect != null && input.minSelect > input.maxSelect) {
+            return Err("minSelect cannot exceed maxSelect");
+        }
+        const rows = await this.db
+            .insert(posModifierGroups)
+            .values({
+            organizationId: orgId,
+            name: input.name,
+            entityId: input.entityId,
+            itemGroup: input.itemGroup,
+            isRequired: input.isRequired ?? false,
+            minSelect: input.minSelect ?? 0,
+            maxSelect: input.maxSelect ?? 1,
+            sortOrder: input.sortOrder ?? 0,
+        })
+            .returning();
+        return Ok(rows[0]);
+    }
+    async listGroups(orgId, entityId) {
+        const conditions = [eq(posModifierGroups.organizationId, orgId)];
+        if (entityId)
+            conditions.push(eq(posModifierGroups.entityId, entityId));
+        const rows = await this.db
+            .select()
+            .from(posModifierGroups)
+            .where(and(...conditions))
+            .orderBy(posModifierGroups.sortOrder);
+        return Ok(rows);
+    }
+    async getGroupWithOptions(orgId, groupId) {
+        const groups = await this.db
+            .select()
+            .from(posModifierGroups)
+            .where(and(eq(posModifierGroups.id, groupId), eq(posModifierGroups.organizationId, orgId)));
+        if (groups.length === 0)
+            return Err("Modifier group not found");
+        const options = await this.db
+            .select()
+            .from(posModifierOptions)
+            .where(eq(posModifierOptions.groupId, groupId))
+            .orderBy(posModifierOptions.sortOrder);
+        return Ok({ group: groups[0], options });
+    }
+    async updateGroup(orgId, groupId, input) {
+        const rows = await this.db
+            .update(posModifierGroups)
+            .set({ ...input, updatedAt: new Date() })
+            .where(and(eq(posModifierGroups.id, groupId), eq(posModifierGroups.organizationId, orgId)))
+            .returning();
+        if (rows.length === 0)
+            return Err("Modifier group not found");
+        return Ok(rows[0]);
+    }
+    async deleteGroup(orgId, groupId) {
+        const rows = await this.db
+            .delete(posModifierGroups)
+            .where(and(eq(posModifierGroups.id, groupId), eq(posModifierGroups.organizationId, orgId)))
+            .returning();
+        if (rows.length === 0)
+            return Err("Modifier group not found");
+        return Ok({ deleted: true });
+    }
+    // ─── Option CRUD ───────────────────────────────────────────────────
+    async addOption(groupId, input) {
+        const rows = await this.db
+            .insert(posModifierOptions)
+            .values({
+            groupId,
+            name: input.name,
+            priceAdjustment: input.priceAdjustment ?? 0,
+            isDefault: input.isDefault ?? false,
+            sortOrder: input.sortOrder ?? 0,
+        })
+            .returning();
+        return Ok(rows[0]);
+    }
+    async updateOption(optionId, input) {
+        const rows = await this.db
+            .update(posModifierOptions)
+            .set(input)
+            .where(eq(posModifierOptions.id, optionId))
+            .returning();
+        if (rows.length === 0)
+            return Err("Modifier option not found");
+        return Ok(rows[0]);
+    }
+    async deleteOption(optionId) {
+        const rows = await this.db
+            .delete(posModifierOptions)
+            .where(eq(posModifierOptions.id, optionId))
+            .returning();
+        if (rows.length === 0)
+            return Err("Modifier option not found");
+        return Ok({ deleted: true });
+    }
+    // ─── Validation ────────────────────────────────────────────────────
+    // Called by cart.beforeAddItem hook to validate modifier selections.
+    async validateModifiers(orgId, entityId, selections) {
+        // Get all modifier groups for this entity
+        const groups = await this.db
+            .select()
+            .from(posModifierGroups)
+            .where(and(eq(posModifierGroups.organizationId, orgId), eq(posModifierGroups.entityId, entityId)));
+        const selectionMap = new Map(selections.map((s) => [s.groupId, s.optionIds]));
+        let totalAdjustment = 0;
+        const validatedModifiers = [];
+        for (const group of groups) {
+            const selectedOptionIds = selectionMap.get(group.id) ?? [];
+            // Validate required groups
+            if (group.isRequired && selectedOptionIds.length < group.minSelect) {
+                return Err(`Required: select at least ${group.minSelect} from '${group.name}'`);
+            }
+            // Validate max selections
+            if (selectedOptionIds.length > group.maxSelect) {
+                return Err(`Maximum ${group.maxSelect} selections allowed for '${group.name}'`);
+            }
+            // Validate each selected option exists and is available
+            if (selectedOptionIds.length > 0) {
+                const options = await this.db
+                    .select()
+                    .from(posModifierOptions)
+                    .where(eq(posModifierOptions.groupId, group.id));
+                const optionMap = new Map(options.map((o) => [o.id, o]));
+                for (const optionId of selectedOptionIds) {
+                    const option = optionMap.get(optionId);
+                    if (!option)
+                        return Err(`Modifier option '${optionId}' not found in group '${group.name}'`);
+                    if (!option.isAvailable)
+                        return Err(`Modifier '${option.name}' is currently unavailable`);
+                    totalAdjustment += option.priceAdjustment;
+                    validatedModifiers.push({ name: option.name, priceAdjustment: option.priceAdjustment });
+                }
+            }
+        }
+        return Ok({ totalAdjustment, validatedModifiers });
+    }
+    // ─── Get Modifiers for Entity ──────────────────────────────────────
+    // Returns all modifier groups with their options for a given entity.
+    // Used by the POS frontend to render modifier selection UI.
+    async getModifiersForEntity(orgId, entityId) {
+        const groups = await this.db
+            .select()
+            .from(posModifierGroups)
+            .where(and(eq(posModifierGroups.organizationId, orgId), eq(posModifierGroups.entityId, entityId)))
+            .orderBy(posModifierGroups.sortOrder);
+        const result = [];
+        for (const group of groups) {
+            const options = await this.db
+                .select()
+                .from(posModifierOptions)
+                .where(eq(posModifierOptions.groupId, group.id))
+                .orderBy(posModifierOptions.sortOrder);
+            result.push({ group, options });
+        }
+        return Ok(result);
+    }
+}

package/dist/services/recipe-deduction-service.d.ts

@@ -0,0 +1,64 @@
+/**
+ * RecipeDeductionService -- resolves recipe ingredient inventory deductions
+ * when a POS transaction completes.
+ *
+ * For each sold item:
+ *   1. Look up the entity's active recipe
+ *   2. For each ingredient with an entityId, calculate deduction quantity
+ *   3. Deduct via inventory service (preferred) or raw SQL (fallback)
+ *
+ * When the ServiceRegistry is provided (normal plugin boot), deductions
+ * go through kernel.services.inventory.adjust() which creates proper
+ * movements, fires hooks, and respects audit trail.
+ *
+ * When the ServiceRegistry is not available (standalone tests, scripts),
+ * falls back to raw SQL with the same atomic guard.
+ */
+import type { PluginResult } from "@porulle/core";
+import type { Db } from "../types.js";
+interface DeductionItem {
+    entityId: string;
+    variantId: string | null;
+    quantity: number;
+    unit: string;
+    itemName: string;
+    reason: string;
+}
+export declare class RecipeDeductionService {
+    private db;
+    private inventorySvc?;
+    constructor(db: Db, services?: Record<string, unknown>);
+    /**
+     * Resolve all recipe ingredient deductions for a list of sold items.
+     * Pure query -- no mutations. Returns a flat list to pass to applyDeductions().
+     */
+    resolveDeductions(orgId: string, items: Array<{
+        entityId: string;
+        quantity: number;
+    }>): Promise<PluginResult<DeductionItem[]>>;
+    /**
+     * Apply deductions to inventory.
+     *
+     * Strategy 1 (preferred): Use inventory.adjust() via ServiceRegistry.
+     *   - Creates proper inventory_movements with audit trail
+     *   - Fires hooks (e.g., low-stock alerts)
+     *   - Respects the inventory service's stock guard logic
+     *
+     * Strategy 2 (fallback): Raw SQL with atomic WHERE guard.
+     *   - Used when services are not available (standalone scripts, tests)
+     *   - Same oversell protection via UPDATE ... WHERE quantity_on_hand >= N
+     */
+    applyDeductions(tx: Db, deductions: DeductionItem[], warehouseId: string, referenceType: string, referenceId: string, performedBy: string): Promise<PluginResult<number>>;
+    /**
+     * Strategy 1: Deduct via kernel.services.inventory.adjust().
+     * Each deduction becomes a negative adjustment with a reason.
+     */
+    private applyViaService;
+    /**
+     * Strategy 2: Raw SQL fallback with atomic oversell guard.
+     * Used when ServiceRegistry is not available.
+     */
+    private applyViaRawSQL;
+}
+export {};
+//# sourceMappingURL=recipe-deduction-service.d.ts.map

package/dist/services/recipe-deduction-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-deduction-service.d.ts","sourceRoot":"","sources":["../../src/services/recipe-deduction-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAUtC,UAAU,aAAa;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,sBAAsB;IAI/B,OAAO,CAAC,EAAE;IAHZ,OAAO,CAAC,YAAY,CAAC,CAAoB;gBAG/B,EAAE,EAAE,EAAE,EACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAQpC;;;OAGG;IACG,iBAAiB,CACrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,GACnD,OAAO,CAAC,YAAY,CAAC,aAAa,EAAE,CAAC,CAAC;IAwCzC;;;;;;;;;;;OAWG;IACG,eAAe,CACnB,EAAE,EAAE,EAAE,EACN,UAAU,EAAE,aAAa,EAAE,EAC3B,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAQhC;;;OAGG;YACW,eAAe;IAwC7B;;;OAGG;YACW,cAAc;CA6C7B"}