@flowselections/logistiek-engine 1.0.112 → 1.0.113

package/dist-lib/lib/handlers/logistics-shipping-note-now.server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logistics-shipping-note-now.server.d.ts","sourceRoot":"","sources":["../../../src/lib/handlers/logistics-shipping-note-now.server.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAQ5D,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,QAAQ,CAAC,CAiGnB"}
+{"version":3,"file":"logistics-shipping-note-now.server.d.ts","sourceRoot":"","sources":["../../../src/lib/handlers/logistics-shipping-note-now.server.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAQ5D,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,QAAQ,CAAC,CA2GnB"}

package/dist-lib/lib/handlers/logistics-shipping-note-now.server.js

@@ -51,14 +51,25 @@ export async function handleShippingNoteNow(request, supabase) {
         catch {
             /* opschonen mag de ronde niet blokkeren */
         }
-        // 2. Alle openstaande aanvragen mogen nu meteen worden opgepakt.
+        // 2. Alleen de aanvraag van díe pakbon wakker maken; nooit alles.
         let wake = null;
+        let slipJobId = null;
         try {
-            const { data } = await supabase.rpc("logistics_shipping_notes_wake_all");
-            wake = data ?? null;
+            const body = (await request.clone().json().catch(() => ({})));
+            const v = typeof body["slipJobId"] === "string" ? body["slipJobId"].trim() : "";
+            slipJobId = /^[0-9a-f-]{36}$/i.test(v) ? v : null;
         }
         catch {
-            wake = null;
+            slipJobId = null;
+        }
+        if (slipJobId) {
+            try {
+                const { data } = await supabase.rpc("logistics_shipping_note_wake", { _slip_job_id: slipJobId });
+                wake = { gewekt: data ?? 0, slipJobId };
+            }
+            catch {
+                wake = null;
+            }
         }
         // 3. Gebundeld verwerken tot alles op is of het tijdbudget vol is; de knop
         //    hoeft niet te wachten tot de laatste ronde klaar is.

package/dist-lib/lib/handlers/logistics-tick.server.js

@@ -218,6 +218,14 @@ async function runTickRound(supabase, tickJob, ident) {
         catch {
             /* zelfherstel mag de ronde niet blokkeren */
         }
+        // Vrijgeven (alleen database): wachtende aanvragen van orders met een
+        // goedgekeurde controlescan, zodra de poort het aanmaken toestaat.
+        try {
+            await supabase.rpc("logistics_shipping_note_release", { _order_number: null });
+        }
+        catch {
+            /* vrijgeven mag de ronde niet blokkeren */
+        }
         const { runShippingNoteQueue } = await import("../shippingNoteQueue.server.js");
         if (typeof runShippingNoteQueue !== "function") {
             throw new Error("Deze versie van de Logistiek Engine bevat geen verzendbriefverwerking. Werk de module bij.");

package/dist-lib/lib/moduleVersion.d.ts

@@ -1,2 +1,2 @@
-export declare const MODULE_VERSION = "1.0.112";
+export declare const MODULE_VERSION = "1.0.113";
 //# sourceMappingURL=moduleVersion.d.ts.map

package/dist-lib/lib/moduleVersion.js

@@ -1,2 +1,2 @@
 // Automatisch gegenereerd door prebuild:lib; niet handmatig aanpassen.
-export const MODULE_VERSION = "1.0.112";
+export const MODULE_VERSION = "1.0.113";

package/dist-lib/lib/shippingNoteQueue.server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shippingNoteQueue.server.d.ts","sourceRoot":"","sources":["../../src/lib/shippingNoteQueue.server.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAM5D,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAqCD,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,cAAc,EAClB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,OAAO,CAAC,eAAe,CAAC,CA4V1B"}
+{"version":3,"file":"shippingNoteQueue.server.d.ts","sourceRoot":"","sources":["../../src/lib/shippingNoteQueue.server.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAO5D,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAoCD,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,cAAc,EAClB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,OAAO,CAAC,eAAe,CAAC,CAiZ1B"}

package/dist-lib/lib/shippingNoteQueue.server.js

@@ -14,8 +14,8 @@
 import { trace, newTraceId, classifyError } from "./trace.server.js";
 import { FLOW_NODE } from "./flowNodes.js";
 import { printViaLayout } from "./layoutPrint.server.js";
-/** Na dit aantal pogingen is een aanvraag definitief mislukt. */
-const MAX_ATTEMPTS = 60;
+import { SHIPPING_NOTE_DEFINITIEVE_FOUTEN, definitieveFout, parseMaxAttempts } from "./shippingNoteStates.js";
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 function pickPdf(result) {
     const base64 = result["pdfBase64"] ??
         result["base64"] ??
@@ -41,6 +41,13 @@ export async function runShippingNoteQueue(sb, options = {}) {
         failed: 0,
         errors: [],
     };
+    // Grens uit de instelling (zelfde als in de database). Ontbreekt hij: niets oppakken.
+    const { data: maxData } = await sb.rpc("logistics_shipping_note_max_attempts");
+    const MAX_ATTEMPTS = parseMaxAttempts(maxData);
+    if (MAX_ATTEMPTS === null) {
+        run.errors.push("De instelling logistics_shipping_note_max_attempts ontbreekt of is ongeldig (1-200); er worden geen verzendbrieven opgehaald.");
+        return run;
+    }
     const { data, error } = await sb.rpc("logistics_slip_note_claim", {
         _limit: options.limit ?? 10,
         _lease_seconds: 120,
@@ -98,7 +105,30 @@ export async function runShippingNoteQueue(sb, options = {}) {
                 ...(fulfillmentOrderId ? { externalRef: fulfillmentOrderId } : {}),
             });
         };
+        const definitief = async (code, detail) => {
+            const f = SHIPPING_NOTE_DEFINITIEVE_FOUTEN[code];
+            await faal(code, `${f.reden}${detail ? ` (${detail})` : ""} Advies: ${f.advies}`, row.fulfillment_order_id);
+        };
+        // Poort weigert of nog geen goedgekeurde controlescan: wacht op vrijgave, telt niet als poging.
+        const houdVast = async (reden) => {
+            await sb.rpc("logistics_slip_note_hold", { _id: row.id, _reason: reden });
+            run.waiting++;
+            await trace(sb, {
+                ...basis,
+                step: "Wacht op vrijgave",
+                status: "wachtend",
+                decision: "wacht_op_vrijgave",
+                reason: reden,
+                rule: "De officiële Floriday-verzendbrief wordt pas na de controlescan aangemaakt",
+                nextStep: "Gaat vanzelf verder na een goedgekeurde controlescan met de poort open",
+            });
+        };
         const wacht = async (reden, klasse) => {
+            const code = definitieveFout(reden);
+            if (code) {
+                await definitief(code, reden);
+                return;
+            }
             if (attempts >= MAX_ATTEMPTS) {
                 await faal("wachten_verlopen", `Na ${attempts} pogingen is er nog steeds geen officiële verzendbrief. Laatste reden: ${reden}`);
                 return;
@@ -133,12 +163,14 @@ export async function runShippingNoteQueue(sb, options = {}) {
                 await faal("geen_ordernummer", "Bij deze kar hoort geen ordernummer; de verzendbrief kan niet worden opgehaald.");
                 continue;
             }
-            // Een verzendbrief ophalen is een leesactie. Wacht daarom niet op de
-            // status-/afhandelpush: die is bewust geblokkeerd tot na de controlescan.
+            if (!row.order_id || !UUID_RE.test(row.order_id)) {
+                await definitief("geen_order_id");
+                continue;
+            }
             const { data: order, error: orderError } = await sb
                 .from("orders")
                 .select("floriday_sales_order_id")
-                .eq("id", row.order_id ?? "")
+                .eq("id", row.order_id)
                 .maybeSingle();
             if (orderError) {
                 await wacht(`De Floriday-order kon niet worden gelezen: ${orderError.message}`, "tijdelijk");
@@ -165,6 +197,16 @@ export async function runShippingNoteQueue(sb, options = {}) {
             // aangemaakt.
             let bestaandeFo = String(row.fulfillment_order_id ?? "").trim() || null;
             if (!bestaandeFo) {
+                // Pas ná een goedgekeurde controlescan laten aanmaken.
+                const { data: goedgekeurd, error: goedError } = await sb.rpc("logistics_floriday_order_approved", {
+                    _order_ref: row.order_number,
+                });
+                if (goedError || goedgekeurd !== true) {
+                    await houdVast(goedError
+                        ? "De goedkeuring van de controlescan kan niet gelezen worden; er gaat niets naar Floriday."
+                        : "Wacht op een goedgekeurde controlescan voordat Floriday de verzendbrief aanmaakt.");
+                    continue;
+                }
                 const { createFlorydayDeliveryNote } = await import("./floridayDocuments.server.js");
                 const startAanmaak = Date.now();
                 const aangemaakt = await createFlorydayDeliveryNote(sb, row.order_number);
@@ -187,6 +229,10 @@ export async function runShippingNoteQueue(sb, options = {}) {
                         .eq("id", row.id)
                         .is("fulfillment_order_id", null);
                 }
+                else if (aangemaakt.skipped) {
+                    await houdVast(aangemaakt.error ?? "De poort staat het aanmaken van de verzendbrief niet toe.");
+                    continue;
+                }
                 else if (!aangemaakt.ok) {
                     await wacht(`Wachten op Floriday-verzendbrief: ${aangemaakt.error ?? "Floriday heeft het document nog niet aangemaakt."}`, aangemaakt.skipped ? "nog_niet_beschikbaar" : classifyFloridayReason(aangemaakt.error ?? ""));
                     continue;

package/dist-lib/lib/shippingNoteStates.d.ts

@@ -0,0 +1,26 @@
+export declare const SHIPPING_NOTE_STATUSSEN: readonly ["wachtend", "wacht_op_vrijgave", "geprint", "mislukt"];
+export type ShippingNoteStatusWaarde = (typeof SHIPPING_NOTE_STATUSSEN)[number];
+/** Definitieve fouten: direct mislukt, nooit opnieuw proberen. */
+export declare const SHIPPING_NOTE_DEFINITIEVE_FOUTEN: {
+    readonly geen_order_id: {
+        readonly reden: "Bij deze pakbon hoort geen geldige order; de verzendbrief kan niet worden opgehaald.";
+        readonly advies: "Print de pakbon opnieuw vanaf het pickstation, zodat de order wordt meegegeven.";
+    };
+    readonly geen_karindeling: {
+        readonly reden: "Er is geen (volledige) karindeling voor deze order; Floriday kan de verzendbrief niet maken.";
+        readonly advies: "Plan de order opnieuw in op karren en print daarna de pakbon opnieuw.";
+    };
+    readonly ongeldige_gegevens: {
+        readonly reden: "De gegevens van deze order zijn ongeldig voor Floriday.";
+        readonly advies: "Controleer de order (artikelen, karren, lagen) en druk daarna op 'Opnieuw starten'.";
+    };
+};
+export type ShippingNoteDefinitieveFout = keyof typeof SHIPPING_NOTE_DEFINITIEVE_FOUTEN;
+/** Instelling in module_runtime_config; geheel getal 1..200, startwaarde 60. */
+export declare const SHIPPING_NOTE_MAX_ATTEMPTS_KEY = "logistics_shipping_note_max_attempts";
+export declare const SHIPPING_NOTE_MAX_ATTEMPTS_MIN = 1;
+export declare const SHIPPING_NOTE_MAX_ATTEMPTS_MAX = 200;
+export declare function parseMaxAttempts(value: unknown): number | null;
+/** Herkent een definitieve fout in een foutmelding; null = mogelijk tijdelijk. */
+export declare function definitieveFout(message: string): ShippingNoteDefinitieveFout | null;
+//# sourceMappingURL=shippingNoteStates.d.ts.map

package/dist-lib/lib/shippingNoteStates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shippingNoteStates.d.ts","sourceRoot":"","sources":["../../src/lib/shippingNoteStates.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,uBAAuB,kEAAmE,CAAC;AACxG,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhF,kEAAkE;AAClE,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;CAanC,CAAC;AACX,MAAM,MAAM,2BAA2B,GAAG,MAAM,OAAO,gCAAgC,CAAC;AAExF,gFAAgF;AAChF,eAAO,MAAM,8BAA8B,yCAAyC,CAAC;AACrF,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAChD,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAElD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAG9D;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,2BAA2B,GAAG,IAAI,CAKnF"}

package/dist-lib/lib/shippingNoteStates.js

@@ -0,0 +1,38 @@
+// ============================================================================
+// Toegestane waarden van de verzendbriefwachtrij (09-10-2026).
+// Zelfde waarden als in de database (logistics_slip_shipping_note, module_runtime_config).
+// ============================================================================
+export const SHIPPING_NOTE_STATUSSEN = ["wachtend", "wacht_op_vrijgave", "geprint", "mislukt"];
+/** Definitieve fouten: direct mislukt, nooit opnieuw proberen. */
+export const SHIPPING_NOTE_DEFINITIEVE_FOUTEN = {
+    geen_order_id: {
+        reden: "Bij deze pakbon hoort geen geldige order; de verzendbrief kan niet worden opgehaald.",
+        advies: "Print de pakbon opnieuw vanaf het pickstation, zodat de order wordt meegegeven.",
+    },
+    geen_karindeling: {
+        reden: "Er is geen (volledige) karindeling voor deze order; Floriday kan de verzendbrief niet maken.",
+        advies: "Plan de order opnieuw in op karren en print daarna de pakbon opnieuw.",
+    },
+    ongeldige_gegevens: {
+        reden: "De gegevens van deze order zijn ongeldig voor Floriday.",
+        advies: "Controleer de order (artikelen, karren, lagen) en druk daarna op 'Opnieuw starten'.",
+    },
+};
+/** Instelling in module_runtime_config; geheel getal 1..200, startwaarde 60. */
+export const SHIPPING_NOTE_MAX_ATTEMPTS_KEY = "logistics_shipping_note_max_attempts";
+export const SHIPPING_NOTE_MAX_ATTEMPTS_MIN = 1;
+export const SHIPPING_NOTE_MAX_ATTEMPTS_MAX = 200;
+export function parseMaxAttempts(value) {
+    const n = typeof value === "number" ? value : typeof value === "string" && /^\d{1,3}$/.test(value.trim()) ? Number(value) : NaN;
+    return Number.isInteger(n) && n >= SHIPPING_NOTE_MAX_ATTEMPTS_MIN && n <= SHIPPING_NOTE_MAX_ATTEMPTS_MAX ? n : null;
+}
+/** Herkent een definitieve fout in een foutmelding; null = mogelijk tijdelijk. */
+export function definitieveFout(message) {
+    if (/invalid input syntax|uuid|geen (geldige )?order/i.test(message))
+        return "geen_order_id";
+    if (/karindeling|geen kar(ren)? ingedeeld/i.test(message))
+        return "geen_karindeling";
+    if (/hoort bij (g|een andere)|ongeldig|invalid|validation|422|400/i.test(message))
+        return "ongeldige_gegevens";
+    return null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowselections/logistiek-engine",
-  "version": "1.0.112",
+  "version": "1.0.113",
   "flowselections": {
     "moduleId": "logistiek-engine",
     "pages": [