@dudousxd/nestjs-inertia-vite 1.4.3 → 1.5.1

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog — @dudousxd/nestjs-inertia-vite
 
+## 1.5.1
+
+### Patch Changes
+
+- [#37](https://github.com/DavideCarvalho/nestjs-inertia/pull/37) [`605c1f7`](https://github.com/DavideCarvalho/nestjs-inertia/commit/605c1f78189664556001e3504614cebd9327e107) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - Ship TanStack Intent agent skills (SKILL.md) inside the package.
+
+## 1.5.0
+
+### Minor Changes
+
+- [#29](https://github.com/DavideCarvalho/nestjs-inertia/pull/29) [`7def22b`](https://github.com/DavideCarvalho/nestjs-inertia/commit/7def22b2df24a472f0e0bcef457aa3b1e60f9fe9) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - A broad set of ecosystem improvements across the server adapter, typed client, codegen, testing, and Vite packages.
+
+  **Server (`@dudousxd/nestjs-inertia`)**
+
+  - General flash messages: the flash store now carries arbitrary flash payloads (success, info, warning, etc.) instead of being limited to errors.
+  - Stable asset-version fallback: the asset-version provider derives a deterministic fallback version so SSR/CSR markup stays consistent when no explicit version is configured.
+  - `matchOn: string | string[]`: partial-reload / scope matching accepts either a single key or an array of keys.
+  - `lazy()` deprecation: deprecated usages now emit a warning through the Nest `Logger` to guide migration.
+  - SSR streaming: streaming SSR render is supported on both the Express and Fastify adapters, with a retryable SSR loader that falls back to buffered SSR when streaming setup fails.
+  - Packaging hygiene: dual ESM/CJS `exports` maps and build config cleaned up across the package set.
+
+  **Client (`@dudousxd/nestjs-inertia-client`)**
+
+  - Typed `useForm` end-to-end for React, Vue, and Svelte.
+  - Typed `<Deferred>` / `<WhenVisible>` components with shared deferred types across frameworks.
+  - Native `router.poll` and prefetch helpers (typed poll + prefetch-route utilities).
+
+  **Codegen, testing, and Vite**
+
+  - Codegen extension, testing helpers (Jest + Vitest), and the Vite plugin updated to support the new typed client surface and packaging conventions.
+
 ## 1.4.3
 
 ### Patch Changes

package/dist/index.cjs

@@ -181,7 +181,7 @@ function nestInertia(options = {}) {
 __name(nestInertia, "nestInertia");
 
 // src/index.ts
-var VERSION = "1.4.3";
+var VERSION = "1.5.1";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   InvalidViteConfigException,

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/setup.ts","../src/plugin/plugin.ts"],"sourcesContent":["export const VERSION = '1.4.3';\nexport { setupInertiaVite } from './setup.js';\nexport type { SetupInertiaViteOptions } from './setup.js';\nexport { default as nestInertia } from './plugin/plugin.js';\nexport type { NestInertiaPluginOptions } from './plugin/plugin.js';\nexport { InvalidViteConfigException } from './plugin/plugin.js';\n","import { resolve } from 'node:path';\n\nexport interface SetupInertiaViteOptions {\n  mode: string | undefined;\n  root: string;\n  publicDir: string;\n  outDir: string;\n  hmrPort?: number;\n  configFile?: string;\n}\n\ntype NestApp = {\n  use: (pathOrMiddleware: unknown, middleware?: unknown) => void;\n};\n\nexport async function setupInertiaVite(\n  app: NestApp,\n  options: SetupInertiaViteOptions,\n): Promise<void> {\n  if (options.mode !== 'production') {\n    const { createServer: createViteServer } = await import('vite');\n    const vite = await createViteServer({\n      configFile: options.configFile ?? resolve(process.cwd(), 'vite.config.ts'),\n      root: options.root,\n      server: {\n        middlewareMode: true,\n        hmr: { port: options.hmrPort ?? 24679 },\n      },\n      appType: 'custom',\n    });\n    app.use((vite as { middlewares: unknown }).middlewares);\n    return;\n  }\n\n  // Production: serve dist/<outDir>/client\n  const express = await import('express');\n  const clientDir = resolve(process.cwd(), options.outDir, 'client');\n  app.use(\n    '/assets',\n    (express.default ?? express).static(resolve(clientDir, 'assets'), {\n      maxAge: '1y',\n      immutable: true,\n    }),\n  );\n  app.use(\n    (express.default ?? express).static(clientDir, {\n      maxAge: '1h',\n      index: false,\n      fallthrough: true,\n    }),\n  );\n}\n","import { createRequire } from 'node:module';\nimport { resolve } from 'node:path';\nimport type { Plugin, UserConfig } from 'vite';\n\nconst require = createRequire(import.meta.url);\n\nexport interface NestInertiaPluginOptions {\n  ssr?: boolean;\n  react?: boolean;\n  vue?: boolean;\n  svelte?: boolean;\n  /**\n   * When `true`, the nestInertia plugin will skip auto-loading the framework\n   * Vite plugin. Use this when the framework plugin (e.g. @sveltejs/vite-plugin-svelte)\n   * needs to be added manually in the vite config alongside nestInertia().\n   *\n   * @default false\n   */\n  skipFrameworkPlugin?: boolean;\n  clientEntry?: string;\n  ssrEntry?: string;\n  alias?: Record<string, string>;\n  root?: string;\n  entry?: string;\n}\n\nexport class InvalidViteConfigException extends Error {\n  constructor(message: string) {\n    super(`[nestjs-inertia-vite] ${message}`);\n    this.name = 'InvalidViteConfigException';\n  }\n}\n\nfunction loadFrameworkPlugin(framework: 'react' | 'vue' | 'svelte'): Plugin {\n  const pkg =\n    framework === 'react'\n      ? '@vitejs/plugin-react'\n      : framework === 'vue'\n        ? '@vitejs/plugin-vue'\n        : '@sveltejs/vite-plugin-svelte';\n  try {\n    const mod = require(pkg) as { default?: () => Plugin; svelte?: () => Plugin };\n    // @sveltejs/vite-plugin-svelte v3+ exports a named `svelte` export rather than default\n    const factory =\n      mod.default ??\n      (framework === 'svelte' ? mod.svelte : undefined) ??\n      (mod as unknown as () => Plugin);\n    return (factory as () => Plugin)();\n  } catch {\n    throw new InvalidViteConfigException(`Plugin \"${pkg}\" not installed. Run: pnpm add ${pkg}`);\n  }\n}\n\nexport default function nestInertia(options: NestInertiaPluginOptions = {}): Plugin[] {\n  const frameworkFlags = [options.react, options.vue, options.svelte].filter(Boolean);\n  if (frameworkFlags.length !== 1) {\n    throw new InvalidViteConfigException(\n      'nestInertia requires exactly one framework flag: react, vue, or svelte',\n    );\n  }\n\n  const defaultRoot = 'inertia';\n  const alias = {\n    '@': resolve(process.cwd(), options.root ?? defaultRoot),\n    ...(options.alias ?? {}),\n  };\n\n  const configurer: Plugin = {\n    name: 'nestjs-inertia',\n    config: (userConfig: UserConfig): Omit<UserConfig, 'plugins'> => {\n      const resolvedRoot = options.root ?? defaultRoot;\n      const defaultEntry = options.entry ?? options.clientEntry ?? `${resolvedRoot}/app/client.tsx`;\n\n      const buildConfig: NonNullable<UserConfig['build']> = {\n        manifest: true,\n        rollupOptions: {},\n      };\n\n      // Only set outDir if the user hasn't already defined it\n      if (!userConfig.build?.outDir) {\n        buildConfig.outDir = 'dist/inertia/client';\n      }\n\n      // Only set rollupOptions.input if the user hasn't already defined it\n      if (!userConfig.build?.rollupOptions?.input) {\n        buildConfig.rollupOptions = {\n          input: resolve(process.cwd(), defaultEntry),\n        };\n      }\n\n      const result: Omit<UserConfig, 'plugins'> = {\n        build: buildConfig,\n        resolve: { alias },\n        server: {\n          middlewareMode: true,\n          hmr: { port: 24679 },\n        },\n      };\n\n      // Only set root if the user hasn't already defined it in their vite config\n      if (!userConfig.root) {\n        result.root = resolve(process.cwd(), resolvedRoot);\n      }\n\n      return result;\n    },\n  };\n\n  const codegenHmr: Plugin = {\n    name: 'nestjs-inertia:codegen-hmr',\n    configureServer(server) {\n      const codegenDir = resolve(process.cwd(), '.nestjs-inertia');\n      const { watcher } = server;\n      watcher.add(codegenDir);\n      watcher.on('change', (file) => {\n        if (!file.startsWith(codegenDir)) return;\n        const mods = server.moduleGraph.getModulesByFile(file);\n        if (mods) {\n          for (const mod of mods) {\n            server.moduleGraph.invalidateModule(mod);\n          }\n        }\n        server.ws.send({ type: 'full-reload' });\n      });\n    },\n  };\n\n  if (options.skipFrameworkPlugin) {\n    return [configurer, codegenHmr];\n  }\n\n  const frameworkPlugin = options.react\n    ? loadFrameworkPlugin('react')\n    : options.vue\n      ? loadFrameworkPlugin('vue')\n      : loadFrameworkPlugin('svelte');\n\n  return [configurer, frameworkPlugin, codegenHmr];\n}\n"],"mappings":"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","names":["setupInertiaVite","app","options","mode","createServer","createViteServer","vite","configFile","resolve","process","cwd","root","server","middlewareMode","hmr","port","hmrPort","appType","use","middlewares","express","clientDir","outDir","default","static","maxAge","immutable","index","fallthrough","import_node_path","require","createRequire","InvalidViteConfigException","Error","message","name","loadFrameworkPlugin","framework","pkg","mod","factory","default","svelte","undefined","options","frameworkFlags","react","vue","filter","Boolean","length","defaultRoot","alias","resolve","process","cwd","root","configurer","config","userConfig","resolvedRoot","defaultEntry","entry","clientEntry","buildConfig","manifest","rollupOptions","build","outDir","input","result","server","middlewareMode","hmr","port","codegenHmr","configureServer","codegenDir","watcher","add","on","file","startsWith","mods","moduleGraph","getModulesByFile","invalidateModule","ws","send","type","skipFrameworkPlugin","frameworkPlugin","nestInertia","VERSION"]}
+{"version":3,"sources":["../src/index.ts","../src/setup.ts","../src/plugin/plugin.ts"],"sourcesContent":["export const VERSION = '1.5.1';\nexport { setupInertiaVite } from './setup.js';\nexport type { SetupInertiaViteOptions } from './setup.js';\nexport { default as nestInertia } from './plugin/plugin.js';\nexport type { NestInertiaPluginOptions } from './plugin/plugin.js';\nexport { InvalidViteConfigException } from './plugin/plugin.js';\n","import { resolve } from 'node:path';\n\nexport interface SetupInertiaViteOptions {\n  mode: string | undefined;\n  root: string;\n  publicDir: string;\n  outDir: string;\n  hmrPort?: number;\n  configFile?: string;\n}\n\ntype NestApp = {\n  use: (pathOrMiddleware: unknown, middleware?: unknown) => void;\n};\n\nexport async function setupInertiaVite(\n  app: NestApp,\n  options: SetupInertiaViteOptions,\n): Promise<void> {\n  if (options.mode !== 'production') {\n    const { createServer: createViteServer } = await import('vite');\n    const vite = await createViteServer({\n      configFile: options.configFile ?? resolve(process.cwd(), 'vite.config.ts'),\n      root: options.root,\n      server: {\n        middlewareMode: true,\n        hmr: { port: options.hmrPort ?? 24679 },\n      },\n      appType: 'custom',\n    });\n    app.use((vite as { middlewares: unknown }).middlewares);\n    return;\n  }\n\n  // Production: serve dist/<outDir>/client\n  const express = await import('express');\n  const clientDir = resolve(process.cwd(), options.outDir, 'client');\n  app.use(\n    '/assets',\n    (express.default ?? express).static(resolve(clientDir, 'assets'), {\n      maxAge: '1y',\n      immutable: true,\n    }),\n  );\n  app.use(\n    (express.default ?? express).static(clientDir, {\n      maxAge: '1h',\n      index: false,\n      fallthrough: true,\n    }),\n  );\n}\n","import { createRequire } from 'node:module';\nimport { resolve } from 'node:path';\nimport type { Plugin, UserConfig } from 'vite';\n\nconst require = createRequire(import.meta.url);\n\nexport interface NestInertiaPluginOptions {\n  ssr?: boolean;\n  react?: boolean;\n  vue?: boolean;\n  svelte?: boolean;\n  /**\n   * When `true`, the nestInertia plugin will skip auto-loading the framework\n   * Vite plugin. Use this when the framework plugin (e.g. @sveltejs/vite-plugin-svelte)\n   * needs to be added manually in the vite config alongside nestInertia().\n   *\n   * @default false\n   */\n  skipFrameworkPlugin?: boolean;\n  clientEntry?: string;\n  ssrEntry?: string;\n  alias?: Record<string, string>;\n  root?: string;\n  entry?: string;\n}\n\nexport class InvalidViteConfigException extends Error {\n  constructor(message: string) {\n    super(`[nestjs-inertia-vite] ${message}`);\n    this.name = 'InvalidViteConfigException';\n  }\n}\n\nfunction loadFrameworkPlugin(framework: 'react' | 'vue' | 'svelte'): Plugin {\n  const pkg =\n    framework === 'react'\n      ? '@vitejs/plugin-react'\n      : framework === 'vue'\n        ? '@vitejs/plugin-vue'\n        : '@sveltejs/vite-plugin-svelte';\n  try {\n    const mod = require(pkg) as { default?: () => Plugin; svelte?: () => Plugin };\n    // @sveltejs/vite-plugin-svelte v3+ exports a named `svelte` export rather than default\n    const factory =\n      mod.default ??\n      (framework === 'svelte' ? mod.svelte : undefined) ??\n      (mod as unknown as () => Plugin);\n    return (factory as () => Plugin)();\n  } catch {\n    throw new InvalidViteConfigException(`Plugin \"${pkg}\" not installed. Run: pnpm add ${pkg}`);\n  }\n}\n\nexport default function nestInertia(options: NestInertiaPluginOptions = {}): Plugin[] {\n  const frameworkFlags = [options.react, options.vue, options.svelte].filter(Boolean);\n  if (frameworkFlags.length !== 1) {\n    throw new InvalidViteConfigException(\n      'nestInertia requires exactly one framework flag: react, vue, or svelte',\n    );\n  }\n\n  const defaultRoot = 'inertia';\n  const alias = {\n    '@': resolve(process.cwd(), options.root ?? defaultRoot),\n    ...(options.alias ?? {}),\n  };\n\n  const configurer: Plugin = {\n    name: 'nestjs-inertia',\n    config: (userConfig: UserConfig): Omit<UserConfig, 'plugins'> => {\n      const resolvedRoot = options.root ?? defaultRoot;\n      const defaultEntry = options.entry ?? options.clientEntry ?? `${resolvedRoot}/app/client.tsx`;\n\n      const buildConfig: NonNullable<UserConfig['build']> = {\n        manifest: true,\n        rollupOptions: {},\n      };\n\n      // Only set outDir if the user hasn't already defined it\n      if (!userConfig.build?.outDir) {\n        buildConfig.outDir = 'dist/inertia/client';\n      }\n\n      // Only set rollupOptions.input if the user hasn't already defined it\n      if (!userConfig.build?.rollupOptions?.input) {\n        buildConfig.rollupOptions = {\n          input: resolve(process.cwd(), defaultEntry),\n        };\n      }\n\n      const result: Omit<UserConfig, 'plugins'> = {\n        build: buildConfig,\n        resolve: { alias },\n        server: {\n          middlewareMode: true,\n          hmr: { port: 24679 },\n        },\n      };\n\n      // Only set root if the user hasn't already defined it in their vite config\n      if (!userConfig.root) {\n        result.root = resolve(process.cwd(), resolvedRoot);\n      }\n\n      return result;\n    },\n  };\n\n  const codegenHmr: Plugin = {\n    name: 'nestjs-inertia:codegen-hmr',\n    configureServer(server) {\n      const codegenDir = resolve(process.cwd(), '.nestjs-inertia');\n      const { watcher } = server;\n      watcher.add(codegenDir);\n      watcher.on('change', (file) => {\n        if (!file.startsWith(codegenDir)) return;\n        const mods = server.moduleGraph.getModulesByFile(file);\n        if (mods) {\n          for (const mod of mods) {\n            server.moduleGraph.invalidateModule(mod);\n          }\n        }\n        server.ws.send({ type: 'full-reload' });\n      });\n    },\n  };\n\n  if (options.skipFrameworkPlugin) {\n    return [configurer, codegenHmr];\n  }\n\n  const frameworkPlugin = options.react\n    ? loadFrameworkPlugin('react')\n    : options.vue\n      ? loadFrameworkPlugin('vue')\n      : loadFrameworkPlugin('svelte');\n\n  return [configurer, frameworkPlugin, codegenHmr];\n}\n"],"mappings":"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","names":["setupInertiaVite","app","options","mode","createServer","createViteServer","vite","configFile","resolve","process","cwd","root","server","middlewareMode","hmr","port","hmrPort","appType","use","middlewares","express","clientDir","outDir","default","static","maxAge","immutable","index","fallthrough","import_node_path","require","createRequire","InvalidViteConfigException","Error","message","name","loadFrameworkPlugin","framework","pkg","mod","factory","default","svelte","undefined","options","frameworkFlags","react","vue","filter","Boolean","length","defaultRoot","alias","resolve","process","cwd","root","configurer","config","userConfig","resolvedRoot","defaultEntry","entry","clientEntry","buildConfig","manifest","rollupOptions","build","outDir","input","result","server","middlewareMode","hmr","port","codegenHmr","configureServer","codegenDir","watcher","add","on","file","startsWith","mods","moduleGraph","getModulesByFile","invalidateModule","ws","send","type","skipFrameworkPlugin","frameworkPlugin","nestInertia","VERSION"]}

package/dist/index.d.cts

@@ -0,0 +1,19 @@
+export { InvalidViteConfigException, NestInertiaPluginOptions, default as nestInertia } from './plugin/plugin.cjs';
+import 'vite';
+
+interface SetupInertiaViteOptions {
+    mode: string | undefined;
+    root: string;
+    publicDir: string;
+    outDir: string;
+    hmrPort?: number;
+    configFile?: string;
+}
+type NestApp = {
+    use: (pathOrMiddleware: unknown, middleware?: unknown) => void;
+};
+declare function setupInertiaVite(app: NestApp, options: SetupInertiaViteOptions): Promise<void>;
+
+declare const VERSION = "1.5.1";
+
+export { type SetupInertiaViteOptions, VERSION, setupInertiaVite };

package/dist/index.d.ts

@@ -14,6 +14,6 @@ type NestApp = {
 };
 declare function setupInertiaVite(app: NestApp, options: SetupInertiaViteOptions): Promise<void>;
 
-declare const VERSION = "1.4.3";
+declare const VERSION = "1.5.1";
 
 export { type SetupInertiaViteOptions, VERSION, setupInertiaVite };

package/dist/index.js

@@ -143,7 +143,7 @@ function nestInertia(options = {}) {
 __name(nestInertia, "nestInertia");
 
 // src/index.ts
-var VERSION = "1.4.3";
+var VERSION = "1.5.1";
 export {
   InvalidViteConfigException,
   VERSION,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/setup.ts","../src/plugin/plugin.ts","../src/index.ts"],"sourcesContent":["import { resolve } from 'node:path';\n\nexport interface SetupInertiaViteOptions {\n  mode: string | undefined;\n  root: string;\n  publicDir: string;\n  outDir: string;\n  hmrPort?: number;\n  configFile?: string;\n}\n\ntype NestApp = {\n  use: (pathOrMiddleware: unknown, middleware?: unknown) => void;\n};\n\nexport async function setupInertiaVite(\n  app: NestApp,\n  options: SetupInertiaViteOptions,\n): Promise<void> {\n  if (options.mode !== 'production') {\n    const { createServer: createViteServer } = await import('vite');\n    const vite = await createViteServer({\n      configFile: options.configFile ?? resolve(process.cwd(), 'vite.config.ts'),\n      root: options.root,\n      server: {\n        middlewareMode: true,\n        hmr: { port: options.hmrPort ?? 24679 },\n      },\n      appType: 'custom',\n    });\n    app.use((vite as { middlewares: unknown }).middlewares);\n    return;\n  }\n\n  // Production: serve dist/<outDir>/client\n  const express = await import('express');\n  const clientDir = resolve(process.cwd(), options.outDir, 'client');\n  app.use(\n    '/assets',\n    (express.default ?? express).static(resolve(clientDir, 'assets'), {\n      maxAge: '1y',\n      immutable: true,\n    }),\n  );\n  app.use(\n    (express.default ?? express).static(clientDir, {\n      maxAge: '1h',\n      index: false,\n      fallthrough: true,\n    }),\n  );\n}\n","import { createRequire } from 'node:module';\nimport { resolve } from 'node:path';\nimport type { Plugin, UserConfig } from 'vite';\n\nconst require = createRequire(import.meta.url);\n\nexport interface NestInertiaPluginOptions {\n  ssr?: boolean;\n  react?: boolean;\n  vue?: boolean;\n  svelte?: boolean;\n  /**\n   * When `true`, the nestInertia plugin will skip auto-loading the framework\n   * Vite plugin. Use this when the framework plugin (e.g. @sveltejs/vite-plugin-svelte)\n   * needs to be added manually in the vite config alongside nestInertia().\n   *\n   * @default false\n   */\n  skipFrameworkPlugin?: boolean;\n  clientEntry?: string;\n  ssrEntry?: string;\n  alias?: Record<string, string>;\n  root?: string;\n  entry?: string;\n}\n\nexport class InvalidViteConfigException extends Error {\n  constructor(message: string) {\n    super(`[nestjs-inertia-vite] ${message}`);\n    this.name = 'InvalidViteConfigException';\n  }\n}\n\nfunction loadFrameworkPlugin(framework: 'react' | 'vue' | 'svelte'): Plugin {\n  const pkg =\n    framework === 'react'\n      ? '@vitejs/plugin-react'\n      : framework === 'vue'\n        ? '@vitejs/plugin-vue'\n        : '@sveltejs/vite-plugin-svelte';\n  try {\n    const mod = require(pkg) as { default?: () => Plugin; svelte?: () => Plugin };\n    // @sveltejs/vite-plugin-svelte v3+ exports a named `svelte` export rather than default\n    const factory =\n      mod.default ??\n      (framework === 'svelte' ? mod.svelte : undefined) ??\n      (mod as unknown as () => Plugin);\n    return (factory as () => Plugin)();\n  } catch {\n    throw new InvalidViteConfigException(`Plugin \"${pkg}\" not installed. Run: pnpm add ${pkg}`);\n  }\n}\n\nexport default function nestInertia(options: NestInertiaPluginOptions = {}): Plugin[] {\n  const frameworkFlags = [options.react, options.vue, options.svelte].filter(Boolean);\n  if (frameworkFlags.length !== 1) {\n    throw new InvalidViteConfigException(\n      'nestInertia requires exactly one framework flag: react, vue, or svelte',\n    );\n  }\n\n  const defaultRoot = 'inertia';\n  const alias = {\n    '@': resolve(process.cwd(), options.root ?? defaultRoot),\n    ...(options.alias ?? {}),\n  };\n\n  const configurer: Plugin = {\n    name: 'nestjs-inertia',\n    config: (userConfig: UserConfig): Omit<UserConfig, 'plugins'> => {\n      const resolvedRoot = options.root ?? defaultRoot;\n      const defaultEntry = options.entry ?? options.clientEntry ?? `${resolvedRoot}/app/client.tsx`;\n\n      const buildConfig: NonNullable<UserConfig['build']> = {\n        manifest: true,\n        rollupOptions: {},\n      };\n\n      // Only set outDir if the user hasn't already defined it\n      if (!userConfig.build?.outDir) {\n        buildConfig.outDir = 'dist/inertia/client';\n      }\n\n      // Only set rollupOptions.input if the user hasn't already defined it\n      if (!userConfig.build?.rollupOptions?.input) {\n        buildConfig.rollupOptions = {\n          input: resolve(process.cwd(), defaultEntry),\n        };\n      }\n\n      const result: Omit<UserConfig, 'plugins'> = {\n        build: buildConfig,\n        resolve: { alias },\n        server: {\n          middlewareMode: true,\n          hmr: { port: 24679 },\n        },\n      };\n\n      // Only set root if the user hasn't already defined it in their vite config\n      if (!userConfig.root) {\n        result.root = resolve(process.cwd(), resolvedRoot);\n      }\n\n      return result;\n    },\n  };\n\n  const codegenHmr: Plugin = {\n    name: 'nestjs-inertia:codegen-hmr',\n    configureServer(server) {\n      const codegenDir = resolve(process.cwd(), '.nestjs-inertia');\n      const { watcher } = server;\n      watcher.add(codegenDir);\n      watcher.on('change', (file) => {\n        if (!file.startsWith(codegenDir)) return;\n        const mods = server.moduleGraph.getModulesByFile(file);\n        if (mods) {\n          for (const mod of mods) {\n            server.moduleGraph.invalidateModule(mod);\n          }\n        }\n        server.ws.send({ type: 'full-reload' });\n      });\n    },\n  };\n\n  if (options.skipFrameworkPlugin) {\n    return [configurer, codegenHmr];\n  }\n\n  const frameworkPlugin = options.react\n    ? loadFrameworkPlugin('react')\n    : options.vue\n      ? loadFrameworkPlugin('vue')\n      : loadFrameworkPlugin('svelte');\n\n  return [configurer, frameworkPlugin, codegenHmr];\n}\n","export const VERSION = '1.4.3';\nexport { setupInertiaVite } from './setup.js';\nexport type { SetupInertiaViteOptions } from './setup.js';\nexport { default as nestInertia } from './plugin/plugin.js';\nexport type { NestInertiaPluginOptions } from './plugin/plugin.js';\nexport { InvalidViteConfigException } from './plugin/plugin.js';\n"],"mappings":"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","names":["resolve","setupInertiaVite","app","options","mode","createServer","createViteServer","vite","configFile","resolve","process","cwd","root","server","middlewareMode","hmr","port","hmrPort","appType","use","middlewares","express","clientDir","outDir","default","static","maxAge","immutable","index","fallthrough","createRequire","resolve","require","createRequire","url","InvalidViteConfigException","Error","message","name","loadFrameworkPlugin","framework","pkg","mod","factory","default","svelte","undefined","options","frameworkFlags","react","vue","filter","Boolean","length","defaultRoot","alias","resolve","process","cwd","root","configurer","config","userConfig","resolvedRoot","defaultEntry","entry","clientEntry","buildConfig","manifest","rollupOptions","build","outDir","input","result","server","middlewareMode","hmr","port","codegenHmr","configureServer","codegenDir","watcher","add","on","file","startsWith","mods","moduleGraph","getModulesByFile","invalidateModule","ws","send","type","skipFrameworkPlugin","frameworkPlugin","nestInertia","VERSION"]}
+{"version":3,"sources":["../src/setup.ts","../src/plugin/plugin.ts","../src/index.ts"],"sourcesContent":["import { resolve } from 'node:path';\n\nexport interface SetupInertiaViteOptions {\n  mode: string | undefined;\n  root: string;\n  publicDir: string;\n  outDir: string;\n  hmrPort?: number;\n  configFile?: string;\n}\n\ntype NestApp = {\n  use: (pathOrMiddleware: unknown, middleware?: unknown) => void;\n};\n\nexport async function setupInertiaVite(\n  app: NestApp,\n  options: SetupInertiaViteOptions,\n): Promise<void> {\n  if (options.mode !== 'production') {\n    const { createServer: createViteServer } = await import('vite');\n    const vite = await createViteServer({\n      configFile: options.configFile ?? resolve(process.cwd(), 'vite.config.ts'),\n      root: options.root,\n      server: {\n        middlewareMode: true,\n        hmr: { port: options.hmrPort ?? 24679 },\n      },\n      appType: 'custom',\n    });\n    app.use((vite as { middlewares: unknown }).middlewares);\n    return;\n  }\n\n  // Production: serve dist/<outDir>/client\n  const express = await import('express');\n  const clientDir = resolve(process.cwd(), options.outDir, 'client');\n  app.use(\n    '/assets',\n    (express.default ?? express).static(resolve(clientDir, 'assets'), {\n      maxAge: '1y',\n      immutable: true,\n    }),\n  );\n  app.use(\n    (express.default ?? express).static(clientDir, {\n      maxAge: '1h',\n      index: false,\n      fallthrough: true,\n    }),\n  );\n}\n","import { createRequire } from 'node:module';\nimport { resolve } from 'node:path';\nimport type { Plugin, UserConfig } from 'vite';\n\nconst require = createRequire(import.meta.url);\n\nexport interface NestInertiaPluginOptions {\n  ssr?: boolean;\n  react?: boolean;\n  vue?: boolean;\n  svelte?: boolean;\n  /**\n   * When `true`, the nestInertia plugin will skip auto-loading the framework\n   * Vite plugin. Use this when the framework plugin (e.g. @sveltejs/vite-plugin-svelte)\n   * needs to be added manually in the vite config alongside nestInertia().\n   *\n   * @default false\n   */\n  skipFrameworkPlugin?: boolean;\n  clientEntry?: string;\n  ssrEntry?: string;\n  alias?: Record<string, string>;\n  root?: string;\n  entry?: string;\n}\n\nexport class InvalidViteConfigException extends Error {\n  constructor(message: string) {\n    super(`[nestjs-inertia-vite] ${message}`);\n    this.name = 'InvalidViteConfigException';\n  }\n}\n\nfunction loadFrameworkPlugin(framework: 'react' | 'vue' | 'svelte'): Plugin {\n  const pkg =\n    framework === 'react'\n      ? '@vitejs/plugin-react'\n      : framework === 'vue'\n        ? '@vitejs/plugin-vue'\n        : '@sveltejs/vite-plugin-svelte';\n  try {\n    const mod = require(pkg) as { default?: () => Plugin; svelte?: () => Plugin };\n    // @sveltejs/vite-plugin-svelte v3+ exports a named `svelte` export rather than default\n    const factory =\n      mod.default ??\n      (framework === 'svelte' ? mod.svelte : undefined) ??\n      (mod as unknown as () => Plugin);\n    return (factory as () => Plugin)();\n  } catch {\n    throw new InvalidViteConfigException(`Plugin \"${pkg}\" not installed. Run: pnpm add ${pkg}`);\n  }\n}\n\nexport default function nestInertia(options: NestInertiaPluginOptions = {}): Plugin[] {\n  const frameworkFlags = [options.react, options.vue, options.svelte].filter(Boolean);\n  if (frameworkFlags.length !== 1) {\n    throw new InvalidViteConfigException(\n      'nestInertia requires exactly one framework flag: react, vue, or svelte',\n    );\n  }\n\n  const defaultRoot = 'inertia';\n  const alias = {\n    '@': resolve(process.cwd(), options.root ?? defaultRoot),\n    ...(options.alias ?? {}),\n  };\n\n  const configurer: Plugin = {\n    name: 'nestjs-inertia',\n    config: (userConfig: UserConfig): Omit<UserConfig, 'plugins'> => {\n      const resolvedRoot = options.root ?? defaultRoot;\n      const defaultEntry = options.entry ?? options.clientEntry ?? `${resolvedRoot}/app/client.tsx`;\n\n      const buildConfig: NonNullable<UserConfig['build']> = {\n        manifest: true,\n        rollupOptions: {},\n      };\n\n      // Only set outDir if the user hasn't already defined it\n      if (!userConfig.build?.outDir) {\n        buildConfig.outDir = 'dist/inertia/client';\n      }\n\n      // Only set rollupOptions.input if the user hasn't already defined it\n      if (!userConfig.build?.rollupOptions?.input) {\n        buildConfig.rollupOptions = {\n          input: resolve(process.cwd(), defaultEntry),\n        };\n      }\n\n      const result: Omit<UserConfig, 'plugins'> = {\n        build: buildConfig,\n        resolve: { alias },\n        server: {\n          middlewareMode: true,\n          hmr: { port: 24679 },\n        },\n      };\n\n      // Only set root if the user hasn't already defined it in their vite config\n      if (!userConfig.root) {\n        result.root = resolve(process.cwd(), resolvedRoot);\n      }\n\n      return result;\n    },\n  };\n\n  const codegenHmr: Plugin = {\n    name: 'nestjs-inertia:codegen-hmr',\n    configureServer(server) {\n      const codegenDir = resolve(process.cwd(), '.nestjs-inertia');\n      const { watcher } = server;\n      watcher.add(codegenDir);\n      watcher.on('change', (file) => {\n        if (!file.startsWith(codegenDir)) return;\n        const mods = server.moduleGraph.getModulesByFile(file);\n        if (mods) {\n          for (const mod of mods) {\n            server.moduleGraph.invalidateModule(mod);\n          }\n        }\n        server.ws.send({ type: 'full-reload' });\n      });\n    },\n  };\n\n  if (options.skipFrameworkPlugin) {\n    return [configurer, codegenHmr];\n  }\n\n  const frameworkPlugin = options.react\n    ? loadFrameworkPlugin('react')\n    : options.vue\n      ? loadFrameworkPlugin('vue')\n      : loadFrameworkPlugin('svelte');\n\n  return [configurer, frameworkPlugin, codegenHmr];\n}\n","export const VERSION = '1.5.1';\nexport { setupInertiaVite } from './setup.js';\nexport type { SetupInertiaViteOptions } from './setup.js';\nexport { default as nestInertia } from './plugin/plugin.js';\nexport type { NestInertiaPluginOptions } from './plugin/plugin.js';\nexport { InvalidViteConfigException } from './plugin/plugin.js';\n"],"mappings":"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","names":["resolve","setupInertiaVite","app","options","mode","createServer","createViteServer","vite","configFile","resolve","process","cwd","root","server","middlewareMode","hmr","port","hmrPort","appType","use","middlewares","express","clientDir","outDir","default","static","maxAge","immutable","index","fallthrough","createRequire","resolve","require","createRequire","url","InvalidViteConfigException","Error","message","name","loadFrameworkPlugin","framework","pkg","mod","factory","default","svelte","undefined","options","frameworkFlags","react","vue","filter","Boolean","length","defaultRoot","alias","resolve","process","cwd","root","configurer","config","userConfig","resolvedRoot","defaultEntry","entry","clientEntry","buildConfig","manifest","rollupOptions","build","outDir","input","result","server","middlewareMode","hmr","port","codegenHmr","configureServer","codegenDir","watcher","add","on","file","startsWith","mods","moduleGraph","getModulesByFile","invalidateModule","ws","send","type","skipFrameworkPlugin","frameworkPlugin","nestInertia","VERSION"]}

package/dist/plugin/plugin.d.cts

@@ -0,0 +1,27 @@
+import { Plugin } from 'vite';
+
+interface NestInertiaPluginOptions {
+    ssr?: boolean;
+    react?: boolean;
+    vue?: boolean;
+    svelte?: boolean;
+    /**
+     * When `true`, the nestInertia plugin will skip auto-loading the framework
+     * Vite plugin. Use this when the framework plugin (e.g. @sveltejs/vite-plugin-svelte)
+     * needs to be added manually in the vite config alongside nestInertia().
+     *
+     * @default false
+     */
+    skipFrameworkPlugin?: boolean;
+    clientEntry?: string;
+    ssrEntry?: string;
+    alias?: Record<string, string>;
+    root?: string;
+    entry?: string;
+}
+declare class InvalidViteConfigException extends Error {
+    constructor(message: string);
+}
+declare function nestInertia(options?: NestInertiaPluginOptions): Plugin[];
+
+export { InvalidViteConfigException, type NestInertiaPluginOptions, nestInertia as default };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dudousxd/nestjs-inertia-vite",
-  "version": "1.4.3",
+  "version": "1.5.1",
   "description": "Vite integration for @dudousxd/nestjs-inertia — dev middleware, prod static serving, plugin.",
   "license": "MIT",
   "repository": {
@@ -15,23 +15,35 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     },
     "./plugin": {
-      "types": "./dist/plugin/plugin.d.ts",
-      "import": "./dist/plugin/plugin.js",
-      "require": "./dist/plugin/plugin.cjs"
+      "import": {
+        "types": "./dist/plugin/plugin.d.ts",
+        "default": "./dist/plugin/plugin.js"
+      },
+      "require": {
+        "types": "./dist/plugin/plugin.d.cts",
+        "default": "./dist/plugin/plugin.cjs"
+      }
     }
   },
+  "sideEffects": false,
   "files": [
     "dist/",
     "README.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "skills"
   ],
   "peerDependencies": {
-    "@dudousxd/nestjs-inertia": ">=1.4.2",
+    "@dudousxd/nestjs-inertia": ">=1.4.5",
     "@nestjs/common": ">=10.0.0",
     "@nestjs/core": ">=10.0.0",
     "vite": ">=5.0.0",
@@ -58,13 +70,16 @@
     "@vitejs/plugin-react": "^4.3.0",
     "express": "^4.19.2",
     "typescript": "^5.4.0",
-    "vite": "^6.4.2",
-    "vitest": "^3.0.0",
-    "@dudousxd/nestjs-inertia": "1.4.2"
+    "vite": "^7.0.0",
+    "vitest": "^4.1.0",
+    "@dudousxd/nestjs-inertia": "1.8.1"
   },
   "engines": {
     "node": ">=20"
   },
+  "keywords": [
+    "tanstack-intent"
+  ],
   "scripts": {
     "build": "tsup",
     "test": "vitest run",

package/skills/inertia-vite-setup/SKILL.md

@@ -0,0 +1,155 @@
+---
+name: inertia-vite-setup
+description: >-
+  Vite dev/build glue for @dudousxd/nestjs-inertia-vite. Covers setupInertiaVite
+  (middleware-mode dev server + production static serving of dist/<outDir>/client)
+  and the nestInertia() Vite plugin (exactly one of react/vue/svelte flags,
+  manifest build, codegen HMR, root/entry/alias/outDir config, skipFrameworkPlugin),
+  plus InvalidViteConfigException. Use when wiring Vite HMR into a NestJS server,
+  configuring vite.config for an Inertia front end, or building client assets.
+license: MIT
+metadata:
+  type: core
+  library: "@dudousxd/nestjs-inertia-vite"
+  library_version: 1.5.0
+  framework: nestjs
+---
+
+# Inertia Vite setup
+
+`@dudousxd/nestjs-inertia-vite` has two halves: `setupInertiaVite(app, options)`
+runs inside your NestJS bootstrap to mount Vite in middleware mode (dev) or serve
+built assets (prod), and `nestInertia()` is the Vite plugin you add to
+`vite.config.ts` to build the Inertia client (and optionally SSR) bundle.
+
+## Setup
+
+```bash
+pnpm add -D @dudousxd/nestjs-inertia-vite vite
+pnpm add -D @vitejs/plugin-react        # or @vitejs/plugin-vue / @sveltejs/vite-plugin-svelte
+```
+
+Server bootstrap (Express, middleware mode in dev):
+
+```ts
+// main.ts
+import { NestFactory } from '@nestjs/core';
+import { setupInertiaVite } from '@dudousxd/nestjs-inertia-vite';
+import { AppModule } from './app.module';
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+  await setupInertiaVite(app, {
+    mode: process.env.NODE_ENV,
+    root: 'inertia',
+    publicDir: 'public',
+    outDir: 'dist/inertia',
+  });
+  await app.listen(3000);
+}
+bootstrap();
+```
+
+`vite.config.ts`:
+
+```ts
+import { defineConfig } from 'vite';
+import nestInertia from '@dudousxd/nestjs-inertia-vite';
+
+export default defineConfig({
+  plugins: [nestInertia({ react: true })],
+});
+```
+
+`Source: packages/vite/src/setup.ts, packages/vite/src/plugin/plugin.ts, packages/vite/src/index.ts`
+
+## Core patterns
+
+### 1. setupInertiaVite — dev vs prod branch
+
+When `options.mode !== 'production'`, it creates a Vite server in
+`middlewareMode` (HMR on port `hmrPort ?? 24679`) and mounts `vite.middlewares`.
+In production it serves `dist/<outDir>/client` statically — `/assets` with a
+1-year immutable cache, the rest with a 1-hour cache. The `mode` you pass is the
+ONLY switch between the two paths. `Source: packages/vite/src/setup.ts`
+
+### 2. nestInertia plugin — one framework, sensible defaults
+
+```ts
+nestInertia({
+  react: true,                 // exactly one of react | vue | svelte
+  root: 'inertia',             // alias '@' → <cwd>/inertia
+  entry: 'inertia/app/client.tsx',
+  ssr: true,
+});
+```
+
+The plugin returns an array: a config plugin (`manifest: true`, default
+`outDir: 'dist/inertia/client'`, rollup input from `entry`/`clientEntry`), the
+framework plugin (auto-loaded), and a codegen-HMR plugin that watches
+`.nestjs-inertia/` and triggers a full reload when generated files change. It
+only sets `root`/`outDir`/`input` when you have not already defined them.
+`Source: packages/vite/src/plugin/plugin.ts`
+
+### 3. Bringing your own framework plugin
+
+```ts
+import { svelte } from '@sveltejs/vite-plugin-svelte';
+
+export default defineConfig({
+  plugins: [nestInertia({ svelte: true, skipFrameworkPlugin: true }), svelte()],
+});
+```
+
+`skipFrameworkPlugin: true` makes `nestInertia` return only the configurer +
+codegen-HMR plugins, so you add the framework plugin yourself.
+`Source: packages/vite/src/plugin/plugin.ts (skipFrameworkPlugin branch)`
+
+## Common mistakes
+
+### Mistake 1: passing zero or multiple framework flags
+
+```ts
+// Wrong: both react and vue → throws InvalidViteConfigException at config load
+nestInertia({ react: true, vue: true });
+```
+
+```ts
+// Correct: exactly one framework flag
+nestInertia({ react: true });
+```
+
+Mechanism: the plugin counts truthy framework flags and throws unless exactly one
+is set. `Source: packages/vite/src/plugin/plugin.ts (frameworkFlags.length !== 1)`
+
+### Mistake 2: omitting the framework plugin dependency
+
+```ts
+// Wrong: nestInertia({ react: true }) but @vitejs/plugin-react not installed
+// → InvalidViteConfigException: Plugin "@vitejs/plugin-react" not installed
+```
+
+```bash
+# Correct: install the matching framework plugin (auto-loaded by nestInertia)
+pnpm add -D @vitejs/plugin-react
+```
+
+Mechanism: `loadFrameworkPlugin` `require()`s the framework package and rethrows
+as `InvalidViteConfigException` with the install command when it is missing.
+`Source: packages/vite/src/plugin/plugin.ts (loadFrameworkPlugin)`
+
+### Mistake 3: forgetting that the dev/prod switch is `mode`
+
+```ts
+// Wrong: leaving mode undefined in production → falls into the dev Vite branch
+await setupInertiaVite(app, { mode: undefined, root: 'inertia', publicDir: 'public', outDir: 'dist/inertia' });
+```
+
+```ts
+// Correct: pass the real mode so prod serves built static assets
+await setupInertiaVite(app, { mode: process.env.NODE_ENV, root: 'inertia', publicDir: 'public', outDir: 'dist/inertia' });
+```
+
+Mechanism: the prod static-serving branch runs only when `mode === 'production'`;
+any other value (including `undefined`) starts an in-process Vite dev server.
+`Source: packages/vite/src/setup.ts (if options.mode !== 'production')`