poc(RI-8216): extract array index util into a shared UI/API location

Proves out a single in-repo location for code consumed by both the UI and
the API: the source lives at api/src/ri-shared/ (inside the api compile
root, because nest build's tsc rootDir inference restructures dist/ when
sources live outside it, breaking node dist/src/main and the desktop
packaging) and the UI reaches it through a bare riShared/* alias, the same
pattern as apiClient. The mirrored array-index helpers collapse into one
module with one spec; gatekeeping rules live in ri-shared/README.md.

References: #RI-8216

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: VaskoAtanasovRedis

.storybook/vite.config.ts

@@ -46,6 +46,9 @@ export default defineConfig({
       apiClient: fileURLToPath(
         new URL('../redisinsight/api-client', import.meta.url),
       ),
+      'riShared': fileURLToPath(
+        new URL('../redisinsight/api/src/ri-shared', import.meta.url),
+      ),
     },
   },
   server: {

jest.config.cjs

@@ -16,6 +16,7 @@ module.exports = {
     'uiSrc/(.*)': '<rootDir>/redisinsight/ui/src/$1',
     '^apiClient$': '<rootDir>/redisinsight/api-client',
     'apiClient/(.*)': '<rootDir>/redisinsight/api-client/$1',
+    '^riShared/(.*)$': '<rootDir>/redisinsight/api/src/ri-shared/$1',
     '@redislabsdev/redis-ui-components': '@redis-ui/components',
     '@redislabsdev/redis-ui-styles': '@redis-ui/styles',
     '@redislabsdev/redis-ui-icons': '@redis-ui/icons',

redisinsight/api/src/common/utils/index.ts

@@ -1,4 +1,4 @@
-export * from './array-index.helper';
+export * from '../../ri-shared/utils/array-index';
 export * from './certificate-import.util';
 export * from './errors.util';
 export * from './merge.util';

redisinsight/api/src/common/validators/array-index.validator.ts

@@ -3,10 +3,7 @@ import {
   ValidatorConstraint,
   ValidatorConstraintInterface,
 } from 'class-validator';
-import {
-  ARRAY_INDEX_MAX,
-  parseArrayIndex,
-} from 'src/common/utils/array-index.helper';
+import { ARRAY_INDEX_MAX, parseArrayIndex } from 'src/common/utils';
 
 @ValidatorConstraint({ name: 'ArrayIndexValidator', async: false })
 export class ArrayIndexValidator implements ValidatorConstraintInterface {

redisinsight/api/src/ri-shared/README.md

@@ -0,0 +1,32 @@
+# ri-shared — code shared across the RedisInsight apps (API + UI)
+
+Modules here are consumed by **both** the API (relative imports, e.g.
+`src/ri-shared/utils/array-index`) and the UI (the `riShared/*` path alias). They live
+inside `api/src` because the api's production build (`nest build` → `node dist/src/main`)
+compiles with `api/src` as the tsc rootDir — sources outside it restructure `dist/` and
+break the packaged app. The UI/Storybook/jest aliases simply point into this folder, so
+shared code ships with zero extra packaging surface (desktop bundles it like any api file).
+
+## What belongs here
+
+- Cross-boundary **contracts**: value formats both sides must agree on (e.g. the
+  BigInt-as-string array index format), stable message formats, shared constants.
+- Small **dependency-free** utilities needed verbatim on both sides.
+
+## Rules
+
+- **No imports** from Nest, React, ioredis, lodash or anything else — dependency-free
+  TypeScript only (the UI and API have separate node_modules; nothing here may assume
+  either).
+- **es2019-compatible**: the api compiles this folder with `target: es2019` — no BigInt
+  literals (`1n` is TS2737; use `BigInt('...')`), no newer syntax.
+- API code style (semicolons) — this folder is linted by `yarn lint:api`.
+- Tests live next to the module (`*.spec.ts`, runs under the api jest config) and define
+  the shared behavior once — UI consumers exercise it through their barrel imports.
+
+## Alias wiring (when adding the alias to a new consumer)
+
+`redisinsight/ui/tsconfig.json` + `redisinsight/ui/vite.config.mjs` +
+`jest.config.cjs` (root, UI tests) + `.storybook/vite.config.ts` +
+`redisinsight/desktop/tsconfig.json` all map `riShared/*` →
+`redisinsight/api/src/ri-shared/*`.

…/common/utils/array-index.helper.spec.ts …/src/ri-shared/utils/array-index.spec.tsredisinsight/api/src/common/utils/array-index.helper.spec.ts renamed to redisinsight/api/src/ri-shared/utils/array-index.spec.ts redisinsight/api/src/common/utils/array-index.helper.spec.ts renamed to redisinsight/api/src/ri-shared/utils/array-index.spec.ts

@@ -2,9 +2,11 @@ import {
   ARRAY_INDEX_MAX,
   isValidArrayIndex,
   parseArrayIndex,
-} from 'src/common/utils';
+} from './array-index';
 
-describe('array-index.helper', () => {
+// Single source of truth for the previously-mirrored UI/API table —
+// runs under the api jest config (rootDir src picks it up automatically).
+describe('shared array-index', () => {
   it('should expose max unsigned 64-bit value', () => {
     expect(ARRAY_INDEX_MAX).toEqual(BigInt('18446744073709551615'));
   });

…i/src/common/utils/array-index.helper.ts …t/api/src/ri-shared/utils/array-index.tsredisinsight/api/src/common/utils/array-index.helper.ts renamed to redisinsight/api/src/ri-shared/utils/array-index.ts redisinsight/api/src/common/utils/array-index.helper.ts renamed to redisinsight/api/src/ri-shared/utils/array-index.ts

@@ -1,13 +1,19 @@
 /**
  * Redis array indexes are unsigned 64-bit integers (0 … 2^64−1) and exceed
  * Number.MAX_SAFE_INTEGER, so they travel as numeric strings end-to-end —
- * never parseInt/Number, no JS-side arithmetic on indexes.
+ * never parseInt/Number, no JS-side arithmetic on indexes (the UI's Redux
+ * store keeps them as strings too).
  *
- * Mirrored in redisinsight/ui/src/utils/arrayIndex.ts — keep semantics and
- * tests in sync.
+ * Shared by the UI and the API (see src/ri-shared/README.md): the API
+ * imports it relatively (it lives in the api compile root, so `nest build`
+ * emits it into dist like any other api source), the UI through the
+ * `riShared/*` alias (wired in redisinsight/ui/vite.config.mjs,
+ * redisinsight/ui/tsconfig.json, .storybook/vite.config.ts and
+ * jest.config.cjs). It must stay dependency-free and es2019-compatible —
+ * BigInt('...') calls only, since BigInt literals are a syntax error
+ * (TS2737) under the api's es2019 target.
  */
-// 2^64 - 1; BigInt() call (not a literal) — this tsconfig targets es2019,
-// where BigInt literals are a syntax error (TS2737).
+// 2^64 - 1
 export const ARRAY_INDEX_MAX = BigInt('18446744073709551615');
 
 const ARRAY_INDEX_REGEX = /^\d+$/;

redisinsight/desktop/tsconfig.json

@@ -29,7 +29,8 @@
       "apiSrc/*": ["redisinsight/api/src/*"],
       "uiSrc/*": ["redisinsight/ui/src/*"],
       "apiClient": ["redisinsight/api-client"],
-      "apiClient/*": ["redisinsight/api-client/*"]
+      "apiClient/*": ["redisinsight/api-client/*"],
+      "riShared/*": ["redisinsight/api/src/ri-shared/*"]
     }
   },
   "include": ["**/*"],

redisinsight/ui/src/utils/arrayIndex.ts

@@ -4,7 +4,7 @@ import RouterWithSubRoutes from './routerWithSubRoutes'
 
 export * from './common'
 export * from './validations'
-export * from './arrayIndex'
+export * from 'riShared/utils/array-index'
 export * from './statuses'
 export * from './instance'
 export * from './apiResponse'