@tulipes/cli 0.1.0-rc.1

package/dist/minimal.js.map

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

package/dist/new-module.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `tulipes new module <name>` — scaffold every contract a module can hold,
+ * so the shape of a module is obvious from the folder rather than from
+ * memory. Delete what this feature does not need; an absent file is always
+ * valid, and deleting is faster than remembering the filename convention.
+ *
+ * The package scope is borrowed from an existing sibling so the app keeps
+ * one naming convention without configuring it anywhere.
+ *
+ * Model and bootstrap files are emitted only when the app has selected a
+ * models provider (`tulipes.providers.models` in its package.json): in a
+ * provider-free app they would make the module require a database the app
+ * refuses to boot without. `--model` / `--no-model` override the detection.
+ */
+export declare function runNewModule(rootDir: string, name: string, options?: {
+    models?: boolean;
+    queues?: boolean;
+    sockets?: boolean;
+}): Promise<void>;

package/dist/new-module.js

@@ -0,0 +1,348 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { BootReport } from "@tulipes/core/errors";
+import { readProviderDeclarations } from "@tulipes/core/boot";
+import { coreVersion } from "./package-info.js";
+/**
+ * `tulipes new module <name>` — scaffold every contract a module can hold,
+ * so the shape of a module is obvious from the folder rather than from
+ * memory. Delete what this feature does not need; an absent file is always
+ * valid, and deleting is faster than remembering the filename convention.
+ *
+ * The package scope is borrowed from an existing sibling so the app keeps
+ * one naming convention without configuring it anywhere.
+ *
+ * Model and bootstrap files are emitted only when the app has selected a
+ * models provider (`tulipes.providers.models` in its package.json): in a
+ * provider-free app they would make the module require a database the app
+ * refuses to boot without. `--model` / `--no-model` override the detection.
+ */
+export async function runNewModule(rootDir, name, options = {}) {
+    if (!/^[a-z][a-z0-9-]*$/.test(name)) {
+        console.error(`module name "${name}" is invalid — lowercase kebab-case required`);
+        process.exitCode = 2;
+        return;
+    }
+    const modulesDir = join(rootDir, "modules");
+    const dir = join(modulesDir, name);
+    if (existsSync(dir)) {
+        console.error(`modules/${name} already exists`);
+        process.exitCode = 1;
+        return;
+    }
+    const scope = detectScope(modulesDir) ?? "@app";
+    const locales = detectLocales(modulesDir);
+    const declared = readProviderDeclarations(rootDir, new BootReport());
+    const models = options.models ?? declared.models !== undefined;
+    const queues = options.queues ?? declared.queues !== undefined;
+    const sockets = options.sockets ?? declared.sockets !== undefined;
+    for (const [relPath, content] of renderModule(name, scope, locales, models, queues, sockets)) {
+        const filePath = join(dir, relPath);
+        mkdirSync(dirname(filePath), { recursive: true });
+        writeFileSync(filePath, content);
+        console.log(`  create modules/${name}/${relPath}`);
+    }
+    console.log([
+        "",
+        `scaffolded modules/${name} (${scope}/${name})`,
+        "",
+        "next:",
+        "  yarn install     # the module is a workspace package",
+        "  yarn sync        # regenerate config types and .env.example",
+        "",
+        `Delete unused files; keep route files wrapped in defineRoutes for offline inspection.`,
+        ...(models
+            ? declared.models
+                ? []
+                : ["", "--model was given but package.json declares no models provider: add",
+                    '  "tulipes": { "providers": { "models": "@tulipes/mongoose" } } and install it, or the boot will refuse this module.']
+            : ["", "No models/ or bootstrap/ files: package.json declares no models provider.",
+                "To add a database, declare \"tulipes\": { \"providers\": { \"models\": \"@tulipes/mongoose\" } }, install it,",
+                `then \`tulipes new module ${name} --model\` in a scratch app to copy the model template.`]),
+        ...(queues
+            ? declared.queues
+                ? []
+                : ["", "--queues was given but package.json declares no queues provider: add",
+                    '  "tulipes": { "providers": { "queues": "@tulipes/bullmq" } } and install it, or the boot will refuse this module.']
+            : ["", "No queues/ file: package.json declares no queues provider.",
+                "To add background work, declare \"tulipes\": { \"providers\": { \"queues\": \"@tulipes/bullmq\" } } and install it."]),
+        ...(sockets
+            ? declared.sockets
+                ? []
+                : ["", "--sockets was given but package.json declares no sockets provider: add",
+                    '  "tulipes": { "providers": { "sockets": "@tulipes/socket.io" } } and install it, or the boot will refuse this module.']
+            : ["", "No sockets/ file: package.json declares no sockets provider.",
+                "To add realtime namespaces, declare \"tulipes\": { \"providers\": { \"sockets\": \"@tulipes/socket.io\" } } and install it."]),
+    ].join("\n"));
+}
+const json = (value) => JSON.stringify(value, null, 2) + "\n";
+function renderModule(name, scope, locales, models, queues, sockets) {
+    const fn = camel(name);
+    const Model = pascal(name);
+    const files = [
+        // One file per locale the app already ships. The module IS the i18n
+        // namespace, so `req.t("title")` in this module's endpoints resolves
+        // here and nowhere else. Only the default locale has to be complete —
+        // gaps in the others fall back to it, and are listed in
+        // `<locale>.missing.json` on the next boot.
+        ...locales.map((locale) => [
+            `i18n/${locale}.json`,
+            json({ title: `${name} module` }),
+        ]),
+        ["package.json", json({
+                name: `${scope}/${name}`,
+                version: "0.0.0",
+                private: true,
+                type: "module",
+                // dependsOn "core" because the helpers below import from it. The npm
+                // dependency makes it resolve; dependsOn makes the ordering explicit.
+                tulipes: { offline: true, tier: "app", priority: 100, dependsOn: ["core"] },
+                dependencies: {
+                    "@tulipes/core": `^${coreVersion()}`,
+                    [`${scope}/core`]: "workspace:*",
+                    express: "^5",
+                    ...(models && { "@tulipes/mongoose": "^0.1.0-rc.3", mongoose: "^8" }),
+                    ...(queues && { "@tulipes/bullmq": "^0.1.0-rc.2" }),
+                    ...(sockets && { "@tulipes/socket.io": "^0.1.0-rc.2" }),
+                },
+            })],
+        // Empty on purpose: add an entry the moment this module needs a value
+        // that differs per deployment, then run `yarn sync`.
+        ["meta.variables.json", json({ variables: [] })],
+        ["module.config.ts", [
+                `import type { ConfigCtx, Ctx } from "@tulipes/core/boot";`,
+                ``,
+                `/**`,
+                ` * Runs in boot phase 6. Whatever this returns is stored at`,
+                ` * \`config.${name}\` and typed by \`yarn sync\`, so other modules read it`,
+                ` * without importing anything from here.`,
+                ` */`,
+                `export default function ${fn}Config(_ctx: ConfigCtx) {`,
+                `  return {};`,
+                `}`,
+                ``,
+                `/** After the process is fully up. Delete if unused. */`,
+                `export async function onReady(_ctx: Ctx): Promise<void> {}`,
+                ``,
+                `/** Graceful shutdown, in REVERSE load order. Delete if unused. */`,
+                `export async function onShutdown(_ctx: Ctx): Promise<void> {}`,
+                ``,
+            ].join("\n")],
+        ["module.acl.ts", [
+                `import type { AclBuilder } from "@tulipes/core/acl";`,
+                ``,
+                `/**`,
+                ` * Roles are global and defined once by the sys core module; a feature`,
+                ` * module only attaches grants, on resources namespaced by its own`,
+                ` * name ("${name}:read", "${name}:write").`,
+                ` *`,
+                ` * The grant below is commented out because granting to a role this`,
+                ` * app does not define is a boot crash — uncomment it once you have`,
+                ` * checked which roles exist in modules/core/module.acl.ts.`,
+                ` */`,
+                `export default function ${fn}Acl(_acl: AclBuilder): void {`,
+                `  // _acl.allow("user", "${name}:read");   // the id declared in routes/`,
+                `}`,
+                ``,
+            ].join("\n")],
+        [`helpers/${name}.helpers.ts`, [
+                `/**`,
+                ` * Pure logic: no Express, no database, no framework — trivial to unit`,
+                ` * test. The framework never scans this folder; import from it`,
+                ` * directly. Anything a second module needs belongs in the core`,
+                ` * module instead, imported as ${scope}/core.`,
+                ` */`,
+                `export function describe${Model}(): string {`,
+                `  return "${name}";`,
+                `}`,
+                ``,
+            ].join("\n")],
+        [`controllers/${name}.controllers.ts`, [
+                `import type { Request, RequestHandler, Response } from "express";`,
+                `import type { Ctx } from "@tulipes/core/boot";`,
+                ``,
+                `import { describe${Model} } from "../helpers/${name}.helpers.js";`,
+                ``,
+                `/**`,
+                ` * One class per controller, holding the context. Each method returns a`,
+                ` * handler rather than being one, so the routes file stays a table of`,
+                ` * contents and private helpers sit beside the handlers that use them.`,
+                ` *`,
+                ` * Taking ctx in the constructor is what makes it testable: construct`,
+                ` * one with a stub context and call the method.`,
+                ` */`,
+                `export class ${Model}Controller {`,
+                `  constructor(private readonly ctx: Ctx) {}`,
+                ``,
+                `  index(): RequestHandler {`,
+                `    return (req: Request, res: Response): void => {`,
+                `      // res.respond wraps this in the app's envelope; req.t is already`,
+                `      // bound to this module's i18n namespace. rai() binds both, which`,
+                `      // is one more thing a declared route buys you.`,
+                `      res.respond({`,
+                `        data: {`,
+                `          module: describe${Model}(),`,
+                `          title: req.t("title"),`,
+                `          app: this.ctx.config.app?.name,`,
+                `        },`,
+                `      });`,
+                `    };`,
+                `  }`,
+                `}`,
+                ``,
+            ].join("\n")],
+        [`routes/${name}.routes.ts`, [
+                `import { Router } from "express";`,
+                `import { defineRoutes } from "@tulipes/core/http";`,
+                ``,
+                `export default defineRoutes(({ rai, runtime }) => {`,
+                `  const router = Router();`,
+                `  const controller = runtime(async ctx => {`,
+                `    const { ${Model}Controller } = await import("../controllers/${name}.controllers.js");`,
+                `    return new ${Model}Controller(ctx);`,
+                `  });`,
+                `  router.get("/${name}", rai({ id: "${name}:read", name: "List ${name}" }),`,
+                `    controller(value => value.index()));`,
+                `  return router;`,
+                `});`,
+                ``,
+            ].join("\n")],
+        [`models/${name}.model.ts`, [
+                `import { Schema } from "mongoose";`,
+                `import type { ModelDef } from "@tulipes/mongoose";`,
+                ``,
+                `import { baseSchemaOptions } from "${scope}/core";`,
+                ``,
+                `/**`,
+                ` * A declaration, never a registration: the framework compiles this on`,
+                ` * its own connection and puts it in the model store. Read it anywhere`,
+                ` * with models!.get("${Model}"). Never call mongoose.model() yourself.`,
+                ` */`,
+                `const ${fn}Schema = new Schema(`,
+                `  {`,
+                `    name: { type: String, required: true, trim: true },`,
+                `  },`,
+                `  baseSchemaOptions,`,
+                `);`,
+                ``,
+                `export default { name: "${Model}", schema: ${fn}Schema } satisfies ModelDef;`,
+                ``,
+            ].join("\n")],
+        [`bootstrap/${name}.bootstrap.ts`, [
+                `import type { DatabaseCtx } from "@tulipes/core/boot";`,
+                ``,
+                `/**`,
+                ` * Runs after models are registered and before the process serves —`,
+                ` * indexes, seed rows, defaults.`,
+                ` *`,
+                ` * MUST be idempotent: it runs on every boot of every process. Upsert,`,
+                ` * never blind-insert.`,
+                ` */`,
+                `export default async function ${fn}Bootstrap(_ctx: DatabaseCtx): Promise<void> {}`,
+                ``,
+            ].join("\n")],
+        [`queues/${name}.queues.ts`, [
+                `import type { Ctx } from "@tulipes/core/boot";`,
+                `import type { QueueRegistry } from "@tulipes/bullmq";`,
+                ``,
+                `/**`,
+                ` * ONE file describes both sides. The backend process registers the`,
+                ` * queue so routes can produce into it; \`yarn worker\` turns the`,
+                ` * processor into a live consumer.`,
+                ` *`,
+                ` * Produce from anywhere with ctx.queues:`,
+                ` *   await ctx.queues!.add("${name}.example", "job", { id });`,
+                ` *`,
+                ` * Queue names use "." — BullMQ reserves ":" as its redis separator.`,
+                ` */`,
+                `export default function ${fn}Queues(_ctx: Ctx, queues: QueueRegistry): void {`,
+                `  queues.define("${name}.example");`,
+                ``,
+                `  queues.process("${name}.example", async (job) => {`,
+                `    // Jobs retry, so keep this safe to run twice. Pass ids in`,
+                `    // job.data and re-read state here.`,
+                `    return { handled: job.name };`,
+                `  });`,
+                `}`,
+                ``,
+            ].join("\n")],
+        [`sockets/${name}.sockets.ts`, [
+                `import type { Ctx } from "@tulipes/core/boot";`,
+                `import type { SocketRegistry } from "@tulipes/socket.io";`,
+                ``,
+                `/**`,
+                ` * Backend mode only. A namespace is claimed by exactly one module;`,
+                ` * emit from anywhere with ctx.sockets!.of("/${name}").`,
+                ` */`,
+                `export default function ${fn}Sockets(_ctx: Ctx, sockets: SocketRegistry): void {`,
+                `  sockets.namespace("/${name}", (nsp) => {`,
+                `    nsp.on("connection", (socket) => {`,
+                `      socket.emit("ready", { module: "${name}" });`,
+                `    });`,
+                `  });`,
+                `}`,
+                ``,
+            ].join("\n")],
+    ];
+    return files.filter(([path]) => (models || (!path.startsWith("models/") && !path.startsWith("bootstrap/"))) &&
+        (queues || !path.startsWith("queues/")) &&
+        (sockets || !path.startsWith("sockets/")));
+}
+/**
+ * The locales a sibling module already ships — the same trick as the
+ * package scope: the app's own conventions decide, with nothing to
+ * configure. `en` alone when nothing is translated yet.
+ */
+function detectLocales(modulesDir) {
+    const found = new Set();
+    let entries;
+    try {
+        entries = readdirSync(modulesDir);
+    }
+    catch {
+        return ["en"];
+    }
+    for (const entry of entries) {
+        let files;
+        try {
+            files = readdirSync(join(modulesDir, entry, "i18n"));
+        }
+        catch {
+            continue; // that module has no translations
+        }
+        for (const file of files) {
+            if (file.endsWith(".json") && !file.endsWith(".missing.json")) {
+                found.add(file.replace(/\.json$/, ""));
+            }
+        }
+    }
+    return found.size > 0 ? [...found].sort() : ["en"];
+}
+function detectScope(modulesDir) {
+    let entries;
+    try {
+        entries = readdirSync(modulesDir);
+    }
+    catch {
+        return undefined;
+    }
+    for (const entry of entries) {
+        try {
+            const pkg = JSON.parse(readFileSync(join(modulesDir, entry, "package.json"), "utf8"));
+            if (pkg.name?.startsWith("@"))
+                return pkg.name.split("/")[0];
+        }
+        catch {
+            continue; // not a module folder
+        }
+    }
+    return undefined;
+}
+function camel(kebab) {
+    return kebab.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+}
+function pascal(kebab) {
+    const c = camel(kebab);
+    return c.charAt(0).toUpperCase() + c.slice(1);
+}
+//# sourceMappingURL=new-module.js.map

package/dist/new-module.js.map

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

package/dist/package-info.d.ts

@@ -0,0 +1,18 @@
+/**
+ * This CLI's own package root (templates live there). Resolved relative to
+ * this file — src/ and dist/ both sit one level below it.
+ */
+export declare function packageRoot(): string;
+/** Version of this CLI. */
+export declare function cliVersion(): string;
+/**
+ * Version of the @tulipes/core this CLI bundles and scaffolds for. The
+ * exports map hides core's package.json, so walk up from its entrypoint.
+ */
+export declare function coreVersion(): string;
+/**
+ * Version of the core installed in an app, which is a different install
+ * from the global CLI and can therefore be a different version. Undefined
+ * when the directory is not an app, or its dependencies aren't installed.
+ */
+export declare function appCoreVersion(rootDir: string): string | undefined;

package/dist/package-info.js

@@ -0,0 +1,53 @@
+import { readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+/**
+ * This CLI's own package root (templates live there). Resolved relative to
+ * this file — src/ and dist/ both sit one level below it.
+ */
+export function packageRoot() {
+    return join(dirname(fileURLToPath(import.meta.url)), "..");
+}
+/** Version of this CLI. */
+export function cliVersion() {
+    return versionAt(packageRoot()) ?? "unknown";
+}
+/**
+ * Version of the @tulipes/core this CLI bundles and scaffolds for. The
+ * exports map hides core's package.json, so walk up from its entrypoint.
+ */
+export function coreVersion() {
+    try {
+        const entry = createRequire(join(packageRoot(), "package.json")).resolve("@tulipes/core");
+        let dir = dirname(entry);
+        for (let depth = 0; depth < 5; depth++) {
+            const version = versionAt(dir);
+            if (version && readFileSync(join(dir, "package.json"), "utf8").includes('"name": "@tulipes/core"'))
+                return version;
+            dir = dirname(dir);
+        }
+    }
+    catch {
+        // fall through
+    }
+    return "unknown";
+}
+/**
+ * Version of the core installed in an app, which is a different install
+ * from the global CLI and can therefore be a different version. Undefined
+ * when the directory is not an app, or its dependencies aren't installed.
+ */
+export function appCoreVersion(rootDir) {
+    return versionAt(join(rootDir, "node_modules", "@tulipes", "core"));
+}
+function versionAt(packageDir) {
+    try {
+        const pkg = JSON.parse(readFileSync(join(packageDir, "package.json"), "utf8"));
+        return typeof pkg.version === "string" ? pkg.version : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=package-info.js.map

package/dist/package-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-info.js","sourceRoot":"","sources":["../src/package-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AAC7D,CAAC;AAED,2BAA2B;AAC3B,MAAM,UAAU,UAAU;IACxB,OAAO,SAAS,CAAC,WAAW,EAAE,CAAC,IAAI,SAAS,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QAC1F,IAAI,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QACzB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;gBAAE,OAAO,OAAO,CAAC;YACnH,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,SAAS,CAAC,UAAkB;IACnC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAE5E,CAAC;QACF,OAAO,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/routes.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `tulipes routes` — every endpoint the app declares, with the roles that
+ * can reach it.
+ *
+ * Reads shared declarations offline, or uses backend inspection for legacy
+ * applications. Both paths use the same route scan and ACL metadata.
+ */
+export declare function runRoutes(rootDir: string, offline?: boolean): Promise<void>;

package/dist/routes.js

@@ -0,0 +1,54 @@
+import { inspectApp } from "./inspection.js";
+/**
+ * `tulipes routes` — every endpoint the app declares, with the roles that
+ * can reach it.
+ *
+ * Reads shared declarations offline, or uses backend inspection for legacy
+ * applications. Both paths use the same route scan and ACL metadata.
+ */
+export async function runRoutes(rootDir, offline = false) {
+    const handle = await inspectApp(rootDir, offline);
+    try {
+        const records = [...handle.ctx.routes.all()].sort((a, b) => a.info.id.localeCompare(b.info.id));
+        if (records.length === 0) {
+            console.log("no routes declared");
+            return;
+        }
+        const grants = handle.ctx.acl.describe();
+        const rolesFor = (id) => {
+            if (handle.ctx.routes.checker)
+                return "dynamic (custom access checker)";
+            const roles = grants
+                .filter(({ resource }) => resource === id || resource === "*" || resource === `${id.split(":")[0]}:*`)
+                .map(({ role }) => role);
+            return [...new Set(roles)].sort().join(", ") || "— nobody";
+        };
+        const width = (pick) => Math.max(...records.map((r) => pick(r).length));
+        const w = {
+            method: width((r) => r.method),
+            id: width((r) => r.info.id),
+            path: width((r) => r.path),
+            module: width((r) => r.module),
+        };
+        console.log(`${records.length} endpoint(s)\n`);
+        for (const record of records) {
+            console.log([
+                record.method.padEnd(w.method),
+                record.info.id.padEnd(w.id),
+                record.path.padEnd(w.path),
+                record.module.padEnd(w.module),
+                rolesFor(record.info.id),
+            ].join("  "));
+            if (record.info.name || record.info.description) {
+                const label = [record.info.name, record.info.description]
+                    .filter(Boolean)
+                    .join(" — ");
+                console.log(" ".repeat(w.method + 2) + label);
+            }
+        }
+    }
+    finally {
+        await handle.shutdown();
+    }
+}
+//# sourceMappingURL=routes.js.map

package/dist/routes.js.map

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

package/dist/spec.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `tulipes spec` — an OpenAPI document and/or a Postman collection, built
+ * from the app's declared routes.
+ *
+ * Shares the routes command's inspection path: offline declarations when
+ * requested, or backend inspection without listening for legacy factories.
+ *
+ * The generator lives in `@tulipes/spec`, imported lazily: core carries no
+ * dependency on it, and an app that never generates a spec never installs
+ * it.
+ */
+export interface SpecOptions {
+    offline?: boolean;
+    openapi?: string;
+    postman?: string;
+    /** Base URL the documents advertise. */
+    url?: string;
+}
+export declare function runSpec(rootDir: string, options: SpecOptions): Promise<void>;