@flowselections/logistiek-engine 1.0.112 → 1.0.117

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

@@ -1 +1 @@
-{"version":3,"file":"modulePrompts.d.ts","sourceRoot":"","sources":["../../src/lib/modulePrompts.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;CAIvB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,oBAAoB,CAAC;AAKhE,MAAM,WAAW,oBAAoB;IACnC,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iFAAiF;IACjF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,oBAAoB,EAAE,CAAC;CACnC;AAy5ID,eAAO,MAAM,cAAc,EAAE,YAAY,EAUL,CAAC;AAErC,gEAAgE;AAChE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,oBAAoB,GAC7B,MAAM,CAmBR;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAE9D;AAED,oEAAoE;AACpE,wBAAgB,qBAAqB,IAAI,MAAM,CAiB9C;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,eAAe,EAC1B,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CAIR"}
+{"version":3,"file":"modulePrompts.d.ts","sourceRoot":"","sources":["../../src/lib/modulePrompts.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;CAIvB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,oBAAoB,CAAC;AAKhE,MAAM,WAAW,oBAAoB;IACnC,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iFAAiF;IACjF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,oBAAoB,EAAE,CAAC;CACnC;AAuiJD,eAAO,MAAM,cAAc,EAAE,YAAY,EAUL,CAAC;AAErC,gEAAgE;AAChE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,oBAAoB,GAC7B,MAAM,CAmBR;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAE9D;AAED,oEAAoE;AACpE,wBAAgB,qBAAqB,IAAI,MAAM,CAiB9C;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,eAAe,EAC1B,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CAIR"}

package/dist-lib/lib/modulePrompts.js

@@ -3325,6 +3325,146 @@ CONTROLELIJST
 [ ] De verzendbrief gaat naar dezelfde printer als de pakbon.
 [ ] De order blijft open tot de controlescan.`,
             },
+            {
+                number: 40,
+                title: "Pakbon per kar: alleen de eigen kar, nooit geprint zonder opdracht",
+                date: "2026-10-09",
+                summary: "Een rij van één kar print alleen die kar; een kar wordt pas als geprint gemarkeerd als er echt een printopdracht is; de pakbonsleutel bevat de kar.",
+                body: `AANVULLING; eerdere prompts blijven gelden.
+
+VASTGESTELDE FOUT (16-09 t/m 01-10)
+Vanaf een rij die bij één kar hoort, vroeg het pickscherm via
+pick_complete_print_carts alle karren van de order aan. Alleen kar 1 kreeg een
+opdracht; kar 2 t/m n werden door de ontdubbeling (print_jobs_dedupe, sleutel
+zonder kar) als dubbel overgeslagen. pick_complete_print_carts zette die karren
+toch in printed_cart_ids. Zo kregen 28 karren nooit een pakbon, terwijl ze als
+geprint stonden.
+
+WAT DE ENGINE AL HEEFT GEDAAN (live)
+- pick_queue_cart_plan geeft bij een rij met een eigen kar (payload.cartId)
+  alleen die kar terug: totalCarts = 1, cartTotal = totaal van order/buffer,
+  rowCartId = de kar. Staat de kar niet meer in het plan, dan een fout
+  "De kar van deze rij bestaat niet meer in het karplan; ververs de
+  pickwachtrij." Rijen zonder eigen kar en buffers: ongewijzigd.
+- pick_enqueue_print_job (per kar) geeft idempotentie_sleutel
+  pakbon:<queue_item_id>:<cart_id>:<layout_id|->:<printer_id|-> mee; bij een
+  herprint geen sleutel (de trigger maakt die uniek).
+
+WAT JIJ BOUWT
+1. Bied bij een rij met een eigen kar alleen die kar aan en print alleen die.
+   Geen knop "alle karren" op een rij van één kar. Stuur nooit cart-id's mee
+   die niet in pick_queue_cart_plan van die rij staan (anders volgt nu een
+   fout en print er niets).
+2. pick_complete_print_carts, pick_complete_print_cart en pick_complete_print:
+   zet een kar alleen in printed_cart_ids, en de rij alleen op geprint, als er
+   echt een printopdracht is aangemaakt (job_id niet leeg). Is er geen
+   opdracht, laat de kar open en geef per kar de melding: "Pakbon voor kar X
+   is niet aangemaakt (dubbel binnen 10 minuten of geweigerd); probeer opnieuw
+   of kies Herprint."
+3. pick_enqueue_print_job_from_cart: geef dezelfde sleutel per kar mee als de
+   Engine (pakbon:<queue_item_id>:<cart_id>:<layout_id|->:<printer_id|->), en
+   geen sleutel bij een herprint.
+4. Toon de fout "De kar van deze rij bestaat niet meer in het karplan;
+   ververs de pickwachtrij" letterlijk in het scherm bij die rij, met een knop
+   "Wachtrij verversen". Markeer niets als geprint en probeer niet zelf een
+   andere kar.
+5. "Kar X van Y": X = cartSeq van de kar, Y = cartTotal (van het plan of van de
+   kar). Gebruik NOOIT totalCarts uit het karplan van een rij; dat is bij een
+   rij met eigen kar altijd 1.
+6. Een eerdere opdracht met status mislukt of geannuleerd blokkeert een nieuwe
+   poging voor dezelfde kar niet (getest 09-10). Toon na zo'n fout gewoon
+   opnieuw de printknop.
+7. Geen DELETE of UPDATE zonder WHERE (safeupdate staat aan).
+8. Test via de app-route met een tijdelijke testfunctie (alleen service_role),
+   eerst safeupdate aantonen, altijd eindigen met een opzettelijke fout zodat
+   alles wordt teruggedraaid; niets echt printen.
+
+WAT JE NIET DOET
+- print_jobs_dedupe aanpassen (Layout maker).
+- Zelf karren samenstellen of uit het order-karplan halen.
+- Geen URL's, sleutels, project-refs, klantnamen of vaste id's in code.
+
+CONTROLELIJST
+[ ] Rij van één kar: precies één pakbon, voor die kar.
+[ ] Meerdere karren onder een orderregel: één opdracht per kar.
+[ ] Dezelfde kar binnen 10 minuten opnieuw: overgeslagen en duidelijk gemeld,
+    kar blijft open.
+[ ] Herprint geeft altijd een nieuwe opdracht.
+[ ] Geen kar staat op geprint zonder printopdracht.
+[ ] Meld terug met je pakketversie.`,
+            },
+            {
+                number: 41,
+                title: "Sets met onderdelen en verdeelmeldingen",
+                date: "2026-10-12",
+                summary: "Een set staat als één pakket op de kar met daaronder de onderdelen op het laagste niveau; groepen zijn al in leden uitgesplitst; meldingen letterlijk tonen.",
+                body: `AANVULLING; bouwt voort op koppelprompt 40 en Pickschermen 1.0.25.
+Eerdere prompts blijven gelden.
+
+INSTALLATIEVOLGORDE
+Eerst Logistiek Engine 1.0.116 installeren, daarna de nieuwe Pickschermen-versie.
+Draait de Engine nog niet op 1.0.116, dan ontbreken de onderdelen; toon dan
+"onderdelen onbekend" (zie punt 5).
+
+BRON (de enige)
+- Lees de karrijen en onderdelen uit de bestaande functie
+  pick_queue_cart_plan(queue_item_id) → carts[].items[].components.
+  (Die functie haalt per order logistics_cart_slip_plan op; dezelfde rechten als
+  nu, anon mag hem uitvoeren.)
+- GEEN directe tabeltoegang: lees order_cart_items, logistics_reservation_allocations
+  of andere Engine-tabellen nooit rechtstreeks (geen .from(...)). Alleen via
+  pick_queue_cart_plan.
+
+WAT DE ENGINE AL HEEFT GEDAAN (live)
+- De karindeling gebruikt dezelfde verdeling als reservering en afboeken.
+- Een set gaat als één pakket in de kar (eigen afmeting/belading van de set).
+- carts[].items[].components (lijst) bij een setregel: per onderdeel
+  { trade_item_key, product_id, product_name, article_number, qty }. Het aantal
+  is een heel getal en geldt voor de sets op díe kar. Bij een set binnen een set
+  staan hier al de echte onderdelen op het laagste niveau. Bij andere regels is
+  de lijst leeg.
+- carts[].items[].isSet (boolean): true bij een setregel, anders false. Ook true
+  bij een setregel waarvan de onderdelen (nog) ontbreken.
+- Een groep is al in leden uitgesplitst: één kar-regel per lid.
+- warnings (lijst met tekst) in het resultaat van pick_queue_cart_plan:
+  · warnings bovenaan: de meldingen van de rij (bij een rij met eigen kar alleen
+    die van de order van die kar; bij een buffer alle orders, zonder dubbele);
+  · orders[] = { orderId, orderNumber, warnings } per order in de rij.
+  Alleen actuele meldingen; leeg ([]) als er niets speelt. Mogelijke teksten:
+  "voorraadtekort op <lid> voor bevroren regel <order>; verdeling niet aangepast"
+  en "groepsregel en ledenregels tegelijk; groepsregel niet meegeteld".
+
+WAT JIJ BOUWT
+1. Setrij: toon de set als één pakket (naam, artikelnummer, aantal sets, kar)
+   met daaronder ingesprongen de onderdelen uit components (onderdeel,
+   artikelnummer, aantal). Niets zelf uitsplitsen of herberekenen.
+2. Afvinken gebeurt op de setrij (het aantal sets). Onderdelen zijn alleen
+   informatie en krijgen geen eigen afvinkknop.
+3. Groepsleden zijn gewone rijen; toon geen groepshoofd als aparte rij.
+4. Toon de teksten uit warnings letterlijk bij de order of rij (orders[].warnings
+   bij de betreffende order, anders warnings bovenaan). Lege lijst: niets tonen.
+   Altijd Array.isArray vóór map. Zelf geen meldingen samenstellen.
+   De melding "De kar van deze rij bestaat niet meer in het karplan; ververs de
+   pickwachtrij" komt als fout van pick_queue_cart_plan; toon die letterlijk.
+5. isSet = true en components ontbreekt, is geen lijst of is leeg: toon
+   "onderdelen onbekend" en laat afvinken gewoon toe. isSet = false: gewone
+   regel, geen onderdelenblok en geen melding. Altijd Array.isArray vóór map/filter.
+6. Geen eigen voorraad- of reserveringslogica, geen schrijfacties op orderregels.
+7. Geen DELETE of UPDATE zonder WHERE (safeupdate staat aan).
+
+WAT JE NIET DOET
+- Aantallen afleiden uit de setsamenstelling of groepen op naam herkennen.
+- De Engine-pakketversie aanpassen.
+- Geen URL's, sleutels, project-refs, klantnamen of vaste id's in code.
+
+CONTROLELIJST
+[ ] Setrij met onderdelen, ook bij een set binnen een set.
+[ ] Onderdelen komen alleen uit pick_queue_cart_plan; geen .from() op Engine-tabellen.
+[ ] Groepsorder toont alleen ledenrijen.
+[ ] Tekortmelding en groepsmelding letterlijk zichtbaar, uit warnings; lege lijst toont niets.
+[ ] isSet true zonder onderdelen: "onderdelen onbekend", afvinken werkt; isSet false: gewone rij.
+[ ] Typecheck en build:lib geslaagd; meld terug met je pakketversie.`,
+            },
         ],
     },
     scanners: {

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.117";
 //# 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.117";

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.117",
   "flowselections": {
     "moduleId": "logistiek-engine",
     "pages": [