@flowselections/logistiek-engine 1.0.53 → 1.0.89

package/dist-lib/lib/resolveBuffer.test.js

@@ -0,0 +1,38 @@
+import { describe, it, expect } from "vitest";
+import { resolveBufferForOrderInternal } from "./loadCarrierPlanning.server";
+function fakeClient(initial, afterRpc) {
+    const calls = { rpc: 0, writes: 0 };
+    let current = initial;
+    const client = {
+        from(table) {
+            return {
+                select: () => ({
+                    eq: () => ({
+                        maybeSingle: async () => ({ data: table === "orders" ? { id: "o1", buffer_id: current } : null }),
+                    }),
+                }),
+                update: () => { calls.writes++; return { eq: async () => ({}) }; },
+                insert: () => { calls.writes++; return { select: () => ({ single: async () => ({}) }) }; },
+            };
+        },
+        async rpc() { calls.rpc++; current = afterRpc; return { error: null }; },
+    };
+    return { client: client, calls };
+}
+describe("resolveBufferForOrderInternal (alleen lezen)", () => {
+    it("gebruikt de bestaande buffer zonder iets te schrijven", async () => {
+        const { client, calls } = fakeClient("b1", "b2");
+        expect(await resolveBufferForOrderInternal(client, "o1")).toBe("b1");
+        expect(calls).toEqual({ rpc: 0, writes: 0 });
+    });
+    it("laat de database beslissen als er nog geen buffer is", async () => {
+        const { client, calls } = fakeClient(null, "b9");
+        expect(await resolveBufferForOrderInternal(client, "o1")).toBe("b9");
+        expect(calls).toEqual({ rpc: 1, writes: 0 });
+    });
+    it("maakt nooit zelf een buffer als de database er geen geeft", async () => {
+        const { client, calls } = fakeClient(null, null);
+        expect(await resolveBufferForOrderInternal(client, "o1")).toBeNull();
+        expect(calls.writes).toBe(0);
+    });
+});

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

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

package/dist-lib/lib/ruleEngineSchema.js

@@ -985,6 +985,58 @@ export const RULE_STEPS = [
             },
         ],
     },
+    {
+        id: "opruimen",
+        label: "Opruimen",
+        icon: "trash",
+        description: "Hoe lang bewaart de engine afgeronde en geannuleerde taken voordat ze worden opgeruimd?",
+        supportsConditions: false,
+        groups: [
+            {
+                id: "opruimen",
+                label: "Bewaartermijn",
+                description: "Afgeronde, overgeslagen en geannuleerde taken worden na deze termijn verwijderd. Lopende en geplande taken blijven altijd staan. Zonder ingevulde termijn wordt er niets opgeruimd.",
+                fields: [
+                    {
+                        key: "task_retention_days",
+                        default: 90,
+                        label: "Afgeronde taken bewaren (dagen)",
+                        type: "number",
+                        min: 1,
+                        max: 3650,
+                        description: "Laat dit leeg om niets op te ruimen. Karren, karnummers en totalen van afgehandelde of gecontroleerde karren blijven hoe dan ook behouden.",
+                    },
+                    {
+                        key: "trace_retention_days",
+                        default: 30,
+                        label: "Logboekregels bewaren (dagen)",
+                        type: "number",
+                        min: 1,
+                        max: 3650,
+                        description: "Na deze termijn worden logboekregels van orders opgeruimd. Laat leeg om niets op te ruimen.",
+                    },
+                    {
+                        key: "pick_history_retention_days",
+                        default: 180,
+                        label: "Pickhistorie bewaren (dagen)",
+                        type: "number",
+                        min: 1,
+                        max: 3650,
+                        description: "Na deze termijn wordt de historie van de pickstations opgeruimd. Laat leeg om niets op te ruimen.",
+                    },
+                    {
+                        key: "barcode_retention_days",
+                        default: 30,
+                        label: "Barcodes van verdwenen karren bewaren (dagen)",
+                        type: "number",
+                        min: 1,
+                        max: 3650,
+                        description: "Alleen barcodes van karren die niet meer bestaan en nooit zijn geprint, gescand of gecontroleerd. Laat leeg om niets op te ruimen.",
+                    },
+                ],
+            },
+        ],
+    },
 ];
 export function defaultStepSettings(step) {
     const fields = {};

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

@@ -0,0 +1,43 @@
+import type { TraceOrderStand } from "../hooks/useOrderTrace";
+import type { ShippingNoteDiagnose } from "../hooks/useShippingNoteDiagnose";
+import type { NodeTraceGroep } from "./nodeTrace";
+export type StopSoort = "mislukt" | "wachtrij" | "handeling" | "nietvastgelegd" | "klaar";
+export interface StopReden {
+    soort: StopSoort;
+    /** Korte kop, bijvoorbeeld "Hier is de order vastgelopen". */
+    titel: string;
+    /** Waarom de reis hier ophoudt. */
+    reden: string;
+    /** Bepalende gegevens, als korte regels. */
+    feiten: string[];
+    /** Wat er hierna moet gebeuren. */
+    volgendeStap: string | null;
+    /** De route is elders opgehouden door een gewijzigde instelling. */
+    verouderd: boolean;
+}
+/**
+ * Waarom de flow bij een samenkomstpunt blijft staan: de ingestelde voorwaarde
+ * is nog niet gehaald, of een verplichte tak is mislukt.
+ */
+export declare function samenkomstStop(input: {
+    wachtOp: string[];
+    mislukt?: string[];
+    voorwaarde: string;
+    maxWachtMinuten: number;
+}): StopReden;
+/**
+ * Bepaalt in gewone taal waarom de blauwe route bij dit vakje ophoudt.
+ * Werkt ook als er voor dit vakje nog niets is vastgelegd.
+ */
+export declare function stopReden(input: {
+    nodeId: string;
+    groep?: NodeTraceGroep | null;
+    stand?: TraceOrderStand | null;
+    verouderd?: boolean;
+}): StopReden;
+/**
+ * Waarom is de verzendbrief bij deze order nog niet opgehaald? Zet de
+ * alleen-lezen diagnose om naar dezelfde stoptekst als de rest van de kaart.
+ */
+export declare function verzendbriefStop(d: ShippingNoteDiagnose | null | undefined): StopReden | null;
+//# sourceMappingURL=stopReden.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stopReden.d.ts","sourceRoot":"","sources":["../../src/lib/stopReden.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAG7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,gBAAgB,GAAG,OAAO,CAAC;AAE1F,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,SAAS,CAAC;IACjB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,mCAAmC;IACnC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,oEAAoE;IACpE,SAAS,EAAE,OAAO,CAAC;CACpB;AAiBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB,GAAG,SAAS,CA+BZ;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GAAG,SAAS,CA+FZ;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI,CAsC7F"}

package/dist-lib/lib/stopReden.js

@@ -0,0 +1,197 @@
+// ============================================================================
+// src/lib/stopReden.ts — waarom houdt de reis van deze order hier op?
+// ============================================================================
+// Eén bron van waarheid voor de tekst "Hier stopt de flow", die op het vakje in
+// de kaart, in het zijpaneel en in de balk boven de kaart wordt getoond.
+// Alleen lezen: hier wordt niets bepaald of gewijzigd.
+// ============================================================================
+import { FLOW_NODE, flowNodeLabel } from "./flowNodes";
+import { foutSoort, foutTekst } from "./foutTekst";
+import { vakUitleg } from "./vakUitleg";
+const WACHTRIJ_TEKST = {
+    pending: "de berekening staat in de wachtrij en is nog niet opgepakt",
+    queued: "de berekening staat in de wachtrij en is nog niet opgepakt",
+    running: "de berekening is op dit moment bezig",
+    blocked: "de berekening is geblokkeerd",
+    failed: "de laatste berekening is mislukt",
+};
+function tijdTekst(waarde) {
+    if (!waarde)
+        return null;
+    const d = new Date(waarde);
+    if (Number.isNaN(d.getTime()))
+        return null;
+    return d.toLocaleString("nl-NL", { day: "2-digit", month: "2-digit", hour: "2-digit", minute: "2-digit" });
+}
+/**
+ * Waarom de flow bij een samenkomstpunt blijft staan: de ingestelde voorwaarde
+ * is nog niet gehaald, of een verplichte tak is mislukt.
+ */
+export function samenkomstStop(input) {
+    const wachtOp = Array.isArray(input.wachtOp) ? input.wachtOp : [];
+    const mislukt = Array.isArray(input.mislukt) ? input.mislukt : [];
+    const feiten = [
+        `Voorwaarde: ${input.voorwaarde}`,
+        `Maximale wachttijd: ${input.maxWachtMinuten} minuten`,
+    ];
+    if (wachtOp.length > 0)
+        feiten.push(`Nog niet klaar: ${wachtOp.join(", ")}`);
+    if (mislukt.length > 0) {
+        return {
+            soort: "mislukt",
+            titel: "Hier wacht de flow op een tak die is mislukt",
+            reden: `De verplichte tak ${mislukt.join(", ")} is mislukt, dus dit samenkomstpunt laat de order niet door.`,
+            feiten,
+            volgendeStap: "Oorzaak in die tak oplossen, of de voorwaarde van dit samenkomstpunt aanpassen",
+            verouderd: false,
+        };
+    }
+    return {
+        soort: "handeling",
+        titel: "De flow wacht hier op andere takken",
+        reden: wachtOp.length > 0
+            ? `Dit samenkomstpunt laat de order pas door als ${input.voorwaarde} klaar is. Nog niet klaar: ${wachtOp.join(", ")}.`
+            : `Dit samenkomstpunt laat de order pas door als ${input.voorwaarde} klaar is.`,
+        feiten,
+        volgendeStap: `Wachten tot die tak klaar is; na ${input.maxWachtMinuten} minuten gaat de flow alsnog verder`,
+        verouderd: false,
+    };
+}
+/**
+ * Bepaalt in gewone taal waarom de blauwe route bij dit vakje ophoudt.
+ * Werkt ook als er voor dit vakje nog niets is vastgelegd.
+ */
+export function stopReden(input) {
+    const { nodeId, groep = null, stand = null } = input;
+    const verouderd = input.verouderd === true;
+    const uitleg = groep ? vakUitleg(groep) : null;
+    const feiten = uitleg ? [...uitleg.feiten] : [];
+    const vervolg = groep?.volgendeStap ?? stand?.nextStep ?? null;
+    const vakNaam = flowNodeLabel(nodeId);
+    const queue = (stand?.queueStatus ?? "").toLowerCase();
+    const standHier = !stand?.stuckNode || stand.stuckNode === nodeId;
+    // 1. Mislukt: er is een echte fout vastgelegd.
+    const foutmelding = groep?.status === "mislukt"
+        ? foutTekst(groep.reden ?? null)
+        : standHier && stand?.stuckStatus === "mislukt"
+            ? foutTekst(stand.stuckReason ?? stand.stuckError ?? stand.queueError ?? null)
+            : null;
+    if (foutmelding || queue === "failed") {
+        const soortFout = groep?.errorClass ?? foutSoort(stand?.stuckReason ?? stand?.queueError ?? null) ?? null;
+        if (soortFout)
+            feiten.push(`Foutsoort: ${soortFout}`);
+        if (stand?.tries && stand.tries > 0)
+            feiten.push(`Automatische pogingen: ${stand.tries}`);
+        const volgende = tijdTekst(stand?.nextAttemptAt);
+        if (volgende)
+            feiten.push(`Volgende poging: ${volgende}`);
+        const sinds = tijdTekst(stand?.blockedSince);
+        if (sinds)
+            feiten.push(`Geblokkeerd sinds: ${sinds}`);
+        return {
+            soort: "mislukt",
+            titel: "Hier is de order vastgelopen",
+            reden: foutmelding ??
+                foutTekst(stand?.queueError ?? null) ??
+                `De berekening van ${vakNaam} is mislukt.`,
+            feiten,
+            volgendeStap: vervolg ?? "Oorzaak oplossen en de order opnieuw aanmelden in de wachtrij",
+            verouderd,
+        };
+    }
+    // 2. Helemaal klaar.
+    if (nodeId === FLOW_NODE.eind) {
+        return {
+            soort: "klaar",
+            titel: "Hier eindigt de reis: de order is afgehandeld",
+            reden: uitleg?.waarom ?? "Alle karren zijn gepickt en gecontroleerd.",
+            feiten,
+            volgendeStap: null,
+            verouderd,
+        };
+    }
+    // 3. De berekening loopt nog of staat in de wachtrij.
+    if (queue && WACHTRIJ_TEKST[queue]) {
+        if (stand?.attempts && stand.attempts > 0)
+            feiten.push(`Pogingen: ${stand.attempts}`);
+        const volgende = tijdTekst(stand?.nextAttemptAt);
+        if (volgende)
+            feiten.push(`Volgende poging: ${volgende}`);
+        return {
+            soort: "wachtrij",
+            titel: "De flow staat hier stil: de berekening is nog niet klaar",
+            reden: `De reis houdt op bij ${vakNaam} omdat ${WACHTRIJ_TEKST[queue]}.`,
+            feiten,
+            volgendeStap: vervolg,
+            verouderd,
+        };
+    }
+    // 4. Wacht op een handeling (picken, printen, scannen, controle).
+    if (groep?.status === "wachtend" || groep?.status === "waarschuwing") {
+        return {
+            soort: "handeling",
+            titel: "De flow wacht hier",
+            reden: uitleg?.waarom ??
+                `${vakNaam} is nog niet afgerond; de order wacht op de volgende handeling.`,
+            feiten,
+            volgendeStap: vervolg,
+            verouderd,
+        };
+    }
+    // 5. Deze stap is geslaagd, maar van de vervolgstap is nog niets vastgelegd.
+    return {
+        soort: "nietvastgelegd",
+        titel: "De flow stopt hier: verder is nog niets vastgelegd",
+        reden: vervolg
+            ? `${vakNaam} is afgerond, maar de volgende stap "${vervolg}" heeft voor deze order nog geen start, status of resultaat vastgelegd. Daarom kan de blauwe route nog niet aantonen dat de order daar is aangekomen.`
+            : `${vakNaam} is afgerond, maar er is voor deze order geen volgende stap of vervolgstatus vastgelegd. Daarom eindigt de aantoonbare blauwe route hier.`,
+        feiten,
+        volgendeStap: vervolg
+            ? `De stap "${vervolg}" moet starten en voor deze order een status of resultaat vastleggen.`
+            : "Controleer welke vervolgstap na dit vakje hoort te starten en waarom die nog geen status heeft vastgelegd.",
+        verouderd,
+    };
+}
+/**
+ * Waarom is de verzendbrief bij deze order nog niet opgehaald? Zet de
+ * alleen-lezen diagnose om naar dezelfde stoptekst als de rest van de kaart.
+ */
+export function verzendbriefStop(d) {
+    if (!d || !d.gevonden)
+        return null;
+    const status = (d.status ?? "").toLowerCase();
+    if (status === "geprint" || status === "klaar")
+        return null;
+    const feiten = [];
+    if (d.status)
+        feiten.push(`Status: ${d.status}`);
+    feiten.push(d.isFloriday
+        ? `Aanvragen naar Floriday: ${d.aanvragenVerstuurd}`
+        : "Eigen verzendbrief (geen Floriday-order)");
+    if (d.pogingen > 0)
+        feiten.push(`Pogingen: ${d.pogingen}`);
+    const laatste = tijdTekst(d.laatsteAanvraag);
+    if (laatste)
+        feiten.push(`Laatste aanvraag: ${laatste}`);
+    if (d.afleveropdracht)
+        feiten.push(`Afleveropdracht: ${d.afleveropdracht}`);
+    if (d.wachtreden)
+        feiten.push(`Wachtreden: ${d.wachtreden}`);
+    // Een Floriday-order die wacht zonder ook maar één aanvraag is een fout in de
+    // omgeving, geen normale toestand. Ook een mislukte status is een fout.
+    const fout = status === "failed" ||
+        status === "mislukt" ||
+        status === "error" ||
+        (d.isFloriday && d.aanvragenVerstuurd === 0 && d.pogingen > 0);
+    return {
+        soort: fout ? "mislukt" : "handeling",
+        titel: fout ? "Hier loopt de verzendbrief vast" : "De verzendbrief is nog niet opgehaald",
+        reden: d.reden ??
+            (d.isFloriday
+                ? "Er is nog geen officiele Floriday-afleverbrief opgehaald voor deze order."
+                : "De verzendbrief voor deze order is nog niet aangemaakt."),
+        feiten,
+        volgendeStap: d.actie ?? null,
+        verouderd: false,
+    };
+}

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

@@ -0,0 +1,2 @@
+export declare function tellOpenTaken(rows: unknown): Record<string, number>;
+//# sourceMappingURL=taskCounts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"taskCounts.d.ts","sourceRoot":"","sources":["../../src/lib/taskCounts.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUnE"}

package/dist-lib/lib/taskCounts.js

@@ -0,0 +1,15 @@
+// Takenteller: zet de databasetelling (open/geplande taken per module) om naar een map.
+// Fail-closed: onleesbare invoer levert een lege telling op, geen verzonnen aantallen.
+export function tellOpenTaken(rows) {
+    const out = {};
+    if (!Array.isArray(rows))
+        return out;
+    for (const r of rows) {
+        const mod = typeof r?.owner_module === "string" ? r.owner_module : null;
+        const n = Number(r?.open_count);
+        if (!mod || !Number.isFinite(n) || n < 0)
+            continue;
+        out[mod] = (out[mod] ?? 0) + n;
+    }
+    return out;
+}

package/dist-lib/lib/taskCounts.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=taskCounts.test.d.ts.map

package/dist-lib/lib/taskCounts.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskCounts.test.d.ts","sourceRoot":"","sources":["../../src/lib/taskCounts.test.ts"],"names":[],"mappings":""}

package/dist-lib/lib/taskCounts.test.js

@@ -0,0 +1,12 @@
+import { describe, expect, it } from "vitest";
+import { tellOpenTaken } from "./taskCounts";
+describe("tellOpenTaken", () => {
+    it("telt per module", () => {
+        expect(tellOpenTaken([{ owner_module: "verkoop", open_count: "36" }, { owner_module: "afhandeling", open_count: 136 }]))
+            .toEqual({ verkoop: 36, afhandeling: 136 });
+    });
+    it("onleesbare invoer geeft lege telling", () => {
+        expect(tellOpenTaken(null)).toEqual({});
+        expect(tellOpenTaken([{ owner_module: "x", open_count: "abc" }, { open_count: 3 }])).toEqual({});
+    });
+});

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

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

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

@@ -8,6 +8,9 @@
 /** Bepaalt de foutsoort uit een reden-code of foutmelding. */
 export function classifyError(reasonCode, message) {
     const t = `${reasonCode ?? ""} ${message ?? ""}`.toLowerCase();
+    // Een volle planronde of een tijdslimiet bij het opslaan is druk, geen stukloop.
+    if (/deadline|statement timeout|deadlock/.test(t))
+        return "regel";
     if (/afmeting|ontbreek|onbekend|geen regels|mist|niet gevuld|leeg/.test(t))
         return "ontbrekende_gegevens";
     if (/instelling|configurat|layout|mapping|niet ingesteld|werktijden/.test(t))

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

@@ -1 +1 @@
-{"version":3,"file":"vakUitleg.d.ts","sourceRoot":"","sources":["../../src/lib/vakUitleg.ts"],"names":[],"mappings":"AASA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAEjE,MAAM,WAAW,SAAS;IACxB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,8DAA8D;IAC9D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,oEAAoE;IACpE,QAAQ,EAAE,OAAO,CAAC;CACnB;AA6DD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAoD1D"}
+{"version":3,"file":"vakUitleg.d.ts","sourceRoot":"","sources":["../../src/lib/vakUitleg.ts"],"names":[],"mappings":"AAUA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAEjE,MAAM,WAAW,SAAS;IACxB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,8DAA8D;IAC9D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,oEAAoE;IACpE,QAAQ,EAAE,OAAO,CAAC;CACnB;AA6DD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAoD1D"}

package/dist-lib/lib/vakUitleg.js

@@ -5,6 +5,7 @@
 // Alleen lezen: hier wordt niets bepaald, alleen leesbaar gemaakt.
 // ============================================================================
 import { FLOW_NODE } from "./flowNodes";
+import { foutTekst } from "./foutTekst";
 import { isAutomatisch } from "./nodeTrace";
 const LABELS = {
     aanmeldmoment: "Aanmeldmoment",
@@ -96,7 +97,7 @@ export function vakUitleg(groep) {
     };
     const besluit = laatsteMet((e) => e.decision);
     const fout = [...relevant].reverse().find((e) => e.status === "mislukt") ?? null;
-    const reden = laatsteMet((e) => e.reason) ?? fout?.error ?? groep.reden ?? null;
+    const reden = foutTekst(laatsteMet((e) => e.reason) ?? fout?.error ?? groep.reden ?? null);
     const regel = laatsteMet((e) => e.rule);
     const calc = laatsteMet((e) => (e.calc && typeof e.calc === "object" ? e.calc : null));
     const feiten = [];