@nsxbet/admin-sdk 0.1.0

package/dist/registry/client/in-memory.js

@@ -0,0 +1,242 @@
+/**
+ * In-Memory Registry Client
+ *
+ * Implementation of RegistryClient that stores data in localStorage.
+ * Used for local development and testing without a backend.
+ */
+import { parseManifest } from '../types';
+const DEFAULT_STORAGE_KEY = '@nsxbet/registry';
+/**
+ * Create an in-memory registry client
+ */
+export function createInMemoryRegistryClient(options = {}) {
+    const storageKey = options.storageKey ?? DEFAULT_STORAGE_KEY;
+    // Initialize or load storage
+    let data = loadStorage(storageKey);
+    // Apply seed if provided and storage is empty
+    // Note: seed is for standalone mode where modules are imported directly (no baseUrl needed)
+    if (options.seed && data.modules.length === 0) {
+        const now = new Date().toISOString();
+        for (const manifest of options.seed) {
+            const validated = parseManifest(manifest);
+            data.modules.push({
+                id: ++data.autoIncrement,
+                moduleId: validated.id,
+                baseUrl: '',
+                manifest: validated,
+                navOrder: validated.navOrder ?? data.autoIncrement * 10,
+                enabled: true,
+                registeredAt: now,
+                updatedAt: now,
+            });
+        }
+        saveStorage(storageKey, data);
+    }
+    // Apply initialModules if provided and storage is empty
+    if (options.initialModules && data.modules.length === 0) {
+        const now = new Date().toISOString();
+        for (const moduleConfig of options.initialModules) {
+            const { baseUrl, ...manifestData } = moduleConfig;
+            const validated = parseManifest(manifestData);
+            data.modules.push({
+                id: ++data.autoIncrement,
+                moduleId: validated.id,
+                baseUrl,
+                manifest: validated,
+                navOrder: validated.navOrder ?? data.autoIncrement * 10,
+                enabled: true,
+                registeredAt: now,
+                updatedAt: now,
+            });
+        }
+        saveStorage(storageKey, data);
+    }
+    // Module operations
+    const modules = {
+        async findAll(filters) {
+            data = loadStorage(storageKey);
+            let result = [...data.modules];
+            if (filters?.enabled !== undefined) {
+                result = result.filter((m) => m.enabled === filters.enabled);
+            }
+            if (filters?.category) {
+                result = result.filter((m) => m.manifest.category === filters.category);
+            }
+            if (filters?.status) {
+                result = result.filter((m) => m.manifest.status === filters.status);
+            }
+            // Sort by navOrder
+            result.sort((a, b) => a.navOrder - b.navOrder);
+            return result;
+        },
+        async find(id) {
+            data = loadStorage(storageKey);
+            const module = data.modules.find((m) => m.id === id);
+            if (!module) {
+                throw new Error(`Module with id ${id} not found`);
+            }
+            return module;
+        },
+        async register(baseUrl) {
+            // Fetch module.manifest.json from URL to get metadata
+            // Note: entry is NOT stored - DynamicModule fetches it at runtime
+            const manifestUrl = baseUrl.endsWith('/')
+                ? `${baseUrl}module.manifest.json`
+                : `${baseUrl}/module.manifest.json`;
+            const response = await fetch(manifestUrl);
+            if (!response.ok) {
+                throw new Error(`Failed to fetch manifest from ${manifestUrl}: ${response.status}`);
+            }
+            const manifestData = await response.json();
+            // Extract manifest without entry (entry is fetched by DynamicModule at runtime)
+            const { entry: _entry, ...manifest } = manifestData;
+            const validated = parseManifest(manifest);
+            return this.registerFromManifest(validated, baseUrl);
+        },
+        async registerFromManifest(manifest, baseUrl = '') {
+            data = loadStorage(storageKey);
+            // Validate manifest
+            const validated = parseManifest(manifest);
+            // Check for duplicate moduleId
+            if (data.modules.some((m) => m.moduleId === validated.id)) {
+                throw new Error(`Module with id ${validated.id} already exists`);
+            }
+            const now = new Date().toISOString();
+            const newModule = {
+                id: ++data.autoIncrement,
+                moduleId: validated.id,
+                baseUrl,
+                manifest: validated,
+                navOrder: validated.navOrder ?? data.autoIncrement * 10,
+                enabled: true,
+                registeredAt: now,
+                updatedAt: now,
+            };
+            data.modules.push(newModule);
+            saveStorage(storageKey, data);
+            return newModule;
+        },
+        async update(id, updateData) {
+            data = loadStorage(storageKey);
+            const index = data.modules.findIndex((m) => m.id === id);
+            if (index === -1) {
+                throw new Error(`Module with id ${id} not found`);
+            }
+            const module = data.modules[index];
+            const updated = {
+                ...module,
+                ...(updateData.navOrder !== undefined && { navOrder: updateData.navOrder }),
+                ...(updateData.enabled !== undefined && { enabled: updateData.enabled }),
+                updatedAt: new Date().toISOString(),
+            };
+            data.modules[index] = updated;
+            saveStorage(storageKey, data);
+            return updated;
+        },
+        async delete(id) {
+            data = loadStorage(storageKey);
+            const index = data.modules.findIndex((m) => m.id === id);
+            if (index === -1) {
+                throw new Error(`Module with id ${id} not found`);
+            }
+            data.modules.splice(index, 1);
+            saveStorage(storageKey, data);
+        },
+        async reorder(order) {
+            data = loadStorage(storageKey);
+            const now = new Date().toISOString();
+            for (const { id, navOrder } of order) {
+                const module = data.modules.find((m) => m.id === id);
+                if (module) {
+                    module.navOrder = navOrder;
+                    module.updatedAt = now;
+                }
+            }
+            saveStorage(storageKey, data);
+        },
+    };
+    // Catalog operations
+    const catalog = {
+        async get() {
+            const allModules = await modules.findAll({ enabled: true });
+            const catalogModules = allModules.map((m) => ({
+                id: m.manifest.id,
+                title: m.manifest.title,
+                description: m.manifest.description ?? '',
+                category: m.manifest.category ?? 'General',
+                routeBase: m.manifest.routeBase,
+                baseUrl: m.baseUrl,
+                keywords: m.manifest.keywords ?? [],
+                permissions: {
+                    view: m.manifest.permissions?.view ?? [],
+                    dangerous: m.manifest.permissions?.dangerous,
+                },
+                owners: {
+                    team: m.manifest.owners?.team ?? 'unknown',
+                    supportChannel: m.manifest.owners?.supportChannel ?? '#general',
+                },
+                status: m.manifest.status ?? 'active',
+                navOrder: m.navOrder,
+                icon: m.manifest.icon,
+                commands: m.manifest.commands?.map((cmd) => ({
+                    id: cmd.id,
+                    title: cmd.title,
+                    keywords: cmd.keywords,
+                    route: cmd.route,
+                    icon: cmd.icon,
+                })),
+            }));
+            return {
+                version: '1.0.0',
+                generatedAt: new Date().toISOString(),
+                modules: catalogModules,
+            };
+        },
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        async getImportMap(_environment) {
+            const allModules = await modules.findAll({ enabled: true });
+            const imports = {};
+            for (const m of allModules) {
+                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.moduleId] = `${base}/module.manifest.json`;
+                }
+            }
+            return { imports };
+        },
+    };
+    return { modules, catalog };
+}
+/**
+ * Load storage data from localStorage
+ */
+function loadStorage(key) {
+    try {
+        const stored = localStorage.getItem(key);
+        if (stored) {
+            return JSON.parse(stored);
+        }
+    }
+    catch (error) {
+        console.error('[InMemoryRegistry] Failed to load storage:', error);
+    }
+    return { modules: [], autoIncrement: 0 };
+}
+/**
+ * Save storage data to localStorage
+ */
+function saveStorage(key, data) {
+    try {
+        localStorage.setItem(key, JSON.stringify(data));
+    }
+    catch (error) {
+        console.error('[InMemoryRegistry] Failed to save storage:', error);
+    }
+}
+/**
+ * Clear all registry data from localStorage
+ */
+export function clearInMemoryRegistry(storageKey = DEFAULT_STORAGE_KEY) {
+    localStorage.removeItem(storageKey);
+}

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

@@ -0,0 +1,7 @@
+/**
+ * Registry Client Exports
+ */
+export type { RegistryClient, ModuleOperations, CatalogOperations } from './interface';
+export { createInMemoryRegistryClient, clearInMemoryRegistry, type InMemoryRegistryOptions, type PreConfiguredModule, } from './in-memory';
+export { createHttpRegistryClient, type HttpRegistryOptions, } from './http';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/registry/client/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEvF,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,wBAAwB,EACxB,KAAK,mBAAmB,GACzB,MAAM,QAAQ,CAAC"}

package/dist/registry/client/index.js

@@ -0,0 +1,5 @@
+/**
+ * Registry Client Exports
+ */
+export { createInMemoryRegistryClient, clearInMemoryRegistry, } from './in-memory';
+export { createHttpRegistryClient, } from './http';

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

@@ -0,0 +1,96 @@
+/**
+ * Registry Client Interface
+ *
+ * Defines the interface for registry operations.
+ * Can be implemented by in-memory (localStorage) or HTTP clients.
+ */
+import type { RegisteredModule, UpdateModuleDto, ReorderModuleDto, ModuleFilters, Catalog, ImportMap, AdminModuleManifest } from '../types';
+/**
+ * Module operations interface
+ */
+export interface ModuleOperations {
+    /**
+     * List all registered modules
+     * @param filters Optional filters
+     */
+    findAll(filters?: ModuleFilters): Promise<RegisteredModule[]>;
+    /**
+     * Get a single module by ID
+     * @param id Module ID
+     */
+    find(id: number): Promise<RegisteredModule>;
+    /**
+     * Register a new module by URL (fetches admin.module.json)
+     * @param baseUrl Base URL of the module
+     */
+    register(baseUrl: string): Promise<RegisteredModule>;
+    /**
+     * Register a new module from a manifest directly
+     * @param manifest The module manifest
+     * @param baseUrl Optional base URL
+     */
+    registerFromManifest(manifest: AdminModuleManifest, baseUrl?: string): Promise<RegisteredModule>;
+    /**
+     * Update admin-controlled fields of a module
+     * @param id Module ID
+     * @param data Update data
+     */
+    update(id: number, data: UpdateModuleDto): Promise<RegisteredModule>;
+    /**
+     * Delete a module
+     * @param id Module ID
+     */
+    delete(id: number): Promise<void>;
+    /**
+     * Reorder modules (batch update navOrder)
+     * @param order Array of id and navOrder pairs
+     */
+    reorder(order: ReorderModuleDto[]): Promise<void>;
+}
+/**
+ * Catalog operations interface (read-only)
+ */
+export interface CatalogOperations {
+    /**
+     * Get the full catalog (denormalized for shell consumption)
+     */
+    get(): Promise<Catalog>;
+    /**
+     * Get the import map for a specific environment
+     * @param environment Environment name (e.g., 'production', 'local')
+     */
+    getImportMap(environment: string): Promise<ImportMap>;
+}
+/**
+ * Registry Client Interface
+ *
+ * Usage:
+ * ```typescript
+ * const registry = createRegistryClient();
+ *
+ * // List modules
+ * const modules = await registry.modules.findAll();
+ *
+ * // Register by URL
+ * await registry.modules.register('https://my-module.com');
+ *
+ * // Update
+ * await registry.modules.update(1, { enabled: false });
+ *
+ * // Reorder
+ * await registry.modules.reorder([
+ *   { id: 1, navOrder: 2 },
+ *   { id: 2, navOrder: 1 },
+ * ]);
+ *
+ * // Get catalog
+ * const catalog = await registry.catalog.get();
+ * ```
+ */
+export interface RegistryClient {
+    /** Module operations */
+    modules: ModuleOperations;
+    /** Catalog operations (read-only) */
+    catalog: CatalogOperations;
+}
+//# sourceMappingURL=interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../src/registry/client/interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,OAAO,EACP,SAAS,EACT,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAE9D;;;OAGG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE5C;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAErD;;;;OAIG;IACH,oBAAoB,CAAC,QAAQ,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEjG;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAErE;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAExB;;;OAGG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CACvD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,OAAO,EAAE,gBAAgB,CAAC;IAE1B,qCAAqC;IACrC,OAAO,EAAE,iBAAiB,CAAC;CAC5B"}

package/dist/registry/client/interface.js

@@ -0,0 +1,7 @@
+/**
+ * Registry Client Interface
+ *
+ * Defines the interface for registry operations.
+ * Can be implemented by in-memory (localStorage) or HTTP clients.
+ */
+export {};

package/dist/registry/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Registry Module
+ *
+ * Provides types and clients for module registry management.
+ */
+export type { AdminModuleManifest, ModuleCommand, ModulePermissions, ModuleOwners, ModuleStatus, RegisteredModule, UpdateModuleDto, ReorderModuleDto, ModuleFilters, Catalog, CatalogModule, ImportMap, } from './types';
+export { validateManifest, parseManifest } from './types';
+export type { RegistryClient, ModuleOperations, CatalogOperations } from './client';
+export { createInMemoryRegistryClient, clearInMemoryRegistry, createHttpRegistryClient, type InMemoryRegistryOptions, type PreConfiguredModule, type HttpRegistryOptions, } from './client';
+export type { RegistryContextValue, AdminShellRegistryProps, } from './AdminShellRegistry';
+export { AdminShellRegistry, useRegistry, useRegistryClient, } from './AdminShellRegistry';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,OAAO,EACP,aAAa,EACb,SAAS,GACV,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG1D,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEpF,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,EACrB,wBAAwB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB,MAAM,UAAU,CAAC;AAGlB,YAAY,EACV,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,iBAAiB,GAClB,MAAM,sBAAsB,CAAC"}

package/dist/registry/index.js

@@ -0,0 +1,8 @@
+/**
+ * Registry Module
+ *
+ * Provides types and clients for module registry management.
+ */
+export { validateManifest, parseManifest } from './types';
+export { createInMemoryRegistryClient, clearInMemoryRegistry, createHttpRegistryClient, } from './client';
+export { AdminShellRegistry, useRegistry, useRegistryClient, } from './AdminShellRegistry';

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

@@ -0,0 +1,9 @@
+/**
+ * Registry Types
+ *
+ * Re-exports all registry-related types.
+ */
+export type { AdminModuleManifest, ModuleCommand, ModulePermissions, ModuleOwners, ModuleStatus, } from './manifest';
+export { validateManifest, parseManifest } from './manifest';
+export type { RegisteredModule, UpdateModuleDto, ReorderModuleDto, ModuleFilters, Catalog, CatalogModule, ImportMap, } from './module';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/registry/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7D,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,OAAO,EACP,aAAa,EACb,SAAS,GACV,MAAM,UAAU,CAAC"}

package/dist/registry/types/index.js

@@ -0,0 +1,6 @@
+/**
+ * Registry Types
+ *
+ * Re-exports all registry-related types.
+ */
+export { validateManifest, parseManifest } from './manifest';

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

@@ -0,0 +1,98 @@
+/**
+ * Admin Module Manifest Schema
+ *
+ * This interface defines the structure of admin.module.json files
+ * that module developers create to register their modules.
+ */
+/**
+ * Command within a module that can be searched and invoked
+ */
+export interface ModuleCommand {
+    /** Unique identifier for the command within the module */
+    id: string;
+    /** Human-readable title */
+    title: string;
+    /** i18n key for the title (for translation) */
+    titleKey?: string;
+    /** Route path for this command */
+    route: string;
+    /** Optional Lucide icon name in kebab-case (e.g., "clipboard-list", "file-text") */
+    icon?: string;
+    /** Keywords for search */
+    keywords?: string[];
+}
+/**
+ * Permission configuration for a module
+ */
+export interface ModulePermissions {
+    /** Permissions required to view the module */
+    view?: string[];
+    /** Permissions required to edit within the module */
+    edit?: string[];
+    /** Permissions required to delete within the module */
+    delete?: string[];
+    /** Dangerous permissions that require extra confirmation */
+    dangerous?: string[];
+}
+/**
+ * Module ownership information
+ */
+export interface ModuleOwners {
+    /** Team responsible for the module */
+    team?: string;
+    /** Support channel (e.g., Slack channel) */
+    supportChannel?: string;
+}
+/**
+ * Module status
+ */
+export type ModuleStatus = 'active' | 'deprecated' | 'disabled';
+/**
+ * Admin Module Manifest
+ *
+ * The structure of admin.module.json files that define a module's metadata.
+ */
+export interface AdminModuleManifest {
+    /** Unique identifier for the module (e.g., "@admin/tasks") */
+    id: string;
+    /** Human-readable title */
+    title: string;
+    /** Base route where module is mounted (e.g., "/admin/tasks") */
+    routeBase: string;
+    /** i18n key for the title (for translation) */
+    titleKey?: string;
+    /** URL slug (derived from id if not provided) */
+    slug?: string;
+    /** Description of what the module does */
+    description?: string;
+    /** i18n key for the description (for translation) */
+    descriptionKey?: string;
+    /** Category for navigation grouping (e.g., "Tools", "Customer") */
+    category?: string;
+    /** Semantic version */
+    version?: string;
+    /** Lucide icon name in kebab-case (e.g., "users", "clipboard-list") */
+    icon?: string;
+    /** Keywords for search */
+    keywords?: string[];
+    /** Navigation order (lower = higher priority) */
+    navOrder?: number;
+    /** Module status */
+    status?: ModuleStatus;
+    /** Commands/actions available in this module */
+    commands?: ModuleCommand[];
+    /** Permission configuration */
+    permissions?: ModulePermissions;
+    /** Module ownership info */
+    owners?: ModuleOwners;
+}
+/**
+ * Validates that an object is a valid AdminModuleManifest
+ */
+export declare function validateManifest(value: unknown): value is AdminModuleManifest;
+/**
+ * Parse and validate a manifest from unknown input
+ * @throws Error if validation fails
+ */
+export declare function parseManifest(value: unknown): AdminModuleManifest;
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/registry/types/manifest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,CAAC;AAEhE;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAElC,8DAA8D;IAC9D,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAGlB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,MAAM,CAAC,EAAE,YAAY,CAAC;IAGtB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAG3B,+BAA+B;IAC/B,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAGhC,4BAA4B;IAC5B,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CA4D7E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAKjE"}

package/dist/registry/types/manifest.js

@@ -0,0 +1,81 @@
+/**
+ * Admin Module Manifest Schema
+ *
+ * This interface defines the structure of admin.module.json files
+ * that module developers create to register their modules.
+ */
+/**
+ * Validates that an object is a valid AdminModuleManifest
+ */
+export function validateManifest(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const obj = value;
+    // Required fields
+    if (typeof obj.id !== 'string' || obj.id.trim() === '') {
+        return false;
+    }
+    if (typeof obj.title !== 'string' || obj.title.trim() === '') {
+        return false;
+    }
+    if (typeof obj.routeBase !== 'string' || !obj.routeBase.startsWith('/')) {
+        return false;
+    }
+    // Optional field validations
+    if (obj.slug !== undefined && typeof obj.slug !== 'string') {
+        return false;
+    }
+    if (obj.description !== undefined && typeof obj.description !== 'string') {
+        return false;
+    }
+    if (obj.category !== undefined && typeof obj.category !== 'string') {
+        return false;
+    }
+    if (obj.version !== undefined && typeof obj.version !== 'string') {
+        return false;
+    }
+    if (obj.icon !== undefined && typeof obj.icon !== 'string') {
+        return false;
+    }
+    if (obj.navOrder !== undefined && typeof obj.navOrder !== 'number') {
+        return false;
+    }
+    if (obj.status !== undefined &&
+        obj.status !== 'active' &&
+        obj.status !== 'deprecated' &&
+        obj.status !== 'disabled') {
+        return false;
+    }
+    if (obj.keywords !== undefined) {
+        if (!Array.isArray(obj.keywords))
+            return false;
+        if (!obj.keywords.every((k) => typeof k === 'string'))
+            return false;
+    }
+    if (obj.commands !== undefined) {
+        if (!Array.isArray(obj.commands))
+            return false;
+        for (const cmd of obj.commands) {
+            if (typeof cmd !== 'object' || cmd === null)
+                return false;
+            if (typeof cmd.id !== 'string')
+                return false;
+            if (typeof cmd.title !== 'string')
+                return false;
+            if (typeof cmd.route !== 'string')
+                return false;
+        }
+    }
+    return true;
+}
+/**
+ * Parse and validate a manifest from unknown input
+ * @throws Error if validation fails
+ */
+export function parseManifest(value) {
+    if (!validateManifest(value)) {
+        throw new Error('Invalid manifest: must have id, title, and routeBase (starting with /)');
+    }
+    return value;
+}