@devbie/newbie-cli 0.1.0-stage.0

package/dist/commands/update.d.ts

@@ -0,0 +1,6 @@
+import { GlobalOptions } from "./shared";
+export declare function runUpdate(options: GlobalOptions & {
+    all?: boolean;
+    yes?: boolean;
+    force?: boolean;
+}): Promise<void>;

package/dist/commands/update.js

@@ -0,0 +1,129 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runUpdate = runUpdate;
+const figlet_1 = __importDefault(require("figlet"));
+const prompts_1 = require("@inquirer/prompts");
+const colorette_1 = require("colorette");
+const pipeline_1 = require("../assemble/pipeline");
+const drift_1 = require("../core/drift");
+const modules_state_1 = require("../core/modules-state");
+const drift_2 = require("../lib/drift");
+const fs_util_1 = require("../lib/fs-util");
+const paths_1 = require("../constants/paths");
+const modules_state_2 = require("../lib/modules-state");
+const shared_1 = require("./shared");
+const short = (commit) => commit ? commit.slice(0, 7) : "unknown";
+async function runUpdate(options) {
+    console.info(figlet_1.default.textSync("Newbie", {
+        font: "Epic",
+        width: 80,
+        whitespaceBreak: true,
+    }));
+    const { ctx } = await (0, shared_1.createContext)(options, { fetch: true });
+    const { cwd, sink, registry, state } = ctx;
+    const keys = (0, modules_state_1.moduleKeys)(state);
+    if (keys.length === 0) {
+        console.info("\n[info] No modules are enabled.\n");
+        return;
+    }
+    const targetCommit = registry.sourceCommit;
+    const inspections = [];
+    for (const key of keys) {
+        process.stdout.write(`Checking ${key}...\r`);
+        const record = state.modules.find((entry) => entry.key === key);
+        const fromCommit = record?.sourceCommit ?? null;
+        const base = {
+            key,
+            status: "up-to-date",
+            fromCommit,
+            toCommit: targetCommit,
+            patchIds: [],
+        };
+        if (!(await (0, fs_util_1.fileExists)(cwd, `${paths_1.MODULES_DIR}/${key}`))) {
+            inspections.push({ ...base, status: "missing" });
+            continue;
+        }
+        if (fromCommit && targetCommit && fromCommit === targetCommit) {
+            inspections.push(base);
+            continue;
+        }
+        if (fromCommit && !options.force) {
+            const pristine = await (0, drift_2.snapshotPristineModule)(registry, key, fromCommit);
+            if (pristine) {
+                const drift = (0, drift_1.diffSnapshots)(await (0, drift_2.snapshotInstalledModule)(cwd, key), pristine);
+                if (!drift.clean) {
+                    inspections.push({
+                        ...base,
+                        status: "drifted",
+                        patchIds: (0, drift_1.driftPatchIds)(drift),
+                    });
+                    continue;
+                }
+            }
+        }
+        inspections.push({ ...base, status: "update-available" });
+    }
+    process.stdout.write("\x1b[2K\r");
+    for (const result of inspections) {
+        if (result.status === "missing") {
+            console.info((0, colorette_1.yellow)(`[skip] ${result.key}: directory missing; run 'newbie install'.`));
+        }
+        else if (result.status === "drifted") {
+            console.info((0, colorette_1.yellow)(`[skip] ${result.key}: local changes detected (${result.patchIds.length} file(s)); re-run with --force to overwrite.`));
+        }
+    }
+    const updatable = inspections.filter((result) => result.status === "update-available");
+    if (updatable.length === 0) {
+        console.info((0, colorette_1.green)("\n[info] All modules are up to date.\n"));
+        return;
+    }
+    let selected;
+    if (options.all || options.dryRun) {
+        selected = updatable;
+    }
+    else {
+        const selectedKeys = await (0, prompts_1.checkbox)({
+            message: "Which modules do you want to update:",
+            choices: updatable.map((result) => ({
+                value: result.key,
+                name: `${result.key} ${(0, colorette_1.inverse)(short(result.fromCommit))} -> ${(0, colorette_1.cyan)(short(result.toCommit))}`,
+                checked: true,
+            })),
+            pageSize: 100,
+            loop: true,
+        });
+        selected = updatable.filter((result) => selectedKeys.includes(result.key));
+    }
+    if (selected.length === 0) {
+        console.info("\n[info] No modules selected.\n");
+        return;
+    }
+    if (!options.yes && !options.dryRun) {
+        const confirmed = await (0, prompts_1.select)({
+            message: `Do you want to UPDATE ${(0, colorette_1.cyan)(selected.map((result) => result.key).join(", "))}?`,
+            choices: [
+                { name: "Yes", value: "yes" },
+                { name: "No", value: "no" },
+            ],
+        });
+        if (confirmed !== "yes") {
+            console.info("\n[info] Update cancelled.\n");
+            return;
+        }
+    }
+    const selectedKeys = selected.map((result) => result.key);
+    await (0, pipeline_1.runSteps)(ctx, {
+        added: selectedKeys,
+        removed: [],
+        enabledKeys: keys,
+    });
+    if (!sink.dryRun) {
+        await (0, modules_state_2.writeModulesState)(cwd, sink, ctx.state);
+    }
+    ctx.issues.assertEmpty();
+    console.info((0, colorette_1.bold)((0, colorette_1.green)("\nC O M P L E T E\n")));
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

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

package/dist/constants/paths.d.ts

@@ -0,0 +1,12 @@
+export declare const MODULES_JSON = "modules.json";
+export declare const MODULES_DIR = "src/modules";
+export declare const MODULES_MODULE_TS = "src/modules/modules.module.ts";
+export declare const MODULES_CONFIG_TS = "src/modules/modules.config.ts";
+export declare const MODULE_MANIFEST_FILE = "newbie.module.json";
+export declare const PRISMA_SCHEMA_MAIN = "prisma/schema.prisma";
+export declare const PRISMA_SCHEMA_MODELS_DIR = "prisma/models";
+export declare const ENV_PATH = ".env";
+export declare const ENV_EXAMPLE_PATH = ".env.example";
+export declare const NEST_CLI_JSON = "nest-cli.json";
+export declare const REGISTRY_MODULES_DIR = "packages/modules";
+export declare const ENV_TOOL_CONFIG_CANDIDATES: string[];

package/dist/constants/paths.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENV_TOOL_CONFIG_CANDIDATES = exports.REGISTRY_MODULES_DIR = exports.NEST_CLI_JSON = exports.ENV_EXAMPLE_PATH = exports.ENV_PATH = exports.PRISMA_SCHEMA_MODELS_DIR = exports.PRISMA_SCHEMA_MAIN = exports.MODULE_MANIFEST_FILE = exports.MODULES_CONFIG_TS = exports.MODULES_MODULE_TS = exports.MODULES_DIR = exports.MODULES_JSON = void 0;
+exports.MODULES_JSON = "modules.json";
+exports.MODULES_DIR = "src/modules";
+exports.MODULES_MODULE_TS = "src/modules/modules.module.ts";
+exports.MODULES_CONFIG_TS = "src/modules/modules.config.ts";
+exports.MODULE_MANIFEST_FILE = "newbie.module.json";
+exports.PRISMA_SCHEMA_MAIN = "prisma/schema.prisma";
+exports.PRISMA_SCHEMA_MODELS_DIR = "prisma/models";
+exports.ENV_PATH = ".env";
+exports.ENV_EXAMPLE_PATH = ".env.example";
+exports.NEST_CLI_JSON = "nest-cli.json";
+exports.REGISTRY_MODULES_DIR = "packages/modules";
+exports.ENV_TOOL_CONFIG_CANDIDATES = [
+    ".newbie/env.config.json",
+    ".newbie-env-tool/.config/config.json",
+];
+//# sourceMappingURL=paths.js.map

package/dist/constants/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/constants/paths.ts"],"names":[],"mappings":";;;AAOa,QAAA,YAAY,GAAG,cAAc,CAAC;AAE9B,QAAA,WAAW,GAAG,aAAa,CAAC;AAC5B,QAAA,iBAAiB,GAAG,+BAA+B,CAAC;AACpD,QAAA,iBAAiB,GAAG,+BAA+B,CAAC;AAGpD,QAAA,oBAAoB,GAAG,oBAAoB,CAAC;AAE5C,QAAA,kBAAkB,GAAG,sBAAsB,CAAC;AAC5C,QAAA,wBAAwB,GAAG,eAAe,CAAC;AAE3C,QAAA,QAAQ,GAAG,MAAM,CAAC;AAClB,QAAA,gBAAgB,GAAG,cAAc,CAAC;AAClC,QAAA,aAAa,GAAG,eAAe,CAAC;AAGhC,QAAA,oBAAoB,GAAG,kBAAkB,CAAC;AAG1C,QAAA,0BAA0B,GAAG;IACxC,yBAAyB;IACzB,sCAAsC;CACvC,CAAC"}

package/dist/core/assets.d.ts

@@ -0,0 +1,8 @@
+export type NestAsset = string | {
+    include: string;
+    outDir?: string;
+};
+export declare function isSameAsset(a: NestAsset, b: NestAsset): boolean;
+export declare function addAssets(existing: NestAsset[], additions: NestAsset[]): NestAsset[];
+export declare function removeAssets(existing: NestAsset[], removals: NestAsset[]): NestAsset[];
+export declare function dedupeAssets(assets: NestAsset[]): NestAsset[];

package/dist/core/assets.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSameAsset = isSameAsset;
+exports.addAssets = addAssets;
+exports.removeAssets = removeAssets;
+exports.dedupeAssets = dedupeAssets;
+function isSameAsset(a, b) {
+    if (typeof a === "string" || typeof b === "string") {
+        return a === b;
+    }
+    return a.include === b.include && (a.outDir ?? null) === (b.outDir ?? null);
+}
+function addAssets(existing, additions) {
+    const next = [...existing];
+    for (const asset of additions) {
+        if (!next.some((candidate) => isSameAsset(candidate, asset))) {
+            next.push(asset);
+        }
+    }
+    return next;
+}
+function removeAssets(existing, removals) {
+    return existing.filter((asset) => !removals.some((removal) => isSameAsset(asset, removal)));
+}
+function dedupeAssets(assets) {
+    return assets
+        .filter(Boolean)
+        .filter((asset, index, all) => all.findIndex((item) => isSameAsset(item, asset)) === index);
+}
+//# sourceMappingURL=assets.js.map

package/dist/core/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../src/core/assets.ts"],"names":[],"mappings":";;AAOA,kCAKC;AAGD,8BAWC;AAGD,oCAOC;AAGD,oCAOC;AAvCD,SAAgB,WAAW,CAAC,CAAY,EAAE,CAAY;IACpD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QACnD,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC;AAC9E,CAAC;AAGD,SAAgB,SAAS,CACvB,QAAqB,EACrB,SAAsB;IAEtB,MAAM,IAAI,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,WAAW,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;YAC7D,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAGD,SAAgB,YAAY,CAC1B,QAAqB,EACrB,QAAqB;IAErB,OAAO,QAAQ,CAAC,MAAM,CACpB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CACpE,CAAC;AACJ,CAAC;AAGD,SAAgB,YAAY,CAAC,MAAmB;IAC9C,OAAO,MAAM;SACV,MAAM,CAAC,OAAO,CAAC;SACf,MAAM,CACL,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CACpB,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,KAAK,KAAK,CAC9D,CAAC;AACN,CAAC"}

package/dist/core/dependency-plan.d.ts

@@ -0,0 +1,12 @@
+export interface DependencyDecls {
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+}
+export declare function planDependencyRemovals(removedDecls: DependencyDecls[], enabledDecls: DependencyDecls[]): {
+    dependencies: string[];
+    devDependencies: string[];
+};
+export declare function buildInstallSpecs(decls: DependencyDecls[]): {
+    dependencies: string[];
+    devDependencies: string[];
+};

package/dist/core/dependency-plan.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.planDependencyRemovals = planDependencyRemovals;
+exports.buildInstallSpecs = buildInstallSpecs;
+function planDependencyRemovals(removedDecls, enabledDecls) {
+    const keptDependencies = new Set();
+    const keptDevDependencies = new Set();
+    for (const decl of enabledDecls) {
+        Object.keys(decl.dependencies ?? {}).forEach((name) => keptDependencies.add(name));
+        Object.keys(decl.devDependencies ?? {}).forEach((name) => keptDevDependencies.add(name));
+    }
+    const removedDependencies = new Set();
+    const removedDevDependencies = new Set();
+    for (const decl of removedDecls) {
+        for (const name of Object.keys(decl.dependencies ?? {})) {
+            if (!keptDependencies.has(name))
+                removedDependencies.add(name);
+        }
+        for (const name of Object.keys(decl.devDependencies ?? {})) {
+            if (!keptDevDependencies.has(name))
+                removedDevDependencies.add(name);
+        }
+    }
+    return {
+        dependencies: [...removedDependencies],
+        devDependencies: [...removedDevDependencies],
+    };
+}
+function buildInstallSpecs(decls) {
+    const dependencies = [];
+    const devDependencies = [];
+    for (const decl of decls) {
+        for (const [name, range] of Object.entries(decl.dependencies ?? {})) {
+            dependencies.push(`${name}@${range}`);
+        }
+        for (const [name, range] of Object.entries(decl.devDependencies ?? {})) {
+            devDependencies.push(`${name}@${range}`);
+        }
+    }
+    return { dependencies, devDependencies };
+}
+//# sourceMappingURL=dependency-plan.js.map

package/dist/core/dependency-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-plan.js","sourceRoot":"","sources":["../../src/core/dependency-plan.ts"],"names":[],"mappings":";;AAWA,wDAgCC;AAGD,8CAiBC;AApDD,SAAgB,sBAAsB,CACpC,YAA+B,EAC/B,YAA+B;IAE/B,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC3C,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAU,CAAC;IAE9C,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CACpD,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAC3B,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CACvD,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAC9B,CAAC;IACJ,CAAC;IAED,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9C,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAAU,CAAC;IAEjD,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,CAAC;YACxD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjE,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAED,OAAO;QACL,YAAY,EAAE,CAAC,GAAG,mBAAmB,CAAC;QACtC,eAAe,EAAE,CAAC,GAAG,sBAAsB,CAAC;KAC7C,CAAC;AACJ,CAAC;AAGD,SAAgB,iBAAiB,CAAC,KAAwB;IAIxD,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,MAAM,eAAe,GAAa,EAAE,CAAC;IAErC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,CAAC;YACpE,YAAY,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC;QACxC,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC,EAAE,CAAC;YACvE,eAAe,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC;AAC3C,CAAC"}

package/dist/core/drift.d.ts

@@ -0,0 +1,9 @@
+export type FileSnapshot = ReadonlyMap<string, string>;
+export interface DriftReport {
+    added: string[];
+    removed: string[];
+    changed: string[];
+    clean: boolean;
+}
+export declare function diffSnapshots(local: FileSnapshot, pristine: FileSnapshot): DriftReport;
+export declare function driftPatchIds(report: DriftReport): string[];

package/dist/core/drift.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.diffSnapshots = diffSnapshots;
+exports.driftPatchIds = driftPatchIds;
+function diffSnapshots(local, pristine) {
+    const added = [];
+    const removed = [];
+    const changed = [];
+    for (const [file, hash] of local) {
+        if (!pristine.has(file)) {
+            added.push(file);
+        }
+        else if (pristine.get(file) !== hash) {
+            changed.push(file);
+        }
+    }
+    for (const file of pristine.keys()) {
+        if (!local.has(file))
+            removed.push(file);
+    }
+    added.sort();
+    removed.sort();
+    changed.sort();
+    return {
+        added,
+        removed,
+        changed,
+        clean: added.length === 0 && removed.length === 0 && changed.length === 0,
+    };
+}
+function driftPatchIds(report) {
+    return [...report.added, ...report.changed, ...report.removed].sort();
+}
+//# sourceMappingURL=drift.js.map

package/dist/core/drift.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift.js","sourceRoot":"","sources":["../../src/core/drift.ts"],"names":[],"mappings":";;AAsBA,sCA4BC;AAGD,sCAEC;AAjCD,SAAgB,aAAa,CAC3B,KAAmB,EACnB,QAAsB;IAEtB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;QACjC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;aAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACvC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,IAAI,EAAE,CAAC;IACb,OAAO,CAAC,IAAI,EAAE,CAAC;IACf,OAAO,CAAC,IAAI,EAAE,CAAC;IACf,OAAO;QACL,KAAK;QACL,OAAO;QACP,OAAO;QACP,KAAK,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;KAC1E,CAAC;AACJ,CAAC;AAGD,SAAgB,aAAa,CAAC,MAAmB;IAC/C,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;AACxE,CAAC"}

package/dist/core/env-file.d.ts

@@ -0,0 +1,19 @@
+export type EnvLine = {
+    kind: "blank";
+} | {
+    kind: "comment";
+    text: string;
+} | {
+    kind: "entry";
+    key: string;
+    value: string;
+};
+export declare function parseEnv(content: string): EnvLine[];
+export declare function serializeEnv(lines: EnvLine[]): string;
+export declare function envValues(lines: EnvLine[]): Record<string, string>;
+export declare function removeEnvKeys(lines: EnvLine[], keys: ReadonlySet<string>): EnvLine[];
+export declare function upsertEnvSection(lines: EnvLine[], title: string, entries: Record<string, string>): EnvLine[];
+export declare function pruneEmptySections(lines: EnvLine[]): EnvLine[];
+export declare const MODULES_MARKER_START = "# @@newbie-modules-start";
+export declare const MODULES_MARKER_END = "# @@newbie-modules-end";
+export declare function replaceMarkedBlock(content: string, body: string): string;

package/dist/core/env-file.js

@@ -0,0 +1,184 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MODULES_MARKER_END = exports.MODULES_MARKER_START = void 0;
+exports.parseEnv = parseEnv;
+exports.serializeEnv = serializeEnv;
+exports.envValues = envValues;
+exports.removeEnvKeys = removeEnvKeys;
+exports.upsertEnvSection = upsertEnvSection;
+exports.pruneEmptySections = pruneEmptySections;
+exports.replaceMarkedBlock = replaceMarkedBlock;
+const SINGLE_ENTRY_RE = /^\s*(?:export\s+)?([\w.-]+)\s*=\s*([\s\S]*?)\s*$/;
+const SECTION_TITLE_RE = /^# ! (.+) variables\s*$/;
+const DECORATION_RE = /^#\s*-{5,}\s*$/;
+function parseEnv(content) {
+    const normalized = content.replace(/\r\n?/g, "\n");
+    const rawLines = normalized.split("\n");
+    if (rawLines.length > 0 && rawLines[rawLines.length - 1] === "") {
+        rawLines.pop();
+    }
+    const lines = [];
+    for (const raw of rawLines) {
+        if (raw.trim() === "") {
+            lines.push({ kind: "blank" });
+            continue;
+        }
+        if (raw.trimStart().startsWith("#")) {
+            lines.push({ kind: "comment", text: raw });
+            continue;
+        }
+        const match = raw.match(SINGLE_ENTRY_RE);
+        if (!match) {
+            lines.push({ kind: "comment", text: raw });
+            continue;
+        }
+        const [, key, rawValue] = match;
+        lines.push({ kind: "entry", key, value: unquote(rawValue.trim()) });
+    }
+    return lines;
+}
+function unquote(value) {
+    const quote = value[0];
+    if (quote === '"' || quote === "'" || quote === "`") {
+        if (value[value.length - 1] === quote) {
+            return value.slice(1, -1);
+        }
+    }
+    return value;
+}
+function serializeEnv(lines) {
+    const text = lines
+        .map((line) => {
+        if (line.kind === "blank")
+            return "";
+        if (line.kind === "comment")
+            return line.text;
+        return `${line.key}=${formatValue(line.value)}`;
+    })
+        .join("\n");
+    return text.length > 0 ? `${text}\n` : "";
+}
+function formatValue(value) {
+    if (value.includes("\n") ||
+        /^[\s]|[\s]$/.test(value) ||
+        value.includes("#")) {
+        return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+    }
+    return value;
+}
+function envValues(lines) {
+    const result = {};
+    for (const line of lines) {
+        if (line.kind === "entry") {
+            result[line.key] = line.value;
+        }
+    }
+    return result;
+}
+function removeEnvKeys(lines, keys) {
+    return lines.filter((line) => line.kind !== "entry" || !keys.has(line.key));
+}
+function findSectionRange(lines, title) {
+    const titleIndex = lines.findIndex((line) => line.kind === "comment" &&
+        line.text.match(SECTION_TITLE_RE)?.[1] === title);
+    if (titleIndex === -1)
+        return null;
+    let start = titleIndex;
+    if (titleIndex - 2 >= 0 &&
+        lines[titleIndex - 1].kind === "comment" &&
+        DECORATION_RE.test(lines[titleIndex - 1].text) &&
+        lines[titleIndex - 2].kind === "comment" &&
+        DECORATION_RE.test(lines[titleIndex - 2].text)) {
+        start = titleIndex - 2;
+    }
+    let end = lines.length;
+    for (let i = titleIndex + 1; i < lines.length; i++) {
+        const candidate = lines[i];
+        if (candidate.kind === "comment" &&
+            DECORATION_RE.test(candidate.text) &&
+            lines[i + 2]?.kind === "comment" &&
+            SECTION_TITLE_RE.test(lines[i + 2].text)) {
+            end = i;
+            break;
+        }
+    }
+    return { start, end };
+}
+function sectionHeader(title) {
+    return [
+        { kind: "blank" },
+        {
+            kind: "comment",
+            text: "# ----------------------------------------------------------------------------------",
+        },
+        { kind: "comment", text: `# ! ${title} variables` },
+        {
+            kind: "comment",
+            text: "# ----------------------------------------------------------------------------------",
+        },
+    ];
+}
+function upsertEnvSection(lines, title, entries) {
+    const newKeys = Object.keys(entries);
+    if (newKeys.length === 0)
+        return lines;
+    const existingKeys = new Set(Object.keys(envValues(lines)));
+    const range = findSectionRange(lines, title);
+    if (!range) {
+        const next = [...lines];
+        next.push(...sectionHeader(title));
+        for (const key of newKeys) {
+            next.push({ kind: "entry", key, value: entries[key] });
+        }
+        return next;
+    }
+    const next = [...lines];
+    const insertAt = [];
+    for (const key of newKeys) {
+        if (!existingKeys.has(key)) {
+            insertAt.push({ kind: "entry", key, value: entries[key] });
+        }
+    }
+    next.splice(range.end, 0, ...insertAt);
+    return next;
+}
+function pruneEmptySections(lines) {
+    const titles = [];
+    for (const line of lines) {
+        if (line.kind === "comment") {
+            const match = line.text.match(SECTION_TITLE_RE);
+            if (match)
+                titles.push(match[1]);
+        }
+    }
+    let next = lines;
+    for (const title of titles) {
+        const range = findSectionRange(next, title);
+        if (!range)
+            continue;
+        const body = next.slice(range.start, range.end);
+        if (!body.some((line) => line.kind === "entry")) {
+            next = [...next.slice(0, range.start), ...next.slice(range.end)];
+            if (next[range.start]?.kind === "blank") {
+                next = [...next.slice(0, range.start), ...next.slice(range.start + 1)];
+            }
+        }
+    }
+    return next;
+}
+exports.MODULES_MARKER_START = "# @@newbie-modules-start";
+exports.MODULES_MARKER_END = "# @@newbie-modules-end";
+function replaceMarkedBlock(content, body) {
+    const startIndex = content.indexOf(exports.MODULES_MARKER_START);
+    const endIndex = content.indexOf(exports.MODULES_MARKER_END);
+    const block = `${exports.MODULES_MARKER_START}\n${body}${exports.MODULES_MARKER_END}\n`;
+    if (startIndex !== -1 && endIndex !== -1 && startIndex < endIndex) {
+        const lineStart = content.lastIndexOf("\n", startIndex);
+        const blockStart = lineStart === -1 ? 0 : lineStart + 1;
+        const afterEnd = endIndex + exports.MODULES_MARKER_END.length;
+        return `${content.slice(0, blockStart)}${block}${content[afterEnd] === "\n" ? content.slice(afterEnd + 1) : content.slice(afterEnd)}`;
+    }
+    const separator = content.length === 0 || content.endsWith("\n") ? "" : "\n";
+    return `${content}${separator}\n${block}`;
+}
+//# sourceMappingURL=env-file.js.map

package/dist/core/env-file.js.map

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

package/dist/core/module-manifest.d.ts

@@ -0,0 +1,19 @@
+import { NestAsset } from "./assets";
+export interface ModuleWiring {
+    file: string;
+    className: string;
+}
+export interface ModuleManifest {
+    key: string;
+    module: ModuleWiring;
+    schema?: string;
+    "config-service"?: Record<string, unknown>;
+    env?: Record<string, string>;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    assets?: NestAsset[];
+    [key: string]: unknown;
+}
+export declare function normalizeModuleManifest(raw: unknown, expectedKey?: string): ModuleManifest;
+export declare function moduleImportLine(key: string, manifest: ModuleManifest): string;
+export declare function sanitizeModuleNames(names: string[], knownKeys: ReadonlySet<string>): string[];

package/dist/core/module-manifest.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeModuleManifest = normalizeModuleManifest;
+exports.moduleImportLine = moduleImportLine;
+exports.sanitizeModuleNames = sanitizeModuleNames;
+function normalizeModuleManifest(raw, expectedKey) {
+    if (!raw || typeof raw !== "object") {
+        throw new Error("Invalid newbie.module.json: expected an object.");
+    }
+    const data = raw;
+    if (typeof data.key !== "string" || data.key.length === 0) {
+        throw new Error("Invalid newbie.module.json: string 'key' is required.");
+    }
+    if (expectedKey && data.key !== expectedKey) {
+        throw new Error(`Invalid newbie.module.json: key '${data.key}' does not match directory '${expectedKey}'.`);
+    }
+    const wiring = data.module;
+    if (!wiring ||
+        typeof wiring.file !== "string" ||
+        typeof wiring.className !== "string" ||
+        wiring.file.length === 0 ||
+        wiring.className.length === 0) {
+        throw new Error(`Invalid newbie.module.json for '${data.key}': module.file and module.className strings are required.`);
+    }
+    const manifest = {
+        ...data,
+        key: data.key,
+        module: { file: wiring.file, className: wiring.className },
+    };
+    if (typeof data.schema !== "string")
+        delete manifest.schema;
+    return manifest;
+}
+function moduleImportLine(key, manifest) {
+    return `import {${manifest.module.className}} from './${key}/${manifest.module.file}';`;
+}
+function sanitizeModuleNames(names, knownKeys) {
+    const seen = new Set();
+    const result = [];
+    for (const name of names.map((name) => name.trim())) {
+        if (!knownKeys.has(name) || seen.has(name))
+            continue;
+        seen.add(name);
+        result.push(name);
+    }
+    return result;
+}
+//# sourceMappingURL=module-manifest.js.map

package/dist/core/module-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-manifest.js","sourceRoot":"","sources":["../../src/core/module-manifest.ts"],"names":[],"mappings":";;AA8BA,0DAsCC;AAGD,4CAKC;AAGD,kDAYC;AA7DD,SAAgB,uBAAuB,CACrC,GAAY,EACZ,WAAoB;IAEpB,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,IAAI,GAAG,GAA8B,CAAC;IAE5C,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,WAAW,IAAI,IAAI,CAAC,GAAG,KAAK,WAAW,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,oCAAoC,IAAI,CAAC,GAAG,+BAA+B,WAAW,IAAI,CAC3F,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAA2C,CAAC;IAChE,IACE,CAAC,MAAM;QACP,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;QAC/B,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;QACpC,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;QACxB,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAC7B,CAAC;QACD,MAAM,IAAI,KAAK,CACb,mCAAmC,IAAI,CAAC,GAAG,2DAA2D,CACvG,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAmB;QAC/B,GAAI,IAAe;QACnB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE;KAC3D,CAAC;IACF,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC,MAAM,CAAC;IAC5D,OAAO,QAAQ,CAAC;AAClB,CAAC;AAGD,SAAgB,gBAAgB,CAC9B,GAAW,EACX,QAAwB;IAExB,OAAO,WAAW,QAAQ,CAAC,MAAM,CAAC,SAAS,aAAa,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;AAC1F,CAAC;AAGD,SAAgB,mBAAmB,CACjC,KAAe,EACf,SAA8B;IAE9B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QACpD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QACrD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}