@fluojs/cli 1.1.0 → 3.0.0

package/dist/new/templates/react-vite-ssr/tests/production-hydration.spec.ts.ejs

@@ -0,0 +1,54 @@
+import { expect, test } from '@playwright/test';
+
+test('hydrates production HTML and preserves HTTP-first navigation', async ({ page }) => {
+  const browserDiagnostics: string[] = [];
+  const assetResponses = new Map<string, number>();
+
+  page.on('console', (message) => {
+    if (message.type() === 'error' || message.type() === 'warning') {
+      browserDiagnostics.push(`${message.type()}: ${message.text()}`);
+    }
+  });
+  page.on('pageerror', (error) => browserDiagnostics.push(`pageerror: ${error.message}`));
+  page.on('response', (response) => {
+    const pathname = new URL(response.url()).pathname;
+    if (pathname.startsWith('/assets/')) {
+      assetResponses.set(pathname, response.status());
+    }
+  });
+
+  const response = await page.goto('/products/sku-42?preview=true', { waitUntil: 'load' });
+  if (response === null) {
+    throw new TypeError('The production page did not return a navigation response.');
+  }
+
+  const bootstrapPaths = await page.locator('script[type="module"][src]').evaluateAll((scripts) =>
+    scripts.map((script) => new URL(script.getAttribute('src') ?? '', document.baseURI).pathname),
+  );
+  const stylesheetPaths = await page.locator('link[data-vite-style][href]').evaluateAll((links) =>
+    links.map((link) => new URL(link.getAttribute('href') ?? '', document.baseURI).pathname),
+  );
+
+  expect(response.status()).toBe(200);
+  expect(response.headers()['content-type']).toContain('text/html');
+  expect(bootstrapPaths).toContain('/assets/entry-client.js');
+  expect(stylesheetPaths).toHaveLength(1);
+  for (const pathname of [...bootstrapPaths, ...stylesheetPaths]) {
+    expect(assetResponses.get(pathname)).toBe(200);
+  }
+
+  await expect(page.getByRole('heading', { name: 'Catalog item sku-42' })).toBeVisible();
+  await page.getByRole('button', { name: 'Count: 0' }).click();
+  await expect(page.getByRole('button', { name: 'Count: 1' })).toBeVisible();
+
+  const link = page.getByRole('link', { name: 'Open sku-84' });
+  await expect(link).toHaveAttribute('href', '/products/sku-84?preview=false');
+  await link.click();
+  await expect(page).toHaveURL(/\/products\/sku-84\?preview=false$/u);
+  await expect(page.getByRole('heading', { name: 'Catalog item sku-84' })).toBeVisible();
+
+  await page.getByRole('button', { name: 'Push sku-126' }).click();
+  await expect(page).toHaveURL(/\/products\/sku-126\?preview=true$/u);
+  await expect(page.getByRole('heading', { name: 'Catalog item sku-126' })).toBeVisible();
+  expect(browserDiagnostics).toEqual([]);
+});

package/dist/new/templates/react-vite-ssr/tsconfig.json.ejs

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "jsx": "react-jsx",
+    "resolveJsonModule": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*.ts", "src/**/*.tsx", "tests/**/*.ts", "*.config.ts"]
+}

package/dist/new/templates/react-vite-ssr/vite.client.config.ts.ejs

@@ -0,0 +1,24 @@
+import { fileURLToPath } from 'node:url';
+
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  base: '/assets/',
+  build: {
+    emptyOutDir: true,
+    manifest: true,
+    outDir: 'dist/client',
+    rolldownOptions: {
+      input: {
+        'entry-client': fileURLToPath(new URL('./src/entry-client.tsx', import.meta.url)),
+        'entry-server': fileURLToPath(new URL('./src/entry-server.tsx', import.meta.url)),
+      },
+      output: {
+        assetFileNames: '[name]-[hash][extname]',
+        chunkFileNames: '[name]-[hash].js',
+        entryFileNames: '[name].js',
+      },
+    },
+    target: 'es2022',
+  },
+});

package/dist/new/templates/react-vite-ssr/vite.server.config.ts.ejs

@@ -0,0 +1,17 @@
+import { fluoDecoratorsPlugin } from '@fluojs/vite';
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  build: {
+    emptyOutDir: false,
+    outDir: 'dist/server',
+    rolldownOptions: {
+      output: {
+        entryFileNames: 'main.js',
+      },
+    },
+    ssr: 'src/main.ts',
+    target: 'node24',
+  },
+  plugins: [fluoDecoratorsPlugin()],
+});

package/dist/new/templates/react-vite-ssr/vitest.config.ts.ejs

@@ -0,0 +1,10 @@
+import { fluoBabelDecoratorsPlugin } from '@fluojs/testing/vitest';
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  plugins: [fluoBabelDecoratorsPlugin()],
+  test: {
+    environment: 'node',
+    include: ['src/**/*.test.ts', 'src/**/*.test.tsx'],
+  },
+});

package/dist/new/types.d.ts

@@ -4,6 +4,8 @@ export type PackageManager = 'bun' | 'npm' | 'pnpm' | 'yarn';
 export type DependencySource = 'local' | 'published';
 /** Supported starter shapes for `fluo new`. */
 export type BootstrapShape = 'application' | 'microservice' | 'mixed';
+/** Named starter variants exposed by `fluo new`. */
+export type BootstrapStarter = 'react-vite-ssr' | 'standard';
 /** Supported runtime families for the current starter matrix. */
 export type BootstrapRuntime = 'bun' | 'cloudflare-workers' | 'deno' | 'node';
 /** Supported platform adapters for the current starter matrix. */
@@ -36,6 +38,7 @@ export interface BootstrapOptions extends BootstrapSchema {
     projectName: string;
     repoRoot?: string;
     skipInstall?: boolean;
+    starter?: BootstrapStarter;
     targetDirectory: string;
 }
 /** Prompt descriptor for bootstrap answer collection. */
@@ -49,15 +52,14 @@ export interface BootstrapAnswers extends BootstrapSchema {
     installDependencies: boolean;
     packageManager: PackageManager;
     projectName: string;
+    starter: BootstrapStarter;
     targetDirectory: string;
 }
 /** Programmatic overrides for `runNewCommand(...)`. */
 export interface NewCommandOptions {
-    dependencySource?: DependencySource;
     force?: boolean;
     initializeGit?: boolean;
     installDependencies?: boolean;
-    repoRoot?: string;
     skipInstall?: boolean;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/new/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/new/types.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAC7D,yDAAyD;AACzD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,WAAW,CAAC;AACrD,+CAA+C;AAC/C,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,cAAc,GAAG,OAAO,CAAC;AACtE,iEAAiE;AACjE,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,oBAAoB,GAAG,MAAM,GAAG,MAAM,CAAC;AAC9E,kEAAkE;AAClE,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,oBAAoB,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAClH,mEAAmE;AACnE,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,eAAe,GAAG,KAAK,CAAC;AACpH,gEAAgE;AAChE,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC;AAEhD,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,sBAAsB,CAAC;IAChC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,SAAS,EAAE,kBAAkB,CAAC;CAC/B;AAED,2EAA2E;AAC3E,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,yDAAyD;AACzD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,gBAAgB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,mFAAmF;AACnF,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,aAAa,EAAE,OAAO,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/new/types.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAC7D,yDAAyD;AACzD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,WAAW,CAAC;AACrD,+CAA+C;AAC/C,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,cAAc,GAAG,OAAO,CAAC;AACtE,oDAAoD;AACpD,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,GAAG,UAAU,CAAC;AAC7D,iEAAiE;AACjE,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,oBAAoB,GAAG,MAAM,GAAG,MAAM,CAAC;AAC9E,kEAAkE;AAClE,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,oBAAoB,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAClH,mEAAmE;AACnE,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,eAAe,GAAG,KAAK,CAAC;AACpH,gEAAgE;AAChE,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC;AAEhD,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,sBAAsB,CAAC;IAChC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,SAAS,EAAE,kBAAkB,CAAC;CAC/B;AAED,2EAA2E;AAC3E,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,yDAAyD;AACzD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,gBAAgB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,mFAAmF;AACnF,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,aAAa,EAAE,OAAO,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}

package/dist/public-generate.d.ts

@@ -0,0 +1,2 @@
+export { type GeneratePlanAction, type GeneratePlanEntry, type GenerateResult, runGenerateCommand } from './generate-command.js';
+//# sourceMappingURL=public-generate.d.ts.map

package/dist/public-generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-generate.d.ts","sourceRoot":"","sources":["../src/public-generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/public-generate.js

@@ -0,0 +1 @@
+export { runGenerateCommand } from './generate-command.js';

package/dist/public-inspect.d.ts

@@ -0,0 +1,13 @@
+import type { InspectCommandRuntimeOptions } from './commands/inspect.js';
+import { inspectUsage } from './usage.js';
+export type { InspectCommandRuntimeOptions } from './commands/inspect.js';
+export { inspectUsage };
+/**
+ * Runs the inspect command through a lazy implementation import.
+ *
+ * @param argv Command arguments after `inspect`.
+ * @param runtime Runtime overrides for programmatic callers.
+ * @returns Process-style exit code from the inspect command.
+ */
+export declare function runInspectCommand(argv: string[], runtime?: InspectCommandRuntimeOptions): Promise<number>;
+//# sourceMappingURL=public-inspect.d.ts.map

package/dist/public-inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-inspect.d.ts","sourceRoot":"","sources":["../src/public-inspect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,YAAY,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,4BAAiC,GAAG,OAAO,CAAC,MAAM,CAAC,CAGnH"}

package/dist/public-inspect.js

@@ -0,0 +1,16 @@
+import { inspectUsage } from './usage.js';
+export { inspectUsage };
+
+/**
+ * Runs the inspect command through a lazy implementation import.
+ *
+ * @param argv Command arguments after `inspect`.
+ * @param runtime Runtime overrides for programmatic callers.
+ * @returns Process-style exit code from the inspect command.
+ */
+export async function runInspectCommand(argv, runtime = {}) {
+  const {
+    runInspectCommand: runInspectCommandImplementation
+  } = await import('./commands/inspect.js');
+  return runInspectCommandImplementation(argv, runtime);
+}

package/dist/public-new.d.ts

@@ -0,0 +1,13 @@
+import type { NewCommandRuntimeOptions } from './commands/new.js';
+import { newUsage } from './usage.js';
+export type { NewCommandRuntimeOptions } from './commands/new.js';
+export { newUsage };
+/**
+ * Runs the new command through a lazy implementation import.
+ *
+ * @param argv Command arguments after `new` or `create`.
+ * @param runtime Runtime overrides for programmatic callers.
+ * @returns Process-style exit code from the new command.
+ */
+export declare function runNewCommand(argv: string[], runtime?: NewCommandRuntimeOptions): Promise<number>;
+//# sourceMappingURL=public-new.d.ts.map

package/dist/public-new.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-new.d.ts","sourceRoot":"","sources":["../src/public-new.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,YAAY,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAEpB;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,MAAM,CAAC,CAG3G"}

package/dist/public-new.js

@@ -0,0 +1,16 @@
+import { newUsage } from './usage.js';
+export { newUsage };
+
+/**
+ * Runs the new command through a lazy implementation import.
+ *
+ * @param argv Command arguments after `new` or `create`.
+ * @param runtime Runtime overrides for programmatic callers.
+ * @returns Process-style exit code from the new command.
+ */
+export async function runNewCommand(argv, runtime = {}) {
+  const {
+    runNewCommand: runNewCommandImplementation
+  } = await import('./commands/new.js');
+  return runNewCommandImplementation(argv, runtime);
+}

package/dist/public-typegen.d.ts

@@ -0,0 +1,14 @@
+import type { TypegenCommandRuntimeOptions } from './commands/typegen.js';
+import { TYPEGEN_EXIT_CODES } from './typegen-contract.js';
+import { typegenUsage } from './usage.js';
+export type { TypegenCommandRuntimeOptions } from './commands/typegen.js';
+export { TYPEGEN_EXIT_CODES, typegenUsage };
+/**
+ * Runs React page generation, checking, or watch mode through a lazy implementation import.
+ *
+ * @param argv Command arguments after `typegen`.
+ * @param runtime Runtime overrides for programmatic callers.
+ * @returns Process-style exit code from the typegen command.
+ */
+export declare function runTypegenCommand(argv: readonly string[], runtime?: TypegenCommandRuntimeOptions): Promise<number>;
+//# sourceMappingURL=public-typegen.d.ts.map

package/dist/public-typegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-typegen.d.ts","sourceRoot":"","sources":["../src/public-typegen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,YAAY,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,CAAC;AAE5C;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,MAAM,CAAC,CAGjB"}

package/dist/public-typegen.js

@@ -0,0 +1,17 @@
+import { TYPEGEN_EXIT_CODES } from './typegen-contract.js';
+import { typegenUsage } from './usage.js';
+export { TYPEGEN_EXIT_CODES, typegenUsage };
+
+/**
+ * Runs React page generation, checking, or watch mode through a lazy implementation import.
+ *
+ * @param argv Command arguments after `typegen`.
+ * @param runtime Runtime overrides for programmatic callers.
+ * @returns Process-style exit code from the typegen command.
+ */
+export async function runTypegenCommand(argv, runtime = {}) {
+  const {
+    runTypegenCommand: runTypegenCommandImplementation
+  } = await import('./commands/typegen.js');
+  return runTypegenCommandImplementation(argv, runtime);
+}

package/dist/run-cli.d.ts

@@ -1,6 +1,7 @@
 import type { CliRuntimeOptions } from './cli.js';
 import type { InspectCommandRuntimeOptions } from './commands/inspect.js';
 import type { NewCommandRuntimeOptions } from './commands/new.js';
+import type { TypegenCommandRuntimeOptions } from './commands/typegen.js';
 export type { CliRuntimeOptions } from './cli.js';
 /**
  * Runs the top-level CLI command dispatcher through a lazy implementation import.
@@ -12,5 +13,5 @@ export type { CliRuntimeOptions } from './cli.js';
  * @param runtime Optional runtime overrides shared by the top-level dispatcher and delegated commands.
  * @returns `0` when the command completes successfully, otherwise the delegated command exit code.
  */
-export declare function runCli(argv?: string[], runtime?: CliRuntimeOptions & NewCommandRuntimeOptions & InspectCommandRuntimeOptions): Promise<number>;
+export declare function runCli(argv?: string[], runtime?: CliRuntimeOptions & NewCommandRuntimeOptions & InspectCommandRuntimeOptions & TypegenCommandRuntimeOptions): Promise<number>;
 //# sourceMappingURL=run-cli.d.ts.map

package/dist/run-cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-cli.d.ts","sourceRoot":"","sources":["../src/run-cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAElE,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD;;;;;;;;;GASG;AACH,wBAAsB,MAAM,CAC1B,IAAI,CAAC,EAAE,MAAM,EAAE,EACf,OAAO,GAAE,iBAAiB,GAAG,wBAAwB,GAAG,4BAAiC,GACxF,OAAO,CAAC,MAAM,CAAC,CAGjB"}
+{"version":3,"file":"run-cli.d.ts","sourceRoot":"","sources":["../src/run-cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAE1E,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD;;;;;;;;;GASG;AACH,wBAAsB,MAAM,CAC1B,IAAI,CAAC,EAAE,MAAM,EAAE,EACf,OAAO,GAAE,iBAAiB,GAAG,wBAAwB,GAAG,4BAA4B,GAAG,4BAAiC,GACvH,OAAO,CAAC,MAAM,CAAC,CAGjB"}

package/dist/studio/sidecar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sidecar.d.ts","sourceRoot":"","sources":["../../src/studio/sidecar.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAwQD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC,CAmLnG"}
+{"version":3,"file":"sidecar.d.ts","sourceRoot":"","sources":["../../src/studio/sidecar.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAkVD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC,CAwMnG"}

package/dist/studio/sidecar.js

@@ -21,10 +21,36 @@ const DEFAULT_HOST = '127.0.0.1';
 const DEFAULT_HEARTBEAT_MS = 15_000;
 const MAX_EVENT_REPLAY = 1_000;
 const MAX_REQUEST_BYTES = 1_048_576;
+const BODY_LIKE_PAYLOAD_FIELDS = new Set(['body', 'headers', 'payload', 'rawBody', 'requestBody', 'responseBody']);
 const require = createRequire(import.meta.url);
 function isRecord(value) {
   return typeof value === 'object' && value !== null;
 }
+function findBodyLikePayloadField(value, path = 'payload') {
+  if (Array.isArray(value)) {
+    for (const [index, item] of value.entries()) {
+      const match = findBodyLikePayloadField(item, `${path}[${String(index)}]`);
+      if (match) {
+        return match;
+      }
+    }
+    return undefined;
+  }
+  if (!isRecord(value)) {
+    return undefined;
+  }
+  for (const [key, nestedValue] of Object.entries(value)) {
+    const nestedPath = `${path}.${key}`;
+    if (BODY_LIKE_PAYLOAD_FIELDS.has(key)) {
+      return nestedPath;
+    }
+    const match = findBodyLikePayloadField(nestedValue, nestedPath);
+    if (match) {
+      return match;
+    }
+  }
+  return undefined;
+}
 function isRestartEpochBoundary(incoming) {
   if (incoming.type !== 'restart' || !isRecord(incoming.payload)) {
     return false;
@@ -60,20 +86,53 @@ function createDefaultAppId() {
 }
 function readBody(request) {
   return new Promise((resolve, reject) => {
+    let settled = false;
     let body = '';
     request.setEncoding('utf8');
-    request.on('data', chunk => {
+    const settle = (action, value) => {
+      if (settled) {
+        return;
+      }
+      settled = true;
+      request.off('data', onData);
+      request.off('end', onEnd);
+      request.off('error', onError);
+      request.off('close', onClose);
+      if (action === 'resolve') {
+        resolve(value);
+      } else {
+        reject(value);
+      }
+    };
+    const onData = chunk => {
       body += chunk;
       if (body.length > MAX_REQUEST_BYTES) {
-        reject(new Error('Studio event payload is too large.'));
+        settle('reject', new Error('Studio event payload is too large.'));
         request.destroy();
       }
-    });
-    request.on('end', () => resolve(body));
-    request.on('error', reject);
+    };
+    const onEnd = () => settle('resolve', body);
+    const onError = error => settle('reject', error);
+    // A client that closes the socket after sending only a partial request body
+    // may never emit `end` or `error`. Bind `close` to body-reader cancellation
+    // so the sidecar cannot hang on a malformed local client indefinitely.
+    const onClose = () => {
+      if (body.length === 0) {
+        settle('reject', new Error('Studio sidecar request closed before any body was received.'));
+        return;
+      }
+      settle('reject', new Error('Studio sidecar request closed before the full body was received.'));
+    };
+    request.on('data', onData);
+    request.on('end', onEnd);
+    request.on('error', onError);
+    request.on('close', onClose);
   });
 }
 function writeJson(response, statusCode, payload) {
+  if (response.writableEnded) {
+    return;
+  }
   response.writeHead(statusCode, {
     'cache-control': 'no-store',
     'content-type': 'application/json; charset=utf-8'
@@ -237,6 +296,8 @@ export async function startStudioSidecar(options = {}) {
   const token = createToken();
   const events = [];
   const clients = new Set();
+  const ingestionRequests = new Set();
+  let acceptingIngestion = true;
   let sequence = 0;
   const startedAt = performance.now();
   const publish = incoming => {
@@ -326,6 +387,11 @@ export async function startStudioSidecar(options = {}) {
       return;
     }
     if (request.method === 'POST' && requestUrl.pathname === '/api/runtime/events') {
+      if (!acceptingIngestion) {
+        request.socket.destroy();
+        return;
+      }
+      ingestionRequests.add(request);
       try {
         const body = await readBody(request);
         const parsed = body ? JSON.parse(body) : {};
@@ -335,6 +401,13 @@ export async function startStudioSidecar(options = {}) {
           });
           return;
         }
+        const bodyLikeField = findBodyLikePayloadField(parsed.payload);
+        if (bodyLikeField) {
+          writeJson(response, 400, {
+            error: `Studio runtime event payload must not include body-like field ${bodyLikeField}.`
+          });
+          return;
+        }
         const event = publish(parsed);
         writeJson(response, 202, {
           accepted: true,
@@ -345,6 +418,8 @@ export async function startStudioSidecar(options = {}) {
         writeJson(response, 400, {
           error: error instanceof Error ? error.message : String(error)
         });
+      } finally {
+        ingestionRequests.delete(request);
       }
       return;
     }
@@ -361,7 +436,11 @@ export async function startStudioSidecar(options = {}) {
   });
   const address = server.address();
   if (!address || typeof address === 'string') {
-    await closeServer(server, clients, undefined);
+    await closeServer(server, {
+      clients,
+      heartbeat: undefined,
+      ingestionRequests
+    });
     throw new Error('Failed to resolve Studio sidecar address.');
   }
   const url = `http://${host}:${String(address.port)}`;
@@ -378,6 +457,7 @@ export async function startStudioSidecar(options = {}) {
     });
   }, options.heartbeatMs ?? DEFAULT_HEARTBEAT_MS);
   heartbeat?.unref();
+  let closePromise;
   return {
     appId,
     get epoch() {
@@ -396,20 +476,28 @@ export async function startStudioSidecar(options = {}) {
     port: address.port,
     token,
     url,
-    async close() {
-      await closeServer(server, clients, heartbeat);
+    close() {
+      if (!closePromise) {
+        acceptingIngestion = false;
+        closePromise = closeServer(server, {
+          clients,
+          heartbeat,
+          ingestionRequests
+        });
+      }
+      return closePromise;
     }
   };
 }
-async function closeServer(server, clients, heartbeat) {
-  if (heartbeat) {
-    clearInterval(heartbeat);
+async function closeServer(server, resources) {
+  if (resources.heartbeat) {
+    clearInterval(resources.heartbeat);
   }
-  for (const client of clients) {
+  for (const client of resources.clients) {
     client.response.end();
   }
-  clients.clear();
-  await new Promise((resolve, reject) => {
+  resources.clients.clear();
+  const serverClosed = new Promise((resolve, reject) => {
     server.close(error => {
       if (error) {
         reject(error);
@@ -418,4 +506,8 @@ async function closeServer(server, clients, heartbeat) {
       resolve();
     });
   });
+  for (const request of resources.ingestionRequests) {
+    request.socket.destroy();
+  }
+  await serverClosed;
 }

package/dist/transforms/nestjs-migrate.d.ts

@@ -6,10 +6,11 @@ export declare const MIGRATION_TRANSFORMS: readonly ["imports", "injectable", "s
  * Defines the migration transform kind type.
  */
 export type MigrationTransformKind = typeof MIGRATION_TRANSFORMS[number];
+type BootstrapPlatform = 'express';
 /**
  * Provides the warning categories value.
  */
-export declare const WARNING_CATEGORIES: readonly ["inject-token", "request-dto", "pipe-converter", "bootstrap-unsupported", "testing-unsupported", "import-unsupported", "injectable-options", "tsconfig-parse", "bootstrap-port"];
+export declare const WARNING_CATEGORIES: readonly ["inject-token", "inject-token-unsupported", "request-dto", "pipe-converter", "bootstrap-unsupported", "testing-unsupported", "import-unsupported", "injectable-options", "tsconfig-parse", "bootstrap-port"];
 /**
  * Defines the warning category type.
  */
@@ -61,6 +62,7 @@ export type MigrationReport = {
  */
 export type RunNestJsMigrationOptions = {
     apply: boolean;
+    bootstrapPlatform?: BootstrapPlatform;
     enabledTransforms: ReadonlySet<MigrationTransformKind>;
     targetPath: string;
 };
@@ -78,4 +80,5 @@ export declare function runNestJsMigration(options: RunNestJsMigrationOptions):
  * @returns The render transform list result.
  */
 export declare function renderTransformList(kinds: readonly MigrationTransformKind[]): string;
+export {};
 //# sourceMappingURL=nestjs-migrate.d.ts.map

package/dist/transforms/nestjs-migrate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nestjs-migrate.d.ts","sourceRoot":"","sources":["../../src/transforms/nestjs-migrate.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,eAAO,MAAM,oBAAoB,iFAAkF,CAAC;AAEpH;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAOzE;;GAEG;AACH,eAAO,MAAM,kBAAkB,4LAUrB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAcF;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,GAAG,CAAC,eAAe,EAAE,gBAAgB,EAAE,CAAC,CAS9G;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,iBAAiB,EAAE,sBAAsB,EAAE,CAAC;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,mBAAmB,EAAE,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,iBAAiB,EAAE,WAAW,CAAC,sBAAsB,CAAC,CAAC;IACvD,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AA6kCF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,eAAe,CAqDtF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,sBAAsB,EAAE,GAAG,MAAM,CAEpF"}
+{"version":3,"file":"nestjs-migrate.d.ts","sourceRoot":"","sources":["../../src/transforms/nestjs-migrate.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,eAAO,MAAM,oBAAoB,iFAAkF,CAAC;AAEpH;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAEzE,KAAK,iBAAiB,GAAG,SAAS,CAAC;AAQnC;;GAEG;AACH,eAAO,MAAM,kBAAkB,wNAWrB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAeF;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,GAAG,CAAC,eAAe,EAAE,gBAAgB,EAAE,CAAC,CAS9G;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,iBAAiB,EAAE,sBAAsB,EAAE,CAAC;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,mBAAmB,EAAE,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,iBAAiB,EAAE,WAAW,CAAC,sBAAsB,CAAC,CAAC;IACvD,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAs4DF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,eAAe,CAqDtF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,sBAAsB,EAAE,GAAG,MAAM,CAEpF"}