@application-kit/nestjs-vite 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @application-kit/nestjs-vite
 
+## 0.4.0
+
+### Minor Changes
+
+- ed011f8: `defineApplicationViteConfig({ root, appPath, clientHtml, environment, plugins, buildPlugins })` во входе `/vite-plugin`
+  (и в корне) — весь `vite.config` Nest-SSR-приложения объектом. Контракт выходных имён: серверные входы `[name].mjs` и
+  чанки `[hash].mjs` в корне `dist`, клиент — `assets/[hash].js`, ассеты — `assets/[hash][extname]`, карт нет. Серверную
+  сборку отличает `--ssr` в `process.argv`; порты dev-сервера и HMR — из `environment`. Плагины клиента и плагины только
+  сборки приходят параметрами, зависимостей у пакета не прибавилось.
+
 ## 0.3.0
 
 ### Minor Changes

package/README.md

@@ -26,6 +26,49 @@ export default defineConfig({
 статическими расширениями и внутренние пути Vite уходят в Vite, остальные — в Nest; при
 горячем обновлении приложение пересоздаётся.
 
+## Vite-конфиг приложения
+
+`defineApplicationViteConfig(options)` из `@application-kit/nestjs-vite/vite-plugin` — весь `vite.config`
+Nest-SSR-приложения: dev-сервер Nest (`vitePluginNode`), серверные входы `vite build --ssr <вход>` и клиентская сборка
+в один `dist`.
+
+```ts
+// vite.config.mts
+import { defineApplicationViteConfig } from '@application-kit/nestjs-vite/vite-plugin'
+
+export default defineApplicationViteConfig({
+  appPath: path.resolve(import.meta.dirname, 'src/create-web-application.ts'),
+  buildPlugins: [cleanup()],
+  clientHtml: path.resolve(import.meta.dirname, 'src/client/index.html'),
+  environment: process.env,
+  plugins: [vue(), htmlMinifier({ minify: true })],
+  root: import.meta.dirname,
+})
+```
+
+- Конфиг — объект, а не функция: `vitest.config` приложения мержит его как объект. Серверную сборку отличает флаг
+  `--ssr` в `process.argv` в момент вызова.
+- Пресет не знает о фреймворке клиента: его плагины, обработка HTML и script-теги модулей приходят в `plugins` (после
+  плагина Nest), плагины только сборки (rolldown) — в `buildPlugins`.
+- Окружение: `PORT` (dev-сервер, 3000), `VITE_SERVER_HMR_PORT` и `VITE_SERVER_HMR_CLIENT_PORT` (HMR, 3001), `NODE_ENV=test`
+  выключает прогрев клиентского графа — в e2e браузера нет, а SSR-запросы ждали бы этот фон.
+- Алиас `@` — `<root>/src`; `optimizeDeps` — `pino` без автопоиска; логгер Vite без предупреждений «Sourcemap for …» о
+  картах зависимостей.
+
+Контракт выходных имён — на него опираются команды запуска, образ и раздача статики приложения:
+
+| Что | Имя |
+|---|---|
+| серверный вход (`web`, `cli`, `consumer`, `tracing`, `ormconfig`, …) | `dist/[name].mjs` — без хеша, запускается по имени |
+| серверный чанк | `dist/[hash].mjs` |
+| клиентский вход и чанки | `dist/assets/[hash].js` |
+| ассеты | `dist/assets/[hash][extname]` |
+| карты `*.map` | нет |
+
+Серверный код — `.mjs`: в `dist` нет `package.json` с `"type": "module"`, и `.js` Node прочёл бы как CommonJS. Клиент
+лежит только под `assets/`: каталог отдаётся наружу с вечным кешем, имена контент-адресные, серверного кода и карт в нём
+нет.
+
 ## SSR-страница
 
 ```ts

package/dist/cjs/vite-plugin/application-vite-config-options.interface.d.ts

@@ -0,0 +1,16 @@
+import type { BuildOptions, PluginOption } from 'vite';
+export interface ApplicationViteConfigOptionsInterface {
+    appPath: string;
+    buildPlugins?: BuildPluginsType;
+    clientHtml: string;
+    environment: ApplicationViteEnvironmentInterface;
+    plugins: PluginOption[];
+    root: string;
+}
+export interface ApplicationViteEnvironmentInterface {
+    NODE_ENV?: string;
+    PORT?: string;
+    VITE_SERVER_HMR_CLIENT_PORT?: string;
+    VITE_SERVER_HMR_PORT?: string;
+}
+export type BuildPluginsType = NonNullable<NonNullable<BuildOptions['rolldownOptions']>['plugins']>;

package/dist/cjs/vite-plugin/application-vite-config-options.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/vite-plugin/define-application-vite-config.d.ts

@@ -0,0 +1,3 @@
+import type { UserConfig } from 'vite';
+import type { ApplicationViteConfigOptionsInterface } from './application-vite-config-options.interface.js';
+export declare const defineApplicationViteConfig: (options: ApplicationViteConfigOptionsInterface) => UserConfig;

package/dist/cjs/vite-plugin/define-application-vite-config.js

@@ -0,0 +1,89 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineApplicationViteConfig = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const node_process_1 = __importDefault(require("node:process"));
+const vite_1 = require("vite");
+const vite_plugin_node_js_1 = require("./vite-plugin-node.js");
+const CLIENT_ENTRY = 'assets/main';
+const DEV_SERVER_PORT = 3000;
+const HMR_PORT = 3001;
+const SOURCEMAP_WARNING = 'Sourcemap for';
+const VENDOR_GROUP = /\/node_modules\/(?<group>[\w\-@]*)/u;
+const vendorGroupName = (moduleId) => {
+    const match = VENDOR_GROUP.exec(moduleId);
+    return match?.groups ? match.groups.group : 'unknown';
+};
+const outputOf = (isServerBuild) => ({
+    assetFileNames: 'assets/[hash][extname]',
+    chunkFileNames: isServerBuild ? '[hash].mjs' : 'assets/[hash].js',
+    codeSplitting: {
+        groups: [
+            { name: 'layout', test: /layouts/u },
+            { maxSize: 200_000, minSize: 100_000, name: vendorGroupName, priority: 10, test: /node_modules/u },
+        ],
+    },
+    comments: false,
+    dir: './dist',
+    entryFileNames: (chunk) => (chunk.name === CLIENT_ENTRY ? 'assets/[hash].js' : '[name].mjs'),
+    format: 'esm',
+    hashCharacters: 'base36',
+    minifyInternalExports: false,
+});
+const buildOf = (options, isServerBuild) => ({
+    chunkSizeWarningLimit: 400,
+    emptyOutDir: false,
+    manifest: true,
+    minify: false,
+    rolldownOptions: {
+        input: { [CLIENT_ENTRY]: options.clientHtml },
+        output: outputOf(isServerBuild),
+        plugins: options.buildPlugins ?? [],
+    },
+    sourcemap: false,
+});
+const portOf = (value, fallback) => Number(value) || fallback;
+const serverOf = (environment) => ({
+    allowedHosts: true,
+    hmr: {
+        clientPort: portOf(environment.VITE_SERVER_HMR_CLIENT_PORT, HMR_PORT),
+        port: portOf(environment.VITE_SERVER_HMR_PORT, HMR_PORT),
+    },
+    host: '0.0.0.0',
+    middlewareMode: false,
+    port: portOf(environment.PORT, DEV_SERVER_PORT),
+    preTransformRequests: environment.NODE_ENV !== 'test',
+    strictPort: true,
+    watch: {
+        ignored: ['**/*.gql', 'reports/**/*'],
+        interval: 400,
+        usePolling: true,
+    },
+});
+const createApplicationLogger = () => {
+    const logger = (0, vite_1.createLogger)();
+    const warnOnce = logger.warnOnce.bind(logger);
+    logger.warnOnce = (message, options) => {
+        if (!message.includes(SOURCEMAP_WARNING)) {
+            warnOnce(message, options);
+        }
+    };
+    return logger;
+};
+const defineApplicationViteConfig = (options) => {
+    const isServerBuild = node_process_1.default.argv.includes('--ssr');
+    return {
+        appType: 'custom',
+        build: buildOf(options, isServerBuild),
+        customLogger: createApplicationLogger(),
+        optimizeDeps: { include: ['pino'], noDiscovery: true },
+        plugins: [...(0, vite_plugin_node_js_1.vitePluginNode)({ appPath: options.appPath }), ...options.plugins],
+        resolve: { alias: { '@': node_path_1.default.resolve(options.root, 'src') } },
+        root: node_path_1.default.resolve(options.root),
+        server: serverOf(options.environment),
+    };
+};
+exports.defineApplicationViteConfig = defineApplicationViteConfig;

package/dist/cjs/vite-plugin/index.d.ts

@@ -1,4 +1,6 @@
+export * from './application-vite-config-options.interface.js';
 export * from './create-middleware.js';
+export * from './define-application-vite-config.js';
 export * from './nest-handler.js';
 export * from './plugin-config.interface.js';
 export * from './vite-plugin-node.js';

package/dist/cjs/vite-plugin/index.js

@@ -14,7 +14,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./application-vite-config-options.interface.js"), exports);
 __exportStar(require("./create-middleware.js"), exports);
+__exportStar(require("./define-application-vite-config.js"), exports);
 __exportStar(require("./nest-handler.js"), exports);
 __exportStar(require("./plugin-config.interface.js"), exports);
 __exportStar(require("./vite-plugin-node.js"), exports);

package/dist/esm/vite-plugin/application-vite-config-options.interface.d.ts

@@ -0,0 +1,16 @@
+import type { BuildOptions, PluginOption } from 'vite';
+export interface ApplicationViteConfigOptionsInterface {
+    appPath: string;
+    buildPlugins?: BuildPluginsType;
+    clientHtml: string;
+    environment: ApplicationViteEnvironmentInterface;
+    plugins: PluginOption[];
+    root: string;
+}
+export interface ApplicationViteEnvironmentInterface {
+    NODE_ENV?: string;
+    PORT?: string;
+    VITE_SERVER_HMR_CLIENT_PORT?: string;
+    VITE_SERVER_HMR_PORT?: string;
+}
+export type BuildPluginsType = NonNullable<NonNullable<BuildOptions['rolldownOptions']>['plugins']>;

package/dist/esm/vite-plugin/application-vite-config-options.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/vite-plugin/define-application-vite-config.d.ts

@@ -0,0 +1,3 @@
+import type { UserConfig } from 'vite';
+import type { ApplicationViteConfigOptionsInterface } from './application-vite-config-options.interface.js';
+export declare const defineApplicationViteConfig: (options: ApplicationViteConfigOptionsInterface) => UserConfig;

package/dist/esm/vite-plugin/define-application-vite-config.js

@@ -0,0 +1,82 @@
+import path from 'node:path';
+import process from 'node:process';
+import { createLogger } from 'vite';
+import { vitePluginNode } from './vite-plugin-node.js';
+const CLIENT_ENTRY = 'assets/main';
+const DEV_SERVER_PORT = 3000;
+const HMR_PORT = 3001;
+const SOURCEMAP_WARNING = 'Sourcemap for';
+const VENDOR_GROUP = /\/node_modules\/(?<group>[\w\-@]*)/u;
+const vendorGroupName = (moduleId) => {
+    const match = VENDOR_GROUP.exec(moduleId);
+    return match?.groups ? match.groups.group : 'unknown';
+};
+const outputOf = (isServerBuild) => ({
+    assetFileNames: 'assets/[hash][extname]',
+    chunkFileNames: isServerBuild ? '[hash].mjs' : 'assets/[hash].js',
+    codeSplitting: {
+        groups: [
+            { name: 'layout', test: /layouts/u },
+            { maxSize: 200_000, minSize: 100_000, name: vendorGroupName, priority: 10, test: /node_modules/u },
+        ],
+    },
+    comments: false,
+    dir: './dist',
+    entryFileNames: (chunk) => (chunk.name === CLIENT_ENTRY ? 'assets/[hash].js' : '[name].mjs'),
+    format: 'esm',
+    hashCharacters: 'base36',
+    minifyInternalExports: false,
+});
+const buildOf = (options, isServerBuild) => ({
+    chunkSizeWarningLimit: 400,
+    emptyOutDir: false,
+    manifest: true,
+    minify: false,
+    rolldownOptions: {
+        input: { [CLIENT_ENTRY]: options.clientHtml },
+        output: outputOf(isServerBuild),
+        plugins: options.buildPlugins ?? [],
+    },
+    sourcemap: false,
+});
+const portOf = (value, fallback) => Number(value) || fallback;
+const serverOf = (environment) => ({
+    allowedHosts: true,
+    hmr: {
+        clientPort: portOf(environment.VITE_SERVER_HMR_CLIENT_PORT, HMR_PORT),
+        port: portOf(environment.VITE_SERVER_HMR_PORT, HMR_PORT),
+    },
+    host: '0.0.0.0',
+    middlewareMode: false,
+    port: portOf(environment.PORT, DEV_SERVER_PORT),
+    preTransformRequests: environment.NODE_ENV !== 'test',
+    strictPort: true,
+    watch: {
+        ignored: ['**/*.gql', 'reports/**/*'],
+        interval: 400,
+        usePolling: true,
+    },
+});
+const createApplicationLogger = () => {
+    const logger = createLogger();
+    const warnOnce = logger.warnOnce.bind(logger);
+    logger.warnOnce = (message, options) => {
+        if (!message.includes(SOURCEMAP_WARNING)) {
+            warnOnce(message, options);
+        }
+    };
+    return logger;
+};
+export const defineApplicationViteConfig = (options) => {
+    const isServerBuild = process.argv.includes('--ssr');
+    return {
+        appType: 'custom',
+        build: buildOf(options, isServerBuild),
+        customLogger: createApplicationLogger(),
+        optimizeDeps: { include: ['pino'], noDiscovery: true },
+        plugins: [...vitePluginNode({ appPath: options.appPath }), ...options.plugins],
+        resolve: { alias: { '@': path.resolve(options.root, 'src') } },
+        root: path.resolve(options.root),
+        server: serverOf(options.environment),
+    };
+};

package/dist/esm/vite-plugin/index.d.ts

@@ -1,4 +1,6 @@
+export * from './application-vite-config-options.interface.js';
 export * from './create-middleware.js';
+export * from './define-application-vite-config.js';
 export * from './nest-handler.js';
 export * from './plugin-config.interface.js';
 export * from './vite-plugin-node.js';

package/dist/esm/vite-plugin/index.js

@@ -1,4 +1,6 @@
+export * from './application-vite-config-options.interface.js';
 export * from './create-middleware.js';
+export * from './define-application-vite-config.js';
 export * from './nest-handler.js';
 export * from './plugin-config.interface.js';
 export * from './vite-plugin-node.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@application-kit/nestjs-vite",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Мост Vite ↔ NestJS для SSR: dev-обвязка, загрузка HTML и ssr-entry",
   "keywords": [
     "nestjs",