@tulipes/cli 0.1.0-rc.1

package/dist/spec.js

@@ -0,0 +1,101 @@
+import { writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { mkdirSync } from "node:fs";
+import { importFromApp } from "./app-core.js";
+import { inspectApp } from "./inspection.js";
+export async function runSpec(rootDir, options) {
+    if (!options.openapi && !options.postman) {
+        console.error([
+            "nothing to write — name at least one output:",
+            "",
+            "  tulipes spec --openapi openapi.json",
+            "  tulipes spec --postman collection.json",
+            "  tulipes spec --openapi openapi.json --postman collection.json --url https://api.example.com",
+        ].join("\n"));
+        process.exitCode = 2;
+        return;
+    }
+    const spec = await loadGenerator(rootDir);
+    if (!spec)
+        return;
+    const handle = await inspectApp(rootDir, options.offline);
+    try {
+        const source = spec.extract(handle.ctx);
+        if (source.routes.length === 0) {
+            console.log("no routes declared — nothing to describe");
+            return;
+        }
+        const url = options.url ?? (handle.env ? defaultUrl(handle.env) : "http://localhost:3000");
+        const warnings = new Set();
+        if (options.openapi) {
+            const { document, warnings: issues } = await spec.toOpenApi(source, { servers: [url] });
+            issues.forEach((issue) => warnings.add(issue));
+            write(options.openapi, document);
+        }
+        if (options.postman) {
+            const { document, warnings: issues } = await spec.toPostman(source, { baseUrl: url });
+            issues.forEach((issue) => warnings.add(issue));
+            write(options.postman, document);
+        }
+        console.log(`\n${source.routes.length} endpoint(s) across ${source.folders.length} folder(s): ` +
+            source.folders.join(", "));
+        // A schema that produced no shape still documents the endpoint, so
+        // this is a warning and not a failure — but it is worth saying,
+        // because the document is quietly less useful than it looks.
+        if (warnings.size > 0) {
+            console.warn(`\n${warnings.size} schema(s) could not be described:`);
+            for (const warning of warnings)
+                console.warn(`  ! ${warning}`);
+        }
+    }
+    finally {
+        await handle.shutdown();
+    }
+}
+/**
+ * Loads the generator **from the app**, not from wherever this CLI lives.
+ *
+ * `tulipes` is normally installed globally, so a bare `import("@tulipes/spec")`
+ * resolves against the CLI's own node_modules and misses the copy the app
+ * just installed — reporting it as absent while it sits right there. The
+ * app's own resolution root is the only one that can be right.
+ */
+async function loadGenerator(rootDir) {
+    for (const load of [() => fromApp(rootDir), fromCli]) {
+        const spec = await load();
+        if (spec)
+            return spec;
+    }
+    console.error([
+        "`tulipes spec` needs the generator package:",
+        "",
+        "  yarn add -D @tulipes/spec",
+        "",
+        "It is separate so an app that never generates a spec never installs it.",
+    ].join("\n"));
+    process.exitCode = 2;
+    return undefined;
+}
+const fromApp = (rootDir) => importFromApp(rootDir, "@tulipes/spec");
+/** A locally installed CLI, or a hoisted layout, resolves it directly. */
+async function fromCli() {
+    try {
+        return (await import("@tulipes/spec"));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Whatever the app itself would be reachable at, so the document is usable as written. */
+function defaultUrl(env) {
+    const port = env.store.has("PORT") ? Number(env.get("PORT")) : 3000;
+    const domain = env.store.has("PUBLIC_DOMAIN") ? String(env.get("PUBLIC_DOMAIN")) : "localhost";
+    return domain === "localhost" ? `http://localhost:${port}` : `https://${domain}`;
+}
+function write(target, document) {
+    const path = resolve(target);
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(document, null, 2)}\n`);
+    console.log(`  wrote ${target}`);
+}
+//# sourceMappingURL=spec.js.map

package/dist/spec.js.map

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

package/dist/sync.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `tulipes sync` — everything derivable from the meta files, derived:
+ *
+ *   types/config.d.ts  KnownVariables + GlobalConfig augmentations. Config
+ *                      namespaces are typed as each factory's RETURN TYPE via
+ *                      `typeof import(...)` — the compiler does the inference,
+ *                      codegen never executes module code.
+ *   .env.example       every variable, grouped by module and `group`.
+ *
+ * Both files are committed and marked generated.
+ */
+export declare function runSync(rootDir: string): Promise<void>;

package/dist/sync.js

@@ -0,0 +1,117 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join, relative } from "node:path";
+import { BootReport } from "@tulipes/core/errors";
+import { discoverModuleMeta } from "@tulipes/core/env";
+import { discoverModules } from "@tulipes/core/modules";
+import { sortModules } from "@tulipes/core/modules";
+import { exploreModules } from "@tulipes/core/modules";
+/**
+ * `tulipes sync` — everything derivable from the meta files, derived:
+ *
+ *   types/config.d.ts  KnownVariables + GlobalConfig augmentations. Config
+ *                      namespaces are typed as each factory's RETURN TYPE via
+ *                      `typeof import(...)` — the compiler does the inference,
+ *                      codegen never executes module code.
+ *   .env.example       every variable, grouped by module and `group`.
+ *
+ * Both files are committed and marked generated.
+ */
+export async function runSync(rootDir) {
+    const report = new BootReport();
+    const modulesDir = join(rootDir, "modules");
+    const metas = discoverModuleMeta(modulesDir, report);
+    const order = sortModules(discoverModules(modulesDir, report), report);
+    report.throwIfAny("sync");
+    const metaByModule = new Map(metas.map((meta) => [meta.module, meta]));
+    // Meta discovery walks folders; align it to load order for stable output.
+    const orderedMetas = order
+        .map((module) => metaByModule.get(module.name))
+        .filter((meta) => meta !== undefined);
+    const typesDir = join(rootDir, "types");
+    mkdirSync(typesDir, { recursive: true });
+    const dtsPath = join(typesDir, "config.d.ts");
+    writeFileSync(dtsPath, renderDts(rootDir, orderedMetas, order));
+    console.log(`wrote ${relative(rootDir, dtsPath)}`);
+    const envExamplePath = join(rootDir, ".env.example");
+    writeFileSync(envExamplePath, renderEnvExample(orderedMetas));
+    console.log(`wrote ${relative(rootDir, envExamplePath)}`);
+}
+function renderDts(rootDir, metas, order) {
+    const variableLines = metas.flatMap((meta) => meta.variables.flatMap((spec) => [
+        `    /** [${meta.module}] ${spec.description} */`,
+        `    ${spec.name}: ${tsTypeOf(spec)};`,
+    ]));
+    // Only modules with a config factory get a typed namespace; the rest fall
+    // back to GlobalConfig's index signature.
+    const configLines = exploreModules(order)
+        .filter((files) => files.configFile)
+        .flatMap((files) => {
+        const specifier = "./" + relative(join(rootDir, "types"), files.configFile).replace(/\.ts$/, ".js");
+        // Optional on purpose: a namespace only exists once phase 6 has run
+        // its factory, and an empty config seed must stay assignable.
+        return [
+            `    ${JSON.stringify(files.module.name)}?: Awaited<`,
+            `      ReturnType<(typeof import("${specifier}"))["default"]>`,
+            `    >;`,
+        ];
+    });
+    return [
+        "// AUTO-GENERATED by `tulipes sync` — do not edit.",
+        "",
+        'declare module "@tulipes/core/env" {',
+        "  interface KnownVariables {",
+        ...variableLines,
+        "  }",
+        "}",
+        "",
+        'declare module "@tulipes/core/config" {',
+        "  interface GlobalConfig {",
+        ...configLines,
+        "  }",
+        "}",
+        "",
+        "export {};",
+        "",
+    ].join("\n");
+}
+function tsTypeOf(spec) {
+    switch (spec.type) {
+        case "number":
+            return "number";
+        case "boolean":
+            return "boolean";
+        case "enum":
+            return spec.enum.map((value) => JSON.stringify(value)).join(" | ");
+        default: // string, url, secret
+            return "string";
+    }
+}
+function renderEnvExample(metas) {
+    const lines = [
+        "# AUTO-GENERATED by `tulipes sync` from every module's meta.variables.json.",
+        "# Copy into .envs/.env.<mode> and fill in the blanks.",
+    ];
+    for (const meta of metas) {
+        if (meta.variables.length === 0)
+            continue;
+        lines.push("", `# ━━━ ${meta.module} ━━━`);
+        // Stable grouping: order of first appearance, ungrouped vars last.
+        const groups = new Map();
+        for (const spec of meta.variables) {
+            const key = spec.group ?? "";
+            (groups.get(key) ?? groups.set(key, []).get(key)).push(spec);
+        }
+        for (const [group, specs] of [...groups.entries()].sort(([a], [b]) => Number(a === "") - Number(b === ""))) {
+            if (group)
+                lines.push("", `# ── ${group} ──`);
+            for (const spec of specs) {
+                const constraint = spec.type === "enum" ? `enum: ${spec.enum.join(" | ")}` : spec.type;
+                const requirement = spec.required ? ", REQUIRED" : "";
+                lines.push(`# ${spec.description} (${constraint}${requirement})`);
+                lines.push(`${spec.name}=${spec.default ?? ""}`);
+            }
+        }
+    }
+    return lines.join("\n") + "\n";
+}
+//# sourceMappingURL=sync.js.map

package/dist/sync.js.map

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

package/dist/update.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `tulipes update` — move to the latest published CLI and core.
+ *
+ * There are two things that can be out of date, and they are genuinely
+ * separate installs:
+ *
+ *   the CLI    the globally installed `tulipes` on your PATH (@tulipes/cli)
+ *   the app    @tulipes/core in the app root and in every module, since
+ *              modules are workspace packages that declare it themselves,
+ *              plus the app's own @tulipes/cli devDependency
+ *
+ * Provider packages (@tulipes/mongoose, /bullmq, /socket.io) follow their
+ * own lines and are not rewritten here; MIGRATING.md lists the pairing.
+ *
+ * Updating only the app leaves you typing an old CLI against a new
+ * framework; updating only the CLI leaves the app behind. This does both,
+ * and either alone when only one applies — so it is also useful outside an
+ * app, where it upgrades just the CLI.
+ */
+export declare function runUpdate(rootDir: string): Promise<void>;

package/dist/update.js

@@ -0,0 +1,240 @@
+import { spawn } from "node:child_process";
+import { existsSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
+import { join, relative, resolve, sep } from "node:path";
+import { appCoreVersion, cliVersion, packageRoot } from "./package-info.js";
+const PACKAGE = "@tulipes/core";
+const CLI = "@tulipes/cli";
+const REGISTRY = "https://registry.npmjs.org";
+/**
+ * `tulipes update` — move to the latest published CLI and core.
+ *
+ * There are two things that can be out of date, and they are genuinely
+ * separate installs:
+ *
+ *   the CLI    the globally installed `tulipes` on your PATH (@tulipes/cli)
+ *   the app    @tulipes/core in the app root and in every module, since
+ *              modules are workspace packages that declare it themselves,
+ *              plus the app's own @tulipes/cli devDependency
+ *
+ * Provider packages (@tulipes/mongoose, /bullmq, /socket.io) follow their
+ * own lines and are not rewritten here; MIGRATING.md lists the pairing.
+ *
+ * Updating only the app leaves you typing an old CLI against a new
+ * framework; updating only the CLI leaves the app behind. This does both,
+ * and either alone when only one applies — so it is also useful outside an
+ * app, where it upgrades just the CLI.
+ */
+export async function runUpdate(rootDir) {
+    const current = cliVersion();
+    let latest;
+    let latestCli;
+    try {
+        [latest, latestCli] = await Promise.all([fetchLatest(PACKAGE), fetchLatest(CLI)]);
+    }
+    catch (error) {
+        console.error(`could not reach the npm registry: ${error.message}`);
+        process.exitCode = 1;
+        return;
+    }
+    const cliRoot = packageRoot();
+    // Updatable-as-a-CLI means: an installed package (it lives under some
+    // node_modules) that is NOT this app's own copy — the app's copy is
+    // covered by the dependency update below. A source checkout matches
+    // neither and is left alone, since git owns its version, not npm.
+    const cliIsGlobal = !cliRoot.startsWith(resolve(rootDir) + sep) &&
+        cliRoot.includes(`${sep}node_modules${sep}`);
+    let didSomething = false;
+    if (cliIsGlobal) {
+        didSomething = true;
+        if (current === latestCli) {
+            console.log(`cli already on ${latestCli}`);
+        }
+        else {
+            await updateGlobalCli(cliRoot, current, latestCli);
+        }
+    }
+    const manifests = findManifests(rootDir);
+    if (manifests.length > 0) {
+        didSomething = true;
+        // The app's installed version, not the CLI's — they are separate
+        // installs, and reporting one as the other is how this whole confusion
+        // started.
+        await updateApp(rootDir, manifests, appCoreVersion(rootDir), latest, latestCli);
+    }
+    if (!didSomething) {
+        console.error(`no package.json in ${rootDir} depends on ${PACKAGE}, and this CLI is not a global install — run it from an app root`);
+        process.exitCode = 1;
+    }
+}
+/**
+ * Reinstalls the global CLI into the prefix it already lives in.
+ *
+ * That prefix matters: with a version manager, `npm install -g` installs
+ * for whichever node is *active*, which may not be the one whose bin
+ * directory holds the `tulipes` on your PATH. Deriving the prefix from the
+ * running CLI's own location updates the binary you actually type.
+ */
+async function updateGlobalCli(cliRoot, current, latest) {
+    console.log(`cli: ${current} → ${latest}`);
+    const prefix = globalPrefixOf(cliRoot);
+    const args = ["install", "-g", ...(prefix ? ["--prefix", prefix] : []), `${CLI}@${latest}`];
+    const code = await run("npm", args, cliRoot);
+    if (code !== 0) {
+        console.error(`\ncould not update the global cli — try: npm install -g ${CLI}@${latest}`);
+        process.exitCode = code === -1 ? 1 : code;
+        return;
+    }
+    console.log(`cli updated — the next \`tulipes\` invocation runs ${latest}\n`);
+}
+/** `<prefix>/lib/node_modules/@tulipes/cli` → `<prefix>`, for npm layouts. */
+function globalPrefixOf(cliRoot) {
+    const marker = `${sep}lib${sep}node_modules${sep}`;
+    const index = cliRoot.indexOf(marker);
+    // pnpm and bun keep globals elsewhere; without a recognisable prefix we
+    // let npm pick its own, which is right for a plain npm install.
+    return index === -1 ? undefined : cliRoot.slice(0, index);
+}
+async function updateApp(rootDir, manifests, current, latest, latestCli) {
+    const range = `^${latest}`;
+    const changed = manifests.filter(({ path }) => rewrite(path, range));
+    // The app's own CLI devDependency moves with it, so `yarn dev` and friends
+    // keep matching the framework they generate for.
+    if (rewrite(join(rootDir, "package.json"), `^${latestCli}`, CLI))
+        changed.push({ path: join(rootDir, "package.json") });
+    if (changed.length === 0) {
+        console.log(`app already on ${PACKAGE}@${range}`);
+        return;
+    }
+    for (const { path } of changed) {
+        console.log(`  update ${relative(rootDir, path) || "package.json"} → ${range}`);
+    }
+    console.log(`\napp: ${current ?? "not installed"} → ${latest}\n`);
+    // Rewriting manifests without installing would leave the app claiming a
+    // version it does not have.
+    const manager = detectManager(rootDir);
+    console.log(`running ${manager} install…\n`);
+    const code = await run(manager, ["install"], rootDir);
+    if (code === -1) {
+        console.error(`\ncould not run "${manager}" — manifests are updated, install manually`);
+        process.exitCode = 1;
+        return;
+    }
+    if (code !== 0) {
+        process.exitCode = code;
+        return;
+    }
+    warnAboutBreakingChanges(current, latest);
+}
+/**
+ * Minor bumps below 1.0 carry breaking changes in this project, and an app
+ * skipping several of them will not boot until each is dealt with. Saying
+ * so here — where the jump is actually visible — beats leaving it to be
+ * discovered as a stack trace.
+ */
+function warnAboutBreakingChanges(current, latest) {
+    const from = minorOf(current);
+    const to = minorOf(latest);
+    if (from === undefined || to === undefined || from >= to)
+        return;
+    console.log([
+        "",
+        `This crossed ${to - from} minor version(s), each of which may have`,
+        "changed something breaking. Before running the app:",
+        "",
+        `  https://github.com/kemora13conf/bp-backend-express/blob/v${latest}/packages/core/MIGRATING.md`,
+        "",
+        "It is ordered oldest-first, because the steps build on each other.",
+    ].join("\n"));
+}
+/** The minor of a 0.x version — 0 for anything already at 1.0 or beyond. */
+function minorOf(version) {
+    if (!version)
+        return undefined;
+    const [major, minor] = version.split(".").map(Number);
+    return major === 0 && Number.isInteger(minor) ? minor : undefined;
+}
+async function fetchLatest(name) {
+    // The scoped name has to be encoded for the registry's document route.
+    const response = await fetch(`${REGISTRY}/${name.replace("/", "%2f")}/latest`);
+    if (!response.ok) {
+        throw new Error(`registry responded ${response.status}`);
+    }
+    const body = (await response.json());
+    if (typeof body.version !== "string") {
+        throw new Error("registry returned no version");
+    }
+    return body.version;
+}
+/** The app root plus every module — anywhere the framework is depended on. */
+function findManifests(rootDir) {
+    const candidates = [join(rootDir, "package.json")];
+    const modulesDir = join(rootDir, "modules");
+    try {
+        for (const entry of readdirSync(modulesDir, { withFileTypes: true })) {
+            if (entry.isDirectory()) {
+                candidates.push(join(modulesDir, entry.name, "package.json"));
+            }
+        }
+    }
+    catch {
+        // No modules directory: still a valid target if the root depends on core.
+    }
+    return candidates
+        .filter((path) => existsSync(path) && dependsOnCore(path))
+        .map((path) => ({ path }));
+}
+function dependsOnCore(path) {
+    try {
+        const manifest = JSON.parse(readFileSync(path, "utf8"));
+        return Boolean(manifest.dependencies?.[PACKAGE] ?? manifest.devDependencies?.[PACKAGE]);
+    }
+    catch {
+        return false;
+    }
+}
+/** Returns true when the file actually changed. */
+function rewrite(path, range, name = PACKAGE) {
+    const manifest = JSON.parse(readFileSync(path, "utf8"));
+    let touched = false;
+    for (const field of ["dependencies", "devDependencies"]) {
+        const deps = manifest[field];
+        if (deps?.[name] !== undefined && deps[name] !== range) {
+            deps[name] = range;
+            touched = true;
+        }
+    }
+    if (!touched)
+        return false;
+    writeFileSync(path, JSON.stringify(manifest, null, 2) + "\n");
+    return true;
+}
+/** Resolves to the exit code, or -1 when the command could not be spawned. */
+async function run(command, args, cwd) {
+    return new Promise((resolve_) => {
+        const child = spawn(command, args, { cwd, stdio: "inherit" });
+        child.on("error", () => resolve_(-1));
+        child.on("exit", (status) => resolve_(status ?? 1));
+    });
+}
+function detectManager(rootDir) {
+    if (existsSync(join(rootDir, "yarn.lock")))
+        return "yarn";
+    if (existsSync(join(rootDir, "pnpm-lock.yaml")))
+        return "pnpm";
+    if (existsSync(join(rootDir, "package-lock.json")))
+        return "npm";
+    // No lockfile yet (a fresh scaffold): fall back to the pinned manager.
+    try {
+        const manifest = JSON.parse(readFileSync(join(rootDir, "package.json"), "utf8"));
+        const pinned = manifest.packageManager ?? "";
+        if (pinned.startsWith("pnpm"))
+            return "pnpm";
+        if (pinned.startsWith("npm"))
+            return "npm";
+    }
+    catch {
+        // fall through
+    }
+    return "yarn";
+}
+//# sourceMappingURL=update.js.map

package/dist/update.js.map

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

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@tulipes/cli",
+  "version": "0.1.0-rc.1",
+  "description": "The tulipes command line: scaffold, sync, inspect, describe and run Tulipes apps",
+  "type": "module",
+  "bin": {
+    "tulipes": "./dist/bin.js"
+  },
+  "exports": {
+    ".": "./dist/main.js"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "node -e \"fs.rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.json",
+    "prepack": "yarn build"
+  },
+  "publishConfig": {
+    "access": "public",
+    "bin": {
+      "tulipes": "./dist/bin.js"
+    },
+    "exports": {
+      ".": "./dist/main.js"
+    }
+  },
+  "dependencies": {
+    "@tulipes/core": "^0.10.0-rc.3",
+    "tsx": "^4"
+  },
+  "devDependencies": {
+    "@types/node": "^24.2.0",
+    "typescript": "^7.0.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kemora13conf/bp-backend-express.git",
+    "directory": "packages/cli"
+  },
+  "keywords": [
+    "tulipes",
+    "cli",
+    "scaffold",
+    "express"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=24.0.0 <25"
+  },
+  "homepage": "https://github.com/kemora13conf/bp-backend-express/tree/master/packages/cli#readme",
+  "bugs": {
+    "url": "https://github.com/kemora13conf/bp-backend-express/issues"
+  }
+}