rlz-engine 1.0.54 → 1.0.55

package/dist/back/logger/cli.js

@@ -0,0 +1,43 @@
+import { number, oneOf, option, optional, string } from 'cmd-ts';
+import { resolve } from 'node:path';
+import { formatAuditRecord } from './format.js';
+import { readAuditLogFile } from './sqlite-storage.js';
+const levels = ['fatal', 'error', 'warn', 'info', 'debug', 'trace'];
+export function makeAuditLogCliModule(workingDirectory = () => process.cwd()) {
+    return {
+        name: 'logger',
+        description: 'Read and inspect persisted audit logs.',
+        commands: {
+            logs: {
+                description: 'Read audit records from a SQLite database with optional filters.',
+                args: {
+                    database: option({
+                        long: 'database',
+                        type: string,
+                        defaultValue: () => 'logs.sqlite',
+                        description: 'SQLite database path, relative to the application working directory.'
+                    }),
+                    from: option({ long: 'from', type: optional(string), description: 'Include records at or after this ISO timestamp.' }),
+                    to: option({ long: 'to', type: optional(string), description: 'Include records at or before this ISO timestamp.' }),
+                    module: option({ long: 'module', type: optional(string), description: 'Only include this logger module.' }),
+                    level: option({ long: 'level', type: optional(oneOf(levels)), description: 'Only include this log level.' }),
+                    limit: option({ long: 'limit', type: optional(number), description: 'Maximum records to return, from 1 to 1000.' }),
+                    offset: option({ long: 'offset', type: optional(number), description: 'Number of matching records to skip.' })
+                },
+                handler: async ({ database, from, to, module, level, limit, offset }) => {
+                    const directory = typeof workingDirectory === 'function' ? workingDirectory() : workingDirectory;
+                    const page = readAuditLogFile(resolve(directory, database), {
+                        ...(from === undefined ? {} : { from }),
+                        ...(to === undefined ? {} : { to }),
+                        ...(module === undefined ? {} : { module }),
+                        ...(level === undefined ? {} : { level }),
+                        limit: limit ?? 100,
+                        offset: offset ?? 0
+                    });
+                    process.stdout.write(page.records.map((record) => formatAuditRecord(record)).join(''));
+                }
+            }
+        }
+    };
+}
+//# sourceMappingURL=cli.js.map

package/dist/back/logger/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/back/logger/cli.ts"],"names":[],"mappings":"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"}

package/dist/back/logger/format.d.ts

@@ -0,0 +1,3 @@
+import type { AuditRecord } from './audit-logger.js';
+/** Formats an audit record for both the live console sink and the log-reading CLI. */
+export declare function formatAuditRecord(record: AuditRecord, color?: boolean): string;

package/dist/back/logger/format.js

@@ -0,0 +1,27 @@
+import { inspect } from 'node:util';
+const LEVEL_COLORS = {
+    fatal: '\u001b[35m',
+    error: '\u001b[31m',
+    warn: '\u001b[33m',
+    info: '\u001b[32m',
+    debug: '\u001b[36m',
+    trace: '\u001b[90m'
+};
+/** Formats an audit record for both the live console sink and the log-reading CLI. */
+export function formatAuditRecord(record, color = true) {
+    const prefix = `${record.time} ${record.level.toUpperCase()} [${record.module}]`;
+    const formattedPrefix = color ? `${LEVEL_COLORS[record.level]}${prefix}\u001b[0m` : prefix;
+    const details = record.data === undefined
+        ? ''
+        : Object.entries(record.data)
+            .map(([key, value]) => {
+            const formattedValue = inspect(value, { colors: color, compact: true, depth: 1, breakLength: Infinity });
+            return `\n    ${key}: ${formattedValue.replaceAll('\n', '\n    ')}`;
+        })
+            .join('');
+    const error = record.error === undefined
+        ? ''
+        : `\n    error: ${(record.error.stack ?? `${record.error.name}: ${record.error.message}`).replaceAll('\n', '\n    ')}`;
+    return `${formattedPrefix} ${record.type}${details}${error}\n`;
+}
+//# sourceMappingURL=format.js.map

package/dist/back/logger/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/back/logger/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAInC,MAAM,YAAY,GAA6B;IAC3C,KAAK,EAAE,YAAY;IACnB,KAAK,EAAE,YAAY;IACnB,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,YAAY;IAClB,KAAK,EAAE,YAAY;IACnB,KAAK,EAAE,YAAY;CACtB,CAAA;AAED,sFAAsF;AACtF,MAAM,UAAU,iBAAiB,CAAC,MAAmB,EAAE,KAAK,GAAG,IAAI;IAC/D,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,MAAM,GAAG,CAAA;IAChF,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,WAAW,CAAC,CAAC,CAAC,MAAM,CAAA;IAC1F,MAAM,OAAO,GACT,MAAM,CAAC,IAAI,KAAK,SAAS;QACrB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;aACtB,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YAClB,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAA;YACxG,OAAO,SAAS,GAAG,KAAK,cAAc,CAAC,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAA;QACvE,CAAC,CAAC;aACD,IAAI,CAAC,EAAE,CAAC,CAAA;IACvB,MAAM,KAAK,GACP,MAAM,CAAC,KAAK,KAAK,SAAS;QACtB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAA;IAE9H,OAAO,GAAG,eAAe,IAAI,MAAM,CAAC,IAAI,GAAG,OAAO,GAAG,KAAK,IAAI,CAAA;AAClE,CAAC"}

package/dist/back/logger/module.d.ts

@@ -0,0 +1,14 @@
+import { makeAuditLogAdmRpc } from './adm-rpc.js';
+import { makeAuditLogCliModule } from './cli.js';
+import type { AdmModule } from '../../client/adm/admin.js';
+declare function makeAdm(): AdmModule;
+/** Audit logging integrations. Each factory is optional to consumers. */
+export declare const LOGGER_MODULE: {
+    /** Create the SQLite audit-log reader command. */
+    makeCli: typeof makeAuditLogCliModule;
+    /** Create the admin-secret-protected audit-log query endpoint. */
+    makeAdmRpc: typeof makeAuditLogAdmRpc;
+    /** Create the audit-log administration section. */
+    makeAdm: typeof makeAdm;
+};
+export {};

package/dist/back/logger/module.js

@@ -0,0 +1,24 @@
+import { makeAuditLogAdmRpc } from './adm-rpc.js';
+import { makeAuditLogCliModule } from './cli.js';
+import { AuditLogs } from '../../client/adm/audit-logs.js';
+import { admRpcCall } from '../../client/rpc.js';
+function makeAdm() {
+    return {
+        name: 'audit',
+        title: 'Audit log',
+        component: AuditLogs,
+        verify: async (auth) => {
+            await admRpcCall(auth, 'audit', 'logs', 1, { limit: 1, offset: 0 });
+        }
+    };
+}
+/** Audit logging integrations. Each factory is optional to consumers. */
+export const LOGGER_MODULE = {
+    /** Create the SQLite audit-log reader command. */
+    makeCli: makeAuditLogCliModule,
+    /** Create the admin-secret-protected audit-log query endpoint. */
+    makeAdmRpc: makeAuditLogAdmRpc,
+    /** Create the audit-log administration section. */
+    makeAdm
+};
+//# sourceMappingURL=module.js.map

package/dist/back/logger/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../src/back/logger/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAGhD,SAAS,OAAO;IACZ,OAAO;QACH,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,WAAW;QAClB,SAAS,EAAE,SAAS;QACpB,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACnB,MAAM,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAA;QACvE,CAAC;KACJ,CAAA;AACL,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,MAAM,aAAa,GAAG;IACzB,kDAAkD;IAClD,OAAO,EAAE,qBAAqB;IAC9B,kEAAkE;IAClE,UAAU,EAAE,kBAAkB;IAC9B,mDAAmD;IACnD,OAAO;CACV,CAAA"}

package/dist/back/logger/sqlite-storage.d.ts

@@ -0,0 +1,27 @@
+import type { AuditLogPage, AuditLogQuery, AuditRecord } from './audit-logger.js';
+export interface SqliteAuditStorageOptions {
+    path: string;
+    retentionMs: number;
+    maxRecords: number;
+    cleanupIntervalMs?: number;
+    onError?: (error: unknown) => void;
+}
+/** Synchronous SQLite writer for the single-process application deployment model. */
+export declare class SqliteAuditStorage {
+    private readonly options;
+    private readonly db;
+    private readonly insertRecord;
+    private readonly deleteExpired;
+    private readonly countRecords;
+    private readonly deleteOldest;
+    private readonly timer;
+    private readonly onError;
+    constructor(options: SqliteAuditStorageOptions);
+    write(record: AuditRecord): void;
+    read(query: AuditLogQuery): AuditLogPage;
+    close(): void;
+    private cleanupSafely;
+    private cleanup;
+}
+/** Reads an existing audit database without creating, pruning, or modifying it. */
+export declare function readAuditLogFile(path: string, query: AuditLogQuery): AuditLogPage;

package/dist/back/logger/sqlite-storage.js

@@ -0,0 +1,169 @@
+import { chmodSync, closeSync, openSync } from 'node:fs';
+import { DatabaseSync } from 'node:sqlite';
+const CLEANUP_MARGIN_MAX = 1000;
+/** Synchronous SQLite writer for the single-process application deployment model. */
+export class SqliteAuditStorage {
+    options;
+    db;
+    insertRecord;
+    deleteExpired;
+    countRecords;
+    deleteOldest;
+    timer;
+    onError;
+    constructor(options) {
+        this.options = options;
+        if (!Number.isFinite(options.retentionMs) || options.retentionMs <= 0) {
+            throw new RangeError('Audit retention must be a positive finite number of milliseconds');
+        }
+        if (!Number.isSafeInteger(options.maxRecords) || options.maxRecords < 1) {
+            throw new RangeError('Audit maximum record count must be a positive safe integer');
+        }
+        this.onError = options.onError ?? reportStorageError;
+        const fd = openSync(options.path, 'a', 0o600);
+        closeSync(fd);
+        chmodSync(options.path, 0o600);
+        this.db = new DatabaseSync(options.path);
+        try {
+            this.db.exec('PRAGMA busy_timeout = 5000; PRAGMA journal_mode = WAL;');
+            this.db.exec(`
+                CREATE TABLE IF NOT EXISTS audit_logs (
+                    id INTEGER PRIMARY KEY AUTOINCREMENT,
+                    time TEXT NOT NULL,
+                    level TEXT NOT NULL,
+                    module TEXT NOT NULL,
+                    type TEXT NOT NULL,
+                    data TEXT,
+                    error TEXT
+                ) STRICT;
+                CREATE INDEX IF NOT EXISTS audit_logs_time_id ON audit_logs (time, id);
+                CREATE INDEX IF NOT EXISTS audit_logs_module_time_id ON audit_logs (module, time, id);
+                CREATE INDEX IF NOT EXISTS audit_logs_level_time_id ON audit_logs (level, time, id);
+                CREATE INDEX IF NOT EXISTS audit_logs_module_level_time_id ON audit_logs (module, level, time, id);
+            `);
+            this.insertRecord = this.db.prepare(`
+                INSERT INTO audit_logs (time, level, module, type, data, error)
+                VALUES (?, ?, ?, ?, ?, ?)
+            `);
+            this.deleteExpired = this.db.prepare('DELETE FROM audit_logs WHERE time < ?');
+            this.countRecords = this.db.prepare('SELECT COUNT(*) AS count FROM audit_logs');
+            this.deleteOldest = this.db.prepare(`
+                DELETE FROM audit_logs WHERE id IN (
+                    SELECT id FROM audit_logs ORDER BY time ASC, id ASC LIMIT ?
+                )
+            `);
+            this.cleanup();
+            this.timer = setInterval(() => this.cleanupSafely(), options.cleanupIntervalMs ?? 60 * 60 * 1000);
+            this.timer.unref();
+        }
+        catch (error) {
+            this.db.close();
+            throw error;
+        }
+    }
+    write(record) {
+        this.insertRecord.run(record.time, record.level, record.module, record.type, record.data === undefined ? null : JSON.stringify(record.data), record.error === undefined ? null : JSON.stringify(record.error));
+    }
+    read(query) {
+        return readAuditLogDatabase(this.db, query);
+    }
+    close() {
+        clearInterval(this.timer);
+        this.db.close();
+    }
+    cleanupSafely() {
+        try {
+            this.cleanup();
+        }
+        catch (error) {
+            this.onError(error);
+        }
+    }
+    cleanup() {
+        const cutoff = new Date(Date.now() - this.options.retentionMs).toISOString();
+        this.deleteExpired.run(cutoff);
+        const countRow = this.countRecords.get();
+        if (countRow.count <= this.options.maxRecords)
+            return;
+        const margin = Math.min(CLEANUP_MARGIN_MAX, Math.max(1, Math.floor(this.options.maxRecords * 0.01)), this.options.maxRecords - 1);
+        const targetCount = Math.max(0, this.options.maxRecords - margin);
+        this.deleteOldest.run(countRow.count - targetCount);
+    }
+}
+/** Reads an existing audit database without creating, pruning, or modifying it. */
+export function readAuditLogFile(path, query) {
+    const db = new DatabaseSync(path, { readOnly: true });
+    try {
+        return readAuditLogDatabase(db, query);
+    }
+    finally {
+        db.close();
+    }
+}
+function readAuditLogDatabase(db, query) {
+    validatePage(query);
+    const from = query.from === undefined ? undefined : normalizeTime(query.from, 'from');
+    const to = query.to === undefined ? undefined : normalizeTime(query.to, 'to');
+    if (from !== undefined && to !== undefined && from > to) {
+        throw new RangeError('Audit query from must not be later than to');
+    }
+    const conditions = [];
+    const values = [];
+    if (from !== undefined) {
+        conditions.push('time >= ?');
+        values.push(from);
+    }
+    if (to !== undefined) {
+        conditions.push('time <= ?');
+        values.push(to);
+    }
+    if (query.module !== undefined) {
+        conditions.push('module = ?');
+        values.push(query.module);
+    }
+    if (query.level !== undefined) {
+        conditions.push('level = ?');
+        values.push(query.level);
+    }
+    const where = conditions.length === 0 ? '' : `WHERE ${conditions.join(' AND ')}`;
+    const count = db.prepare(`SELECT COUNT(*) AS count FROM audit_logs ${where}`).get(...values);
+    const rows = db
+        .prepare(`
+            SELECT id, time, level, module, type, data, error
+            FROM audit_logs ${where}
+            ORDER BY time DESC, id DESC
+            LIMIT ? OFFSET ?
+        `)
+        .all(...values, query.limit, query.offset);
+    return { records: rows.map(toAuditLogEntry), total: count.count };
+}
+function toAuditLogEntry(row) {
+    return {
+        id: row.id,
+        time: row.time,
+        level: row.level,
+        module: row.module,
+        type: row.type,
+        ...(row.data === null ? {} : { data: JSON.parse(row.data) }),
+        ...(row.error === null ? {} : { error: JSON.parse(row.error) })
+    };
+}
+function validatePage(query) {
+    if (!Number.isSafeInteger(query.limit) || query.limit < 1 || query.limit > 1000) {
+        throw new RangeError('Audit page limit must be an integer between 1 and 1000');
+    }
+    if (!Number.isSafeInteger(query.offset) || query.offset < 0) {
+        throw new RangeError('Audit page offset must be a non-negative safe integer');
+    }
+}
+function normalizeTime(value, field) {
+    const date = new Date(value);
+    if (!Number.isFinite(date.getTime()))
+        throw new RangeError(`Audit query ${field} must be a valid date`);
+    return date.toISOString();
+}
+function reportStorageError(error) {
+    const message = error instanceof Error ? `${error.name}: ${error.message}` : String(error);
+    process.stderr.write(`AuditLogger SQLite maintenance error: ${message.replaceAll(/\s*\n\s*/g, ' | ')}\n`);
+}
+//# sourceMappingURL=sqlite-storage.js.map

package/dist/back/logger/sqlite-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-storage.js","sourceRoot":"","sources":["../../../src/back/logger/sqlite-storage.ts"],"names":[],"mappings":"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"}

package/dist/back/logger/system-logger.d.ts

@@ -0,0 +1,27 @@
+import type { FastifyBaseLogger, FastifyLogFn } from 'fastify';
+type Bindings = Parameters<FastifyBaseLogger['child']>[0];
+type ChildLoggerOptions = Parameters<FastifyBaseLogger['child']>[1];
+export interface SystemLoggerConfig {
+    debug?: boolean;
+}
+/** Pino-compatible adapter for Fastify; application modules should use getAuditLogger directly. */
+export declare class SystemLogger implements FastifyBaseLogger {
+    private readonly name;
+    private readonly bindingsValue;
+    private readonly threshold;
+    private readonly audit;
+    readonly level: string;
+    constructor(name?: string, { debug }?: SystemLoggerConfig, bindings?: Bindings);
+    fatal: FastifyLogFn;
+    error: FastifyLogFn;
+    warn: FastifyLogFn;
+    info: FastifyLogFn;
+    debug: FastifyLogFn;
+    trace: FastifyLogFn;
+    silent: FastifyLogFn;
+    child(bindings: Bindings, _options?: ChildLoggerOptions): FastifyBaseLogger;
+    private makeLog;
+    private log;
+}
+export declare function getSystemLogger(name: string, config?: SystemLoggerConfig): SystemLogger;
+export {};

package/dist/back/logger/system-logger.js

@@ -0,0 +1,82 @@
+import { PRODUCTION } from '../config.js';
+import { getAuditLogger } from './audit-logger.js';
+const LEVELS = { fatal: 60, error: 50, warn: 40, info: 30, debug: 20, trace: 10 };
+/** Pino-compatible adapter for Fastify; application modules should use getAuditLogger directly. */
+export class SystemLogger {
+    name;
+    bindingsValue;
+    threshold;
+    audit = getAuditLogger('SYSTEM');
+    level;
+    constructor(name = 'SYSTEM', { debug = false } = {}, bindings = {}) {
+        this.name = name;
+        this.bindingsValue = bindings;
+        this.threshold = debug ? (PRODUCTION ? 'debug' : 'trace') : 'info';
+        this.level = this.threshold;
+    }
+    fatal = this.makeLog('fatal');
+    error = this.makeLog('error');
+    warn = this.makeLog('warn');
+    info = this.makeLog('info');
+    debug = this.makeLog('debug');
+    trace = this.makeLog('trace');
+    silent = (() => undefined);
+    child(bindings, _options) {
+        return new SystemLogger(this.name, { debug: this.threshold !== 'info' }, { ...this.bindingsValue, ...bindings });
+    }
+    makeLog(level) {
+        return ((obj, msg, ...args) => this.log(level, obj, msg, args));
+    }
+    log(level, obj, msg, args = []) {
+        if (LEVELS[level] < LEVELS[this.threshold])
+            return;
+        const { message, data, error } = normalizeLog(obj, msg, args, this.bindingsValue);
+        this.audit.write(level, { ...(data ?? {}), type: message, logger: this.name }, error);
+        if (PRODUCTION) {
+            const fields = data === undefined ? '' : ` ${formatFields(data)}`;
+            const stack = error?.stack?.replaceAll(/\s*\n\s*/g, ' | ');
+            const errorText = error === undefined ? '' : ` ${error.name}: ${error.message}${stack ? ` ${stack}` : ''}`;
+            const singleLineMessage = message.replaceAll(/\s*[\r\n]+\s*/g, ' | ');
+            process.stdout.write(`${new Date().toISOString()} ${level.toUpperCase()} [${this.name}] ${singleLineMessage}${fields}${errorText}\n`);
+        }
+    }
+}
+export function getSystemLogger(name, config) {
+    return new SystemLogger(name, config);
+}
+function normalizeLog(obj, msg, args, bindings) {
+    const values = [obj, ...args];
+    let message = typeof obj === 'string' ? obj : typeof msg === 'string' ? msg : '';
+    if (typeof obj === 'string' && typeof msg === 'string')
+        message = msg;
+    const data = { ...bindings };
+    let error;
+    for (const value of values) {
+        if (value instanceof Error)
+            error = value;
+        else if (isRecord(value))
+            Object.assign(data, value);
+    }
+    if (typeof obj !== 'string' && typeof msg === 'string')
+        message = msg;
+    if (!message)
+        message = error?.message ?? 'Log record';
+    return { message, ...(Object.keys(data).length ? { data: jsonSafe(data) } : {}), ...(error ? { error } : {}) };
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function jsonSafe(data) {
+    try {
+        return JSON.parse(JSON.stringify(data));
+    }
+    catch {
+        return { serializationError: 'Structured log data was not JSON-serializable' };
+    }
+}
+function formatFields(data) {
+    return Object.entries(data)
+        .map(([key, value]) => `${key}=${JSON.stringify(value)}`)
+        .join(' ');
+}
+//# sourceMappingURL=system-logger.js.map

package/dist/back/logger/system-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-logger.js","sourceRoot":"","sources":["../../../src/back/logger/system-logger.ts"],"names":[],"mappings":"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"}

package/dist/back/module/composer.d.ts

@@ -0,0 +1,34 @@
+import type { FastifyInstance, FastifyPluginOptions } from 'fastify';
+import { CliEngine, type CliModule, DevCliEngine } from '../cli/cli-engine.js';
+import type { AdmRpcPluginBuilder, RpcPluginBuilder } from '../rpc/rpc.js';
+import type { AdmModule } from '../../client/adm/admin.js';
+/**
+ * Runtime facets returned by feature module factories. Applications create only
+ * the facets they need, then pass those values to `composeModules`.
+ */
+export interface ModuleFacets {
+    cli?: readonly CliModule[];
+    devCli?: readonly CliModule[];
+    rpc?: readonly RpcPluginBuilder[];
+    admRpc?: readonly AdmRpcPluginBuilder[];
+    adm?: readonly AdmModule[];
+    rpcOptions?: Readonly<Record<string, FastifyPluginOptions>>;
+    admRpcOptions?: Readonly<Record<string, FastifyPluginOptions>>;
+}
+/**
+ * Combines selected feature facets into application startup operations.
+ * Factory invocation and deployment configuration remain in the application;
+ * this object only registers the resulting CLI modules and RPC plugins.
+ */
+export declare function composeModules(...facets: readonly ModuleFacets[]): {
+    /** Administration sections for the application's route at `/.adm`. */
+    adm: AdmModule[];
+    /** Register the selected operational commands with the application's CLI. */
+    registerCli(engine: CliEngine): CliEngine;
+    /** Register development-only commands with a separate CLI entry point. */
+    registerDevCli(engine: DevCliEngine): DevCliEngine;
+    /** Register user-authenticated and anonymous RPC plugins on a Fastify server. */
+    registerRpc(server: FastifyInstance): Promise<void>;
+    /** Register admin-secret-protected RPC plugins on a Fastify server. */
+    registerAdmRpc(server: FastifyInstance): Promise<void>;
+};

package/dist/back/module/composer.js

@@ -0,0 +1,57 @@
+/**
+ * Combines selected feature facets into application startup operations.
+ * Factory invocation and deployment configuration remain in the application;
+ * this object only registers the resulting CLI modules and RPC plugins.
+ */
+export function composeModules(...facets) {
+    const cliModules = facets.flatMap(({ cli = [] }) => cli);
+    const devCliModules = facets.flatMap(({ devCli = [] }) => devCli);
+    const rpcBuilders = facets.flatMap(({ rpc = [] }) => rpc);
+    const admRpcBuilders = facets.flatMap(({ admRpc = [] }) => admRpc);
+    const admModules = facets.flatMap(({ adm = [] }) => adm);
+    const rpcOptions = Object.assign({}, ...facets.map(({ rpcOptions = {} }) => rpcOptions));
+    const admRpcOptions = Object.assign({}, ...facets.map(({ admRpcOptions = {} }) => admRpcOptions));
+    assertUniqueNames(cliModules.map(({ name }) => name), 'CLI module');
+    assertUniqueNames(devCliModules.map(({ name }) => name), 'development CLI module');
+    assertUniqueNames(rpcBuilders.map(({ name }) => name), 'RPC plugin');
+    assertUniqueNames(admRpcBuilders.map(({ name }) => name), 'administrative RPC plugin');
+    assertUniqueNames(admModules.map(({ name }) => name), 'administration section');
+    return {
+        /** Administration sections for the application's route at `/.adm`. */
+        adm: admModules,
+        /** Register the selected operational commands with the application's CLI. */
+        registerCli(engine) {
+            for (const module of cliModules)
+                engine.register(module);
+            return engine;
+        },
+        /** Register development-only commands with a separate CLI entry point. */
+        registerDevCli(engine) {
+            for (const module of devCliModules)
+                engine.register(module);
+            return engine;
+        },
+        /** Register user-authenticated and anonymous RPC plugins on a Fastify server. */
+        async registerRpc(server) {
+            for (const builder of rpcBuilders) {
+                // RPC builders with no options use `never`; Fastify's register overload expects its default options type.
+                await server.register(builder.makeFastifyPlugin(), rpcOptions[builder.name]);
+            }
+        },
+        /** Register admin-secret-protected RPC plugins on a Fastify server. */
+        async registerAdmRpc(server) {
+            for (const builder of admRpcBuilders) {
+                await server.register(builder.makeFastifyPlugin(), admRpcOptions[builder.name]);
+            }
+        }
+    };
+}
+function assertUniqueNames(names, kind) {
+    const seen = new Set();
+    for (const name of names) {
+        if (seen.has(name))
+            throw new Error(`${kind} already composed: ${name}`);
+        seen.add(name);
+    }
+}
+//# sourceMappingURL=composer.js.map

package/dist/back/module/composer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer.js","sourceRoot":"","sources":["../../../src/back/module/composer.ts"],"names":[],"mappings":"AAoBA;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAG,MAA+B;IAC7D,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAA;IACxD,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,CAAA;IACjE,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAA;IACzD,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,CAAA;IAClE,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAA;IACxD,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAA;IACxF,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAA;IAEjG,iBAAiB,CACb,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,EAClC,YAAY,CACf,CAAA;IACD,iBAAiB,CACb,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,EACrC,wBAAwB,CAC3B,CAAA;IACD,iBAAiB,CACb,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,EACnC,YAAY,CACf,CAAA;IACD,iBAAiB,CACb,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,EACtC,2BAA2B,CAC9B,CAAA;IACD,iBAAiB,CACb,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,EAClC,wBAAwB,CAC3B,CAAA;IAED,OAAO;QACH,sEAAsE;QACtE,GAAG,EAAE,UAAU;QACf,6EAA6E;QAC7E,WAAW,CAAC,MAAiB;YACzB,KAAK,MAAM,MAAM,IAAI,UAAU;gBAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;YACxD,OAAO,MAAM,CAAA;QACjB,CAAC;QAED,0EAA0E;QAC1E,cAAc,CAAC,MAAoB;YAC/B,KAAK,MAAM,MAAM,IAAI,aAAa;gBAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;YAC3D,OAAO,MAAM,CAAA;QACjB,CAAC;QAED,iFAAiF;QACjF,KAAK,CAAC,WAAW,CAAC,MAAuB;YACrC,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;gBAChC,0GAA0G;gBAC1G,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,iBAAiB,EAAsC,EAAE,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;YACpH,CAAC;QACL,CAAC;QAED,uEAAuE;QACvE,KAAK,CAAC,cAAc,CAAC,MAAuB;YACxC,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;gBACnC,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,iBAAiB,EAAsC,EAAE,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;YACvH,CAAC;QACL,CAAC;KACJ,CAAA;AACL,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAwB,EAAE,IAAY;IAC7D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,sBAAsB,IAAI,EAAE,CAAC,CAAA;QACxE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAClB,CAAC;AACL,CAAC"}

package/dist/back/rpc/gen.d.ts

@@ -1,2 +1,3 @@
-import { RpcPluginBuilder } from './rpc.js';
+import { AdmRpcPluginBuilder, RpcPluginBuilder } from './rpc.js';
 export declare function generateClient(fileName: string, ...rpcBuilders: readonly RpcPluginBuilder[]): string;
+export declare function generateAdmClient(fileName: string, ...rpcBuilders: readonly AdmRpcPluginBuilder[]): string;