@venizia/ignis-boot 0.3.2 → 0.3.3

package/README.md

@@ -1,6 +1,6 @@
 # @venizia/ignis-boot
 
-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.
+Build-time tools for an IGNIS application: `ignis-artifacts` writes one static file that registers your decorated classes, and `BuildInfoStamp` stamps the build. Install it as a devDependency of the application, or as a dependency if production runs the source unbundled.
 
 ## Install
 
@@ -101,22 +101,32 @@ A class lands in the index when all of these hold. The scanner logs a warning fo
 
 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`
+## The build stamp
 
-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.
+A running service cannot say which commit it is. `BuildInfoStamp` (from `@venizia/ignis-boot/build-info`) bakes the commit, branch and build time into a compiled binary, and resolves them from git when you run from source. Nothing is generated, so a clean checkout typechecks, tests and boots.
 
+```typescript
+// scripts/compile.ts
+import { BunCompiler } from '@venizia/dev-configs/compilers';
+import { BuildInfoStamp } from '@venizia/ignis-boot/build-info';
+
+await BunCompiler.compile({
+  entrypoint: './src/index.ts',
+  outfile: './dist/service',
+  define: await BuildInfoStamp.define(),
+});
 ```
-ignis-build-info generate [--out src/_build_info.ts] [--root .] [--format ts|json] [--export BUILD_INFO]
+
+```typescript
+// src/index.ts
+import { BuildInfoStamp } from '@venizia/ignis-boot/build-info';
+
+await BuildInfoStamp.register();
 ```
 
-| 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 |
+`register()` uses the baked stamp when the compile defined it, else `BuildInfoResolver`, then calls `BuildInfoRegistry.set`. It sets `commit`, `branch` and `builtAt`; `service` and `version` stay with `getAppInfo()`. The health-check component's `/stats` route reports it.
 
-Each field reads the environment first (first non-blank key wins), then its fallback. A field nothing resolves reads `unspecified`.
+The resolver reads each field from the environment first (first non-blank key wins), then its fallback. A field nothing resolves reads `unspecified`.
 
 | Field | Environment keys, in order | Fallback |
 |---|---|---|
@@ -124,16 +134,7 @@ Each field reads the environment first (first non-blank key wins), then its fall
 | `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 });
-```
+| `builtAt` | `APP_ENV_BUILD_DATE`, `APP_BUILD_DATE` | the time the stamp was resolved |
 
 ## Entry points
 
@@ -141,12 +142,11 @@ BuildInfoRegistry.set({ buildInfo: BUILD_INFO });
 |---|---|---|
 | `@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/build-info` | `BuildInfoStamp`, `BuildInfoResolver`, `BuildInfoEnvironmentKeys` | none |
 
 | Binary | File |
 |---|---|
 | `ignis-artifacts` | `dist/cjs/clis/artifacts.js` |
-| `ignis-build-info` | `dist/cjs/clis/build-info.js` |
 
 The package ships CommonJS and ESM builds. The programmatic API mirrors the CLI:
 

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

@@ -1,11 +1,3 @@
-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

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

@@ -1 +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"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/build-info/common/constants.ts"],"names":[],"mappings":"AAAA;;;;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

@@ -1,15 +1,6 @@
 "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;
+exports.BuildInfoEnvironmentKeys = void 0;
 /**
  * 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

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

@@ -1 +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","sourcesContent":["import type { TConstValue } from '@venizia/ignis-helpers';\n\nexport class BuildInfoFormats {\n  static readonly TS = 'ts';\n  static readonly JSON = 'json';\n\n  static readonly SCHEME_SET = new Set<string>([this.TS, this.JSON]);\n\n  static isValid(value: string): boolean {\n    return this.SCHEME_SET.has(value);\n  }\n}\n\nexport type TBuildInfoFormat = TConstValue<typeof BuildInfoFormats>;\n\n/**\n * Each field is spelled differently by every CI provider, and `APP_ENV_*` is what this\n * organisation's pipelines export - so it is read before the generic `APP_BUILD_*` pair and before\n * anything provider-specific. The first key carrying a non-blank value wins.\n */\nexport class BuildInfoEnvironmentKeys {\n  static readonly VERSION: readonly string[] = [\n    'APP_ENV_BUILD_VERSION',\n    'APP_BUILD_VERSION',\n    'CI_COMMIT_TAG',\n    'GITHUB_REF_NAME',\n  ];\n\n  static readonly COMMIT: readonly string[] = [\n    'APP_ENV_BUILD_COMMIT_TAG',\n    'APP_BUILD_COMMIT',\n    'CI_COMMIT_SHA',\n    'GITHUB_SHA',\n    'COMMIT_SHA',\n  ];\n\n  static readonly BRANCH: readonly string[] = [\n    'APP_BUILD_BRANCH',\n    'CI_COMMIT_REF_NAME',\n    'GITHUB_REF_NAME',\n    'BRANCH_NAME',\n  ];\n\n  static readonly BUILT_AT: readonly string[] = ['APP_ENV_BUILD_DATE', 'APP_BUILD_DATE'];\n}\n"]}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/build-info/common/constants.ts"],"names":[],"mappings":";;;AAAA;;;;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","sourcesContent":["/**\n * Each field is spelled differently by every CI provider, and `APP_ENV_*` is what this\n * organisation's pipelines export - so it is read before the generic `APP_BUILD_*` pair and before\n * anything provider-specific. The first key carrying a non-blank value wins.\n */\nexport class BuildInfoEnvironmentKeys {\n  static readonly VERSION: readonly string[] = [\n    'APP_ENV_BUILD_VERSION',\n    'APP_BUILD_VERSION',\n    'CI_COMMIT_TAG',\n    'GITHUB_REF_NAME',\n  ];\n\n  static readonly COMMIT: readonly string[] = [\n    'APP_ENV_BUILD_COMMIT_TAG',\n    'APP_BUILD_COMMIT',\n    'CI_COMMIT_SHA',\n    'GITHUB_SHA',\n    'COMMIT_SHA',\n  ];\n\n  static readonly BRANCH: readonly string[] = [\n    'APP_BUILD_BRANCH',\n    'CI_COMMIT_REF_NAME',\n    'GITHUB_REF_NAME',\n    'BRANCH_NAME',\n  ];\n\n  static readonly BUILT_AT: readonly string[] = ['APP_ENV_BUILD_DATE', 'APP_BUILD_DATE'];\n}\n"]}

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

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

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/build-info/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

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

@@ -15,5 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/build-info/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,0CAAwB","sourcesContent":["export * from './constants';\nexport * from './types';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/build-info/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B","sourcesContent":["export * from './constants';\n"]}

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

@@ -1,10 +1,4 @@
-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';
+export * from './stamp';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/build-info/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC"}

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

@@ -14,30 +14,7 @@ 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);
+__exportStar(require("./stamp"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +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","sourcesContent":["import { mkdirSync, writeFileSync } from 'node:fs';\nimport { dirname, resolve } from 'node:path';\nimport { BuildInfoFormats, type IBuildInfoOptions, type IBuildInfoResult } from './common';\nimport { BuildInfoEmitter } from './emitter';\nimport { BuildInfoResolver } from './resolver';\n\n/**\n * Writes the stamp. Unlike the artifact index this ALWAYS writes: `builtAt` changes every run, so\n * an unchanged-content short-circuit would be dead code that hides a stale timestamp.\n */\nexport const generateBuildInfo = async (opts: IBuildInfoOptions): Promise<IBuildInfoResult> => {\n  const buildInfo = await BuildInfoResolver.getInstance().resolve({ root: opts.root });\n  const content = BuildInfoEmitter.render({\n    buildInfo,\n    format: opts.format ?? BuildInfoFormats.TS,\n    exportName: opts.exportName ?? BuildInfoEmitter.DEFAULT_EXPORT_NAME,\n  });\n\n  const out = resolve(opts.out);\n  mkdirSync(dirname(out), { recursive: true });\n  writeFileSync(out, content);\n\n  return { buildInfo, content, out };\n};\n\nexport * from './common';\nexport * from './emitter';\nexport * from './resolver';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/build-info/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,6CAA2B;AAC3B,0CAAwB","sourcesContent":["export * from './common';\nexport * from './resolver';\nexport * from './stamp';\n"]}

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

@@ -0,0 +1,22 @@
+/**
+ * The build stamp, decided where it is cheap: a compile bakes it into the binary, a run from
+ * source resolves it from git when the application starts.
+ *
+ * `define()` is for the compile script, `register()` for the entrypoint. A binary that carries the
+ * stamp never runs git; the resolver is the only code here, and it needs no TypeScript scanner.
+ */
+export declare class BuildInfoStamp {
+    /** The identifier `define()` replaces in the bundle and `register()` reads. */
+    static readonly GLOBAL_NAME = "IGNIS_BUILD_INFO";
+    /** The `define` record for a compile: resolves the stamp now and returns it under {@link BuildInfoStamp.GLOBAL_NAME}. */
+    static define(opts?: {
+        root?: string;
+    }): Promise<Record<string, string>>;
+    /**
+     * Registers the stamp in {@link BuildInfoRegistry}: the baked value when the compile defined it,
+     * else the resolver's. Only `commit`, `branch` and `builtAt` are set - `service` and `version`
+     * stay with the application's `getAppInfo()`, which the health reporter reads when they are absent.
+     */
+    static register(): Promise<void>;
+}
+//# sourceMappingURL=stamp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stamp.d.ts","sourceRoot":"","sources":["../../../src/build-info/stamp.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,qBAAa,cAAc;IACzB,+EAA+E;IAC/E,MAAM,CAAC,QAAQ,CAAC,WAAW,sBAAsB;IAEjD,yHAAyH;WAC5G,MAAM,CAAC,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAK9E;;;;OAIG;WACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAUvC"}

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

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BuildInfoStamp = void 0;
+const core_1 = require("@venizia/ignis-helpers/core");
+const resolver_1 = require("./resolver");
+/**
+ * The build stamp, decided where it is cheap: a compile bakes it into the binary, a run from
+ * source resolves it from git when the application starts.
+ *
+ * `define()` is for the compile script, `register()` for the entrypoint. A binary that carries the
+ * stamp never runs git; the resolver is the only code here, and it needs no TypeScript scanner.
+ */
+class BuildInfoStamp {
+    /** The identifier `define()` replaces in the bundle and `register()` reads. */
+    static { this.GLOBAL_NAME = 'IGNIS_BUILD_INFO'; }
+    /** The `define` record for a compile: resolves the stamp now and returns it under {@link BuildInfoStamp.GLOBAL_NAME}. */
+    static async define(opts) {
+        const stamp = await resolver_1.BuildInfoResolver.getInstance().resolve(opts);
+        return { [BuildInfoStamp.GLOBAL_NAME]: JSON.stringify(stamp) };
+    }
+    /**
+     * Registers the stamp in {@link BuildInfoRegistry}: the baked value when the compile defined it,
+     * else the resolver's. Only `commit`, `branch` and `builtAt` are set - `service` and `version`
+     * stay with the application's `getAppInfo()`, which the health reporter reads when they are absent.
+     */
+    static async register() {
+        const stamp = typeof IGNIS_BUILD_INFO !== 'undefined'
+            ? IGNIS_BUILD_INFO
+            : await resolver_1.BuildInfoResolver.getInstance().resolve();
+        core_1.BuildInfoRegistry.set({
+            buildInfo: { commit: stamp.commit, branch: stamp.branch, builtAt: stamp.builtAt },
+        });
+    }
+}
+exports.BuildInfoStamp = BuildInfoStamp;
+//# sourceMappingURL=stamp.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stamp.js","sourceRoot":"","sources":["../../../src/build-info/stamp.ts"],"names":[],"mappings":";;;AAAA,sDAAuF;AACvF,yCAA+C;AAM/C;;;;;;GAMG;AACH,MAAa,cAAc;IACzB,+EAA+E;aAC/D,gBAAW,GAAG,kBAAkB,CAAC;IAEjD,yHAAyH;IACzH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAwB;QAC1C,MAAM,KAAK,GAAG,MAAM,4BAAiB,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClE,OAAO,EAAE,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;IACjE,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,QAAQ;QACnB,MAAM,KAAK,GACT,OAAO,gBAAgB,KAAK,WAAW;YACrC,CAAC,CAAC,gBAAgB;YAClB,CAAC,CAAC,MAAM,4BAAiB,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,CAAC;QAEtD,wBAAiB,CAAC,GAAG,CAAC;YACpB,SAAS,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE;SAClF,CAAC,CAAC;IACL,CAAC;;AAxBH,wCAyBC","sourcesContent":["import { BuildInfoRegistry, type TBuildInfoRecord } from '@venizia/ignis-helpers/core';\nimport { BuildInfoResolver } from './resolver';\n\n// A compile bakes the stamp in under this name (`define`); a run from source has no such name.\n// The identifier below must spell the same as `BuildInfoStamp.GLOBAL_NAME`.\ndeclare const IGNIS_BUILD_INFO: TBuildInfoRecord | undefined;\n\n/**\n * The build stamp, decided where it is cheap: a compile bakes it into the binary, a run from\n * source resolves it from git when the application starts.\n *\n * `define()` is for the compile script, `register()` for the entrypoint. A binary that carries the\n * stamp never runs git; the resolver is the only code here, and it needs no TypeScript scanner.\n */\nexport class BuildInfoStamp {\n  /** The identifier `define()` replaces in the bundle and `register()` reads. */\n  static readonly GLOBAL_NAME = 'IGNIS_BUILD_INFO';\n\n  /** The `define` record for a compile: resolves the stamp now and returns it under {@link BuildInfoStamp.GLOBAL_NAME}. */\n  static async define(opts?: { root?: string }): Promise<Record<string, string>> {\n    const stamp = await BuildInfoResolver.getInstance().resolve(opts);\n    return { [BuildInfoStamp.GLOBAL_NAME]: JSON.stringify(stamp) };\n  }\n\n  /**\n   * Registers the stamp in {@link BuildInfoRegistry}: the baked value when the compile defined it,\n   * else the resolver's. Only `commit`, `branch` and `builtAt` are set - `service` and `version`\n   * stay with the application's `getAppInfo()`, which the health reporter reads when they are absent.\n   */\n  static async register(): Promise<void> {\n    const stamp =\n      typeof IGNIS_BUILD_INFO !== 'undefined'\n        ? IGNIS_BUILD_INFO\n        : await BuildInfoResolver.getInstance().resolve();\n\n    BuildInfoRegistry.set({\n      buildInfo: { commit: stamp.commit, branch: stamp.branch, builtAt: stamp.builtAt },\n    });\n  }\n}\n"]}

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

@@ -1,11 +1,3 @@
-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

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

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

@@ -1,11 +1,3 @@
-export 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);
-    }
-}
 /**
  * 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

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

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/build-info/common/constants.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,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;;AAKH;;;;GAIG;AACH,MAAM,OAAO,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","sourcesContent":["import type { TConstValue } from '@venizia/ignis-helpers';\n\nexport class BuildInfoFormats {\n  static readonly TS = 'ts';\n  static readonly JSON = 'json';\n\n  static readonly SCHEME_SET = new Set<string>([this.TS, this.JSON]);\n\n  static isValid(value: string): boolean {\n    return this.SCHEME_SET.has(value);\n  }\n}\n\nexport type TBuildInfoFormat = TConstValue<typeof BuildInfoFormats>;\n\n/**\n * Each field is spelled differently by every CI provider, and `APP_ENV_*` is what this\n * organisation's pipelines export - so it is read before the generic `APP_BUILD_*` pair and before\n * anything provider-specific. The first key carrying a non-blank value wins.\n */\nexport class BuildInfoEnvironmentKeys {\n  static readonly VERSION: readonly string[] = [\n    'APP_ENV_BUILD_VERSION',\n    'APP_BUILD_VERSION',\n    'CI_COMMIT_TAG',\n    'GITHUB_REF_NAME',\n  ];\n\n  static readonly COMMIT: readonly string[] = [\n    'APP_ENV_BUILD_COMMIT_TAG',\n    'APP_BUILD_COMMIT',\n    'CI_COMMIT_SHA',\n    'GITHUB_SHA',\n    'COMMIT_SHA',\n  ];\n\n  static readonly BRANCH: readonly string[] = [\n    'APP_BUILD_BRANCH',\n    'CI_COMMIT_REF_NAME',\n    'GITHUB_REF_NAME',\n    'BRANCH_NAME',\n  ];\n\n  static readonly BUILT_AT: readonly string[] = ['APP_ENV_BUILD_DATE', 'APP_BUILD_DATE'];\n}\n"]}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/build-info/common/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,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","sourcesContent":["/**\n * Each field is spelled differently by every CI provider, and `APP_ENV_*` is what this\n * organisation's pipelines export - so it is read before the generic `APP_BUILD_*` pair and before\n * anything provider-specific. The first key carrying a non-blank value wins.\n */\nexport class BuildInfoEnvironmentKeys {\n  static readonly VERSION: readonly string[] = [\n    'APP_ENV_BUILD_VERSION',\n    'APP_BUILD_VERSION',\n    'CI_COMMIT_TAG',\n    'GITHUB_REF_NAME',\n  ];\n\n  static readonly COMMIT: readonly string[] = [\n    'APP_ENV_BUILD_COMMIT_TAG',\n    'APP_BUILD_COMMIT',\n    'CI_COMMIT_SHA',\n    'GITHUB_SHA',\n    'COMMIT_SHA',\n  ];\n\n  static readonly BRANCH: readonly string[] = [\n    'APP_BUILD_BRANCH',\n    'CI_COMMIT_REF_NAME',\n    'GITHUB_REF_NAME',\n    'BRANCH_NAME',\n  ];\n\n  static readonly BUILT_AT: readonly string[] = ['APP_ENV_BUILD_DATE', 'APP_BUILD_DATE'];\n}\n"]}

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

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

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/build-info/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/build-info/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC","sourcesContent":["export * from './constants';\nexport * from './types';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/build-info/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC","sourcesContent":["export * from './constants';\n"]}

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

@@ -1,10 +1,4 @@
-import { type IBuildInfoOptions, type IBuildInfoResult } from './common/index.js';
-/**
- * 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/index.js';
-export * from './emitter.js';
 export * from './resolver.js';
+export * from './stamp.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/build-info/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC"}

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

@@ -1,25 +1,4 @@
-import { mkdirSync, writeFileSync } from 'node:fs';
-import { dirname, resolve } from 'node:path';
-import { BuildInfoFormats } from './common/index.js';
-import { BuildInfoEmitter } from './emitter.js';
-import { BuildInfoResolver } from './resolver.js';
-/**
- * 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/index.js';
-export * from './emitter.js';
 export * from './resolver.js';
+export * from './stamp.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +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","sourcesContent":["import { mkdirSync, writeFileSync } from 'node:fs';\nimport { dirname, resolve } from 'node:path';\nimport { BuildInfoFormats, type IBuildInfoOptions, type IBuildInfoResult } from './common';\nimport { BuildInfoEmitter } from './emitter';\nimport { BuildInfoResolver } from './resolver';\n\n/**\n * Writes the stamp. Unlike the artifact index this ALWAYS writes: `builtAt` changes every run, so\n * an unchanged-content short-circuit would be dead code that hides a stale timestamp.\n */\nexport const generateBuildInfo = async (opts: IBuildInfoOptions): Promise<IBuildInfoResult> => {\n  const buildInfo = await BuildInfoResolver.getInstance().resolve({ root: opts.root });\n  const content = BuildInfoEmitter.render({\n    buildInfo,\n    format: opts.format ?? BuildInfoFormats.TS,\n    exportName: opts.exportName ?? BuildInfoEmitter.DEFAULT_EXPORT_NAME,\n  });\n\n  const out = resolve(opts.out);\n  mkdirSync(dirname(out), { recursive: true });\n  writeFileSync(out, content);\n\n  return { buildInfo, content, out };\n};\n\nexport * from './common';\nexport * from './emitter';\nexport * from './resolver';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/build-info/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC","sourcesContent":["export * from './common';\nexport * from './resolver';\nexport * from './stamp';\n"]}

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

@@ -0,0 +1,22 @@
+/**
+ * The build stamp, decided where it is cheap: a compile bakes it into the binary, a run from
+ * source resolves it from git when the application starts.
+ *
+ * `define()` is for the compile script, `register()` for the entrypoint. A binary that carries the
+ * stamp never runs git; the resolver is the only code here, and it needs no TypeScript scanner.
+ */
+export declare class BuildInfoStamp {
+    /** The identifier `define()` replaces in the bundle and `register()` reads. */
+    static readonly GLOBAL_NAME = "IGNIS_BUILD_INFO";
+    /** The `define` record for a compile: resolves the stamp now and returns it under {@link BuildInfoStamp.GLOBAL_NAME}. */
+    static define(opts?: {
+        root?: string;
+    }): Promise<Record<string, string>>;
+    /**
+     * Registers the stamp in {@link BuildInfoRegistry}: the baked value when the compile defined it,
+     * else the resolver's. Only `commit`, `branch` and `builtAt` are set - `service` and `version`
+     * stay with the application's `getAppInfo()`, which the health reporter reads when they are absent.
+     */
+    static register(): Promise<void>;
+}
+//# sourceMappingURL=stamp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stamp.d.ts","sourceRoot":"","sources":["../../../src/build-info/stamp.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,qBAAa,cAAc;IACzB,+EAA+E;IAC/E,MAAM,CAAC,QAAQ,CAAC,WAAW,sBAAsB;IAEjD,yHAAyH;WAC5G,MAAM,CAAC,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAK9E;;;;OAIG;WACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAUvC"}

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

@@ -0,0 +1,32 @@
+import { BuildInfoRegistry } from '@venizia/ignis-helpers/core';
+import { BuildInfoResolver } from './resolver.js';
+/**
+ * The build stamp, decided where it is cheap: a compile bakes it into the binary, a run from
+ * source resolves it from git when the application starts.
+ *
+ * `define()` is for the compile script, `register()` for the entrypoint. A binary that carries the
+ * stamp never runs git; the resolver is the only code here, and it needs no TypeScript scanner.
+ */
+export class BuildInfoStamp {
+    /** The identifier `define()` replaces in the bundle and `register()` reads. */
+    static { this.GLOBAL_NAME = 'IGNIS_BUILD_INFO'; }
+    /** The `define` record for a compile: resolves the stamp now and returns it under {@link BuildInfoStamp.GLOBAL_NAME}. */
+    static async define(opts) {
+        const stamp = await BuildInfoResolver.getInstance().resolve(opts);
+        return { [BuildInfoStamp.GLOBAL_NAME]: JSON.stringify(stamp) };
+    }
+    /**
+     * Registers the stamp in {@link BuildInfoRegistry}: the baked value when the compile defined it,
+     * else the resolver's. Only `commit`, `branch` and `builtAt` are set - `service` and `version`
+     * stay with the application's `getAppInfo()`, which the health reporter reads when they are absent.
+     */
+    static async register() {
+        const stamp = typeof IGNIS_BUILD_INFO !== 'undefined'
+            ? IGNIS_BUILD_INFO
+            : await BuildInfoResolver.getInstance().resolve();
+        BuildInfoRegistry.set({
+            buildInfo: { commit: stamp.commit, branch: stamp.branch, builtAt: stamp.builtAt },
+        });
+    }
+}
+//# sourceMappingURL=stamp.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stamp.js","sourceRoot":"","sources":["../../../src/build-info/stamp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAyB,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAM/C;;;;;;GAMG;AACH,MAAM,OAAO,cAAc;IACzB,+EAA+E;aAC/D,gBAAW,GAAG,kBAAkB,CAAC;IAEjD,yHAAyH;IACzH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAwB;QAC1C,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClE,OAAO,EAAE,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;IACjE,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,QAAQ;QACnB,MAAM,KAAK,GACT,OAAO,gBAAgB,KAAK,WAAW;YACrC,CAAC,CAAC,gBAAgB;YAClB,CAAC,CAAC,MAAM,iBAAiB,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,CAAC;QAEtD,iBAAiB,CAAC,GAAG,CAAC;YACpB,SAAS,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE;SAClF,CAAC,CAAC;IACL,CAAC","sourcesContent":["import { BuildInfoRegistry, type TBuildInfoRecord } from '@venizia/ignis-helpers/core';\nimport { BuildInfoResolver } from './resolver';\n\n// A compile bakes the stamp in under this name (`define`); a run from source has no such name.\n// The identifier below must spell the same as `BuildInfoStamp.GLOBAL_NAME`.\ndeclare const IGNIS_BUILD_INFO: TBuildInfoRecord | undefined;\n\n/**\n * The build stamp, decided where it is cheap: a compile bakes it into the binary, a run from\n * source resolves it from git when the application starts.\n *\n * `define()` is for the compile script, `register()` for the entrypoint. A binary that carries the\n * stamp never runs git; the resolver is the only code here, and it needs no TypeScript scanner.\n */\nexport class BuildInfoStamp {\n  /** The identifier `define()` replaces in the bundle and `register()` reads. */\n  static readonly GLOBAL_NAME = 'IGNIS_BUILD_INFO';\n\n  /** The `define` record for a compile: resolves the stamp now and returns it under {@link BuildInfoStamp.GLOBAL_NAME}. */\n  static async define(opts?: { root?: string }): Promise<Record<string, string>> {\n    const stamp = await BuildInfoResolver.getInstance().resolve(opts);\n    return { [BuildInfoStamp.GLOBAL_NAME]: JSON.stringify(stamp) };\n  }\n\n  /**\n   * Registers the stamp in {@link BuildInfoRegistry}: the baked value when the compile defined it,\n   * else the resolver's. Only `commit`, `branch` and `builtAt` are set - `service` and `version`\n   * stay with the application's `getAppInfo()`, which the health reporter reads when they are absent.\n   */\n  static async register(): Promise<void> {\n    const stamp =\n      typeof IGNIS_BUILD_INFO !== 'undefined'\n        ? IGNIS_BUILD_INFO\n        : await BuildInfoResolver.getInstance().resolve();\n\n    BuildInfoRegistry.set({\n      buildInfo: { commit: stamp.commit, branch: stamp.branch, builtAt: stamp.builtAt },\n    });\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venizia/ignis-boot",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Build-time artifact index generator for IGNIS applications: scans decorated classes with the TypeScript AST and emits one static registration file per package, so bun build --compile sees plain imports.",
   "keywords": [
     "artifact-index",
@@ -97,12 +97,12 @@
     "test:watch": "NODE_ENV=test bun test --watch --env-file=.env.test"
   },
   "dependencies": {
-    "@venizia/ignis-helpers": "0.3.2",
-    "@venizia/ignis-inversion": "0.3.2"
+    "@venizia/ignis-helpers": "0.3.3",
+    "@venizia/ignis-inversion": "0.3.4"
   },
   "devDependencies": {
     "@types/bun": "^1.4.1",
-    "@venizia/dev-configs": "0.3.1",
+    "@venizia/dev-configs": "0.3.3",
     "eslint": "^10.10.0",
     "oxfmt": "0.73.0",
     "oxlint": "1.88.0",
@@ -114,7 +114,6 @@
     "typescript": "^5.0.0 || ^6.0.0"
   },
   "bin": {
-    "ignis-artifacts": "./dist/cjs/clis/artifacts.js",
-    "ignis-build-info": "./dist/cjs/clis/build-info.js"
+    "ignis-artifacts": "./dist/cjs/clis/artifacts.js"
   }
 }

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

@@ -1,16 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/build-info/common/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { TBuildInfoRecord } from '@venizia/ignis-helpers/core';\nimport type { TBuildInfoFormat } from './constants';\n\nexport interface IBuildInfoOptions {\n  out: string;\n  /** Where `package.json` is read from and where `git` is asked; default the cwd. */\n  root?: string;\n  format?: TBuildInfoFormat;\n  /** Name of the exported constant in `ts` format; default `BUILD_INFO`. */\n  exportName?: string;\n}\n\nexport interface IBuildInfoResult {\n  buildInfo: TBuildInfoRecord;\n  content: string;\n  out: string;\n}\n"]}

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

@@ -1,12 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,26 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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","sourcesContent":["import type { TBuildInfoRecord } from '@venizia/ignis-helpers/core';\nimport { BuildInfoFormats, type TBuildInfoFormat } from './common';\n\n/** 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. */\nexport class BuildInfoEmitter {\n  static readonly DEFAULT_EXPORT_NAME = 'BUILD_INFO';\n\n  static render(opts: {\n    buildInfo: TBuildInfoRecord;\n    format: TBuildInfoFormat;\n    exportName: string;\n  }): string {\n    const { buildInfo, format, exportName } = opts;\n\n    if (format === BuildInfoFormats.JSON) {\n      return `${JSON.stringify(buildInfo, null, 2)}\\n`;\n    }\n\n    const fields = Object.entries(buildInfo)\n      .map(([key, value]) => `  ${key}: ${JSON.stringify(value)},`)\n      .join('\\n');\n\n    return [\n      '// AUTO-GENERATED by @venizia/ignis-boot - do not edit. Regenerate: ignis-build-info generate',\n      `export const ${exportName} = {`,\n      fields,\n      '} as const;',\n      '',\n    ].join('\\n');\n  }\n}\n"]}

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

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

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

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

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

@@ -1,48 +0,0 @@
-#!/usr/bin/env bun
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-require("../common/install-quiet-logger");
-const node_util_1 = require("node:util");
-const build_info_1 = require("../build-info");
-const USAGE = 'ignis-build-info generate [--out src/_build_info.ts] [--root .] [--format ts|json] [--export BUILD_INFO]';
-const { positionals, values } = (0, node_util_1.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: build_info_1.BuildInfoFormats.TS },
-        export: { type: 'string', default: build_info_1.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 (!build_info_1.BuildInfoFormats.isValid(values.format)) {
-        console.error(`invalid --format '${values.format}' | expected one of: ${[...build_info_1.BuildInfoFormats.SCHEME_SET].join(', ')}`);
-        return 1;
-    }
-    // Narrowed by comparison, never asserted: `isValid` above already refused everything else.
-    const format = values.format === build_info_1.BuildInfoFormats.JSON ? build_info_1.BuildInfoFormats.JSON : build_info_1.BuildInfoFormats.TS;
-    const result = await (0, build_info_1.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/cjs/clis/build-info.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"build-info.js","sourceRoot":"","sources":["../../../src/clis/build-info.ts"],"names":[],"mappings":";;;AACA,0CAAwC;AACxC,yCAAsC;AACtC,8CAAsF;AAEtF,MAAM,KAAK,GACT,0GAA0G,CAAC;AAE7G,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAA,qBAAS,EAAC;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,6BAAgB,CAAC,EAAE,EAAE;QACxD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,6BAAgB,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,6BAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7C,OAAO,CAAC,KAAK,CACX,qBAAqB,MAAM,CAAC,MAAM,wBAAwB,CAAC,GAAG,6BAAgB,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,6BAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,6BAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,6BAAgB,CAAC,EAAE,CAAC;IAExF,MAAM,MAAM,GAAG,MAAM,IAAA,8BAAiB,EAAC;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","sourcesContent":["#!/usr/bin/env bun\nimport '../common/install-quiet-logger';\nimport { parseArgs } from 'node:util';\nimport { BuildInfoEmitter, BuildInfoFormats, generateBuildInfo } from '../build-info';\n\nconst USAGE =\n  'ignis-build-info generate [--out src/_build_info.ts] [--root .] [--format ts|json] [--export BUILD_INFO]';\n\nconst { positionals, values } = parseArgs({\n  args: process.argv.slice(2),\n  allowPositionals: true,\n  options: {\n    out: { type: 'string', default: 'src/_build_info.ts' },\n    root: { type: 'string', default: '.' },\n    format: { type: 'string', default: BuildInfoFormats.TS },\n    export: { type: 'string', default: BuildInfoEmitter.DEFAULT_EXPORT_NAME },\n  },\n});\n\n/** Exit code of the command, so the process exits in exactly one place. */\nconst run = async (): Promise<number> => {\n  if (positionals[0] !== 'generate') {\n    console.error(USAGE);\n    return 1;\n  }\n\n  if (!BuildInfoFormats.isValid(values.format)) {\n    console.error(\n      `invalid --format '${values.format}' | expected one of: ${[...BuildInfoFormats.SCHEME_SET].join(', ')}`,\n    );\n    return 1;\n  }\n\n  // Narrowed by comparison, never asserted: `isValid` above already refused everything else.\n  const format =\n    values.format === BuildInfoFormats.JSON ? BuildInfoFormats.JSON : BuildInfoFormats.TS;\n\n  const result = await generateBuildInfo({\n    out: values.out,\n    root: values.root,\n    format,\n    exportName: values.export,\n  });\n\n  const { service, version, commit, branch } = result.buildInfo;\n  console.log(`wrote ${values.out} | ${service}@${version} | ${commit} (${branch})`);\n\n  return 0;\n};\n\nrun()\n  .then(code => {\n    process.exit(code);\n  })\n  .catch(error => {\n    console.error(error);\n    process.exit(1);\n  });\n"]}

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

@@ -1,16 +0,0 @@
-import type { TBuildInfoRecord } from '@venizia/ignis-helpers/core';
-import type { TBuildInfoFormat } from './constants.js';
-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/esm/build-info/common/types.d.ts.map

@@ -1 +0,0 @@
-{"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/esm/build-info/common/types.js

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/build-info/common/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { TBuildInfoRecord } from '@venizia/ignis-helpers/core';\nimport type { TBuildInfoFormat } from './constants';\n\nexport interface IBuildInfoOptions {\n  out: string;\n  /** Where `package.json` is read from and where `git` is asked; default the cwd. */\n  root?: string;\n  format?: TBuildInfoFormat;\n  /** Name of the exported constant in `ts` format; default `BUILD_INFO`. */\n  exportName?: string;\n}\n\nexport interface IBuildInfoResult {\n  buildInfo: TBuildInfoRecord;\n  content: string;\n  out: string;\n}\n"]}

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

@@ -1,12 +0,0 @@
-import type { TBuildInfoRecord } from '@venizia/ignis-helpers/core';
-import { type TBuildInfoFormat } from './common/index.js';
-/** 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/esm/build-info/emitter.d.ts.map

@@ -1 +0,0 @@
-{"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/esm/build-info/emitter.js

@@ -1,22 +0,0 @@
-import { BuildInfoFormats } from './common/index.js';
-/** 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 class BuildInfoEmitter {
-    static { this.DEFAULT_EXPORT_NAME = 'BUILD_INFO'; }
-    static render(opts) {
-        const { buildInfo, format, exportName } = opts;
-        if (format === 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');
-    }
-}
-//# sourceMappingURL=emitter.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../../../src/build-info/emitter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAyB,MAAM,UAAU,CAAC;AAEnE,+HAA+H;AAC/H,MAAM,OAAO,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,gBAAgB,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","sourcesContent":["import type { TBuildInfoRecord } from '@venizia/ignis-helpers/core';\nimport { BuildInfoFormats, type TBuildInfoFormat } from './common';\n\n/** 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. */\nexport class BuildInfoEmitter {\n  static readonly DEFAULT_EXPORT_NAME = 'BUILD_INFO';\n\n  static render(opts: {\n    buildInfo: TBuildInfoRecord;\n    format: TBuildInfoFormat;\n    exportName: string;\n  }): string {\n    const { buildInfo, format, exportName } = opts;\n\n    if (format === BuildInfoFormats.JSON) {\n      return `${JSON.stringify(buildInfo, null, 2)}\\n`;\n    }\n\n    const fields = Object.entries(buildInfo)\n      .map(([key, value]) => `  ${key}: ${JSON.stringify(value)},`)\n      .join('\\n');\n\n    return [\n      '// AUTO-GENERATED by @venizia/ignis-boot - do not edit. Regenerate: ignis-build-info generate',\n      `export const ${exportName} = {`,\n      fields,\n      '} as const;',\n      '',\n    ].join('\\n');\n  }\n}\n"]}

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

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

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

@@ -1 +0,0 @@
-{"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

@@ -1,46 +0,0 @@
-#!/usr/bin/env bun
-import '../common/install-quiet-logger.js';
-import { parseArgs } from 'node:util';
-import { BuildInfoEmitter, BuildInfoFormats, generateBuildInfo } from '../build-info/index.js';
-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

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