@nsxbet/admin-sdk 0.1.0

package/dist/registry/AdminShellRegistry.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Registry Context API
+ *
+ * Provides a React context for accessing the module registry throughout the app.
+ *
+ * @example
+ * ```tsx
+ * // 1. Create the registry client
+ * const registry = createInMemoryRegistryClient({ seed: [...] });
+ *
+ * // 2. Wrap your app with the provider
+ * function App() {
+ *   return (
+ *     <AdminShellRegistry store={registry}>
+ *       <MyApp />
+ *     </AdminShellRegistry>
+ *   );
+ * }
+ *
+ * // 3. Use the hook in any component
+ * function ModuleList() {
+ *   const { modules, isLoading, deleteModule } = useRegistry();
+ *   // ...
+ * }
+ * ```
+ */
+import { type ReactNode } from 'react';
+import type { RegistryClient } from './client/interface';
+import type { RegisteredModule, UpdateModuleDto, AdminModuleManifest } from './types';
+/**
+ * Registry context value
+ */
+export interface RegistryContextValue {
+    /** The underlying registry client */
+    client: RegistryClient;
+    /** List of all registered modules */
+    modules: RegisteredModule[];
+    /** Whether modules are currently being loaded */
+    isLoading: boolean;
+    /** Error from the last operation, if any */
+    error: Error | null;
+    /** Reload modules from the registry */
+    reload: () => Promise<void>;
+    /** Register a new module from manifest */
+    registerModule: (manifest: AdminModuleManifest, baseUrl?: string) => Promise<RegisteredModule>;
+    /** Register a new module by URL (fetches admin.module.json) */
+    registerModuleByUrl: (baseUrl: string) => Promise<RegisteredModule>;
+    /** Update a module */
+    updateModule: (id: number, data: UpdateModuleDto) => Promise<RegisteredModule>;
+    /** Delete a module */
+    deleteModule: (id: number) => Promise<void>;
+    /** Reorder modules */
+    reorderModules: (order: Array<{
+        id: number;
+        navOrder: number;
+    }>) => Promise<void>;
+    /** Get a single module by ID */
+    getModule: (id: number) => RegisteredModule | undefined;
+    /** Get enabled modules only */
+    enabledModules: RegisteredModule[];
+    /** Get modules by category */
+    getModulesByCategory: (category: string) => RegisteredModule[];
+}
+/**
+ * Props for AdminShellRegistry provider
+ */
+export interface AdminShellRegistryProps {
+    /** The registry client instance */
+    store: RegistryClient;
+    /** Child components */
+    children: ReactNode;
+    /** Called when modules change (for external sync) */
+    onModulesChange?: (modules: RegisteredModule[]) => void;
+}
+/**
+ * Registry provider component
+ *
+ * Wrap your app with this component to provide registry access to all children.
+ *
+ * @example
+ * ```tsx
+ * const registry = createInMemoryRegistryClient({ seed: myModules });
+ *
+ * function App() {
+ *   return (
+ *     <AdminShellRegistry store={registry}>
+ *       <Router>
+ *         <Routes />
+ *       </Router>
+ *     </AdminShellRegistry>
+ *   );
+ * }
+ * ```
+ */
+export declare function AdminShellRegistry({ store, children, onModulesChange, }: AdminShellRegistryProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to access the registry context
+ *
+ * @throws Error if used outside of AdminShellRegistry provider
+ *
+ * @example
+ * ```tsx
+ * function ModuleList() {
+ *   const { modules, isLoading, deleteModule } = useRegistry();
+ *
+ *   if (isLoading) return <Loading />;
+ *
+ *   return (
+ *     <ul>
+ *       {modules.map((m) => (
+ *         <li key={m.id}>
+ *           {m.manifest.title}
+ *           <button onClick={() => deleteModule(m.id)}>Delete</button>
+ *         </li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ * ```
+ */
+export declare function useRegistry(): RegistryContextValue;
+/**
+ * Hook to access just the registry client
+ *
+ * Use this when you only need the raw client without the managed state.
+ *
+ * @example
+ * ```tsx
+ * function CustomOperation() {
+ *   const client = useRegistryClient();
+ *
+ *   const handleCustom = async () => {
+ *     const catalog = await client.catalog.get();
+ *     // ...
+ *   };
+ * }
+ * ```
+ */
+export declare function useRegistryClient(): RegistryClient;
+//# sourceMappingURL=AdminShellRegistry.d.ts.map

package/dist/registry/AdminShellRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdminShellRegistry.d.ts","sourceRoot":"","sources":["../../src/registry/AdminShellRegistry.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,MAAM,EAAE,cAAc,CAAC;IAEvB,qCAAqC;IACrC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAE5B,iDAAiD;IACjD,SAAS,EAAE,OAAO,CAAC;IAEnB,4CAA4C;IAC5C,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB,uCAAuC;IACvC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B,0CAA0C;IAC1C,cAAc,EAAE,CAAC,QAAQ,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE/F,+DAA+D;IAC/D,mBAAmB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEpE,sBAAsB;IACtB,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE/E,sBAAsB;IACtB,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C,sBAAsB;IACtB,cAAc,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAElF,gCAAgC;IAChC,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,gBAAgB,GAAG,SAAS,CAAC;IAExD,+BAA+B;IAC/B,cAAc,EAAE,gBAAgB,EAAE,CAAC;IAEnC,8BAA8B;IAC9B,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,gBAAgB,EAAE,CAAC;CAChE;AAID;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,mCAAmC;IACnC,KAAK,EAAE,cAAc,CAAC;IAEtB,uBAAuB;IACvB,QAAQ,EAAE,SAAS,CAAC;IAEpB,qDAAqD;IACrD,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,IAAI,CAAC;CACzD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,QAAQ,EACR,eAAe,GAChB,EAAE,uBAAuB,2CAiKzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,wBAAgB,WAAW,IAAI,oBAAoB,CAMlD;AAED;;;;;;;;;;;;;;;;GAgBG;AAEH,wBAAgB,iBAAiB,IAAI,cAAc,CAMlD"}

package/dist/registry/AdminShellRegistry.js

@@ -0,0 +1,237 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Registry Context API
+ *
+ * Provides a React context for accessing the module registry throughout the app.
+ *
+ * @example
+ * ```tsx
+ * // 1. Create the registry client
+ * const registry = createInMemoryRegistryClient({ seed: [...] });
+ *
+ * // 2. Wrap your app with the provider
+ * function App() {
+ *   return (
+ *     <AdminShellRegistry store={registry}>
+ *       <MyApp />
+ *     </AdminShellRegistry>
+ *   );
+ * }
+ *
+ * // 3. Use the hook in any component
+ * function ModuleList() {
+ *   const { modules, isLoading, deleteModule } = useRegistry();
+ *   // ...
+ * }
+ * ```
+ */
+import { createContext, useContext, useState, useEffect, useCallback, useMemo, } from 'react';
+const RegistryContext = createContext(null);
+/**
+ * Registry provider component
+ *
+ * Wrap your app with this component to provide registry access to all children.
+ *
+ * @example
+ * ```tsx
+ * const registry = createInMemoryRegistryClient({ seed: myModules });
+ *
+ * function App() {
+ *   return (
+ *     <AdminShellRegistry store={registry}>
+ *       <Router>
+ *         <Routes />
+ *       </Router>
+ *     </AdminShellRegistry>
+ *   );
+ * }
+ * ```
+ */
+export function AdminShellRegistry({ store, children, onModulesChange, }) {
+    const [modules, setModules] = useState([]);
+    const [isLoading, setIsLoading] = useState(true);
+    const [error, setError] = useState(null);
+    // Load modules from registry
+    const reload = useCallback(async () => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await store.modules.findAll();
+            setModules(result);
+            onModulesChange?.(result);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error('Failed to load modules'));
+            console.error('[Registry] Failed to load modules:', err);
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [store, onModulesChange]);
+    // Initial load
+    useEffect(() => {
+        reload();
+    }, [reload]);
+    // Register module from manifest
+    const registerModule = useCallback(async (manifest, baseUrl) => {
+        setError(null);
+        try {
+            const newModule = await store.modules.registerFromManifest(manifest, baseUrl);
+            await reload();
+            return newModule;
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Failed to register module');
+            setError(error);
+            throw error;
+        }
+    }, [store, reload]);
+    // Register module by URL
+    const registerModuleByUrl = useCallback(async (baseUrl) => {
+        setError(null);
+        try {
+            const newModule = await store.modules.register(baseUrl);
+            await reload();
+            return newModule;
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Failed to register module');
+            setError(error);
+            throw error;
+        }
+    }, [store, reload]);
+    // Update module
+    const updateModule = useCallback(async (id, data) => {
+        setError(null);
+        try {
+            const updated = await store.modules.update(id, data);
+            await reload();
+            return updated;
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Failed to update module');
+            setError(error);
+            throw error;
+        }
+    }, [store, reload]);
+    // Delete module
+    const deleteModule = useCallback(async (id) => {
+        setError(null);
+        try {
+            await store.modules.delete(id);
+            await reload();
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Failed to delete module');
+            setError(error);
+            throw error;
+        }
+    }, [store, reload]);
+    // Reorder modules
+    const reorderModules = useCallback(async (order) => {
+        setError(null);
+        try {
+            await store.modules.reorder(order);
+            await reload();
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Failed to reorder modules');
+            setError(error);
+            throw error;
+        }
+    }, [store, reload]);
+    // Get single module
+    const getModule = useCallback((id) => modules.find((m) => m.id === id), [modules]);
+    // Enabled modules only
+    const enabledModules = useMemo(() => modules.filter((m) => m.enabled), [modules]);
+    // Get modules by category
+    const getModulesByCategory = useCallback((category) => modules.filter((m) => m.manifest.category === category), [modules]);
+    const value = useMemo(() => ({
+        client: store,
+        modules,
+        isLoading,
+        error,
+        reload,
+        registerModule,
+        registerModuleByUrl,
+        updateModule,
+        deleteModule,
+        reorderModules,
+        getModule,
+        enabledModules,
+        getModulesByCategory,
+    }), [
+        store,
+        modules,
+        isLoading,
+        error,
+        reload,
+        registerModule,
+        registerModuleByUrl,
+        updateModule,
+        deleteModule,
+        reorderModules,
+        getModule,
+        enabledModules,
+        getModulesByCategory,
+    ]);
+    return _jsx(RegistryContext.Provider, { value: value, children: children });
+}
+/**
+ * Hook to access the registry context
+ *
+ * @throws Error if used outside of AdminShellRegistry provider
+ *
+ * @example
+ * ```tsx
+ * function ModuleList() {
+ *   const { modules, isLoading, deleteModule } = useRegistry();
+ *
+ *   if (isLoading) return <Loading />;
+ *
+ *   return (
+ *     <ul>
+ *       {modules.map((m) => (
+ *         <li key={m.id}>
+ *           {m.manifest.title}
+ *           <button onClick={() => deleteModule(m.id)}>Delete</button>
+ *         </li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ * ```
+ */
+// eslint-disable-next-line react-refresh/only-export-components
+export function useRegistry() {
+    const context = useContext(RegistryContext);
+    if (!context) {
+        throw new Error('useRegistry must be used within an AdminShellRegistry provider');
+    }
+    return context;
+}
+/**
+ * Hook to access just the registry client
+ *
+ * Use this when you only need the raw client without the managed state.
+ *
+ * @example
+ * ```tsx
+ * function CustomOperation() {
+ *   const client = useRegistryClient();
+ *
+ *   const handleCustom = async () => {
+ *     const catalog = await client.catalog.get();
+ *     // ...
+ *   };
+ * }
+ * ```
+ */
+// eslint-disable-next-line react-refresh/only-export-components
+export function useRegistryClient() {
+    const context = useContext(RegistryContext);
+    if (!context) {
+        throw new Error('useRegistryClient must be used within an AdminShellRegistry provider');
+    }
+    return context.client;
+}

package/dist/registry/client/http.d.ts

@@ -0,0 +1,21 @@
+/**
+ * HTTP Registry Client
+ *
+ * Implementation of RegistryClient that communicates with the admin-api.
+ * Used when running with PostgreSQL backend.
+ */
+import type { RegistryClient } from './interface';
+/**
+ * Options for creating an HTTP registry client
+ */
+export interface HttpRegistryOptions {
+    /** Base URL of the API (e.g., 'http://localhost:4000/api') */
+    baseUrl: string;
+    /** Optional fetch options (headers, etc.) */
+    fetchOptions?: RequestInit;
+}
+/**
+ * Create an HTTP registry client
+ */
+export declare function createHttpRegistryClient(options: HttpRegistryOptions): RegistryClient;
+//# sourceMappingURL=http.d.ts.map

package/dist/registry/client/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/registry/client/http.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,OAAO,KAAK,EAAE,cAAc,EAAuC,MAAM,aAAa,CAAA;AAEtF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAA;IACf,6CAA6C;IAC7C,YAAY,CAAC,EAAE,WAAW,CAAA;CAC3B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,mBAAmB,GAAG,cAAc,CAyHrF"}

package/dist/registry/client/http.js

@@ -0,0 +1,107 @@
+/**
+ * HTTP Registry Client
+ *
+ * Implementation of RegistryClient that communicates with the admin-api.
+ * Used when running with PostgreSQL backend.
+ */
+/**
+ * Create an HTTP registry client
+ */
+export function createHttpRegistryClient(options) {
+    const { baseUrl, fetchOptions = {} } = options;
+    const defaultHeaders = {
+        'Content-Type': 'application/json',
+        ...fetchOptions.headers,
+    };
+    async function request(path, init) {
+        const url = `${baseUrl}${path}`;
+        const response = await fetch(url, {
+            ...fetchOptions,
+            ...init,
+            headers: {
+                ...defaultHeaders,
+                ...init?.headers,
+            },
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`API request failed: ${response.status} - ${error}`);
+        }
+        // Handle empty responses (e.g., DELETE)
+        const text = await response.text();
+        if (!text) {
+            return undefined;
+        }
+        return JSON.parse(text);
+    }
+    // Module operations
+    const modules = {
+        async findAll(filters) {
+            const params = new URLSearchParams();
+            if (filters?.enabled !== undefined) {
+                params.set('enabled', String(filters.enabled));
+            }
+            if (filters?.category) {
+                params.set('category', filters.category);
+            }
+            if (filters?.status) {
+                params.set('status', filters.status);
+            }
+            const query = params.toString();
+            const path = query ? `/modules?${query}` : '/modules';
+            return request(path);
+        },
+        async find(id) {
+            return request(`/modules/${id}`);
+        },
+        async register(baseUrl) {
+            return request('/modules', {
+                method: 'POST',
+                body: JSON.stringify({ baseUrl }),
+            });
+        },
+        async registerFromManifest(manifest, baseUrl = '') {
+            return request('/modules/manifest', {
+                method: 'POST',
+                body: JSON.stringify({ manifest, baseUrl }),
+            });
+        },
+        async update(id, data) {
+            return request(`/modules/${id}`, {
+                method: 'PATCH',
+                body: JSON.stringify(data),
+            });
+        },
+        async delete(id) {
+            await request(`/modules/${id}`, {
+                method: 'DELETE',
+            });
+        },
+        async reorder(order) {
+            await request('/modules/reorder', {
+                method: 'POST',
+                body: JSON.stringify(order),
+            });
+        },
+    };
+    // Catalog operations
+    const catalog = {
+        async get() {
+            return request('/catalog');
+        },
+        async getImportMap(_environment) {
+            // Generate import map from catalog baseUrl
+            const catalogData = await this.get();
+            const imports = {};
+            for (const m of catalogData.modules) {
+                if (m.baseUrl) {
+                    // Note: This import map is deprecated - DynamicModule fetches manifest at runtime
+                    const base = m.baseUrl.endsWith('/') ? m.baseUrl.slice(0, -1) : m.baseUrl;
+                    imports[m.id] = `${base}/module.manifest.json`;
+                }
+            }
+            return { imports };
+        },
+    };
+    return { modules, catalog };
+}

package/dist/registry/client/in-memory.d.ts

@@ -0,0 +1,36 @@
+/**
+ * In-Memory Registry Client
+ *
+ * Implementation of RegistryClient that stores data in localStorage.
+ * Used for local development and testing without a backend.
+ */
+import type { AdminModuleManifest } from '../types';
+import type { RegistryClient } from './interface';
+/**
+ * Pre-configured module with baseUrl
+ * Note: entry is not stored - DynamicModule fetches module.manifest.json at runtime
+ */
+export interface PreConfiguredModule extends AdminModuleManifest {
+    /** Base URL where module is served (e.g., http://localhost:3003) */
+    baseUrl: string;
+}
+/**
+ * Options for creating an in-memory registry client
+ */
+export interface InMemoryRegistryOptions {
+    /** Seed with manifest JSONs directly (without baseUrl) */
+    seed?: AdminModuleManifest[];
+    /** Pre-configured modules with baseUrl (for Docker/production setups) */
+    initialModules?: PreConfiguredModule[];
+    /** localStorage key prefix (defaults to '@nsxbet/registry') */
+    storageKey?: string;
+}
+/**
+ * Create an in-memory registry client
+ */
+export declare function createInMemoryRegistryClient(options?: InMemoryRegistryOptions): RegistryClient;
+/**
+ * Clear all registry data from localStorage
+ */
+export declare function clearInMemoryRegistry(storageKey?: string): void;
+//# sourceMappingURL=in-memory.d.ts.map

package/dist/registry/client/in-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../../src/registry/client/in-memory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAQV,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAAE,cAAc,EAAuC,MAAM,aAAa,CAAC;AAEvF;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0DAA0D;IAC1D,IAAI,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC7B,yEAAyE;IACzE,cAAc,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACvC,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAYD;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,GAAE,uBAA4B,GACpC,cAAc,CA6OhB;AA4BD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,GAAE,MAA4B,GAAG,IAAI,CAEpF"}