@fluojs/cli 2.0.1 → 3.0.0

package/dist/new/templates/react-vite-ssr/src/main.ts.ejs

@@ -0,0 +1,18 @@
+import { createFastifyAdapter } from '@fluojs/platform-fastify';
+import { FluoFactory } from '@fluojs/runtime';
+
+import { createAppModule } from './app';
+import { createReactPageRenderer } from './entry-server';
+import { loadReactViteManifest } from './load-manifest';
+
+const manifest = await loadReactViteManifest(new URL('../client/.vite/manifest.json', import.meta.url));
+const AppModule = createAppModule({
+  clientDirectory: new URL('../client/', import.meta.url),
+  renderPage: createReactPageRenderer(manifest),
+});
+const port = Number(process.env.PORT ?? '3000');
+const app = await FluoFactory.create(AppModule, {
+  adapter: createFastifyAdapter({ host: '127.0.0.1', port }),
+});
+
+await app.listen();

package/dist/new/templates/react-vite-ssr/src/page.tsx.ejs

@@ -0,0 +1,43 @@
+import {
+  Link,
+  useParams,
+  useRouter,
+  useSearchParams,
+} from '@fluojs/react/client';
+import { type ReactElement, useId, useState } from 'react';
+
+export function HydratedCounter(): ReactElement {
+  const [count, setCount] = useState(0);
+  return <button onClick={() => setCount((value) => value + 1)} type='button'>Count: {count}</button>;
+}
+
+function ProductNavigation(): ReactElement {
+  const router = useRouter();
+
+  return (
+    <nav aria-label='Product navigation'>
+      <Link href='/products/sku-84?preview=false'>Open sku-84</Link>
+      <button onClick={() => router.push('/products/sku-126?preview=true')} type='button'>
+        Push sku-126
+      </button>
+    </nav>
+  );
+}
+
+export function ProductPage(): ReactElement {
+  const identifier = useId();
+  const params = useParams();
+  const searchParams = useSearchParams();
+  const sku = params['sku'] ?? 'unknown';
+  const preview = searchParams.get('preview') === 'true';
+
+  return (
+    <main>
+      <h1>{`Catalog item ${sku}`}</h1>
+      <p>{preview ? 'Preview mode' : 'Published mode'}</p>
+      <p data-react-identifier id={identifier}>Shared hydration identifier</p>
+      <HydratedCounter />
+      <ProductNavigation />
+    </main>
+  );
+}

package/dist/new/templates/react-vite-ssr/src/react-app.test.tsx.ejs

@@ -0,0 +1,67 @@
+// @vitest-environment happy-dom
+
+import { ReactClientRouterProvider, createReactRouteSnapshot } from '@fluojs/react/client';
+import { hydrateRoot } from 'react-dom/client';
+import { renderToString } from 'react-dom/server';
+import { afterEach, describe, expect, it, vi } from 'vitest';
+
+import { HydratedCounter, ProductPage } from './page';
+import { ReactAppDocument, reportReactHydrationMismatch } from './react-app';
+
+describe('React Vite SSR app composition', () => {
+  afterEach(() => {
+    document.body.replaceChildren();
+    vi.restoreAllMocks();
+  });
+
+  it('renders the HTTP-owned route snapshot through the shared document', () => {
+    const html = renderToString(
+      <ReactAppDocument
+        page={<ProductPage />}
+        route={{ params: { sku: 'sku-42' }, url: '/products/sku-42?preview=true' }}
+        stylesheets={['/assets/styles.css']}
+      />,
+    );
+
+    expect(html).toContain('Catalog item sku-42');
+    expect(html).toContain('Preview mode');
+    expect(html).toContain('href="/assets/styles.css"');
+    expect(html).toContain('data-route-sku="sku-42"');
+  });
+
+  it('reports actionable application files when hydration mismatches', () => {
+    const consoleError = vi.spyOn(console, 'error').mockImplementation(() => undefined);
+    const mismatch = new Error('Hydration mismatch');
+
+    reportReactHydrationMismatch(mismatch);
+
+    expect(consoleError).toHaveBeenCalledWith(expect.stringContaining('src/entry-client.tsx'), mismatch);
+    expect(consoleError).toHaveBeenCalledWith(expect.stringContaining('src/entry-server.tsx'), mismatch);
+    expect(consoleError).toHaveBeenCalledWith(expect.stringContaining('src/react-app.tsx'), mismatch);
+    expect(consoleError).toHaveBeenCalledWith(expect.stringContaining('vite.client.config.ts'), mismatch);
+    expect(consoleError).toHaveBeenCalledWith(expect.stringContaining('generated build script'), mismatch);
+  });
+
+  it('attaches interaction without hydration warnings', async () => {
+    const consoleError = vi.spyOn(console, 'error').mockImplementation(() => undefined);
+    const container = document.createElement('div');
+    const initialSnapshot = createReactRouteSnapshot({ url: '/products/sku-42' });
+    const counter = (
+      <ReactClientRouterProvider initialSnapshot={initialSnapshot}>
+        <HydratedCounter />
+      </ReactClientRouterProvider>
+    );
+    container.innerHTML = renderToString(counter);
+    document.body.append(container);
+
+    const root = hydrateRoot(container, counter);
+    await new Promise<void>((resolve) => queueMicrotask(resolve));
+    const button = document.querySelector('button');
+    button?.click();
+    await new Promise<void>((resolve) => queueMicrotask(resolve));
+
+    expect(button?.textContent).toBe('Count: 1');
+    expect(consoleError).not.toHaveBeenCalled();
+    root.unmount();
+  });
+});

package/dist/new/templates/react-vite-ssr/src/react-app.tsx.ejs

@@ -0,0 +1,46 @@
+import {
+  ReactClientRouterProvider,
+  createReactRouteSnapshot,
+  type ReactRouteSnapshotInput,
+} from '@fluojs/react/client';
+import type { ReactElement } from 'react';
+
+export const REACT_IDENTIFIER_PREFIX = 'fluo-react-vite-' as const;
+
+export type ReactAppDocumentProps = {
+  readonly page: ReactElement;
+  readonly route: ReactRouteSnapshotInput;
+  readonly stylesheets: readonly string[];
+};
+
+export function reportReactHydrationMismatch(error: unknown): void {
+  console.error(
+    'React hydration did not match. Compare src/entry-client.tsx, src/entry-server.tsx, and src/react-app.tsx; check vite.client.config.ts, then run the generated build script again.',
+    error,
+  );
+}
+
+export function ReactAppDocument({
+  page,
+  route,
+  stylesheets,
+}: ReactAppDocumentProps): ReactElement {
+  const initialSnapshot = createReactRouteSnapshot(route);
+
+  return (
+    <ReactClientRouterProvider initialSnapshot={initialSnapshot}>
+      <html data-route-sku={initialSnapshot.params['sku'] ?? ''} lang='en'>
+        <head>
+          <meta charSet='utf-8' />
+          <meta content='width=device-width, initial-scale=1' name='viewport' />
+          <link href='data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg"/>' rel='icon' />
+          <title>Fluo React starter</title>
+          {stylesheets.map((href) => (
+            <link data-vite-style href={href} key={href} rel='stylesheet' />
+          ))}
+        </head>
+        <body>{page}</body>
+      </html>
+    </ReactClientRouterProvider>
+  );
+}

package/dist/new/templates/react-vite-ssr/src/styles.css.ejs

@@ -0,0 +1,25 @@
+:root {
+  color: #172033;
+  font-family: system-ui, sans-serif;
+}
+
+body {
+  margin: 0;
+}
+
+main {
+  margin: 0 auto;
+  max-width: 48rem;
+  padding: 4rem 1.5rem;
+}
+
+nav {
+  display: grid;
+  gap: 0.75rem;
+  margin-top: 2rem;
+}
+
+button,
+a {
+  font: inherit;
+}

package/dist/new/templates/react-vite-ssr/src/styles.d.ts.ejs

@@ -0,0 +1 @@
+declare module '*.css';

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,6 +52,7 @@ export interface BootstrapAnswers extends BootstrapSchema {
     installDependencies: boolean;
     packageManager: PackageManager;
     projectName: string;
+    starter: BootstrapStarter;
     targetDirectory: string;
 }
 /** Programmatic overrides for `runNewCommand(...)`. */

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,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,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-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;AA4UD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC,CAyLnG"}
+{"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

@@ -296,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 => {
@@ -385,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) : {};
@@ -411,6 +418,8 @@ export async function startStudioSidecar(options = {}) {
         writeJson(response, 400, {
           error: error instanceof Error ? error.message : String(error)
         });
+      } finally {
+        ingestionRequests.delete(request);
       }
       return;
     }
@@ -427,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)}`;
@@ -444,6 +457,7 @@ export async function startStudioSidecar(options = {}) {
     });
   }, options.heartbeatMs ?? DEFAULT_HEARTBEAT_MS);
   heartbeat?.unref();
+  let closePromise;
   return {
     appId,
     get epoch() {
@@ -462,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);
@@ -484,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"}