@venizia/ignis-boot 0.2.0-2 → 0.2.0-21

package/README.md

@@ -4,216 +4,195 @@
 
 # :fire: IGNIS - `@venizia/ignis-boot`
 
-**Convention-based discovery and bootstrapping.**
+**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/)
 
-[Bootstrapping reference](https://ignis.venizia.ai/references/base/bootstrapping) •
-[Application](https://ignis.venizia.ai/references/base/application) •
-[Dependency injection](https://ignis.venizia.ai/references/base/dependency-injection)
+[Artifact registration reference](https://ignis.venizia.ai/references/base/bootstrapping) •
+[Registering artifacts guide](https://ignis.venizia.ai/guides/core-concepts/application/bootstrapping) •
+[Changelog](https://ignis.venizia.ai/changelogs/2026-09-03-deprecated-boot-api-removed)
 
 </div>
 
 ---
 
-Finds your controllers, services, repositories, and datasources by filename, then binds each one into
-the IoC container - so you never maintain a registration list that drifts from the files on disk.
+`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.
 
-**Most applications never import this package.** `BaseApplication` from `@venizia/ignis` already depends
-on it, registers the four built-in booters, and exposes `boot()`. You reach for it directly only to
-write a custom booter for an artifact type of your own.
+**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.
 
 ## Install
 
 ```bash
-bun add @venizia/ignis-boot
+bun add -d @venizia/ignis-boot
 ```
 
-Already a transitive dependency of `@venizia/ignis`.
+`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.
 
 ## Use it
 
-Convention boot is opt-in: call `boot()` before `start()`.
+Decorate the classes you want registered:
 
 ```typescript
-import { BaseApplication, IApplicationInfo } from '@venizia/ignis';
+import { component, service } from '@venizia/ignis';
 
-class App extends BaseApplication {
-  getAppInfo(): IApplicationInfo {
-    return { name: 'my-app', version: '1.0.0', description: 'My app' };
-  }
-
-  staticConfigure() {}
-  preConfigure() {}
-  postConfigure() {}
-  setupMiddlewares() {}
-}
+@service()
+export class PricingService extends BaseService {}
 
-const application = new App({
-  scope: 'App',
-  config: {
-    host: '0.0.0.0',
-    port: 3000,
-    path: { base: '/api', isStrict: false },
-    bootOptions: {}, // the defaults cover the conventional layout
-  },
-});
-
-await application.boot(); // discover and bind every artifact
-await application.start();
+@component()
+export class MetricsComponent extends BaseComponent {}
 ```
 
-Given the layout below, `boot()` binds `datasources.PostgresDataSource`, `repositories.UserRepository`,
-`services.UserService`, and `controllers.UserController` - no further code.
+Add the generator scripts and run one:
 
+```json
+{
+  "scripts": {
+    "generate:artifacts": "ignis-artifacts generate --root src --out src/generated/artifacts.ts",
+    "check:artifacts": "ignis-artifacts check --root src --out src/generated/artifacts.ts"
+  }
+}
 ```
-<projectRoot>/
-  datasources/postgres.datasource.js
-  repositories/user.repository.js
-  services/user.service.js
-  controllers/user.controller.js
+
+```bash
+bun run generate:artifacts
 ```
 
-## Discovery conventions
+Pass the generated index to your application:
 
-Each booter has a default directory and a default file suffix, and binds into its own namespace.
+```typescript
+import { GeneratedArtifacts } from './generated/artifacts';
 
-| Booter | Default dir | Default suffix | Binding key | Tag | Scope |
-| :--- | :--- | :--- | :--- | :--- | :--- |
-| `DatasourceBooter` | `datasources` | `.datasource.js` | `datasources.<ClassName>` | `datasources` | singleton |
-| `RepositoryBooter` | `repositories` | `.repository.js` | `repositories.<ClassName>` | `repositories` | transient |
-| `ServiceBooter` | `services` | `.service.js` | `services.<ClassName>` | `services` | transient |
-| `ControllerBooter` | `controllers` | `.controller.js` | `controllers.<ClassName>` | `controllers` | transient |
+export const configs: IApplicationConfigs = {
+  path: { base: '/api', isStrict: true },
+  artifacts: GeneratedArtifacts,
+};
+```
 
-Datasources are singletons because a connection pool must be shared; everything else resolves per use.
-Directories resolve relative to the application's `getProjectRoot()`, which defaults to `process.cwd()`.
-Subdirectories are included - `isNested` defaults to `true`.
+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).
 
-Booters are registered datasources -> repositories -> services -> controllers, so a repository can
-always resolve the datasource it injects.
+## CLI
 
-> [!IMPORTANT]
-> **The default suffixes end in `.js`, not `.ts`.** Discovery globs files on disk and `import`s them, and
-> it is designed to run against your **compiled output**. Build first, and have `getProjectRoot()` point
-> at the built directory - returning `__dirname` from the compiled entrypoint does exactly that. If
-> `boot()` reports zero artifacts, this is almost always why. To boot from TypeScript sources instead,
-> set the extensions explicitly: `{ controllers: { extensions: ['.controller.ts'] } }`.
+Shipped as the `ignis-artifacts` binary. Requires `typescript >= 5` (peer dependency) and runs
+under bun.
 
-## Phases
+```
+ignis-artifacts <generate|check> [--root src] [--out src/generated/artifacts.ts] [--ignore a,b] [--export GeneratedArtifacts]
+```
 
-`Bootstrapper.boot()` runs three phases across **all** booters - phase by phase, not booter by booter.
+| 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 |
+| `--export` | `GeneratedArtifacts` | Name of the exported constant |
 
-| Phase | What happens |
-| :--- | :--- |
-| `configure` | Fill in defaults for `dirs`, `extensions`, `isNested`, then build the glob pattern |
-| `discover` | Run the glob under the project root, collecting absolute file paths |
-| `load` | `import()` each file, keep the exported classes, bind them into the container |
+| 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 |
 
-`boot()` resolves to an `IBootReport`: the booter class names that ran, per-phase `durationMs`, and
-`totalDurationMs`. A throw in any phase is rewrapped naming both the phase and the booter, with the
-original error kept as `cause`.
+Default ignore list: `**/__tests__/**`, `**/*.test.ts`, `**/*.spec.ts`, `**/generated/**`.
 
-## Configuring discovery
+## Detection rules
 
-Pass `bootOptions` in the application config. Every artifact type takes the same `IArtifactOptions`.
+A class is emitted when every rule holds. Every miss is logged with its reason.
 
-| Option | Type | Meaning |
-| :--- | :--- | :--- |
-| `dirs` | `string[]` | Directories to scan, relative to the project root |
-| `extensions` | `string[]` | File suffixes to match |
-| `isNested` | `boolean` | Include subdirectories - default `true` |
-| `glob` | `string` | Raw glob pattern; overrides the three above |
+- 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>`.
 
-```typescript
-bootOptions: {
-  controllers: { dirs: ['controllers', 'api'], extensions: ['.controller.js'] },
-  services: { glob: 'modules/**/*.service.js' },
-}
-```
+`model` classes are recognised and never emitted - a model is reached through its repository.
 
-A key that is present but `undefined` - the shape `dirs: process.env.APP_DIRS?.split(',')` produces - is
-treated as not provided and falls back to the default. An empty `dirs` or `extensions` array is not: it
-throws when the pattern is built.
+## Programmatic API
 
-## Custom booters
+`@venizia/ignis-boot/generator` exports the same machinery as functions, for a caller that is not
+a shell script.
 
-Extend `BaseArtifactBooter` and implement its three hooks. The base class handles configure, discover,
-and load; you decide only where to look and what to bind.
+| 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 |
 
 ```typescript
-import { BaseArtifactBooter, IApplication, IBootOptions } from '@venizia/ignis-boot';
-import { BindingKeys, inject } from '@venizia/ignis-inversion';
-
-export class ObserverBooter extends BaseArtifactBooter {
-  constructor(
-    @inject({ key: '@app/project_root' }) root: string,
-    @inject({ key: '@app/instance' }) private readonly application: IApplication,
-    @inject({ key: '@app/boot-options' }) bootOptions: IBootOptions,
-  ) {
-    super({ scope: ObserverBooter.name, root, artifactOptions: bootOptions.observers ?? {} });
-  }
+import { checkArtifactIndex } from '@venizia/ignis-boot/generator';
 
-  protected override getDefaultDirs(): string[] {
-    return ['observers'];
-  }
+const { isFresh } = checkArtifactIndex({ root: 'src', out: 'src/generated/artifacts.ts' });
+```
 
-  protected override getDefaultExtensions(): string[] {
-    return ['.observer.js'];
-  }
+## `ignis-build-info` - stamp the build
+
+A second binary in the same package. It resolves what a running service should be able to say
+about itself - service, version, commit, branch, build time - at BUILD time, and writes it as a
+static file the bundle bakes in. Nothing is read back at run time: a `bun build --compile` binary
+ships no `node_modules`, no `.git` and no readable `package.json`, and a Distroless image has no
+`git` to spawn, so a runtime resolver would report blanks in exactly the deployment that matters.
 
-  protected override async bind(): Promise<void> {
-    for (const cls of this.loadedClasses) {
-      const key = BindingKeys.build({ namespace: 'observers', key: cls.name });
-      this.application.bind({ key }).toClass(cls).setTags('observers');
-    }
-  }
-}
+```
+ignis-build-info generate [--out src/_build_info.ts] [--root .] [--format ts|json] [--export BUILD_INFO]
 ```
 
-`IBootOptions` carries an index signature, so `bootOptions.observers` type-checks with no change to the
-framework. Booters are found by the `booter` tag, so registering is all that remains - and it must
-happen before `boot()` runs, which is earlier than `preConfigure()`:
+| Flag | Default | Meaning |
+| :--- | :--- | :--- |
+| `--out` | `src/_build_info.ts` | Output path; always rewritten - `builtAt` changes every run |
+| `--root` | `.` | Where `package.json` is read and where `git` is asked |
+| `--format` | `ts` | `ts` - a static `export const`; `json` - the same record, for a Vite app or a Tauri shell |
+| `--export` | `BUILD_INFO` | Name of the exported constant in `ts` format |
 
-```typescript
-override async boot() {
-  this.booter(ObserverBooter);
-  return super.boot();
-}
-```
+Each field is read from the environment first, then `git`, then `package.json`; anything left reads
+`unspecified`, so a pipeline that forgot a variable is visible rather than silent.
 
-Every constructor parameter must carry `@inject` - a container-instantiated class with one bare
-parameter is refused at boot.
+| Field | Environment, first present wins | Fallback |
+| :--- | :--- | :--- |
+| `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 moment the generator ran |
+| `service` | - | `package.json#name` |
 
-## What you must know
+Register the stamp once at the entrypoint, and `GET /health/stats` reports it:
 
-- **Every exported class in a matched file is bound**, not only the one whose name matches the file.
-  Keep helper classes out of `*.controller.js` and friends, or move them to their own module.
-- **Discovery is filename-driven, not decorator-driven.** A correctly decorated controller in the wrong
-  directory is invisible to it - register that one manually with `this.controller(...)`.
-- Calling `boot()` twice does not double-register: the bootstrapper resets its booter list on each run.
-- `reflect-metadata` must be imported once at your entrypoint, and `experimentalDecorators` plus
-  `emitDecoratorMetadata` must be `true` **inline** in your `tsconfig.json` - Bun does not resolve them
-  through `extends`, and `@inject` is silently dropped without them.
+```typescript
+import { BUILD_INFO } from './_build_info';
+import { BuildInfoRegistry } from '@venizia/ignis-helpers/core';
 
-## Surface
+BuildInfoRegistry.set({ buildInfo: BUILD_INFO });
+```
 
-| Export | What it is |
-| :--- | :--- |
-| `BaseArtifactBooter` | Abstract base implementing the three phases; extend it for custom artifacts |
-| `Bootstrapper` | Runs the phases across every `booter`-tagged binding and returns the report |
-| `BootMixin` | Adds `boot()`, `bootOptions`, and the four built-in booters to a raw `Container` |
-| `ControllerBooter` / `ServiceBooter` / `RepositoryBooter` / `DatasourceBooter` | The built-in booters |
-| `discoverFiles` / `loadClasses` | The glob and dynamic-import primitives, usable standalone |
-| `BootPhases` | `configure`, `discover`, `load` |
-| `IBootOptions` / `IArtifactOptions` / `IBootReport` / `IBooter` | Public types |
+`git` runs through Bun Shell, so the binary needs bun (it carries a `bun` shebang). Under plain
+Node the `git` fields degrade to `unspecified` and the build still succeeds; set the variables
+above if a Node invocation has to be exact.
+
+Programmatic: `@venizia/ignis-boot/build-info` exports `generateBuildInfo(opts)`,
+`BuildInfoResolver.getInstance().resolve({ root })`, `BuildInfoEmitter.render({ buildInfo, format, exportName })`,
+`BuildInfoFormats` and `BuildInfoEnvironmentKeys`.
 
-`BootMixin` is for applications not built on `BaseApplication` - it wires the same four booters onto any
-`Container`. `BaseApplication` does its own registration and does not use the mixin.
+## What you must know
 
-Full detail: [Bootstrapping reference](https://ignis.venizia.ai/references/base/bootstrapping).
+- **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.
+
+Full detail: [Artifact registration reference](https://ignis.venizia.ai/references/base/bootstrapping).
 
 ## Links
 
@@ -223,8 +202,5 @@ Full detail: [Bootstrapping reference](https://ignis.venizia.ai/references/base/
 [Best practices](https://ignis.venizia.ai/best-practices/) &#8226;
 [Changelog](https://ignis.venizia.ai/changelogs/)
 
-Inspired by [LoopBack 4's boot system](https://loopback.io/doc/en/lb4/Booting-an-Application.html).
-
 MIT licensed - see [LICENSE.md](LICENSE.md).
 Questions: [GitHub Issues](https://github.com/VENIZIA-AI/ignis/issues) &#8226; developer@venizia.ai
-</content>

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/{esm → cjs/build-info}/common/index.d.ts

@@ -1,3 +1,3 @@
-export * from './types';
 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/{common → build-info/common}/index.js

@@ -14,6 +14,6 @@ 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("./types"), exports);
 __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"}