typeferry 0.7.5 → 0.9.0

package/README.md

@@ -4,6 +4,11 @@ The TypeScript implementation of TypeFerry provides the reference Node.js server
 
 Install the public TypeScript package with `npm install typeferry`. Repository contributors can use the local [`template/`](../template/) workflow described in the [quickstart](../docs/getting-started.md).
 
+AI coding agents building consumer applications should begin with the
+[agent application guide](https://github.com/leonardoventurini/typeferry/blob/main/docs/agents/application-development.md).
+It defines the supported project structure, public imports, package-owned
+commands, optional configuration, safety boundaries, and completion checks.
+
 ## Runtime requirements
 
 - Node.js `24.19.0`
@@ -26,9 +31,65 @@ Install the public TypeScript package with `npm install typeferry`. Repository c
 | `typeferry/ejson` | Extended JSON namespace |
 | `typeferry/mongodb` | Native-driver MongoDB extension |
 | `typeferry/mongodb/decorators` | MongoDB collection decorators |
+| `typeferry/config` | Optional typed application configuration |
+| `typeferry/test` | Unstable mirror of the installed Vitest API |
 
 Applications should import these compiled package exports. Do not alias or import TypeFerry source files from application code.
 
+## Application commands
+
+Applications using the conventional root-level `client/`, `common/`,
+`server/`, and `test/` directories need no TypeFerry configuration:
+
+```json
+{
+  "scripts": {
+    "develop": "typeferry develop",
+    "build": "typeferry build",
+    "test": "typeferry test"
+  }
+}
+```
+
+`typeferry test unit`, `typeferry test integration`, and
+`typeferry test browser` select one project. Add `--watch` for watch mode.
+Tests can import Vitest through `typeferry/test`:
+
+```ts
+import { describe, expect, it } from 'typeferry/test'
+```
+
+That entry point mirrors TypeFerry's installed Vitest release. Individual
+mirrored exports follow Vitest and do not carry independent TypeFerry
+compatibility guarantees.
+
+Add `typeferry.config.ts` only when overriding supported high-level defaults:
+
+```ts
+import { defineConfig } from 'typeferry/config'
+
+export default defineConfig({
+  development: {
+    clientPort: 8000,
+    serverPort: 8002,
+  },
+  build: {
+    server: {
+      external: ['sharp'],
+    },
+  },
+})
+```
+
+Server dependencies are bundled by default. Configured externals must be direct
+application `dependencies`, and the application must ship them in its
+production runtime installation.
+
+See the full
+[application framework guide](https://github.com/leonardoventurini/typeferry/blob/main/docs/typescript/application-framework.md)
+for command behavior, test discovery, every configuration field, migration,
+ownership boundaries, upgrades, and troubleshooting.
+
 ## Define and serve a typed method
 
 ```ts
@@ -85,4 +146,4 @@ npm pack --dry-run
 
 ## Guides
 
-Start at the [documentation home](../docs/README.md) or jump to [server and RPC](../docs/typescript/server-rpc.md), [client](../docs/typescript/client.md), [React](../docs/typescript/react.md), [authentication](../docs/typescript/authentication.md), [events and channels](../docs/typescript/events-and-channels.md), [MongoDB](../docs/typescript/mongodb.md), [EJSON](../docs/typescript/ejson.md), or [deployment](../docs/typescript/deployment.md).
+Start at the [documentation home](../docs/README.md) or jump to the [application framework](../docs/typescript/application-framework.md), [server and RPC](../docs/typescript/server-rpc.md), [client](../docs/typescript/client.md), [React](../docs/typescript/react.md), [authentication](../docs/typescript/authentication.md), [events and channels](../docs/typescript/events-and-channels.md), [MongoDB](../docs/typescript/mongodb.md), [EJSON](../docs/typescript/ejson.md), or [deployment](../docs/typescript/deployment.md).

package/dist/application/build.d.ts

@@ -0,0 +1,2 @@
+import type { ResolvedApplicationConfig } from './config.js';
+export declare function runBuild(config: ResolvedApplicationConfig): Promise<void>;

package/dist/application/build.js

@@ -0,0 +1,21 @@
+import { access, rm } from 'node:fs/promises';
+import path from 'node:path';
+import { build as buildServer } from 'esbuild';
+import { build as buildClient } from 'vite';
+import { createServerBuildOptions } from './server-build.js';
+import { createViteConfig } from './vite-config.js';
+export async function runBuild(config) {
+    await Promise.all([
+        access(path.join(config.root, config.paths.client, 'index.html')),
+        access(path.join(config.root, config.paths.server, 'index.ts')),
+    ]);
+    await rm(path.join(config.root, config.paths.output), {
+        force: true,
+        recursive: true,
+    });
+    await Promise.all([
+        buildClient(createViteConfig(config, 'build')),
+        buildServer(createServerBuildOptions(config)),
+    ]);
+}
+//# sourceMappingURL=build.js.map

package/dist/application/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/application/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,KAAK,IAAI,WAAW,EAAE,MAAM,SAAS,CAAA;AAC9C,OAAO,EAAE,KAAK,IAAI,WAAW,EAAE,MAAM,MAAM,CAAA;AAG3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAEhD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAiC;IAEjC,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACjE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;KAChE,CAAC,CAAA;IAEF,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE;QACpD,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,IAAI;KAChB,CAAC,CAAA;IAEF,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,WAAW,CAAC,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9C,WAAW,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;KAC9C,CAAC,CAAA;AACJ,CAAC"}

package/dist/application/cli-arguments.d.ts

@@ -0,0 +1,13 @@
+export type TestProjectName = 'unit' | 'integration' | 'browser';
+export type CliArguments = {
+    readonly command: 'build';
+} | {
+    readonly command: 'develop';
+    readonly serverArguments: readonly string[];
+} | {
+    readonly command: 'test';
+    readonly project?: TestProjectName;
+    readonly watch: boolean;
+};
+export declare const CLI_USAGE = "Usage: typeferry <develop [-- server-args...]|build|test [unit|integration|browser] [--watch]>";
+export declare function parseCliArguments(arguments_: readonly string[]): CliArguments;

package/dist/application/cli-arguments.js

@@ -0,0 +1,46 @@
+const TEST_PROJECTS = new Set([
+    'unit',
+    'integration',
+    'browser',
+]);
+export const CLI_USAGE = 'Usage: typeferry <develop [-- server-args...]|build|test [unit|integration|browser] [--watch]>';
+export function parseCliArguments(arguments_) {
+    const [command, ...rest] = arguments_;
+    if (command === 'build') {
+        if (rest.length > 0)
+            throw new Error(`Unexpected build arguments. ${CLI_USAGE}`);
+        return { command };
+    }
+    if (command === 'develop') {
+        if (rest.length === 0)
+            return { command, serverArguments: [] };
+        if (rest[0] !== '--') {
+            throw new Error(`Server arguments must follow --. ${CLI_USAGE}`);
+        }
+        return { command, serverArguments: rest.slice(1) };
+    }
+    if (command === 'test')
+        return parseTestArguments(rest);
+    throw new Error(`Unknown command: ${command ?? '(missing)'}. ${CLI_USAGE}`);
+}
+function parseTestArguments(arguments_) {
+    let project;
+    let watch = false;
+    for (const argument of arguments_) {
+        if (argument === '--watch') {
+            watch = true;
+            continue;
+        }
+        if (!TEST_PROJECTS.has(argument)) {
+            throw new Error(`Unknown test project: ${argument}. ${CLI_USAGE}`);
+        }
+        if (project !== undefined) {
+            throw new Error(`Only one test project can be selected. ${CLI_USAGE}`);
+        }
+        project = argument;
+    }
+    return project === undefined
+        ? { command: 'test', watch }
+        : { command: 'test', project, watch };
+}
+//# sourceMappingURL=cli-arguments.js.map

package/dist/application/cli-arguments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-arguments.js","sourceRoot":"","sources":["../../src/application/cli-arguments.ts"],"names":[],"mappings":"AAWA,MAAM,aAAa,GAAG,IAAI,GAAG,CAAkB;IAC7C,MAAM;IACN,aAAa;IACb,SAAS;CACV,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,SAAS,GACpB,gGAAgG,CAAA;AAElG,MAAM,UAAU,iBAAiB,CAAC,UAA6B;IAC7D,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,UAAU,CAAA;IAErC,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,SAAS,EAAE,CAAC,CAAA;QAChF,OAAO,EAAE,OAAO,EAAE,CAAA;IACpB,CAAC;IAED,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,EAAE,CAAA;QAC9D,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,oCAAoC,SAAS,EAAE,CAAC,CAAA;QAClE,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;IACpD,CAAC;IAED,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAA;IAEvD,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC,CAAA;AAC7E,CAAC;AAED,SAAS,kBAAkB,CAAC,UAA6B;IACvD,IAAI,OAAoC,CAAA;IACxC,IAAI,KAAK,GAAG,KAAK,CAAA;IAEjB,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,KAAK,GAAG,IAAI,CAAA;YACZ,SAAQ;QACV,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAA2B,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,KAAK,SAAS,EAAE,CAAC,CAAA;QACpE,CAAC;QACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,0CAA0C,SAAS,EAAE,CAAC,CAAA;QACxE,CAAC;QACD,OAAO,GAAG,QAA2B,CAAA;IACvC,CAAC;IAED,OAAO,OAAO,KAAK,SAAS;QAC1B,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE;QAC5B,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;AACzC,CAAC"}

package/dist/application/config.d.ts

@@ -0,0 +1,86 @@
+export type BrowserName = 'chromium' | 'firefox' | 'webkit';
+export interface TypeFerryConfig {
+    readonly development?: {
+        readonly clientPort?: number;
+        readonly serverPort?: number;
+        readonly serverEnvironmentFile?: string;
+    };
+    readonly build?: {
+        readonly target?: string;
+        readonly sourceMaps?: boolean;
+        readonly server?: {
+            readonly external?: readonly string[];
+        };
+    };
+    readonly test?: {
+        readonly integration?: {
+            readonly timeout?: number;
+        };
+        readonly browser?: {
+            readonly browser?: BrowserName;
+        };
+    };
+}
+export interface ResolvedApplicationConfig {
+    readonly root: string;
+    readonly paths: {
+        readonly client: string;
+        readonly common: string;
+        readonly server: string;
+        readonly tests: string;
+        readonly output: string;
+    };
+    readonly development: {
+        readonly clientPort: number;
+        readonly serverPort: number;
+        readonly serverEnvironmentFile: string;
+    };
+    readonly build: {
+        readonly target: string;
+        readonly sourceMaps: boolean;
+        readonly server: {
+            readonly external: readonly string[];
+        };
+    };
+    readonly test: {
+        readonly integration: {
+            readonly timeout: number;
+        };
+        readonly browser: {
+            readonly browser: BrowserName;
+        };
+    };
+}
+export declare const DEFAULT_APPLICATION_CONFIG: {
+    readonly paths: {
+        readonly client: "client";
+        readonly common: "common";
+        readonly server: "server";
+        readonly tests: "test";
+        readonly output: "dist";
+    };
+    readonly development: {
+        readonly clientPort: 8000;
+        readonly serverPort: 8002;
+        readonly serverEnvironmentFile: ".env.server";
+    };
+    readonly build: {
+        readonly target: "es2023";
+        readonly sourceMaps: true;
+        readonly server: {
+            readonly external: readonly string[];
+        };
+    };
+    readonly test: {
+        readonly integration: {
+            readonly timeout: 30000;
+        };
+        readonly browser: {
+            readonly browser: BrowserName;
+        };
+    };
+};
+/** Provides contextual typing without transforming application configuration. */
+export declare function defineConfig(config: TypeFerryConfig): TypeFerryConfig;
+export declare function resolveApplicationConfig(root: string, input?: unknown): ResolvedApplicationConfig;
+export declare function loadApplicationConfig(root: string): Promise<ResolvedApplicationConfig>;

package/dist/application/config.js

@@ -0,0 +1,177 @@
+import { access, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { createJiti } from 'jiti';
+import { z } from 'zod';
+const browserNameSchema = z.enum(['chromium', 'firefox', 'webkit']);
+const positivePortSchema = z.number().int().min(1).max(65_535);
+const packageManifestSchema = z.object({
+    dependencies: z.record(z.string(), z.string()).optional(),
+    devDependencies: z.record(z.string(), z.string()).optional(),
+});
+const serverExternalSchema = z
+    .array(z
+    .string()
+    .min(1)
+    .refine(isPackageSpecifier, 'Expected an npm package specifier'))
+    .refine(values => new Set(values).size === values.length, {
+    message: 'Server external package specifiers must not contain duplicates',
+});
+const configSchema = z
+    .object({
+    development: z
+        .object({
+        clientPort: positivePortSchema.optional(),
+        serverPort: positivePortSchema.optional(),
+        serverEnvironmentFile: z.string().min(1).optional(),
+    })
+        .strict()
+        .optional(),
+    build: z
+        .object({
+        target: z.string().min(1).optional(),
+        sourceMaps: z.boolean().optional(),
+        server: z
+            .object({ external: serverExternalSchema.optional() })
+            .strict()
+            .optional(),
+    })
+        .strict()
+        .optional(),
+    test: z
+        .object({
+        integration: z
+            .object({ timeout: z.number().int().positive().optional() })
+            .strict()
+            .optional(),
+        browser: z
+            .object({ browser: browserNameSchema.optional() })
+            .strict()
+            .optional(),
+    })
+        .strict()
+        .optional(),
+})
+    .strict();
+export const DEFAULT_APPLICATION_CONFIG = {
+    paths: {
+        client: 'client',
+        common: 'common',
+        server: 'server',
+        tests: 'test',
+        output: 'dist',
+    },
+    development: {
+        clientPort: 8000,
+        serverPort: 8002,
+        serverEnvironmentFile: '.env.server',
+    },
+    build: {
+        target: 'es2023',
+        sourceMaps: true,
+        server: {
+            external: [],
+        },
+    },
+    test: {
+        integration: { timeout: 30_000 },
+        browser: { browser: 'chromium' },
+    },
+};
+/** Provides contextual typing without transforming application configuration. */
+export function defineConfig(config) {
+    return config;
+}
+export function resolveApplicationConfig(root, input = {}) {
+    const config = configSchema.parse(input);
+    return {
+        root: path.resolve(root),
+        paths: DEFAULT_APPLICATION_CONFIG.paths,
+        development: {
+            ...DEFAULT_APPLICATION_CONFIG.development,
+            ...config.development,
+        },
+        build: {
+            ...DEFAULT_APPLICATION_CONFIG.build,
+            ...config.build,
+            server: {
+                ...DEFAULT_APPLICATION_CONFIG.build.server,
+                ...config.build?.server,
+            },
+        },
+        test: {
+            integration: {
+                ...DEFAULT_APPLICATION_CONFIG.test.integration,
+                ...config.test?.integration,
+            },
+            browser: {
+                ...DEFAULT_APPLICATION_CONFIG.test.browser,
+                ...config.test?.browser,
+            },
+        },
+    };
+}
+export async function loadApplicationConfig(root) {
+    const configPath = path.join(root, 'typeferry.config.ts');
+    try {
+        await access(configPath);
+    }
+    catch {
+        return resolveApplicationConfig(root, withEnvironmentFile({}));
+    }
+    const jiti = createJiti(import.meta.url, { interopDefault: true });
+    const loaded = await jiti.import(configPath, { default: true });
+    const parsed = configSchema.parse(loaded);
+    const resolved = resolveApplicationConfig(root, withEnvironmentFile(parsed));
+    await validateServerExternalDependencies(resolved);
+    return resolved;
+}
+async function validateServerExternalDependencies(config) {
+    if (config.build.server.external.length === 0)
+        return;
+    const manifestPath = path.join(config.root, 'package.json');
+    const manifest = packageManifestSchema.parse(JSON.parse(await readFile(manifestPath, 'utf8')));
+    for (const external of config.build.server.external) {
+        const packageName = packageNameFromSpecifier(external);
+        if (manifest.dependencies?.[packageName] !== undefined)
+            continue;
+        if (manifest.devDependencies?.[packageName] !== undefined) {
+            throw new Error(`Server external "${external}" must be declared in dependencies, not devDependencies`);
+        }
+        throw new Error(`Server external "${external}" must be declared in package.json dependencies`);
+    }
+}
+function isPackageSpecifier(value) {
+    if (value.includes('*') || value.includes('\\') || value.includes(':')) {
+        return false;
+    }
+    const segments = value.split('/');
+    if (value.startsWith('@')) {
+        return (segments.length >= 2 &&
+            isPackageNameSegment(segments[0]?.slice(1) ?? '') &&
+            segments.every((segment, index) => index === 0 ? true : isPackageNameSegment(segment)));
+    }
+    return segments.every(isPackageNameSegment);
+}
+function isPackageNameSegment(value) {
+    return /^[a-z0-9][a-z0-9._~-]*$/u.test(value);
+}
+function packageNameFromSpecifier(specifier) {
+    const segments = specifier.split('/');
+    return specifier.startsWith('@')
+        ? `${segments[0]}/${segments[1]}`
+        : (segments[0] ?? specifier);
+}
+function withEnvironmentFile(config) {
+    if (config.development?.serverEnvironmentFile !== undefined ||
+        process.env['DEVELOP_ENV_FILE'] === undefined) {
+        return config;
+    }
+    return {
+        ...config,
+        development: {
+            ...config.development,
+            serverEnvironmentFile: process.env['DEVELOP_ENV_FILE'],
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/application/config.js.map

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

package/dist/application/develop.d.ts

@@ -0,0 +1,4 @@
+import type { ResolvedApplicationConfig } from './config.js';
+export declare const SHUTDOWN_SIGNALS: readonly ["SIGUSR2", "SIGINT", "SIGQUIT", "SIGTERM", "SIGHUP"];
+export declare function buildServerArguments(config: ResolvedApplicationConfig, arguments_: readonly string[]): string[];
+export declare function runDevelop(config: ResolvedApplicationConfig, serverArguments: readonly string[]): Promise<void>;

package/dist/application/develop.js

@@ -0,0 +1,119 @@
+import { spawn } from 'node:child_process';
+import { createWriteStream } from 'node:fs';
+import path from 'node:path';
+import { context } from 'esbuild';
+import kill from 'tree-kill';
+import { createServer } from 'vite';
+import { createServerBuildOptions } from './server-build.js';
+import { createViteConfig } from './vite-config.js';
+export const SHUTDOWN_SIGNALS = [
+    'SIGUSR2',
+    'SIGINT',
+    'SIGQUIT',
+    'SIGTERM',
+    'SIGHUP',
+];
+export function buildServerArguments(config, arguments_) {
+    return [
+        '--watch',
+        `--env-file=${config.development.serverEnvironmentFile}`,
+        path.join(config.paths.output, 'server', 'index.cjs'),
+        ...arguments_,
+    ];
+}
+export async function runDevelop(config, serverArguments) {
+    const logStream = createWriteStream(path.join(config.root, 'dev.log'), {
+        flags: 'w',
+    });
+    logStream.write(`--- started ${new Date().toISOString()} ---\n`);
+    const vite = await startVite(config);
+    const backendCompiler = await startBackendCompiler(config);
+    const backend = startBackend(config, serverArguments, logStream);
+    process.stdout.write(`TypeFerry application running at http://localhost:${config.development.clientPort}/\n`);
+    let shuttingDown = false;
+    const shutdown = async (signal) => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        writeTaggedOutput(logStream, 'develop', `received ${signal}; shutting down\n`);
+        await Promise.all([
+            stopProcess({ name: 'backend', process: backend }, logStream),
+            backendCompiler.dispose(),
+            vite.close(),
+        ]);
+        logStream.end();
+    };
+    for (const signal of SHUTDOWN_SIGNALS) {
+        process.on(signal, () => {
+            void shutdown(signal).then(() => {
+                process.exit(0);
+            });
+        });
+    }
+    backend.once('exit', code => {
+        if (!shuttingDown && code !== 0) {
+            void shutdown(`backend exit ${code ?? 'unknown'}`).then(() => {
+                process.exit(code ?? 1);
+            });
+        }
+    });
+}
+async function startVite(config) {
+    const server = await createServer(createViteConfig(config, 'develop'));
+    await server.listen();
+    return server;
+}
+async function startBackendCompiler(config) {
+    const compiler = await context(createServerBuildOptions(config));
+    await compiler.rebuild();
+    await compiler.watch();
+    return compiler;
+}
+function startBackend(config, arguments_, logStream) {
+    const child = spawn(process.execPath, buildServerArguments(config, arguments_), {
+        cwd: config.root,
+        detached: false,
+        stdio: ['inherit', 'pipe', 'pipe'],
+    });
+    child.stdout?.on('data', (chunk) => writeTaggedOutput(logStream, 'server', chunk.toString()));
+    child.stderr?.on('data', (chunk) => writeTaggedOutput(logStream, 'server', chunk.toString()));
+    return child;
+}
+function writeTaggedOutput(logStream, tag, data) {
+    const line = `[${tag}] ${data}`;
+    process.stdout.write(line);
+    logStream.write(line);
+}
+function stopProcess({ name, process: child }, logStream) {
+    return new Promise(resolveStop => {
+        const processId = child.pid;
+        if (processId === undefined || child.exitCode !== null) {
+            resolveStop();
+            return;
+        }
+        let completed = false;
+        const finish = () => {
+            if (!completed) {
+                completed = true;
+                resolveStop();
+            }
+        };
+        child.once('exit', finish);
+        kill(processId, 'SIGTERM', error => {
+            if (!error)
+                return;
+            writeTaggedOutput(logStream, 'develop', `${name} SIGTERM failed: ${error.message}\n`);
+            kill(processId, 'SIGKILL', killError => {
+                if (killError) {
+                    writeTaggedOutput(logStream, 'develop', `${name} SIGKILL failed: ${killError.message}\n`);
+                }
+                finish();
+            });
+        });
+        setTimeout(() => {
+            kill(processId, 'SIGKILL', () => finish());
+        }, 2_000).unref();
+        setTimeout(finish, 10_000).unref();
+    });
+}
+//# sourceMappingURL=develop.js.map

package/dist/application/develop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"develop.js","sourceRoot":"","sources":["../../src/application/develop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAE,iBAAiB,EAAoB,MAAM,SAAS,CAAA;AAC7D,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,OAAO,EAAqB,MAAM,SAAS,CAAA;AACpD,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,YAAY,EAAsB,MAAM,MAAM,CAAA;AAGvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAOhD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,SAAS;IACT,QAAQ;IACR,SAAS;IACT,SAAS;IACT,QAAQ;CACA,CAAA;AAEV,MAAM,UAAU,oBAAoB,CAClC,MAAiC,EACjC,UAA6B;IAE7B,OAAO;QACL,SAAS;QACT,cAAc,MAAM,CAAC,WAAW,CAAC,qBAAqB,EAAE;QACxD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC;QACrD,GAAG,UAAU;KACd,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAiC,EACjC,eAAkC;IAElC,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE;QACrE,KAAK,EAAE,GAAG;KACX,CAAC,CAAA;IACF,SAAS,CAAC,KAAK,CAAC,eAAe,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;IAEhE,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAA;IACpC,MAAM,eAAe,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,CAAA;IAC1D,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,SAAS,CAAC,CAAA;IAChE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,qDAAqD,MAAM,CAAC,WAAW,CAAC,UAAU,KAAK,CACxF,CAAA;IAED,IAAI,YAAY,GAAG,KAAK,CAAA;IACxB,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAc,EAAiB,EAAE;QACvD,IAAI,YAAY;YAAE,OAAM;QACxB,YAAY,GAAG,IAAI,CAAA;QACnB,iBAAiB,CACf,SAAS,EACT,SAAS,EACT,YAAY,MAAM,mBAAmB,CACtC,CAAA;QACD,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,WAAW,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,SAAS,CAAC;YAC7D,eAAe,CAAC,OAAO,EAAE;YACzB,IAAI,CAAC,KAAK,EAAE;SACb,CAAC,CAAA;QACF,SAAS,CAAC,GAAG,EAAE,CAAA;IACjB,CAAC,CAAA;IAED,KAAK,MAAM,MAAM,IAAI,gBAAgB,EAAE,CAAC;QACtC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;YACtB,KAAK,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACjB,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE;QAC1B,IAAI,CAAC,YAAY,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YAChC,KAAK,QAAQ,CAAC,gBAAgB,IAAI,IAAI,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC3D,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAA;YACzB,CAAC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,KAAK,UAAU,SAAS,CACtB,MAAiC;IAEjC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAA;IACtE,MAAM,MAAM,CAAC,MAAM,EAAE,CAAA;IACrB,OAAO,MAAM,CAAA;AACf,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,MAAiC;IAEjC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC,CAAA;IAChE,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAA;IACxB,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAA;IACtB,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,SAAS,YAAY,CACnB,MAAiC,EACjC,UAA6B,EAC7B,SAAsB;IAEtB,MAAM,KAAK,GAAG,KAAK,CACjB,OAAO,CAAC,QAAQ,EAChB,oBAAoB,CAAC,MAAM,EAAE,UAAU,CAAC,EACxC;QACE,GAAG,EAAE,MAAM,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK;QACf,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC;KACnC,CACF,CAAA;IAED,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CACzC,iBAAiB,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CACzD,CAAA;IACD,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CACzC,iBAAiB,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CACzD,CAAA;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,iBAAiB,CACxB,SAAsB,EACtB,GAAW,EACX,IAAY;IAEZ,MAAM,IAAI,GAAG,IAAI,GAAG,KAAK,IAAI,EAAE,CAAA;IAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC1B,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AACvB,CAAC;AAED,SAAS,WAAW,CAClB,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAkB,EACxC,SAAsB;IAEtB,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC,EAAE;QAC/B,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAA;QAC3B,IAAI,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACvD,WAAW,EAAE,CAAA;YACb,OAAM;QACR,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAA;QACrB,MAAM,MAAM,GAAG,GAAS,EAAE;YACxB,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,SAAS,GAAG,IAAI,CAAA;gBAChB,WAAW,EAAE,CAAA;YACf,CAAC;QACH,CAAC,CAAA;QAED,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC1B,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE;YACjC,IAAI,CAAC,KAAK;gBAAE,OAAM;YAElB,iBAAiB,CACf,SAAS,EACT,SAAS,EACT,GAAG,IAAI,oBAAoB,KAAK,CAAC,OAAO,IAAI,CAC7C,CAAA;YACD,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE;gBACrC,IAAI,SAAS,EAAE,CAAC;oBACd,iBAAiB,CACf,SAAS,EACT,SAAS,EACT,GAAG,IAAI,oBAAoB,SAAS,CAAC,OAAO,IAAI,CACjD,CAAA;gBACH,CAAC;gBACD,MAAM,EAAE,CAAA;YACV,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;QAEF,UAAU,CAAC,GAAG,EAAE;YACd,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAA;QAC5C,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,CAAA;QACjB,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KAAK,EAAE,CAAA;IACpC,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/application/paths.d.ts

@@ -0,0 +1 @@
+export declare function findApplicationRoot(start: string): Promise<string>;

package/dist/application/paths.js

@@ -0,0 +1,19 @@
+import { access } from 'node:fs/promises';
+import path from 'node:path';
+export async function findApplicationRoot(start) {
+    let candidate = path.resolve(start);
+    while (true) {
+        try {
+            await access(path.join(candidate, 'package.json'));
+            return candidate;
+        }
+        catch {
+            const parent = path.dirname(candidate);
+            if (parent === candidate) {
+                throw new Error(`Could not find an application package.json from ${start}`);
+            }
+            candidate = parent;
+        }
+    }
+}
+//# sourceMappingURL=paths.js.map

package/dist/application/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/application/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAAa;IACrD,IAAI,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAEnC,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAA;YAClD,OAAO,SAAS,CAAA;QAClB,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;YACtC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CACb,mDAAmD,KAAK,EAAE,CAC3D,CAAA;YACH,CAAC;YACD,SAAS,GAAG,MAAM,CAAA;QACpB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/application/proxy.d.ts

@@ -0,0 +1,6 @@
+import { type IncomingHttpHeaders } from 'node:http';
+import type { Plugin } from 'vite';
+export declare function isTypeFerryHttpPath(url: string | undefined): boolean;
+export declare function createTypeFerryDevProxy(backendPort: number): Plugin;
+/** Removes backend-only cookie domains without adding undefined headers. */
+export declare function rewriteProxyHeaders(proxyHeaders: IncomingHttpHeaders): IncomingHttpHeaders;

package/dist/application/proxy.js

@@ -0,0 +1,51 @@
+import { request as createHttpRequest, } from 'node:http';
+export function isTypeFerryHttpPath(url) {
+    return url === '/__h' || url?.startsWith('/__h/') === true;
+}
+export function createTypeFerryDevProxy(backendPort) {
+    return {
+        name: 'typeferry-development-proxy',
+        configureServer(server) {
+            server.middlewares.use((request, response, next) => {
+                if (!isTypeFerryHttpPath(request.url)) {
+                    next();
+                    return;
+                }
+                proxyRequest(request, response, backendPort);
+            });
+        },
+    };
+}
+/** Removes backend-only cookie domains without adding undefined headers. */
+export function rewriteProxyHeaders(proxyHeaders) {
+    const headers = { ...proxyHeaders };
+    const setCookie = headers['set-cookie'];
+    if (setCookie) {
+        headers['set-cookie'] = setCookie.map(cookie => cookie.replace(/;\s*Domain=[^;]+/giu, ''));
+    }
+    return headers;
+}
+function proxyRequest(clientRequest, clientResponse, backendPort) {
+    const proxyRequest = createHttpRequest({
+        hostname: '127.0.0.1',
+        port: backendPort,
+        method: clientRequest.method,
+        path: clientRequest.url,
+        headers: {
+            ...clientRequest.headers,
+            host: `localhost:${backendPort}`,
+        },
+    }, proxyResponse => {
+        clientResponse.writeHead(proxyResponse.statusCode ?? 502, rewriteProxyHeaders(proxyResponse.headers));
+        proxyResponse.pipe(clientResponse);
+    });
+    proxyRequest.on('error', (error) => {
+        if (!clientResponse.headersSent) {
+            clientResponse.writeHead(502, { 'content-type': 'text/plain' });
+        }
+        clientResponse.end(`TypeFerry development proxy error: ${error.message}`);
+    });
+    clientRequest.on('aborted', () => proxyRequest.destroy());
+    clientRequest.pipe(proxyRequest);
+}
+//# sourceMappingURL=proxy.js.map

package/dist/application/proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../../src/application/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,OAAO,IAAI,iBAAiB,GAE7B,MAAM,WAAW,CAAA;AAIlB,MAAM,UAAU,mBAAmB,CAAC,GAAuB;IACzD,OAAO,GAAG,KAAK,MAAM,IAAI,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;AAC5D,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,WAAmB;IACzD,OAAO;QACL,IAAI,EAAE,6BAA6B;QACnC,eAAe,CAAC,MAAM;YACpB,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;gBACjD,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;oBACtC,IAAI,EAAE,CAAA;oBACN,OAAM;gBACR,CAAC;gBAED,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAA;YAC9C,CAAC,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,mBAAmB,CACjC,YAAiC;IAEjC,MAAM,OAAO,GAAG,EAAE,GAAG,YAAY,EAAE,CAAA;IACnC,MAAM,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IACvC,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAC7C,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAC1C,CAAA;IACH,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,SAAS,YAAY,CACnB,aAA8B,EAC9B,cAA8B,EAC9B,WAAmB;IAEnB,MAAM,YAAY,GAAG,iBAAiB,CACpC;QACE,QAAQ,EAAE,WAAW;QACrB,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,aAAa,CAAC,MAAM;QAC5B,IAAI,EAAE,aAAa,CAAC,GAAG;QACvB,OAAO,EAAE;YACP,GAAG,aAAa,CAAC,OAAO;YACxB,IAAI,EAAE,aAAa,WAAW,EAAE;SACjC;KACF,EACD,aAAa,CAAC,EAAE;QACd,cAAc,CAAC,SAAS,CACtB,aAAa,CAAC,UAAU,IAAI,GAAG,EAC/B,mBAAmB,CAAC,aAAa,CAAC,OAAO,CAAC,CAC3C,CAAA;QACD,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;IACpC,CAAC,CACF,CAAA;IAED,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;QACxC,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC;YAChC,cAAc,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC,CAAA;QACjE,CAAC;QACD,cAAc,CAAC,GAAG,CAAC,sCAAsC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;IAC3E,CAAC,CAAC,CAAA;IACF,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CAAA;IACzD,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;AAClC,CAAC"}

package/dist/application/run-tests.d.ts

@@ -0,0 +1,3 @@
+import type { TestProjectName } from './cli-arguments.js';
+import type { ResolvedApplicationConfig } from './config.js';
+export declare function runTests(config: ResolvedApplicationConfig, project: TestProjectName | undefined, watch: boolean): Promise<void>;

package/dist/application/run-tests.js

@@ -0,0 +1,13 @@
+import { startVitest } from 'vitest/node';
+import { createTestConfig } from './test-config.js';
+export async function runTests(config, project, watch) {
+    const vitest = await startVitest('test', [], {
+        project: project === undefined ? undefined : [project],
+        root: config.root,
+        run: !watch,
+        watch,
+    }, createTestConfig(config));
+    if (!watch)
+        await vitest.close();
+}
+//# sourceMappingURL=run-tests.js.map

package/dist/application/run-tests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-tests.js","sourceRoot":"","sources":["../../src/application/run-tests.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAIzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAEhD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAiC,EACjC,OAAoC,EACpC,KAAc;IAEd,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B,MAAM,EACN,EAAE,EACF;QACE,OAAO,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QACtD,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG,EAAE,CAAC,KAAK;QACX,KAAK;KACN,EACD,gBAAgB,CAAC,MAAM,CAAC,CACzB,CAAA;IAED,IAAI,CAAC,KAAK;QAAE,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;AAClC,CAAC"}

package/dist/application/server-build.d.ts

@@ -0,0 +1,3 @@
+import type { BuildOptions } from 'esbuild';
+import type { ResolvedApplicationConfig } from './config.js';
+export declare function createServerBuildOptions(config: ResolvedApplicationConfig): BuildOptions;

package/dist/application/server-build.js

@@ -0,0 +1,17 @@
+import path from 'node:path';
+export function createServerBuildOptions(config) {
+    return {
+        bundle: true,
+        external: [...config.build.server.external],
+        entryPoints: [
+            path.join(config.root, config.paths.server, 'index.ts'),
+        ],
+        format: 'cjs',
+        outfile: path.join(config.root, config.paths.output, 'server', 'index.cjs'),
+        platform: 'node',
+        sourcemap: config.build.sourceMaps,
+        supported: { decorators: false },
+        target: config.build.target,
+    };
+}
+//# sourceMappingURL=server-build.js.map

package/dist/application/server-build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-build.js","sourceRoot":"","sources":["../../src/application/server-build.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAM5B,MAAM,UAAU,wBAAwB,CACtC,MAAiC;IAEjC,OAAO;QACL,MAAM,EAAE,IAAI;QACZ,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC3C,WAAW,EAAE;YACX,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC;SACxD;QACD,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,IAAI,CAAC,IAAI,CAChB,MAAM,CAAC,IAAI,EACX,MAAM,CAAC,KAAK,CAAC,MAAM,EACnB,QAAQ,EACR,WAAW,CACZ;QACD,QAAQ,EAAE,MAAM;QAChB,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU;QAClC,SAAS,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE;QAChC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;KAC5B,CAAA;AACH,CAAC"}

package/dist/application/test-config.d.ts

@@ -0,0 +1,4 @@
+import type { InlineConfig } from 'vite';
+import type { ResolvedApplicationConfig } from './config.js';
+export type ApplicationTestConfig = InlineConfig;
+export declare function createTestConfig(config: ResolvedApplicationConfig): ApplicationTestConfig;

package/dist/application/test-config.js

@@ -0,0 +1,91 @@
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { babel } from '@rollup/plugin-babel';
+import tailwindcss from '@tailwindcss/vite';
+import react from '@vitejs/plugin-react';
+import { playwright } from '@vitest/browser-playwright';
+export function createTestConfig(config) {
+    const alias = { '@': config.root };
+    const projectRoots = '{client,common,server,test}';
+    return {
+        configFile: false,
+        root: config.root,
+        resolve: { alias },
+        test: {
+            projects: [
+                {
+                    resolve: { alias },
+                    test: {
+                        name: 'unit',
+                        include: [
+                            `${projectRoots}/**/*.unit.spec.ts`,
+                            `${projectRoots}/**/*.unit.spec.tsx`,
+                        ],
+                        setupFiles: optionalSetup(config.root, 'setup-unit.ts'),
+                    },
+                },
+                {
+                    plugins: [
+                        babel({
+                            babelHelpers: 'bundled',
+                            babelrc: false,
+                            configFile: false,
+                            extensions: ['.ts', '.tsx'],
+                            plugins: [
+                                [
+                                    '@babel/plugin-proposal-decorators',
+                                    { version: '2023-11' },
+                                ],
+                            ],
+                        }),
+                    ],
+                    resolve: { alias },
+                    test: {
+                        name: 'integration',
+                        fileParallelism: false,
+                        hookTimeout: config.test.integration.timeout,
+                        include: [
+                            `${projectRoots}/**/*.integration.spec.ts`,
+                            `${projectRoots}/**/*.integration.spec.tsx`,
+                        ],
+                        setupFiles: optionalSetup(config.root, 'setup-integration.ts'),
+                        testTimeout: config.test.integration.timeout,
+                    },
+                },
+                {
+                    plugins: [react(), tailwindcss()],
+                    resolve: {
+                        alias: {
+                            ...alias,
+                            react: path.join(config.root, 'node_modules', 'react'),
+                            'react-dom': path.join(config.root, 'node_modules', 'react-dom'),
+                        },
+                    },
+                    test: {
+                        name: 'browser',
+                        // Vitest's browser mock API requires globals when it is mirrored
+                        // through the public typeferry/test entry point.
+                        globals: true,
+                        browser: {
+                            enabled: true,
+                            headless: true,
+                            instances: [{ browser: config.test.browser.browser }],
+                            provider: playwright(),
+                            screenshotFailures: false,
+                        },
+                        include: [
+                            `${projectRoots}/**/*.browser.spec.ts`,
+                            `${projectRoots}/**/*.browser.spec.tsx`,
+                        ],
+                        setupFiles: optionalSetup(config.root, 'setup-browser.ts'),
+                    },
+                },
+            ],
+        },
+    };
+}
+function optionalSetup(root, fileName) {
+    const setupPath = path.join(root, 'test', fileName);
+    return existsSync(setupPath) ? [setupPath] : [];
+}
+//# sourceMappingURL=test-config.js.map

package/dist/application/test-config.js.map

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

package/dist/application/vite-config.d.ts

@@ -0,0 +1,3 @@
+import type { InlineConfig } from 'vite';
+import type { ResolvedApplicationConfig } from './config.js';
+export declare function createViteConfig(config: ResolvedApplicationConfig, command: 'develop' | 'build'): InlineConfig;

package/dist/application/vite-config.js

@@ -0,0 +1,43 @@
+import path from 'node:path';
+import tailwindcss from '@tailwindcss/vite';
+import react from '@vitejs/plugin-react';
+import { createTypeFerryDevProxy } from './proxy.js';
+export function createViteConfig(config, command) {
+    const plugins = [react(), tailwindcss()];
+    if (command === 'develop') {
+        plugins.unshift(createTypeFerryDevProxy(config.development.serverPort));
+    }
+    return {
+        configFile: false,
+        root: path.join(config.root, config.paths.client),
+        plugins,
+        server: {
+            allowedHosts: true,
+            host: '0.0.0.0',
+            port: config.development.clientPort,
+            hmr: { overlay: true },
+            watch: {
+                ignored: ['**/*.spec.ts', '**/*.spec.tsx'],
+            },
+        },
+        resolve: {
+            preserveSymlinks: true,
+            alias: {
+                react: path.join(config.root, 'node_modules', 'react'),
+                'react-dom': path.join(config.root, 'node_modules', 'react-dom'),
+                '@': config.root,
+            },
+        },
+        build: {
+            outDir: path.relative(path.join(config.root, config.paths.client), path.join(config.root, config.paths.output, 'client')),
+            emptyOutDir: true,
+            manifest: true,
+            target: config.build.target,
+            sourcemap: config.build.sourceMaps,
+            rollupOptions: {
+                input: path.join(config.root, config.paths.client, 'index.html'),
+            },
+        },
+    };
+}
+//# sourceMappingURL=vite-config.js.map

package/dist/application/vite-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-config.js","sourceRoot":"","sources":["../../src/application/vite-config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,WAAW,MAAM,mBAAmB,CAAA;AAC3C,OAAO,KAAK,MAAM,sBAAsB,CAAA;AAIxC,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA;AAEjD,MAAM,UAAU,gBAAgB,CAC9B,MAAiC,EACjC,OAA4B;IAE5B,MAAM,OAAO,GAAmB,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC,CAAA;IACxD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,CAAC,OAAO,CAAC,uBAAuB,CAAC,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAA;IACzE,CAAC;IAED,OAAO;QACL,UAAU,EAAE,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;QACjD,OAAO;QACP,MAAM,EAAE;YACN,YAAY,EAAE,IAAI;YAClB,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,UAAU;YACnC,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;YACtB,KAAK,EAAE;gBACL,OAAO,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC;aAC3C;SACF;QACD,OAAO,EAAE;YACP,gBAAgB,EAAE,IAAI;YACtB,KAAK,EAAE;gBACL,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC;gBACtD,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,WAAW,CAAC;gBAChE,GAAG,EAAE,MAAM,CAAC,IAAI;aACjB;SACF;QACD,KAAK,EAAE;YACL,MAAM,EAAE,IAAI,CAAC,QAAQ,CACnB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAC3C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CACtD;YACD,WAAW,EAAE,IAAI;YACjB,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;YAC3B,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU;YAClC,aAAa,EAAE;gBACb,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC;aACjE;SACF;KACF,CAAA;AACH,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/index.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { CLI_USAGE, } from '../application/cli-arguments.js';
+import { runCli } from './run.js';
+runCli(process.argv.slice(2)).catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(message);
+    console.error(CLI_USAGE);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA,OAAO,EACL,SAAS,GACV,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAE9B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACrD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACtE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACtB,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IACxB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;AACtB,CAAC,CAAC,CAAA"}

package/dist/cli/run.d.ts

@@ -0,0 +1 @@
+export declare function runCli(arguments_: readonly string[]): Promise<void>;

package/dist/cli/run.js

@@ -0,0 +1,21 @@
+import { runBuild } from '../application/build.js';
+import { parseCliArguments } from '../application/cli-arguments.js';
+import { loadApplicationConfig } from '../application/config.js';
+import { runDevelop } from '../application/develop.js';
+import { findApplicationRoot } from '../application/paths.js';
+import { runTests } from '../application/run-tests.js';
+export async function runCli(arguments_) {
+    const parsed = parseCliArguments(arguments_);
+    const root = await findApplicationRoot(process.cwd());
+    const config = await loadApplicationConfig(root);
+    if (parsed.command === 'build') {
+        await runBuild(config);
+        return;
+    }
+    if (parsed.command === 'develop') {
+        await runDevelop(config, parsed.serverArguments);
+        return;
+    }
+    await runTests(config, parsed.project, parsed.watch);
+}
+//# sourceMappingURL=run.js.map

package/dist/cli/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAEnD,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,UAA6B;IACxD,MAAM,MAAM,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAA;IAC5C,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;IACrD,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAA;IAEhD,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QAC/B,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAA;QACtB,OAAM;IACR,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,eAAe,CAAC,CAAA;QAChD,OAAM;IACR,CAAC;IAED,MAAM,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;AACtD,CAAC"}

package/dist/testing/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Mirrors the installed Vitest release for TypeFerry application tests.
+ *
+ * This surface intentionally follows Vitest and does not provide independent
+ * TypeFerry compatibility guarantees for individual exports.
+ */
+export * from 'vitest';

package/dist/testing/index.js

@@ -0,0 +1,8 @@
+/**
+ * Mirrors the installed Vitest release for TypeFerry application tests.
+ *
+ * This surface intentionally follows Vitest and does not provide independent
+ * TypeFerry compatibility guarantees for individual exports.
+ */
+export * from 'vitest';
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,QAAQ,CAAA"}

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "typeferry",
-  "version": "0.7.5",
+  "version": "0.9.0",
   "description": "Type-safe real-time RPC framework for TypeScript",
   "type": "module",
   "sideEffects": false,
   "license": "MIT",
+  "bin": {
+    "typeferry": "./dist/cli/index.js"
+  },
   "files": [
     "dist"
   ],
@@ -57,6 +60,14 @@
       "types": "./dist/utils/index.d.ts",
       "import": "./dist/utils/index.js"
     },
+    "./config": {
+      "types": "./dist/application/config.d.ts",
+      "import": "./dist/application/config.js"
+    },
+    "./test": {
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing/index.js"
+    },
     "./*": {
       "types": "./dist/*.d.ts",
       "import": "./dist/*.js"
@@ -64,6 +75,7 @@
   },
   "scripts": {
     "build": "rm -rf dist && tsc -p tsconfig.build.json && node scripts/prepare-dist.mjs",
+    "verify:consumer": "node ../scripts/verify-application-consumer.mjs",
     "typecheck": "tsc --noEmit",
     "test": "npm run test:unit && npm run test:integration && npm run test:browser",
     "test:watch": "npm run test:unit:watch",
@@ -78,18 +90,32 @@
     "lint:fix": "eslint src/ --fix"
   },
   "dependencies": {
+    "@babel/core": "^7.29.7",
+    "@babel/plugin-proposal-decorators": "^7.29.7",
     "@hono/node-server": "^2.1.1",
     "@lukeed/uuid": "^2.0.1",
+    "@rollup/plugin-babel": "^7.1.0",
+    "@tailwindcss/vite": "^4.3.3",
+    "@vitejs/plugin-react": "5.2.0",
+    "@vitest/browser": "4.1.11",
+    "@vitest/browser-playwright": "4.1.11",
+    "esbuild": "0.28.1",
     "fast-deep-equal": "^3.1.3",
     "google-auth-library": "^10.9.0",
     "hono": "^4.13.3",
+    "jiti": "^2.6.1",
     "jsonwebtoken": "^9.0.2",
     "limiter": "^2.1.0",
     "memoizee": "^0.4.15",
+    "playwright": "1.62.1",
     "query-string": "^9.5.0",
     "redis": "^4.6.7",
+    "tailwindcss": "^4.3.3",
+    "tree-kill": "^1.2.2",
     "ua-parser-js": "^2.0.10",
     "use-debounce": "^10.1.1",
+    "vite": "7.3.6",
+    "vitest": "4.1.11",
     "ws": "^8.21.3",
     "zod": "^4.4.3"
   },
@@ -120,24 +146,18 @@
     "@types/sinon": "^10.0.16",
     "@types/ua-parser-js": "^0.7.39",
     "@types/ws": "^8",
-    "@vitest/browser": "^4.1.11",
-    "@vitest/browser-playwright": "^4.1.11",
     "@vitest/coverage-v8": "^4.1.11",
-    "esbuild": "^0.28.1",
     "eslint": "^10.9.0",
     "eslint-plugin-security": "^4.0.1",
     "globals": "^17.7.0",
     "jsdom": "^30.0.1",
     "mongodb": "^7.5.0",
-    "playwright": "^1.61.1",
     "postcss": "^8.5.26",
     "react": "^19.2.3",
     "react-dom": "^19.2.3",
     "sinon": "^18.0.0",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.67.0",
-    "vite": "^7.3.3",
-    "vitest": "^4.1.11"
+    "typescript-eslint": "^8.67.0"
   },
   "overrides": {
     "body-parser": "^2.3.0",
@@ -147,8 +167,7 @@
     "nanoid": "^6.0.1",
     "postcss": "^8.5.26",
     "qs": "^6.15.3",
-    "undici": "^7.29.0",
-    "vite": "^7.3.3"
+    "undici": "^7.29.0"
   },
   "engines": {
     "node": ">=24.19.0 <27",