@porulle/core 0.7.0 → 0.9.0

package/dist/modules/documents/service.d.ts

@@ -0,0 +1,51 @@
+import type { Actor } from "../../auth/types.js";
+import type { TxContext } from "../../kernel/database/tx-context.js";
+import { type Result } from "../../kernel/result.js";
+import type { HydratedOrder } from "../orders/service.js";
+import type { DocumentsRepository, OrderDocument } from "./repository/index.js";
+interface DocumentsServiceDeps {
+    repository: DocumentsRepository;
+    services: Record<string, unknown>;
+}
+/**
+ * Order document rendering + fiscal numbering (issue #47).
+ */
+export declare class DocumentsService {
+    private repository;
+    private services;
+    constructor(deps: DocumentsServiceDeps);
+    private get orders();
+    private get settings();
+    private brandingFor;
+    /**
+     * Issues (or returns the previously issued) fiscal invoice number for an
+     * order. Idempotent per (org, order): once handed out, the number never
+     * changes. Sequence allocation is atomic; a lost creation race falls back
+     * to the winner's document.
+     */
+    issueInvoiceNumber(order: HydratedOrder, ctx?: TxContext): Promise<OrderDocument>;
+    private loadOrder;
+    renderInvoiceHtml(orderId: string, actor: Actor | null, ctx?: TxContext): Promise<Result<{
+        html: string;
+        invoiceNumber: string;
+    }>>;
+    renderInvoicePdf(orderId: string, actor: Actor | null, ctx?: TxContext): Promise<Result<{
+        pdf: Uint8Array;
+        invoiceNumber: string;
+    }>>;
+    renderReceiptHtml(orderId: string, actor: Actor | null, ctx?: TxContext): Promise<Result<{
+        html: string;
+    }>>;
+    /**
+     * Emails the invoice via the configured email adapter. The adapter's
+     * template contract is (template, to, data) — the rendered HTML and the
+     * fiscal number ride in `data` so template-based adapters can use either.
+     */
+    emailInvoice(orderId: string, to: string, actor: Actor | null, ctx?: TxContext): Promise<Result<{
+        sent: true;
+        invoiceNumber: string;
+        to: string;
+    }>>;
+}
+export {};
+//# sourceMappingURL=service.d.ts.map

package/dist/modules/documents/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/modules/documents/service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAErE,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,sBAAsB,CAAC;AASxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEhF,UAAU,oBAAoB;IAC5B,UAAU,EAAE,mBAAmB,CAAC;IAGhC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAQD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,QAAQ,CAA0B;gBAE9B,IAAI,EAAE,oBAAoB;IAKtC,OAAO,KAAK,MAAM,GAEjB;IAED,OAAO,KAAK,QAAQ,GAEnB;YAEa,WAAW;IAIzB;;;;;OAKG;IACG,kBAAkB,CACtB,KAAK,EAAE,aAAa,EACpB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,aAAa,CAAC;YA0BX,SAAS;IAQjB,iBAAiB,CACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,KAAK,GAAG,IAAI,EACnB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAWrD,gBAAgB,CACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,KAAK,GAAG,IAAI,EACnB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC;QAAE,GAAG,EAAE,UAAU,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAaxD,iBAAiB,CACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,KAAK,GAAG,IAAI,EACnB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAOpC;;;;OAIG;IACG,YAAY,CAChB,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,KAAK,GAAG,IAAI,EACnB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CA0BtE"}

package/dist/modules/documents/service.js

@@ -0,0 +1,119 @@
+import { resolveOrgId } from "../../auth/org.js";
+import { CommerceValidationError } from "../../kernel/errors.js";
+import { Err, Ok } from "../../kernel/result.js";
+import { buildPdf } from "./pdf.js";
+import { invoiceHtml, invoicePdfOps, receiptHtml, } from "./render.js";
+const DEFAULT_INVOICE_PREFIX = "INV-";
+/**
+ * Order document rendering + fiscal numbering (issue #47).
+ */
+export class DocumentsService {
+    repository;
+    services;
+    constructor(deps) {
+        this.repository = deps.repository;
+        this.services = deps.services;
+    }
+    get orders() {
+        return this.services.orders;
+    }
+    get settings() {
+        return this.services.settings;
+    }
+    async brandingFor(orgId, ctx) {
+        return (await this.settings.read(orgId, "branding", ctx));
+    }
+    /**
+     * Issues (or returns the previously issued) fiscal invoice number for an
+     * order. Idempotent per (org, order): once handed out, the number never
+     * changes. Sequence allocation is atomic; a lost creation race falls back
+     * to the winner's document.
+     */
+    async issueInvoiceNumber(order, ctx) {
+        const orgId = order.organizationId;
+        const existing = await this.repository.findDocument(orgId, order.id, "invoice", ctx);
+        if (existing)
+            return existing;
+        const documentsSettings = await this.settings.read(orgId, "documents", ctx);
+        const prefix = typeof documentsSettings.invoicePrefix === "string"
+            ? documentsSettings.invoicePrefix
+            : DEFAULT_INVOICE_PREFIX;
+        const value = await this.repository.allocate(orgId, "invoice", ctx);
+        const documentNumber = `${prefix}${String(value).padStart(6, "0")}`;
+        try {
+            return await this.repository.createDocument({ organizationId: orgId, orderId: order.id, type: "invoice", documentNumber }, ctx);
+        }
+        catch (error) {
+            // Unique (org, order, type) — a concurrent request won; use its number.
+            const winner = await this.repository.findDocument(orgId, order.id, "invoice", ctx);
+            if (winner)
+                return winner;
+            throw error;
+        }
+    }
+    async loadOrder(orderId, actor, ctx) {
+        return this.orders.getById(orderId, actor, ctx);
+    }
+    async renderInvoiceHtml(orderId, actor, ctx) {
+        const order = await this.loadOrder(orderId, actor, ctx);
+        if (!order.ok)
+            return order;
+        const branding = await this.brandingFor(order.value.organizationId, ctx);
+        const doc = await this.issueInvoiceNumber(order.value, ctx);
+        return Ok({
+            html: invoiceHtml({ order: order.value, branding, invoiceNumber: doc.documentNumber }),
+            invoiceNumber: doc.documentNumber,
+        });
+    }
+    async renderInvoicePdf(orderId, actor, ctx) {
+        const order = await this.loadOrder(orderId, actor, ctx);
+        if (!order.ok)
+            return order;
+        const branding = await this.brandingFor(order.value.organizationId, ctx);
+        const doc = await this.issueInvoiceNumber(order.value, ctx);
+        const pages = invoicePdfOps({
+            order: order.value,
+            branding,
+            invoiceNumber: doc.documentNumber,
+        });
+        return Ok({ pdf: buildPdf(pages), invoiceNumber: doc.documentNumber });
+    }
+    async renderReceiptHtml(orderId, actor, ctx) {
+        const order = await this.loadOrder(orderId, actor, ctx);
+        if (!order.ok)
+            return order;
+        const branding = await this.brandingFor(order.value.organizationId, ctx);
+        return Ok({ html: receiptHtml({ order: order.value, branding }) });
+    }
+    /**
+     * Emails the invoice via the configured email adapter. The adapter's
+     * template contract is (template, to, data) — the rendered HTML and the
+     * fiscal number ride in `data` so template-based adapters can use either.
+     */
+    async emailInvoice(orderId, to, actor, ctx) {
+        const email = this.services.email;
+        if (!email) {
+            return Err(new CommerceValidationError("No email adapter is configured."));
+        }
+        const rendered = await this.renderInvoiceHtml(orderId, actor, ctx);
+        if (!rendered.ok)
+            return rendered;
+        const order = await this.loadOrder(orderId, actor, ctx);
+        if (!order.ok)
+            return order;
+        await email.send({
+            template: "order-invoice",
+            to,
+            data: {
+                orgId: resolveOrgId(actor ?? ctx?.actor ?? null),
+                orderId,
+                orderNumber: order.value.orderNumber,
+                invoiceNumber: rendered.value.invoiceNumber,
+                grandTotal: order.value.grandTotal,
+                currency: order.value.currency,
+                html: rendered.value.html,
+            },
+        });
+        return Ok({ sent: true, invoiceNumber: rendered.value.invoiceNumber, to });
+    }
+}

package/dist/modules/fulfillment/service.d.ts

@@ -37,6 +37,24 @@ export declare class FulfillmentService {
     private strategies;
     constructor(deps: FulfillmentServiceDeps);
     fulfillOrder(orderId: string, actor?: Actor | null, ctx?: TxContext): Promise<Result<void>>;
+    /**
+     * Records a fulfillment (e.g. a shipment) for a subset of an order's line
+     * items, with optional carrier/tracking details. Supports partial
+     * fulfillment (per-line quantities) and multiple fulfillments per order.
+     */
+    createFulfillment(input: {
+        orderId: string;
+        lineItems: Array<{
+            orderLineItemId: string;
+            quantity: number;
+        }>;
+        carrier?: string;
+        trackingNumber?: string;
+        trackingUrl?: string;
+        type?: string;
+        status?: string;
+        metadata?: Record<string, unknown>;
+    }, actor?: Actor | null, ctx?: TxContext): Promise<Result<FulfillmentRecord>>;
     getByOrderId(orderId: string, ctx?: TxContext): Promise<Result<FulfillmentRecord[]>>;
     updateTracking(input: {
         fulfillmentId: string;

package/dist/modules/fulfillment/service.d.ts.map

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

package/dist/modules/fulfillment/service.js

@@ -1,6 +1,6 @@
 import { createHmac } from "node:crypto";
 import { resolveOrgId } from "../../auth/org.js";
-import { CommerceNotFoundError } from "../../kernel/errors.js";
+import { CommerceNotFoundError, CommerceValidationError } from "../../kernel/errors.js";
 import { runAfterHooks } from "../../kernel/hooks/executor.js";
 import { createHookContext } from "../../kernel/hooks/create-context.js";
 import { Err, Ok } from "../../kernel/result.js";
@@ -198,6 +198,90 @@ export class FulfillmentService {
         }
         return Ok(undefined);
     }
+    /**
+     * Records a fulfillment (e.g. a shipment) for a subset of an order's line
+     * items, with optional carrier/tracking details. Supports partial
+     * fulfillment (per-line quantities) and multiple fulfillments per order.
+     */
+    async createFulfillment(input, actor, ctx) {
+        const orgId = resolveOrgId(actor ?? ctx?.actor ?? null);
+        const order = await this.deps.ordersRepository.findById(orgId, input.orderId, ctx);
+        if (!order)
+            return Err(new CommerceNotFoundError("Order not found."));
+        const orderLines = await this.deps.ordersRepository.findLineItemsByOrderId(input.orderId, ctx);
+        const linesById = new Map(orderLines.map((li) => [li.id, li]));
+        // Validate every requested line before writing anything: it must belong
+        // to the order, and requested + already-fulfilled must not exceed ordered.
+        const alreadyFulfilled = new Map();
+        for (const req of input.lineItems) {
+            const line = linesById.get(req.orderLineItemId);
+            if (!line) {
+                return Err(new CommerceValidationError(`Line item ${req.orderLineItemId} does not belong to this order.`));
+            }
+            const fulfilled = await this.deps.repository.getFulfilledQuantity(req.orderLineItemId, ctx);
+            alreadyFulfilled.set(req.orderLineItemId, fulfilled);
+            if (fulfilled + req.quantity > line.quantity) {
+                return Err(new CommerceValidationError(`Cannot fulfill ${req.quantity} of "${line.title}" — only ${line.quantity - fulfilled} remaining.`));
+            }
+        }
+        const status = input.status ?? "shipped";
+        const created = await this.deps.repository.create({
+            orderId: order.id,
+            type: input.type ?? "physical",
+            status,
+            carrier: input.carrier ?? null,
+            trackingNumber: input.trackingNumber ?? null,
+            trackingUrl: input.trackingUrl ?? null,
+            ...(status === "shipped" ? { shippedAt: new Date() } : {}),
+            ...(status === "delivered" ? { deliveredAt: new Date() } : {}),
+            ...(order.customerId != null ? { customerId: order.customerId } : {}),
+            metadata: input.metadata ?? {},
+        }, ctx);
+        await this.deps.repository.createLineItems(input.lineItems.map((li) => ({
+            fulfillmentId: created.id,
+            orderLineItemId: li.orderLineItemId,
+            quantity: li.quantity,
+        })), ctx);
+        await this.deps.repository.createEvent({
+            fulfillmentId: created.id,
+            eventType: "created",
+            toStatus: status,
+            ...(actor?.userId !== undefined ? { actorId: actor.userId } : {}),
+            description: input.trackingNumber
+                ? `Shipment recorded (${input.trackingNumber})`
+                : "Fulfillment recorded",
+        }, ctx);
+        // Reflect per-line fulfillment progress on the order line items
+        for (const req of input.lineItems) {
+            const line = linesById.get(req.orderLineItemId);
+            const total = (alreadyFulfilled.get(req.orderLineItemId) ?? 0) + req.quantity;
+            await this.deps.ordersRepository.updateLineItem(req.orderLineItemId, { fulfillmentStatus: total >= line.quantity ? "fulfilled" : "partial" }, ctx);
+        }
+        const record = {
+            ...toServiceRecord(created, input.lineItems.map((li) => ({
+                id: "",
+                fulfillmentId: created.id,
+                orderLineItemId: li.orderLineItemId,
+                quantity: li.quantity,
+            }))),
+            lineItems: input.lineItems.map((li) => ({
+                id: li.orderLineItemId,
+                title: linesById.get(li.orderLineItemId)?.title ?? "",
+                quantity: li.quantity,
+            })),
+        };
+        const afterHooks = this.deps.hooks.resolve("fulfillment.afterCreate");
+        const hookCtx = createHookContext({
+            actor: actor ?? ctx?.actor ?? null,
+            tx: ctx?.tx ?? null,
+            logger: createLogger("fulfillment"),
+            services: this.deps.services,
+            context: { moduleName: "fulfillment" },
+            database: { db: this.deps.database.db },
+        });
+        await runAfterHooks(afterHooks, null, record, "create", hookCtx);
+        return Ok(record);
+    }
     async getByOrderId(orderId, ctx) {
         const dbRecords = await this.deps.repository.findByOrderId(orderId, ctx);
         // Hydrate each record with its associated line items

package/dist/modules/orders/repository/index.d.ts

@@ -1,6 +1,6 @@
 import type { TxContext } from "../../../kernel/database/tx-context.js";
 import type { DrizzleDatabase } from "../../../kernel/database/drizzle-db.js";
-import { orders, orderLineItems, orderStatusHistory } from "../schema.js";
+import { orders, orderLineItems, orderNotes, orderRefunds, orderStatusHistory } from "../schema.js";
 export interface OrderLookupRow {
     id: string;
     orderNumber: string;
@@ -18,6 +18,10 @@ export type OrderLineItem = typeof orderLineItems.$inferSelect;
 export type OrderLineItemInsert = typeof orderLineItems.$inferInsert;
 export type OrderStatusHistory = typeof orderStatusHistory.$inferSelect;
 export type OrderStatusHistoryInsert = typeof orderStatusHistory.$inferInsert;
+export type OrderRefund = typeof orderRefunds.$inferSelect;
+export type OrderRefundInsert = typeof orderRefunds.$inferInsert;
+export type OrderNote = typeof orderNotes.$inferSelect;
+export type OrderNoteInsert = typeof orderNotes.$inferInsert;
 /**
  * OrdersRepository provides type-safe database operations for orders.
  *
@@ -44,6 +48,7 @@ export declare class OrdersRepository {
         limit?: number;
         offset?: number;
     }, ctx?: TxContext): Promise<Order[]>;
+    findByIdempotencyKey(orgId: string, idempotencyKey: string, ctx?: TxContext): Promise<Order | undefined>;
     create(data: OrderInsert, ctx?: TxContext): Promise<Order>;
     update(id: string, data: Partial<Omit<OrderInsert, "id">>, ctx?: TxContext): Promise<Order | undefined>;
     updateStatus(id: string, currentStatus: string, newStatus: string, ctx?: TxContext): Promise<Order | undefined>;
@@ -62,6 +67,18 @@ export declare class OrdersRepository {
         order: Order;
         lineItems: OrderLineItem[];
     } | undefined>;
+    createRefund(data: OrderRefundInsert, ctx?: TxContext): Promise<OrderRefund>;
+    findRefundById(orgId: string, id: string, ctx?: TxContext): Promise<OrderRefund | undefined>;
+    findRefundsByOrderId(orderId: string, ctx?: TxContext): Promise<OrderRefund[]>;
+    markRefundUndone(id: string, undoneBy: string, ctx?: TxContext): Promise<OrderRefund | undefined>;
+    /**
+     * Sum of completed refunds performed by an operator for the local calendar
+     * day in the given timezone — the daily-cap accounting query.
+     */
+    sumRefundsByOperatorToday(orgId: string, performedBy: string, timezone: string, ctx?: TxContext): Promise<number>;
+    createNote(data: OrderNoteInsert, ctx?: TxContext): Promise<OrderNote>;
+    findNotesByOrderId(orderId: string, ctx?: TxContext): Promise<OrderNote[]>;
+    deleteNote(orgId: string, orderId: string, noteId: string, ctx?: TxContext): Promise<boolean>;
     getNextOrderNumber(ctx?: TxContext): Promise<string>;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/modules/orders/repository/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/orders/repository/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/orders/repository/index.ts"],"names":[],"mappings":"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"}

package/dist/modules/orders/repository/index.js

@@ -1,5 +1,5 @@
 import { eq, and, or, gte, lte, desc, sql } from "drizzle-orm";
-import { orders, orderLineItems, orderStatusHistory } from "../schema.js";
+import { orders, orderLineItems, orderNotes, orderRefunds, orderStatusHistory } from "../schema.js";
 import { customers } from "../../customers/schema.js";
 /**
  * OrdersRepository provides type-safe database operations for orders.
@@ -106,6 +106,14 @@ export class OrdersRepository {
         }
         return query;
     }
+    async findByIdempotencyKey(orgId, idempotencyKey, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db
+            .select()
+            .from(orders)
+            .where(and(eq(orders.organizationId, orgId), eq(orders.idempotencyKey, idempotencyKey)));
+        return rows[0];
+    }
     async create(data, ctx) {
         const db = this.getDb(ctx);
         const rows = await db.insert(orders).values(data).returning();
@@ -223,6 +231,83 @@ export class OrdersRepository {
         return { order, lineItems };
     }
     // ─────────────────────────────────────────────────────────────────────────────
+    // Line-level refunds (issue #52)
+    // ─────────────────────────────────────────────────────────────────────────────
+    async createRefund(data, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db.insert(orderRefunds).values(data).returning();
+        return rows[0];
+    }
+    async findRefundById(orgId, id, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db
+            .select()
+            .from(orderRefunds)
+            .where(and(eq(orderRefunds.organizationId, orgId), eq(orderRefunds.id, id)));
+        return rows[0];
+    }
+    async findRefundsByOrderId(orderId, ctx) {
+        const db = this.getDb(ctx);
+        return db
+            .select()
+            .from(orderRefunds)
+            .where(eq(orderRefunds.orderId, orderId))
+            .orderBy(desc(orderRefunds.createdAt));
+    }
+    async markRefundUndone(id, undoneBy, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db
+            .update(orderRefunds)
+            .set({ status: "undone", undoneAt: new Date(), undoneBy })
+            .where(and(eq(orderRefunds.id, id), eq(orderRefunds.status, "completed")))
+            .returning();
+        return rows[0];
+    }
+    /**
+     * Sum of completed refunds performed by an operator for the local calendar
+     * day in the given timezone — the daily-cap accounting query.
+     */
+    async sumRefundsByOperatorToday(orgId, performedBy, timezone, ctx) {
+        const db = this.getDb(ctx);
+        const result = await db.execute(sql `
+      SELECT COALESCE(sum(amount), 0)::int AS "total"
+      FROM order_refunds
+      WHERE organization_id = ${orgId}
+        AND performed_by = ${performedBy}
+        AND status = 'completed'
+        AND (created_at AT TIME ZONE ${timezone})::date = (now() AT TIME ZONE ${timezone})::date
+    `);
+        const rows = Array.isArray(result)
+            ? result
+            : (result.rows ?? []);
+        const total = rows[0]?.total;
+        return typeof total === "bigint" ? Number(total) : (total ?? 0);
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Order notes (issue #56)
+    // ─────────────────────────────────────────────────────────────────────────────
+    async createNote(data, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db.insert(orderNotes).values(data).returning();
+        return rows[0];
+    }
+    async findNotesByOrderId(orderId, ctx) {
+        const db = this.getDb(ctx);
+        return db
+            .select()
+            .from(orderNotes)
+            .where(eq(orderNotes.orderId, orderId))
+            .orderBy(desc(orderNotes.pinned), desc(orderNotes.createdAt));
+    }
+    async deleteNote(orgId, orderId, noteId, ctx) {
+        const db = this.getDb(ctx);
+        const rows = await db
+            .delete(orderNotes)
+            .where(and(eq(orderNotes.id, noteId), eq(orderNotes.orderId, orderId), eq(orderNotes.organizationId, orgId)))
+            .returning();
+        return rows.length > 0;
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
     // Order Number Generation
     // ─────────────────────────────────────────────────────────────────────────────
     async getNextOrderNumber(ctx) {