@flowselections/floriday-voorraad 1.0.40 → 1.0.42

package/dist-lib/lib/floriday-write-gate.server.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Fail-closed poort voor ÁL het schrijvende verkeer naar Floriday.
+ *
+ * Contract (koppelprompt 4 + 5):
+ *  - Voor elke schrijfactie: `public.logistics_floriday_write_allowed(<actie>)`.
+ *    Alleen bij exact `true` mag er verstuurd worden.
+ *  - Statuswijzigingen en afhandelingen vragen daarnaast
+ *    `public.logistics_floriday_order_approved(order_ref)`.
+ *  - Fail closed: onbekende actie, ontbrekende functie, databasefout of een
+ *    ander antwoord dan `true` → NIET versturen. Nooit terugvallen.
+ *  - Elke weigering en elke verzending wordt vastgelegd via
+ *    `logistics_floriday_log_refusal` / `logistics_floriday_log_send`.
+ *  - Lezen valt hier nooit onder; alleen schrijven.
+ *
+ * Server-only bestand: nooit importeren vanuit clientcode.
+ */
+export declare const WRITE_GATE_MODULE = "voorraad";
+/** Herkenbare markering zodat de wachtrij een weigering als "wachten" ziet. */
+export declare const WRITE_GATE_MARK = "[poort]";
+export type GateAction = "stock_publish" | "trade_item_update" | "status_update" | "fulfillment_order_send";
+export declare class FloridayWriteRefused extends Error {
+    readonly refused = true;
+    constructor(reason: string);
+}
+export declare function isWriteRefusal(message: string): boolean;
+/**
+ * Vertaalt een gateway-schrijfactie naar één van de vier toegestane
+ * actienamen. Herkent de code de actie niet, dan is het antwoord `null` en
+ * wordt er per definitie geweigerd.
+ */
+export declare function classifyWriteAction(input: {
+    action?: string;
+    path?: string;
+}): GateAction | null;
+export declare function logFloridaySend(input: {
+    orderRef: string;
+    action: string;
+    ok: boolean;
+    httpStatus?: number | null;
+    detail?: string | null;
+}): Promise<void>;
+/**
+ * Vraagt toestemming voor één schrijfactie. Gooit `FloridayWriteRefused`
+ * wanneer er niet verstuurd mag worden — er is geen andere uitkomst.
+ */
+export declare function ensureFloridayWriteAllowed(input: {
+    action?: string;
+    path?: string;
+    referenceId?: string;
+    orderRef?: string;
+}): Promise<GateAction>;
+/**
+ * Mag de voorraadwachtrij überhaupt draaien? Gebruikt dezelfde poort, zodat
+ * cronjobs en achtergrondtaken elke ronde opnieuw toestemming vragen.
+ */
+export declare function stockPublishAllowed(): Promise<{
+    allowed: boolean;
+    reason: string | null;
+}>;
+//# sourceMappingURL=floriday-write-gate.server.d.ts.map

package/dist-lib/lib/floriday-write-gate.server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"floriday-write-gate.server.d.ts","sourceRoot":"","sources":["../../src/lib/floriday-write-gate.server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,iBAAiB,aAAa,CAAC;AAE5C,+EAA+E;AAC/E,eAAO,MAAM,eAAe,YAAY,CAAC;AAEzC,MAAM,MAAM,UAAU,GAClB,eAAe,GACf,mBAAmB,GACnB,eAAe,GACf,wBAAwB,CAAC;AAE7B,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,OAAO,QAAQ;gBACZ,MAAM,EAAE,MAAM;CAI3B;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,UAAU,GAAG,IAAI,CAwBpB;AAwCD,wBAAsB,eAAe,CAAC,KAAK,EAAE;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,GAAG,OAAO,CAAC,IAAI,CAAC,CAehB;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,KAAK,EAAE;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,UAAU,CAAC,CAsEtB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC,CAYD"}

package/dist-lib/lib/floriday-write-gate.server.js

@@ -0,0 +1,196 @@
+/**
+ * Fail-closed poort voor ÁL het schrijvende verkeer naar Floriday.
+ *
+ * Contract (koppelprompt 4 + 5):
+ *  - Voor elke schrijfactie: `public.logistics_floriday_write_allowed(<actie>)`.
+ *    Alleen bij exact `true` mag er verstuurd worden.
+ *  - Statuswijzigingen en afhandelingen vragen daarnaast
+ *    `public.logistics_floriday_order_approved(order_ref)`.
+ *  - Fail closed: onbekende actie, ontbrekende functie, databasefout of een
+ *    ander antwoord dan `true` → NIET versturen. Nooit terugvallen.
+ *  - Elke weigering en elke verzending wordt vastgelegd via
+ *    `logistics_floriday_log_refusal` / `logistics_floriday_log_send`.
+ *  - Lezen valt hier nooit onder; alleen schrijven.
+ *
+ * Server-only bestand: nooit importeren vanuit clientcode.
+ */
+export const WRITE_GATE_MODULE = "voorraad";
+/** Herkenbare markering zodat de wachtrij een weigering als "wachten" ziet. */
+export const WRITE_GATE_MARK = "[poort]";
+export class FloridayWriteRefused extends Error {
+    constructor(reason) {
+        super(`${WRITE_GATE_MARK} Niet verstuurd naar Floriday: ${reason}`);
+        this.refused = true;
+        this.name = "FloridayWriteRefused";
+    }
+}
+export function isWriteRefusal(message) {
+    return String(message ?? "").includes(WRITE_GATE_MARK);
+}
+/**
+ * Vertaalt een gateway-schrijfactie naar één van de vier toegestane
+ * actienamen. Herkent de code de actie niet, dan is het antwoord `null` en
+ * wordt er per definitie geweigerd.
+ */
+export function classifyWriteAction(input) {
+    const a = (input.action ?? "").toLowerCase();
+    const p = (input.path ?? "").toLowerCase();
+    if (/fulfillment/.test(a) || /fulfillment-orders/.test(p)) {
+        return "fulfillment_order_send";
+    }
+    if (/status/.test(a) || /\/status\b/.test(p))
+        return "status_update";
+    if (/(stock|supply|availabilit|allocation|batch)/.test(a) ||
+        /(continuous-stock|base-supply|supply-lines|availabilit)/.test(p)) {
+        return "stock_publish";
+    }
+    if (/(trade-item|tradeitem|item|product|media|photo|image|packing|warehouse|offer|price)/.test(a) ||
+        /(trade-items|media|packings|warehouses|customer-offers|price)/.test(p)) {
+        return "trade_item_update";
+    }
+    return null;
+}
+/** Naam van deze omgeving; afgeleid van de runtime, nooit hardcoded. */
+function resolveShell() {
+    const base = process.env.PUBLIC_BASE_URL ??
+        process.env.MODULE_BASE_URL ??
+        process.env.SUPABASE_URL ??
+        "";
+    try {
+        return base ? new URL(base).host : "onbekend";
+    }
+    catch {
+        return "onbekend";
+    }
+}
+async function admin() {
+    const { getAdminClient } = await import("./supabase-admin.server");
+    return getAdminClient();
+}
+async function logRefusal(orderRef, reason, action) {
+    try {
+        const db = await admin();
+        await db.rpc("logistics_floriday_log_refusal", {
+            _order_ref: orderRef,
+            _reason: reason,
+            _module: WRITE_GATE_MODULE,
+            _shell: resolveShell(),
+            _action: action,
+        });
+    }
+    catch {
+        /* logboek mag de weigering nooit omzetten in een verzending */
+    }
+}
+export async function logFloridaySend(input) {
+    try {
+        const db = await admin();
+        await db.rpc("logistics_floriday_log_send", {
+            _order_ref: input.orderRef,
+            _action: input.action,
+            _ok: input.ok,
+            _http_status: input.httpStatus ?? null,
+            _detail: input.detail ?? null,
+            _module: WRITE_GATE_MODULE,
+            _shell: resolveShell(),
+        });
+    }
+    catch {
+        /* logboek mag de verwerking niet blokkeren */
+    }
+}
+/**
+ * Vraagt toestemming voor één schrijfactie. Gooit `FloridayWriteRefused`
+ * wanneer er niet verstuurd mag worden — er is geen andere uitkomst.
+ */
+export async function ensureFloridayWriteAllowed(input) {
+    const orderRef = String(input.orderRef ?? input.referenceId ?? "").trim() || "-";
+    const gateAction = classifyWriteAction(input);
+    if (!gateAction) {
+        const reason = `onbekende schrijfactie "${input.action ?? input.path ?? "?"}"`;
+        await logRefusal(orderRef, reason, String(input.action ?? ""));
+        throw new FloridayWriteRefused(reason);
+    }
+    let db;
+    try {
+        db = await admin();
+    }
+    catch (e) {
+        const reason = `database niet bereikbaar: ${e?.message ?? e}`;
+        await logRefusal(orderRef, reason, gateAction);
+        throw new FloridayWriteRefused(reason);
+    }
+    try {
+        const { data, error } = await db.rpc("logistics_floriday_write_allowed", {
+            _action: gateAction,
+        });
+        if (error) {
+            const reason = `poortfunctie niet leesbaar: ${error.message}`;
+            await logRefusal(orderRef, reason, gateAction);
+            throw new FloridayWriteRefused(reason);
+        }
+        if (data !== true) {
+            const reason = `schakelaar voor "${gateAction}" staat uit`;
+            await logRefusal(orderRef, reason, gateAction);
+            throw new FloridayWriteRefused(reason);
+        }
+    }
+    catch (e) {
+        if (e instanceof FloridayWriteRefused)
+            throw e;
+        const reason = `poort niet bereikbaar: ${e?.message ?? e}`;
+        await logRefusal(orderRef, reason, gateAction);
+        throw new FloridayWriteRefused(reason);
+    }
+    // Statusverkeer vraagt daarnaast om een goedgekeurde karrencontrole.
+    if (gateAction === "status_update" || gateAction === "fulfillment_order_send") {
+        if (orderRef === "-") {
+            const reason = "geen ordernummer bekend";
+            await logRefusal(orderRef, reason, gateAction);
+            throw new FloridayWriteRefused(reason);
+        }
+        try {
+            const { data, error } = await db.rpc("logistics_floriday_order_approved", {
+                _order_ref: orderRef,
+            });
+            if (error) {
+                const reason = `goedkeuring niet leesbaar: ${error.message}`;
+                await logRefusal(orderRef, reason, gateAction);
+                throw new FloridayWriteRefused(reason);
+            }
+            if (data !== true) {
+                const reason = "karrencontrole niet goedgekeurd";
+                await logRefusal(orderRef, reason, gateAction);
+                throw new FloridayWriteRefused(reason);
+            }
+        }
+        catch (e) {
+            if (e instanceof FloridayWriteRefused)
+                throw e;
+            const reason = `goedkeuring niet leesbaar: ${e?.message ?? e}`;
+            await logRefusal(orderRef, reason, gateAction);
+            throw new FloridayWriteRefused(reason);
+        }
+    }
+    return gateAction;
+}
+/**
+ * Mag de voorraadwachtrij überhaupt draaien? Gebruikt dezelfde poort, zodat
+ * cronjobs en achtergrondtaken elke ronde opnieuw toestemming vragen.
+ */
+export async function stockPublishAllowed() {
+    try {
+        const db = await admin();
+        const { data, error } = await db.rpc("logistics_floriday_write_allowed", {
+            _action: "stock_publish",
+        });
+        if (error)
+            return { allowed: false, reason: `poort niet leesbaar: ${error.message}` };
+        if (data !== true)
+            return { allowed: false, reason: "voorraadschakelaar staat uit" };
+        return { allowed: true, reason: null };
+    }
+    catch (e) {
+        return { allowed: false, reason: `poort niet bereikbaar: ${e?.message ?? e}` };
+    }
+}