@nsxbet/admin-sdk 0.1.0

package/dist/registry/types/module.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Registered Module Types
+ *
+ * Types for modules that have been registered in the registry.
+ */
+import type { AdminModuleManifest } from './manifest';
+/**
+ * A module that has been registered in the registry
+ */
+export interface RegisteredModule {
+    /** Auto-increment ID */
+    id: number;
+    /** Module identifier from manifest (e.g., "@admin/tasks") */
+    moduleId: string;
+    /** Base URL where the module is hosted */
+    baseUrl: string;
+    /** Full parsed module.manifest.json (without entry - fetched at runtime) */
+    manifest: AdminModuleManifest;
+    /** Admin-controlled navigation order */
+    navOrder: number;
+    /** Whether the module is enabled */
+    enabled: boolean;
+    /** ISO timestamp when registered */
+    registeredAt: string;
+    /** ISO timestamp when last updated */
+    updatedAt: string;
+}
+/**
+ * DTO for updating a registered module
+ * Only admin-controlled fields can be updated
+ */
+export interface UpdateModuleDto {
+    /** Update navigation order */
+    navOrder?: number;
+    /** Enable or disable the module */
+    enabled?: boolean;
+}
+/**
+ * DTO for reordering modules
+ */
+export interface ReorderModuleDto {
+    /** Module ID */
+    id: number;
+    /** New navigation order */
+    navOrder: number;
+}
+/**
+ * Filters for listing modules
+ */
+export interface ModuleFilters {
+    /** Filter by enabled status */
+    enabled?: boolean;
+    /** Filter by category */
+    category?: string;
+    /** Filter by status */
+    status?: 'active' | 'deprecated' | 'disabled';
+}
+/**
+ * Catalog structure for shell consumption (denormalized)
+ */
+export interface Catalog {
+    /** Version identifier */
+    version: string;
+    /** Timestamp when generated */
+    generatedAt: string;
+    /** Array of modules in catalog format */
+    modules: CatalogModule[];
+}
+/**
+ * Module in catalog format (denormalized for shell)
+ * Note: entry is not included - DynamicModule fetches module.manifest.json at runtime
+ */
+export interface CatalogModule {
+    id: string;
+    title: string;
+    /** i18n key for the title (for translation) */
+    titleKey?: string;
+    description: string;
+    /** i18n key for the description (for translation) */
+    descriptionKey?: string;
+    category: string;
+    routeBase: string;
+    /** Base URL where the module is hosted */
+    baseUrl: string;
+    keywords: string[];
+    permissions: {
+        view: string[];
+        dangerous?: string[];
+    };
+    owners: {
+        team: string;
+        supportChannel: string;
+    };
+    status: 'active' | 'deprecated' | 'disabled';
+    navOrder?: number;
+    icon?: string;
+    commands?: Array<{
+        id: string;
+        title: string;
+        /** i18n key for the title (for translation) */
+        titleKey?: string;
+        keywords?: string[];
+        route: string;
+        icon?: string;
+    }>;
+}
+/**
+ * Import map structure for dynamic module loading
+ */
+export interface ImportMap {
+    imports: {
+        [moduleName: string]: string;
+    };
+}
+//# sourceMappingURL=module.d.ts.map

package/dist/registry/types/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/registry/types/module.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,MAAM,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,UAAU,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;IACF,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,MAAM,EAAE,QAAQ,GAAG,YAAY,GAAG,UAAU,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,+CAA+C;QAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE;QACP,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;KAC9B,CAAC;CACH"}

package/dist/registry/types/module.js

@@ -0,0 +1,6 @@
+/**
+ * Registered Module Types
+ *
+ * Types for modules that have been registered in the registry.
+ */
+export {};

package/dist/router/DynamicModule.d.ts

@@ -0,0 +1,50 @@
+import { Component, type ReactNode } from "react";
+interface DynamicModuleProps {
+    /** Base URL where the module is hosted (e.g., "http://localhost:5001") */
+    baseUrl: string;
+    /** Module global name (e.g., "TasksAdminModule") - if not provided, uses ES import */
+    globalName?: string;
+    /** Custom loading fallback */
+    fallback?: ReactNode;
+    /** Custom error fallback */
+    errorFallback?: ReactNode;
+}
+/**
+ * Loading spinner shown while module is being fetched
+ */
+declare function ModuleLoading(): import("react/jsx-runtime").JSX.Element;
+/**
+ * Error boundary for catching module load errors
+ */
+interface ErrorBoundaryProps {
+    children: ReactNode;
+    fallback?: ReactNode;
+    onRetry?: () => void;
+}
+interface ErrorBoundaryState {
+    hasError: boolean;
+    error?: Error;
+}
+declare class ModuleErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    constructor(props: ErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+    componentDidCatch(error: Error, errorInfo: React.ErrorInfo): void;
+    handleRetry: () => void;
+    render(): string | number | boolean | Iterable<ReactNode> | import("react/jsx-runtime").JSX.Element | null | undefined;
+}
+/**
+ * DynamicModule - Loads a module from a URL using React.lazy
+ *
+ * This component:
+ * 1. Fetches module.manifest.json from baseUrl to get the hashed entry path
+ * 2. Loads the module JS file using React.lazy
+ * 3. Keeps the module in the shell's React tree for shared Router context
+ *
+ * @example
+ * ```tsx
+ * <DynamicModule baseUrl="http://localhost:5001" />
+ * ```
+ */
+export declare function DynamicModule({ baseUrl, globalName, fallback, errorFallback, }: DynamicModuleProps): import("react/jsx-runtime").JSX.Element;
+export { ModuleLoading, ModuleErrorBoundary };
+//# sourceMappingURL=DynamicModule.d.ts.map

package/dist/router/DynamicModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DynamicModule.d.ts","sourceRoot":"","sources":["../../src/router/DynamicModule.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA2B,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAG3E,UAAU,kBAAkB;IAC1B,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,4BAA4B;IAC5B,aAAa,CAAC,EAAE,SAAS,CAAC;CAC3B;AAUD;;GAEG;AACH,iBAAS,aAAa,4CAerB;AAED;;GAEG;AACH,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,cAAM,mBAAoB,SAAQ,SAAS,CACzC,kBAAkB,EAClB,kBAAkB,CACnB;gBACa,KAAK,EAAE,kBAAkB;IAKrC,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,kBAAkB;IAIjE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS;IAI1D,WAAW,aAGT;IAEF,MAAM;CAkEP;AA0DD;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,EAC5B,OAAO,EACP,UAAU,EACV,QAAQ,EACR,aAAa,GACd,EAAE,kBAAkB,2CAsDpB;AAED,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/router/DynamicModule.js

@@ -0,0 +1,141 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Suspense, lazy, useMemo, Component } from "react";
+import { Icon, Card, CardContent, Button } from "@nsxbet/admin-ui";
+/**
+ * Loading spinner shown while module is being fetched
+ */
+function ModuleLoading() {
+    return (_jsxs("div", { "data-testid": "module-loading", className: "flex flex-col items-center justify-center h-full min-h-[300px] gap-4", children: [_jsx("div", { className: "inline-flex p-4 rounded-full bg-primary/10", children: _jsx(Icon, { name: "loader-2", className: "h-8 w-8 text-primary animate-spin" }) }), _jsxs("div", { className: "text-center", children: [_jsx("p", { className: "text-lg font-medium", children: "Loading module..." }), _jsx("p", { className: "text-sm text-muted-foreground", children: "Please wait while the module is being loaded" })] })] }));
+}
+class ModuleErrorBoundary extends Component {
+    constructor(props) {
+        super(props);
+        Object.defineProperty(this, "handleRetry", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: () => {
+                this.setState({ hasError: false, error: undefined });
+                this.props.onRetry?.();
+            }
+        });
+        this.state = { hasError: false };
+    }
+    static getDerivedStateFromError(error) {
+        return { hasError: true, error };
+    }
+    componentDidCatch(error, errorInfo) {
+        console.error("[DynamicModule] Failed to load module:", error, errorInfo);
+    }
+    render() {
+        if (this.state.hasError) {
+            if (this.props.fallback) {
+                return this.props.fallback;
+            }
+            const errorMessage = this.state.error?.message || "An unexpected error occurred";
+            const isNetworkError = errorMessage.includes("Failed to fetch") ||
+                errorMessage.includes("NetworkError") ||
+                errorMessage.includes("Failed to load script");
+            return (_jsx("div", { "data-testid": "module-error", className: "flex items-center justify-center h-full min-h-[300px] p-6", children: _jsx(Card, { className: "max-w-md w-full", children: _jsx(CardContent, { className: "pt-6", children: _jsxs("div", { className: "flex flex-col items-center text-center gap-4", children: [_jsx("div", { className: "inline-flex p-4 rounded-full bg-destructive/10", children: _jsx(Icon, { name: isNetworkError ? "wifi-off" : "alert-triangle", className: "h-8 w-8 text-destructive" }) }), _jsxs("div", { children: [_jsx("h3", { className: "text-lg font-semibold mb-1", children: isNetworkError ? "Module Unavailable" : "Failed to Load Module" }), _jsx("p", { className: "text-sm text-muted-foreground mb-2", children: isNetworkError
+                                                ? "The module server is not responding. Please ensure the module is running."
+                                                : "An error occurred while loading the module." }), _jsx("p", { className: "text-xs font-mono text-muted-foreground bg-muted p-2 rounded break-all", children: errorMessage })] }), _jsx("div", { className: "flex gap-2", children: _jsxs(Button, { "data-testid": "module-retry-button", onClick: this.handleRetry, variant: "default", children: [_jsx(Icon, { name: "refresh-cw", className: "h-4 w-4 mr-2" }), "Try Again"] }) }), isNetworkError && (_jsx("p", { className: "text-xs text-muted-foreground", children: "Tip: Run the module dev server or check your network connection." }))] }) }) }) }));
+        }
+        return this.props.children;
+    }
+}
+/**
+ * Load a script and return the global it exposes
+ */
+function loadScript(url, globalName) {
+    return new Promise((resolve, reject) => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const win = window;
+        // Check if already loaded
+        if (win[globalName]) {
+            resolve(win[globalName]);
+            return;
+        }
+        const script = document.createElement("script");
+        script.src = url;
+        script.async = true;
+        script.onload = () => {
+            const moduleExport = win[globalName];
+            if (moduleExport) {
+                resolve(moduleExport);
+            }
+            else {
+                reject(new Error(`Global "${globalName}" not found after loading ${url}`));
+            }
+        };
+        script.onerror = () => {
+            reject(new Error(`Failed to load script: ${url}`));
+        };
+        document.head.appendChild(script);
+    });
+}
+/**
+ * Fetch module manifest to get the entry path
+ */
+async function fetchModuleEntry(baseUrl) {
+    const manifestUrl = `${baseUrl}/module.manifest.json`;
+    console.log(`[DynamicModule] Fetching manifest from ${manifestUrl}`);
+    const response = await fetch(manifestUrl);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch manifest from ${manifestUrl}: ${response.status}`);
+    }
+    const manifest = await response.json();
+    if (!manifest.entry) {
+        throw new Error(`Manifest at ${manifestUrl} is missing required 'entry' field`);
+    }
+    return manifest.entry;
+}
+/**
+ * DynamicModule - Loads a module from a URL using React.lazy
+ *
+ * This component:
+ * 1. Fetches module.manifest.json from baseUrl to get the hashed entry path
+ * 2. Loads the module JS file using React.lazy
+ * 3. Keeps the module in the shell's React tree for shared Router context
+ *
+ * @example
+ * ```tsx
+ * <DynamicModule baseUrl="http://localhost:5001" />
+ * ```
+ */
+export function DynamicModule({ baseUrl, globalName, fallback, errorFallback, }) {
+    // Normalize baseUrl (remove trailing slash)
+    const normalizedUrl = baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
+    // Create lazy component - memoized to avoid re-creating on every render
+    const ModuleComponent = useMemo(() => lazy(async () => {
+        try {
+            // Step 1: Fetch manifest to get entry path
+            const entry = await fetchModuleEntry(normalizedUrl);
+            // Step 2: Load the module
+            const moduleUrl = `${normalizedUrl}/${entry}`;
+            console.log(`[DynamicModule] Loading module from ${moduleUrl}`);
+            let moduleExport;
+            if (globalName) {
+                // IIFE format: load script and get global
+                moduleExport = await loadScript(moduleUrl, globalName);
+            }
+            else {
+                // ES module format: use dynamic import
+                moduleExport = await import(/* @vite-ignore */ moduleUrl);
+            }
+            console.log(`[DynamicModule] Module loaded successfully`);
+            // Handle both default export and direct component
+            const mod = moduleExport;
+            const Component = (mod.default || mod.App || mod);
+            if (typeof Component !== "function") {
+                throw new Error("Module must export a default component or named App export");
+            }
+            return { default: Component };
+        }
+        catch (error) {
+            console.error(`[DynamicModule] Failed to load module:`, error);
+            throw error;
+        }
+    }), [normalizedUrl, globalName]);
+    return (_jsx(ModuleErrorBoundary, { fallback: errorFallback, children: _jsx(Suspense, { fallback: fallback ?? _jsx(ModuleLoading, {}), children: _jsx(ModuleComponent, {}) }) }));
+}
+export { ModuleLoading, ModuleErrorBoundary };

package/dist/router/index.d.ts

@@ -0,0 +1,2 @@
+export { DynamicModule, ModuleLoading, ModuleErrorBoundary } from "./DynamicModule";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/router/index.js

@@ -0,0 +1 @@
+export { DynamicModule, ModuleLoading, ModuleErrorBoundary } from "./DynamicModule";

package/dist/shell/AdminShell.d.ts

@@ -0,0 +1,38 @@
+import type { AuthClient } from "../auth/client/interface";
+import type { AdminModuleManifest, RegistryClient } from "../registry";
+export interface AdminShellProps {
+    /**
+     * Module manifests to load (used for standalone mode when no registryClient)
+     * In standalone mode, modules are rendered via children prop
+     */
+    modules?: AdminModuleManifest[];
+    /**
+     * Content to render for standalone module development.
+     * Only used in standalone mode (when modules prop is provided)
+     */
+    children?: React.ReactNode;
+    /**
+     * Keycloak configuration
+     * If not provided, uses in-memory (mock) authentication
+     */
+    keycloak?: {
+        url: string;
+        realm: string;
+        clientId: string;
+    };
+    /**
+     * Auth client to use for authentication.
+     * If not provided, creates one based on keycloak prop or environment.
+     */
+    authClient?: AuthClient;
+    /** Registry client for fetching modules from API */
+    registryClient?: RegistryClient;
+    /** API URL for registry management (e.g., "http://localhost:4000/api") */
+    apiUrl?: string;
+    /** Use in-memory registry (default: true, ignored if registryClient is provided) */
+    inMemoryRegistry?: boolean;
+    /** Environment (default: "local") */
+    environment?: string;
+}
+export declare function AdminShell({ modules: manifests, children, keycloak, authClient: providedAuthClient, registryClient, apiUrl, inMemoryRegistry, environment, }: AdminShellProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=AdminShell.d.ts.map

package/dist/shell/AdminShell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdminShell.d.ts","sourceRoot":"","sources":["../../src/shell/AdminShell.tsx"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAiB,MAAM,aAAa,CAAC;AAMtF,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,EAAE;QACT,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,oDAAoD;IACpD,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA8RD,wBAAgB,UAAU,CAAC,EACzB,OAAO,EAAE,SAAc,EACvB,QAAQ,EACR,QAAQ,EACR,UAAU,EAAE,kBAAkB,EAC9B,cAAc,EACd,MAAM,EACN,gBAAuB,EACvB,WAAqB,GACtB,EAAE,eAAe,2CAsLjB"}