@application-kit/nestjs-vite 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @application-kit/nestjs-vite
 
+## 0.6.0
+
+### Minor Changes
+
+- e9411eb: Спеки-гейты продукта переехали в пакеты: спека теперь — вызов помощника с параметрами продукта, а нарушение приходит ошибкой со списком.
+
+  `ui/testing`: `assertTokensDeclared`. `kafka/testing` (новый вход): `assertConsumerTopicsConsistent`. `authorization/testing` (новый вход): `assertAbilityRegistryConsistent`. `nestjs-vite/static-assets-gate` (новый вход, отдельно от `/testing`, чтобы спеки с фейком рендерера не грузили `vite`): `assertStaticAssetsLayout`. `lint-config` разрешает импорт нового входа `nestjs-vite/static-assets-gate`.
+
 ## 0.5.0
 
 ### Minor Changes

package/README.md

@@ -148,6 +148,10 @@ export class ClientModule {}
 `VITE_APPLICATION_RENDERER` для спек, предмет которых не SSR (контроллеры зависят от рендерера, а настоящий поднимает
 Vite). Фейк отвечает `<div id="app">{url}</div>` со статусом 200; сам он — `fakeApplicationRenderer`. Vite вход не тянет.
 
+Вход `@application-kit/nestjs-vite/static-assets-gate` — `assertStaticAssetsLayout`: гейт периметра прод-образа. Читает
+`vite.config` продукта обеими сборками и падает со списком расхождений, если клиентская сборка вышла за подкаталог
+`assets` под хешем, серверные входы переименованы, появились карты исходников или нехешируемая статика в `publicDir`.
+
 ## Формат
 
 ESM и CJS. Это две копии с разными классами и токенами — в одном процессе пакет

package/dist/cjs/static-assets-gate/assert-static-assets-layout.d.ts

@@ -0,0 +1,10 @@
+export interface StaticAssetsLayoutOptionsInterface {
+    readonly clientModuleFile: string;
+    readonly iconFile: string;
+    readonly indexHtmlFile: string;
+    readonly rootDirectory: string;
+    readonly serverEntries: readonly string[];
+    readonly tsconfigBuildFile: string;
+    readonly viteConfigFile: string;
+}
+export declare const assertStaticAssetsLayout: (options: StaticAssetsLayoutOptionsInterface) => Promise<void>;

package/dist/cjs/static-assets-gate/assert-static-assets-layout.js

@@ -0,0 +1,105 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertStaticAssetsLayout = void 0;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
+const node_util_1 = require("node:util");
+const vite_1 = require("vite");
+const ASSETS_DIRECTORY = 'assets';
+const CLIENT_ENTRY = `${ASSETS_DIRECTORY}/main`;
+const CHUNK_NAME = 'chunk';
+const isPresent = async (file) => {
+    try {
+        await (0, promises_1.access)(file);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const loadBuildConfig = async ({ rootDirectory, viteConfigFile }, isSsrBuild) => {
+    const { argv } = process;
+    process.argv = isSsrBuild ? [...argv, '--ssr'] : argv;
+    try {
+        const loaded = await (0, vite_1.loadConfigFromFile)({ command: 'build', isSsrBuild, mode: 'production' }, node_path_1.default.join(rootDirectory, viteConfigFile), rootDirectory, 'silent');
+        if (loaded === null) {
+            throw new Error(`${viteConfigFile} не найден`);
+        }
+        return loaded.config;
+    }
+    finally {
+        process.argv = argv;
+    }
+};
+const buildOf = (config) => config.build ?? {};
+const outputOf = (config, viteConfigFile) => {
+    const output = buildOf(config).rolldownOptions?.output;
+    if (output === undefined || Array.isArray(output)) {
+        throw new TypeError(`${viteConfigFile}: ожидается один набор output`);
+    }
+    return output;
+};
+const fileNameOf = (pattern, name) => (typeof pattern === 'function'
+    ? pattern({ exports: [], facadeModuleId: null, isDynamicEntry: false, isEntry: true, moduleIds: [], name })
+    : pattern);
+const violationIf = (isViolated, message) => (isViolated ? [message] : []);
+const mismatch = (what, actual, expected) => ((0, node_util_1.isDeepStrictEqual)(actual, expected)
+    ? []
+    : [`${what}: ${JSON.stringify(actual)}, ожидается ${JSON.stringify(expected)}`]);
+const clientOutputViolations = (output) => [
+    ...mismatch('клиентские ассеты', output.assetFileNames, `${ASSETS_DIRECTORY}/[hash][extname]`),
+    ...mismatch('клиентские чанки', fileNameOf(output.chunkFileNames, CHUNK_NAME), `${ASSETS_DIRECTORY}/[hash].js`),
+    ...mismatch('клиентский вход', fileNameOf(output.entryFileNames, CLIENT_ENTRY), `${ASSETS_DIRECTORY}/[hash].js`),
+];
+const serverOutputViolations = (output, serverEntries) => [
+    ...mismatch('серверные чанки', fileNameOf(output.chunkFileNames, CHUNK_NAME), '[hash].mjs'),
+    ...serverEntries.flatMap((entry) => mismatch(`серверный вход ${entry}`, fileNameOf(output.entryFileNames, entry), '[name].mjs')),
+];
+const listPublicAssets = async (rootDirectory) => {
+    try {
+        return await (0, promises_1.readdir)(node_path_1.default.join(rootDirectory, 'public', ASSETS_DIRECTORY));
+    }
+    catch {
+        return [];
+    }
+};
+const placementViolations = async ({ iconFile, indexHtmlFile, rootDirectory }, input) => {
+    const [html, iconPresent, publicAssets] = await Promise.all([
+        (0, promises_1.readFile)(node_path_1.default.join(rootDirectory, indexHtmlFile), 'utf8'),
+        isPresent(node_path_1.default.join(rootDirectory, iconFile)),
+        listPublicAssets(rootDirectory),
+    ]);
+    const iconHref = `href="./${ASSETS_DIRECTORY}/${node_path_1.default.basename(iconFile)}"`;
+    return [
+        ...mismatch('клиентский вход сборки', input, { [CLIENT_ENTRY]: node_path_1.default.join(rootDirectory, indexHtmlFile) }),
+        ...violationIf(!html.includes(iconHref), `${indexHtmlFile} не содержит ${iconHref}`),
+        ...violationIf(!iconPresent, `нет иконки ${iconFile}`),
+        ...publicAssets.map((file) => `нехешируемая статика под вечным кешем: public/${ASSETS_DIRECTORY}/${file}`),
+    ];
+};
+const assertStaticAssetsLayout = async (options) => {
+    const { clientModuleFile, rootDirectory, serverEntries, tsconfigBuildFile, viteConfigFile } = options;
+    const clientConfig = await loadBuildConfig(options, false);
+    const serverConfig = await loadBuildConfig(options, true);
+    const [clientModule, tsconfig, placement] = await Promise.all([
+        (0, promises_1.readFile)(node_path_1.default.join(rootDirectory, clientModuleFile), 'utf8'),
+        (0, promises_1.readFile)(node_path_1.default.join(rootDirectory, tsconfigBuildFile), 'utf8'),
+        placementViolations(options, buildOf(clientConfig).rolldownOptions?.input),
+    ]);
+    const violations = [
+        ...violationIf(clientModule.includes('useStaticAssets'), `${clientModuleFile} раздаёт статику приложением`),
+        ...clientOutputViolations(outputOf(clientConfig, viteConfigFile)),
+        ...serverOutputViolations(outputOf(serverConfig, viteConfigFile), serverEntries),
+        ...placement,
+        ...mismatch('карта клиентской сборки', buildOf(clientConfig).sourcemap, false),
+        ...mismatch('карта серверной сборки', buildOf(serverConfig).sourcemap, false),
+        ...violationIf(!tsconfig.includes('"sourceMap": false'), `${tsconfigBuildFile}: нужен "sourceMap": false`),
+    ];
+    if (violations.length > 0) {
+        throw new Error(`Гейт статики прод-сборки:\n${violations.join('\n')}`);
+    }
+};
+exports.assertStaticAssetsLayout = assertStaticAssetsLayout;

package/dist/cjs/static-assets-gate/index.d.ts

@@ -0,0 +1 @@
+export * from './assert-static-assets-layout.js';

package/dist/cjs/static-assets-gate/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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("./assert-static-assets-layout.js"), exports);

package/dist/esm/static-assets-gate/assert-static-assets-layout.d.ts

@@ -0,0 +1,10 @@
+export interface StaticAssetsLayoutOptionsInterface {
+    readonly clientModuleFile: string;
+    readonly iconFile: string;
+    readonly indexHtmlFile: string;
+    readonly rootDirectory: string;
+    readonly serverEntries: readonly string[];
+    readonly tsconfigBuildFile: string;
+    readonly viteConfigFile: string;
+}
+export declare const assertStaticAssetsLayout: (options: StaticAssetsLayoutOptionsInterface) => Promise<void>;

package/dist/esm/static-assets-gate/assert-static-assets-layout.js

@@ -0,0 +1,98 @@
+import { access, readdir, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { isDeepStrictEqual } from 'node:util';
+import { loadConfigFromFile } from 'vite';
+const ASSETS_DIRECTORY = 'assets';
+const CLIENT_ENTRY = `${ASSETS_DIRECTORY}/main`;
+const CHUNK_NAME = 'chunk';
+const isPresent = async (file) => {
+    try {
+        await access(file);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const loadBuildConfig = async ({ rootDirectory, viteConfigFile }, isSsrBuild) => {
+    const { argv } = process;
+    process.argv = isSsrBuild ? [...argv, '--ssr'] : argv;
+    try {
+        const loaded = await loadConfigFromFile({ command: 'build', isSsrBuild, mode: 'production' }, path.join(rootDirectory, viteConfigFile), rootDirectory, 'silent');
+        if (loaded === null) {
+            throw new Error(`${viteConfigFile} не найден`);
+        }
+        return loaded.config;
+    }
+    finally {
+        process.argv = argv;
+    }
+};
+const buildOf = (config) => config.build ?? {};
+const outputOf = (config, viteConfigFile) => {
+    const output = buildOf(config).rolldownOptions?.output;
+    if (output === undefined || Array.isArray(output)) {
+        throw new TypeError(`${viteConfigFile}: ожидается один набор output`);
+    }
+    return output;
+};
+const fileNameOf = (pattern, name) => (typeof pattern === 'function'
+    ? pattern({ exports: [], facadeModuleId: null, isDynamicEntry: false, isEntry: true, moduleIds: [], name })
+    : pattern);
+const violationIf = (isViolated, message) => (isViolated ? [message] : []);
+const mismatch = (what, actual, expected) => (isDeepStrictEqual(actual, expected)
+    ? []
+    : [`${what}: ${JSON.stringify(actual)}, ожидается ${JSON.stringify(expected)}`]);
+const clientOutputViolations = (output) => [
+    ...mismatch('клиентские ассеты', output.assetFileNames, `${ASSETS_DIRECTORY}/[hash][extname]`),
+    ...mismatch('клиентские чанки', fileNameOf(output.chunkFileNames, CHUNK_NAME), `${ASSETS_DIRECTORY}/[hash].js`),
+    ...mismatch('клиентский вход', fileNameOf(output.entryFileNames, CLIENT_ENTRY), `${ASSETS_DIRECTORY}/[hash].js`),
+];
+const serverOutputViolations = (output, serverEntries) => [
+    ...mismatch('серверные чанки', fileNameOf(output.chunkFileNames, CHUNK_NAME), '[hash].mjs'),
+    ...serverEntries.flatMap((entry) => mismatch(`серверный вход ${entry}`, fileNameOf(output.entryFileNames, entry), '[name].mjs')),
+];
+const listPublicAssets = async (rootDirectory) => {
+    try {
+        return await readdir(path.join(rootDirectory, 'public', ASSETS_DIRECTORY));
+    }
+    catch {
+        return [];
+    }
+};
+const placementViolations = async ({ iconFile, indexHtmlFile, rootDirectory }, input) => {
+    const [html, iconPresent, publicAssets] = await Promise.all([
+        readFile(path.join(rootDirectory, indexHtmlFile), 'utf8'),
+        isPresent(path.join(rootDirectory, iconFile)),
+        listPublicAssets(rootDirectory),
+    ]);
+    const iconHref = `href="./${ASSETS_DIRECTORY}/${path.basename(iconFile)}"`;
+    return [
+        ...mismatch('клиентский вход сборки', input, { [CLIENT_ENTRY]: path.join(rootDirectory, indexHtmlFile) }),
+        ...violationIf(!html.includes(iconHref), `${indexHtmlFile} не содержит ${iconHref}`),
+        ...violationIf(!iconPresent, `нет иконки ${iconFile}`),
+        ...publicAssets.map((file) => `нехешируемая статика под вечным кешем: public/${ASSETS_DIRECTORY}/${file}`),
+    ];
+};
+export const assertStaticAssetsLayout = async (options) => {
+    const { clientModuleFile, rootDirectory, serverEntries, tsconfigBuildFile, viteConfigFile } = options;
+    const clientConfig = await loadBuildConfig(options, false);
+    const serverConfig = await loadBuildConfig(options, true);
+    const [clientModule, tsconfig, placement] = await Promise.all([
+        readFile(path.join(rootDirectory, clientModuleFile), 'utf8'),
+        readFile(path.join(rootDirectory, tsconfigBuildFile), 'utf8'),
+        placementViolations(options, buildOf(clientConfig).rolldownOptions?.input),
+    ]);
+    const violations = [
+        ...violationIf(clientModule.includes('useStaticAssets'), `${clientModuleFile} раздаёт статику приложением`),
+        ...clientOutputViolations(outputOf(clientConfig, viteConfigFile)),
+        ...serverOutputViolations(outputOf(serverConfig, viteConfigFile), serverEntries),
+        ...placement,
+        ...mismatch('карта клиентской сборки', buildOf(clientConfig).sourcemap, false),
+        ...mismatch('карта серверной сборки', buildOf(serverConfig).sourcemap, false),
+        ...violationIf(!tsconfig.includes('"sourceMap": false'), `${tsconfigBuildFile}: нужен "sourceMap": false`),
+    ];
+    if (violations.length > 0) {
+        throw new Error(`Гейт статики прод-сборки:\n${violations.join('\n')}`);
+    }
+};

package/dist/esm/static-assets-gate/index.d.ts

@@ -0,0 +1 @@
+export * from './assert-static-assets-layout.js';

package/dist/esm/static-assets-gate/index.js

@@ -0,0 +1 @@
+export * from './assert-static-assets-layout.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@application-kit/nestjs-vite",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Мост Vite ↔ NestJS для SSR: dev-обвязка, загрузка HTML и ssr-entry",
   "keywords": [
     "nestjs",
@@ -32,6 +32,16 @@
       }
     },
     "./package.json": "./package.json",
+    "./static-assets-gate": {
+      "import": {
+        "types": "./dist/esm/static-assets-gate/index.d.ts",
+        "default": "./dist/esm/static-assets-gate/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/static-assets-gate/index.d.ts",
+        "default": "./dist/cjs/static-assets-gate/index.js"
+      }
+    },
     "./testing": {
       "import": {
         "types": "./dist/esm/testing/index.d.ts",
@@ -60,7 +70,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "rm -rf ./dist && node ../../scripts/barrels.mjs create ./src --entry-only=testing && tsc --project tsconfig.build.json && tsc --project tsconfig.build.cjs.json && node ../../scripts/barrels.mjs clean ./src && node ../../scripts/mark-cjs.mjs ./dist/cjs",
+    "build": "rm -rf ./dist && node ../../scripts/barrels.mjs create ./src --entry-only=static-assets-gate,testing && tsc --project tsconfig.build.json && tsc --project tsconfig.build.cjs.json && node ../../scripts/barrels.mjs clean ./src && node ../../scripts/mark-cjs.mjs ./dist/cjs",
     "lint:tsc": "tsc --noEmit --pretty --project .",
     "test:mutation": "stryker run",
     "test:unit": "vitest run"