@flowselections/floriday-voorraad 1.0.38 → 1.0.40

package/dist-lib/lib/floriday-2026v1.server.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Centrale server-side adapter voor de Floriday Suppliers API 2026v1.
+ *
+ * Alle voorraadsturing loopt via deze module, zodat pad, methode, body-vorm,
+ * snelheidslimiet en idempotentie op één plek staan. Alle calls gaan via de
+ * gateway van de Floriday-Authenticatiemodule (HMAC), nooit rechtstreeks.
+ *
+ * Niet importeren vanuit clientcode (.server.ts wordt geblokkeerd).
+ */
+export type FloridayEnvironment = "staging" | "live";
+export type CallResult<T = unknown> = {
+    ok: boolean;
+    status?: number;
+    data?: T | null;
+    attemptId?: string;
+    error?: string;
+};
+/** ISO-jaar/week van een datum (maandag als eerste dag). */
+export declare function isoWeekOf(input?: string | Date): {
+    year: number;
+    week: number;
+};
+/** Ligt (jaar, week) in het verleden ten opzichte van nu? */
+export declare function isPastWeek(year: number, week: number): boolean;
+export type RateBucket = "base-supply-write" | "base-supply-read" | "availability-write" | "sales-orders-read";
+export declare function consumeRateLimit(supabaseAdmin: any, connectionId: string, bucket: RateBucket, cost?: number): Promise<{
+    granted: boolean;
+    waitMs: number;
+}>;
+export type ErrorClass = "retry" | "permanent" | "config" | "rate-limit" | "locked";
+export declare function classifyError(message: string): ErrorClass;
+export declare class Floriday2026v1Client {
+    private readonly supabaseAdmin;
+    private readonly environment;
+    private readonly connectionId;
+    constructor(supabaseAdmin: any, environment: FloridayEnvironment, connectionId: string);
+    private write;
+    private read;
+    /** Volledig weekaanbod (prijs + aantal). Vereist een bekende prijs. */
+    updateWeeklyBaseSupply(params: {
+        tradeItemId: string;
+        year: number;
+        week: number;
+        numberOfPieces: number;
+        pricePerPiece: number;
+        currency?: string;
+    }): Promise<CallResult>;
+    /** Alleen het aantal aanpassen — werkt ook zonder bekende prijs. */
+    patchWeeklyBaseSupplyQuantity(params: {
+        tradeItemId: string;
+        year: number;
+        week: number;
+        numberOfPieces: number;
+    }): Promise<CallResult>;
+    /** Beschikbaarheid per week aan- of uitzetten voor één of meer artikelen. */
+    updateTradeItemAvailabilityPerWeek(params: {
+        tradeItemIds: string[];
+        year: number;
+        week: number;
+        isAvailable: boolean;
+        tillYear?: number;
+        tillWeek?: number;
+    }): Promise<CallResult>;
+    /** Werkelijke standen bij Floriday voor een handelsweek (1 call/sec). */
+    getWeeklyBaseSupplies(params: {
+        year: number;
+        week: number;
+    }): Promise<CallResult<any>>;
+    /** Verkooporders vanaf een sequencenummer. */
+    syncSalesOrders(params: {
+        sequenceNumber: number;
+        limit?: number;
+    }): Promise<CallResult<any>>;
+    /** Hoogste beschikbare sequencenummer voor verkooporders. */
+    getSalesOrderMaxSequence(): Promise<CallResult<any>>;
+}
+//# sourceMappingURL=floriday-2026v1.server.d.ts.map

package/dist-lib/lib/floriday-2026v1.server.d.ts.map

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

package/dist-lib/lib/floriday-2026v1.server.js

@@ -0,0 +1,178 @@
+/**
+ * Centrale server-side adapter voor de Floriday Suppliers API 2026v1.
+ *
+ * Alle voorraadsturing loopt via deze module, zodat pad, methode, body-vorm,
+ * snelheidslimiet en idempotentie op één plek staan. Alle calls gaan via de
+ * gateway van de Floriday-Authenticatiemodule (HMAC), nooit rechtstreeks.
+ *
+ * Niet importeren vanuit clientcode (.server.ts wordt geblokkeerd).
+ */
+const API = "/suppliers-api-2026v1";
+/** ISO-jaar/week van een datum (maandag als eerste dag). */
+export function isoWeekOf(input) {
+    const parsed = input ? new Date(input) : new Date();
+    const source = Number.isNaN(parsed.getTime()) ? new Date() : parsed;
+    const date = new Date(Date.UTC(source.getUTCFullYear(), source.getUTCMonth(), source.getUTCDate()));
+    const day = date.getUTCDay() || 7;
+    date.setUTCDate(date.getUTCDate() + 4 - day);
+    const year = date.getUTCFullYear();
+    const yearStart = new Date(Date.UTC(year, 0, 1));
+    const week = Math.ceil(((date.getTime() - yearStart.getTime()) / 86400000 + 1) / 7);
+    return { year, week };
+}
+/** Ligt (jaar, week) in het verleden ten opzichte van nu? */
+export function isPastWeek(year, week) {
+    const now = isoWeekOf();
+    return year < now.year || (year === now.year && week < now.week);
+}
+const BUCKET_LIMITS = {
+    // Floriday: schrijven op base-supply 10/s met burst 1000.
+    "base-supply-write": { capacity: 1000, refillPerSec: 10 },
+    // Lezen van base-supply is hard begrensd op 1/s (burst 20).
+    "base-supply-read": { capacity: 20, refillPerSec: 1 },
+    "availability-write": { capacity: 100, refillPerSec: 5 },
+    "sales-orders-read": { capacity: 60, refillPerSec: 2 },
+};
+export async function consumeRateLimit(supabaseAdmin, connectionId, bucket, cost = 1) {
+    const limits = BUCKET_LIMITS[bucket];
+    try {
+        const { data, error } = await supabaseAdmin.rpc("consume_floriday_rate_limit", {
+            p_bucket: `${connectionId}:${bucket}`,
+            p_capacity: limits.capacity,
+            p_refill_per_sec: limits.refillPerSec,
+            p_cost: cost,
+        });
+        if (error)
+            return { granted: true, waitMs: 0 };
+        const row = Array.isArray(data) ? data[0] : data;
+        return { granted: row?.granted !== false, waitMs: Number(row?.wait_ms ?? 0) || 0 };
+    }
+    catch {
+        // Nooit de verwerking blokkeren op een limietfout; de API-kant begrenst ook.
+        return { granted: true, waitMs: 0 };
+    }
+}
+export function classifyError(message) {
+    const m = (message || "").toLowerCase();
+    if (/\b429\b|rate limit|too many requests/.test(m))
+        return "rate-limit";
+    if (/\b423\b|locked/.test(m))
+        return "locked";
+    if (/\b(401|403)\b|unauthorized|forbidden|credential|central auth|not configured|gateway/.test(m)) {
+        return "config";
+    }
+    if (/\b(500|502|503|504)\b|timeout|timed out|network|fetch failed|econn|socket/.test(m)) {
+        return "retry";
+    }
+    if (/\b(400|404|409|422)\b|validation|invalid|not found/.test(m))
+        return "permanent";
+    return "retry";
+}
+// ---------------------------------------------------------------------------
+// Client
+// ---------------------------------------------------------------------------
+export class Floriday2026v1Client {
+    constructor(supabaseAdmin, environment, connectionId) {
+        this.supabaseAdmin = supabaseAdmin;
+        this.environment = environment;
+        this.connectionId = connectionId;
+    }
+    async write(input) {
+        const gate = await consumeRateLimit(this.supabaseAdmin, this.connectionId, input.bucket);
+        if (!gate.granted) {
+            return { ok: false, error: `429 snelheidslimiet, wacht ${gate.waitMs} ms` };
+        }
+        try {
+            const { gatewayWrite } = await import("./floriday-gateway.server");
+            const res = await gatewayWrite({
+                environment: this.environment,
+                module: "inventory",
+                action: input.action,
+                method: input.method,
+                path: input.path,
+                referenceId: input.referenceId,
+                idempotencyKey: input.idempotencyKey,
+                body: input.body,
+            });
+            return { ok: true, status: res?.status, data: res?.data, attemptId: res?.attemptId };
+        }
+        catch (e) {
+            return { ok: false, error: e instanceof Error ? e.message : String(e) };
+        }
+    }
+    async read(path, bucket) {
+        const gate = await consumeRateLimit(this.supabaseAdmin, this.connectionId, bucket);
+        if (!gate.granted) {
+            return { ok: false, error: `429 snelheidslimiet, wacht ${gate.waitMs} ms` };
+        }
+        try {
+            const { gatewayRead } = await import("./floriday-gateway.server");
+            const res = await gatewayRead({ environment: this.environment, path });
+            return { ok: res.ok !== false, status: res.status, data: res.data };
+        }
+        catch (e) {
+            return { ok: false, error: e instanceof Error ? e.message : String(e) };
+        }
+    }
+    /** Volledig weekaanbod (prijs + aantal). Vereist een bekende prijs. */
+    updateWeeklyBaseSupply(params) {
+        return this.write({
+            action: "edit-weekly-base-supply",
+            method: "PUT",
+            path: `${API}/trade-items/${params.tradeItemId}/base-supply/${params.year}/${params.week}`,
+            referenceId: params.tradeItemId,
+            idempotencyKey: `inventory:base-supply:${params.tradeItemId}:${params.year}:${params.week}:${params.numberOfPieces}:${params.pricePerPiece}`,
+            body: {
+                basePricePerPiece: { currency: params.currency ?? "EUR", value: params.pricePerPiece },
+                numberOfPieces: params.numberOfPieces,
+            },
+            bucket: "base-supply-write",
+        });
+    }
+    /** Alleen het aantal aanpassen — werkt ook zonder bekende prijs. */
+    patchWeeklyBaseSupplyQuantity(params) {
+        return this.write({
+            action: "patch-weekly-base-supply-quantity",
+            method: "PATCH",
+            path: `${API}/trade-items/${params.tradeItemId}/base-supply/${params.year}/${params.week}?numberOfPieces=${params.numberOfPieces}`,
+            referenceId: params.tradeItemId,
+            idempotencyKey: `inventory:base-supply-qty:${params.tradeItemId}:${params.year}:${params.week}:${params.numberOfPieces}`,
+            body: {},
+            bucket: "base-supply-write",
+        });
+    }
+    /** Beschikbaarheid per week aan- of uitzetten voor één of meer artikelen. */
+    updateTradeItemAvailabilityPerWeek(params) {
+        const till = { year: params.tillYear ?? params.year, week: params.tillWeek ?? params.week };
+        return this.write({
+            action: "edit-availabilities-per-week",
+            method: "PUT",
+            path: `${API}/trade-items/availabilities-per-week`,
+            referenceId: params.tradeItemIds[0] ?? "bulk",
+            idempotencyKey: `inventory:availability:${params.tradeItemIds.join(",")}:${params.year}:${params.week}:${params.isAvailable}`,
+            body: {
+                tradeItemIds: params.tradeItemIds,
+                fromWeek: { year: params.year, week: params.week },
+                tillWeek: till,
+                isAvailable: params.isAvailable,
+                // Beide lijsten zijn verplicht in het 2026v1-schema.
+                alwaysAvailableForCustomerOrganizationIds: [],
+                neverAvailableForCustomerOrganizationIds: [],
+            },
+            bucket: "availability-write",
+        });
+    }
+    /** Werkelijke standen bij Floriday voor een handelsweek (1 call/sec). */
+    getWeeklyBaseSupplies(params) {
+        return this.read(`${API}/trade-items/base-supply?year=${params.year}&week=${params.week}`, "base-supply-read");
+    }
+    /** Verkooporders vanaf een sequencenummer. */
+    syncSalesOrders(params) {
+        const limit = Math.min(Math.max(params.limit ?? 50, 1), 200);
+        return this.read(`${API}/sales-orders/sync/${params.sequenceNumber}?limit=${limit}`, "sales-orders-read");
+    }
+    /** Hoogste beschikbare sequencenummer voor verkooporders. */
+    getSalesOrderMaxSequence() {
+        return this.read(`${API}/sales-orders/current-max-sequence`, "sales-orders-read");
+    }
+}