@flowselections/layout-maker 1.24.1 → 1.26.0

package/README.md

@@ -1,139 +1,139 @@
-# Layout maker (pakbonnen, verzendbrieven, ectra)
-
-blank project start
-
-This project was built with [Lovable](https://lovable.dev).
-
-## Build with Lovable
-
-Continue developing this project in the [Lovable editor](https://lovable.dev/projects/4735fccb-b385-4b48-b4f8-ef135f63f4f7).
-
-- **Ship faster**: describe what you want to build and Lovable handles the code.
-- **Stay in sync**: every change made in Lovable is committed straight to this repository.
-- **Full ownership**: this code is yours. Push to `main` on GitHub and your changes sync back into Lovable, ready for your next prompt.
-
-## Development
-
-Prefer working locally? You need Node.js and npm — [install with nvm](https://github.com/nvm-sh/nvm#installing-and-updating).
-
-```sh
-git clone <this-repository-url>
-cd <repository-name>
-npm i
-npm run dev
-```
-
-## Installeren in een andere shell
-
-1. Draai `sql/print-schema.sql` één keer in de Supabase-database van die shell
-   (SQL editor). Het script is idempotent en zet tabellen, rechten, RLS,
-   functies, de geplande taken én de opslagmap `layout-logos` voor de Logo
-   Bibliotheek klaar. Zorg dat de extensies `pg_cron` en `pg_net` aan staan.
-
-2. Zet in de omgeving van de shell:
-   - `SUPABASE_URL` en `SERVICE_ROLE_KEY` — nodig voor achtergrondprinten
-   - `CENTRAL_AUTH_URL` en `CENTRAL_AUTH_SECRET` — nodig voor de printdienst
-3. Zorg dat de shell het tick-eindpunt host. De setup-CLI doet dit automatisch
-   op basis van `flowselections.serverRoutes` in `package.json`. Handmatig
-   opgezette shells maken zelf dit bestand aan:
-
-   ```ts
-   // src/routes/api/public/print/queue-tick.ts
-   import { createFileRoute } from "@tanstack/react-router";
-   import { behandelQueueTick } from "@flowselections/layout-maker/print";
-
-   export const Route = createFileRoute("/api/public/print/queue-tick")({
-     server: {
-       handlers: {
-         POST: async ({ request }) => {
-           // De shell levert de databaseverbinding; de module maakt er nooit zelf een.
-           const { supabaseAdmin } = await import(
-             "../../../../integrations/supabase/client.server"
-           );
-           return behandelQueueTick(request, supabaseAdmin);
-         },
-       },
-     },
-   });
-   ```
-
-   Het eindpunt accepteert drie toegangsbewijzen: een runner-sleutel uit
-   `print_queue_runners.tick_sleutel`, `SUPABASE_PUBLISHABLE_KEY` (de cron) of
-   het sessietoken van een ingelogde gebruiker (de knop in de Printwachtrij).
-
-
-4. Klaar. Zodra de module in de shell draait meldt hij zichzelf aan als
-   verwerker van de printwachtrij. Een nieuwe printopdracht wordt meteen
-   opgepakt; daarnaast verwerkt de geplande taak `print-queue-tick` elke minuut
-   de wachtende opdrachten. Reageert een shell een uur lang niet, dan wordt hij
-   automatisch op inactief gezet. De taak `print-queue-cleanup` ruimt dagelijks
-   oude opdrachten en bestanden op.
-
-## Printen vanuit een andere module
-
-Andere modules in dezelfde shell gebruiken uitsluitend de print-API van deze
-module; zij hoeven de printtabellen niet te kennen en mogen er ook niet zelf in
-schrijven (dan blijft de opdracht wachten tot de volgende cronronde).
-
-```ts
-import {
-  printDocument, printPdf, printHtml,
-  printerVoorWerkplek, printerVoorDocumenttype, volgJobStatus,
-} from "@flowselections/layout-maker";
-
-// 1. Document dat via een ontwerp uit deze module wordt opgemaakt
-const { jobId } = await printDocument({
-  documenttype: "pakbon",          // moet een bestaande documentsoort zijn
-  documentnaam: "PB-2601284",
-  payload: { order, order_id: order.id }, // order_id: verplicht kenmerk
-});
-
-// 2. Kant-en-klare PDF (Floriday-document, klantsticker, externe factuur)
-//    Zonder printerId wordt de printer bepaald via de gekoppelde layout van
-//    de documentsoort (of de koppeling op papierformaat).
-await printPdf({
-  documenttype: "factuur",
-  documentnaam: "F-2026-00123",
-  pdfBase64,                       // met of zonder data:-voorvoegsel
-  payload: { order_id: factuur.id },
-});
-
-// Geef in payload altijd een order-kenmerk mee: queue_item_id, order_id of
-// ordernummer. De wachtrij gebruikt dat om dubbele aanvragen te herkennen;
-// zonder kenmerk kunnen twee orders met dezelfde documentnaam binnen tien
-// minuten als dubbel worden gezien.
-
-
-// Of expliciet per werkplek:
-const printerId = await printerVoorWerkplek("PICKSTATION-1", "A4");
-await printPdf({
-  documenttype: "afleverbrief",
-  documentnaam: "AFL-12345",
-  pdfBase64,
-  printerId: printerId!,
-});
-
-
-// 3. Eigen opmaak afdrukken (geen layout, anders wint de layout)
-await printHtml({
-  documenttype: "controlelijst",
-  documentnaam: "Controlelijst kar 12",
-  html,
-  printerId: printerId!,
-});
-
-// Status live volgen (realtime staat aan op print_jobs)
-const stop = volgJobStatus(jobId, (s) => console.log(s.status, s.foutmelding));
-```
-
-Belangrijk:
-
-- **Documentsoorten** liggen vast in de database: pakbon, factuur, offerte,
-  orderbevestiging, etiket, verzendlabel, productlabel, barcode_label,
-  magazijnlijst, controlelijst, transportdocument, sticker, productiebon,
-  veilingbon, afleverbrief, veilingbrief en vrij.
-- **Beslisvolgorde bij het afdrukken**: kant-en-klare PDF > gekoppelde layout >
-  meegestuurde opmaak > actieve layout van de documentsoort.
-- **Dubbelbeveiliging**: een identieke aanvraag binnen 10 minuten wordt
-  genegeerd; de aanroep werpt dan `DubbeleAanvraagFout`. Geef bij bulkprints per
-  document een eigen `documentnaam` zodat elke opdracht uniek is.
+# Layout maker (pakbonnen, verzendbrieven, ectra)
+
+blank project start
+
+This project was built with [Lovable](https://lovable.dev).
+
+## Build with Lovable
+
+Continue developing this project in the [Lovable editor](https://lovable.dev/projects/4735fccb-b385-4b48-b4f8-ef135f63f4f7).
+
+- **Ship faster**: describe what you want to build and Lovable handles the code.
+- **Stay in sync**: every change made in Lovable is committed straight to this repository.
+- **Full ownership**: this code is yours. Push to `main` on GitHub and your changes sync back into Lovable, ready for your next prompt.
+
+## Development
+
+Prefer working locally? You need Node.js and npm — [install with nvm](https://github.com/nvm-sh/nvm#installing-and-updating).
+
+```sh
+git clone <this-repository-url>
+cd <repository-name>
+npm i
+npm run dev
+```
+
+## Installeren in een andere shell
+
+1. Draai `sql/print-schema.sql` één keer in de Supabase-database van die shell
+   (SQL editor). Het script is idempotent en zet tabellen, rechten, RLS,
+   functies, de geplande taken én de opslagmap `layout-logos` voor de Logo
+   Bibliotheek klaar. Zorg dat de extensies `pg_cron` en `pg_net` aan staan.
+
+2. Zet in de omgeving van de shell:
+   - `SUPABASE_URL` en `SERVICE_ROLE_KEY` — nodig voor achtergrondprinten
+   - `CENTRAL_AUTH_URL` en `CENTRAL_AUTH_SECRET` — nodig voor de printdienst
+3. Zorg dat de shell het tick-eindpunt host. De setup-CLI doet dit automatisch
+   op basis van `flowselections.serverRoutes` in `package.json`. Handmatig
+   opgezette shells maken zelf dit bestand aan:
+
+   ```ts
+   // src/routes/api/public/print/queue-tick.ts
+   import { createFileRoute } from "@tanstack/react-router";
+   import { behandelQueueTick } from "@flowselections/layout-maker/print";
+
+   export const Route = createFileRoute("/api/public/print/queue-tick")({
+     server: {
+       handlers: {
+         POST: async ({ request }) => {
+           // De shell levert de databaseverbinding; de module maakt er nooit zelf een.
+           const { supabaseAdmin } = await import(
+             "../../../../integrations/supabase/client.server"
+           );
+           return behandelQueueTick(request, supabaseAdmin);
+         },
+       },
+     },
+   });
+   ```
+
+   Het eindpunt accepteert drie toegangsbewijzen: een runner-sleutel uit
+   `print_queue_runners.tick_sleutel`, `SUPABASE_PUBLISHABLE_KEY` (de cron) of
+   het sessietoken van een ingelogde gebruiker (de knop in de Printwachtrij).
+
+
+4. Klaar. Zodra de module in de shell draait meldt hij zichzelf aan als
+   verwerker van de printwachtrij. Een nieuwe printopdracht wordt meteen
+   opgepakt; daarnaast verwerkt de geplande taak `print-queue-tick` elke minuut
+   de wachtende opdrachten. Reageert een shell een uur lang niet, dan wordt hij
+   automatisch op inactief gezet. De taak `print-queue-cleanup` ruimt dagelijks
+   oude opdrachten en bestanden op.
+
+## Printen vanuit een andere module
+
+Andere modules in dezelfde shell gebruiken uitsluitend de print-API van deze
+module; zij hoeven de printtabellen niet te kennen en mogen er ook niet zelf in
+schrijven (dan blijft de opdracht wachten tot de volgende cronronde).
+
+```ts
+import {
+  printDocument, printPdf, printHtml,
+  printerVoorWerkplek, printerVoorDocumenttype, volgJobStatus,
+} from "@flowselections/layout-maker";
+
+// 1. Document dat via een ontwerp uit deze module wordt opgemaakt
+const { jobId } = await printDocument({
+  documenttype: "pakbon",          // moet een bestaande documentsoort zijn
+  documentnaam: "PB-2601284",
+  payload: { order, order_id: order.id }, // order_id: verplicht kenmerk
+});
+
+// 2. Kant-en-klare PDF (Floriday-document, klantsticker, externe factuur)
+//    Zonder printerId wordt de printer bepaald via de gekoppelde layout van
+//    de documentsoort (of de koppeling op papierformaat).
+await printPdf({
+  documenttype: "factuur",
+  documentnaam: "F-2026-00123",
+  pdfBase64,                       // met of zonder data:-voorvoegsel
+  payload: { order_id: factuur.id },
+});
+
+// Geef in payload altijd een order-kenmerk mee: queue_item_id, order_id of
+// ordernummer. De wachtrij gebruikt dat om dubbele aanvragen te herkennen;
+// zonder kenmerk kunnen twee orders met dezelfde documentnaam binnen tien
+// minuten als dubbel worden gezien.
+
+
+// Of expliciet per werkplek:
+const printerId = await printerVoorWerkplek("PICKSTATION-1", "A4");
+await printPdf({
+  documenttype: "afleverbrief",
+  documentnaam: "AFL-12345",
+  pdfBase64,
+  printerId: printerId!,
+});
+
+
+// 3. Eigen opmaak afdrukken (geen layout, anders wint de layout)
+await printHtml({
+  documenttype: "controlelijst",
+  documentnaam: "Controlelijst kar 12",
+  html,
+  printerId: printerId!,
+});
+
+// Status live volgen (realtime staat aan op print_jobs)
+const stop = volgJobStatus(jobId, (s) => console.log(s.status, s.foutmelding));
+```
+
+Belangrijk:
+
+- **Documentsoorten** liggen vast in de database: pakbon, factuur, offerte,
+  orderbevestiging, etiket, verzendlabel, productlabel, barcode_label,
+  magazijnlijst, controlelijst, transportdocument, sticker, productiebon,
+  veilingbon, afleverbrief, veilingbrief en vrij.
+- **Beslisvolgorde bij het afdrukken**: kant-en-klare PDF > gekoppelde layout >
+  meegestuurde opmaak > actieve layout van de documentsoort.
+- **Dubbelbeveiliging**: een identieke aanvraag binnen 10 minuten wordt
+  genegeerd; de aanroep werpt dan `DubbeleAanvraagFout`. Geef bij bulkprints per
+  document een eigen `documentnaam` zodat elke opdracht uniek is.

package/dist-lib/components/AfdrukKnop.d.ts

@@ -1,20 +1,20 @@
-import { type Orientatie } from "../lib/browserPrint.js";
-export interface AfdrukKnopProps {
-    documenttype: string;
-    formaatCode: string | null;
-    orientatie: Orientatie;
-    /** Levert de HTML van het document aan op het moment van afdrukken. */
-    getHtml: () => string;
-    css?: string;
-    documentnaam?: string;
-    label?: string;
-    layoutId?: string | null;
-    kopieen?: number;
-}
-/**
- * @deprecated Verouderd — deze knop gebruikt het browser-printvenster als
- * terugval. Gebruik `printHtml()` / `printPdf()` uit `printApi` zodat alles
- * via PrintNode loopt.
- */
-export declare function AfdrukKnop({ documenttype, formaatCode, orientatie, getHtml, css, documentnaam, label, layoutId, kopieen, }: AfdrukKnopProps): import("react/jsx-runtime").JSX.Element;
+import { type Orientatie } from "../lib/browserPrint.js";
+export interface AfdrukKnopProps {
+    documenttype: string;
+    formaatCode: string | null;
+    orientatie: Orientatie;
+    /** Levert de HTML van het document aan op het moment van afdrukken. */
+    getHtml: () => string;
+    css?: string;
+    documentnaam?: string;
+    label?: string;
+    layoutId?: string | null;
+    kopieen?: number;
+}
+/**
+ * @deprecated Verouderd — deze knop gebruikt het browser-printvenster als
+ * terugval. Gebruik `printHtml()` / `printPdf()` uit `printApi` zodat alles
+ * via PrintNode loopt.
+ */
+export declare function AfdrukKnop({ documenttype, formaatCode, orientatie, getHtml, css, documentnaam, label, layoutId, kopieen, }: AfdrukKnopProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=AfdrukKnop.d.ts.map

package/dist-lib/components/NetwerkPrintersDialog.d.ts

@@ -1,8 +1,8 @@
-export declare function NetwerkPrintersDialog({ open, onOpenChange, huidigePrinterId, huidigePrinterNaam, onKlaar, }: {
-    open: boolean;
-    onOpenChange: (v: boolean) => void;
-    huidigePrinterId?: string | null;
-    huidigePrinterNaam?: string | null;
-    onKlaar?: () => void;
-}): import("react/jsx-runtime").JSX.Element;
+export declare function NetwerkPrintersDialog({ open, onOpenChange, huidigePrinterId, huidigePrinterNaam, onKlaar, }: {
+    open: boolean;
+    onOpenChange: (v: boolean) => void;
+    huidigePrinterId?: string | null;
+    huidigePrinterNaam?: string | null;
+    onKlaar?: () => void;
+}): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=NetwerkPrintersDialog.d.ts.map

package/dist-lib/components/PrinterSetupWizard.js

@@ -183,9 +183,9 @@ export function PrinterSetupWizard({ open, onOpenChange, onKlaar, computerFilter
         setTestStatus("bezig");
         setTestMelding("");
         const maat = gekozenFormaat ? `${gekozenFormaat.breedte} × ${gekozenFormaat.hoogte} mm` : "standaardformaat";
-        const html = `<div style="padding:15mm;font-family:Arial,Helvetica,sans-serif;font-size:12pt">
-<h1 style="font-size:20pt;margin:0 0 6mm">Testpagina</h1>
-<p style="margin:0 0 3mm">Deze pagina hoort uit: <strong>${naam}</strong></p>
+        const html = `<div style="padding:15mm;font-family:Arial,Helvetica,sans-serif;font-size:12pt">
+<h1 style="font-size:20pt;margin:0 0 6mm">Testpagina</h1>
+<p style="margin:0 0 3mm">Deze pagina hoort uit: <strong>${naam}</strong></p>
 <p style="margin:0">Papier: ${maat} — ${new Date().toLocaleString("nl-NL")}</p></div>`;
         try {
             const { jobId } = await printHtml({

package/dist-lib/components/PrintersRedirectPage.d.ts

@@ -1,2 +1,2 @@
-export declare function PrintersRedirectPage(): import("react").JSX.Element;
+export declare function PrintersRedirectPage(): import("react").JSX.Element;
 //# sourceMappingURL=PrintersRedirectPage.d.ts.map

package/dist-lib/components/PrintersRedirectPage.js

@@ -1,14 +1,14 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-// ============================================================================
-// src/components/PrintersRedirectPage.tsx — oude URL /layouts-printers/printers
-// stuurt door naar de samengevoegde pagina Printplekken.
-// ============================================================================
-import { useEffect } from "react";
-import { useNavigate } from "@tanstack/react-router";
-export function PrintersRedirectPage() {
-    const navigate = useNavigate();
-    useEffect(() => {
-        void navigate({ to: "/layouts-printers/printplekken", replace: true });
-    }, [navigate]);
-    return _jsx("p", { className: "text-muted-foreground p-6 text-sm", children: "Doorsturen naar Printplekken\u2026" });
-}
+import { jsx as _jsx } from "react/jsx-runtime";
+// ============================================================================
+// src/components/PrintersRedirectPage.tsx — oude URL /layouts-printers/printers
+// stuurt door naar de samengevoegde pagina Printplekken.
+// ============================================================================
+import { useEffect } from "react";
+import { useNavigate } from "@tanstack/react-router";
+export function PrintersRedirectPage() {
+    const navigate = useNavigate();
+    useEffect(() => {
+        void navigate({ to: "/layouts-printers/printplekken", replace: true });
+    }, [navigate]);
+    return _jsx("p", { className: "text-muted-foreground p-6 text-sm", children: "Doorsturen naar Printplekken\u2026" });
+}