@lenne.tech/cli 1.21.0 → 1.22.0

package/build/lib/caddy.js

@@ -0,0 +1,169 @@
+"use strict";
+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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paths = void 0;
+exports.caddyAvailable = caddyAvailable;
+exports.caddyDaemonRunning = caddyDaemonRunning;
+exports.readCaddyfile = readCaddyfile;
+exports.reloadCaddy = reloadCaddy;
+exports.removeProjectBlock = removeProjectBlock;
+exports.renderProjectBlock = renderProjectBlock;
+exports.upsertProjectBlock = upsertProjectBlock;
+exports.validateCaddyfile = validateCaddyfile;
+exports.writeCaddyfile = writeCaddyfile;
+/**
+ * Caddy integration for `lt dev`.
+ *
+ * Caddy is the HTTPS engine: it provides automatic local TLS for
+ * `*.localhost` (no /etc/hosts edits needed — RFC 6761), atomic
+ * config reload, and a long-stable Caddyfile format. Compared to
+ * portless / mkcert / nginx, Caddy gives all of this with a single
+ * binary and no sudo daemon.
+ *
+ * Layout:
+ * - Global Caddyfile at `~/.lenneTech/Caddyfile` — one block per
+ *   project, marked with `# >>> lt-dev:<slug> >>>` / `# <<<`.
+ * - Atomic reload via `caddy reload --config ~/.lenneTech/Caddyfile`.
+ *
+ * Lifecycle is owned by `lt dev install` (one-time setup) and
+ * `lt dev up`/`lt dev down` (per-project block management).
+ */
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+const CADDYFILE_PATH = process.env.LT_DEV_CADDYFILE || (0, path_1.join)((0, os_1.homedir)(), '.lenneTech', 'Caddyfile');
+const HEADER = '# Managed by `lt dev`. Per-project blocks are bounded by `# >>> lt-dev:<slug> >>>` markers.';
+/** Detect whether `caddy` is on PATH. */
+function caddyAvailable() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const result = yield runCaddy(['version']);
+        return result.ok;
+    });
+}
+/** Detect whether the Caddy admin endpoint is reachable (i.e. a daemon is running). */
+function caddyDaemonRunning() {
+    return __awaiter(this, void 0, void 0, function* () {
+        return new Promise((resolve) => {
+            const child = (0, child_process_1.spawn)('curl', ['-fsS', '-o', '/dev/null', 'http://localhost:2019/config/'], {
+                stdio: ['ignore', 'ignore', 'ignore'],
+            });
+            child.on('error', () => resolve(false));
+            child.on('close', (code) => resolve(code === 0));
+        });
+    });
+}
+/** Read the current Caddyfile (or empty string). */
+function readCaddyfile() {
+    if (!(0, fs_1.existsSync)(CADDYFILE_PATH))
+        return '';
+    return (0, fs_1.readFileSync)(CADDYFILE_PATH, 'utf8');
+}
+/**
+ * Reload Caddy with the global Caddyfile. Caller is responsible for
+ * starting Caddy in the first place (typically via `lt dev install`).
+ */
+function reloadCaddy() {
+    return __awaiter(this, void 0, void 0, function* () {
+        return runCaddy(['reload', '--config', CADDYFILE_PATH, '--adapter', 'caddyfile']);
+    });
+}
+/**
+ * Remove a project block from the Caddyfile.
+ * Returns true if anything was removed.
+ */
+function removeProjectBlock(slug) {
+    const current = readCaddyfile();
+    const startMarker = `# >>> lt-dev:${slug} >>>`;
+    const endMarker = `# <<< lt-dev:${slug} <<<`;
+    const startIdx = current.indexOf(startMarker);
+    const endIdx = current.indexOf(endMarker);
+    if (startIdx === -1 || endIdx === -1 || endIdx <= startIdx)
+        return false;
+    const before = current.slice(0, startIdx).replace(/\n+$/, '');
+    const after = current.slice(endIdx + endMarker.length).replace(/^\n+/, '');
+    const next = [before, after].filter((s) => s.length > 0).join('\n\n');
+    writeCaddyfile(next);
+    return true;
+}
+/** Generate the Caddyfile block for one project's routes. */
+function renderProjectBlock(slug, routes) {
+    const lines = [`# >>> lt-dev:${slug} >>>`];
+    for (const route of routes) {
+        lines.push(`${route.hostname} {`);
+        lines.push(`  reverse_proxy 127.0.0.1:${route.upstreamPort}`);
+        lines.push('}');
+    }
+    lines.push(`# <<< lt-dev:${slug} <<<`);
+    return lines.join('\n');
+}
+/**
+ * Insert/replace a project block in the Caddyfile.
+ *
+ * Idempotent — re-applying with the same routes is a no-op.
+ * Returns true if the file was modified.
+ */
+function upsertProjectBlock(slug, routes) {
+    const current = readCaddyfile();
+    const block = renderProjectBlock(slug, routes);
+    const startMarker = `# >>> lt-dev:${slug} >>>`;
+    const endMarker = `# <<< lt-dev:${slug} <<<`;
+    const startIdx = current.indexOf(startMarker);
+    const endIdx = current.indexOf(endMarker);
+    let next;
+    if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
+        const before = current.slice(0, startIdx).replace(/\n+$/, '');
+        const after = current.slice(endIdx + endMarker.length).replace(/^\n+/, '');
+        next = [before, block, after].filter((s) => s.length > 0).join('\n\n');
+    }
+    else {
+        next = current.length > 0 ? `${current.replace(/\n+$/, '')}\n\n${block}` : block;
+    }
+    if (next === current.replace(/\s+$/, ''))
+        return false;
+    writeCaddyfile(next);
+    return true;
+}
+/** Validate the current Caddyfile syntax. */
+function validateCaddyfile() {
+    return __awaiter(this, void 0, void 0, function* () {
+        return runCaddy(['validate', '--config', CADDYFILE_PATH, '--adapter', 'caddyfile']);
+    });
+}
+/** Write the Caddyfile, ensuring the parent directory exists. */
+function writeCaddyfile(content) {
+    (0, fs_1.mkdirSync)((0, path_1.dirname)(CADDYFILE_PATH), { recursive: true });
+    const next = content.startsWith('#') ? content : `${HEADER}\n\n${content}`;
+    (0, fs_1.writeFileSync)(CADDYFILE_PATH, next.endsWith('\n') ? next : `${next}\n`, 'utf8');
+}
+/** Run a caddy subcommand and capture stdout/stderr. */
+function runCaddy(args) {
+    return new Promise((resolve) => {
+        var _a, _b;
+        const child = (0, child_process_1.spawn)('caddy', args, { stdio: ['ignore', 'pipe', 'pipe'] });
+        let stdout = '';
+        let stderr = '';
+        let errored = false;
+        (_a = child.stdout) === null || _a === void 0 ? void 0 : _a.on('data', (b) => (stdout += String(b)));
+        (_b = child.stderr) === null || _b === void 0 ? void 0 : _b.on('data', (b) => (stderr += String(b)));
+        child.on('error', () => (errored = true));
+        child.on('close', (code) => {
+            if (errored)
+                resolve({ exitCode: null, ok: false, stderr: 'caddy: command not found', stdout: '' });
+            else
+                resolve({ exitCode: code, ok: code === 0, stderr, stdout });
+        });
+    });
+}
+/** Path constants for tests + status displays. */
+exports.paths = {
+    caddyfile: CADDYFILE_PATH,
+};

package/build/lib/dev-env-bridge.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearEnvBridge = clearEnvBridge;
+exports.detectCaddyRootCa = detectCaddyRootCa;
+exports.envBridgePath = envBridgePath;
+exports.writeEnvBridge = writeEnvBridge;
+/**
+ * ENV bridge file at `<root>/.lt-dev/.env` — written by `lt dev up`,
+ * removed by `lt dev down`. External tools (Playwright, custom scripts,
+ * IDE test runners) load this file via dotenv to pick up the URLs and
+ * the Caddy root CA path without depending on the parent shell.
+ *
+ * Why a file (not just inherited env): the typical workflow is
+ *   1. `lt dev up`    (in shell A)
+ *   2. `pnpm test:e2e` (in shell B, IDE, or VS Code task)
+ * Shell B does not inherit shell A's exports. Reading a file solves
+ * this without polluting global state.
+ *
+ * The file is gitignored via `.lt-dev/`. It contains only public URLs +
+ * the local CA path — no secrets. Format: standard dotenv KEY=VALUE.
+ */
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+const HEADER = `# Managed by \`lt dev up\` — do NOT edit, will be overwritten.\n# Removed by \`lt dev down\`. Loaded by Playwright + other tools.\n`;
+/** Remove the ENV bridge file. No-op if missing. */
+function clearEnvBridge(projectRoot) {
+    const file = envBridgePath(projectRoot);
+    if (!(0, fs_1.existsSync)(file))
+        return false;
+    try {
+        (0, fs_1.rmSync)(file);
+        return true;
+    }
+    catch (_a) {
+        return false;
+    }
+}
+/**
+ * Detect the local Caddy root CA certificate path.
+ *
+ * Caddy stores its locally-signed root CA at a platform-specific
+ * data dir. We probe the common locations first; if none exists,
+ * we fall back to `caddy environ` (slow but authoritative).
+ */
+function detectCaddyRootCa() {
+    const candidates = [];
+    if ((0, os_1.platform)() === 'darwin') {
+        candidates.push((0, path_1.join)((0, os_1.homedir)(), 'Library/Application Support/Caddy/pki/authorities/local/root.crt'));
+    }
+    // Linux + fallback
+    candidates.push((0, path_1.join)((0, os_1.homedir)(), '.local/share/caddy/pki/authorities/local/root.crt'));
+    // XDG_DATA_HOME override
+    if (process.env.XDG_DATA_HOME) {
+        candidates.push((0, path_1.join)(process.env.XDG_DATA_HOME, 'caddy/pki/authorities/local/root.crt'));
+    }
+    for (const c of candidates) {
+        if ((0, fs_1.existsSync)(c))
+            return c;
+    }
+    return null;
+}
+/** Resolve the path to the ENV bridge file for a project. */
+function envBridgePath(projectRoot) {
+    return (0, path_1.join)(projectRoot, '.lt-dev', '.env');
+}
+/**
+ * Write the ENV bridge file. Idempotent — same content = no rewrite.
+ *
+ * Returns the absolute path that was written.
+ */
+function writeEnvBridge(projectRoot, devEnv, dbName) {
+    const file = envBridgePath(projectRoot);
+    const lines = [];
+    // The App-side env is the more "external" one (Playwright, browser tools).
+    // We expose every URL/storage/api key the App env carries.
+    const exported = [
+        'BASE_URL',
+        'APP_URL',
+        'NSC__BASE_URL',
+        'NSC__APP_URL',
+        'NUXT_API_URL',
+        'NUXT_PUBLIC_API_URL',
+        'NUXT_PUBLIC_SITE_URL',
+        'NUXT_PUBLIC_STORAGE_PREFIX',
+        'NUXT_PUBLIC_API_PROXY',
+        'NSC__MONGOOSE__URI',
+        'DATABASE_URL',
+    ];
+    for (const key of exported) {
+        const v = devEnv.app.env[key];
+        if (v !== undefined && v !== '')
+            lines.push(`${String(key)}=${v}`);
+    }
+    // Marker so consumers can detect "lt dev mode" reliably.
+    lines.push(`LT_DEV_ACTIVE=true`);
+    if (dbName)
+        lines.push(`LT_DEV_DB_NAME=${dbName}`);
+    // Caddy root CA — Playwright/Chromium use NODE_EXTRA_CA_CERTS to trust it.
+    const caPath = detectCaddyRootCa();
+    if (caPath)
+        lines.push(`NODE_EXTRA_CA_CERTS=${caPath}`);
+    const content = `${HEADER}${lines.join('\n')}\n`;
+    if ((0, fs_1.existsSync)(file) && (0, fs_1.readFileSync)(file, 'utf8') === content)
+        return file;
+    (0, fs_1.mkdirSync)((0, path_1.dirname)(file), { recursive: true });
+    (0, fs_1.writeFileSync)(file, content, 'utf8');
+    return file;
+}

package/build/lib/dev-env.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildDevEnv = buildDevEnv;
+/**
+ * Build the environment maps for both API and App processes.
+ *
+ * Both processes inherit `baseEnv` (typically `process.env`) so user-set
+ * vars survive. `lt dev`-managed keys win on top.
+ */
+function buildDevEnv(input) {
+    const { apiInternalPort, appInternalPort, baseEnv = {}, dbName, identity } = input;
+    const apiSub = identity.subdomains.api;
+    const appSub = identity.subdomains.app;
+    const apiUrl = apiSub ? `https://${apiSub.hostname}` : '';
+    const appUrl = appSub ? `https://${appSub.hostname}` : '';
+    const sharedKeys = Object.assign(Object.assign(Object.assign({}, (apiUrl ? { BASE_URL: apiUrl, NSC__BASE_URL: apiUrl } : {})), (appUrl ? { APP_URL: appUrl, NSC__APP_URL: appUrl } : {})), (dbName ? { DATABASE_URL: buildPostgresUrl(dbName), NSC__MONGOOSE__URI: `mongodb://127.0.0.1/${dbName}` } : {}));
+    return {
+        api: {
+            env: Object.assign(Object.assign(Object.assign({}, baseEnv), sharedKeys), { PORT: String(apiInternalPort) }),
+            internalPort: apiInternalPort,
+        },
+        app: {
+            env: Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, baseEnv), sharedKeys), (apiUrl ? { NUXT_API_URL: apiUrl, NUXT_PUBLIC_API_URL: apiUrl } : {})), (appUrl ? { NUXT_PUBLIC_SITE_URL: appUrl } : {})), { 
+                // Vite-API-Proxy is OFF by default in lt dev mode — Caddy serves
+                // both subdomains under HTTPS with shared cookie domain, so
+                // same-origin trickery is no longer required.
+                NUXT_PUBLIC_API_PROXY: 'false', NUXT_PUBLIC_STORAGE_PREFIX: identity.slug, PORT: String(appInternalPort) }),
+            internalPort: appInternalPort,
+        },
+    };
+}
+/** Postgres convenience URL — used by Postgres-based projects (e.g. nest-base). */
+function buildPostgresUrl(dbName) {
+    return `postgresql://${dbName}:${dbName}@localhost:5432/${dbName}`;
+}

package/build/lib/dev-identity.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildIdentity = buildIdentity;
+exports.projectSlug = projectSlug;
+exports.slugify = slugify;
+/**
+ * Project identity for `lt dev`.
+ *
+ * URL-first: every project has a slug derived from its package.json
+ * "name", and a deterministic set of subdomains under `*.localhost`.
+ *
+ * Convention:
+ * - `<slug>.localhost`         → primary App
+ * - `api.<slug>.localhost`     → API
+ * - `<other>.<slug>.localhost` → optional additional services
+ *
+ * The internal port behind each subdomain is opaque — Caddy proxies
+ * arbitrary local ports. Developers and Claude only ever see the URL.
+ */
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * Build a complete identity from a project root.
+ *
+ * Detects monorepo subprojects under `projects/` automatically:
+ * - `projects/api` → `api.<slug>.localhost`
+ * - `projects/app` → `<slug>.localhost` (primary)
+ * - `projects/<other>` → `<other>.<slug>.localhost`
+ *
+ * For standalone projects (single repo, no `projects/` directory):
+ * - API project (config.env.ts present) → `api.<slug>.localhost`
+ * - App project (nuxt.config.ts present) → `<slug>.localhost`
+ */
+function buildIdentity(root) {
+    const slug = projectSlug(root);
+    const subdomains = {};
+    const projectsDir = (0, path_1.join)(root, 'projects');
+    if ((0, fs_1.existsSync)(projectsDir)) {
+        // Monorepo: enumerate projects/* subdirectories.
+        const apiDir = (0, path_1.join)(projectsDir, 'api');
+        const appDir = (0, path_1.join)(projectsDir, 'app');
+        if ((0, fs_1.existsSync)(apiDir)) {
+            subdomains.api = {
+                hostname: `api.${slug}.localhost`,
+                isPrimaryApp: false,
+                subdir: 'projects/api',
+            };
+        }
+        if ((0, fs_1.existsSync)(appDir)) {
+            subdomains.app = {
+                hostname: `${slug}.localhost`,
+                isPrimaryApp: true,
+                subdir: 'projects/app',
+            };
+        }
+    }
+    else {
+        // Standalone — derive from project shape.
+        const isApi = (0, fs_1.existsSync)((0, path_1.join)(root, 'src', 'config.env.ts')) || (0, fs_1.existsSync)((0, path_1.join)(root, 'nest-cli.json'));
+        const isApp = (0, fs_1.existsSync)((0, path_1.join)(root, 'nuxt.config.ts'));
+        if (isApi) {
+            subdomains.api = { hostname: `api.${slug}.localhost`, isPrimaryApp: false, subdir: null };
+        }
+        if (isApp) {
+            subdomains.app = { hostname: `${slug}.localhost`, isPrimaryApp: true, subdir: null };
+        }
+    }
+    return { root, slug, subdomains };
+}
+/**
+ * Read the bare project name from package.json (scope stripped).
+ * Falls back to directory basename if no package.json or no `name`.
+ */
+function projectSlug(root) {
+    const fromPkg = readPackageName(root);
+    const raw = fromPkg || (0, path_1.basename)(root);
+    return slugify(raw);
+}
+/** Lowercase, alphanumerics + dashes only, trimmed dashes. */
+function slugify(input) {
+    return input
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+/** Read `name` from package.json, scope-stripped (e.g. `@lenne.tech/foo` → `foo`). */
+function readPackageName(dir) {
+    const pkgPath = (0, path_1.join)(dir, 'package.json');
+    if (!(0, fs_1.existsSync)(pkgPath))
+        return null;
+    try {
+        const pkg = JSON.parse((0, fs_1.readFileSync)(pkgPath, 'utf8'));
+        if (!pkg.name)
+            return null;
+        return pkg.name.includes('/') ? pkg.name.split('/').pop() : pkg.name;
+    }
+    catch (_a) {
+        return null;
+    }
+}

package/build/lib/dev-migrate-helper.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runMigrate = runMigrate;
+/**
+ * Reusable migrate logic — used by `commands/dev/migrate.ts` (interactive
+ * + verbose) and `commands/fullstack/init.ts` (silent best-effort after
+ * project creation).
+ *
+ * Returns a structured result so callers can decide what to print.
+ * Idempotent — safe to run multiple times.
+ */
+const fs_1 = require("fs");
+const path_1 = require("path");
+const dev_identity_1 = require("./dev-identity");
+const dev_patches_1 = require("./dev-patches");
+const dev_project_1 = require("./dev-project");
+const dev_state_1 = require("./dev-state");
+/**
+ * Run all migration steps for a resolved project.
+ *
+ * Idempotent — re-running with no changes returns `alreadyMigrated: true`.
+ */
+function runMigrate(input) {
+    const { layout } = input;
+    const identity = (0, dev_identity_1.buildIdentity)(layout.root);
+    const dbName = (0, dev_project_1.deriveDbName)(layout.apiDir, identity.slug);
+    // 1. Code patches (config.env.ts, nuxt.config.ts, playwright.config.ts).
+    const filesToPatch = [];
+    if (layout.apiDir) {
+        const f = (0, dev_project_1.apiNeedsPortPatch)(layout.apiDir);
+        if (f)
+            filesToPatch.push(f);
+    }
+    if (layout.appDir)
+        filesToPatch.push(...(0, dev_project_1.appNeedsPortPatch)(layout.appDir));
+    const codePatches = filesToPatch.map((f) => (0, dev_patches_1.autoPatch)(f));
+    // 2. CLAUDE.md URL block (root + each subproject — only patches existing files).
+    const claudeCandidates = [
+        (0, path_1.join)(layout.root, 'CLAUDE.md'),
+        ...(layout.apiDir ? [(0, path_1.join)(layout.apiDir, 'CLAUDE.md')] : []),
+        ...(layout.appDir ? [(0, path_1.join)(layout.appDir, 'CLAUDE.md')] : []),
+    ];
+    const claudePatches = claudeCandidates
+        .filter((f) => (0, fs_1.existsSync)(f))
+        .map((f) => (0, dev_patches_1.patchClaudeMd)(f, { dbName, identity }));
+    // 3. Registry — only write when something actually changed.
+    const reg = (0, dev_state_1.loadRegistry)();
+    const subdomainMap = {};
+    for (const [k, v] of Object.entries(identity.subdomains))
+        subdomainMap[k] = v.hostname;
+    const existing = reg.projects[identity.slug];
+    const next = {
+        dbName,
+        internalPorts: (existing === null || existing === void 0 ? void 0 : existing.internalPorts) || {},
+        lastUsedAt: existing === null || existing === void 0 ? void 0 : existing.lastUsedAt,
+        path: layout.root,
+        subdomains: subdomainMap,
+    };
+    const registryChanged = !existing ||
+        existing.path !== next.path ||
+        existing.dbName !== next.dbName ||
+        JSON.stringify(existing.subdomains) !== JSON.stringify(next.subdomains);
+    if (registryChanged) {
+        reg.projects[identity.slug] = next;
+        (0, dev_state_1.saveRegistry)(reg);
+    }
+    // 4. .gitignore
+    const addedGitignoreEntry = (0, dev_patches_1.addToGitignore)(layout.root, '.lt-dev/');
+    const codePatched = codePatches.filter((r) => r.patched).length > 0;
+    const claudePatched = claudePatches.filter((r) => r.patched).length > 0;
+    const alreadyMigrated = !codePatched && !claudePatched && !registryChanged && !addedGitignoreEntry;
+    return {
+        addedGitignoreEntry,
+        alreadyMigrated,
+        claudePatches,
+        codePatches,
+        dbName,
+        identity,
+        registryUpdated: registryChanged,
+    };
+}