@hamak/ui-store-api 0.2.2 → 0.2.3

package/.turbo/turbo-build.log

@@ -1,2 +1 @@
-
-$ tsc -p tsconfig.json && tsc -p tsconfig.es2015.json
+$ tsc -p tsconfig.json && tsc -p tsconfig.es2015.json

package/.turbo/turbo-test.log

@@ -0,0 +1,12 @@
+$ vitest run
+
+ RUN  v2.1.9 /Users/amah/Devs/projects/app-framework/packages/ui-store/ui-store-api
+
+ ✓ src/types/extension-types.test.ts (7 tests) 6ms
+ ✓ src/tokens/service-tokens.test.ts (8 tests) 8ms
+
+ Test Files  2 passed (2)
+      Tests  15 passed (15)
+   Start at  21:18:14
+   Duration  1.81s (transform 109ms, setup 0ms, collect 217ms, tests 14ms, environment 0ms, prepare 938ms)
+

package/dist/es2015/tokens/service-tokens.js

@@ -5,3 +5,4 @@
 export const STORE_MANAGER_TOKEN = Symbol('StoreManager');
 export const MIDDLEWARE_REGISTRY_TOKEN = Symbol('MiddlewareRegistry');
 export const REDUCER_REGISTRY_TOKEN = Symbol('ReducerRegistry');
+export const STORE_EXTENSIONS_TOKEN = Symbol('StoreExtensions');

package/dist/es2015/types/extension-types.js

@@ -0,0 +1,4 @@
+/**
+ * Store extension types
+ */
+export {};

package/dist/es2015/types/index.js

@@ -4,3 +4,4 @@
 export * from './store-types';
 export * from './middleware-types';
 export * from './reducer-types';
+export * from './extension-types';

package/dist/tokens/service-tokens.d.ts

@@ -5,4 +5,5 @@
 export declare const STORE_MANAGER_TOKEN: unique symbol;
 export declare const MIDDLEWARE_REGISTRY_TOKEN: unique symbol;
 export declare const REDUCER_REGISTRY_TOKEN: unique symbol;
+export declare const STORE_EXTENSIONS_TOKEN: unique symbol;
 //# sourceMappingURL=service-tokens.d.ts.map

package/dist/tokens/service-tokens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service-tokens.d.ts","sourceRoot":"","sources":["../../src/tokens/service-tokens.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,mBAAmB,eAAyB,CAAC;AAC1D,eAAO,MAAM,yBAAyB,eAA+B,CAAC;AACtE,eAAO,MAAM,sBAAsB,eAA4B,CAAC"}
+{"version":3,"file":"service-tokens.d.ts","sourceRoot":"","sources":["../../src/tokens/service-tokens.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,mBAAmB,eAAyB,CAAC;AAC1D,eAAO,MAAM,yBAAyB,eAA+B,CAAC;AACtE,eAAO,MAAM,sBAAsB,eAA4B,CAAC;AAChE,eAAO,MAAM,sBAAsB,eAA4B,CAAC"}

package/dist/tokens/service-tokens.js

@@ -5,3 +5,4 @@
 export const STORE_MANAGER_TOKEN = Symbol('StoreManager');
 export const MIDDLEWARE_REGISTRY_TOKEN = Symbol('MiddlewareRegistry');
 export const REDUCER_REGISTRY_TOKEN = Symbol('ReducerRegistry');
+export const STORE_EXTENSIONS_TOKEN = Symbol('StoreExtensions');

package/dist/types/extension-types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Store extension types
+ */
+import type { Reducer } from 'redux';
+import type { MiddlewareRegistration } from './middleware-types';
+/**
+ * Middleware contribution matches registry entries
+ */
+export type StoreMiddlewareExtension = MiddlewareRegistration;
+/**
+ * Extension payload that mirrors store plugin config
+ */
+export interface StorePluginExtensions {
+    middleware?: StoreMiddlewareExtension[];
+    reducers?: Record<string, Reducer>;
+}
+/**
+ * Registry exposed via STORE_EXTENSIONS_TOKEN
+ */
+export interface StoreExtensionsRegistry {
+    register(source: string, extensions: StorePluginExtensions): void;
+}
+//# sourceMappingURL=extension-types.d.ts.map

package/dist/types/extension-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-types.d.ts","sourceRoot":"","sources":["../../src/types/extension-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AACrC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,sBAAsB,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACnE"}

package/dist/types/extension-types.js

@@ -0,0 +1,4 @@
+/**
+ * Store extension types
+ */
+export {};

package/dist/types/index.d.ts

@@ -4,4 +4,5 @@
 export * from './store-types';
 export * from './middleware-types';
 export * from './reducer-types';
+export * from './extension-types';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

package/dist/types/index.js

@@ -4,3 +4,4 @@
 export * from './store-types';
 export * from './middleware-types';
 export * from './reducer-types';
+export * from './extension-types';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hamak/ui-store-api",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "private": false,
   "type": "module",
   "description": "UI Store API - Redux store interfaces and contracts",

package/src/tokens/service-tokens.test.ts

@@ -0,0 +1,88 @@
+/**
+ * Service Tokens Tests
+ */
+
+import { describe, test, expect } from 'vitest';
+import {
+  STORE_MANAGER_TOKEN,
+  MIDDLEWARE_REGISTRY_TOKEN,
+  REDUCER_REGISTRY_TOKEN,
+  STORE_EXTENSIONS_TOKEN,
+} from './service-tokens';
+
+describe('Service Tokens', () => {
+  describe('Token Definitions', () => {
+    test('STORE_MANAGER_TOKEN should be defined as symbol', () => {
+      expect(typeof STORE_MANAGER_TOKEN).toBe('symbol');
+      expect(STORE_MANAGER_TOKEN.toString()).toBe('Symbol(StoreManager)');
+    });
+
+    test('MIDDLEWARE_REGISTRY_TOKEN should be defined as symbol', () => {
+      expect(typeof MIDDLEWARE_REGISTRY_TOKEN).toBe('symbol');
+      expect(MIDDLEWARE_REGISTRY_TOKEN.toString()).toBe('Symbol(MiddlewareRegistry)');
+    });
+
+    test('REDUCER_REGISTRY_TOKEN should be defined as symbol', () => {
+      expect(typeof REDUCER_REGISTRY_TOKEN).toBe('symbol');
+      expect(REDUCER_REGISTRY_TOKEN.toString()).toBe('Symbol(ReducerRegistry)');
+    });
+
+    test('STORE_EXTENSIONS_TOKEN should be defined as symbol', () => {
+      expect(typeof STORE_EXTENSIONS_TOKEN).toBe('symbol');
+      expect(STORE_EXTENSIONS_TOKEN.toString()).toBe('Symbol(StoreExtensions)');
+    });
+  });
+
+  describe('Token Uniqueness', () => {
+    test('each token should be unique', () => {
+      const tokens = [
+        STORE_MANAGER_TOKEN,
+        MIDDLEWARE_REGISTRY_TOKEN,
+        REDUCER_REGISTRY_TOKEN,
+        STORE_EXTENSIONS_TOKEN,
+      ];
+
+      const uniqueTokens = new Set(tokens);
+      expect(uniqueTokens.size).toBe(tokens.length);
+    });
+
+    test('tokens should not equal each other', () => {
+      expect(STORE_MANAGER_TOKEN).not.toBe(MIDDLEWARE_REGISTRY_TOKEN);
+      expect(STORE_MANAGER_TOKEN).not.toBe(REDUCER_REGISTRY_TOKEN);
+      expect(STORE_MANAGER_TOKEN).not.toBe(STORE_EXTENSIONS_TOKEN);
+      expect(MIDDLEWARE_REGISTRY_TOKEN).not.toBe(REDUCER_REGISTRY_TOKEN);
+      expect(MIDDLEWARE_REGISTRY_TOKEN).not.toBe(STORE_EXTENSIONS_TOKEN);
+      expect(REDUCER_REGISTRY_TOKEN).not.toBe(STORE_EXTENSIONS_TOKEN);
+    });
+  });
+
+  describe('Token Usage', () => {
+    test('tokens should be usable as Map keys', () => {
+      const map = new Map();
+      map.set(STORE_MANAGER_TOKEN, 'store manager');
+      map.set(MIDDLEWARE_REGISTRY_TOKEN, 'middleware registry');
+      map.set(REDUCER_REGISTRY_TOKEN, 'reducer registry');
+      map.set(STORE_EXTENSIONS_TOKEN, 'store extensions');
+
+      expect(map.get(STORE_MANAGER_TOKEN)).toBe('store manager');
+      expect(map.get(MIDDLEWARE_REGISTRY_TOKEN)).toBe('middleware registry');
+      expect(map.get(REDUCER_REGISTRY_TOKEN)).toBe('reducer registry');
+      expect(map.get(STORE_EXTENSIONS_TOKEN)).toBe('store extensions');
+      expect(map.size).toBe(4);
+    });
+
+    test('tokens should be usable as object keys', () => {
+      const obj = {
+        [STORE_MANAGER_TOKEN]: 'store manager',
+        [MIDDLEWARE_REGISTRY_TOKEN]: 'middleware registry',
+        [REDUCER_REGISTRY_TOKEN]: 'reducer registry',
+        [STORE_EXTENSIONS_TOKEN]: 'store extensions',
+      };
+
+      expect(obj[STORE_MANAGER_TOKEN]).toBe('store manager');
+      expect(obj[MIDDLEWARE_REGISTRY_TOKEN]).toBe('middleware registry');
+      expect(obj[REDUCER_REGISTRY_TOKEN]).toBe('reducer registry');
+      expect(obj[STORE_EXTENSIONS_TOKEN]).toBe('store extensions');
+    });
+  });
+});

package/src/tokens/service-tokens.ts

@@ -6,3 +6,4 @@
 export const STORE_MANAGER_TOKEN = Symbol('StoreManager');
 export const MIDDLEWARE_REGISTRY_TOKEN = Symbol('MiddlewareRegistry');
 export const REDUCER_REGISTRY_TOKEN = Symbol('ReducerRegistry');
+export const STORE_EXTENSIONS_TOKEN = Symbol('StoreExtensions');

package/src/types/extension-types.test.ts

@@ -0,0 +1,108 @@
+/**
+ * Extension Types Tests
+ */
+
+import { describe, test, expect } from 'vitest';
+import type {
+  StoreMiddlewareExtension,
+  StorePluginExtensions,
+  StoreExtensionsRegistry,
+} from './extension-types';
+import type { Middleware } from 'redux';
+
+describe('Extension Types', () => {
+  describe('StorePluginExtensions', () => {
+    test('should accept middleware array', () => {
+      const middleware: Middleware = () => (next) => (action) => next(action);
+      const extensions: StorePluginExtensions = {
+        middleware: [
+          {
+            id: 'test',
+            middleware,
+          },
+        ],
+      };
+
+      expect(extensions.middleware).toBeDefined();
+      expect(extensions.middleware?.length).toBe(1);
+    });
+
+    test('should accept reducers record', () => {
+      const reducer = (state = {}) => state;
+      const extensions: StorePluginExtensions = {
+        reducers: {
+          testReducer: reducer,
+        },
+      };
+
+      expect(extensions.reducers).toBeDefined();
+      expect(extensions.reducers?.testReducer).toBe(reducer);
+    });
+
+    test('should accept both middleware and reducers', () => {
+      const middleware: Middleware = () => (next) => (action) => next(action);
+      const reducer = (state = {}) => state;
+      const extensions: StorePluginExtensions = {
+        middleware: [{ id: 'test', middleware }],
+        reducers: { testReducer: reducer },
+      };
+
+      expect(extensions.middleware).toBeDefined();
+      expect(extensions.reducers).toBeDefined();
+    });
+
+    test('should accept empty object', () => {
+      const extensions: StorePluginExtensions = {};
+
+      expect(extensions).toBeDefined();
+      expect(extensions.middleware).toBeUndefined();
+      expect(extensions.reducers).toBeUndefined();
+    });
+  });
+
+  describe('StoreExtensionsRegistry', () => {
+    test('should define register method signature', () => {
+      const mockRegistry: StoreExtensionsRegistry = {
+        register: (source: string, extensions: StorePluginExtensions) => {
+          expect(source).toBeDefined();
+          expect(extensions).toBeDefined();
+        },
+      };
+
+      mockRegistry.register('test-source', {});
+    });
+
+    test('should accept source and extensions', () => {
+      const middleware: Middleware = () => (next) => (action) => next(action);
+      const reducer = (state = {}) => state;
+
+      const mockRegistry: StoreExtensionsRegistry = {
+        register: (source: string, extensions: StorePluginExtensions) => {
+          expect(source).toBe('test-plugin');
+          expect(extensions.middleware?.length).toBe(1);
+          expect(extensions.reducers?.testReducer).toBe(reducer);
+        },
+      };
+
+      mockRegistry.register('test-plugin', {
+        middleware: [{ id: 'test', middleware }],
+        reducers: { testReducer: reducer },
+      });
+    });
+  });
+
+  describe('StoreMiddlewareExtension', () => {
+    test('should match MiddlewareRegistration structure', () => {
+      const middleware: Middleware = () => (next) => (action) => next(action);
+      const extension: StoreMiddlewareExtension = {
+        id: 'test-middleware',
+        middleware,
+        priority: 100,
+      };
+
+      expect(extension.id).toBe('test-middleware');
+      expect(extension.middleware).toBe(middleware);
+      expect(extension.priority).toBe(100);
+    });
+  });
+});

package/src/types/extension-types.ts

@@ -0,0 +1,26 @@
+/**
+ * Store extension types
+ */
+
+import type { Reducer } from 'redux';
+import type { MiddlewareRegistration } from './middleware-types';
+
+/**
+ * Middleware contribution matches registry entries
+ */
+export type StoreMiddlewareExtension = MiddlewareRegistration;
+
+/**
+ * Extension payload that mirrors store plugin config
+ */
+export interface StorePluginExtensions {
+  middleware?: StoreMiddlewareExtension[];
+  reducers?: Record<string, Reducer>;
+}
+
+/**
+ * Registry exposed via STORE_EXTENSIONS_TOKEN
+ */
+export interface StoreExtensionsRegistry {
+  register(source: string, extensions: StorePluginExtensions): void;
+}

package/src/types/index.ts

@@ -5,3 +5,4 @@
 export * from './store-types';
 export * from './middleware-types';
 export * from './reducer-types';
+export * from './extension-types';