npm - @seifer-webapp-factory/user-settings - Versions diffs - 0.1.0 - Mend

@seifer-webapp-factory/user-settings 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (106) hide show

package/README.md +122 -0
package/backend/templates/config/config-fragment.ts +22 -0
package/backend/templates/nestjs/tokens.ts +15 -0
package/backend/templates/nestjs/user-settings.controller.ts +119 -0
package/backend/templates/nestjs/user-settings.module.ts +107 -0
package/backend/templates/persistence/migrations/0001_user_settings.sql +16 -0
package/backend/templates/persistence/migrations/index.ts +37 -0
package/backend/templates/persistence/pg-settings-store.ts +62 -0
package/backend/templates/security/security.ts +79 -0
package/dist/backend/src/descriptors.d.ts +11 -0
package/dist/backend/src/descriptors.d.ts.map +1 -0
package/dist/backend/src/descriptors.js +38 -0
package/dist/backend/src/descriptors.js.map +1 -0
package/dist/backend/src/errors.d.ts +18 -0
package/dist/backend/src/errors.d.ts.map +1 -0
package/dist/backend/src/errors.js +29 -0
package/dist/backend/src/errors.js.map +1 -0
package/dist/backend/src/index.d.ts +10 -0
package/dist/backend/src/index.d.ts.map +1 -0
package/dist/backend/src/index.js +9 -0
package/dist/backend/src/index.js.map +1 -0
package/dist/backend/src/ports.d.ts +58 -0
package/dist/backend/src/ports.d.ts.map +1 -0
package/dist/backend/src/ports.js +2 -0
package/dist/backend/src/ports.js.map +1 -0
package/dist/backend/src/services.d.ts +26 -0
package/dist/backend/src/services.d.ts.map +1 -0
package/dist/backend/src/services.js +104 -0
package/dist/backend/src/services.js.map +1 -0
package/dist/contract/config.d.ts +35 -0
package/dist/contract/config.d.ts.map +1 -0
package/dist/contract/config.js +20 -0
package/dist/contract/config.js.map +1 -0
package/dist/contract/endpoints.d.ts +188 -0
package/dist/contract/endpoints.d.ts.map +1 -0
package/dist/contract/endpoints.js +21 -0
package/dist/contract/endpoints.js.map +1 -0
package/dist/contract/errors.d.ts +22 -0
package/dist/contract/errors.d.ts.map +1 -0
package/dist/contract/errors.js +26 -0
package/dist/contract/errors.js.map +1 -0
package/dist/contract/events.d.ts +38 -0
package/dist/contract/events.d.ts.map +1 -0
package/dist/contract/events.js +7 -0
package/dist/contract/events.js.map +1 -0
package/dist/contract/index.d.ts +11 -0
package/dist/contract/index.d.ts.map +1 -0
package/dist/contract/index.js +11 -0
package/dist/contract/index.js.map +1 -0
package/dist/contract/schemas.d.ts +255 -0
package/dist/contract/schemas.d.ts.map +1 -0
package/dist/contract/schemas.js +54 -0
package/dist/contract/schemas.js.map +1 -0
package/dist/frontend/src/client.d.ts +22 -0
package/dist/frontend/src/client.d.ts.map +1 -0
package/dist/frontend/src/client.js +64 -0
package/dist/frontend/src/client.js.map +1 -0
package/dist/frontend/src/descriptors.d.ts +12 -0
package/dist/frontend/src/descriptors.d.ts.map +1 -0
package/dist/frontend/src/descriptors.js +44 -0
package/dist/frontend/src/descriptors.js.map +1 -0
package/dist/frontend/src/index.d.ts +16 -0
package/dist/frontend/src/index.d.ts.map +1 -0
package/dist/frontend/src/index.js +12 -0
package/dist/frontend/src/index.js.map +1 -0
package/dist/frontend/src/ssr.d.ts +43 -0
package/dist/frontend/src/ssr.d.ts.map +1 -0
package/dist/frontend/src/ssr.js +90 -0
package/dist/frontend/src/ssr.js.map +1 -0
package/dist/frontend/src/store.d.ts +46 -0
package/dist/frontend/src/store.d.ts.map +1 -0
package/dist/frontend/src/store.js +111 -0
package/dist/frontend/src/store.js.map +1 -0
package/dist/frontend/src/useSettings.d.ts +46 -0
package/dist/frontend/src/useSettings.d.ts.map +1 -0
package/dist/frontend/src/useSettings.js +100 -0
package/dist/frontend/src/useSettings.js.map +1 -0
package/dist/manifest.d.ts +59 -0
package/dist/manifest.d.ts.map +1 -0
package/dist/manifest.js +45 -0
package/dist/manifest.js.map +1 -0
package/dist/scaffolder/core/errors.d.ts +24 -0
package/dist/scaffolder/core/errors.d.ts.map +1 -0
package/dist/scaffolder/core/errors.js +38 -0
package/dist/scaffolder/core/errors.js.map +1 -0
package/dist/scaffolder/core/materialize.d.ts +40 -0
package/dist/scaffolder/core/materialize.d.ts.map +1 -0
package/dist/scaffolder/core/materialize.js +38 -0
package/dist/scaffolder/core/materialize.js.map +1 -0
package/dist/scaffolder/core/ports.d.ts +28 -0
package/dist/scaffolder/core/ports.d.ts.map +1 -0
package/dist/scaffolder/core/ports.js +28 -0
package/dist/scaffolder/core/ports.js.map +1 -0
package/dist/scaffolder/core/presence.d.ts +21 -0
package/dist/scaffolder/core/presence.d.ts.map +1 -0
package/dist/scaffolder/core/presence.js +20 -0
package/dist/scaffolder/core/presence.js.map +1 -0
package/dist/scaffolder/index.d.ts +20 -0
package/dist/scaffolder/index.d.ts.map +1 -0
package/dist/scaffolder/index.js +6 -0
package/dist/scaffolder/index.js.map +1 -0
package/frontend/templates/i18n/en.json +20 -0
package/frontend/templates/i18n/nl.json +20 -0
package/frontend/templates/pages/settings.vue +62 -0
package/frontend/templates/runtime.ts +19 -0
package/package.json +79 -0

package/dist/frontend/src/ssr.d.ts ADDED Viewed

@@ -0,0 +1,43 @@
+/**
+ * SSR-afhandeling van de render-kritieke keys (theme/locale/dir), first-paint-veilig. De aanpak is
+ * sterker dan de localStorage+script van next-themes/Nuxt color-mode:
+ *
+ *  - Terugkerende bezoeker: de server leest de cookie en zet de juiste `<html>`-class in de initiële HTML —
+ *    écht geen flash, geen script nodig.
+ *  - Eerste bezoek: het OS-thema is server-side niet leesbaar zonder de `Sec-CH-Prefers-Color-Scheme`
+ *    client-hint, dus (a) `color-scheme: light dark` + `light-dark()` als zero-JS default die het OS bij
+ *    first paint volgt, en (b) een synchroon `<head>`-script (primaire route, geen last-resort) dat de
+ *    `<html>`-class alleen zet als een opgeslagen voorkeur de media-query tegenspreekt.
+ *
+ * Puur & framework-agnostisch: geen DOM-afhankelijkheid, geen module-globale state — makkelijk te testen.
+ */
+export interface RenderState {
+    theme: string | null;
+    locale: string | null;
+    dir: string | null;
+}
+/** Parse een rauwe `Cookie`-header naar een naam→waarde-map (server-side). */
+export declare function parseCookies(cookieHeader: string | null | undefined): Record<string, string>;
+/** Neem de eerste taalcode uit een `Accept-Language`-header (alleen een HINT, nooit een override). */
+export declare function firstAcceptLanguage(acceptLanguage: string | null | undefined): string | null;
+export interface ResolveRenderStateOptions {
+    readonly cookieHeader?: string | null;
+    readonly cookiePrefix: string;
+    readonly acceptLanguage?: string | null;
+    readonly defaults?: Partial<RenderState>;
+}
+/**
+ * Resolve de render-state die de server in de initiële HTML zet. `theme` uit de cookie (of default; `null`
+ * → laat CSS `light-dark()` het OS volgen). `locale` uit de cookie, anders de `Accept-Language`-hint,
+ * anders de default. `dir` uit de cookie of default.
+ */
+export declare function resolveRenderState(options: ResolveRenderStateOptions): RenderState;
+/** `<meta name="color-scheme">`-content zodat native controls/scrollbars vóór CSS goed staan. */
+export declare function colorSchemeMeta(theme: string | null): string;
+/**
+ * Het synchrone `<head>`-script (primaire first-visit-route). Leest de theme-cookie client-side en zet de
+ * `<html data-theme>` vóór first paint, maar ALLEEN als er een opgeslagen voorkeur is — anders laat het
+ * `light-dark()` het OS volgen. Injecteer met een CSP-nonce en zet `suppressHydrationWarning` op `<html>`.
+ */
+export declare function renderHeadScript(cookiePrefix: string): string;
+//# sourceMappingURL=ssr.d.ts.map

package/dist/frontend/src/ssr.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"ssr.d.ts","sourceRoot":"","sources":["../../../frontend/src/ssr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAW5F;AAED,sGAAsG;AACtG,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAM5F;AAaD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CAC1C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,WAAW,CAQlF;AAED,iGAAiG;AACjG,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAI5D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAW7D"}

package/dist/frontend/src/ssr.js ADDED Viewed

@@ -0,0 +1,90 @@
+/**
+ * SSR-afhandeling van de render-kritieke keys (theme/locale/dir), first-paint-veilig. De aanpak is
+ * sterker dan de localStorage+script van next-themes/Nuxt color-mode:
+ *
+ *  - Terugkerende bezoeker: de server leest de cookie en zet de juiste `<html>`-class in de initiële HTML —
+ *    écht geen flash, geen script nodig.
+ *  - Eerste bezoek: het OS-thema is server-side niet leesbaar zonder de `Sec-CH-Prefers-Color-Scheme`
+ *    client-hint, dus (a) `color-scheme: light dark` + `light-dark()` als zero-JS default die het OS bij
+ *    first paint volgt, en (b) een synchroon `<head>`-script (primaire route, geen last-resort) dat de
+ *    `<html>`-class alleen zet als een opgeslagen voorkeur de media-query tegenspreekt.
+ *
+ * Puur & framework-agnostisch: geen DOM-afhankelijkheid, geen module-globale state — makkelijk te testen.
+ */
+/** Parse een rauwe `Cookie`-header naar een naam→waarde-map (server-side). */
+export function parseCookies(cookieHeader) {
+    const out = {};
+    if (!cookieHeader)
+        return out;
+    for (const part of cookieHeader.split(';')) {
+        const eq = part.indexOf('=');
+        if (eq === -1)
+            continue;
+        const name = part.slice(0, eq).trim();
+        const value = part.slice(eq + 1).trim();
+        if (name.length > 0)
+            out[name] = decodeURIComponent(value);
+    }
+    return out;
+}
+/** Neem de eerste taalcode uit een `Accept-Language`-header (alleen een HINT, nooit een override). */
+export function firstAcceptLanguage(acceptLanguage) {
+    if (!acceptLanguage)
+        return null;
+    const first = acceptLanguage.split(',')[0];
+    if (first === undefined)
+        return null;
+    const tag = first.split(';')[0]?.trim();
+    return tag && tag.length > 0 ? tag : null;
+}
+/** De opgeslagen cel op de cookie is JSON `{ v, ver, t }`; haal er de waarde uit (of null). */
+function cookieValue(raw) {
+    if (raw === undefined)
+        return null;
+    try {
+        const parsed = JSON.parse(raw);
+        return typeof parsed.v === 'string' ? parsed.v : null;
+    }
+    catch {
+        return typeof raw === 'string' ? raw : null;
+    }
+}
+/**
+ * Resolve de render-state die de server in de initiële HTML zet. `theme` uit de cookie (of default; `null`
+ * → laat CSS `light-dark()` het OS volgen). `locale` uit de cookie, anders de `Accept-Language`-hint,
+ * anders de default. `dir` uit de cookie of default.
+ */
+export function resolveRenderState(options) {
+    const { cookiePrefix, cookieHeader, acceptLanguage, defaults } = options;
+    const cookies = parseCookies(cookieHeader);
+    const theme = cookieValue(cookies[`${cookiePrefix}theme`]) ?? defaults?.theme ?? null;
+    const locale = cookieValue(cookies[`${cookiePrefix}locale`]) ?? firstAcceptLanguage(acceptLanguage) ?? defaults?.locale ?? null;
+    const dir = cookieValue(cookies[`${cookiePrefix}dir`]) ?? defaults?.dir ?? null;
+    return { theme, locale, dir };
+}
+/** `<meta name="color-scheme">`-content zodat native controls/scrollbars vóór CSS goed staan. */
+export function colorSchemeMeta(theme) {
+    if (theme === 'dark')
+        return 'dark light';
+    if (theme === 'light')
+        return 'light dark';
+    return 'light dark';
+}
+/**
+ * Het synchrone `<head>`-script (primaire first-visit-route). Leest de theme-cookie client-side en zet de
+ * `<html data-theme>` vóór first paint, maar ALLEEN als er een opgeslagen voorkeur is — anders laat het
+ * `light-dark()` het OS volgen. Injecteer met een CSP-nonce en zet `suppressHydrationWarning` op `<html>`.
+ */
+export function renderHeadScript(cookiePrefix) {
+    const cookieName = `${cookiePrefix}theme`;
+    return [
+        '(function(){try{',
+        `var m=document.cookie.match(/(?:^|; )${cookieName}=([^;]*)/);`,
+        'if(!m)return;',
+        'var raw=decodeURIComponent(m[1]);var t=raw;',
+        'try{var p=JSON.parse(raw);if(p&&typeof p.v==="string")t=p.v;}catch(e){}',
+        'if(t==="dark"||t==="light"){document.documentElement.setAttribute("data-theme",t);}',
+        '}catch(e){}})();',
+    ].join('');
+}
+//# sourceMappingURL=ssr.js.map

package/dist/frontend/src/ssr.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"ssr.js","sourceRoot":"","sources":["../../../frontend/src/ssr.ts"],"names":[],"mappings":"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"}

package/dist/frontend/src/store.d.ts ADDED Viewed

@@ -0,0 +1,46 @@
+/**
+ * De `SettingsStore`-poort + de twee adapters (het mechanisme). Eén seam, twee runtime-backends:
+ *
+ *  - {@link createClientAdapter}: cookie (render-kritieke keys, SSR-leesbaar) + localStorage (functionele
+ *    prefs), voor de anonieme gebruiker. Junk uit storage valt terug op de descriptor-`default`.
+ *  - {@link createServerAdapter}: de getypte client over `GET/PUT /settings`, voor de geauthenticeerde
+ *    gebruiker; render-keys blijven op de cookie gespiegeld zodat SSR post-login blijft werken.
+ *
+ * De poort is uniform async (zodat één seam een netwerk-adapter kan hosten) en houdt zich aan de
+ * client∩server-intersectie. Waarden zijn host-getypt → op de poort-grens `unknown`.
+ */
+import type { SettingsRecord, SettingsSchema } from '../../contract/index.js';
+import type { UserSettingsClient } from './client.js';
+/** De swappable seam die beide adapters implementeren. */
+export interface SettingsStore {
+    get(key: string): Promise<SettingsRecord | null>;
+    set(key: string, value: unknown, baseVersion?: number): Promise<SettingsRecord>;
+    all(): Promise<Record<string, SettingsRecord>>;
+    /** Wist één key (of alles). Client: verwijdert de lokale kopie. Server: reset naar de descriptor-default. */
+    clear(key?: string): Promise<void>;
+}
+/** Minimale key-value-poort (cookie of localStorage). Bewust synchroon; SSR levert een cookie-only variant. */
+export interface KeyValueStore {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    remove(key: string): void;
+}
+export interface CreateClientAdapterOptions {
+    readonly descriptors: SettingsSchema;
+    /** Server-leesbare cookie-toegang (app-kernel). */
+    readonly cookie: KeyValueStore;
+    /** localStorage (browser). */
+    readonly local: KeyValueStore;
+    readonly cookiePrefix: string;
+    readonly renderKeys: readonly string[];
+    readonly clock: () => number;
+}
+/** De anonieme client-adapter: cookie voor render-keys, localStorage voor de rest. */
+export declare function createClientAdapter(options: CreateClientAdapterOptions): SettingsStore;
+export interface CreateServerAdapterOptions {
+    readonly client: UserSettingsClient;
+    readonly descriptors: SettingsSchema;
+}
+/** De geauthenticeerde server-adapter: de getypte client over GET/PUT /settings. */
+export declare function createServerAdapter(options: CreateServerAdapterOptions): SettingsStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/frontend/src/store.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../frontend/src/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAqB,cAAc,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEjG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACjD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAChF,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IAC/C,6GAA6G;IAC7G,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,+GAA+G;AAC/G,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAChC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AA2BD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,MAAM,CAAC;CAC9B;AAED,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,aAAa,CAsDtF;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;CACtC;AAED,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,aAAa,CAkCtF"}

package/dist/frontend/src/store.js ADDED Viewed

@@ -0,0 +1,111 @@
+import { coerceValue, indexDescriptors } from './descriptors.js';
+function parseCell(raw) {
+    if (raw === null)
+        return null;
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed === null || typeof parsed !== 'object')
+            return null;
+        const cell = parsed;
+        if (typeof cell.ver !== 'number' || typeof cell.t !== 'number')
+            return null;
+        return { v: cell.v, ver: cell.ver, t: cell.t, del: cell.del === true ? true : undefined };
+    }
+    catch {
+        return null;
+    }
+}
+function toRecord(descriptor, cell) {
+    const value = coerceValue(descriptor, cell.v, cell.ver);
+    return { value, version: cell.ver, updatedAt: cell.t, ...(cell.del ? { deleted: true } : {}) };
+}
+/** De anonieme client-adapter: cookie voor render-keys, localStorage voor de rest. */
+export function createClientAdapter(options) {
+    const { descriptors, cookie, local, cookiePrefix, renderKeys, clock } = options;
+    const index = indexDescriptors(descriptors);
+    const renderSet = new Set(renderKeys);
+    function isRender(descriptor) {
+        return descriptor.namespace === 'render' || descriptor.cookie === true || renderSet.has(descriptor.key);
+    }
+    function backendFor(descriptor) {
+        return isRender(descriptor)
+            ? { store: cookie, storageKey: `${cookiePrefix}${descriptor.key}` }
+            : { store: local, storageKey: `${cookiePrefix}${descriptor.key}` };
+    }
+    async function get(key) {
+        const descriptor = index.get(key);
+        if (descriptor === undefined)
+            return null;
+        const { store, storageKey } = backendFor(descriptor);
+        const cell = parseCell(store.get(storageKey));
+        if (cell === null)
+            return null;
+        return toRecord(descriptor, cell);
+    }
+    async function set(key, value, baseVersion) {
+        const descriptor = index.get(key);
+        if (descriptor === undefined)
+            throw new Error(`[user-settings] unknown_key: ${key}`);
+        const parsed = descriptor.schema.safeParse(value);
+        if (!parsed.success)
+            throw new Error(`[user-settings] validation_failed: ${key}`);
+        const { store, storageKey } = backendFor(descriptor);
+        const current = parseCell(store.get(storageKey));
+        const nextVersion = (baseVersion ?? current?.ver ?? 0) + 1;
+        const cell = { v: parsed.data, ver: nextVersion, t: clock() };
+        store.set(storageKey, JSON.stringify(cell));
+        return { value: parsed.data, version: nextVersion, updatedAt: cell.t };
+    }
+    async function all() {
+        const out = {};
+        for (const descriptor of descriptors) {
+            const record = await get(descriptor.key);
+            if (record !== null)
+                out[descriptor.key] = record;
+        }
+        return out;
+    }
+    async function clear(key) {
+        const targets = key !== undefined ? [index.get(key)].filter(Boolean) : descriptors;
+        for (const descriptor of targets) {
+            const { store, storageKey } = backendFor(descriptor);
+            store.remove(storageKey);
+        }
+    }
+    return { get, set, all, clear };
+}
+/** De geauthenticeerde server-adapter: de getypte client over GET/PUT /settings. */
+export function createServerAdapter(options) {
+    const { client, descriptors } = options;
+    const index = indexDescriptors(descriptors);
+    async function all() {
+        const res = await client.getSettings();
+        const out = {};
+        for (const [key, record] of Object.entries(res.settings)) {
+            out[key] = {
+                value: record.value,
+                version: record.version,
+                updatedAt: record.updatedAt,
+                ...(record.deleted ? { deleted: true } : {}),
+            };
+        }
+        return out;
+    }
+    async function get(key) {
+        const map = await all();
+        return map[key] ?? null;
+    }
+    async function set(key, value, baseVersion) {
+        return client.putSetting(key, { value, ...(baseVersion !== undefined ? { baseVersion } : {}) });
+    }
+    async function clear(key) {
+        // Geen DELETE-endpoint in v0.1: 'clear' reset naar de descriptor-default (tombstone-kolom is voor
+        // merge-semantiek + een toekomstig DELETE-endpoint gereserveerd).
+        const targets = key !== undefined ? [index.get(key)].filter(Boolean) : descriptors;
+        for (const descriptor of targets) {
+            await client.putSetting(descriptor.key, { value: descriptor.default });
+        }
+    }
+    return { get, set, all, clear };
+}
+//# sourceMappingURL=store.js.map

package/dist/frontend/src/store.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"store.js","sourceRoot":"","sources":["../../../frontend/src/store.ts"],"names":[],"mappings":"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"}

package/dist/frontend/src/useSettings.d.ts ADDED Viewed

@@ -0,0 +1,46 @@
+/**
+ * De `useSettings()`-seam (het mechanisme, provide/inject). Eén reactieve keyed store die de UI leest/schrijft,
+ * transparant achter de actieve adapter (client óf server). De host kiest de adapter op runtime via `bind`;
+ * bij login voegt `syncOnLogin` de anonieme client-map per-key samen in de server-store en herpunt de seam —
+ * render-keys blijven cookie-gespiegeld zodat SSR post-login blijft werken. Geen module-globale mutable state:
+ * de API wordt per app-instance geprovide.
+ */
+import { type App, type InjectionKey, type Ref, type WritableComputedRef } from 'vue';
+import type { MergeResponse, SettingsSchema } from '../../contract/index.js';
+import type { UserSettingsClient } from './client.js';
+import type { SettingsStore } from './store.js';
+export interface UserSettingsApi {
+    /** Huidige (reactieve) waarde van een key; valt terug op de descriptor-`default`. */
+    get<T = unknown>(key: string): T;
+    /** Schrijf een key via de actieve adapter en werk de reactieve state bij. */
+    set(key: string, value: unknown): Promise<void>;
+    /** Snapshot van alle huidige waarden (met defaults ingevuld). */
+    all(): Record<string, unknown>;
+    /** Wis één key (of alles) via de actieve adapter; state valt terug op defaults. */
+    clear(key?: string): Promise<void>;
+    /** Laad een adapter in de reactieve state en maak hem de actieve. */
+    bind(adapter: SettingsStore): Promise<void>;
+    /** Guest→login: merge de anonieme map in de server-store, herpunt naar de server-adapter. */
+    syncOnLogin(options: SyncOnLoginOptions): Promise<MergeResponse | undefined>;
+    readonly ready: Ref<boolean>;
+}
+export interface SyncOnLoginOptions {
+    readonly from: SettingsStore;
+    readonly to: SettingsStore;
+    readonly client: UserSettingsClient;
+    /** Idempotentie-token: een retry na een verloren response is een no-op (geen replay-storm). */
+    readonly opId: string;
+    /** Render-keys blijven na de merge op de cookie staan (niet lokaal gewist). */
+    readonly renderKeys?: readonly string[];
+}
+export interface CreateUserSettingsOptions {
+    readonly descriptors: SettingsSchema;
+    readonly initialAdapter: SettingsStore;
+}
+export declare function createUserSettings(options: CreateUserSettingsOptions): UserSettingsApi;
+export declare const USER_SETTINGS_KEY: InjectionKey<UserSettingsApi>;
+export declare function provideUserSettings(app: App, api: UserSettingsApi): void;
+export declare function useSettings(): UserSettingsApi;
+/** Reactieve twee-weg-binding voor één key: lezen geeft de huidige waarde, schrijven upsert via de adapter. */
+export declare function useSetting<T = unknown>(key: string): WritableComputedRef<T>;
+//# sourceMappingURL=useSettings.d.ts.map

package/dist/frontend/src/useSettings.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"useSettings.d.ts","sourceRoot":"","sources":["../../../frontend/src/useSettings.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAmC,KAAK,GAAG,EAAE,KAAK,YAAY,EAAE,KAAK,GAAG,EAAE,KAAK,mBAAmB,EAAE,MAAM,KAAK,CAAC;AACvH,OAAO,KAAK,EAAc,aAAa,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,qFAAqF;IACrF,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC;IACjC,6EAA6E;IAC7E,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,iEAAiE;IACjE,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,mFAAmF;IACnF,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,qEAAqE;IACrE,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,6FAA6F;IAC7F,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;IAC7E,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,+FAA+F;IAC/F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC;CACxC;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,eAAe,CAuEtF;AAED,eAAO,MAAM,iBAAiB,EAAE,YAAY,CAAC,eAAe,CAA+B,CAAC;AAE5F,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,eAAe,GAAG,IAAI,CAExE;AAED,wBAAgB,WAAW,IAAI,eAAe,CAM7C;AAED,+GAA+G;AAC/G,wBAAgB,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAQ3E"}

package/dist/frontend/src/useSettings.js ADDED Viewed

@@ -0,0 +1,100 @@
+/**
+ * De `useSettings()`-seam (het mechanisme, provide/inject). Eén reactieve keyed store die de UI leest/schrijft,
+ * transparant achter de actieve adapter (client óf server). De host kiest de adapter op runtime via `bind`;
+ * bij login voegt `syncOnLogin` de anonieme client-map per-key samen in de server-store en herpunt de seam —
+ * render-keys blijven cookie-gespiegeld zodat SSR post-login blijft werken. Geen module-globale mutable state:
+ * de API wordt per app-instance geprovide.
+ */
+import { computed, inject, reactive, ref } from 'vue';
+import { indexDescriptors } from './descriptors.js';
+export function createUserSettings(options) {
+    const { descriptors, initialAdapter } = options;
+    const index = indexDescriptors(descriptors);
+    const state = reactive({});
+    const ready = ref(false);
+    let active = initialAdapter;
+    function resetToDefaults() {
+        for (const descriptor of descriptors)
+            state[descriptor.key] = descriptor.default;
+    }
+    resetToDefaults();
+    async function bind(adapter) {
+        active = adapter;
+        resetToDefaults();
+        const map = await adapter.all();
+        for (const [key, record] of Object.entries(map)) {
+            if (record.deleted !== true)
+                state[key] = record.value;
+        }
+        ready.value = true;
+    }
+    function get(key) {
+        if (key in state)
+            return state[key];
+        return index.get(key)?.default ?? undefined;
+    }
+    async function set(key, value) {
+        const record = await active.set(key, value);
+        state[key] = record.value;
+    }
+    function all() {
+        return { ...state };
+    }
+    async function clear(key) {
+        await active.clear(key);
+        if (key !== undefined) {
+            const descriptor = index.get(key);
+            if (descriptor !== undefined)
+                state[key] = descriptor.default;
+        }
+        else {
+            resetToDefaults();
+        }
+    }
+    async function syncOnLogin(opts) {
+        const anonymous = await opts.from.all();
+        const entries = {};
+        for (const [key, record] of Object.entries(anonymous)) {
+            entries[key] = {
+                value: record.value,
+                version: record.version,
+                updatedAt: record.updatedAt,
+                ...(record.deleted ? { deleted: true } : {}),
+            };
+        }
+        const result = await opts.client.mergeSettings({ opId: opts.opId, entries });
+        await bind(opts.to);
+        // Wis de lokale kopie, behalve de render-keys (die blijven cookie-gespiegeld voor SSR).
+        const renderSet = new Set(opts.renderKeys ?? []);
+        for (const key of Object.keys(anonymous)) {
+            const descriptor = index.get(key);
+            const isRender = descriptor?.namespace === 'render' || descriptor?.cookie === true || renderSet.has(key);
+            if (!isRender)
+                await opts.from.clear(key);
+        }
+        return result;
+    }
+    return { get, set, all, clear, bind, syncOnLogin, ready };
+}
+export const USER_SETTINGS_KEY = Symbol('user-settings.api');
+export function provideUserSettings(app, api) {
+    app.provide(USER_SETTINGS_KEY, api);
+}
+export function useSettings() {
+    const api = inject(USER_SETTINGS_KEY);
+    if (api === undefined) {
+        throw new Error('[user-settings] useSettings(): geen API geprovide. Roep provideUserSettings(app, api) aan bij bootstrap.');
+    }
+    return api;
+}
+/** Reactieve twee-weg-binding voor één key: lezen geeft de huidige waarde, schrijven upsert via de adapter. */
+export function useSetting(key) {
+    const api = useSettings();
+    return computed({
+        get: () => api.get(key),
+        set: (value) => {
+            void api.set(key, value);
+        },
+    });
+}
+//# sourceMappingURL=useSettings.js.map

package/dist/frontend/src/useSettings.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"useSettings.js","sourceRoot":"","sources":["../../../frontend/src/useSettings.ts"],"names":[],"mappings":"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"}

package/dist/manifest.d.ts ADDED Viewed

@@ -0,0 +1,59 @@
+/**
+ * user-settings — de capability-MANIFEST.
+ *
+ * De machine-leesbare descriptor die de scaffolder leest om de module te assembleren, te wiren en te
+ * upgraden. Componeert kits (persistence/http-kernel/config/i18n backend; app-kernel/data/http-client/i18n
+ * frontend) en heeft GEEN `requires.modules` — de eerste module met een backend-slice die volledig
+ * kit-only is (ontkoppeld van account; consent wordt gelinkt, niet als harde module-dep). `backendRoutes`
+ * wordt uit de endpoint-catalogus afgeleid zodat manifest en contract niet kunnen driften.
+ *
+ * Het interface + de validator komen uit de gedeelde spec `@seifer-webapp-factory/capability-spec` (de
+ * enige bron) en worden hier her-geëxporteerd zodat imports vanuit deze module blijven werken. Bevat GEEN
+ * mechanisme: puur declaratief.
+ */
+import { validateManifest } from '@seifer-webapp-factory/capability-spec';
+import type { CapabilityModuleManifest } from '@seifer-webapp-factory/capability-spec';
+export { validateManifest };
+export type { CapabilityModuleManifest };
+/** De concrete manifest van de user-settings-module. */
+export declare const userSettingsManifest: {
+    name: string;
+    version: string;
+    templateVersion: string;
+    provides: {
+        routes: string[];
+        backendRoutes: readonly string[];
+        capabilities: string[];
+    };
+    requires: {
+        kits: {
+            backend: string[];
+            frontend: string[];
+        };
+        ports: string[];
+    };
+    contract: string;
+    config: import("zod").ZodObject<{
+        serverSync: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        cookiePrefix: import("zod").ZodDefault<import("zod").ZodString>;
+        renderKeys: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString, "many">>;
+        cookieMaxAgeDays: import("zod").ZodDefault<import("zod").ZodNumber>;
+        onboardingScope: import("zod").ZodDefault<import("zod").ZodEnum<["server", "device"]>>;
+    }, "strip", import("zod").ZodTypeAny, {
+        serverSync: boolean;
+        cookiePrefix: string;
+        renderKeys: string[];
+        cookieMaxAgeDays: number;
+        onboardingScope: "server" | "device";
+    }, {
+        serverSync?: boolean | undefined;
+        cookiePrefix?: string | undefined;
+        renderKeys?: string[] | undefined;
+        cookieMaxAgeDays?: number | undefined;
+        onboardingScope?: "server" | "device" | undefined;
+    }>;
+    migrations: string[];
+    surface: string[];
+    mechanism: string[];
+};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAGvF,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC5B,YAAY,EAAE,wBAAwB,EAAE,CAAC;AAKzC,wDAAwD;AACxD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwBG,CAAC"}

package/dist/manifest.js ADDED Viewed

@@ -0,0 +1,45 @@
+/**
+ * user-settings — de capability-MANIFEST.
+ *
+ * De machine-leesbare descriptor die de scaffolder leest om de module te assembleren, te wiren en te
+ * upgraden. Componeert kits (persistence/http-kernel/config/i18n backend; app-kernel/data/http-client/i18n
+ * frontend) en heeft GEEN `requires.modules` — de eerste module met een backend-slice die volledig
+ * kit-only is (ontkoppeld van account; consent wordt gelinkt, niet als harde module-dep). `backendRoutes`
+ * wordt uit de endpoint-catalogus afgeleid zodat manifest en contract niet kunnen driften.
+ *
+ * Het interface + de validator komen uit de gedeelde spec `@seifer-webapp-factory/capability-spec` (de
+ * enige bron) en worden hier her-geëxporteerd zodat imports vanuit deze module blijven werken. Bevat GEEN
+ * mechanisme: puur declaratief.
+ */
+import { validateManifest } from '@seifer-webapp-factory/capability-spec';
+import { USER_SETTINGS_ENDPOINTS, userSettingsConfigSchema } from './contract/index.js';
+export { validateManifest };
+/** Backend-routes afgeleid uit de endpoint-catalogus (gededupliceerd op pad). */
+const backendRoutes = [...new Set(Object.values(USER_SETTINGS_ENDPOINTS).map((ep) => ep.path))];
+/** De concrete manifest van de user-settings-module. */
+export const userSettingsManifest = {
+    name: 'user-settings',
+    version: '0.1.0',
+    templateVersion: '0.1.0',
+    provides: {
+        // De optionele referentie-pagina; een host mag hem remappen of weglaten (headless-first).
+        routes: ['/settings'],
+        backendRoutes,
+        capabilities: ['settings.preferences', 'settings.render', 'settings.sync'],
+    },
+    requires: {
+        kits: {
+            // backend-kits alleen relevant wanneer de server-adapter draait (serverSync).
+            backend: ['persistence', 'http-kernel', 'config', 'i18n'],
+            frontend: ['app-kernel', 'data', 'http-client', 'i18n'],
+        },
+        ports: ['SettingsStore', 'SubjectProvider', 'Database', 'DesignSystem'],
+        // geen `modules`: componeert kits, ontkoppeld van account.
+    },
+    contract: './contract/index.ts',
+    config: userSettingsConfigSchema,
+    migrations: ['user_settings'],
+    surface: ['backend/templates/**', 'frontend/templates/**'],
+    mechanism: ['backend/src/**', 'frontend/src/**', 'contract/**'],
+};
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"manifest.js","sourceRoot":"","sources":["../manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAE1E,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAExF,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAG5B,iFAAiF;AACjF,MAAM,aAAa,GAAsB,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEnH,wDAAwD;AACxD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,eAAe;IACrB,OAAO,EAAE,OAAO;IAChB,eAAe,EAAE,OAAO;IACxB,QAAQ,EAAE;QACR,0FAA0F;QAC1F,MAAM,EAAE,CAAC,WAAW,CAAC;QACrB,aAAa;QACb,YAAY,EAAE,CAAC,sBAAsB,EAAE,iBAAiB,EAAE,eAAe,CAAC;KAC3E;IACD,QAAQ,EAAE;QACR,IAAI,EAAE;YACJ,8EAA8E;YAC9E,OAAO,EAAE,CAAC,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,CAAC;YACzD,QAAQ,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC;SACxD;QACD,KAAK,EAAE,CAAC,eAAe,EAAE,iBAAiB,EAAE,UAAU,EAAE,cAAc,CAAC;QACvE,2DAA2D;KAC5D;IACD,QAAQ,EAAE,qBAAqB;IAC/B,MAAM,EAAE,wBAAwB;IAChC,UAAU,EAAE,CAAC,eAAe,CAAC;IAC7B,OAAO,EAAE,CAAC,sBAAsB,EAAE,uBAAuB,CAAC;IAC1D,SAAS,EAAE,CAAC,gBAAgB,EAAE,iBAAiB,EAAE,aAAa,CAAC;CAC7B,CAAC"}

package/dist/scaffolder/core/errors.d.ts ADDED Viewed

@@ -0,0 +1,24 @@
+/**
+ * Fouttypes voor de user-settings-scaffolder. Draag altijd genoeg context voor een expliciete melding
+ * (paden, poorten, modules), maar NOOIT invoerwaarden of secrets. Deterministisch: geen timestamps/random.
+ */
+/** Geworpen wanneer te materialiseren surface-bestanden al bestaan en `overwrite` niet gezet is. */
+export declare class UserSettingsMaterializationConflictError extends Error {
+    readonly paths: readonly string[];
+    constructor(paths: readonly string[]);
+}
+/** Geworpen wanneer het project een door het manifest vereiste requires-port niet levert. */
+export declare class MissingRequiredPortError extends Error {
+    readonly missing: readonly string[];
+    constructor(missing: readonly string[]);
+}
+/**
+ * Geworpen door `checkRequiredModules` wanneer een vereiste capability-module niet aanwezig is.
+ * user-settings heeft GEEN `requires.modules` (kit-only), dus dit vuurt bij deze module in de praktijk niet
+ * — het blijft aanwezig voor pariteit met de siblings en voor het geval een host de check toch aanroept.
+ */
+export declare class MissingRequiredModuleError extends Error {
+    readonly missing: readonly string[];
+    constructor(missing: readonly string[]);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/scaffolder/core/errors.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../scaffolder/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oGAAoG;AACpG,qBAAa,wCAAyC,SAAQ,KAAK;IACjE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;gBACtB,KAAK,EAAE,SAAS,MAAM,EAAE;CAQrC;AAED,6FAA6F;AAC7F,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;gBACxB,OAAO,EAAE,SAAS,MAAM,EAAE;CAKvC;AAED;;;;GAIG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;gBACxB,OAAO,EAAE,SAAS,MAAM,EAAE;CAQvC"}