@pristine-ts/cli 1.0.439 → 2.0.1

package/dist/lib/esm/commands/start-alias.command.js

@@ -0,0 +1,48 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { moduleScoped, ServiceDefinitionTagEnum, tag } from "@pristine-ts/common";
+import { injectable } from "tsyringe";
+import { CliModuleKeyname } from "../cli.module.keyname";
+import { StartCommand } from "./start.command";
+import { StartCommandOptions } from "./start.command-options";
+/**
+ * Top-level alias for the framework-reserved `p:start` command. Injects the delegate
+ * directly via standard DI.
+ */
+let StartAliasCommand = class StartAliasCommand {
+    constructor(delegate) {
+        this.delegate = delegate;
+        this.optionsType = StartCommandOptions;
+        this.name = "start";
+        this.description = "Alias for p:start.";
+    }
+    run(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.delegate.run(args);
+        });
+    }
+};
+StartAliasCommand = __decorate([
+    tag(ServiceDefinitionTagEnum.Command),
+    moduleScoped(CliModuleKeyname),
+    injectable(),
+    __metadata("design:paramtypes", [StartCommand])
+], StartAliasCommand);
+export { StartAliasCommand };
+//# sourceMappingURL=start-alias.command.js.map

package/dist/lib/esm/commands/start-alias.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-alias.command.js","sourceRoot":"","sources":["../../../../src/commands/start-alias.command.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAC,YAAY,EAAE,wBAAwB,EAAE,GAAG,EAAC,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AAGpC,OAAO,EAAC,gBAAgB,EAAC,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAC,mBAAmB,EAAC,MAAM,yBAAyB,CAAC;AAE5D;;;GAGG;AAII,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAK5B,YAA6B,QAAsB;QAAtB,aAAQ,GAAR,QAAQ,CAAc;QAJnD,gBAAW,GAAG,mBAAmB,CAAC;QAClC,SAAI,GAAG,OAAO,CAAC;QACf,gBAAW,GAAG,oBAAoB,CAAC;IAGnC,CAAC;IAEK,GAAG,CAAC,IAAyB;;YACjC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;KAAA;CACF,CAAA;AAXY,iBAAiB;IAH7B,GAAG,CAAC,wBAAwB,CAAC,OAAO,CAAC;IACrC,YAAY,CAAC,gBAAgB,CAAC;IAC9B,UAAU,EAAE;qCAM4B,YAAY;GALxC,iBAAiB,CAW7B"}

package/dist/lib/esm/commands/start.command-options.js

@@ -0,0 +1,30 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import "reflect-metadata";
+import { IsNumber, IsOptional, IsString } from "@pristine-ts/class-validator";
+/**
+ * Runtime overrides for `pristine start`. These are applied to every `RuntimeServerInterface`
+ * the kernel resolves — implementations are free to ignore them. The flags exist mainly for
+ * one-off cases ("I just need to test on a different port right now"); the canonical place
+ * to set defaults is the matching module's configurationDefinitions or `pristine.config.ts`.
+ */
+export class StartCommandOptions {
+}
+__decorate([
+    IsOptional(),
+    IsNumber(),
+    __metadata("design:type", Number)
+], StartCommandOptions.prototype, "port", void 0);
+__decorate([
+    IsOptional(),
+    IsString(),
+    __metadata("design:type", String)
+], StartCommandOptions.prototype, "address", void 0);
+//# sourceMappingURL=start.command-options.js.map

package/dist/lib/esm/commands/start.command-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.command-options.js","sourceRoot":"","sources":["../../../../src/commands/start.command-options.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAC,MAAM,8BAA8B,CAAC;AAE5E;;;;;GAKG;AACH,MAAM,OAAO,mBAAmB;CAQ/B;AALC;IAFC,UAAU,EAAE;IACZ,QAAQ,EAAE;;iDACG;AAId;IAFC,UAAU,EAAE;IACZ,QAAQ,EAAE;;oDACM"}

package/dist/lib/esm/commands/start.command.js

@@ -0,0 +1,166 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var StartCommand_1;
+import { moduleScoped, ServiceDefinitionTagEnum, tag } from "@pristine-ts/common";
+import { injectable, injectAll } from "tsyringe";
+import { Kernel } from "@pristine-ts/core";
+import { ConsoleManager } from "../managers/console.manager";
+import { ExitCodeEnum } from "../enums/exit-code.enum";
+import { CliModuleKeyname } from "../cli.module.keyname";
+import { StartCommandOptions } from "./start.command-options";
+/**
+ * Boots the AppModule, starts every registered `RuntimeServerInterface` (HTTP server, gRPC
+ * server, etc.), and keeps the process alive until SIGTERM or SIGINT. On signal, runs the
+ * registered `onShutdown` hooks via `Kernel.stop()` and exits.
+ *
+ * This is the production-grade entry point. Use `pristine start` (or its `pristine p:start`
+ * canonical name) instead of `node dist/main.js` if you want Pristine to manage the lifecycle,
+ * signal handling, and graceful shutdown — including listening on every server module the
+ * AppModule imports.
+ *
+ * Notes:
+ *   - The kernel is **already started** by `bootstrap()` before this command runs (the CLI
+ *     boots once for every command). This command does not call `kernel.start()` again — it
+ *     just starts the registered servers and keeps the process alive.
+ *   - `RuntimeServer`-tagged services are constructor-injected via `@injectAll`. This works
+ *     because `RuntimeServer` is a different tag than `Command`, so there's no self-reference
+ *     cycle (StartCommand is `@tag(Command)`, not `@tag(RuntimeServer)`). When no servers
+ *     are registered, the array is empty and the start path skips the loop.
+ *   - The `Kernel` is injected only for `kernel.stop()` — the legitimate use of the Kernel
+ *     as a service. Other resolution (commands, runtime servers, etc.) goes through
+ *     standard DI rather than reaching through `kernel.container`.
+ *   - The shutdown timeout (per `onShutdown` hook) defaults to 10 seconds. The whole-process
+ *     hard exit timeout defaults to 30 seconds — if the orderly shutdown doesn't finish in
+ *     that window, the process is force-exited so Kubernetes / ECS don't get stuck waiting.
+ *   - `--port` / `--address` flags are propagated to every RuntimeServer's `start()`. In
+ *     multi-server scenarios where servers should listen on different ports, use the per-module
+ *     configuration values (e.g. `pristine.http.kernel-server.port`) instead of CLI flags.
+ *   - Watch mode (`--watch`) is not yet implemented. For a dev loop, wrap `pristine start` in
+ *     `nodemon` or `tsx --watch`.
+ */
+let StartCommand = StartCommand_1 = class StartCommand {
+    constructor(consoleManager, kernel, servers) {
+        this.consoleManager = consoleManager;
+        this.kernel = kernel;
+        this.servers = servers;
+        this.optionsType = StartCommandOptions;
+        this.name = "p:start";
+        this.description = "Boot the AppModule and run until SIGTERM/SIGINT. Production-grade entry point.";
+        // Sentinel name of the DefaultRuntimeServer registered in @pristine-ts/core. We filter
+        // it out of `this.servers` before doing any real work because it's a no-op placeholder
+        // whose only job is to make `@injectAll(RuntimeServer)` resolvable in apps that don't
+        // import a real server module.
+        this.defaultRuntimeServerName = "__default__";
+    }
+    run(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const servers = this.servers.filter(s => s.name !== this.defaultRuntimeServerName);
+            const overrides = (args.port !== undefined || args.address !== undefined)
+                ? { port: args.port, address: args.address }
+                : undefined;
+            for (const server of servers) {
+                try {
+                    yield server.start(overrides);
+                }
+                catch (error) {
+                    this.consoleManager.writeError(`Failed to start server '${server.name}': ${error.message}`);
+                    // Best-effort: stop any servers that did start before we abort.
+                    for (const started of servers) {
+                        if (started === server)
+                            break;
+                        try {
+                            yield started.stop();
+                        }
+                        catch ( /* swallow */_a) { /* swallow */ }
+                    }
+                    return ExitCodeEnum.Error;
+                }
+            }
+            if (servers.length === 0) {
+                this.consoleManager.writeSuccess("Pristine app running. Send SIGTERM (or Ctrl+C) to stop.");
+            }
+            else {
+                const labels = servers.map(s => s.name).join(", ");
+                this.consoleManager.writeSuccess(`Pristine app running with ${servers.length} server(s): ${labels}. Send SIGTERM (or Ctrl+C) to stop.`);
+            }
+            return new Promise((resolve) => {
+                let shuttingDown = false;
+                // Keep the event loop alive. Without this, Node would exit as soon as it noticed nothing
+                // else (no open sockets, no timers, no listening servers from user modules) was pending —
+                // signal handlers alone don't count as work. The interval is a 1-day no-op heartbeat;
+                // we clear it on shutdown so the process can actually exit when stop() returns.
+                const heartbeat = setInterval(() => { }, 1 << 30);
+                const initiateShutdown = (signal) => __awaiter(this, void 0, void 0, function* () {
+                    if (shuttingDown) {
+                        // Second signal arrived while we're already shutting down — escalate to an immediate
+                        // hard exit. This mirrors the behavior of most production runtimes (one Ctrl+C =
+                        // graceful, two = right now).
+                        this.consoleManager.writeWarning(`Received ${signal} again — forcing exit.`);
+                        process.exit(130);
+                    }
+                    shuttingDown = true;
+                    this.consoleManager.writeInfo(`Received ${signal}, shutting down gracefully...`);
+                    const hardExitTimer = setTimeout(() => {
+                        this.consoleManager.writeError(`Shutdown exceeded ${StartCommand_1.HARD_EXIT_TIMEOUT_MS}ms — forcing exit.`);
+                        process.exit(1);
+                    }, StartCommand_1.HARD_EXIT_TIMEOUT_MS);
+                    // Don't keep the event loop alive just for the timer.
+                    hardExitTimer.unref();
+                    try {
+                        // Kernel.stop() invokes module onShutdown hooks in outer-to-inner order, including
+                        // HttpModule.onShutdown which calls KernelHttpServer.stop(). No need to stop the
+                        // servers individually here.
+                        yield this.kernel.stop();
+                        this.consoleManager.writeSuccess("Shutdown complete.");
+                        clearTimeout(hardExitTimer);
+                        clearInterval(heartbeat);
+                        resolve(ExitCodeEnum.Success);
+                    }
+                    catch (error) {
+                        this.consoleManager.writeError(`Shutdown error: ${error.message}`);
+                        clearTimeout(hardExitTimer);
+                        clearInterval(heartbeat);
+                        resolve(ExitCodeEnum.Error);
+                    }
+                });
+                // Register on each signal once. A second SIGINT/SIGTERM goes through `initiateShutdown`
+                // again, which detects `shuttingDown` and force-exits.
+                process.on("SIGTERM", () => { void initiateShutdown("SIGTERM"); });
+                process.on("SIGINT", () => { void initiateShutdown("SIGINT"); });
+            });
+        });
+    }
+};
+// Force-exit safeguard: if onShutdown hooks are still running after this many milliseconds
+// past the first signal, the process is killed. Prevents orchestrators from waiting on a
+// wedged shutdown.
+StartCommand.HARD_EXIT_TIMEOUT_MS = 30000;
+StartCommand = StartCommand_1 = __decorate([
+    tag(ServiceDefinitionTagEnum.Command),
+    moduleScoped(CliModuleKeyname),
+    injectable(),
+    __param(2, injectAll(ServiceDefinitionTagEnum.RuntimeServer)),
+    __metadata("design:paramtypes", [ConsoleManager,
+        Kernel, Array])
+], StartCommand);
+export { StartCommand };
+//# sourceMappingURL=start.command.js.map

package/dist/lib/esm/commands/start.command.js.map

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

package/dist/lib/esm/commands/verify-alias.command.js

@@ -0,0 +1,47 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { moduleScoped, ServiceDefinitionTagEnum, tag } from "@pristine-ts/common";
+import { injectable } from "tsyringe";
+import { CliModuleKeyname } from "../cli.module.keyname";
+import { VerifyCommand } from "./verify.command";
+/**
+ * Top-level alias for the framework-reserved `p:verify` command. Injects the delegate
+ * directly via standard DI.
+ */
+let VerifyAliasCommand = class VerifyAliasCommand {
+    constructor(delegate) {
+        this.delegate = delegate;
+        this.optionsType = null;
+        this.name = "verify";
+        this.description = "Alias for p:verify.";
+    }
+    run(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.delegate.run(args);
+        });
+    }
+};
+VerifyAliasCommand = __decorate([
+    tag(ServiceDefinitionTagEnum.Command),
+    moduleScoped(CliModuleKeyname),
+    injectable(),
+    __metadata("design:paramtypes", [VerifyCommand])
+], VerifyAliasCommand);
+export { VerifyAliasCommand };
+//# sourceMappingURL=verify-alias.command.js.map

package/dist/lib/esm/commands/verify-alias.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-alias.command.js","sourceRoot":"","sources":["../../../../src/commands/verify-alias.command.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAC,YAAY,EAAE,wBAAwB,EAAE,GAAG,EAAC,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AAGpC,OAAO,EAAC,gBAAgB,EAAC,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAE/C;;;GAGG;AAII,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAK7B,YAA6B,QAAuB;QAAvB,aAAQ,GAAR,QAAQ,CAAe;QAJpD,gBAAW,GAAG,IAAI,CAAC;QACnB,SAAI,GAAG,QAAQ,CAAC;QAChB,gBAAW,GAAG,qBAAqB,CAAC;IAGpC,CAAC;IAEK,GAAG,CAAC,IAAS;;YACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;KAAA;CACF,CAAA;AAXY,kBAAkB;IAH9B,GAAG,CAAC,wBAAwB,CAAC,OAAO,CAAC;IACrC,YAAY,CAAC,gBAAgB,CAAC;IAC9B,UAAU,EAAE;qCAM4B,aAAa;GALzC,kBAAkB,CAW9B"}

package/dist/lib/esm/commands/verify.command.js

@@ -0,0 +1,68 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { moduleScoped, ServiceDefinitionTagEnum, tag } from "@pristine-ts/common";
+import { inject, injectable } from "tsyringe";
+import { Kernel } from "@pristine-ts/core";
+import { ExitCodeEnum } from "../enums/exit-code.enum";
+import { CliModuleKeyname } from "../cli.module.keyname";
+import { AppModuleLoader } from "../bootstrap/app-module-loader";
+/**
+ * Verifies that the consumer's AppModule can be instantiated against its configuration.
+ * Builds a fresh throw-away kernel, runs every boot phase capturing per-phase outcomes,
+ * executes every embedder-registered `InstantiationTestInterface`, and routes the resulting
+ * report through the project's `LogHandlerInterface`.
+ *
+ * Note: this command runs after the CLI's own `kernel.start()` has succeeded, so it cannot
+ * be used to debug a configuration that is so broken the CLI can't start. For that case,
+ * call `kernel.verifyInstantiation(...)` directly from a small script that imports your
+ * AppModule.
+ */
+let VerifyCommand = class VerifyCommand {
+    constructor(logHandler, appModuleLoader) {
+        this.logHandler = logHandler;
+        this.appModuleLoader = appModuleLoader;
+        this.optionsType = null;
+        this.name = "p:verify";
+        this.description = "Verify the AppModule boots cleanly and run all registered InstantiationTests.";
+    }
+    run(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const skipTests = (args === null || args === void 0 ? void 0 : args["skip-tests"]) === true || (args === null || args === void 0 ? void 0 : args.skipTests) === true;
+            const { appModule, configuration } = yield this.appModuleLoader.load();
+            const kernel = new Kernel();
+            const report = yield kernel.verifyInstantiation(appModule, configuration, {
+                runInstantiationTests: !skipTests,
+            });
+            report.log(this.logHandler);
+            return report.hasErrors ? ExitCodeEnum.Error : ExitCodeEnum.Success;
+        });
+    }
+};
+VerifyCommand = __decorate([
+    tag(ServiceDefinitionTagEnum.Command),
+    moduleScoped(CliModuleKeyname),
+    injectable(),
+    __param(0, inject("LogHandlerInterface")),
+    __metadata("design:paramtypes", [Object, AppModuleLoader])
+], VerifyCommand);
+export { VerifyCommand };
+//# sourceMappingURL=verify.command.js.map

package/dist/lib/esm/commands/verify.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.command.js","sourceRoot":"","sources":["../../../../src/commands/verify.command.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAC,YAAY,EAAE,wBAAwB,EAAE,GAAG,EAAC,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAC,MAAM,EAAE,UAAU,EAAC,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAC,MAAM,EAAC,MAAM,mBAAmB,CAAC;AAGzC,OAAO,EAAC,YAAY,EAAC,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAC,gBAAgB,EAAC,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAC,eAAe,EAAC,MAAM,gCAAgC,CAAC;AAE/D;;;;;;;;;;GAUG;AAII,IAAM,aAAa,GAAnB,MAAM,aAAa;IAKxB,YACiC,UAAgD,EAC9D,eAAgC;QADD,eAAU,GAAV,UAAU,CAAqB;QAC9D,oBAAe,GAAf,eAAe,CAAiB;QANnD,gBAAW,GAAG,IAAI,CAAC;QACnB,SAAI,GAAG,UAAU,CAAC;QAClB,gBAAW,GAAG,+EAA+E,CAAC;IAM9F,CAAC;IAEK,GAAG,CAAC,IAAS;;YACjB,MAAM,SAAS,GAAG,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAG,YAAY,CAAC,MAAK,IAAI,IAAI,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,SAAS,MAAK,IAAI,CAAC;YAE5E,MAAM,EAAC,SAAS,EAAE,aAAa,EAAC,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;YAErE,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,aAAa,EAAE;gBACxE,qBAAqB,EAAE,CAAC,SAAS;aAClC,CAAC,CAAC;YAEH,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAE5B,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC;QACtE,CAAC;KAAA;CACF,CAAA;AAzBY,aAAa;IAHzB,GAAG,CAAC,wBAAwB,CAAC,OAAO,CAAC;IACrC,YAAY,CAAC,gBAAgB,CAAC;IAC9B,UAAU,EAAE;IAOR,WAAA,MAAM,CAAC,qBAAqB,CAAC,CAAA;6CACI,eAAe;GAPxC,aAAa,CAyBzB"}

package/dist/lib/esm/config/config-loader.js

@@ -0,0 +1,130 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { injectable } from "tsyringe";
+import fs from "fs";
+import path from "path";
+import { ConfigProvenanceEnum } from "./config-provenance.enum";
+import { ResolvedPristineConfig } from "./resolved-pristine-config";
+import { DynamicImporter } from "../bootstrap/dynamic-importer";
+/**
+ * Loads `pristine.config.ts` (preferred) or `pristine.config.js` (escape hatch for
+ * pure-JS projects). Walks up from `process.cwd()` looking for the file, then loads it
+ * through `jiti` (for `.ts`) or Node's dynamic `import()` (for `.js`).
+ *
+ * Returns a `ResolvedPristineConfig` carrying the file path (when found) and per-field
+ * provenance, which `pristine p:config:print` uses to render an annotated dump.
+ */
+let ConfigLoader = class ConfigLoader {
+    constructor(dynamicImporter) {
+        this.dynamicImporter = dynamicImporter;
+        /**
+         * File names searched for, in order. `.ts` is the canonical form — `defineConfig()`
+         * gives full IDE autocomplete and every Pristine project ships a TS toolchain anyway.
+         * `.js` is the escape hatch for the rare pure-JS project that cannot have a `.ts`
+         * file at the root.
+         */
+        this.configFileNames = [
+            "pristine.config.ts",
+            "pristine.config.js",
+        ];
+    }
+    load(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const startDir = (_a = options === null || options === void 0 ? void 0 : options.startDir) !== null && _a !== void 0 ? _a : process.cwd();
+            let configFilePath;
+            if ((options === null || options === void 0 ? void 0 : options.explicitPath) !== undefined) {
+                const abs = path.resolve(startDir, options.explicitPath);
+                if (fs.existsSync(abs) === false) {
+                    throw new Error(`[pristine] Config file not found: '${options.explicitPath}' (resolved to '${abs}')`);
+                }
+                configFilePath = abs;
+            }
+            else {
+                configFilePath = this.findConfigFile(startDir);
+            }
+            if (configFilePath === undefined) {
+                return new ResolvedPristineConfig({}, undefined, {});
+            }
+            const config = yield this.importConfigFile(configFilePath);
+            const provenance = {};
+            for (const key of Object.keys(config)) {
+                provenance[key] = ConfigProvenanceEnum.ConfigFile;
+            }
+            return new ResolvedPristineConfig(config, configFilePath, provenance);
+        });
+    }
+    /**
+     * Walks up from `startDir` looking for a config file with any of the supported names.
+     * Stops at the first match, returning the absolute path. Stops at the filesystem root
+     * without finding anything → returns undefined. Walking up matters in monorepos: a CLI
+     * invoked in `packages/foo/` should still find a `pristine.config.ts` at the repo root.
+     * @private
+     */
+    findConfigFile(startDir) {
+        let current = path.resolve(startDir);
+        while (true) {
+            for (const name of this.configFileNames) {
+                const candidate = path.join(current, name);
+                if (fs.existsSync(candidate) && fs.statSync(candidate).isFile()) {
+                    return candidate;
+                }
+            }
+            const parent = path.dirname(current);
+            // path.dirname of root === root; we've hit the filesystem boundary.
+            if (parent === current)
+                return undefined;
+            current = parent;
+        }
+    }
+    /**
+     * Loads a config file from `absolutePath`. `.ts` goes through `jiti`; `.js` uses Node's
+     * native dynamic `import()`. Extracts the default export, falling back to a named
+     * `pristineConfig` export for users who prefer not to use `export default`.
+     * @private
+     */
+    importConfigFile(absolutePath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d;
+            const ext = path.extname(absolutePath).toLowerCase();
+            let loaded;
+            if (ext === ".ts") {
+                const jitiModule = yield this.dynamicImporter.import("jiti");
+                const createJiti = (_b = (_a = jitiModule.default) !== null && _a !== void 0 ? _a : jitiModule.createJiti) !== null && _b !== void 0 ? _b : jitiModule;
+                const jiti = createJiti(absolutePath, { interopDefault: true });
+                loaded = jiti(absolutePath);
+            }
+            else {
+                loaded = yield this.dynamicImporter.import(`file://${absolutePath}`);
+            }
+            const config = (_d = (_c = loaded === null || loaded === void 0 ? void 0 : loaded.default) !== null && _c !== void 0 ? _c : loaded === null || loaded === void 0 ? void 0 : loaded.pristineConfig) !== null && _d !== void 0 ? _d : loaded;
+            if (!config || typeof config !== "object") {
+                throw new Error(`[pristine] Config file at '${absolutePath}' did not export a valid configuration. ` +
+                    `Use \`export default defineConfig({ ... })\` or \`export const pristineConfig = { ... }\`.`);
+            }
+            return config;
+        });
+    }
+};
+ConfigLoader = __decorate([
+    injectable(),
+    __metadata("design:paramtypes", [DynamicImporter])
+], ConfigLoader);
+export { ConfigLoader };
+//# sourceMappingURL=config-loader.js.map

package/dist/lib/esm/config/config-loader.js.map

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

package/dist/lib/esm/config/config-provenance.enum.js

@@ -0,0 +1,12 @@
+/**
+ * Where a resolved configuration value originated. Used by `pristine p:config:print` to
+ * annotate output so users can tell whether a value comes from their config file, a
+ * deprecated `package.json` field, or the CLI's built-in defaults.
+ */
+export var ConfigProvenanceEnum;
+(function (ConfigProvenanceEnum) {
+    ConfigProvenanceEnum["ConfigFile"] = "config-file";
+    ConfigProvenanceEnum["PackageJsonDeprecated"] = "package-json-deprecated";
+    ConfigProvenanceEnum["Default"] = "default";
+})(ConfigProvenanceEnum || (ConfigProvenanceEnum = {}));
+//# sourceMappingURL=config-provenance.enum.js.map

package/dist/lib/esm/config/config-provenance.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-provenance.enum.js","sourceRoot":"","sources":["../../../../src/config/config-provenance.enum.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAN,IAAY,oBAIX;AAJD,WAAY,oBAAoB;IAC9B,kDAA0B,CAAA;IAC1B,yEAAiD,CAAA;IACjD,2CAAmB,CAAA;AACrB,CAAC,EAJW,oBAAoB,KAApB,oBAAoB,QAI/B"}

package/dist/lib/esm/config/config.js

@@ -0,0 +1,6 @@
+export * from "./config-loader";
+export * from "./config-provenance.enum";
+export * from "./define-config";
+export * from "./pristine-config.interface";
+export * from "./resolved-pristine-config";
+//# sourceMappingURL=config.js.map

package/dist/lib/esm/config/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../src/config/config.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC"}

package/dist/lib/esm/config/define-config.js

@@ -0,0 +1,14 @@
+/**
+ * Identity helper that gives an authored `pristine.config.ts` full type checking and
+ * autocomplete. Implementation is intentionally trivial — the types do all the work.
+ *
+ * ```ts
+ * import {defineConfig} from "@pristine-ts/cli";
+ *
+ * export default defineConfig({
+ *   appModule: { path: "dist/app.module.js" },
+ * });
+ * ```
+ */
+export const defineConfig = (config) => config;
+//# sourceMappingURL=define-config.js.map

package/dist/lib/esm/config/define-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-config.js","sourceRoot":"","sources":["../../../../src/config/define-config.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAsB,EAAkB,EAAE,CAAC,MAAM,CAAC"}

package/dist/lib/esm/config/pristine-config.interface.js

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

package/dist/lib/esm/config/pristine-config.interface.js.map

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

package/dist/lib/esm/config/resolved-pristine-config.js

@@ -0,0 +1,21 @@
+/**
+ * A loaded `PristineConfig` augmented with discovery metadata. `ConfigLoader` returns this
+ * shape; the raw `PristineConfig` is what users author.
+ */
+export class ResolvedPristineConfig {
+    constructor(config, 
+    /** Absolute path to the config file that was loaded, if any. */
+    configFilePath, 
+    /**
+     * Per-top-level-field provenance markers, mainly for `pristine p:config:print`. Keys are
+     * top-level fields of `PristineConfig` (`appModule`, `build`, `start`, `plugins`,
+     * `kernelConfiguration`); values are the `ConfigProvenanceEnum` describing where each
+     * came from.
+     */
+    provenance) {
+        this.config = config;
+        this.configFilePath = configFilePath;
+        this.provenance = provenance;
+    }
+}
+//# sourceMappingURL=resolved-pristine-config.js.map

package/dist/lib/esm/config/resolved-pristine-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolved-pristine-config.js","sourceRoot":"","sources":["../../../../src/config/resolved-pristine-config.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,OAAO,sBAAsB;IACjC,YACkB,MAAsB;IACtC,gEAAgE;IAChD,cAAkC;IAClD;;;;;OAKG;IACa,UAAgD;QAThD,WAAM,GAAN,MAAM,CAAgB;QAEtB,mBAAc,GAAd,cAAc,CAAoB;QAOlC,eAAU,GAAV,UAAU,CAAsC;IAElE,CAAC;CACF"}