@venizia/ignis-boot 0.2.0-9 → 0.2.0

package/LICENSE.md

@@ -47,7 +47,6 @@ This package uses the following open-source libraries:
 | [@venizia/ignis-helpers](https://github.com/VENIZIA-AI/ignis) | MIT | Ignis utility helpers |
 | [@venizia/ignis-inversion](https://github.com/VENIZIA-AI/ignis) | MIT | Ignis DI/IoC container |
 | [glob](https://github.com/isaacs/node-glob) | ISC | File pattern matching |
-| [lodash](https://github.com/lodash/lodash) | MIT | Utility library |
 | [reflect-metadata](https://github.com/rbuckton/reflect-metadata) | Apache-2.0 | Metadata reflection API |
 | [zod](https://github.com/colinhacks/zod) | MIT | TypeScript-first schema validation |
 

package/README.md

@@ -1,56 +1,31 @@
-<div align="center">
+# @venizia/ignis-boot
 
-<br />
-
-# :fire: IGNIS - `@venizia/ignis-boot`
-
-**Generates one static registration file from your decorated classes.**
-
-[![Docs](https://img.shields.io/badge/Docs-ignis.venizia.ai-2563EB.svg?style=flat-square)](https://ignis.venizia.ai/references/base/bootstrapping)
-[![npm](https://img.shields.io/npm/v/@venizia/ignis-boot.svg?style=flat-square&color=cb3837&label=@venizia/ignis-boot)](https://www.npmjs.com/package/@venizia/ignis-boot)
-[![License: MIT](https://img.shields.io/badge/License-MIT-3DA639.svg?style=flat-square)](LICENSE.md)
-[![TypeScript](https://img.shields.io/badge/TypeScript-6.x-3178C6.svg?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
-
-[Artifact registration reference](https://ignis.venizia.ai/references/base/bootstrapping) &#8226;
-[Registering artifacts guide](https://ignis.venizia.ai/guides/core-concepts/application/bootstrapping) &#8226;
-[Changelog](https://ignis.venizia.ai/changelogs/2026-09-03-deprecated-boot-api-removed)
-
-</div>
-
----
-
-`ignis-artifacts` walks a source root with the TypeScript compiler API, finds every named,
-non-abstract class that carries an IGNIS stereotype decorator (`@service`, `@controller`, ...), and
-writes one file of plain static imports: `src/generated/artifacts.ts`. The application passes that
-file as `configs.artifacts`; `@venizia/ignis`'s `registerArtifacts` boot step binds it.
-
-**This package runs at build time only.** No decorator runs and no class is imported while
-scanning - detection reads source text, so a datasource that opens a pool at import stays inert.
+Build-time tools for an IGNIS application: `ignis-artifacts` writes one static file that registers your decorated classes, and `ignis-build-info` stamps the build. Install it as a devDependency of the application.
 
 ## Install
 
 ```bash
-bun add -d @venizia/ignis-boot
+bun add -d @venizia/ignis-boot typescript
 ```
 
-`ignis-artifacts` runs at build time; the generated file imports nothing from this package, so a
-deployed application installs nothing extra for it at runtime.
+`typescript` 5 or 6 is a required peer: the scanner reads your source with the TypeScript compiler API. Both binaries run under Bun (they carry a `bun` shebang).
 
-## Use it
+## Register your classes
 
 Decorate the classes you want registered:
 
 ```typescript
-import { component, service } from '@venizia/ignis';
+import { BaseService, service } from '@venizia/ignis';
 
 @service()
-export class PricingService extends BaseService {}
-
-@component()
-export class MetricsComponent extends BaseComponent {}
+export class PricingService extends BaseService {
+  constructor() {
+    super({ scope: PricingService.name });
+  }
+}
 ```
 
-Add the generator scripts and run one:
+Add two scripts and run the first one:
 
 ```json
 {
@@ -61,13 +36,26 @@ Add the generator scripts and run one:
 }
 ```
 
-```bash
-bun run generate:artifacts
+`generate` writes plain static imports and one object:
+
+```typescript
+// AUTO-GENERATED by @venizia/ignis-boot - do not edit. Regenerate: ignis-artifacts generate --root src --out src/generated/artifacts.ts
+import { PricingService } from '../services/pricing.service';
+
+export const GeneratedArtifacts = {
+  configurations: [],
+  dataSources: [],
+  components: [],
+  repositories: [],
+  services: [PricingService],
+  controllers: [],
+};
 ```
 
-Pass the generated index to your application:
+Hand that object to the application. The `registerArtifacts` boot step binds every class in it:
 
 ```typescript
+import type { IApplicationConfigs } from '@venizia/ignis';
 import { GeneratedArtifacts } from './generated/artifacts';
 
 export const configs: IApplicationConfigs = {
@@ -76,57 +64,91 @@ export const configs: IApplicationConfigs = {
 };
 ```
 
-Commit the generated file; never edit it by hand - the next `generate` overwrites it. Full
-walkthrough: [Registering artifacts](https://ignis.venizia.ai/guides/core-concepts/application/bootstrapping).
+Commit the generated file and never edit it by hand. Run `check:artifacts` where lint runs, so a stale index fails before it reaches CI.
 
-## CLI
+The scanner reads source text and never imports a module. No decorator runs and no import side effect fires, so a datasource that opens a pool at import stays inert. Because the output is plain imports, `bun build --compile` sees every class; a compiled binary has no source tree to scan at run time.
 
-Shipped as the `ignis-artifacts` binary. Requires `typescript >= 5` (peer dependency) and runs
-under bun.
+## `ignis-artifacts`
 
 ```
 ignis-artifacts <generate|check> [--root src] [--out src/generated/artifacts.ts] [--ignore a,b] [--export GeneratedArtifacts]
 ```
 
 | Flag | Default | Meaning |
-| :--- | :--- | :--- |
-| `--root` | `src` | Directory to scan, recursively |
-| `--out` | `src/generated/artifacts.ts` | Output path; import paths are relative to it |
-| `--ignore` | `**/__tests__/**`, `**/*.test.ts`, `**/*.spec.ts`, `**/generated/**` | Comma-separated globs, merged with the default ignore list - never replaces it |
+|---|---|---|
+| `--root` | `src` | Directory to scan, recursively (`.ts` files, `.d.ts` skipped) |
+| `--out` | `src/generated/artifacts.ts` | Output file; import paths are relative to it |
+| `--ignore` | none | Comma-separated globs, relative to `--root`, added to the default list |
 | `--export` | `GeneratedArtifacts` | Name of the exported constant |
 
+The default ignore list always applies: `**/__tests__/**`, `**/*.test.ts`, `**/*.spec.ts`, `**/generated/**`. A decorated class hidden by one of your own `--ignore` patterns prints one `warning:` line on stderr.
+
 | Command | Effect | Exit code |
-| :--- | :--- | :--- |
-| `generate` | Writes `--out` when its content changed | `0` |
-| `check` | Renders in memory and compares with `--out`; fails a stale index | `0` fresh, `1` stale |
+|---|---|---|
+| `generate` | Writes `--out` only when the content changed | `0` |
+| `check` | Renders in memory and compares with `--out`, ignoring the header line | `0` fresh, `1` stale or missing |
+| anything else | Prints the usage line | `2` |
 
-Default ignore list: `**/__tests__/**`, `**/*.test.ts`, `**/*.spec.ts`, `**/generated/**`.
+### What gets emitted
 
-## Detection rules
+A class lands in the index when all of these hold. The scanner logs a warning for a decorated class it skips.
 
-A class is emitted when every rule holds. Every miss is logged with its reason.
+- It is a named export (`export class` or `export { Name }`), not `export default`.
+- It is not `abstract`.
+- It carries exactly one of `@configuration`, `@component`, `@controller`, `@service`, `@repository` or `@datasource`, imported by name from `@venizia/ignis` or `@venizia/ignis-kernel` (aliases resolved). `@injectable({ type })` counts when `type` is a string literal or `ArtifactTypes.<NAME>`.
 
-- Named export (`export class`), not `export default`, not module-private.
-- Not `abstract`.
-- Decorated with `component`, `controller`, `service`, `repository` or `datasource`, imported from
-  `@venizia/ignis` or `@venizia/ignis-kernel` (import aliases resolved) - or with
-  `injectable({ type })` where `type` is a string literal or `ArtifactTypes.<NAME>`.
+`@model` classes are recognized and never emitted - a repository registers its model. A decorator re-exported through your own wrapper module is not recognized. Two stereotypes on one class fail the scan.
+
+The output is deterministic: imports sorted by path, names sorted within each field, empty fields kept, a field wider than 100 columns wrapped one name per line.
+
+## `ignis-build-info`
+
+A compiled binary or a Distroless image has no `.git` and no readable `package.json`, so `ignis-build-info` resolves the build stamp at build time and writes it as a static file.
+
+```
+ignis-build-info generate [--out src/_build_info.ts] [--root .] [--format ts|json] [--export BUILD_INFO]
+```
+
+| Flag | Default | Meaning |
+|---|---|---|
+| `--out` | `src/_build_info.ts` | Output file; rewritten on every run |
+| `--root` | `.` | Where `package.json` is read and `git` runs |
+| `--format` | `ts` | `ts` writes an `export const`; `json` writes the same record as JSON |
+| `--export` | `BUILD_INFO` | Name of the exported constant in `ts` format |
+
+Each field reads the environment first (first non-blank key wins), then its fallback. A field nothing resolves reads `unspecified`.
+
+| Field | Environment keys, in order | Fallback |
+|---|---|---|
+| `service` | - | `package.json` `name` |
+| `version` | `APP_ENV_BUILD_VERSION`, `APP_BUILD_VERSION`, `CI_COMMIT_TAG`, `GITHUB_REF_NAME` | `package.json` `version` |
+| `commit` | `APP_ENV_BUILD_COMMIT_TAG`, `APP_BUILD_COMMIT`, `CI_COMMIT_SHA`, `GITHUB_SHA`, `COMMIT_SHA` | `git rev-parse --short=12 HEAD` |
+| `branch` | `APP_BUILD_BRANCH`, `CI_COMMIT_REF_NAME`, `GITHUB_REF_NAME`, `BRANCH_NAME` | `git rev-parse --abbrev-ref HEAD` |
+| `builtAt` | `APP_ENV_BUILD_DATE`, `APP_BUILD_DATE` | the time the generator ran |
+
+Register the stamp once at the entry point. The health-check component's `/stats` route reports it:
+
+```typescript
+import { BuildInfoRegistry } from '@venizia/ignis-helpers/core';
+import { BUILD_INFO } from './_build_info';
+
+BuildInfoRegistry.set({ buildInfo: BUILD_INFO });
+```
 
-`model` classes are recognised and never emitted - a model is reached through its repository.
+## Entry points
 
-## Programmatic API
+| Subpath | What it gives | Extra peers |
+|---|---|---|
+| `@venizia/ignis-boot` | Everything from the two subpaths below | `typescript` |
+| `@venizia/ignis-boot/generator` | `generateArtifactIndex`, `checkArtifactIndex`, `ArtifactScanner`, `ArtifactIndexEmitter`, `ArtifactStereotypes`, `ArtifactTypes`, `ArtifactIndexFields` | `typescript` |
+| `@venizia/ignis-boot/build-info` | `generateBuildInfo`, `BuildInfoResolver`, `BuildInfoEmitter`, `BuildInfoFormats`, `BuildInfoEnvironmentKeys` | none |
 
-`@venizia/ignis-boot/generator` exports the same machinery as functions, for a caller that is not
-a shell script.
+| Binary | File |
+|---|---|
+| `ignis-artifacts` | `dist/cjs/clis/artifacts.js` |
+| `ignis-build-info` | `dist/cjs/clis/build-info.js` |
 
-| Export | What it is |
-| :--- | :--- |
-| `generateArtifactIndex(opts)` | Renders and writes `opts.out` when the content changed |
-| `checkArtifactIndex(opts)` | Renders in memory and compares with `opts.out`, without writing |
-| `IGenerateOptions` | `{ root, out, ignore?, exportName? }` - shared options for both |
-| `ArtifactScanner.getInstance().scan({ root, ignore? })` | The scan step alone, as `IScannedArtifact[]` |
-| `ArtifactIndexEmitter.render({ artifacts, outFile, exportName })` | The render step alone, as text |
-| `ArtifactStereotypes`, `ArtifactTypes`, `ArtifactIndexFields` | The decorator-to-type map and the emitted field names |
+The package ships CommonJS and ESM builds. The programmatic API mirrors the CLI:
 
 ```typescript
 import { checkArtifactIndex } from '@venizia/ignis-boot/generator';
@@ -134,26 +156,19 @@ import { checkArtifactIndex } from '@venizia/ignis-boot/generator';
 const { isFresh } = checkArtifactIndex({ root: 'src', out: 'src/generated/artifacts.ts' });
 ```
 
-## What you must know
+## Where it sits
 
-- **Output is deterministic.** Imports sorted by path, class names sorted within each field, one
-  field per kind, empty arrays kept. A field wider than 100 columns wraps one name per line, so the
-  file passes the repo's `prettier -l` unchanged.
-- **The scanner never executes a module.** No decorator runs and no import side effect fires while
-  scanning, so a stereotype re-exported through a local wrapper module is not recognised - the
-  import must name an IGNIS module directly.
-- **`check` belongs where lint runs**, not only in CI - a stale index should fail locally before a
-  push reaches the pipeline.
+`dev-configs -> inversion -> {filter, helpers} -> {boot, kernel} -> connectors -> {core-worker, core-server} -> atlas`. Boot depends on `@venizia/ignis-helpers` only; no IGNIS package depends on boot, so the application declares it.
 
-Full detail: [Artifact registration reference](https://ignis.venizia.ai/references/base/bootstrapping).
+The generated index replaces the runtime booters IGNIS once took from LoopBack 4, which globbed the file system at startup.
 
 ## Links
 
-[Documentation](https://ignis.venizia.ai) &#8226;
-[Quickstart](https://ignis.venizia.ai/guides/get-started/5-minute-quickstart) &#8226;
-[Core API](https://ignis.venizia.ai/references/) &#8226;
-[Best practices](https://ignis.venizia.ai/best-practices/) &#8226;
-[Changelog](https://ignis.venizia.ai/changelogs/)
+- [Registering artifacts (guide)](https://ignis.venizia.ai/guides/core-concepts/application/bootstrapping)
+- [Artifact registration (reference)](https://ignis.venizia.ai/references/base/bootstrapping)
+- [Build info](https://ignis.venizia.ai/guides/core-concepts/application/build-info)
+- [Runtime boot API removed](https://ignis.venizia.ai/changelogs/2026-09-03-deprecated-boot-api-removed)
+- [Changelogs](https://ignis.venizia.ai/changelogs/)
+- [Source](https://github.com/VENIZIA-AI/ignis/blob/main/packages/boot)
 
-MIT licensed - see [LICENSE.md](LICENSE.md).
-Questions: [GitHub Issues](https://github.com/VENIZIA-AI/ignis/issues) &#8226; developer@venizia.ai
+MIT licensed - see [LICENSE.md](./LICENSE.md).

package/dist/cjs/build-info/common/constants.d.ts

@@ -0,0 +1,20 @@
+import type { TConstValue } from '@venizia/ignis-helpers';
+export declare class BuildInfoFormats {
+    static readonly TS = "ts";
+    static readonly JSON = "json";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(value: string): boolean;
+}
+export type TBuildInfoFormat = TConstValue<typeof BuildInfoFormats>;
+/**
+ * Each field is spelled differently by every CI provider, and `APP_ENV_*` is what this
+ * organisation's pipelines export - so it is read before the generic `APP_BUILD_*` pair and before
+ * anything provider-specific. The first key carrying a non-blank value wins.
+ */
+export declare class BuildInfoEnvironmentKeys {
+    static readonly VERSION: readonly string[];
+    static readonly COMMIT: readonly string[];
+    static readonly BRANCH: readonly string[];
+    static readonly BUILT_AT: readonly string[];
+}
+//# sourceMappingURL=constants.d.ts.map

package/dist/cjs/build-info/common/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/build-info/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,qBAAa,gBAAgB;IAC3B,MAAM,CAAC,QAAQ,CAAC,EAAE,QAAQ;IAC1B,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAE9B,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAyC;IAEnE,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAED,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEpE;;;;GAIG;AACH,qBAAa,wBAAwB;IACnC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAKxC;IAEF,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAMvC;IAEF,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAKvC;IAEF,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAA4C;CACxF"}

package/dist/cjs/build-info/common/constants.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BuildInfoEnvironmentKeys = exports.BuildInfoFormats = void 0;
+class BuildInfoFormats {
+    static { this.TS = 'ts'; }
+    static { this.JSON = 'json'; }
+    static { this.SCHEME_SET = new Set([this.TS, this.JSON]); }
+    static isValid(value) {
+        return this.SCHEME_SET.has(value);
+    }
+}
+exports.BuildInfoFormats = BuildInfoFormats;
+/**
+ * Each field is spelled differently by every CI provider, and `APP_ENV_*` is what this
+ * organisation's pipelines export - so it is read before the generic `APP_BUILD_*` pair and before
+ * anything provider-specific. The first key carrying a non-blank value wins.
+ */
+class BuildInfoEnvironmentKeys {
+    static { this.VERSION = [
+        'APP_ENV_BUILD_VERSION',
+        'APP_BUILD_VERSION',
+        'CI_COMMIT_TAG',
+        'GITHUB_REF_NAME',
+    ]; }
+    static { this.COMMIT = [
+        'APP_ENV_BUILD_COMMIT_TAG',
+        'APP_BUILD_COMMIT',
+        'CI_COMMIT_SHA',
+        'GITHUB_SHA',
+        'COMMIT_SHA',
+    ]; }
+    static { this.BRANCH = [
+        'APP_BUILD_BRANCH',
+        'CI_COMMIT_REF_NAME',
+        'GITHUB_REF_NAME',
+        'BRANCH_NAME',
+    ]; }
+    static { this.BUILT_AT = ['APP_ENV_BUILD_DATE', 'APP_BUILD_DATE']; }
+}
+exports.BuildInfoEnvironmentKeys = BuildInfoEnvironmentKeys;
+//# sourceMappingURL=constants.js.map

package/dist/cjs/build-info/common/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/build-info/common/constants.ts"],"names":[],"mappings":";;;AAEA,MAAa,gBAAgB;aACX,OAAE,GAAG,IAAI,CAAC;aACV,SAAI,GAAG,MAAM,CAAC;aAEd,eAAU,GAAG,IAAI,GAAG,CAAS,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAEnE,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AARH,4CASC;AAID;;;;GAIG;AACH,MAAa,wBAAwB;aACnB,YAAO,GAAsB;QAC3C,uBAAuB;QACvB,mBAAmB;QACnB,eAAe;QACf,iBAAiB;KAClB,CAAC;aAEc,WAAM,GAAsB;QAC1C,0BAA0B;QAC1B,kBAAkB;QAClB,eAAe;QACf,YAAY;QACZ,YAAY;KACb,CAAC;aAEc,WAAM,GAAsB;QAC1C,kBAAkB;QAClB,oBAAoB;QACpB,iBAAiB;QACjB,aAAa;KACd,CAAC;aAEc,aAAQ,GAAsB,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAC;;AAvBzF,4DAwBC"}

package/dist/cjs/build-info/common/index.d.ts

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

package/dist/cjs/build-info/common/index.d.ts.map

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

package/dist/cjs/build-info/common/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./constants"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/build-info/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/build-info/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,0CAAwB"}

package/dist/cjs/build-info/common/types.d.ts

@@ -0,0 +1,16 @@
+import type { TBuildInfoRecord } from '@venizia/ignis-helpers/core';
+import type { TBuildInfoFormat } from './constants';
+export interface IBuildInfoOptions {
+    out: string;
+    /** Where `package.json` is read from and where `git` is asked; default the cwd. */
+    root?: string;
+    format?: TBuildInfoFormat;
+    /** Name of the exported constant in `ts` format; default `BUILD_INFO`. */
+    exportName?: string;
+}
+export interface IBuildInfoResult {
+    buildInfo: TBuildInfoRecord;
+    content: string;
+    out: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/build-info/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/build-info/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,gBAAgB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb"}

package/dist/cjs/build-info/common/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/build-info/common/types.js.map

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

package/dist/cjs/build-info/emitter.d.ts

@@ -0,0 +1,12 @@
+import type { TBuildInfoRecord } from '@venizia/ignis-helpers/core';
+import { type TBuildInfoFormat } from './common';
+/** Renders the stamp: a static `ts` const a bundler bakes in, or the same record as `json` for a Vite app or a Tauri shell. */
+export declare class BuildInfoEmitter {
+    static readonly DEFAULT_EXPORT_NAME = "BUILD_INFO";
+    static render(opts: {
+        buildInfo: TBuildInfoRecord;
+        format: TBuildInfoFormat;
+        exportName: string;
+    }): string;
+}
+//# sourceMappingURL=emitter.d.ts.map

package/dist/cjs/build-info/emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../../src/build-info/emitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEnE,+HAA+H;AAC/H,qBAAa,gBAAgB;IAC3B,MAAM,CAAC,QAAQ,CAAC,mBAAmB,gBAAgB;IAEnD,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QAClB,SAAS,EAAE,gBAAgB,CAAC;QAC5B,MAAM,EAAE,gBAAgB,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,MAAM;CAmBX"}

package/dist/cjs/build-info/emitter.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BuildInfoEmitter = void 0;
+const common_1 = require("./common");
+/** Renders the stamp: a static `ts` const a bundler bakes in, or the same record as `json` for a Vite app or a Tauri shell. */
+class BuildInfoEmitter {
+    static { this.DEFAULT_EXPORT_NAME = 'BUILD_INFO'; }
+    static render(opts) {
+        const { buildInfo, format, exportName } = opts;
+        if (format === common_1.BuildInfoFormats.JSON) {
+            return `${JSON.stringify(buildInfo, null, 2)}\n`;
+        }
+        const fields = Object.entries(buildInfo)
+            .map(([key, value]) => `  ${key}: ${JSON.stringify(value)},`)
+            .join('\n');
+        return [
+            '// AUTO-GENERATED by @venizia/ignis-boot - do not edit. Regenerate: ignis-build-info generate',
+            `export const ${exportName} = {`,
+            fields,
+            '} as const;',
+            '',
+        ].join('\n');
+    }
+}
+exports.BuildInfoEmitter = BuildInfoEmitter;
+//# sourceMappingURL=emitter.js.map

package/dist/cjs/build-info/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../../../src/build-info/emitter.ts"],"names":[],"mappings":";;;AACA,qCAAmE;AAEnE,+HAA+H;AAC/H,MAAa,gBAAgB;aACX,wBAAmB,GAAG,YAAY,CAAC;IAEnD,MAAM,CAAC,MAAM,CAAC,IAIb;QACC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QAE/C,IAAI,MAAM,KAAK,yBAAgB,CAAC,IAAI,EAAE,CAAC;YACrC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;QACnD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;aACrC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC;aAC5D,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,OAAO;YACL,+FAA+F;YAC/F,gBAAgB,UAAU,MAAM;YAChC,MAAM;YACN,aAAa;YACb,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;;AAzBH,4CA0BC"}

package/dist/cjs/build-info/index.d.ts

@@ -0,0 +1,10 @@
+import { type IBuildInfoOptions, type IBuildInfoResult } from './common';
+/**
+ * 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 declare const generateBuildInfo: (opts: IBuildInfoOptions) => Promise<IBuildInfoResult>;
+export * from './common';
+export * from './emitter';
+export * from './resolver';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/build-info/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/build-info/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAI3F;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAU,MAAM,iBAAiB,KAAG,OAAO,CAAC,gBAAgB,CAazF,CAAC;AAEF,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}

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

@@ -0,0 +1,43 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateBuildInfo = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const common_1 = require("./common");
+const emitter_1 = require("./emitter");
+const resolver_1 = require("./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.
+ */
+const generateBuildInfo = async (opts) => {
+    const buildInfo = await resolver_1.BuildInfoResolver.getInstance().resolve({ root: opts.root });
+    const content = emitter_1.BuildInfoEmitter.render({
+        buildInfo,
+        format: opts.format ?? common_1.BuildInfoFormats.TS,
+        exportName: opts.exportName ?? emitter_1.BuildInfoEmitter.DEFAULT_EXPORT_NAME,
+    });
+    const out = (0, node_path_1.resolve)(opts.out);
+    (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(out), { recursive: true });
+    (0, node_fs_1.writeFileSync)(out, content);
+    return { buildInfo, content, out };
+};
+exports.generateBuildInfo = generateBuildInfo;
+__exportStar(require("./common"), exports);
+__exportStar(require("./emitter"), exports);
+__exportStar(require("./resolver"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/build-info/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,qCAAmD;AACnD,yCAA6C;AAC7C,qCAA2F;AAC3F,uCAA6C;AAC7C,yCAA+C;AAE/C;;;GAGG;AACI,MAAM,iBAAiB,GAAG,KAAK,EAAE,IAAuB,EAA6B,EAAE;IAC5F,MAAM,SAAS,GAAG,MAAM,4BAAiB,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACrF,MAAM,OAAO,GAAG,0BAAgB,CAAC,MAAM,CAAC;QACtC,SAAS;QACT,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,yBAAgB,CAAC,EAAE;QAC1C,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,0BAAgB,CAAC,mBAAmB;KACpE,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,IAAA,mBAAO,EAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAA,mBAAS,EAAC,IAAA,mBAAO,EAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,IAAA,uBAAa,EAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAE5B,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;AACrC,CAAC,CAAC;AAbW,QAAA,iBAAiB,qBAa5B;AAEF,2CAAyB;AACzB,4CAA0B;AAC1B,6CAA2B"}

package/dist/cjs/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/cjs/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"}