@venizia/ignis-boot 0.2.0-3 → 0.2.0-30

package/dist/esm/build-info/index.js

@@ -0,0 +1,25 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { BuildInfoFormats } from './common';
+import { BuildInfoEmitter } from './emitter';
+import { BuildInfoResolver } from './resolver';
+/**
+ * Writes the stamp. Unlike the artifact index this ALWAYS writes: `builtAt` changes every run, so
+ * an unchanged-content short-circuit would be dead code that hides a stale timestamp.
+ */
+export const generateBuildInfo = async (opts) => {
+    const buildInfo = await BuildInfoResolver.getInstance().resolve({ root: opts.root });
+    const content = BuildInfoEmitter.render({
+        buildInfo,
+        format: opts.format ?? BuildInfoFormats.TS,
+        exportName: opts.exportName ?? BuildInfoEmitter.DEFAULT_EXPORT_NAME,
+    });
+    const out = resolve(opts.out);
+    mkdirSync(dirname(out), { recursive: true });
+    writeFileSync(out, content);
+    return { buildInfo, content, out };
+};
+export * from './common';
+export * from './emitter';
+export * from './resolver';
+//# sourceMappingURL=index.js.map

package/dist/esm/build-info/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/build-info/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAiD,MAAM,UAAU,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EAAE,IAAuB,EAA6B,EAAE;IAC5F,MAAM,SAAS,GAAG,MAAM,iBAAiB,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACrF,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC;QACtC,SAAS;QACT,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,gBAAgB,CAAC,EAAE;QAC1C,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,gBAAgB,CAAC,mBAAmB;KACpE,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9B,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAE5B,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;AACrC,CAAC,CAAC;AAEF,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}

package/dist/esm/build-info/resolver.d.ts

@@ -0,0 +1,25 @@
+import { BaseHelper } from '@venizia/ignis-helpers';
+import { type TBuildInfoRecord } from '@venizia/ignis-helpers/core';
+/**
+ * Resolves the stamp: environment first (CI knows the release tag), then `git`, then the
+ * manifest. Every miss is logged with its reason and degrades one field to
+ * {@link BuildInfoRegistry.UNSPECIFIED} - a Distroless image has no `git` and an exported tarball
+ * has no manifest, and a build must not die over a stamp.
+ */
+export declare class BuildInfoResolver extends BaseHelper {
+    private static instance?;
+    private constructor();
+    static getInstance(): BuildInfoResolver;
+    resolve(opts?: {
+        root?: string;
+    }): Promise<TBuildInfoRecord>;
+    private resolveEnvironmentValue;
+    /**
+     * `nothrow()` covers a nonzero exit; the `catch` covers `git` being absent and also `Bun` being
+     * absent - under plain Node the `ReferenceError` degrades the field instead of killing the build.
+     */
+    private resolveGitValue;
+    /** `JSON.parse` promises nothing about the shape, so a manifest holding `{ "name": 42 }` must not become a numeric `service`. */
+    private resolveManifest;
+}
+//# sourceMappingURL=resolver.d.ts.map

package/dist/esm/build-info/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../src/build-info/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAQvF;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,UAAU;IAC/C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAoB;IAE5C,OAAO;IAIP,MAAM,CAAC,WAAW,IAAI,iBAAiB;IAIjC,OAAO,CAAC,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkClE,OAAO,CAAC,uBAAuB;IAW/B;;;OAGG;YACW,eAAe;IA4B7B,iIAAiI;IACjI,OAAO,CAAC,eAAe;CAyBxB"}

package/dist/esm/build-info/resolver.js

@@ -0,0 +1,101 @@
+import { BaseHelper } from '@venizia/ignis-helpers';
+import { BuildInfoRegistry } from '@venizia/ignis-helpers/core';
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { BuildInfoEnvironmentKeys } from './common';
+/** Length of a short SHA; an env value already shorter is left alone. */
+const COMMIT_LENGTH = 12;
+/**
+ * Resolves the stamp: environment first (CI knows the release tag), then `git`, then the
+ * manifest. Every miss is logged with its reason and degrades one field to
+ * {@link BuildInfoRegistry.UNSPECIFIED} - a Distroless image has no `git` and an exported tarball
+ * has no manifest, and a build must not die over a stamp.
+ */
+export class BuildInfoResolver extends BaseHelper {
+    constructor() {
+        super({ scope: BuildInfoResolver.name });
+    }
+    static getInstance() {
+        return (this.instance ??= new BuildInfoResolver());
+    }
+    async resolve(opts) {
+        const root = resolve(opts?.root ?? process.cwd());
+        const manifest = this.resolveManifest({ root });
+        // Independent processes; sequencing them would double the latency of the common case for nothing.
+        const [gitCommit, gitBranch] = await Promise.all([
+            this.resolveGitValue({ args: ['rev-parse', `--short=${COMMIT_LENGTH}`, 'HEAD'], root }),
+            this.resolveGitValue({ args: ['rev-parse', '--abbrev-ref', 'HEAD'], root }),
+        ]);
+        const unspecified = BuildInfoRegistry.UNSPECIFIED;
+        return {
+            service: manifest.name ?? unspecified,
+            version: this.resolveEnvironmentValue({ keys: BuildInfoEnvironmentKeys.VERSION }) ??
+                manifest.version ??
+                unspecified,
+            commit: this.resolveEnvironmentValue({ keys: BuildInfoEnvironmentKeys.COMMIT })?.slice(0, COMMIT_LENGTH) ??
+                gitCommit ??
+                unspecified,
+            branch: this.resolveEnvironmentValue({ keys: BuildInfoEnvironmentKeys.BRANCH }) ??
+                gitBranch ??
+                unspecified,
+            builtAt: this.resolveEnvironmentValue({ keys: BuildInfoEnvironmentKeys.BUILT_AT }) ??
+                new Date().toISOString(),
+        };
+    }
+    resolveEnvironmentValue(opts) {
+        for (const key of opts.keys) {
+            const value = process.env[key];
+            if (value !== undefined && value.trim().length > 0) {
+                return value.trim();
+            }
+        }
+        return undefined;
+    }
+    /**
+     * `nothrow()` covers a nonzero exit; the `catch` covers `git` being absent and also `Bun` being
+     * absent - under plain Node the `ReferenceError` degrades the field instead of killing the build.
+     */
+    async resolveGitValue(opts) {
+        const { args, root } = opts;
+        try {
+            const result = await Bun.$ `git ${args}`.cwd(root).quiet().nothrow();
+            // `rev-parse --abbrev-ref HEAD` in a repository with no commit prints the literal `HEAD` on
+            // stdout while exiting 128, so the exit code decides and stdout alone never does.
+            if (result.exitCode !== 0) {
+                this.logger.debug('git %s | exit: %d | %s', args.join(' '), result.exitCode, result.stderr.toString().trim());
+                return undefined;
+            }
+            const value = result.stdout.toString().trim();
+            return value.length > 0 ? value : undefined;
+        }
+        catch (error) {
+            this.logger.debug('git %s | unavailable: %s', args.join(' '), error);
+            return undefined;
+        }
+    }
+    /** `JSON.parse` promises nothing about the shape, so a manifest holding `{ "name": 42 }` must not become a numeric `service`. */
+    resolveManifest(opts) {
+        const manifest = resolve(opts.root, 'package.json');
+        if (!existsSync(manifest)) {
+            this.logger.debug('No package.json at %s', opts.root);
+            return {};
+        }
+        try {
+            const parsed = JSON.parse(readFileSync(manifest, 'utf8'));
+            if (typeof parsed !== 'object' || parsed === null) {
+                return {};
+            }
+            const name = 'name' in parsed ? parsed.name : undefined;
+            const version = 'version' in parsed ? parsed.version : undefined;
+            return {
+                name: typeof name === 'string' ? name : undefined,
+                version: typeof version === 'string' ? version : undefined,
+            };
+        }
+        catch (error) {
+            this.logger.debug('Unreadable package.json at %s | %s', manifest, error);
+            return {};
+        }
+    }
+}
+//# sourceMappingURL=resolver.js.map

package/dist/esm/build-info/resolver.js.map

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

package/dist/esm/clis/artifacts.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+import '../common/install-quiet-logger';
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/esm/clis/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../../src/clis/artifacts.ts"],"names":[],"mappings":";AACA,OAAO,gCAAgC,CAAC"}

package/dist/esm/clis/artifacts.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env bun
+import '../common/install-quiet-logger';
+import { relative } from 'node:path';
+import { parseArgs } from 'node:util';
+import { checkArtifactIndex, generateArtifactIndex } from '../generator';
+const USAGE = 'ignis-artifacts <generate|check> [--root src] [--out src/generated/artifacts.ts] [--ignore a,b] [--export GeneratedArtifacts]';
+const { positionals, values } = parseArgs({
+    args: process.argv.slice(2),
+    allowPositionals: true,
+    options: {
+        root: { type: 'string', default: 'src' },
+        out: { type: 'string', default: 'src/generated/artifacts.ts' },
+        ignore: { type: 'string' },
+        export: { type: 'string', default: 'GeneratedArtifacts' },
+    },
+});
+const options = {
+    root: values.root,
+    out: values.out,
+    ignore: values.ignore
+        ?.split(',')
+        .map(pattern => pattern.trim())
+        .filter(Boolean),
+    exportName: values.export,
+};
+/** One stderr line per decorated class a user `--ignore` pattern hid; silence when nothing is hidden. */
+const warnIgnored = (opts) => {
+    for (const artifact of opts.ignored) {
+        console.error(`warning: ${artifact.className} (${artifact.type}) in ${relative(opts.root, artifact.filePath)} matches --ignore and is left out of the index`);
+    }
+};
+/** Exit code of the command, so the process exits in exactly one place. */
+const run = () => {
+    switch (positionals[0]) {
+        case 'generate': {
+            const result = generateArtifactIndex(options);
+            console.log(`${result.written ? 'wrote' : 'up to date'} ${options.out} | ${result.artifacts.length} artifact(s)`);
+            warnIgnored({ ignored: result.ignored, root: options.root });
+            return 0;
+        }
+        case 'check': {
+            const result = checkArtifactIndex(options);
+            warnIgnored({ ignored: result.ignored, root: options.root });
+            if (result.isFresh) {
+                console.log(`fresh ${options.out}`);
+                return 0;
+            }
+            console.error(`stale ${options.out} - run: ignis-artifacts generate --root ${options.root} --out ${options.out}`);
+            return 1;
+        }
+        default: {
+            console.error(USAGE);
+            return 2;
+        }
+    }
+};
+process.exit(run());
+//# sourceMappingURL=artifacts.js.map

package/dist/esm/clis/artifacts.js.map

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

package/dist/esm/clis/build-info.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+import '../common/install-quiet-logger';
+//# sourceMappingURL=build-info.d.ts.map

package/dist/esm/clis/build-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-info.d.ts","sourceRoot":"","sources":["../../../src/clis/build-info.ts"],"names":[],"mappings":";AACA,OAAO,gCAAgC,CAAC"}

package/dist/esm/clis/build-info.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env bun
+import '../common/install-quiet-logger';
+import { parseArgs } from 'node:util';
+import { BuildInfoEmitter, BuildInfoFormats, generateBuildInfo } from '../build-info';
+const USAGE = 'ignis-build-info generate [--out src/_build_info.ts] [--root .] [--format ts|json] [--export BUILD_INFO]';
+const { positionals, values } = parseArgs({
+    args: process.argv.slice(2),
+    allowPositionals: true,
+    options: {
+        out: { type: 'string', default: 'src/_build_info.ts' },
+        root: { type: 'string', default: '.' },
+        format: { type: 'string', default: BuildInfoFormats.TS },
+        export: { type: 'string', default: BuildInfoEmitter.DEFAULT_EXPORT_NAME },
+    },
+});
+/** Exit code of the command, so the process exits in exactly one place. */
+const run = async () => {
+    if (positionals[0] !== 'generate') {
+        console.error(USAGE);
+        return 1;
+    }
+    if (!BuildInfoFormats.isValid(values.format)) {
+        console.error(`invalid --format '${values.format}' | expected one of: ${[...BuildInfoFormats.SCHEME_SET].join(', ')}`);
+        return 1;
+    }
+    // Narrowed by comparison, never asserted: `isValid` above already refused everything else.
+    const format = values.format === BuildInfoFormats.JSON ? BuildInfoFormats.JSON : BuildInfoFormats.TS;
+    const result = await generateBuildInfo({
+        out: values.out,
+        root: values.root,
+        format,
+        exportName: values.export,
+    });
+    const { service, version, commit, branch } = result.buildInfo;
+    console.log(`wrote ${values.out} | ${service}@${version} | ${commit} (${branch})`);
+    return 0;
+};
+run()
+    .then(code => {
+    process.exit(code);
+})
+    .catch(error => {
+    console.error(error);
+    process.exit(1);
+});
+//# sourceMappingURL=build-info.js.map

package/dist/esm/clis/build-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-info.js","sourceRoot":"","sources":["../../../src/clis/build-info.ts"],"names":[],"mappings":";AACA,OAAO,gCAAgC,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEtF,MAAM,KAAK,GACT,0GAA0G,CAAC;AAE7G,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACxC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3B,gBAAgB,EAAE,IAAI;IACtB,OAAO,EAAE;QACP,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,oBAAoB,EAAE;QACtD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE;QACtC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,CAAC,EAAE,EAAE;QACxD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,CAAC,mBAAmB,EAAE;KAC1E;CACF,CAAC,CAAC;AAEH,2EAA2E;AAC3E,MAAM,GAAG,GAAG,KAAK,IAAqB,EAAE;IACtC,IAAI,WAAW,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7C,OAAO,CAAC,KAAK,CACX,qBAAqB,MAAM,CAAC,MAAM,wBAAwB,CAAC,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxG,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,2FAA2F;IAC3F,MAAM,MAAM,GACV,MAAM,CAAC,MAAM,KAAK,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,EAAE,CAAC;IAExF,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC;QACrC,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM;QACN,UAAU,EAAE,MAAM,CAAC,MAAM;KAC1B,CAAC,CAAC;IAEH,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,OAAO,IAAI,OAAO,MAAM,MAAM,KAAK,MAAM,GAAG,CAAC,CAAC;IAEnF,OAAO,CAAC,CAAC;AACX,CAAC,CAAC;AAEF,GAAG,EAAE;KACF,IAAI,CAAC,IAAI,CAAC,EAAE;IACX,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC,CAAC;KACD,KAAK,CAAC,KAAK,CAAC,EAAE;IACb,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/esm/common/install-quiet-logger.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=install-quiet-logger.d.ts.map

package/dist/esm/common/install-quiet-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-quiet-logger.d.ts","sourceRoot":"","sources":["../../../src/common/install-quiet-logger.ts"],"names":[],"mappings":""}

package/dist/esm/common/install-quiet-logger.js

@@ -0,0 +1,5 @@
+import { LoggerFactory } from '@venizia/ignis-helpers';
+import { QuietLogger } from './quiet-logger';
+// Imported first by the CLI: a provider registered after another module resolved its logger would still see the console fallback and its warning.
+LoggerFactory.use({ provider: QuietLogger });
+//# sourceMappingURL=install-quiet-logger.js.map

package/dist/esm/common/install-quiet-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-quiet-logger.js","sourceRoot":"","sources":["../../../src/common/install-quiet-logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,kJAAkJ;AAClJ,aAAa,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC"}

package/dist/esm/common/quiet-logger.d.ts

@@ -0,0 +1,18 @@
+import type { ILogger, TLogLevel } from '@venizia/ignis-helpers/core';
+/** The generator's own output goes through `console.log`; framework diagnostics below `warn` are dropped and the rest land on stderr, so a codegen run prints nothing but its result on stdout. */
+export declare class QuietLogger implements ILogger {
+    private readonly scope;
+    private static readonly cache;
+    private readonly prefix;
+    private constructor();
+    static get(scope: string): ILogger;
+    private write;
+    debug(): void;
+    info(): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    emerg(message: string, ...args: unknown[]): void;
+    log(level: TLogLevel, message: string, ...args: unknown[]): void;
+    for(methodName: string): ILogger;
+}
+//# sourceMappingURL=quiet-logger.d.ts.map

package/dist/esm/common/quiet-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quiet-logger.d.ts","sourceRoot":"","sources":["../../../src/common/quiet-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAGtE,mMAAmM;AACnM,qBAAa,WAAY,YAAW,OAAO;IAIrB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAH1C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAkC;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,OAAO;IAIP,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAWlC,OAAO,CAAC,KAAK;IAIb,KAAK,IAAI,IAAI;IAEb,IAAI,IAAI,IAAI;IAEZ,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIhD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIhD,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAQhE,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;CAGjC"}

package/dist/esm/common/quiet-logger.js

@@ -0,0 +1,42 @@
+import { LogLevels } from '@venizia/ignis-helpers/core';
+/** The generator's own output goes through `console.log`; framework diagnostics below `warn` are dropped and the rest land on stderr, so a codegen run prints nothing but its result on stdout. */
+export class QuietLogger {
+    static { this.cache = new Map(); }
+    constructor(scope) {
+        this.scope = scope;
+        this.prefix = scope === '' ? '' : `[${scope}] `;
+    }
+    static get(scope) {
+        const cached = this.cache.get(scope);
+        if (cached) {
+            return cached;
+        }
+        const created = new QuietLogger(scope);
+        this.cache.set(scope, created);
+        return created;
+    }
+    write(opts) {
+        console.error(`${this.prefix}${opts.message}`, ...opts.args);
+    }
+    debug() { }
+    info() { }
+    warn(message, ...args) {
+        this.write({ message, args });
+    }
+    error(message, ...args) {
+        this.write({ message, args });
+    }
+    emerg(message, ...args) {
+        this.write({ message, args });
+    }
+    log(level, message, ...args) {
+        if (level === LogLevels.DEBUG || level === LogLevels.INFO) {
+            return;
+        }
+        this.write({ message, args });
+    }
+    for(methodName) {
+        return QuietLogger.get(this.scope === '' ? methodName : `${this.scope}-${methodName}`);
+    }
+}
+//# sourceMappingURL=quiet-logger.js.map

package/dist/esm/common/quiet-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quiet-logger.js","sourceRoot":"","sources":["../../../src/common/quiet-logger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAExD,mMAAmM;AACnM,MAAM,OAAO,WAAW;aACE,UAAK,GAAG,IAAI,GAAG,EAAuB,CAAC;IAG/D,YAAqC,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;QAChD,IAAI,CAAC,MAAM,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,KAAa;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,IAA0C;QACtD,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,KAAU,CAAC;IAEhB,IAAI,KAAU,CAAC;IAEf,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,GAAG,CAAC,KAAgB,EAAE,OAAe,EAAE,GAAG,IAAe;QACvD,IAAI,KAAK,KAAK,SAAS,CAAC,KAAK,IAAI,KAAK,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YAC1D,OAAO;QACT,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,GAAG,CAAC,UAAkB;QACpB,OAAO,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,UAAU,EAAE,CAAC,CAAC;IACzF,CAAC"}

package/dist/esm/generator/common/constants.d.ts

@@ -0,0 +1,46 @@
+import type { TConstValue } from '@venizia/ignis-helpers';
+/** Mirrors the kernel's `ArtifactTypes` values; boot must not depend on kernel (`{boot, kernel} -> core` in the build chain). */
+export declare class ArtifactTypes {
+    static readonly CONFIGURATION = "configuration";
+    static readonly COMPONENT = "component";
+    static readonly CONTROLLER = "controller";
+    static readonly SERVICE = "service";
+    static readonly REPOSITORY = "repository";
+    static readonly DATASOURCE = "datasource";
+    static readonly MODEL = "model";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(value: string): boolean;
+}
+export type TArtifactType = TConstValue<typeof ArtifactTypes>;
+/** Mirrors the kernel's `ArtifactIndexFields` - the keys of the object the emitter writes and `registerArtifacts` reads. */
+export declare class ArtifactIndexFields {
+    static readonly CONFIGURATIONS = "configurations";
+    static readonly DATA_SOURCES = "dataSources";
+    static readonly COMPONENTS = "components";
+    static readonly REPOSITORIES = "repositories";
+    static readonly SERVICES = "services";
+    static readonly CONTROLLERS = "controllers";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(value: string): boolean;
+}
+export type TArtifactIndexField = TConstValue<typeof ArtifactIndexFields>;
+export declare class ArtifactStereotypes {
+    /** Decorator name as imported from `@venizia/ignis` or `@venizia/ignis-kernel` -> artifact type. */
+    static readonly BY_DECORATOR: Readonly<Record<string, TArtifactType>>;
+    static readonly ROOT_DECORATOR = "injectable";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(value: string): boolean;
+    static readonly SOURCE_MODULES: RegExp;
+    static readonly DEFAULT_IGNORE: string[];
+    /**
+     * The kernel's `registerArtifacts` order; `model` is never emitted. Configurations come first:
+     * `registerConfigurations` runs before the datasource and component sweeps, so a `@configuration`
+     * can shape what they read. The kernel sorts them among themselves by their `after` declarations
+     * at boot, so the order within the field does not matter here.
+     */
+    static readonly EMIT_ORDER: ReadonlyArray<{
+        type: TArtifactType;
+        field: TArtifactIndexField;
+    }>;
+}
+//# sourceMappingURL=constants.d.ts.map

package/dist/esm/generator/common/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/generator/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,iIAAiI;AACjI,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,aAAa,mBAAmB;IAChD,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IACxC,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAC1C,MAAM,CAAC,QAAQ,CAAC,OAAO,aAAa;IACpC,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAC1C,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAC1C,MAAM,CAAC,QAAQ,CAAC,KAAK,WAAW;IAEhC,MAAM,CAAC,QAAQ,CAAC,UAAU,cAQvB;IAEH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAED,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,aAAa,CAAC,CAAC;AAE9D,4HAA4H;AAC5H,qBAAa,mBAAmB;IAC9B,MAAM,CAAC,QAAQ,CAAC,cAAc,oBAAoB;IAClD,MAAM,CAAC,QAAQ,CAAC,YAAY,iBAAiB;IAC7C,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAC1C,MAAM,CAAC,QAAQ,CAAC,YAAY,kBAAkB;IAC9C,MAAM,CAAC,QAAQ,CAAC,QAAQ,cAAc;IACtC,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;IAE5C,MAAM,CAAC,QAAQ,CAAC,UAAU,cAOvB;IAEH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAED,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAE1E,qBAAa,mBAAmB;IAC9B,oGAAoG;IACpG,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAQnE;IAEF,MAAM,CAAC,QAAQ,CAAC,cAAc,gBAAgB;IAE9C,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAoE;IAE9F,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAItC,MAAM,CAAC,QAAQ,CAAC,cAAc,SAAiC;IAE/D,MAAM,CAAC,QAAQ,CAAC,cAAc,WAK5B;IAEF;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,aAAa,CAAC;QAAC,KAAK,EAAE,mBAAmB,CAAA;KAAE,CAAC,CAO5F;CACH"}

package/dist/esm/generator/common/constants.js

@@ -0,0 +1,81 @@
+/** Mirrors the kernel's `ArtifactTypes` values; boot must not depend on kernel (`{boot, kernel} -> core` in the build chain). */
+export class ArtifactTypes {
+    static { this.CONFIGURATION = 'configuration'; }
+    static { this.COMPONENT = 'component'; }
+    static { this.CONTROLLER = 'controller'; }
+    static { this.SERVICE = 'service'; }
+    static { this.REPOSITORY = 'repository'; }
+    static { this.DATASOURCE = 'datasource'; }
+    static { this.MODEL = 'model'; }
+    static { this.SCHEME_SET = new Set([
+        this.CONFIGURATION,
+        this.COMPONENT,
+        this.CONTROLLER,
+        this.SERVICE,
+        this.REPOSITORY,
+        this.DATASOURCE,
+        this.MODEL,
+    ]); }
+    static isValid(value) {
+        return this.SCHEME_SET.has(value);
+    }
+}
+/** Mirrors the kernel's `ArtifactIndexFields` - the keys of the object the emitter writes and `registerArtifacts` reads. */
+export class ArtifactIndexFields {
+    static { this.CONFIGURATIONS = 'configurations'; }
+    static { this.DATA_SOURCES = 'dataSources'; }
+    static { this.COMPONENTS = 'components'; }
+    static { this.REPOSITORIES = 'repositories'; }
+    static { this.SERVICES = 'services'; }
+    static { this.CONTROLLERS = 'controllers'; }
+    static { this.SCHEME_SET = new Set([
+        this.CONFIGURATIONS,
+        this.DATA_SOURCES,
+        this.COMPONENTS,
+        this.REPOSITORIES,
+        this.SERVICES,
+        this.CONTROLLERS,
+    ]); }
+    static isValid(value) {
+        return this.SCHEME_SET.has(value);
+    }
+}
+export class ArtifactStereotypes {
+    /** Decorator name as imported from `@venizia/ignis` or `@venizia/ignis-kernel` -> artifact type. */
+    static { this.BY_DECORATOR = {
+        configuration: ArtifactTypes.CONFIGURATION,
+        component: ArtifactTypes.COMPONENT,
+        controller: ArtifactTypes.CONTROLLER,
+        service: ArtifactTypes.SERVICE,
+        repository: ArtifactTypes.REPOSITORY,
+        datasource: ArtifactTypes.DATASOURCE,
+        model: ArtifactTypes.MODEL,
+    }; }
+    static { this.ROOT_DECORATOR = 'injectable'; }
+    static { this.SCHEME_SET = new Set(Object.values(ArtifactStereotypes.BY_DECORATOR)); }
+    static isValid(value) {
+        return this.SCHEME_SET.has(value);
+    }
+    static { this.SOURCE_MODULES = /^@venizia\/ignis(-kernel)?$/; }
+    static { this.DEFAULT_IGNORE = [
+        '**/__tests__/**',
+        '**/*.test.ts',
+        '**/*.spec.ts',
+        '**/generated/**',
+    ]; }
+    /**
+     * The kernel's `registerArtifacts` order; `model` is never emitted. Configurations come first:
+     * `registerConfigurations` runs before the datasource and component sweeps, so a `@configuration`
+     * can shape what they read. The kernel sorts them among themselves by their `after` declarations
+     * at boot, so the order within the field does not matter here.
+     */
+    static { this.EMIT_ORDER = [
+        { type: ArtifactTypes.CONFIGURATION, field: ArtifactIndexFields.CONFIGURATIONS },
+        { type: ArtifactTypes.DATASOURCE, field: ArtifactIndexFields.DATA_SOURCES },
+        { type: ArtifactTypes.COMPONENT, field: ArtifactIndexFields.COMPONENTS },
+        { type: ArtifactTypes.REPOSITORY, field: ArtifactIndexFields.REPOSITORIES },
+        { type: ArtifactTypes.SERVICE, field: ArtifactIndexFields.SERVICES },
+        { type: ArtifactTypes.CONTROLLER, field: ArtifactIndexFields.CONTROLLERS },
+    ]; }
+}
+//# sourceMappingURL=constants.js.map

package/dist/esm/generator/common/constants.js.map

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

package/dist/esm/generator/common/index.d.ts

@@ -0,0 +1,3 @@
+export * from './constants';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/generator/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/generator/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}

package/dist/esm/generator/common/index.js

@@ -0,0 +1,3 @@
+export * from './constants';
+export * from './types';
+//# sourceMappingURL=index.js.map

package/dist/esm/generator/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/generator/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}

package/dist/esm/generator/common/types.d.ts

@@ -0,0 +1,18 @@
+import type { TArtifactType } from './constants';
+export interface IScannedArtifact {
+    className: string;
+    /** Absolute path of the declaring file. */
+    filePath: string;
+    type: TArtifactType;
+}
+export interface IScanOptions {
+    root: string;
+    /** Glob patterns relative to `root`; defaults to `ArtifactStereotypes.DEFAULT_IGNORE`. */
+    ignore?: string[];
+}
+/** The index content plus what a caller's `ignore` silently left out: decorated classes under a user pattern, never under a default one. */
+export interface IScanReport {
+    artifacts: IScannedArtifact[];
+    ignored: IScannedArtifact[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/generator/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/generator/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,4IAA4I;AAC5I,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B"}

package/dist/esm/generator/common/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/generator/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/generator/common/types.ts"],"names":[],"mappings":""}

package/dist/esm/generator/emitter.d.ts

@@ -0,0 +1,29 @@
+import { type IScannedArtifact } from './common';
+/** Renders the generated index: deterministic text, plain static imports, no IGNIS import - the object is type-checked where `registerArtifacts` receives it. */
+export declare class ArtifactIndexEmitter {
+    /** Mirrors `printWidth` in @venizia/dev-configs prettier settings. */
+    static readonly PRINT_WIDTH = 100;
+    static readonly DEFAULT_EXPORT_NAME = "GeneratedArtifacts";
+    /** The exact command that regenerates the file, so the header never points at another path than the one the build used. */
+    static renderHeader(opts: {
+        root: string;
+        out: string;
+        ignore?: string[];
+        exportName?: string;
+    }): string;
+    static render(opts: {
+        artifacts: IScannedArtifact[];
+        outFile: string;
+        exportName: string;
+        /** The CLI arguments as given, for the header; `outFile` above is the resolved path used for import specifiers. */
+        command: {
+            root: string;
+            out: string;
+            ignore?: string[];
+        };
+    }): string;
+    /** One line while it fits the repo's prettier width, else one name per line - so `prettier -l` on the generated file stays quiet. */
+    private static renderField;
+    private static importPath;
+}
+//# sourceMappingURL=emitter.d.ts.map

package/dist/esm/generator/emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../../src/generator/emitter.ts"],"names":[],"mappings":"AACA,OAAO,EAAsC,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAErF,iKAAiK;AACjK,qBAAa,oBAAoB;IAC/B,sEAAsE;IACtE,MAAM,CAAC,QAAQ,CAAC,WAAW,OAAO;IAElC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,wBAAwB;IAE3D,2HAA2H;IAC3H,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE;QACxB,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,MAAM;IAYV,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QAClB,SAAS,EAAE,gBAAgB,EAAE,CAAC;QAC9B,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,mHAAmH;QACnH,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC;KAC3D,GAAG,MAAM;IAgCV,qIAAqI;IACrI,OAAO,CAAC,MAAM,CAAC,WAAW;IAW1B,OAAO,CAAC,MAAM,CAAC,UAAU;CAI1B"}