@application-kit/graphql 0.6.0 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @application-kit/graphql
 
+## 0.8.0
+
+### Minor Changes
+
+- 3a2f7ed: `graphql`: класс аргументов листинга `Payload` (`@ArgsType`) переименован в `ListingArgs` — имя говорит, чьи это аргументы.
+  **Ломающее:** потребителю — заменить импорт и тип `Payload` на `ListingArgs`; схема GraphQL не меняется, имя класса в неё не попадает.
+
+  `audit-log`: резолвер `auditRecords` принимает `ListingArgs`.
+- 79a405c: `graphql/nest`: `GraphqlRootModule.forRoot({ maxDepth, resolveSupportId, schemaPath })` — корень GraphQL на процесс.
+  Регистрирует `GraphqlConfig` с `GraphqlEnvironment` и поднимает `GraphQLModule` на `MercuriusDriver`: приложению не нужно
+  собирать `GraphQLModule.forRootAsync` и регистрировать конфиг самому.
+
+### Patch Changes
+
+- Updated dependencies [c5a41d7]
+  - @application-kit/typeorm@0.5.2
+
+## 0.7.0
+
+### Minor Changes
+
+- 06ce168: Клиентские части обработки ошибки запроса и кнопка темы переехали в пакеты.
+
+  `ui`: очередь страховочного тоста `globalErrorToast` и её подключение `useGlobalErrorToastConnection(translate)`, `withSupportId`, стор страницы ошибки `useErrorStore`, переключатель темы `LayoutTopbarThemeSwitcher`, встроенные иконки `moon` и `sun`. Колбэк `describeRequestError` у `UiVendorPlugin` получает третьим аргументом тексты пакета текущей локали. Ломающее: в `messages` обязательны `layout.topbar.toggleTheme` и группа `requestError` (`supportIdLine`, `title`, `unexpected`); у `LayoutTopbarIconButton` и `LayoutTopbarSubmenu` обязателен `label` — доступное имя кнопки; приложение убирает `moon` и `sun` из своего реестра иконок.
+
+  `graphql`: `createBusinessMessageKeyResolver` в `/client` — резолвер «ошибка запроса → ключ словаря» по таблице приложения, типизированной реестром кодов.
+
 ## 0.6.0
 
 ### Minor Changes

package/README.md

@@ -32,7 +32,7 @@ Peer-зависимости: `@nestjs/common`, `@nestjs/graphql`, `class-transfo
 - `matchBusinessError(table, fallback)` — таблица «класс доменной ошибки → опции ответа», первая подходящая строка.
 - `formatGraphQLError(error, supportId)` — единая точка форматирования: `HttpException` → `extensions`,
   техническая ошибка получает `supportId`, бизнесовая — нет (`isBusinessGraphQLError`).
-- Типы листинга: `Payload` (`@ArgsType`), `PaginatorInputType` (потолок `limit` 200), `FilterInputType`,
+- Типы листинга: `ListingArguments` (`@ArgsType`), `PaginatorInputType` (потолок `limit` 200), `FilterInputType`,
   `SortingInputType`, `CursorOutputType`, `ListingResponseInterface`.
 
 ### Словарь кодов сообщений — у приложения
@@ -56,6 +56,8 @@ declare module '@application-kit/graphql' {
   `HttpLink` как есть. `onError(error)` зовётся на каждую ошибку операции, кроме помеченных флагом
   `SKIP_GLOBAL_ERROR_TOAST` в контексте: их показывает сам вызывающий. Вызывающий получает ошибку в любом случае.
 - `requireApolloData(result)` — данные ответа query; `undefined` вместо них — ошибка транспорта.
+- `createBusinessMessageKeyResolver(keyByCode)` — резолвер «ошибка запроса → ключ словаря». Таблица — приложения, тип `Record`
+  по реестру кодов: новый код без ключа не компилируется. Незнакомый код и ответ без кода дают `null`.
 
 ```ts
 export const apolloClient = createApolloClient({
@@ -74,16 +76,15 @@ export const apolloClient = createApolloClient({
   Пустой `schemaPath` — схема только в памяти.
 - `GraphqlEnvironment` — `GRAPHQL_PLAYGROUND` (дефолт `false`) и необязательный `GRAPHQL_SCHEMA_PATH`;
   `GraphqlConfig.createOptions({ schemaPath, maxDepth, resolveSupportId })` берёт флаг консоли из окружения, путь —
-  из окружения, если он задан, иначе из вызова. Регистрацию делает приложение:
+  из окружения, если он задан, иначе из вызова.
+- `GraphqlRootModule.forRoot({ maxDepth, resolveSupportId, schemaPath })` — корень GraphQL на процесс: регистрирует
+  `GraphqlConfig` с `GraphqlEnvironment` и поднимает `GraphQLModule` на `MercuriusDriver` с опциями `createOptions`:
 
 ```ts
-ConfigsModule.forFeature([GraphqlConfig], [GraphqlEnvironment])
-
-GraphQLModule.forRootAsync({
-  driver: MercuriusDriver,
-  inject: [GraphqlConfig],
-  useFactory: (config: GraphqlConfig) => config.createOptions({ maxDepth: 5, resolveSupportId, schemaPath: 'src/schema.gql' }),
+@Module({
+  imports: [GraphqlRootModule.forRoot({ maxDepth: 5, resolveSupportId, schemaPath: 'src/schema.gql' })],
 })
+export class WebModule {}
 ```
 
 Источник `supportId` (трасса, id запроса) пакет не выбирает: резолвер передаёт приложение.

package/dist/cjs/client/business-message-key-resolver.d.ts

@@ -0,0 +1,2 @@
+import type { BusinessMessageCode } from '../contract/business-message-code.js';
+export declare const createBusinessMessageKeyResolver: (keyByCode: Readonly<Record<BusinessMessageCode, string>>) => (error: unknown) => null | string;

package/dist/cjs/client/business-message-key-resolver.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBusinessMessageKeyResolver = void 0;
+const message_code_from_error_js_1 = require("./message-code-from-error.js");
+const createBusinessMessageKeyResolver = (keyByCode) => {
+    const keys = new Map(Object.entries(keyByCode));
+    return (error) => {
+        const code = (0, message_code_from_error_js_1.messageCodeFromError)(error);
+        return code === null ? null : keys.get(code) ?? null;
+    };
+};
+exports.createBusinessMessageKeyResolver = createBusinessMessageKeyResolver;

package/dist/cjs/client/index.d.ts

@@ -1,3 +1,4 @@
+export * from './business-message-key-resolver.js';
 export * from './create-apollo-client.js';
 export * from './message-code-from-error.js';
 export * from './rejected-characters-from-error.js';

package/dist/cjs/client/index.js

@@ -14,6 +14,7 @@ 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("./business-message-key-resolver.js"), exports);
 __exportStar(require("./create-apollo-client.js"), exports);
 __exportStar(require("./message-code-from-error.js"), exports);
 __exportStar(require("./rejected-characters-from-error.js"), exports);

package/dist/cjs/listing/index.d.ts

@@ -1,7 +1,7 @@
 export * from './cursor-output.type.js';
 export * from './cursor-type.interface.js';
 export * from './filter-input.type.js';
-export * from './listing-payload.js';
+export * from './listing-arguments.js';
 export * from './listing-response.interface.js';
 export * from './paginator-input.type.js';
 export * from './sorting-input.type.js';

package/dist/cjs/listing/index.js

@@ -17,7 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./cursor-output.type.js"), exports);
 __exportStar(require("./cursor-type.interface.js"), exports);
 __exportStar(require("./filter-input.type.js"), exports);
-__exportStar(require("./listing-payload.js"), exports);
+__exportStar(require("./listing-arguments.js"), exports);
 __exportStar(require("./listing-response.interface.js"), exports);
 __exportStar(require("./paginator-input.type.js"), exports);
 __exportStar(require("./sorting-input.type.js"), exports);

package/dist/cjs/listing/{listing-payload.d.ts → listing-arguments.d.ts}

@@ -1,7 +1,7 @@
 import { FilterInputType } from './filter-input.type.js';
 import { PaginatorInputType } from './paginator-input.type.js';
 import { SortingInputType } from './sorting-input.type.js';
-export declare class Payload {
+export declare class ListingArguments {
     filters?: FilterInputType[];
     paginator: PaginatorInputType;
     sorting?: SortingInputType[];

package/dist/cjs/listing/{listing-payload.js → listing-arguments.js}

@@ -9,33 +9,33 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Payload = void 0;
+exports.ListingArguments = void 0;
 const graphql_1 = require("@nestjs/graphql");
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const filter_input_type_js_1 = require("./filter-input.type.js");
 const paginator_input_type_js_1 = require("./paginator-input.type.js");
 const sorting_input_type_js_1 = require("./sorting-input.type.js");
-let Payload = class Payload {
+let ListingArguments = class ListingArguments {
     filters = [];
     paginator = new paginator_input_type_js_1.PaginatorInputType();
     sorting = [];
 };
-exports.Payload = Payload;
+exports.ListingArguments = ListingArguments;
 __decorate([
     (0, graphql_1.Field)(() => [filter_input_type_js_1.FilterInputType], { nullable: true }),
     __metadata("design:type", Array)
-], Payload.prototype, "filters", void 0);
+], ListingArguments.prototype, "filters", void 0);
 __decorate([
     (0, graphql_1.Field)(() => paginator_input_type_js_1.PaginatorInputType, { nullable: true }),
     (0, class_transformer_1.Type)(() => paginator_input_type_js_1.PaginatorInputType),
     (0, class_validator_1.ValidateNested)(),
     __metadata("design:type", paginator_input_type_js_1.PaginatorInputType)
-], Payload.prototype, "paginator", void 0);
+], ListingArguments.prototype, "paginator", void 0);
 __decorate([
     (0, graphql_1.Field)(() => [sorting_input_type_js_1.SortingInputType], { nullable: true }),
     __metadata("design:type", Array)
-], Payload.prototype, "sorting", void 0);
-exports.Payload = Payload = __decorate([
+], ListingArguments.prototype, "sorting", void 0);
+exports.ListingArguments = ListingArguments = __decorate([
     (0, graphql_1.ArgsType)()
-], Payload);
+], ListingArguments);

package/dist/cjs/nest/graphql-root.module.d.ts

@@ -0,0 +1,5 @@
+import type { DynamicModule } from '@nestjs/common';
+import type { GraphqlConfigOptionsInterface } from './mercurius-options.interface.js';
+export declare class GraphqlRootModule {
+    static forRoot(options: GraphqlConfigOptionsInterface): DynamicModule;
+}

package/dist/cjs/nest/graphql-root.module.js

@@ -0,0 +1,34 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    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;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphqlRootModule = void 0;
+const nestjs_config_module_1 = require("@libs-for-dev/nestjs-config-module");
+const common_1 = require("@nestjs/common");
+const graphql_1 = require("@nestjs/graphql");
+const mercurius_1 = require("@nestjs/mercurius");
+const graphql_config_js_1 = require("./graphql.config.js");
+const graphql_environment_js_1 = require("./graphql.environment.js");
+let GraphqlRootModule = class GraphqlRootModule {
+    static forRoot(options) {
+        return {
+            imports: [
+                graphql_1.GraphQLModule.forRootAsync({
+                    driver: mercurius_1.MercuriusDriver,
+                    imports: [nestjs_config_module_1.ConfigsModule.forFeature([graphql_config_js_1.GraphqlConfig], [graphql_environment_js_1.GraphqlEnvironment])],
+                    inject: [graphql_config_js_1.GraphqlConfig],
+                    useFactory: (config) => config.createOptions(options),
+                }),
+            ],
+            module: this,
+        };
+    }
+};
+exports.GraphqlRootModule = GraphqlRootModule;
+exports.GraphqlRootModule = GraphqlRootModule = __decorate([
+    (0, common_1.Module)({})
+], GraphqlRootModule);

package/dist/cjs/nest/index.d.ts

@@ -1,3 +1,4 @@
+export * from './graphql-root.module.js';
 export * from './graphql.config.js';
 export * from './graphql.environment.js';
 export * from './mercurius-options.js';

package/dist/cjs/nest/index.js

@@ -14,6 +14,7 @@ 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("./graphql-root.module.js"), exports);
 __exportStar(require("./graphql.config.js"), exports);
 __exportStar(require("./graphql.environment.js"), exports);
 __exportStar(require("./mercurius-options.js"), exports);

package/dist/esm/client/business-message-key-resolver.d.ts

@@ -0,0 +1,2 @@
+import type { BusinessMessageCode } from '../contract/business-message-code.js';
+export declare const createBusinessMessageKeyResolver: (keyByCode: Readonly<Record<BusinessMessageCode, string>>) => (error: unknown) => null | string;

package/dist/esm/client/business-message-key-resolver.js

@@ -0,0 +1,8 @@
+import { messageCodeFromError } from './message-code-from-error.js';
+export const createBusinessMessageKeyResolver = (keyByCode) => {
+    const keys = new Map(Object.entries(keyByCode));
+    return (error) => {
+        const code = messageCodeFromError(error);
+        return code === null ? null : keys.get(code) ?? null;
+    };
+};

package/dist/esm/client/index.d.ts

@@ -1,3 +1,4 @@
+export * from './business-message-key-resolver.js';
 export * from './create-apollo-client.js';
 export * from './message-code-from-error.js';
 export * from './rejected-characters-from-error.js';

package/dist/esm/client/index.js

@@ -1,3 +1,4 @@
+export * from './business-message-key-resolver.js';
 export * from './create-apollo-client.js';
 export * from './message-code-from-error.js';
 export * from './rejected-characters-from-error.js';

package/dist/esm/listing/index.d.ts

@@ -1,7 +1,7 @@
 export * from './cursor-output.type.js';
 export * from './cursor-type.interface.js';
 export * from './filter-input.type.js';
-export * from './listing-payload.js';
+export * from './listing-arguments.js';
 export * from './listing-response.interface.js';
 export * from './paginator-input.type.js';
 export * from './sorting-input.type.js';

package/dist/esm/listing/index.js

@@ -1,7 +1,7 @@
 export * from './cursor-output.type.js';
 export * from './cursor-type.interface.js';
 export * from './filter-input.type.js';
-export * from './listing-payload.js';
+export * from './listing-arguments.js';
 export * from './listing-response.interface.js';
 export * from './paginator-input.type.js';
 export * from './sorting-input.type.js';

package/dist/esm/listing/{listing-payload.d.ts → listing-arguments.d.ts}

@@ -1,7 +1,7 @@
 import { FilterInputType } from './filter-input.type.js';
 import { PaginatorInputType } from './paginator-input.type.js';
 import { SortingInputType } from './sorting-input.type.js';
-export declare class Payload {
+export declare class ListingArguments {
     filters?: FilterInputType[];
     paginator: PaginatorInputType;
     sorting?: SortingInputType[];

package/dist/esm/listing/{listing-payload.js → listing-arguments.js}

@@ -13,7 +13,7 @@ import { ValidateNested } from 'class-validator';
 import { FilterInputType } from './filter-input.type.js';
 import { PaginatorInputType } from './paginator-input.type.js';
 import { SortingInputType } from './sorting-input.type.js';
-let Payload = class Payload {
+let ListingArguments = class ListingArguments {
     filters = [];
     paginator = new PaginatorInputType();
     sorting = [];
@@ -21,18 +21,18 @@ let Payload = class Payload {
 __decorate([
     Field(() => [FilterInputType], { nullable: true }),
     __metadata("design:type", Array)
-], Payload.prototype, "filters", void 0);
+], ListingArguments.prototype, "filters", void 0);
 __decorate([
     Field(() => PaginatorInputType, { nullable: true }),
     Type(() => PaginatorInputType),
     ValidateNested(),
     __metadata("design:type", PaginatorInputType)
-], Payload.prototype, "paginator", void 0);
+], ListingArguments.prototype, "paginator", void 0);
 __decorate([
     Field(() => [SortingInputType], { nullable: true }),
     __metadata("design:type", Array)
-], Payload.prototype, "sorting", void 0);
-Payload = __decorate([
+], ListingArguments.prototype, "sorting", void 0);
+ListingArguments = __decorate([
     ArgsType()
-], Payload);
-export { Payload };
+], ListingArguments);
+export { ListingArguments };

package/dist/esm/nest/graphql-root.module.d.ts

@@ -0,0 +1,5 @@
+import type { DynamicModule } from '@nestjs/common';
+import type { GraphqlConfigOptionsInterface } from './mercurius-options.interface.js';
+export declare class GraphqlRootModule {
+    static forRoot(options: GraphqlConfigOptionsInterface): DynamicModule;
+}

package/dist/esm/nest/graphql-root.module.js

@@ -0,0 +1,31 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    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;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { ConfigsModule } from '@libs-for-dev/nestjs-config-module';
+import { Module } from '@nestjs/common';
+import { GraphQLModule } from '@nestjs/graphql';
+import { MercuriusDriver } from '@nestjs/mercurius';
+import { GraphqlConfig } from './graphql.config.js';
+import { GraphqlEnvironment } from './graphql.environment.js';
+let GraphqlRootModule = class GraphqlRootModule {
+    static forRoot(options) {
+        return {
+            imports: [
+                GraphQLModule.forRootAsync({
+                    driver: MercuriusDriver,
+                    imports: [ConfigsModule.forFeature([GraphqlConfig], [GraphqlEnvironment])],
+                    inject: [GraphqlConfig],
+                    useFactory: (config) => config.createOptions(options),
+                }),
+            ],
+            module: this,
+        };
+    }
+};
+GraphqlRootModule = __decorate([
+    Module({})
+], GraphqlRootModule);
+export { GraphqlRootModule };

package/dist/esm/nest/index.d.ts

@@ -1,3 +1,4 @@
+export * from './graphql-root.module.js';
 export * from './graphql.config.js';
 export * from './graphql.environment.js';
 export * from './mercurius-options.js';

package/dist/esm/nest/index.js

@@ -1,3 +1,4 @@
+export * from './graphql-root.module.js';
 export * from './graphql.config.js';
 export * from './graphql.environment.js';
 export * from './mercurius-options.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@application-kit/graphql",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "Контракт ошибок GraphQL (сервер и клиент) и типы курсорного листинга для NestJS",
   "keywords": [
     "apollo",
@@ -80,7 +80,7 @@
     "test:unit": "vitest run"
   },
   "dependencies": {
-    "@application-kit/typeorm": "^0.5.1"
+    "@application-kit/typeorm": "^0.5.2"
   },
   "devDependencies": {
     "@apollo/client": "^4.2.12",
@@ -89,6 +89,8 @@
     "@nestjs/core": "^11.2.7",
     "@nestjs/graphql": "^13.4.5",
     "@nestjs/mercurius": "^13.4.5",
+    "@nestjs/platform-fastify": "^11.2.7",
+    "@nestjs/testing": "^11.2.7",
     "@stryker-mutator/core": "^10.0.0",
     "@stryker-mutator/vitest-runner": "^10.0.0",
     "@types/node": "^26.2.0",