@celljs/cli 3.9.0 → 4.0.0

package/lib/preset/vercel/vercel-deployer.js

@@ -0,0 +1,160 @@
+import { spawn } from 'node:child_process';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { dirname, join, relative, resolve } from 'node:path';
+import { stripVTControlCharacters } from 'node:util';
+import { CellError, defineDeployer } from '@celljs/kit';
+import { CloudNames } from '../../deploy/cloud-api.js';
+import { VercelPreset } from './vercel-preset.js';
+/**
+ * Runs the Vercel CLI, which uploads prebuilt outputs and owns the credentials (`VERCEL_TOKEN` or
+ * `vercel login`). Like Wrangler it is not a dependency: the project's is used, else npx installs
+ * {@link VercelCli.PACKAGE} on first use.
+ */
+export class VercelCli {
+    root;
+    env;
+    static PACKAGE = 'vercel@65';
+    constructor(root, env) {
+        this.root = root;
+        this.env = env;
+    }
+    command(args) {
+        for (let dir = this.root;; dir = dirname(dir)) {
+            const manifest = join(dir, 'node_modules', 'vercel', 'package.json');
+            if (existsSync(manifest)) {
+                const { bin } = JSON.parse(readFileSync(manifest, 'utf8'));
+                if (bin?.vercel) {
+                    return {
+                        command: process.execPath.includes('bun') ? 'node' : process.execPath,
+                        args: [join(dirname(manifest), bin.vercel), ...args],
+                        source: 'project',
+                    };
+                }
+            }
+            if (dirname(dir) === dir) {
+                break;
+            }
+        }
+        return { command: process.platform === 'win32' ? 'npx.cmd' : 'npx', args: ['--yes', VercelCli.PACKAGE, ...args], source: 'npx' };
+    }
+    run(args, relay) {
+        const { command, args: commandArgs, source } = this.command(args);
+        return new Promise((done, reject) => {
+            let output = '';
+            const child = spawn(command, commandArgs, { cwd: this.root, env: this.env, stdio: ['ignore', 'pipe', 'pipe'] });
+            for (const stream of ['stdout', 'stderr']) {
+                child[stream].setEncoding('utf8');
+                child[stream].on('data', (chunk) => {
+                    output += chunk;
+                    relay(chunk, stream);
+                });
+            }
+            child.on('error', reject);
+            child.on('close', code => done({ code: code ?? 1, output: stripVTControlCharacters(output), source }));
+        });
+    }
+    static isAuthError(output) {
+        return /no existing credentials|not logged in|vercel login|invalid token|token is not valid|missing.*token|authentication/i.test(output);
+    }
+    /** The last line Vercel printed with `Error`, else its last line. */
+    static errorOf(output) {
+        const lines = output
+            .split('\n')
+            .map(l => l.trim())
+            .filter(Boolean);
+        return lines.filter(l => /error/i.test(l)).pop() ?? lines.pop() ?? 'The Vercel CLI failed without output.';
+    }
+}
+/** Deploys `.vercel/output` with `vercel deploy --prebuilt`: no build runs on Vercel. */
+export class VercelDeployment {
+    context;
+    project;
+    cli;
+    constructor(context) {
+        this.context = context;
+        this.project = CloudNames.functionName(context.root, context.options.project, 100);
+        this.cli = new VercelCli(context.root, context.env);
+    }
+    get production() {
+        return (this.context.options.environment ?? 'production') === 'production';
+    }
+    async plan() {
+        this.checkOutput();
+        const { outDir, manifest, env, options } = this.context;
+        const config = JSON.parse(readFileSync(join(outDir, VercelPreset.FUNCTION, '.vc-config.json'), 'utf8').toString());
+        const staticFiles = manifest.public ? readdirSync(join(outDir, manifest.public), { recursive: true }).length : 0;
+        return {
+            deployer: 'vercel',
+            resources: [
+                {
+                    type: 'deployment',
+                    name: this.project,
+                    action: 'deploy',
+                    details: {
+                        environment: this.production ? 'production' : 'preview',
+                        ...(options.scope ? { scope: options.scope } : {}),
+                        function: `index (${config.runtime})`,
+                        staticFiles,
+                    },
+                },
+            ],
+            details: {
+                output: relative(this.context.root, outDir),
+                cli: this.cli.command([]).source === 'project' ? 'project' : VercelCli.PACKAGE,
+                credentials: env.VERCEL_TOKEN ? 'VERCEL_TOKEN' : 'vercel login',
+            },
+        };
+    }
+    async apply() {
+        this.checkOutput();
+        const { env, options } = this.context;
+        const args = [
+            'deploy',
+            '--prebuilt',
+            '--yes',
+            '--project',
+            this.project,
+            '--create-if-missing',
+            ...(this.production ? ['--prod'] : []),
+            ...(options.scope ? ['--scope', String(options.scope)] : []),
+            ...(env.VERCEL_TOKEN ? ['--token', env.VERCEL_TOKEN] : []),
+        ];
+        this.context.info(`Deploying ${this.project} with vercel deploy --prebuilt…`);
+        const result = await this.cli.run(args, (chunk, stream) => this.context.relay(chunk, stream));
+        if (result.code !== 0) {
+            throw new CellError({
+                code: VercelCli.isAuthError(result.output) ? 'CELL_DEPLOY_UNAUTHORIZED' : 'CELL_DEPLOY_FAILED',
+                message: `vercel deploy failed: ${VercelCli.errorOf(result.output)}`,
+                hint: VercelCli.isAuthError(result.output)
+                    ? 'Set VERCEL_TOKEN (a token from vercel.com/account/tokens; vercel.scope for a team), or run npx vercel login once.'
+                    : 'Fix the reported problem (the Vercel CLI printed the details above), then run cell deploy again.',
+            });
+        }
+        const urls = result.output.match(/https:\/\/[\w.-]+\.vercel\.app\b/g) ?? [];
+        return { url: urls.pop(), details: { project: this.project, environment: this.production ? 'production' : 'preview' } };
+    }
+    checkOutput() {
+        const { manifest, outDir, root } = this.context;
+        if (manifest.preset !== 'vercel') {
+            throw new CellError({
+                code: 'CELL_DEPLOY_OUTPUT_MISMATCH',
+                message: `${outDir} has no output of the vercel preset (built with: ${manifest.preset ?? 'no preset'}).`,
+                hint: 'Run cell deploy --preset vercel without --skip-build, or cell build --preset vercel first.',
+            });
+        }
+        if (resolve(outDir) !== resolve(root, VercelPreset.OUT_DIR)) {
+            throw new CellError({
+                code: 'CELL_DEPLOY_OUTPUT_MISMATCH',
+                message: `vercel deploy --prebuilt reads .vercel/output, but the output is in ${relative(root, outDir)}.`,
+                hint: 'Build without --out-dir (the vercel preset writes to .vercel/output).',
+            });
+        }
+    }
+}
+export const vercelDeployer = defineDeployer({
+    name: 'vercel',
+    description: "Vercel through vercel deploy --prebuilt (the project's CLI, or vercel@65 installed on first use)",
+    plan: context => new VercelDeployment(context).plan(),
+    apply: context => new VercelDeployment(context).apply(),
+});
+//# sourceMappingURL=vercel-deployer.js.map

package/lib/preset/vercel/vercel-deployer.js.map

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

package/lib/preset/vercel/vercel-preset.d.ts

@@ -0,0 +1,19 @@
+import { type PresetOutputContext, type PresetPreviewContext, type PreviewProcess } from '@celljs/kit';
+/**
+ * Vercel through the Build Output API (v3): the frontend in `static/` on Vercel's CDN, the Cell
+ * server as one Node.js function `functions/index.func` that gets every request no static file
+ * answers. The output goes to `.vercel/output`, where `vercel deploy --prebuilt` looks for it.
+ */
+export declare namespace VercelPreset {
+    const OUT_DIR = ".vercel/output";
+    const FUNCTION = "functions/index.func";
+    const RUNTIMES: readonly ['nodejs22.x', 'nodejs20.x'];
+    const OPTIONS: import("@celljs/kit").StandardSchema<unknown>;
+    /** What `vercel build` writes into .vercel/output; a deployment would mix it with Cell's output. */
+    const FOREIGN: string[];
+    function output(context: PresetOutputContext): void;
+    /** Node.js on the function's server bundle, with the frontend from `static/`. */
+    function preview({ outDir, manifest, port }: PresetPreviewContext): PreviewProcess;
+}
+export declare const vercelPreset: import("@celljs/kit").Preset;
+//# sourceMappingURL=vercel-preset.d.ts.map

package/lib/preset/vercel/vercel-preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel-preset.d.ts","sourceRoot":"","sources":["../../../src/preset/vercel/vercel-preset.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAIrH;;;;GAIG;AACH,yBAAiB,YAAY,CAAC;IACnB,MAAM,OAAO,mBAAmB,CAAC;IACjC,MAAM,QAAQ,yBAAyB,CAAC;IACxC,MAAM,QAAQ,YAAI,YAAY,EAAE,YAAY,CAAU,CAAC;IAEvD,MAAM,OAAO,+CAQlB,CAAC;IAEH,oGAAoG;IAC7F,MAAM,OAAO,UAAuE,CAAC;IAE5F,SAAgB,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAoDzD;IAED,iFAAiF;IACjF,SAAgB,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,oBAAoB,GAAG,cAAc,CAUxF;CACJ;AAED,eAAO,MAAM,YAAY,8BAavB,CAAC"}

package/lib/preset/vercel/vercel-preset.js

@@ -0,0 +1,102 @@
+import { cpSync, existsSync, mkdirSync, renameSync, rmSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { definePreset } from '@celljs/kit';
+import { PresetOptionsSchema } from '../../deploy/cloud-api.js';
+import { ServerlessScripts } from '../serverless-scripts.js';
+/**
+ * Vercel through the Build Output API (v3): the frontend in `static/` on Vercel's CDN, the Cell
+ * server as one Node.js function `functions/index.func` that gets every request no static file
+ * answers. The output goes to `.vercel/output`, where `vercel deploy --prebuilt` looks for it.
+ */
+export var VercelPreset;
+(function (VercelPreset) {
+    VercelPreset.OUT_DIR = '.vercel/output';
+    VercelPreset.FUNCTION = 'functions/index.func';
+    VercelPreset.RUNTIMES = ['nodejs22.x', 'nodejs20.x'];
+    VercelPreset.OPTIONS = PresetOptionsSchema.of({
+        project: 'string',
+        scope: 'string',
+        environment: ['production', 'preview'],
+        runtime: VercelPreset.RUNTIMES,
+        memory: 'number',
+        maxDuration: 'number',
+        regions: 'string',
+    });
+    /** What `vercel build` writes into .vercel/output; a deployment would mix it with Cell's output. */
+    VercelPreset.FOREIGN = ['static', 'functions', 'config.json', 'builds.json', 'diagnostics'];
+    function output(context) {
+        const { manifest, outDir, options } = context;
+        for (const entry of VercelPreset.FOREIGN) {
+            rmSync(join(outDir, entry), { recursive: true, force: true });
+        }
+        if (manifest.public) {
+            renameSync(join(outDir, manifest.public), join(outDir, 'static'));
+            manifest.public = 'static';
+        }
+        const routes = [
+            // Vite's hashed files never change.
+            { src: '^/assets/(.*)$', headers: { 'cache-control': 'public, max-age=31536000, immutable' }, continue: true },
+            { handle: 'filesystem' },
+        ];
+        if (manifest.server) {
+            const fn = join(outDir, VercelPreset.FUNCTION);
+            mkdirSync(fn, { recursive: true });
+            renameSync(join(outDir, dirname(manifest.server)), join(fn, 'server'));
+            manifest.server = `${VercelPreset.FUNCTION}/server/${manifest.server.split('/').pop()}`;
+            // The single-page fallback of serve-static, inside the function.
+            const index = join(outDir, 'static', 'index.html');
+            if (existsSync(index)) {
+                mkdirSync(join(fn, 'public'), { recursive: true });
+                cpSync(index, join(fn, 'public', 'index.html'));
+            }
+            context.write(`${VercelPreset.FUNCTION}/vercel.mjs`, ServerlessScripts.VERCEL_FUNCTION);
+            context.write(`${VercelPreset.FUNCTION}/.vc-config.json`, `${JSON.stringify({
+                runtime: options.runtime ?? VercelPreset.RUNTIMES[0],
+                handler: 'vercel.mjs',
+                launcherType: 'Nodejs',
+                shouldAddHelpers: false,
+                supportsResponseStreaming: true,
+                ...(options.memory ? { memory: options.memory } : {}),
+                ...(options.maxDuration ? { maxDuration: options.maxDuration } : {}),
+                ...(options.regions
+                    ? {
+                        regions: String(options.regions)
+                            .split(',')
+                            .map(r => r.trim()),
+                    }
+                    : {}),
+            }, null, 2)}\n`);
+            routes.push({ src: '^/(.*)$', dest: '/index' });
+        }
+        context.write('config.json', `${JSON.stringify({ version: 3, routes }, null, 2)}\n`);
+    }
+    VercelPreset.output = output;
+    /** Node.js on the function's server bundle, with the frontend from `static/`. */
+    function preview({ outDir, manifest, port }) {
+        return {
+            command: process.execPath.includes('bun') ? 'node' : process.execPath,
+            args: [join(outDir, manifest.server ?? `${VercelPreset.FUNCTION}/server/index.mjs`)],
+            env: {
+                NODE_ENV: 'production',
+                CELL_BACKEND__PATHS__PUBLIC: join(outDir, 'static'),
+                ...(port === undefined ? {} : { CELL_BACKEND__SERVER__PORT: String(port) }),
+            },
+        };
+    }
+    VercelPreset.preview = preview;
+})(VercelPreset || (VercelPreset = {}));
+export const vercelPreset = definePreset({
+    name: 'vercel',
+    description: 'Vercel (Build Output API): static frontend on the CDN, the server as a function',
+    entry: 'http',
+    format: 'esm',
+    outDir: VercelPreset.OUT_DIR,
+    staticHosting: true,
+    // Vercel's build machines set VERCEL=1.
+    detect: env => env.VERCEL === '1',
+    options: VercelPreset.OPTIONS,
+    output: context => VercelPreset.output(context),
+    preview: context => VercelPreset.preview(context),
+    deployer: 'vercel',
+});
+//# sourceMappingURL=vercel-preset.js.map

package/lib/preset/vercel/vercel-preset.js.map

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

package/lib/test/fixture-project.d.ts

@@ -0,0 +1,17 @@
+/**
+ * A throw-away project on disk for tests. It lives under this package's `.fixtures/` directory so
+ * that the repository's node_modules (and therefore @celljs/core) are resolvable from it.
+ */
+export declare class FixtureProject {
+    /** Created eagerly: Bun's resolver caches a missing directory, which would break later lookups from it. */
+    static readonly BASE: string;
+    protected static createBase(): string;
+    readonly root: string;
+    constructor(name: string);
+    file(path: string, content: string | object): this;
+    /** Adds a package under `node_modules` (or nested under `under`). */
+    dependency(name: string, pkg?: Record<string, unknown>, files?: Record<string, string>, under?: string): this;
+    path(...parts: string[]): string;
+    dispose(): void;
+}
+//# sourceMappingURL=fixture-project.d.ts.map

package/lib/test/fixture-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture-project.d.ts","sourceRoot":"","sources":["../../src/test/fixture-project.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,qBAAa,cAAc;IACvB,2GAA2G;IAC3G,MAAM,CAAC,QAAQ,CAAC,IAAI,SAA+B;IAEnD,SAAS,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAIpC;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,YAAY,IAAI,EAAE,MAAM,EAGvB;IAED,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKjD;IAED,qEAAqE;IACrE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EAAE,KAAK,SAAK,GAAG,IAAI,CAOhH;IAED,IAAI,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAE/B;IAED,OAAO,IAAI,IAAI,CAEd;CACJ"}

package/lib/test/fixture-project.js

@@ -0,0 +1,43 @@
+import { mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * A throw-away project on disk for tests. It lives under this package's `.fixtures/` directory so
+ * that the repository's node_modules (and therefore @celljs/core) are resolvable from it.
+ */
+export class FixtureProject {
+    /** Created eagerly: Bun's resolver caches a missing directory, which would break later lookups from it. */
+    static BASE = FixtureProject.createBase();
+    static createBase() {
+        const base = join(dirname(fileURLToPath(import.meta.url)), '..', '..', '.fixtures');
+        mkdirSync(base, { recursive: true });
+        return base;
+    }
+    root;
+    constructor(name) {
+        this.root = join(FixtureProject.BASE, `${name}-${process.pid}-${Math.random().toString(36).slice(2, 8)}`);
+        mkdirSync(this.root, { recursive: true });
+    }
+    file(path, content) {
+        const file = join(this.root, path);
+        mkdirSync(dirname(file), { recursive: true });
+        writeFileSync(file, typeof content === 'string' ? content : `${JSON.stringify(content, null, 2)}\n`);
+        return this;
+    }
+    /** Adds a package under `node_modules` (or nested under `under`). */
+    dependency(name, pkg = {}, files = {}, under = '') {
+        const dir = join(under, 'node_modules', name);
+        this.file(join(dir, 'package.json'), { name, version: '1.0.0', ...pkg });
+        for (const [path, content] of Object.entries(files)) {
+            this.file(join(dir, path), content);
+        }
+        return this;
+    }
+    path(...parts) {
+        return join(this.root, ...parts);
+    }
+    dispose() {
+        rmSync(this.root, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=fixture-project.js.map

package/lib/test/fixture-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture-project.js","sourceRoot":"","sources":["../../src/test/fixture-project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;GAGG;AACH,MAAM,OAAO,cAAc;IACvB,2GAA2G;IAC3G,MAAM,CAAU,IAAI,GAAG,cAAc,CAAC,UAAU,EAAE,CAAC;IAEzC,MAAM,CAAC,UAAU;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QACpF,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IAChB,CAAC;IAEQ,IAAI,CAAS;IAEtB,YAAY,IAAY;QACpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1G,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,CAAC,IAAY,EAAE,OAAwB;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACnC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,aAAa,CAAC,IAAI,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACrG,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,qEAAqE;IACrE,UAAU,CAAC,IAAY,EAAE,GAAG,GAA4B,EAAE,EAAE,KAAK,GAA2B,EAAE,EAAE,KAAK,GAAG,EAAE;QACtG,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;QACzE,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,CAAC,GAAG,KAAe;QACnB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,OAAO;QACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;CACJ"}

package/lib/testing/create-test-app.d.ts

@@ -0,0 +1,27 @@
+import { type TestApp as BaseTestApp } from '@celljs/vite';
+export type { TestApp, TestContainer } from '@celljs/vite';
+export interface CreateTestAppOptions {
+    /** Project root. Default: the current directory. */
+    root?: string;
+    /** Modes after `test`, which is always on (cell.test.yml). */
+    mode?: string[];
+    /** Preset whose entry runs the backend. Default as for `cell build`. */
+    preset?: string;
+    /** Environment for `${env.*}` and `CELL_*__` overrides of the frontend. Default: `process.env`. */
+    env?: NodeJS.ProcessEnv;
+}
+/**
+ * The application of the project in the test process (docs/design/agent-first.md R11): cell.config.ts,
+ * toolchain modules and the preset's entry apply as for `cell dev`, in the `test` mode, without a
+ * port. Requests go through `app.fetch(path, init)`, which returns a standard `Response`.
+ *
+ * ```ts
+ * import { createTestApp } from '@celljs/cli';
+ *
+ * const app = await createTestApp();
+ * expect(await (await app.fetch('/users')).json()).toEqual([]);
+ * await app.close();
+ * ```
+ */
+export declare function createTestApp(options?: CreateTestAppOptions): Promise<BaseTestApp>;
+//# sourceMappingURL=create-test-app.d.ts.map

package/lib/testing/create-test-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-test-app.d.ts","sourceRoot":"","sources":["../../src/testing/create-test-app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,IAAI,WAAW,EAA0B,MAAM,cAAc,CAAC;AAEnF,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAI3D,MAAM,WAAW,oBAAoB;IACjC,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mGAAmG;IACnG,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAC3B;AAiBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,WAAW,CAAC,CA2B5F"}

package/lib/testing/create-test-app.js

@@ -0,0 +1,54 @@
+import { TestApp as ViteTestApp } from '@celljs/vite';
+import { Toolchain } from '../toolchain/toolchain.js';
+/** A test application that also closes the toolchain it was created with. */
+class ToolchainTestApp extends ViteTestApp {
+    toolchain;
+    constructor(options, toolchain) {
+        super(options);
+        this.toolchain = toolchain;
+    }
+    async close() {
+        await super.close();
+        await this.toolchain.close();
+    }
+}
+/**
+ * The application of the project in the test process (docs/design/agent-first.md R11): cell.config.ts,
+ * toolchain modules and the preset's entry apply as for `cell dev`, in the `test` mode, without a
+ * port. Requests go through `app.fetch(path, init)`, which returns a standard `Response`.
+ *
+ * ```ts
+ * import { createTestApp } from '@celljs/cli';
+ *
+ * const app = await createTestApp();
+ * expect(await (await app.fetch('/users')).json()).toEqual([]);
+ * await app.close();
+ * ```
+ */
+export async function createTestApp(options = {}) {
+    const toolchain = await Toolchain.create({
+        root: options.root,
+        command: 'test',
+        flags: { mode: options.mode, preset: options.preset },
+        env: options.env,
+        runHooks: false,
+        logger: { info: () => undefined, warn: message => process.stderr.write(`warning: ${message}\n`) },
+    });
+    const { config } = toolchain;
+    const app = new ToolchainTestApp({
+        ...toolchain.projectOptions(),
+        mode: config.mode,
+        env: options.env,
+        vite: config.vite,
+        plugins: toolchain.modules.vitePlugins(),
+        outDir: config.build.outDir,
+    }, toolchain);
+    try {
+        return await app.start();
+    }
+    catch (error) {
+        await toolchain.close();
+        throw error;
+    }
+}
+//# sourceMappingURL=create-test-app.js.map

package/lib/testing/create-test-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-test-app.js","sourceRoot":"","sources":["../../src/testing/create-test-app.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,OAAO,IAAI,WAAW,EAAE,MAAM,cAAc,CAAC;AAInF,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAatD,6EAA6E;AAC7E,MAAM,gBAAiB,SAAQ,WAAW;IAGf,SAAS;IAFhC,YACI,OAAqD,EAClC,SAAoB;QAEvC,KAAK,CAAC,OAAO,CAAC,CAAC;yBAFI,SAAS;IAGhC,CAAC;IAEQ,KAAK,CAAC,KAAK;QAChB,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACjC,CAAC;CACJ;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAO,GAAyB,EAAE;IAClE,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC;QACrC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,MAAM;QACf,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;QACrD,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,OAAO,IAAI,CAAC,EAAE;KACpG,CAAC,CAAC;IACH,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC7B,MAAM,GAAG,GAAG,IAAI,gBAAgB,CAC5B;QACI,GAAG,SAAS,CAAC,cAAc,EAAE;QAC7B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE;QACxC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;KAC9B,EACD,SAAS,CACZ,CAAC;IACF,IAAI,CAAC;QACD,OAAO,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;QACxB,MAAM,KAAK,CAAC;IAChB,CAAC;AACL,CAAC"}

package/lib/testing/create-test-app.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=create-test-app.spec.d.ts.map

package/lib/testing/create-test-app.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-test-app.spec.d.ts","sourceRoot":"","sources":["../../src/testing/create-test-app.spec.ts"],"names":[],"mappings":""}

package/lib/testing/create-test-app.spec.js

@@ -0,0 +1,66 @@
+import { afterAll, describe, expect, it } from 'bun:test';
+import { FixtureProject } from '../test/fixture-project.js';
+import { createTestApp } from './create-test-app.js';
+describe('createTestApp of @celljs/cli', () => {
+    const fixture = new FixtureProject('cli-test-app')
+        .file('package.json', {
+        name: 'cli-test-app',
+        dependencies: { '@celljs/core': '*', '@celljs/http': '*', '@celljs/web': '*', '@celljs/mvc': '*', '@celljs/express-adapter': '*' },
+    })
+        .file('cell.yml', 'backend:\n  cell:\n    who: production\n')
+        .file('cell.test.yml', 'backend:\n  cell:\n    who: test\n')
+        .file('cell.extra.yml', 'backend:\n  cell:\n    extra: on\n')
+        .file('mod.mjs', "export default cell => cell.addVirtualModule('virtual:suffix', 'export default \"!\";');\n")
+        .file('cell.config.ts', "export default { modules: ['./mod.mjs'] };\n")
+        .file('src/common/tokens.ts', "export const Greeter = Symbol('Greeter');\nexport const Missing = Symbol('Missing');\n")
+        .file('src/node/module.ts', [
+        "import { autoBind, Component, Value } from '@celljs/core';",
+        "import { Greeter } from '../common/tokens';",
+        '@Component(Greeter)',
+        "export class GreeterImpl { greet(): string { return 'hi'; } }",
+        "import { Controller, Get, Text } from '@celljs/mvc/lib/node';",
+        "import suffix from 'virtual:suffix';",
+        '@Controller()',
+        'export class HomeController {',
+        "    @Value('cell.who') protected readonly who: string;",
+        "    @Value('cell.extra') protected readonly extra: string;",
+        '    @Get() @Text()',
+        "    home(): string { return this.who + suffix + (this.extra ?? ''); }",
+        '}',
+        'export default autoBind();',
+    ].join('\n'));
+    afterAll(() => fixture.dispose());
+    it('runs the project like cell dev does, with its modules, in the test mode', async () => {
+        const app = await createTestApp({ root: fixture.root });
+        try {
+            expect(app.project.mode).toEqual(['test']);
+            expect(app.project.backend?.entryComponent).toBe('@celljs/express-adapter');
+            expect(await (await app.fetch('/')).text()).toBe('test!');
+        }
+        finally {
+            await app.close();
+        }
+    });
+    it('finds services by identifiers the test imports from the sources, which are other module instances', async () => {
+        const app = await createTestApp({ root: fixture.root });
+        try {
+            const tokens = await import(fixture.path('src/common/tokens.ts'));
+            expect(app.get(tokens.Greeter).greet()).toBe('hi');
+            expect(() => app.get(tokens.Missing)).toThrow(expect.objectContaining({ code: 'CELL_DI_NO_BINDING' }));
+        }
+        finally {
+            await app.close();
+        }
+    });
+    it('adds the modes it is given after test', async () => {
+        const app = await createTestApp({ root: fixture.root, mode: ['extra'] });
+        try {
+            expect(app.project.mode).toEqual(['test', 'extra']);
+            expect(await (await app.fetch('/')).text()).toBe('test!on');
+        }
+        finally {
+            await app.close();
+        }
+    });
+});
+//# sourceMappingURL=create-test-app.spec.js.map

package/lib/testing/create-test-app.spec.js.map

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

package/lib/toolchain/toolchain.d.ts

@@ -0,0 +1,49 @@
+import type { CellError, Preset } from '@celljs/kit';
+import { type CellBuilderOptions, type ProjectLoaderOptions } from '@celljs/vite';
+import { type CellCommand, type ConfigFlags, type ResolvedConfig } from '../config/config-resolver.js';
+import { EventBus } from '../events/event-bus.js';
+import { ModuleHost } from '../modules/module-host.js';
+import { PresetRegistry } from '../preset/preset-registry.js';
+export interface ToolchainOptions {
+    root?: string;
+    command: CellCommand;
+    flags?: ConfigFlags;
+    env?: NodeJS.ProcessEnv;
+    /** Send hook output to stderr (`--json`). */
+    quiet?: boolean;
+    /** Run the project's `hooks` commands; read-only commands such as `cell info` turn this off. Default `true`. */
+    runHooks?: boolean;
+    /** Messages of modules. Default: stderr. */
+    logger?: {
+        info(message: string): void;
+        warn(message: string): void;
+    };
+    /** Report failing notification handlers here instead of failing (`cell dev`). */
+    onNotifyError?: (error: CellError) => void;
+}
+/**
+ * The toolchain of one command run: resolved configuration, toolchain modules, the preset and the
+ * event bus with the project's hooks. Startup order follows docs/design/modules.md §3.3: read
+ * cell.config.ts → find components → run module factories → resolve the preset → modules:done →
+ * config:resolved.
+ */
+export declare class Toolchain {
+    readonly config: ResolvedConfig;
+    readonly preset: Preset;
+    readonly events: EventBus;
+    readonly presets: PresetRegistry;
+    readonly modules: ModuleHost;
+    protected constructor(config: ResolvedConfig, preset: Preset, events: EventBus, presets: PresetRegistry, modules: ModuleHost);
+    static create(options: ToolchainOptions): Promise<Toolchain>;
+    /** Presets added by modules take part in CI detection like the built-in ones. */
+    protected static detectModulePreset(config: ResolvedConfig, presets: PresetRegistry, env: NodeJS.ProcessEnv): void;
+    /** What decides the component graph, with what modules added (DI modules, entries). */
+    projectOptions(): ProjectLoaderOptions;
+    /** Options of the build: the configuration, the preset and the modules' plugins. */
+    builderOptions(): CellBuilderOptions;
+    protected moduleProjectOptions(): Pick<ProjectLoaderOptions, 'extraModules' | 'entry'>;
+    /** The options of a preset: its field of cell.config.ts, `{}` when absent. */
+    presetOptions(name?: string): Record<string, unknown>;
+    close(reason?: 'exit' | 'restart'): Promise<void>;
+}
+//# sourceMappingURL=toolchain.d.ts.map

package/lib/toolchain/toolchain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolchain.d.ts","sourceRoot":"","sources":["../../src/toolchain/toolchain.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,KAAK,kBAAkB,EAAsB,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACtG,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAkB,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACvH,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gHAAgH;IAChH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4CAA4C;IAC5C,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACtE,iFAAiF;IACjF,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CAC9C;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IAEd,QAAQ,CAAC,MAAM,EAAE,cAAc;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,MAAM,EAAE,QAAQ;IACzB,QAAQ,CAAC,OAAO,EAAE,cAAc;IAChC,QAAQ,CAAC,OAAO,EAAE,UAAU;IALhC,SAAS,aACI,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,UAAU,EAC5B;IAEJ,OAAa,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,CAyCjE;IAED,iFAAiF;IACjF,SAAS,CAAC,MAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAQjH;IAED,uFAAuF;IACvF,cAAc,IAAI,oBAAoB,CAErC;IAED,oFAAoF;IACpF,cAAc,IAAI,kBAAkB,CAEnC;IAED,SAAS,CAAC,oBAAoB,IAAI,IAAI,CAAC,oBAAoB,EAAE,cAAc,GAAG,OAAO,CAAC,CAMrF;IAED,8EAA8E;IAC9E,aAAa,CAAC,IAAI,SAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE9D;IAEK,KAAK,CAAC,MAAM,GAAE,MAAM,GAAG,SAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;CACJ"}