@flowselections/floriday-authenticatie-module 1.0.68 → 1.0.72

package/dist-lib/lib/status-overview.d.ts

@@ -0,0 +1,77 @@
+export declare const MAX_SALES_ORDER_IDS = 100;
+/** Grenzen voor één verzoek in de Shell (Cloudflare Worker). */
+export declare const REFRESH_LIMITS: {
+    /** Totale tijd voor alle inhaalrondes binnen één verzoek. */
+    readonly timeoutMs: 8000;
+    /** Pagina's per bron per ronde (Floriday levert max 1000 per pagina). */
+    readonly maxBatches: 3;
+    /** Minimale tijd tussen twee rondes per bron. */
+    readonly cooldownMs: 60000;
+    /** Lokaal geldt als actueel als de laatste volledige sync jonger is dan dit (cron elke 5 min, 2x marge). */
+    readonly freshMs: number;
+    /** Lock-duur in de database; ruim boven timeoutMs zodat een afgebroken worker de lock vanzelf vrijgeeft. */
+    readonly lockTtlSeconds: 30;
+    /** Wachtinterval voor een tweede aanroep terwijl een ronde loopt. */
+    readonly pollMs: 500;
+};
+export type RefreshMode = "auto" | "never";
+export type StatusRequest = {
+    kind: "overview";
+    salesOrderIds: string[];
+    fulfillmentOrderIds: string[] | null;
+    refresh: RefreshMode;
+    environment?: "staging" | "live";
+} | {
+    kind: "single";
+    fulfillmentOrderId: string;
+    environment?: "staging" | "live";
+};
+export type ParseResult = {
+    ok: true;
+    value: StatusRequest;
+} | {
+    ok: false;
+    errors: string[];
+};
+export declare function parseStatusRequest(body: any): ParseResult;
+export type RefreshSource = "sales-orders" | "delivery-orders" | "fulfillment-orders";
+export interface SourceState {
+    lastSyncedAt: number | null;
+    lastSuccessAt: number | null;
+}
+export interface RefreshDeps {
+    now: () => number;
+    sleep: (ms: number) => Promise<void>;
+    readState: (source: RefreshSource) => Promise<SourceState>;
+    tryLock: (source: RefreshSource) => Promise<boolean>;
+    unlock: (source: RefreshSource) => Promise<void>;
+    /** Voert de begrensde sync uit; moet zelf stoppen bij deadlineMs. */
+    runSync: (source: RefreshSource, deadlineMs: number) => Promise<{
+        synced: number;
+        partial?: boolean;
+    }>;
+}
+export type SkipReason = "fresh" | "cooldown" | "in_progress" | "disabled" | "deadline";
+export interface SourceRefreshReport {
+    source: RefreshSource;
+    attempted: boolean;
+    skippedReason: SkipReason | null;
+    timedOut: boolean;
+    durationMs: number;
+    synced: number;
+    error: string | null;
+}
+export declare function decideRefresh(state: SourceState, now: number, needed: boolean): {
+    run: true;
+} | {
+    run: false;
+    reason: SkipReason;
+};
+/**
+ * Eén bron bijwerken binnen de deadline. Maar één ronde tegelijk per bron
+ * (database-lock, gedeeld met de cron). Een tweede aanroep wacht tot de
+ * lopende ronde klaar is of de deadline verstrijkt, en leest daarna lokaal.
+ * Gooit nooit: fouten komen in het rapport.
+ */
+export declare function refreshSource(deps: RefreshDeps, source: RefreshSource, needed: boolean, deadlineMs: number): Promise<SourceRefreshReport>;
+//# sourceMappingURL=status-overview.d.ts.map

package/dist-lib/lib/status-overview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-overview.d.ts","sourceRoot":"","sources":["../../src/lib/status-overview.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,gEAAgE;AAChE,eAAO,MAAM,cAAc;IACzB,6DAA6D;;IAE7D,yEAAyE;;IAEzE,iDAAiD;;IAEjD,4GAA4G;;IAE5G,4GAA4G;;IAE5G,qEAAqE;;CAE7D,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3C,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IAAC,mBAAmB,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,WAAW,CAAC;IAAC,WAAW,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;CAAE,GAC3I;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;CAAE,CAAC;AAErF,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAkB/F,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,GAAG,GAAG,WAAW,CAuBzD;AAMD,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,iBAAiB,GAAG,oBAAoB,CAAC;AAEtF,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,SAAS,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3D,OAAO,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,qEAAqE;IACrE,OAAO,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACxG;AAED,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,aAAa,GAAG,UAAU,GAAG,UAAU,CAAC;AAExF,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,OAAO,GACd;IAAE,GAAG,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAOpD;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,mBAAmB,CAAC,CAqD9B"}

package/dist-lib/lib/status-overview.js

@@ -0,0 +1,141 @@
+// Statusoverzicht per verkooporder (fulfillment-order/status met salesOrderIds).
+// Pure helpers: verzoek-controle en de coördinatie van de inhaalronde.
+// Contract: docs/contract-fulfillment-order-status.md
+export const MAX_SALES_ORDER_IDS = 100;
+/** Grenzen voor één verzoek in de Shell (Cloudflare Worker). */
+export const REFRESH_LIMITS = {
+    /** Totale tijd voor alle inhaalrondes binnen één verzoek. */
+    timeoutMs: 8000,
+    /** Pagina's per bron per ronde (Floriday levert max 1000 per pagina). */
+    maxBatches: 3,
+    /** Minimale tijd tussen twee rondes per bron. */
+    cooldownMs: 60000,
+    /** Lokaal geldt als actueel als de laatste volledige sync jonger is dan dit (cron elke 5 min, 2x marge). */
+    freshMs: 10 * 60000,
+    /** Lock-duur in de database; ruim boven timeoutMs zodat een afgebroken worker de lock vanzelf vrijgeeft. */
+    lockTtlSeconds: 30,
+    /** Wachtinterval voor een tweede aanroep terwijl een ronde loopt. */
+    pollMs: 500,
+};
+function stringList(v, name, errors, max) {
+    if (!Array.isArray(v)) {
+        errors.push(`${name} moet een lijst met tekst zijn`);
+        return null;
+    }
+    const out = [];
+    v.forEach((x, i) => {
+        if (typeof x !== "string" || !x.trim())
+            errors.push(`${name}[${i}] moet niet-lege tekst zijn`);
+        else
+            out.push(x.trim());
+    });
+    const uniq = Array.from(new Set(out));
+    if (v.length === 0)
+        errors.push(`${name} mag niet leeg zijn`);
+    if (max !== undefined && uniq.length > max)
+        errors.push(`${name}: maximaal ${max} id's (ontvangen ${uniq.length})`);
+    return uniq;
+}
+export function parseStatusRequest(body) {
+    const errors = [];
+    if (!body || typeof body !== "object" || Array.isArray(body)) {
+        return { ok: false, errors: ["Body moet een JSON-object zijn"] };
+    }
+    const env = body.environment;
+    if (env !== undefined && env !== "staging" && env !== "live")
+        errors.push("environment moet 'staging' of 'live' zijn");
+    if (body.salesOrderIds !== undefined) {
+        const ids = stringList(body.salesOrderIds, "salesOrderIds", errors, MAX_SALES_ORDER_IDS);
+        let foIds = null;
+        if (body.fulfillmentOrderIds !== undefined)
+            foIds = stringList(body.fulfillmentOrderIds, "fulfillmentOrderIds", errors);
+        const refresh = body.refresh ?? "auto";
+        if (refresh !== "auto" && refresh !== "never")
+            errors.push("refresh moet 'auto' of 'never' zijn");
+        if (errors.length)
+            return { ok: false, errors };
+        return { ok: true, value: { kind: "overview", salesOrderIds: ids, fulfillmentOrderIds: foIds, refresh, environment: env } };
+    }
+    const fo = body.fulfillmentOrderId;
+    if (fo === undefined)
+        errors.push("salesOrderIds (overzicht) of fulfillmentOrderId (één uitlevering) is verplicht");
+    else if (typeof fo !== "string" || !fo.trim())
+        errors.push("fulfillmentOrderId moet niet-lege tekst zijn");
+    if (errors.length)
+        return { ok: false, errors };
+    return { ok: true, value: { kind: "single", fulfillmentOrderId: String(fo).trim(), environment: env } };
+}
+export function decideRefresh(state, now, needed) {
+    const fresh = state.lastSuccessAt !== null && now - state.lastSuccessAt < REFRESH_LIMITS.freshMs;
+    if (fresh && !needed)
+        return { run: false, reason: "fresh" };
+    if (state.lastSyncedAt !== null && now - state.lastSyncedAt < REFRESH_LIMITS.cooldownMs) {
+        return { run: false, reason: "cooldown" };
+    }
+    return { run: true };
+}
+/**
+ * Eén bron bijwerken binnen de deadline. Maar één ronde tegelijk per bron
+ * (database-lock, gedeeld met de cron). Een tweede aanroep wacht tot de
+ * lopende ronde klaar is of de deadline verstrijkt, en leest daarna lokaal.
+ * Gooit nooit: fouten komen in het rapport.
+ */
+export async function refreshSource(deps, source, needed, deadlineMs) {
+    const t0 = deps.now();
+    const report = {
+        source, attempted: false, skippedReason: null, timedOut: false, durationMs: 0, synced: 0, error: null,
+    };
+    const done = () => ({ ...report, durationMs: deps.now() - t0 });
+    try {
+        if (deps.now() >= deadlineMs) {
+            report.skippedReason = "deadline";
+            report.timedOut = true;
+            return done();
+        }
+        const state = await deps.readState(source);
+        const d = decideRefresh(state, deps.now(), needed);
+        if (!d.run) {
+            report.skippedReason = d.reason;
+            return done();
+        }
+        if (!(await deps.tryLock(source))) {
+            report.skippedReason = "in_progress";
+            const before = state.lastSyncedAt;
+            while (deps.now() < deadlineMs) {
+                await deps.sleep(REFRESH_LIMITS.pollMs);
+                const s = await deps.readState(source);
+                if (s.lastSyncedAt !== before)
+                    return done();
+            }
+            report.timedOut = true;
+            return done();
+        }
+        report.attempted = true;
+        let release = true;
+        try {
+            const remaining = Math.max(0, deadlineMs - deps.now());
+            let timer;
+            const timeout = new Promise((r) => { timer = setTimeout(() => r("timeout"), remaining); });
+            const out = await Promise.race([deps.runSync(source, deadlineMs), timeout]);
+            clearTimeout(timer);
+            if (out === "timeout") {
+                // Ronde loopt nog tot zijn eigen deadline; lock vervalt via TTL.
+                report.timedOut = true;
+                release = false;
+            }
+            else {
+                report.synced = out.synced;
+                if (out.partial)
+                    report.timedOut = deps.now() >= deadlineMs;
+            }
+        }
+        finally {
+            if (release)
+                await deps.unlock(source);
+        }
+    }
+    catch (e) {
+        report.error = String(e?.message ?? e).slice(0, 300);
+    }
+    return done();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowselections/floriday-authenticatie-module",
-  "version": "1.0.68",
+  "version": "1.0.72",
   "sideEffects": false,
   "type": "module",
   "main": "./dist-lib/index.js",