refactor: enforce enum machine codes #18

Use owner enums for known codes; preserve wire values and unknown fallbacks.

Verified npm ci and verify: 379 tests, 5 lint checks, app and Storybook builds.

src/features/instrument-details/model/useInstrumentOperations.ts

@@ -6,7 +6,7 @@ import {
 	type OperationCategory,
 	useBrokerageOperations,
 } from "@/entities/broker-operation";
-import { apiErrorCode } from "@/shared/api";
+import { ApiErrorCode, apiErrorCode, isApiErrorCode } from "@/shared/api";
 
 function useInstrumentOperations(
 	uid: string,
@@ -26,7 +26,7 @@ function useInstrumentOperations(
 		cursor: cursors.at(-1),
 	});
 	const retry = (retryScreen: () => unknown) => {
-		if (apiErrorCode(operations.error) === "INVALID_OPERATIONS_CURSOR") {
+		if (isApiErrorCode(apiErrorCode(operations.error), ApiErrorCode.InvalidOperationsCursor)) {
 			setPagination({ cursors: [], scope });
 			void client.invalidateQueries({
 				exact: true,

src/features/tbank-connection/model/screen-sync.ts

@@ -2,9 +2,11 @@ import { type QueryKey, useQueryClient } from "@tanstack/react-query";
 import { useEffect, useLayoutEffect, useRef, useState } from "react";
 
 import {
+	ApiErrorCode,
 	apiErrorCode,
 	apiQueryClient,
 	invalidateResourceAccess,
+	isApiErrorCode,
 	type paths,
 	useAuthenticatedQueries,
 } from "@/shared/api";
@@ -112,7 +114,7 @@ function useScreenSync(scope: InvestmentScreen, resources: ScreenResource[]) {
 			}
 
 			deniedRef.current.add(status.error);
-			if (apiErrorCode(status.error) !== "NOT_FOUND")
+			if (!isApiErrorCode(apiErrorCode(status.error), ApiErrorCode.NotFound))
 				invalidateResourceAccess(client, "brokerage", status.error);
 		}
 		const latest = new Map<string, ResourceMeta>();

src/features/tbank-connection/ui/TbankConnectionSection/TbankConnectionSectionLoaded.tsx

@@ -13,13 +13,15 @@ import { useEffect, useRef, useState } from "react";
 import { useForm } from "react-hook-form";
 import { useTranslation } from "react-i18next";
 
-import { apiErrorCode, apiQueryClient } from "@/shared/api";
+import { ApiErrorCode, apiErrorCode, apiQueryClient, isApiErrorCode } from "@/shared/api";
 
 import {
 	commitTbankConnectionBoundary,
 	type TbankConnectionStatus,
 } from "../../model/connection-boundary";
 
+enum ConnectionErrorCode { RequestFailed = "REQUEST_ERROR" }
+
 type TbankConnectionSectionLoadedProps = {
 	refreshError: boolean;
 	refreshing: boolean;
@@ -43,7 +45,7 @@ const TbankConnectionSectionLoaded: FC<TbankConnectionSectionLoadedProps> = (
 		reset,
 	} = useForm<{ token: string }>();
 	const update = apiQueryClient.useMutation("put", "/api/v1/tbank-connection", {
-		onError: error => setRequestError(apiErrorCode(error) ?? "REQUEST_ERROR"),
+		onError: error => setRequestError(apiErrorCode(error) ?? ConnectionErrorCode.RequestFailed),
 		onSuccess: (data) => {
 			commitTbankConnectionBoundary(queryClient, data);
 			reset();
@@ -62,7 +64,7 @@ const TbankConnectionSectionLoaded: FC<TbankConnectionSectionLoadedProps> = (
 			},
 		},
 	);
-	const unavailableMessage = requestError === "TBANK_UNAVAILABLE" ? "tbank.unavailable" : "tbank.requestError";
+	const unavailableMessage = isApiErrorCode(requestError, ApiErrorCode.TbankUnavailable) ? "tbank.unavailable" : "tbank.requestError";
 	const isPending = update.isPending || remove.isPending;
 	const isConnected = status.connected;
 	useEffect(() => {
@@ -119,7 +121,7 @@ const TbankConnectionSectionLoaded: FC<TbankConnectionSectionLoadedProps> = (
 						{requestError && (
 							<Alert color="red">
 								{t(
-									requestError === "INVALID_TBANK_TOKEN"
+									isApiErrorCode(requestError, ApiErrorCode.InvalidTbankToken)
 										? "tbank.invalidToken"
 										: unavailableMessage,
 								)}