@application-kit/graphql 0.5.0 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @application-kit/graphql
 
+## 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
+
+- abb4a67: Реестр кодов сообщений `BusinessMessageCodeRegistryInterface` и тип `BusinessMessageCode`: приложение объявляет коды через `declare module '@application-kit/graphql'`.
+  **Ломающее:** параметр типа у `BusinessGraphQLError` и `BusinessErrorOptionsInterface` снят, `BusinessErrorTable` получил значение параметра по умолчанию. Потребителю — записать коды в реестр и удалить свои привязки параметра; без записи тип кода `never`, и `new BusinessGraphQLError` не компилируется.
+
 ## 0.5.0
 
 ### Minor Changes

package/README.md

@@ -27,7 +27,7 @@ Peer-зависимости: `@nestjs/common`, `@nestjs/graphql`, `class-transfo
 
 ## Сервер
 
-- `BusinessGraphQLError<TMessageCode>` — бизнес-ошибка с транспортным кодом (`BAD_USER_INPUT`, `FORBIDDEN`,
+- `BusinessGraphQLError` — бизнес-ошибка с транспортным кодом (`BAD_USER_INPUT`, `FORBIDDEN`,
   `NOT_FOUND`) и кодом показываемого текста `messageCode`.
 - `matchBusinessError(table, fallback)` — таблица «класс доменной ошибки → опции ответа», первая подходящая строка.
 - `formatGraphQLError(error, supportId)` — единая точка форматирования: `HttpException` → `extensions`,
@@ -37,14 +37,17 @@ Peer-зависимости: `@nestjs/common`, `@nestjs/graphql`, `class-transfo
 
 ### Словарь кодов сообщений — у приложения
 
-Пакет не знает кодов сообщений: тип кода — параметр без значения по умолчанию. Приложение один раз связывает его
-со своим объединением, и неизвестный код перестаёт компилироваться:
+Пакет не знает кодов сообщений: реестр `BusinessMessageCodeRegistryInterface` пуст, и без записи приложения тип кода —
+`never`. Приложение объявляет коды один раз, и неизвестный код перестаёт компилироваться в `BusinessGraphQLError`,
+`BusinessErrorOptionsInterface` и `BusinessErrorTable`:
 
 ```ts
-type MessageCode = 'signIn.invalidCredentials' | 'profile.notFound'
-
-export class BusinessGraphQLError extends BaseBusinessGraphQLError<MessageCode> {}
-export type BusinessErrorOptions = BusinessErrorOptionsInterface<MessageCode>
+declare module '@application-kit/graphql' {
+  interface BusinessMessageCodeRegistryInterface {
+    'profile.notFound': true
+    'signIn.invalidCredentials': true
+  }
+}
 ```
 
 ## Клиент (`/client`)
@@ -53,6 +56,8 @@ export type BusinessErrorOptions = BusinessErrorOptionsInterface<MessageCode>
   `HttpLink` как есть. `onError(error)` зовётся на каждую ошибку операции, кроме помеченных флагом
   `SKIP_GLOBAL_ERROR_TOAST` в контексте: их показывает сам вызывающий. Вызывающий получает ошибку в любом случае.
 - `requireApolloData(result)` — данные ответа query; `undefined` вместо них — ошибка транспорта.
+- `createBusinessMessageKeyResolver(keyByCode)` — резолвер «ошибка запроса → ключ словаря». Таблица — приложения, тип `Record`
+  по реестру кодов: новый код без ключа не компилируется. Незнакомый код и ответ без кода дают `null`.
 
 ```ts
 export const apolloClient = createApolloClient({

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/contract/business-message-code.d.ts

@@ -0,0 +1,3 @@
+export type BusinessMessageCode = keyof BusinessMessageCodeRegistryInterface;
+export interface BusinessMessageCodeRegistryInterface {
+}

package/dist/cjs/contract/business-message-code.js

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

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

@@ -1 +1,2 @@
+export * from './business-message-code.js';
 export * from './graphql-error-contract.js';

package/dist/cjs/contract/index.js

@@ -14,4 +14,5 @@ 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-code.js"), exports);
 __exportStar(require("./graphql-error-contract.js"), exports);

package/dist/cjs/errors/business-graphql-error.d.ts

@@ -1,5 +1,6 @@
 import { GraphQLError } from 'graphql';
+import type { BusinessMessageCode } from '../contract/business-message-code.js';
 import type { BusinessGraphQLErrorCode, GraphQLErrorWireExtensions } from '../contract/graphql-error-contract.js';
-export declare class BusinessGraphQLError<TMessageCode extends string> extends GraphQLError {
-    constructor(message: string, code: BusinessGraphQLErrorCode, messageCode: TMessageCode, extensions?: GraphQLErrorWireExtensions);
+export declare class BusinessGraphQLError extends GraphQLError {
+    constructor(message: string, code: BusinessGraphQLErrorCode, messageCode: BusinessMessageCode, extensions?: GraphQLErrorWireExtensions);
 }

package/dist/cjs/errors/match-business-error.d.ts

@@ -1,7 +1,8 @@
+import type { BusinessMessageCode } from '../contract/business-message-code.js';
 import type { BusinessGraphQLErrorCode } from '../contract/graphql-error-contract.js';
-export interface BusinessErrorOptionsInterface<TMessageCode extends string> {
+export interface BusinessErrorOptionsInterface {
     code: BusinessGraphQLErrorCode;
-    messageCode: TMessageCode;
+    messageCode: BusinessMessageCode;
 }
-export type BusinessErrorTable<TOptions> = readonly [new (...arguments_: never[]) => Error, TOptions][];
+export type BusinessErrorTable<TOptions = BusinessErrorOptionsInterface> = readonly [new (...arguments_: never[]) => Error, TOptions][];
 export declare const matchBusinessError: <TOptions>(table: BusinessErrorTable<TOptions>, fallback: TOptions) => (commandError: Error) => TOptions;

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/contract/business-message-code.d.ts

@@ -0,0 +1,3 @@
+export type BusinessMessageCode = keyof BusinessMessageCodeRegistryInterface;
+export interface BusinessMessageCodeRegistryInterface {
+}

package/dist/esm/contract/business-message-code.js

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

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

@@ -1 +1,2 @@
+export * from './business-message-code.js';
 export * from './graphql-error-contract.js';

package/dist/esm/contract/index.js

@@ -1 +1,2 @@
+export * from './business-message-code.js';
 export * from './graphql-error-contract.js';

package/dist/esm/errors/business-graphql-error.d.ts

@@ -1,5 +1,6 @@
 import { GraphQLError } from 'graphql';
+import type { BusinessMessageCode } from '../contract/business-message-code.js';
 import type { BusinessGraphQLErrorCode, GraphQLErrorWireExtensions } from '../contract/graphql-error-contract.js';
-export declare class BusinessGraphQLError<TMessageCode extends string> extends GraphQLError {
-    constructor(message: string, code: BusinessGraphQLErrorCode, messageCode: TMessageCode, extensions?: GraphQLErrorWireExtensions);
+export declare class BusinessGraphQLError extends GraphQLError {
+    constructor(message: string, code: BusinessGraphQLErrorCode, messageCode: BusinessMessageCode, extensions?: GraphQLErrorWireExtensions);
 }

package/dist/esm/errors/match-business-error.d.ts

@@ -1,7 +1,8 @@
+import type { BusinessMessageCode } from '../contract/business-message-code.js';
 import type { BusinessGraphQLErrorCode } from '../contract/graphql-error-contract.js';
-export interface BusinessErrorOptionsInterface<TMessageCode extends string> {
+export interface BusinessErrorOptionsInterface {
     code: BusinessGraphQLErrorCode;
-    messageCode: TMessageCode;
+    messageCode: BusinessMessageCode;
 }
-export type BusinessErrorTable<TOptions> = readonly [new (...arguments_: never[]) => Error, TOptions][];
+export type BusinessErrorTable<TOptions = BusinessErrorOptionsInterface> = readonly [new (...arguments_: never[]) => Error, TOptions][];
 export declare const matchBusinessError: <TOptions>(table: BusinessErrorTable<TOptions>, fallback: TOptions) => (commandError: Error) => TOptions;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@application-kit/graphql",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Контракт ошибок GraphQL (сервер и клиент) и типы курсорного листинга для NestJS",
   "keywords": [
     "apollo",