@seifer-webapp-factory/authorization 0.1.0

package/dist/scaffolder/core/materialize.d.ts

@@ -0,0 +1,71 @@
+/**
+ * materialize — de GENERATE-stap van de version-aware materializer (US-Z0803).
+ *
+ * Gegeven de surface-`FileDescriptor`s van de authorization-module schrijft deze functie ze via een
+ * geïnjecteerde fs-port in een doelproject. Vanaf dat moment is de surface projecteigendom en mag ze
+ * divergeren; het mechanisme (`backend/src`, `frontend/src`, `contract/`) blijft een gepinde dependency. De functie:
+ *
+ *  - stempelt de `templateVersion` per bestand in een `MaterializationRecord` (de basis waartegen een
+ *    latere upgrade-merge diff't — US-Z0804),
+ *  - verzamelt ÁLLE collisions en weigert all-or-nothing zonder `overwrite` (nooit stil overschrijven),
+ *  - weigert te starten als een vereiste requires-port ontbreekt (AC3), zodat er geen half-gewirede
+ *    surface achterblijft.
+ *
+ * Puur op de fs-port na: geen echt filesystem, geen module-globale mutable state, deterministisch
+ * (invoervolgorde blijft behouden, geen Date.now/random).
+ */
+import type { CapabilityModuleManifest } from '../../manifest.js';
+import type { AuthzScaffolderFsPort, FileDescriptor } from './ports.js';
+/** De stempel van één gematerialiseerd bestand: de bronversie én de exact geschreven basis-inhoud. */
+export interface MaterializedFile {
+    /** De `templateVersion` waaruit dit bestand is gegenereerd. */
+    readonly templateVersion: string;
+    /** De precies gematerialiseerde template-inhoud — de `base` voor een latere three-way-merge. */
+    readonly base: string;
+}
+/**
+ * Het per-project stempelrecord (manifest/lockfile-vorm): welke surface-bestanden zijn gematerialiseerd,
+ * vanaf welke `templateVersion`, met hun basis-inhoud. `files` mapt bestand → stempel; `templateVersion`
+ * is de module-brede versie waarmee gematerialiseerd is.
+ */
+export interface MaterializationRecord {
+    /** Module-slug, bv. 'authorization'. */
+    readonly module: string;
+    /** De module-brede templateVersion waarmee gematerialiseerd is. */
+    readonly templateVersion: string;
+    /** Bestand-pad → stempel (versie + basis-inhoud). */
+    readonly files: Readonly<Record<string, MaterializedFile>>;
+}
+/** Opties voor `materializeAuthzModule`. */
+export interface MaterializeOptions {
+    /** Het (gevalideerde) capability-manifest dat de materialisatie stuurt. */
+    readonly manifest: CapabilityModuleManifest;
+    /** De surface-bestanden die gematerialiseerd worden (uitsluitend surface — US-Z0802). */
+    readonly surfaceFiles: readonly FileDescriptor[];
+    /** De geïnjecteerde fs-port; alle writes lopen hierlangs. */
+    readonly fsPort: AuthzScaffolderFsPort;
+    /** Overschrijf de te stempelen versie; standaard `manifest.templateVersion`. */
+    readonly templateVersion?: string;
+    /** Sta overschrijven van bestaande bestanden toe (expliciete eject/regenerate). */
+    readonly overwrite?: boolean;
+    /**
+     * De requires-ports die de host levert. Wordt dit opgegeven, dan controleert de materializer dat
+     * `manifest.requires.ports` een deelverzameling is en weigert anders (AC3). Weggelaten = check overslaan.
+     */
+    readonly providedPorts?: readonly string[];
+}
+/** Resultaat van een geslaagde materialisatie: het stempelrecord + de geschreven paden (in volgorde). */
+export interface MaterializeResult {
+    readonly record: MaterializationRecord;
+    readonly written: readonly string[];
+}
+/**
+ * Materialiseert de surface van de authorization-module in een project.
+ *
+ * @throws MissingRequiredPortError als een vereiste port ontbreekt (geen enkele write gebeurt)
+ * @throws AuthzMaterializationConflictError als bestanden al bestaan en `overwrite` niet gezet is
+ */
+export declare function materializeAuthzModule(options: MaterializeOptions): MaterializeResult;
+/** Convenience: het stempelrecord platgeslagen tot een pure `bestand → templateVersion`-map. */
+export declare function stampedVersions(record: MaterializationRecord): Record<string, string>;
+//# sourceMappingURL=materialize.d.ts.map

package/dist/scaffolder/core/materialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize.d.ts","sourceRoot":"","sources":["../../../scaffolder/core/materialize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGxE,sGAAsG;AACtG,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,gGAAgG;IAChG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;CAC5D;AAED,4CAA4C;AAC5C,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;IAC5C,yFAAyF;IACzF,QAAQ,CAAC,YAAY,EAAE,SAAS,cAAc,EAAE,CAAC;IACjD,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,gFAAgF;IAChF,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,mFAAmF;IACnF,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,yGAAyG;AACzG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CAkCrF;AAED,gGAAgG;AAChG,wBAAgB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMrF"}

package/dist/scaffolder/core/materialize.js

@@ -0,0 +1,47 @@
+import { AuthzMaterializationConflictError, MissingRequiredPortError } from './errors.js';
+/**
+ * Materialiseert de surface van de authorization-module in een project.
+ *
+ * @throws MissingRequiredPortError als een vereiste port ontbreekt (geen enkele write gebeurt)
+ * @throws AuthzMaterializationConflictError als bestanden al bestaan en `overwrite` niet gezet is
+ */
+export function materializeAuthzModule(options) {
+    const { manifest, surfaceFiles, fsPort, overwrite = false, providedPorts } = options;
+    const templateVersion = options.templateVersion ?? manifest.templateVersion;
+    // (1) Requires-ports: weiger vóór welke write dan ook als de host er één niet levert.
+    if (providedPorts !== undefined) {
+        const geleverd = new Set(providedPorts);
+        const missing = manifest.requires.ports.filter((port) => !geleverd.has(port));
+        if (missing.length > 0) {
+            throw new MissingRequiredPortError(missing);
+        }
+    }
+    // (2) Collision-check: verzamel ÁLLE conflicten en weiger all-or-nothing (nooit stil overschrijven).
+    if (!overwrite) {
+        const conflicts = surfaceFiles.filter((f) => fsPort.exists(f.path)).map((f) => f.path);
+        if (conflicts.length > 0) {
+            throw new AuthzMaterializationConflictError(conflicts);
+        }
+    }
+    // (3) Schrijf de surface en stempel per bestand de templateVersion + de basis-inhoud.
+    const files = {};
+    const written = [];
+    for (const descriptor of surfaceFiles) {
+        fsPort.write(descriptor.path, descriptor.contents);
+        files[descriptor.path] = { templateVersion, base: descriptor.contents };
+        written.push(descriptor.path);
+    }
+    return {
+        record: { module: manifest.name, templateVersion, files },
+        written,
+    };
+}
+/** Convenience: het stempelrecord platgeslagen tot een pure `bestand → templateVersion`-map. */
+export function stampedVersions(record) {
+    const out = {};
+    for (const [path, file] of Object.entries(record.files)) {
+        out[path] = file.templateVersion;
+    }
+    return out;
+}
+//# sourceMappingURL=materialize.js.map

package/dist/scaffolder/core/materialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize.js","sourceRoot":"","sources":["../../../scaffolder/core/materialize.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,iCAAiC,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAiD1F;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAA2B;IAChE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,GAAG,KAAK,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IACrF,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,QAAQ,CAAC,eAAe,CAAC;IAE5E,sFAAsF;IACtF,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;QACxC,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,wBAAwB,CAAC,OAAO,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,qGAAqG;IACrG,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACvF,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,iCAAiC,CAAC,SAAS,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,sFAAsF;IACtF,MAAM,KAAK,GAAqC,EAAE,CAAC;IACnD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;QACnD,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC;QACxE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,OAAO;QACL,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE;QACzD,OAAO;KACR,CAAC;AACJ,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,eAAe,CAAC,MAA6B;IAC3D,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC;IACnC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/scaffolder/core/ports.d.ts

@@ -0,0 +1,39 @@
+/**
+ * ports — de geïnjecteerde randen van de scaffolder. De core-functies raken NOOIT een echt
+ * filesystem: ze krijgen een {@link AuthzScaffolderFsPort} injected en werken uitsluitend met
+ * {@link FileDescriptor}s. Zo blijft de materializer deterministisch, testbaar met een in-memory
+ * port en vrij van module-globale mutable state.
+ *
+ * Spiegelt bewust de frontend-scaffolder (`kits/frontend/.../wiring-generator.ts`): dezelfde
+ * `{ path, contents }`-descriptor en dezelfde kleine, synchrone fs-port — één tier hoger.
+ */
+/** Eén te materialiseren bestand: relatief pad + volledige inhoud. Pure data, geen side-effects. */
+export interface FileDescriptor {
+    readonly path: string;
+    readonly contents: string;
+}
+/**
+ * Minimale, injecteerbare fs-port. Bewust synchroon en klein zodat hij triviaal te mocken is.
+ * `read` is nodig omdat de upgrade-merge de (mogelijk gedivergeerde) projectbestanden moet inlezen.
+ */
+export interface AuthzScaffolderFsPort {
+    /** Bestaat er al een bestand op dit pad? */
+    exists(path: string): boolean;
+    /** Leest de huidige inhoud; gooit als het pad niet bestaat. */
+    read(path: string): string;
+    /** Schrijft (of overschrijft) de inhoud op dit pad. */
+    write(path: string, contents: string): void;
+}
+/** Een in-memory fs-port met een `snapshot()` erbij, voor tests én voor de re-scaffold-naar-temp-stap. */
+export interface MemoryFsPort extends AuthzScaffolderFsPort {
+    /** Geeft een gewone-object-kopie van de huidige inhoud (pad → inhoud). Deterministisch. */
+    snapshot(): Record<string, string>;
+}
+/**
+ * Maakt een verse, geïsoleerde in-memory fs-port. Elke aanroep levert een eigen store — geen
+ * module-globale mutable state, zodat parallelle tests elkaar niet besmetten.
+ *
+ * @param seed optionele begininhoud (pad → inhoud)
+ */
+export declare function createMemoryFsPort(seed?: Readonly<Record<string, string>>): MemoryFsPort;
+//# sourceMappingURL=ports.d.ts.map

package/dist/scaffolder/core/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../../scaffolder/core/ports.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,oGAAoG;AACpG,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,4CAA4C;IAC5C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,+DAA+D;IAC/D,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,uDAAuD;IACvD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C;AAED,0GAA0G;AAC1G,MAAM,WAAW,YAAa,SAAQ,qBAAqB;IACzD,2FAA2F;IAC3F,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,YAAY,CAgBxF"}

package/dist/scaffolder/core/ports.js

@@ -0,0 +1,33 @@
+/**
+ * ports — de geïnjecteerde randen van de scaffolder. De core-functies raken NOOIT een echt
+ * filesystem: ze krijgen een {@link AuthzScaffolderFsPort} injected en werken uitsluitend met
+ * {@link FileDescriptor}s. Zo blijft de materializer deterministisch, testbaar met een in-memory
+ * port en vrij van module-globale mutable state.
+ *
+ * Spiegelt bewust de frontend-scaffolder (`kits/frontend/.../wiring-generator.ts`): dezelfde
+ * `{ path, contents }`-descriptor en dezelfde kleine, synchrone fs-port — één tier hoger.
+ */
+/**
+ * Maakt een verse, geïsoleerde in-memory fs-port. Elke aanroep levert een eigen store — geen
+ * module-globale mutable state, zodat parallelle tests elkaar niet besmetten.
+ *
+ * @param seed optionele begininhoud (pad → inhoud)
+ */
+export function createMemoryFsPort(seed) {
+    const store = new Map(seed ? Object.entries(seed) : []);
+    return {
+        exists: (path) => store.has(path),
+        read: (path) => {
+            const value = store.get(path);
+            if (value === undefined) {
+                throw new Error(`Bestand niet gevonden op de fs-port: ${path}`);
+            }
+            return value;
+        },
+        write: (path, contents) => {
+            store.set(path, contents);
+        },
+        snapshot: () => Object.fromEntries([...store.entries()].sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))),
+    };
+}
+//# sourceMappingURL=ports.js.map

package/dist/scaffolder/core/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../../scaffolder/core/ports.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA2BH;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAuC;IACxE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAiB,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACxE,OAAO;QACL,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;QACjC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;YACb,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,EAAE,CAAC,CAAC;YAClE,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,KAAK,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE;YACxB,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC5B,CAAC;QACD,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAC1G,CAAC;AACJ,CAAC"}

package/dist/scaffolder/core/presence.d.ts

@@ -0,0 +1,34 @@
+/**
+ * presence — de module→module presence-check die de scaffolder erbij krijgt (US-Z0803).
+ *
+ * De authorization-module is de eerste die van een ándere capability-module afhangt
+ * (`requires.modules: ['authentication']`). Voordat de scaffolder assembleert, bewaakt
+ * `checkRequiredModules` dat elke vereiste module daadwerkelijk aanwezig is in de doel-assemblage.
+ * Ontbreekt er één, dan weigert de scaffolder fail-fast met een expliciete melding (nooit stil een
+ * halve autorisatie-laag genereren die op een afwezige authenticatie-module leunt).
+ *
+ * Puur & deterministisch: geen fs, geen module-globale mutable state, geen random/timestamps.
+ */
+import type { CapabilityModuleManifest } from '../../manifest.js';
+/**
+ * Controleert dat elke `manifest.requires.modules`-entry in `presentModules` zit. Ontbreekt er één
+ * of meer, dan wordt een {@link MissingRequiredModuleError} geworpen met ÁLLE ontbrekende modules.
+ * Heeft het manifest geen `requires.modules`, dan is er niets te controleren (no-op).
+ *
+ * @throws MissingRequiredModuleError als een vereiste module niet aanwezig is
+ */
+export declare function checkRequiredModules(manifest: CapabilityModuleManifest, presentModules: readonly string[]): void;
+/** Opties voor `assertAssemblable`. */
+export interface AssemblableOptions {
+    /** De capability-modules die in de doel-assemblage aanwezig zijn. */
+    readonly presentModules: readonly string[];
+}
+/**
+ * Kleine helper die vóór het assembleren bevestigt dat de module assembleerbaar is: momenteel is dat
+ * exact de module-presence-check (US-Z0803). Gooit dezelfde {@link MissingRequiredModuleError} als
+ * `checkRequiredModules`; bedoeld als één duidelijk instappunt voor de scaffolder-orkestratie.
+ *
+ * @throws MissingRequiredModuleError als een vereiste module niet aanwezig is
+ */
+export declare function assertAssemblable(manifest: CapabilityModuleManifest, options: AssemblableOptions): void;
+//# sourceMappingURL=presence.d.ts.map

package/dist/scaffolder/core/presence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../../scaffolder/core/presence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAGlE;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,wBAAwB,EAClC,cAAc,EAAE,SAAS,MAAM,EAAE,GAChC,IAAI,CASN;AAED,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,wBAAwB,EAClC,OAAO,EAAE,kBAAkB,GAC1B,IAAI,CAEN"}

package/dist/scaffolder/core/presence.js

@@ -0,0 +1,29 @@
+import { MissingRequiredModuleError } from './errors.js';
+/**
+ * Controleert dat elke `manifest.requires.modules`-entry in `presentModules` zit. Ontbreekt er één
+ * of meer, dan wordt een {@link MissingRequiredModuleError} geworpen met ÁLLE ontbrekende modules.
+ * Heeft het manifest geen `requires.modules`, dan is er niets te controleren (no-op).
+ *
+ * @throws MissingRequiredModuleError als een vereiste module niet aanwezig is
+ */
+export function checkRequiredModules(manifest, presentModules) {
+    const required = manifest.requires.modules;
+    if (required === undefined || required.length === 0)
+        return;
+    const aanwezig = new Set(presentModules);
+    const missing = required.filter((module) => !aanwezig.has(module));
+    if (missing.length > 0) {
+        throw new MissingRequiredModuleError(missing);
+    }
+}
+/**
+ * Kleine helper die vóór het assembleren bevestigt dat de module assembleerbaar is: momenteel is dat
+ * exact de module-presence-check (US-Z0803). Gooit dezelfde {@link MissingRequiredModuleError} als
+ * `checkRequiredModules`; bedoeld als één duidelijk instappunt voor de scaffolder-orkestratie.
+ *
+ * @throws MissingRequiredModuleError als een vereiste module niet aanwezig is
+ */
+export function assertAssemblable(manifest, options) {
+    checkRequiredModules(manifest, options.presentModules);
+}
+//# sourceMappingURL=presence.js.map

package/dist/scaffolder/core/presence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.js","sourceRoot":"","sources":["../../../scaffolder/core/presence.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAkC,EAClC,cAAiC;IAEjC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;IAC3C,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAE5D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACnE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,0BAA0B,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;AACH,CAAC;AAQD;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAkC,EAClC,OAA2B;IAE3B,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;AACzD,CAAC"}

package/dist/scaffolder/core/three-way-merge.d.ts

@@ -0,0 +1,113 @@
+/**
+ * three-way-merge — de UPGRADE-stap die "mag divergeren" van een val naar een feature maakt (US-Z0804).
+ *
+ * Per surface-bestand reconcilieert `mergeSurface` drie versies:
+ *   - `base`     = de oorspronkelijk gematerialiseerde template (uit het `MaterializationRecord`),
+ *   - `upstream` = de nieuwe template-versie,
+ *   - `current`  = het (mogelijk gedivergeerde) projectbestand.
+ *
+ * Regels:
+ *   - `current === base`      → schoon toepassen: neem `upstream` over (project onaangeroerd).
+ *   - `upstream === base`     → behoud `current` (upstream ongewijzigd; divergentie blijft staan).
+ *   - `current === upstream`  → beide al gelijk; niets te doen.
+ *   - anders                  → regel-gebaseerde diff3: niet-botsende wijzigingen mergen, botsende
+ *                               krijgen CONFLICT-markers (nooit stil overschrijven).
+ *
+ * `upgradeSurface` orkestreert dit over alle bestanden met behulp van het `MaterializationRecord` en
+ * de twee templateVersions. Puur & deterministisch: geen fs-side-effects in de merge zelf, geen random.
+ */
+import type { AuthzScaffolderFsPort, FileDescriptor } from './ports.js';
+import type { MaterializationRecord } from './materialize.js';
+/** De uitkomst-categorie van een merge. */
+export type MergeStatus = 'clean' | 'unchanged' | 'merged' | 'conflict';
+/** Labels die in de conflict-markers verschijnen. */
+export interface MergeMarkerLabels {
+    readonly current: string;
+    readonly base: string;
+    readonly upstream: string;
+}
+/** Invoer voor één bestand-merge. */
+export interface MergeInput {
+    readonly base: string;
+    readonly upstream: string;
+    readonly current: string;
+    readonly labels?: MergeMarkerLabels;
+}
+/** Resultaat van één bestand-merge. */
+export interface MergeResult {
+    readonly status: MergeStatus;
+    /** De uiteindelijke inhoud (met conflict-markers als `status === 'conflict'`). */
+    readonly contents: string;
+    /** True als er minstens één conflict-hunk in zit. */
+    readonly conflict: boolean;
+    /** Aantal conflict-hunks (0 als schoon). */
+    readonly conflicts: number;
+}
+/**
+ * Reconcilieert één bestand (base ↔ upstream ↔ current). Zie de bestandskop voor de regels.
+ */
+export declare function mergeSurface(input: MergeInput): MergeResult;
+/** De uitkomst per bestand binnen een upgrade. */
+export interface FileUpgradeOutcome {
+    readonly path: string;
+    /** Merge-status, of 'added' voor een nieuw upstream-bestand dat nog niet in het project stond. */
+    readonly status: MergeStatus | 'added';
+    readonly contents: string;
+    readonly conflict: boolean;
+}
+/** Uitkomst van een acceptatiegate (contract-tests + verticale e2e). */
+export interface GateOutcome {
+    readonly ok: boolean;
+    /** Naam van de gefaalde gate (bv. 'contract' of 'e2e'), indien van toepassing. */
+    readonly failed?: string;
+}
+/** Een acceptatiegate-callback die na de merge draait; ontvangt de voorgestelde bestanden. */
+export type AcceptanceGate = (files: readonly FileUpgradeOutcome[]) => GateOutcome;
+/** Opties voor `upgradeSurface`. */
+export interface UpgradeOptions {
+    /** Het stempelrecord van de vorige materialisatie (levert base + fromVersion per bestand). */
+    readonly record: MaterializationRecord;
+    /** De nieuwe surface-templates (upstream), voor de doel-`toVersion`. */
+    readonly upstreamFiles: readonly FileDescriptor[];
+    /** De doel-templateVersion die na een veilige upgrade gestempeld wordt. */
+    readonly toVersion: string;
+    /** Fs-port om de huidige (mogelijk gedivergeerde) projectbestanden in te lezen. */
+    readonly fsPort: AuthzScaffolderFsPort;
+    /**
+     * Schrijf de gemergede inhoud terug via de fs-port. Standaard `false` (droog: alleen een plan).
+     * Conflict-bestanden worden NOOIT geschreven, ook niet met `write: true` — ze wachten op reconciliatie.
+     */
+    readonly write?: boolean;
+    /**
+     * Optionele acceptatiegate (contract + e2e). Wordt hij opgegeven én slaagt hij niet, dan is de
+     * upgrade niet veilig (US-Z0804 AC3 / US-Z1004 AC3): bewuste overschrijding richting fork (niveau 4).
+     */
+    readonly gate?: AcceptanceGate;
+    readonly labels?: MergeMarkerLabels;
+}
+/** Uitkomst van een volledige upgrade-run. */
+export interface UpgradeResult {
+    readonly fromVersion: string;
+    readonly toVersion: string;
+    readonly files: readonly FileUpgradeOutcome[];
+    /** Paden met een onopgelost conflict. */
+    readonly conflicts: readonly string[];
+    /**
+     * Is de upgrade veilig? True als er geen conflicten zijn ÉN (indien opgegeven) de gate groen is.
+     * Bij `false` is de divergentie bewust richting niveau 4 (fork) gegaan tenzij eerst gereconcilieerd.
+     */
+    readonly safe: boolean;
+    /** Uitkomst van de gate, indien er één is opgegeven. */
+    readonly gate?: GateOutcome;
+    /**
+     * Het bijgewerkte stempelrecord: schoon-toegepaste/gemergede bestanden staan op `toVersion` met de
+     * nieuwe basis; conflict-bestanden houden hun oude stempel tot ze gereconcilieerd zijn.
+     */
+    readonly record: MaterializationRecord;
+}
+/**
+ * Orkestreert de upgrade over alle upstream-bestanden op basis van het stempelrecord.
+ * Mecht uitsluitend de surface; het mechanisme upgradet los via semver (buiten deze functie).
+ */
+export declare function upgradeSurface(options: UpgradeOptions): UpgradeResult;
+//# sourceMappingURL=three-way-merge.d.ts.map

package/dist/scaffolder/core/three-way-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"three-way-merge.d.ts","sourceRoot":"","sources":["../../../scaffolder/core/three-way-merge.ts"],"names":[],"mappings":"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"}

package/dist/scaffolder/core/three-way-merge.js

@@ -0,0 +1,184 @@
+const DEFAULT_LABELS = { current: 'current', base: 'base', upstream: 'upstream' };
+/**
+ * Reconcilieert één bestand (base ↔ upstream ↔ current). Zie de bestandskop voor de regels.
+ */
+export function mergeSurface(input) {
+    const { base, upstream, current } = input;
+    const labels = input.labels ?? DEFAULT_LABELS;
+    // Snelle, exacte gevallen — behandeld vóór de regel-diff zodat triviale upgrades geen merge doen.
+    if (current === base) {
+        // Project heeft niets aangeraakt → neem de nieuwe template schoon over.
+        return { status: 'clean', contents: upstream, conflict: false, conflicts: 0 };
+    }
+    if (upstream === base) {
+        // Upstream is onveranderd → behoud de (gedivergeerde) projectversie.
+        return { status: 'unchanged', contents: current, conflict: false, conflicts: 0 };
+    }
+    if (current === upstream) {
+        // Beide kanten kwamen op dezelfde inhoud uit → niets te mergen.
+        return { status: 'clean', contents: current, conflict: false, conflicts: 0 };
+    }
+    // Echte drie-weg-merge op regelniveau.
+    const { lines, conflicts } = threeWayMergeLines(splitLines(base), splitLines(current), splitLines(upstream), labels);
+    const contents = lines.join('\n');
+    return {
+        status: conflicts > 0 ? 'conflict' : 'merged',
+        contents,
+        conflict: conflicts > 0,
+        conflicts,
+    };
+}
+/** Splitst inhoud in regels. Behoudt lege staart-regels zodat join('\n') exact terugkeert. */
+function splitLines(text) {
+    return text.split('\n');
+}
+/** Array-gelijkheid op regels. */
+function equalLines(a, b) {
+    if (a.length !== b.length)
+        return false;
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i])
+            return false;
+    }
+    return true;
+}
+/**
+ * Longest common subsequence van twee regel-arrays. Levert de gematchte index-paren [xIdx, yIdx] in
+ * oplopende volgorde. Klassieke DP; deterministisch (bij gelijke lengte kiest hij consequent x++).
+ */
+function lcsPairs(x, y) {
+    const n = x.length;
+    const m = y.length;
+    const dp = Array.from({ length: n + 1 }, () => new Array(m + 1).fill(0));
+    for (let i = n - 1; i >= 0; i--) {
+        for (let j = m - 1; j >= 0; j--) {
+            dp[i][j] = x[i] === y[j] ? dp[i + 1][j + 1] + 1 : Math.max(dp[i + 1][j], dp[i][j + 1]);
+        }
+    }
+    const pairs = [];
+    let i = 0;
+    let j = 0;
+    while (i < n && j < m) {
+        if (x[i] === y[j]) {
+            pairs.push([i, j]);
+            i++;
+            j++;
+        }
+        else if (dp[i + 1][j] >= dp[i][j + 1]) {
+            i++;
+        }
+        else {
+            j++;
+        }
+    }
+    return pairs;
+}
+/** Zet LCS-paren om naar een map baseIndex → otherIndex. */
+function matchMap(pairs) {
+    const map = new Map();
+    for (const [o, other] of pairs)
+        map.set(o, other);
+    return map;
+}
+/**
+ * De eigenlijke diff3. Ankers = base-regels die ONgewijzigd zijn in zowel `current` als `upstream`
+ * (aanwezig in beide LCS'en). Tussen opeenvolgende ankers classificeren we het segment:
+ *   - alleen upstream wijzigde  → neem upstream-segment,
+ *   - alleen current wijzigde   → neem current-segment,
+ *   - beide identiek gewijzigd  → neem dat (geen conflict),
+ *   - beide verschillend        → CONFLICT-markers.
+ * Omdat beide LCS'en monotoon zijn in de base-index, zijn de ankers monotoon in alle drie de indices.
+ */
+function threeWayMergeLines(base, current, upstream, labels) {
+    const matchCurrent = matchMap(lcsPairs(base, current)); // baseIdx → currentIdx
+    const matchUpstream = matchMap(lcsPairs(base, upstream)); // baseIdx → upstreamIdx
+    const anchors = [];
+    for (let o = 0; o < base.length; o++) {
+        const a = matchCurrent.get(o);
+        const b = matchUpstream.get(o);
+        if (a !== undefined && b !== undefined)
+            anchors.push({ o, a, b });
+    }
+    const out = [];
+    let conflicts = 0;
+    let po = -1;
+    let pa = -1;
+    let pb = -1;
+    const emitSegment = (oE, aE, bE) => {
+        const baseSeg = base.slice(po + 1, oE);
+        const currentSeg = current.slice(pa + 1, aE);
+        const upstreamSeg = upstream.slice(pb + 1, bE);
+        if (baseSeg.length === 0 && currentSeg.length === 0 && upstreamSeg.length === 0)
+            return;
+        if (equalLines(currentSeg, baseSeg)) {
+            out.push(...upstreamSeg); // alleen upstream wijzigde
+        }
+        else if (equalLines(upstreamSeg, baseSeg)) {
+            out.push(...currentSeg); // alleen current wijzigde
+        }
+        else if (equalLines(currentSeg, upstreamSeg)) {
+            out.push(...currentSeg); // beide dezelfde wijziging
+        }
+        else {
+            conflicts++;
+            out.push(`<<<<<<< ${labels.current}`, ...currentSeg, `||||||| ${labels.base}`, ...baseSeg, '=======', ...upstreamSeg, `>>>>>>> ${labels.upstream}`);
+        }
+    };
+    for (const anchor of anchors) {
+        emitSegment(anchor.o, anchor.a, anchor.b);
+        out.push(base[anchor.o]); // het anker zelf is in alle drie identiek
+        po = anchor.o;
+        pa = anchor.a;
+        pb = anchor.b;
+    }
+    // Staart-segment na het laatste anker.
+    emitSegment(base.length, current.length, upstream.length);
+    return { lines: out, conflicts };
+}
+/**
+ * Orkestreert de upgrade over alle upstream-bestanden op basis van het stempelrecord.
+ * Mecht uitsluitend de surface; het mechanisme upgradet los via semver (buiten deze functie).
+ */
+export function upgradeSurface(options) {
+    const { record, upstreamFiles, toVersion, fsPort, write = false, gate, labels } = options;
+    const fromVersion = record.templateVersion;
+    const files = [];
+    const conflicts = [];
+    const nextFiles = { ...record.files };
+    for (const upstream of upstreamFiles) {
+        const stamped = record.files[upstream.path];
+        const exists = fsPort.exists(upstream.path);
+        // Nieuw upstream-bestand (nog niet gematerialiseerd) of ontbrekend in het project → toevoegen.
+        if (stamped === undefined || !exists) {
+            files.push({ path: upstream.path, status: 'added', contents: upstream.contents, conflict: false });
+            if (write)
+                fsPort.write(upstream.path, upstream.contents);
+            nextFiles[upstream.path] = { templateVersion: toVersion, base: upstream.contents };
+            continue;
+        }
+        const current = fsPort.read(upstream.path);
+        const merge = mergeSurface({ base: stamped.base, upstream: upstream.contents, current, labels });
+        files.push({ path: upstream.path, status: merge.status, contents: merge.contents, conflict: merge.conflict });
+        if (merge.conflict) {
+            conflicts.push(upstream.path);
+            // Conflict: niet schrijven, oud stempel behouden tot reconciliatie.
+            continue;
+        }
+        if (write)
+            fsPort.write(upstream.path, merge.contents);
+        // Schoon/gemerged: stempel de nieuwe versie en leg de nieuwe basis vast voor volgende upgrades.
+        nextFiles[upstream.path] = { templateVersion: toVersion, base: merge.contents };
+    }
+    const gateOutcome = gate ? gate(files) : undefined;
+    const safe = conflicts.length === 0 && (gateOutcome ? gateOutcome.ok : true);
+    return {
+        fromVersion,
+        toVersion,
+        files,
+        conflicts,
+        safe,
+        gate: gateOutcome,
+        record: { module: record.module, templateVersion: safe ? toVersion : fromVersion, files: nextFiles },
+    };
+}
+//# sourceMappingURL=three-way-merge.js.map

package/dist/scaffolder/core/three-way-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"three-way-merge.js","sourceRoot":"","sources":["../../../scaffolder/core/three-way-merge.ts"],"names":[],"mappings":"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"}

package/dist/scaffolder/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * scaffolder (authorization) — de version-aware materializer van de authorization-capability-module.
+ *
+ * Composeert het manifest (US-Z0801/0802) tot een werkende generate + upgrade-merge, en levert de
+ * divergentie-ladder niveau 1–3 (configureren, uitbreiden, materialiseren & mergen). Nieuw t.o.v. de
+ * authentication-tier: de module→module presence-check (US-Z0803), want dit is de eerste module die
+ * van een ándere capability-module afhangt. Alle core-functies zijn puur/deterministisch; het
+ * wegschrijven en inlezen gaat via een geïnjecteerde fs-port. Geen module-globale mutable state, geen
+ * echt filesystem. Dit is een build/dev-tool, geen runtime-mechanisme.
+ */
+export type { FileDescriptor, AuthzScaffolderFsPort, MemoryFsPort } from './core/ports.js';
+export { createMemoryFsPort } from './core/ports.js';
+export { materializeAuthzModule, stampedVersions } from './core/materialize.js';
+export type { MaterializeOptions, MaterializeResult, MaterializationRecord, MaterializedFile, } from './core/materialize.js';
+export { mergeSurface, upgradeSurface } from './core/three-way-merge.js';
+export type { MergeStatus, MergeInput, MergeResult, MergeMarkerLabels, UpgradeOptions, UpgradeResult, FileUpgradeOutcome, AcceptanceGate, GateOutcome, } from './core/three-way-merge.js';
+export { checkRequiredModules, assertAssemblable } from './core/presence.js';
+export type { AssemblableOptions } from './core/presence.js';
+export { resolveAuthzConfig, filterSurfaceByConfig, authzConfigSchema } from './core/config.js';
+export type { EffectiveAuthzConfig, ResolvedAuthzConfig, AffectedSurface, } from './core/config.js';
+export { definePermissionExtension, createPolicyHookRegistry, defineRelationResolver, } from './core/extend.js';
+export type { PolicyDecisionContext, PolicyHook, PolicyHookRunResult, PolicyHookRegistry, RelationResolverSpec, RelationResolverInput, RelationResolverDescriptor, } from './core/extend.js';
+export { AuthzMaterializationConflictError, MissingRequiredPortError, MissingRequiredModuleError, AuthzConfigValidationError, } from './core/errors.js';
+export type { AuthzConfigViolation } from './core/errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/scaffolder/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../scaffolder/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC3F,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGrD,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAChF,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACzE,YAAY,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,WAAW,GACZ,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAG7D,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAChG,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,qBAAqB,EACrB,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,iCAAiC,EACjC,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}