@application-kit/nestjs-vite 0.2.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/CHANGELOG.md +29 -0
  2. package/README.md +95 -7
  3. package/dist/cjs/filters/index.d.ts +2 -0
  4. package/dist/cjs/filters/index.js +18 -0
  5. package/dist/cjs/filters/not-found.filter.d.ts +11 -0
  6. package/dist/cjs/filters/not-found.filter.js +48 -0
  7. package/dist/cjs/filters/unauthorized-redirect.filter.d.ts +7 -0
  8. package/dist/cjs/filters/unauthorized-redirect.filter.js +42 -0
  9. package/dist/cjs/index.d.ts +4 -0
  10. package/dist/cjs/index.js +4 -0
  11. package/dist/cjs/renderer/html-template.d.ts +5 -0
  12. package/dist/cjs/renderer/html-template.js +18 -0
  13. package/dist/cjs/renderer/index.d.ts +3 -0
  14. package/dist/cjs/renderer/index.js +19 -0
  15. package/dist/cjs/renderer/render-html-page.d.ts +3 -0
  16. package/dist/cjs/renderer/render-html-page.js +9 -0
  17. package/dist/cjs/renderer/vite-application-renderer.d.ts +12 -0
  18. package/dist/cjs/renderer/vite-application-renderer.js +44 -0
  19. package/dist/cjs/ssr-entry/ssr-entry-with-vite.d.ts +4 -4
  20. package/dist/cjs/ssr-entry/ssr-entry.interface.d.ts +9 -7
  21. package/dist/cjs/vite-application-renderer.interface.d.ts +1 -1
  22. package/dist/cjs/vite-plugin/application-vite-config-options.interface.d.ts +16 -0
  23. package/dist/cjs/vite-plugin/application-vite-config-options.interface.js +2 -0
  24. package/dist/cjs/vite-plugin/define-application-vite-config.d.ts +3 -0
  25. package/dist/cjs/vite-plugin/define-application-vite-config.js +89 -0
  26. package/dist/cjs/vite-plugin/index.d.ts +2 -0
  27. package/dist/cjs/vite-plugin/index.js +2 -0
  28. package/dist/cjs/vite-ssr-options.interface.d.ts +10 -0
  29. package/dist/cjs/vite-ssr-options.interface.js +2 -0
  30. package/dist/cjs/vite-ssr.module.d.ts +5 -0
  31. package/dist/cjs/vite-ssr.module.js +55 -0
  32. package/dist/cjs/vite.constants.d.ts +1 -0
  33. package/dist/cjs/vite.constants.js +2 -1
  34. package/dist/esm/filters/index.d.ts +2 -0
  35. package/dist/esm/filters/index.js +2 -0
  36. package/dist/esm/filters/not-found.filter.d.ts +11 -0
  37. package/dist/esm/filters/not-found.filter.js +45 -0
  38. package/dist/esm/filters/unauthorized-redirect.filter.d.ts +7 -0
  39. package/dist/esm/filters/unauthorized-redirect.filter.js +39 -0
  40. package/dist/esm/index.d.ts +4 -0
  41. package/dist/esm/index.js +4 -0
  42. package/dist/esm/renderer/html-template.d.ts +5 -0
  43. package/dist/esm/renderer/html-template.js +14 -0
  44. package/dist/esm/renderer/index.d.ts +3 -0
  45. package/dist/esm/renderer/index.js +3 -0
  46. package/dist/esm/renderer/render-html-page.d.ts +3 -0
  47. package/dist/esm/renderer/render-html-page.js +5 -0
  48. package/dist/esm/renderer/vite-application-renderer.d.ts +12 -0
  49. package/dist/esm/renderer/vite-application-renderer.js +41 -0
  50. package/dist/esm/ssr-entry/ssr-entry-with-vite.d.ts +4 -4
  51. package/dist/esm/ssr-entry/ssr-entry.interface.d.ts +9 -7
  52. package/dist/esm/vite-application-renderer.interface.d.ts +1 -1
  53. package/dist/esm/vite-plugin/application-vite-config-options.interface.d.ts +16 -0
  54. package/dist/esm/vite-plugin/application-vite-config-options.interface.js +1 -0
  55. package/dist/esm/vite-plugin/define-application-vite-config.d.ts +3 -0
  56. package/dist/esm/vite-plugin/define-application-vite-config.js +82 -0
  57. package/dist/esm/vite-plugin/index.d.ts +2 -0
  58. package/dist/esm/vite-plugin/index.js +2 -0
  59. package/dist/esm/vite-ssr-options.interface.d.ts +10 -0
  60. package/dist/esm/vite-ssr-options.interface.js +1 -0
  61. package/dist/esm/vite-ssr.module.d.ts +5 -0
  62. package/dist/esm/vite-ssr.module.js +52 -0
  63. package/dist/esm/vite.constants.d.ts +1 -0
  64. package/dist/esm/vite.constants.js +1 -0
  65. package/package.json +2 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,34 @@
1
1
  # @application-kit/nestjs-vite
2
2
 
3
+ ## 0.4.0
4
+
5
+ ### Minor Changes
6
+
7
+ - ed011f8: `defineApplicationViteConfig({ root, appPath, clientHtml, environment, plugins, buildPlugins })` во входе `/vite-plugin`
8
+ (и в корне) — весь `vite.config` Nest-SSR-приложения объектом. Контракт выходных имён: серверные входы `[name].mjs` и
9
+ чанки `[hash].mjs` в корне `dist`, клиент — `assets/[hash].js`, ассеты — `assets/[hash][extname]`, карт нет. Серверную
10
+ сборку отличает `--ssr` в `process.argv`; порты dev-сервера и HMR — из `environment`. Плагины клиента и плагины только
11
+ сборки приходят параметрами, зависимостей у пакета не прибавилось.
12
+
13
+ ## 0.3.0
14
+
15
+ ### Minor Changes
16
+
17
+ - 73ac7bd: SSR-страница целиком в пакете: `ViteSsrModule.forRoot({ htmlPath, ssrEntry, isProduction, notFoundPath,
18
+ buildInitialState })` — глобальный модуль с загрузчиком `index.html` и обёрткой энтри под production или Vite dev
19
+ server, рендерером `ViteApplicationRenderer` под `VITE_APPLICATION_RENDERER` и фильтром 404 `NotFoundFilter`.
20
+ `renderHtmlPage(renderer, request, reply)` — один путь HTML-ответа для контроллера и фильтра.
21
+ `UnauthorizedRedirectFilter(signInPath)` — 401: JSON-клиенту тело 401, навигации браузера — переход на вход с
22
+ `?continue=`, GraphQL-вызову — повторный бросок драйверу. Плейсхолдеры шаблона — `STATE_PLACEHOLDER`,
23
+ `TEMPLATE_PLACEHOLDER`, `LANG_ATTRIBUTE_PATTERN`; значения состояния уходят в `<script>` JS-литералами с
24
+ экранированным `<` при любом сериализаторе потребителя. Новая peer-зависимость — `@nestjs/core`.
25
+
26
+ **Ломающее:** SSR-энтри отдаёт страницу `SsrPageInterface { lang, state, statusCode, template }` вместо
27
+ `{ context, store, template }` — ключи `window.*`, язык `<html lang>` и статус выбирает энтри; дженерик контекста
28
+ у `SsrEntryInterface` и тип `SsrEntryInterfaceRender` удалены, `initialState` обязателен. У
29
+ `ViteApplicationRendererInterface.renderApplication` нет второго параметра: данные запроса собирает
30
+ `buildInitialState`.
31
+
3
32
  ## 0.2.0
4
33
 
5
34
  ### Minor Changes
package/README.md CHANGED
@@ -26,15 +26,103 @@ export default defineConfig({
26
26
  статическими расширениями и внутренние пути Vite уходят в Vite, остальные — в Nest; при
27
27
  горячем обновлении приложение пересоздаётся.
28
28
 
29
- ## Рендер
29
+ ## Vite-конфиг приложения
30
30
 
31
- - `ViteModule` — глобальный модуль с Vite dev server под токеном `VITE_DEV_SERVER` (только dev).
32
- - `HTML_LOADER_INTERFACE` — `HtmlLoaderWithVite` (dev, `transformIndexHtml`) или `HtmlLoader`
33
- (production, читает `index.html` один раз и кеширует).
34
- - `SSR_ENTRY_INTERFACE` — SSR-entry приложения; в dev его оборачивает `SsrEntryWithVite`:
31
+ `defineApplicationViteConfig(options)` из `@application-kit/nestjs-vite/vite-plugin` — весь `vite.config`
32
+ Nest-SSR-приложения: dev-сервер Nest (`vitePluginNode`), серверные входы `vite build --ssr <вход>` и клиентская сборка
33
+ в один `dist`.
34
+
35
+ ```ts
36
+ // vite.config.mts
37
+ import { defineApplicationViteConfig } from '@application-kit/nestjs-vite/vite-plugin'
38
+
39
+ export default defineApplicationViteConfig({
40
+ appPath: path.resolve(import.meta.dirname, 'src/create-web-application.ts'),
41
+ buildPlugins: [cleanup()],
42
+ clientHtml: path.resolve(import.meta.dirname, 'src/client/index.html'),
43
+ environment: process.env,
44
+ plugins: [vue(), htmlMinifier({ minify: true })],
45
+ root: import.meta.dirname,
46
+ })
47
+ ```
48
+
49
+ - Конфиг — объект, а не функция: `vitest.config` приложения мержит его как объект. Серверную сборку отличает флаг
50
+ `--ssr` в `process.argv` в момент вызова.
51
+ - Пресет не знает о фреймворке клиента: его плагины, обработка HTML и script-теги модулей приходят в `plugins` (после
52
+ плагина Nest), плагины только сборки (rolldown) — в `buildPlugins`.
53
+ - Окружение: `PORT` (dev-сервер, 3000), `VITE_SERVER_HMR_PORT` и `VITE_SERVER_HMR_CLIENT_PORT` (HMR, 3001), `NODE_ENV=test`
54
+ выключает прогрев клиентского графа — в e2e браузера нет, а SSR-запросы ждали бы этот фон.
55
+ - Алиас `@` — `<root>/src`; `optimizeDeps` — `pino` без автопоиска; логгер Vite без предупреждений «Sourcemap for …» о
56
+ картах зависимостей.
57
+
58
+ Контракт выходных имён — на него опираются команды запуска, образ и раздача статики приложения:
59
+
60
+ | Что | Имя |
61
+ |---|---|
62
+ | серверный вход (`web`, `cli`, `consumer`, `tracing`, `ormconfig`, …) | `dist/[name].mjs` — без хеша, запускается по имени |
63
+ | серверный чанк | `dist/[hash].mjs` |
64
+ | клиентский вход и чанки | `dist/assets/[hash].js` |
65
+ | ассеты | `dist/assets/[hash][extname]` |
66
+ | карты `*.map` | нет |
67
+
68
+ Серверный код — `.mjs`: в `dist` нет `package.json` с `"type": "module"`, и `.js` Node прочёл бы как CommonJS. Клиент
69
+ лежит только под `assets/`: каталог отдаётся наружу с вечным кешем, имена контент-адресные, серверного кода и карт в нём
70
+ нет.
71
+
72
+ ## SSR-страница
73
+
74
+ ```ts
75
+ @Module({
76
+ imports: [
77
+ ViteSsrModule.forRoot({
78
+ buildInitialState: (request) => ({ locale: resolveLocale(request) }),
79
+ htmlPath: isProduction ? path.resolve(dirname, 'client') : dirname,
80
+ isProduction,
81
+ notFoundPath: '/404',
82
+ ssrEntry: EntrySsr,
83
+ }),
84
+ ],
85
+ })
86
+ export class ClientModule {}
87
+ ```
88
+
89
+ `ViteSsrModule.forRoot` — глобальный модуль: рендерер под `VITE_APPLICATION_RENDERER` виден контроллерам страниц в
90
+ любом модуле. Опции:
91
+
92
+ - `ssrEntry` — класс SSR-энтри (`SsrEntryInterface`). Модуль провайдит его сам, поэтому зависимости энтри должны быть
93
+ видны из глобальных модулей.
94
+ - `buildInitialState(request)` — данные запроса для энтри (локаль, идентификатор для поддержки…): запрос виден только
95
+ рендереру, а что из него нужно странице, знает приложение.
96
+ - `htmlPath` — каталог с `index.html`; `notFoundPath` — путь страницы «не найдено», его рендерит фильтр 404.
97
+ - `isProduction` — `HtmlLoader` (читает `index.html` один раз и кеширует) и энтри как есть; иначе `ViteModule`
98
+ с Vite dev server под `VITE_DEV_SERVER`, `HtmlLoaderWithVite` (`transformIndexHtml`) и обёртка `SsrEntryWithVite`:
35
99
  ошибка рендера получает стектрейс по исходникам (`ssrFixStacktrace`) и уходит как `PluginRenderError`.
36
- - `VITE_APPLICATION_RENDERER` — токен рендерера приложения (`ViteApplicationRendererInterface`),
37
- реализация остаётся за приложением.
100
+
101
+ Энтри отдаёт страницу `SsrPageInterface`: `template` — разметка приложения, `state` — ключ `window.*` → строка,
102
+ `lang` — значение `<html lang>`, `statusCode` — статус ответа. Рендерер вставляет её в `index.html` приложения по
103
+ плейсхолдерам:
104
+
105
+ | Константа | В шаблоне | Чем заменяется |
106
+ |---|---|---|
107
+ | `STATE_PLACEHOLDER` | `<script id="state"></script>` | `<script>` с присваиваниями `window[ключ] = значение` |
108
+ | `TEMPLATE_PLACEHOLDER` | `<div id="app"></div>` | тот же `div` с разметкой `template` внутри |
109
+ | `LANG_ATTRIBUTE_PATTERN` | `<html lang="…">` с любым значением | `lang` страницы |
110
+
111
+ Значения состояния уходят JS-литералами строки с экранированным `<`: `</script>` в данных не закроет тег, какой бы
112
+ сериализатор ни выбрало приложение. Клиентский энтри читает их до гидрации.
113
+
114
+ `renderHtmlPage(renderer, request, reply)` — один путь HTML-ответа: ставит статус рендера и `Content-Type: text/html`
115
+ и возвращает HTML. Контроллер с `@Res({ passthrough: true })` возвращает его, фильтр — отправляет. Декоратор
116
+ `@Header('Content-Type')` на маршруте страницы не нужен.
117
+
118
+ ### Фильтры
119
+
120
+ - `NotFoundFilter` — регистрирует `ViteSsrModule`: `NotFoundException` отвечает отрендеренной страницей
121
+ `notFoundPath` со статусом рендера.
122
+ - `UnauthorizedRedirectFilter(signInPath)` — регистрирует модуль, которому принадлежит страница входа:
123
+ `{ provide: APP_FILTER, useValue: new UnauthorizedRedirectFilter('/sign-in') }`. JSON-клиент (`Content-Type:
124
+ application/json`) получает 401 с JSON-телом, навигация браузера — 302 на `<signInPath>?continue=<url>`,
125
+ GraphQL-вызов — повторный бросок исключения драйверу GraphQL.
38
126
 
39
127
  ## Тесты потребителя
40
128
 
@@ -0,0 +1,2 @@
1
+ export * from './not-found.filter.js';
2
+ export * from './unauthorized-redirect.filter.js';
@@ -0,0 +1,18 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ __exportStar(require("./not-found.filter.js"), exports);
18
+ __exportStar(require("./unauthorized-redirect.filter.js"), exports);
@@ -0,0 +1,11 @@
1
+ import type { ArgumentsHost, ExceptionFilter } from '@nestjs/common';
2
+ import { NotFoundException } from '@nestjs/common';
3
+ import { ModuleRef } from '@nestjs/core';
4
+ import type { ViteSsrOptionsInterface } from '../vite-ssr-options.interface.js';
5
+ export declare class NotFoundFilter implements ExceptionFilter<NotFoundException> {
6
+ private readonly moduleReference;
7
+ private readonly options;
8
+ constructor(moduleReference: ModuleRef, options: Pick<ViteSsrOptionsInterface, 'notFoundPath'>);
9
+ catch(_exception: NotFoundException, host: ArgumentsHost): Promise<void>;
10
+ private resolveRenderer;
11
+ }
@@ -0,0 +1,48 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ var __metadata = (this && this.__metadata) || function (k, v) {
9
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
+ };
11
+ var __param = (this && this.__param) || function (paramIndex, decorator) {
12
+ return function (target, key) { decorator(target, key, paramIndex); }
13
+ };
14
+ Object.defineProperty(exports, "__esModule", { value: true });
15
+ exports.NotFoundFilter = void 0;
16
+ const common_1 = require("@nestjs/common");
17
+ const core_1 = require("@nestjs/core");
18
+ const render_html_page_js_1 = require("../renderer/render-html-page.js");
19
+ const vite_application_renderer_interface_js_1 = require("../vite-application-renderer.interface.js");
20
+ const vite_constants_js_1 = require("../vite.constants.js");
21
+ let NotFoundFilter = class NotFoundFilter {
22
+ moduleReference;
23
+ options;
24
+ constructor(moduleReference, options) {
25
+ this.moduleReference = moduleReference;
26
+ this.options = options;
27
+ }
28
+ async catch(_exception, host) {
29
+ const context = host.switchToHttp();
30
+ const reply = context.getResponse();
31
+ const request = context.getRequest();
32
+ const renderer = await this.resolveRenderer(request);
33
+ request.raw.url = this.options.notFoundPath;
34
+ await reply.send(await (0, render_html_page_js_1.renderHtmlPage)(renderer, request, reply));
35
+ }
36
+ async resolveRenderer(request) {
37
+ const contextId = core_1.ContextIdFactory.getByRequest(request);
38
+ this.moduleReference.registerRequestByContextId(request, contextId);
39
+ return this.moduleReference.resolve(vite_application_renderer_interface_js_1.VITE_APPLICATION_RENDERER, contextId);
40
+ }
41
+ };
42
+ exports.NotFoundFilter = NotFoundFilter;
43
+ exports.NotFoundFilter = NotFoundFilter = __decorate([
44
+ (0, common_1.Catch)(common_1.NotFoundException),
45
+ __param(0, (0, common_1.Inject)(core_1.ModuleRef)),
46
+ __param(1, (0, common_1.Inject)(vite_constants_js_1.VITE_SSR_OPTIONS)),
47
+ __metadata("design:paramtypes", [core_1.ModuleRef, Object])
48
+ ], NotFoundFilter);
@@ -0,0 +1,7 @@
1
+ import type { ArgumentsHost, ExceptionFilter } from '@nestjs/common';
2
+ import { UnauthorizedException } from '@nestjs/common';
3
+ export declare class UnauthorizedRedirectFilter implements ExceptionFilter<UnauthorizedException> {
4
+ private readonly signInPath;
5
+ constructor(signInPath: string);
6
+ catch(exception: UnauthorizedException, host: ArgumentsHost): Promise<void>;
7
+ }
@@ -0,0 +1,42 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ var __metadata = (this && this.__metadata) || function (k, v) {
9
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
+ };
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.UnauthorizedRedirectFilter = void 0;
13
+ const common_1 = require("@nestjs/common");
14
+ let UnauthorizedRedirectFilter = class UnauthorizedRedirectFilter {
15
+ signInPath;
16
+ constructor(signInPath) {
17
+ this.signInPath = signInPath;
18
+ }
19
+ async catch(exception, host) {
20
+ if (host.getType() === 'graphql') {
21
+ throw exception;
22
+ }
23
+ const context = host.switchToHttp();
24
+ const reply = context.getResponse();
25
+ const request = context.getRequest();
26
+ const contentType = request.headers['content-type'];
27
+ if (typeof contentType === 'string' && contentType.includes('application/json')) {
28
+ await reply.status(common_1.HttpStatus.UNAUTHORIZED).send({
29
+ error: exception.name,
30
+ message: exception.message,
31
+ statusCode: common_1.HttpStatus.UNAUTHORIZED,
32
+ });
33
+ return;
34
+ }
35
+ await reply.status(common_1.HttpStatus.FOUND).redirect(`${this.signInPath}?continue=${request.url}`);
36
+ }
37
+ };
38
+ exports.UnauthorizedRedirectFilter = UnauthorizedRedirectFilter;
39
+ exports.UnauthorizedRedirectFilter = UnauthorizedRedirectFilter = __decorate([
40
+ (0, common_1.Catch)(common_1.UnauthorizedException),
41
+ __metadata("design:paramtypes", [String])
42
+ ], UnauthorizedRedirectFilter);
@@ -1,6 +1,10 @@
1
+ export * from './filters/index.js';
1
2
  export * from './html-loader/index.js';
3
+ export * from './renderer/index.js';
2
4
  export * from './ssr-entry/index.js';
3
5
  export * from './vite-plugin/index.js';
4
6
  export * from './vite-application-renderer.interface.js';
7
+ export * from './vite-ssr-options.interface.js';
8
+ export * from './vite-ssr.module.js';
5
9
  export * from './vite.constants.js';
6
10
  export * from './vite.module.js';
package/dist/cjs/index.js CHANGED
@@ -14,9 +14,13 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
14
  for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
15
  };
16
16
  Object.defineProperty(exports, "__esModule", { value: true });
17
+ __exportStar(require("./filters/index.js"), exports);
17
18
  __exportStar(require("./html-loader/index.js"), exports);
19
+ __exportStar(require("./renderer/index.js"), exports);
18
20
  __exportStar(require("./ssr-entry/index.js"), exports);
19
21
  __exportStar(require("./vite-plugin/index.js"), exports);
20
22
  __exportStar(require("./vite-application-renderer.interface.js"), exports);
23
+ __exportStar(require("./vite-ssr-options.interface.js"), exports);
24
+ __exportStar(require("./vite-ssr.module.js"), exports);
21
25
  __exportStar(require("./vite.constants.js"), exports);
22
26
  __exportStar(require("./vite.module.js"), exports);
@@ -0,0 +1,5 @@
1
+ import type { SsrPageInterface } from '../ssr-entry/ssr-entry.interface.js';
2
+ export declare const STATE_PLACEHOLDER = "<script id=\"state\"></script>";
3
+ export declare const TEMPLATE_PLACEHOLDER = "<div id=\"app\"></div>";
4
+ export declare const LANG_ATTRIBUTE_PATTERN: RegExp;
5
+ export declare const fillHtmlTemplate: (html: string, page: SsrPageInterface) => string;
@@ -0,0 +1,18 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.fillHtmlTemplate = exports.LANG_ATTRIBUTE_PATTERN = exports.TEMPLATE_PLACEHOLDER = exports.STATE_PLACEHOLDER = void 0;
4
+ exports.STATE_PLACEHOLDER = '<script id="state"></script>';
5
+ exports.TEMPLATE_PLACEHOLDER = '<div id="app"></div>';
6
+ exports.LANG_ATTRIBUTE_PATTERN = /<html\s+lang="[^"]*"/u;
7
+ const toScriptLiteral = (value) => JSON.stringify(value).replaceAll('<', String.raw `\u003C`);
8
+ const toAttributeValue = (value) => value.replaceAll('&', '&amp;').replaceAll('"', '&quot;');
9
+ const toStateScript = (state) => {
10
+ const assignments = Object.entries(state)
11
+ .map(([key, value]) => `window[${toScriptLiteral(key)}] = ${toScriptLiteral(value)};`);
12
+ return `<script>${assignments.join('')}</script>`;
13
+ };
14
+ const fillHtmlTemplate = (html, page) => html
15
+ .replace(exports.STATE_PLACEHOLDER, () => toStateScript(page.state))
16
+ .replace(exports.TEMPLATE_PLACEHOLDER, () => `<div id="app">${page.template}</div>`)
17
+ .replace(exports.LANG_ATTRIBUTE_PATTERN, () => `<html lang="${toAttributeValue(page.lang)}"`);
18
+ exports.fillHtmlTemplate = fillHtmlTemplate;
@@ -0,0 +1,3 @@
1
+ export * from './html-template.js';
2
+ export * from './render-html-page.js';
3
+ export * from './vite-application-renderer.js';
@@ -0,0 +1,19 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ __exportStar(require("./html-template.js"), exports);
18
+ __exportStar(require("./render-html-page.js"), exports);
19
+ __exportStar(require("./vite-application-renderer.js"), exports);
@@ -0,0 +1,3 @@
1
+ import type { FastifyReply, FastifyRequest } from 'fastify';
2
+ import type { ViteApplicationRendererInterface } from '../vite-application-renderer.interface.js';
3
+ export declare const renderHtmlPage: (renderer: ViteApplicationRendererInterface, request: FastifyRequest, reply: FastifyReply) => Promise<string>;
@@ -0,0 +1,9 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.renderHtmlPage = void 0;
4
+ const renderHtmlPage = async (renderer, request, reply) => {
5
+ const { html, statusCode } = await renderer.renderApplication(request);
6
+ void reply.code(statusCode).header('Content-Type', 'text/html');
7
+ return html;
8
+ };
9
+ exports.renderHtmlPage = renderHtmlPage;
@@ -0,0 +1,12 @@
1
+ import type { FastifyRequest } from 'fastify';
2
+ import type { HtmlLoaderInterface } from '../html-loader/html-loader.interface.js';
3
+ import type { SsrEntryInterface } from '../ssr-entry/ssr-entry.interface.js';
4
+ import type { ApplicationInterface, ViteApplicationRendererInterface } from '../vite-application-renderer.interface.js';
5
+ import type { ViteSsrOptionsInterface } from '../vite-ssr-options.interface.js';
6
+ export declare class ViteApplicationRenderer implements ViteApplicationRendererInterface {
7
+ private readonly ssrEntry;
8
+ private readonly htmlLoader;
9
+ private readonly options;
10
+ constructor(ssrEntry: SsrEntryInterface, htmlLoader: HtmlLoaderInterface, options: Pick<ViteSsrOptionsInterface, 'buildInitialState' | 'htmlPath'>);
11
+ renderApplication(request: FastifyRequest): Promise<ApplicationInterface>;
12
+ }
@@ -0,0 +1,44 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ var __metadata = (this && this.__metadata) || function (k, v) {
9
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
+ };
11
+ var __param = (this && this.__param) || function (paramIndex, decorator) {
12
+ return function (target, key) { decorator(target, key, paramIndex); }
13
+ };
14
+ Object.defineProperty(exports, "__esModule", { value: true });
15
+ exports.ViteApplicationRenderer = void 0;
16
+ const common_1 = require("@nestjs/common");
17
+ const html_loader_interface_js_1 = require("../html-loader/html-loader.interface.js");
18
+ const ssr_entry_interface_js_1 = require("../ssr-entry/ssr-entry.interface.js");
19
+ const vite_constants_js_1 = require("../vite.constants.js");
20
+ const html_template_js_1 = require("./html-template.js");
21
+ let ViteApplicationRenderer = class ViteApplicationRenderer {
22
+ ssrEntry;
23
+ htmlLoader;
24
+ options;
25
+ constructor(ssrEntry, htmlLoader, options) {
26
+ this.ssrEntry = ssrEntry;
27
+ this.htmlLoader = htmlLoader;
28
+ this.options = options;
29
+ }
30
+ async renderApplication(request) {
31
+ const { url } = request;
32
+ const html = await this.htmlLoader.loadHtml(this.options.htmlPath, url);
33
+ const page = await this.ssrEntry.render(url, this.options.buildInitialState(request));
34
+ return { html: (0, html_template_js_1.fillHtmlTemplate)(html, page), statusCode: page.statusCode };
35
+ }
36
+ };
37
+ exports.ViteApplicationRenderer = ViteApplicationRenderer;
38
+ exports.ViteApplicationRenderer = ViteApplicationRenderer = __decorate([
39
+ (0, common_1.Injectable)(),
40
+ __param(0, (0, common_1.Inject)(ssr_entry_interface_js_1.SSR_ENTRY_INTERFACE)),
41
+ __param(1, (0, common_1.Inject)(html_loader_interface_js_1.HTML_LOADER_INTERFACE)),
42
+ __param(2, (0, common_1.Inject)(vite_constants_js_1.VITE_SSR_OPTIONS)),
43
+ __metadata("design:paramtypes", [Object, Object, Object])
44
+ ], ViteApplicationRenderer);
@@ -1,8 +1,8 @@
1
1
  import type { ViteDevServer } from 'vite';
2
- import type { SsrEntryInterface, SsrEntryInterfaceRender } from './ssr-entry.interface.js';
3
- export declare class SsrEntryWithVite implements SsrEntryInterface<unknown> {
2
+ import type { SsrEntryInterface, SsrPageInterface } from './ssr-entry.interface.js';
3
+ export declare class SsrEntryWithVite implements SsrEntryInterface {
4
4
  private readonly originSsrEntry;
5
5
  private readonly viteDevelopmentServer;
6
- constructor(originSsrEntry: SsrEntryInterface<unknown>, viteDevelopmentServer: ViteDevServer);
7
- render(url: string, initialState?: Record<string, unknown>): SsrEntryInterfaceRender<unknown>;
6
+ constructor(originSsrEntry: SsrEntryInterface, viteDevelopmentServer: ViteDevServer);
7
+ render(url: string, initialState: Record<string, unknown>): Promise<SsrPageInterface>;
8
8
  }
@@ -1,9 +1,11 @@
1
+ import type { HttpStatus } from '@nestjs/common';
1
2
  export declare const SSR_ENTRY_INTERFACE: unique symbol;
2
- export interface SsrEntryInterface<SsrContext> {
3
- render(url: string, initialState?: Record<string, unknown>): SsrEntryInterfaceRender<SsrContext>;
3
+ export interface SsrEntryInterface {
4
+ render(url: string, initialState: Record<string, unknown>): Promise<SsrPageInterface>;
5
+ }
6
+ export interface SsrPageInterface {
7
+ readonly lang: string;
8
+ readonly state: Readonly<Record<string, string>>;
9
+ readonly statusCode: HttpStatus;
10
+ readonly template: string;
4
11
  }
5
- export type SsrEntryInterfaceRender<T> = Promise<{
6
- context: T;
7
- store: string;
8
- template: string;
9
- }>;
@@ -5,7 +5,7 @@ interface AppInterface {
5
5
  statusCode: HttpStatus;
6
6
  }
7
7
  interface ViteAppRendererInterface {
8
- renderApplication(request: FastifyRequest, initialState?: Record<string, unknown>): Promise<AppInterface>;
8
+ renderApplication(request: FastifyRequest): Promise<AppInterface>;
9
9
  }
10
10
  export type { AppInterface as ApplicationInterface, ViteAppRendererInterface as ViteApplicationRendererInterface };
11
11
  export declare const VITE_APPLICATION_RENDERER: unique symbol;
@@ -0,0 +1,16 @@
1
+ import type { BuildOptions, PluginOption } from 'vite';
2
+ export interface ApplicationViteConfigOptionsInterface {
3
+ appPath: string;
4
+ buildPlugins?: BuildPluginsType;
5
+ clientHtml: string;
6
+ environment: ApplicationViteEnvironmentInterface;
7
+ plugins: PluginOption[];
8
+ root: string;
9
+ }
10
+ export interface ApplicationViteEnvironmentInterface {
11
+ NODE_ENV?: string;
12
+ PORT?: string;
13
+ VITE_SERVER_HMR_CLIENT_PORT?: string;
14
+ VITE_SERVER_HMR_PORT?: string;
15
+ }
16
+ export type BuildPluginsType = NonNullable<NonNullable<BuildOptions['rolldownOptions']>['plugins']>;
@@ -0,0 +1,2 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -0,0 +1,3 @@
1
+ import type { UserConfig } from 'vite';
2
+ import type { ApplicationViteConfigOptionsInterface } from './application-vite-config-options.interface.js';
3
+ export declare const defineApplicationViteConfig: (options: ApplicationViteConfigOptionsInterface) => UserConfig;
@@ -0,0 +1,89 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.defineApplicationViteConfig = void 0;
7
+ const node_path_1 = __importDefault(require("node:path"));
8
+ const node_process_1 = __importDefault(require("node:process"));
9
+ const vite_1 = require("vite");
10
+ const vite_plugin_node_js_1 = require("./vite-plugin-node.js");
11
+ const CLIENT_ENTRY = 'assets/main';
12
+ const DEV_SERVER_PORT = 3000;
13
+ const HMR_PORT = 3001;
14
+ const SOURCEMAP_WARNING = 'Sourcemap for';
15
+ const VENDOR_GROUP = /\/node_modules\/(?<group>[\w\-@]*)/u;
16
+ const vendorGroupName = (moduleId) => {
17
+ const match = VENDOR_GROUP.exec(moduleId);
18
+ return match?.groups ? match.groups.group : 'unknown';
19
+ };
20
+ const outputOf = (isServerBuild) => ({
21
+ assetFileNames: 'assets/[hash][extname]',
22
+ chunkFileNames: isServerBuild ? '[hash].mjs' : 'assets/[hash].js',
23
+ codeSplitting: {
24
+ groups: [
25
+ { name: 'layout', test: /layouts/u },
26
+ { maxSize: 200_000, minSize: 100_000, name: vendorGroupName, priority: 10, test: /node_modules/u },
27
+ ],
28
+ },
29
+ comments: false,
30
+ dir: './dist',
31
+ entryFileNames: (chunk) => (chunk.name === CLIENT_ENTRY ? 'assets/[hash].js' : '[name].mjs'),
32
+ format: 'esm',
33
+ hashCharacters: 'base36',
34
+ minifyInternalExports: false,
35
+ });
36
+ const buildOf = (options, isServerBuild) => ({
37
+ chunkSizeWarningLimit: 400,
38
+ emptyOutDir: false,
39
+ manifest: true,
40
+ minify: false,
41
+ rolldownOptions: {
42
+ input: { [CLIENT_ENTRY]: options.clientHtml },
43
+ output: outputOf(isServerBuild),
44
+ plugins: options.buildPlugins ?? [],
45
+ },
46
+ sourcemap: false,
47
+ });
48
+ const portOf = (value, fallback) => Number(value) || fallback;
49
+ const serverOf = (environment) => ({
50
+ allowedHosts: true,
51
+ hmr: {
52
+ clientPort: portOf(environment.VITE_SERVER_HMR_CLIENT_PORT, HMR_PORT),
53
+ port: portOf(environment.VITE_SERVER_HMR_PORT, HMR_PORT),
54
+ },
55
+ host: '0.0.0.0',
56
+ middlewareMode: false,
57
+ port: portOf(environment.PORT, DEV_SERVER_PORT),
58
+ preTransformRequests: environment.NODE_ENV !== 'test',
59
+ strictPort: true,
60
+ watch: {
61
+ ignored: ['**/*.gql', 'reports/**/*'],
62
+ interval: 400,
63
+ usePolling: true,
64
+ },
65
+ });
66
+ const createApplicationLogger = () => {
67
+ const logger = (0, vite_1.createLogger)();
68
+ const warnOnce = logger.warnOnce.bind(logger);
69
+ logger.warnOnce = (message, options) => {
70
+ if (!message.includes(SOURCEMAP_WARNING)) {
71
+ warnOnce(message, options);
72
+ }
73
+ };
74
+ return logger;
75
+ };
76
+ const defineApplicationViteConfig = (options) => {
77
+ const isServerBuild = node_process_1.default.argv.includes('--ssr');
78
+ return {
79
+ appType: 'custom',
80
+ build: buildOf(options, isServerBuild),
81
+ customLogger: createApplicationLogger(),
82
+ optimizeDeps: { include: ['pino'], noDiscovery: true },
83
+ plugins: [...(0, vite_plugin_node_js_1.vitePluginNode)({ appPath: options.appPath }), ...options.plugins],
84
+ resolve: { alias: { '@': node_path_1.default.resolve(options.root, 'src') } },
85
+ root: node_path_1.default.resolve(options.root),
86
+ server: serverOf(options.environment),
87
+ };
88
+ };
89
+ exports.defineApplicationViteConfig = defineApplicationViteConfig;
@@ -1,4 +1,6 @@
1
+ export * from './application-vite-config-options.interface.js';
1
2
  export * from './create-middleware.js';
3
+ export * from './define-application-vite-config.js';
2
4
  export * from './nest-handler.js';
3
5
  export * from './plugin-config.interface.js';
4
6
  export * from './vite-plugin-node.js';
@@ -14,7 +14,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
14
  for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
15
  };
16
16
  Object.defineProperty(exports, "__esModule", { value: true });
17
+ __exportStar(require("./application-vite-config-options.interface.js"), exports);
17
18
  __exportStar(require("./create-middleware.js"), exports);
19
+ __exportStar(require("./define-application-vite-config.js"), exports);
18
20
  __exportStar(require("./nest-handler.js"), exports);
19
21
  __exportStar(require("./plugin-config.interface.js"), exports);
20
22
  __exportStar(require("./vite-plugin-node.js"), exports);
@@ -0,0 +1,10 @@
1
+ import type { Type } from '@nestjs/common';
2
+ import type { FastifyRequest } from 'fastify';
3
+ import type { SsrEntryInterface } from './ssr-entry/ssr-entry.interface.js';
4
+ export interface ViteSsrOptionsInterface {
5
+ buildInitialState(request: FastifyRequest): Record<string, unknown>;
6
+ readonly htmlPath: string;
7
+ readonly isProduction: boolean;
8
+ readonly notFoundPath: string;
9
+ readonly ssrEntry: Type<SsrEntryInterface>;
10
+ }
@@ -0,0 +1,2 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });