@zudojs/core 0.0.1

package/dist/modules/moduleLoader/moduleLoader.loader.js

@@ -0,0 +1,164 @@
+import { createModuleContext } from "../moduleContext.context.js";
+import { createModuleDependencyGraph, resolveModuleStartupOrder, validateModuleDependencyGraph, } from "../moduleDependency/index.js";
+import { ModuleLoadError } from "./moduleLoader.type.js";
+/**
+ * Default module loader.
+ *
+ * Reads definitions from registry, builds dependency graph,
+ * validates, resolves startup order, instantiates modules.
+ */
+export class ModuleLoader {
+    application;
+    configuration;
+    logger;
+    registry;
+    allowExplicitLoad;
+    contexts = new Map();
+    constructor(registry, options) {
+        this.registry = registry;
+        this.application = options.application;
+        this.configuration = options.configuration;
+        this.logger = options.logger;
+        this.allowExplicitLoad = options.allowExplicitLoad ?? true;
+    }
+    /** Loads every module whose definition has autoLoad enabled. */
+    async loadAll() {
+        const definitions = this.registry
+            .getDefinitions()
+            .filter((d) => d.autoLoad !== false);
+        return this.loadDefinitions(definitions);
+    }
+    /** Loads a specific module and all of its required dependencies. */
+    async load(moduleId) {
+        const registration = this.registry.require(moduleId);
+        if (registration.state === "loaded" && registration.instance)
+            return registration.instance;
+        if (registration.definition.autoLoad === false && !this.allowExplicitLoad) {
+            throw new ModuleLoadError(moduleId, new Error(`Module "${moduleId}" is not configured for explicit loading.`));
+        }
+        const definitions = this.collectDependencies(moduleId);
+        await this.loadDefinitions(definitions);
+        const loaded = this.registry.require(moduleId);
+        if (!loaded.instance)
+            throw new ModuleLoadError(moduleId, new Error("Module was not instantiated."));
+        return loaded.instance;
+    }
+    async loadDefinitions(definitions) {
+        if (definitions.length === 0)
+            return { loaded: [], alreadyLoaded: [], skipped: [], order: [] };
+        const graph = this.createGraph(definitions);
+        const missing = validateModuleDependencyGraph(graph);
+        if (missing.length > 0)
+            throw new ModuleLoadError("module-dependencies", new Error(`Missing required modules: ${missing.join(", ")}`));
+        const order = resolveModuleStartupOrder(graph);
+        const loaded = [];
+        const alreadyLoaded = [];
+        const skipped = [];
+        for (const moduleId of order) {
+            const registration = this.registry.get(moduleId);
+            if (!registration)
+                throw new ModuleLoadError(moduleId, new Error(`Module "${moduleId}" disappeared from the registry during loading.`));
+            if (registration.state === "loaded" && registration.instance) {
+                alreadyLoaded.push(registration.instance);
+                continue;
+            }
+            if (registration.definition.autoLoad === false &&
+                !this.isExplicitlyRequested(moduleId, definitions)) {
+                skipped.push(moduleId);
+                continue;
+            }
+            const instance = await this.instantiate(registration.definition);
+            loaded.push(instance);
+        }
+        return {
+            loaded: Object.freeze([...loaded]),
+            alreadyLoaded: Object.freeze([...alreadyLoaded]),
+            skipped: Object.freeze([...skipped]),
+            order: Object.freeze([...order]),
+        };
+    }
+    createGraph(definitions) {
+        const nodes = definitions.map((d) => ({
+            id: d.id,
+            dependencies: this.registry.getDependencies(d.id),
+        }));
+        return createModuleDependencyGraph(nodes);
+    }
+    collectDependencies(moduleId) {
+        const collected = new Map();
+        const visit = (currentId) => {
+            if (collected.has(currentId))
+                return;
+            const registration = this.registry.require(currentId);
+            collected.set(currentId, registration.definition);
+            for (const dependency of this.registry.getDependencies(currentId)) {
+                if (dependency.optional && !this.registry.has(dependency.id))
+                    continue;
+                if (this.registry.has(dependency.id))
+                    visit(dependency.id);
+            }
+        };
+        visit(moduleId);
+        return Object.freeze([...collected.values()]);
+    }
+    async instantiate(definition) {
+        const moduleId = definition.id;
+        this.registry.setState(moduleId, "loading");
+        try {
+            const module = await definition.factory(definition.options);
+            if (!module || typeof module !== "object")
+                throw new TypeError(`Module factory for "${moduleId}" did not return a valid module.`);
+            if (module.id !== moduleId)
+                throw new TypeError(`Module factory returned module "${module.id}" but expected "${moduleId}".`);
+            if (typeof module.attach === "function")
+                module.attach(this.application);
+            const moduleLogger = this.createModuleLogger(module);
+            const context = createModuleContext({
+                module,
+                dependencies: {
+                    application: this.application,
+                    configuration: this.configuration,
+                    logger: moduleLogger,
+                },
+                metadata: definition.metadata,
+                moduleContexts: this.contexts,
+            });
+            this.contexts.set(moduleId, context);
+            this.registry.setState(moduleId, "loaded", { instance: module });
+            return module;
+        }
+        catch (error) {
+            this.registry.setState(moduleId, "failed", { error });
+            throw new ModuleLoadError(moduleId, error);
+        }
+    }
+    createModuleLogger(module) {
+        const logger = this.logger;
+        if (typeof logger.child === "function")
+            return logger.child({ moduleId: module.id, module: module.name });
+        return this.logger;
+    }
+    isExplicitlyRequested(moduleId, definitions) {
+        return definitions.some((d) => d.id === moduleId);
+    }
+    getContext(moduleId) {
+        return this.contexts.get(moduleId);
+    }
+    requireContext(moduleId) {
+        const context = this.getContext(moduleId);
+        if (!context)
+            throw new Error(`Module "${moduleId}" has not been loaded.`);
+        return context;
+    }
+    getContexts() {
+        return new Map(this.contexts);
+    }
+    isLoaded(moduleId) {
+        return this.registry.get(moduleId)?.state === "loaded";
+    }
+}
+/** Creates a module loader. */
+export function createModuleLoader(registry, options) {
+    return new ModuleLoader(registry, options);
+}
+//# sourceMappingURL=moduleLoader.loader.js.map

package/dist/modules/moduleLoader/moduleLoader.loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleLoader.loader.js","sourceRoot":"","sources":["../../../src/modules/moduleLoader/moduleLoader.loader.ts"],"names":[],"mappings":"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"}

package/dist/modules/moduleLoader/moduleLoader.type.d.ts

@@ -0,0 +1,57 @@
+import type { ApplicationContext } from "../../application/applicationContext.context.js";
+import type { ConfigurationManager } from "../../configuration/configurationManager.manager.js";
+import type { Logger } from "../../logging/core/logger.js";
+import type { ModuleId } from "../module.js";
+/**
+ * Options used by the module loader.
+ */
+export interface ModuleLoaderOptions {
+    /**
+     * Application context supplied to modules.
+     */
+    readonly application: ApplicationContext;
+    /**
+     * Configuration manager.
+     */
+    readonly configuration: ConfigurationManager;
+    /**
+     * Base logger used to create module-scoped loggers.
+     */
+    readonly logger: Logger;
+    /**
+     * Whether modules marked `autoLoad: false` should
+     * still be loaded when explicitly requested.
+     *
+     * Defaults to true.
+     */
+    readonly allowExplicitLoad?: boolean;
+}
+/**
+ * Result returned after loading modules.
+ */
+export interface ModuleLoadResult {
+    /**
+     * Modules successfully loaded.
+     */
+    readonly loaded: readonly import("../module.js").Module[];
+    /**
+     * Modules that were already loaded.
+     */
+    readonly alreadyLoaded: readonly import("../module.js").Module[];
+    /**
+     * Modules skipped because auto loading was disabled.
+     */
+    readonly skipped: readonly ModuleId[];
+    /**
+     * Startup order used by the loader.
+     */
+    readonly order: readonly ModuleId[];
+}
+import { ModuleLoadError as BaseModuleLoadError } from "@zudojs/errors";
+/**
+ * Error thrown when one or more modules cannot be loaded.
+ */
+export declare class ModuleLoadError extends BaseModuleLoadError {
+    constructor(moduleId: ModuleId, cause: unknown);
+}
+//# sourceMappingURL=moduleLoader.type.d.ts.map

package/dist/modules/moduleLoader/moduleLoader.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleLoader.type.d.ts","sourceRoot":"","sources":["../../../src/modules/moduleLoader/moduleLoader.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AAE1F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qDAAqD,CAAC;AAEhG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IAEzC;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;IAE7C;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;;;;OAKG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,cAAc,EAAE,MAAM,EAAE,CAAC;IAE1D;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,SAAS,OAAO,cAAc,EAAE,MAAM,EAAE,CAAC;IAEjE;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,CAAC;IAEtC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;CACrC;AAED,OAAO,EAAE,eAAe,IAAI,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAExE;;GAEG;AACH,qBAAa,eAAgB,SAAQ,mBAAmB;IACtD,YAAmB,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAIpD;CACF"}

package/dist/modules/moduleLoader/moduleLoader.type.js

@@ -0,0 +1,11 @@
+import { ModuleLoadError as BaseModuleLoadError } from "@zudojs/errors";
+/**
+ * Error thrown when one or more modules cannot be loaded.
+ */
+export class ModuleLoadError extends BaseModuleLoadError {
+    constructor(moduleId, cause) {
+        const message = cause instanceof Error ? cause.message : String(cause);
+        super(moduleId, `Failed to load module "${moduleId}": ${message}`, cause);
+    }
+}
+//# sourceMappingURL=moduleLoader.type.js.map

package/dist/modules/moduleLoader/moduleLoader.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleLoader.type.js","sourceRoot":"","sources":["../../../src/modules/moduleLoader/moduleLoader.type.ts"],"names":[],"mappings":"AA6DA,OAAO,EAAE,eAAe,IAAI,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAExE;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,mBAAmB;IACtD,YAAmB,QAAkB,EAAE,KAAc;QACnD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEvE,KAAK,CAAC,QAAQ,EAAE,0BAA0B,QAAQ,MAAM,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;IAC5E,CAAC;CACF"}

package/dist/modules/moduleMetadata.metadata.d.ts

@@ -0,0 +1,36 @@
+import type { ModuleId } from "./module.js";
+import type { Environment } from "@zudojs/constants";
+/** Environment in which a module is intended to run. */
+export type ModuleEnvironment = Environment;
+/** Category describing the role of a module. */
+export type ModuleCategory = "application" | "infrastructure" | "domain" | "integration" | "transport" | "observability" | "security" | "system" | "custom";
+/** Metadata describing a Zudojs module. */
+export interface ModuleMetadata {
+    readonly description?: string;
+    readonly author?: string;
+    readonly homepage?: string;
+    readonly repository?: string;
+    readonly category?: ModuleCategory;
+    readonly tags?: readonly string[];
+    readonly environments?: readonly ModuleEnvironment[];
+    readonly experimental?: boolean;
+    readonly deprecated?: boolean;
+    readonly deprecationMessage?: string;
+    readonly replacement?: ModuleId;
+    readonly extra?: Readonly<Record<string, unknown>>;
+}
+export interface ModuleMetadataOptions extends ModuleMetadata {
+}
+/** Creates immutable module metadata. */
+export declare function createModuleMetadata(options?: ModuleMetadataOptions): ModuleMetadata;
+/** Merges two metadata objects. Values from `override` take precedence. */
+export declare function mergeModuleMetadata(base?: ModuleMetadata, override?: ModuleMetadata): ModuleMetadata;
+/** Determines whether a module is enabled for an environment. */
+export declare function isModuleEnabledForEnvironment(metadata: ModuleMetadata | undefined, environment: ModuleEnvironment): boolean;
+/** Determines whether a module is deprecated. */
+export declare function isModuleDeprecated(metadata: ModuleMetadata | undefined): boolean;
+/** Determines whether a module is experimental. */
+export declare function isModuleExperimental(metadata: ModuleMetadata | undefined): boolean;
+/** Creates a compact metadata object suitable for diagnostics. */
+export declare function getModuleMetadataSummary(metadata?: ModuleMetadata): Readonly<Record<string, unknown>>;
+//# sourceMappingURL=moduleMetadata.metadata.d.ts.map

package/dist/modules/moduleMetadata.metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleMetadata.metadata.d.ts","sourceRoot":"","sources":["../../src/modules/moduleMetadata.metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,wDAAwD;AACxD,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC;AAE5C,gDAAgD;AAChD,MAAM,MAAM,cAAc,GACtB,aAAa,GACb,gBAAgB,GAChB,QAAQ,GACR,aAAa,GACb,WAAW,GACX,eAAe,GACf,UAAU,GACV,QAAQ,GACR,QAAQ,CAAC;AAEb,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACrD,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,qBAAsB,SAAQ,cAAc;CAAG;AAyDhE,yCAAyC;AACzC,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,qBAA0B,GAClC,cAAc,CAiBhB;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,CACjC,IAAI,CAAC,EAAE,cAAc,EACrB,QAAQ,CAAC,EAAE,cAAc,GACxB,cAAc,CAShB;AAED,iEAAiE;AACjE,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,cAAc,GAAG,SAAS,EACpC,WAAW,EAAE,iBAAiB,GAC7B,OAAO,CAIT;AAED,iDAAiD;AACjD,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,cAAc,GAAG,SAAS,GACnC,OAAO,CAET;AAED,mDAAmD;AACnD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,cAAc,GAAG,SAAS,GACnC,OAAO,CAET;AAED,kEAAkE;AAClE,wBAAgB,wBAAwB,CACtC,QAAQ,CAAC,EAAE,cAAc,GACxB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAYnC"}

package/dist/modules/moduleMetadata.metadata.js

@@ -0,0 +1,105 @@
+function normalizeOptionalString(value) {
+    if (value === undefined)
+        return undefined;
+    const normalized = value.trim();
+    return normalized.length > 0 ? normalized : undefined;
+}
+function normalizeTags(tags) {
+    if (!tags || tags.length === 0)
+        return undefined;
+    const normalized = new Set();
+    for (const tag of tags) {
+        const value = tag.trim();
+        if (value.length > 0)
+            normalized.add(value);
+    }
+    if (normalized.size === 0)
+        return undefined;
+    return Object.freeze([...normalized]);
+}
+function normalizeEnvironments(environments) {
+    if (!environments || environments.length === 0)
+        return undefined;
+    return Object.freeze([...new Set(environments)]);
+}
+function isValidUrl(value) {
+    try {
+        const url = new URL(value);
+        return url.protocol === "http:" || url.protocol === "https:";
+    }
+    catch {
+        return false;
+    }
+}
+function validateModuleMetadata(metadata) {
+    if (metadata.deprecated &&
+        metadata.deprecationMessage === undefined &&
+        metadata.replacement === undefined) {
+        throw new TypeError("Deprecated modules should provide either a deprecationMessage or replacement module.");
+    }
+    if (metadata.homepage && !isValidUrl(metadata.homepage))
+        throw new TypeError(`Invalid module homepage URL: ${metadata.homepage}`);
+    if (metadata.repository && !isValidUrl(metadata.repository))
+        throw new TypeError(`Invalid module repository URL: ${metadata.repository}`);
+}
+/** Creates immutable module metadata. */
+export function createModuleMetadata(options = {}) {
+    const metadata = {
+        description: normalizeOptionalString(options.description),
+        author: normalizeOptionalString(options.author),
+        homepage: normalizeOptionalString(options.homepage),
+        repository: normalizeOptionalString(options.repository),
+        category: options.category,
+        tags: normalizeTags(options.tags),
+        environments: normalizeEnvironments(options.environments),
+        experimental: options.experimental ?? false,
+        deprecated: options.deprecated ?? false,
+        deprecationMessage: normalizeOptionalString(options.deprecationMessage),
+        replacement: normalizeOptionalString(options.replacement),
+        extra: options.extra ? Object.freeze({ ...options.extra }) : undefined,
+    };
+    validateModuleMetadata(metadata);
+    return Object.freeze(metadata);
+}
+/** Merges two metadata objects. Values from `override` take precedence. */
+export function mergeModuleMetadata(base, override) {
+    if (!base && !override)
+        return createModuleMetadata();
+    return createModuleMetadata({
+        ...(base ?? {}),
+        ...(override ?? {}),
+        tags: [...(base?.tags ?? []), ...(override?.tags ?? [])],
+        environments: override?.environments ?? base?.environments,
+        extra: { ...(base?.extra ?? {}), ...(override?.extra ?? {}) },
+    });
+}
+/** Determines whether a module is enabled for an environment. */
+export function isModuleEnabledForEnvironment(metadata, environment) {
+    if (!metadata?.environments || metadata.environments.length === 0)
+        return true;
+    return metadata.environments.includes(environment);
+}
+/** Determines whether a module is deprecated. */
+export function isModuleDeprecated(metadata) {
+    return metadata?.deprecated === true;
+}
+/** Determines whether a module is experimental. */
+export function isModuleExperimental(metadata) {
+    return metadata?.experimental === true;
+}
+/** Creates a compact metadata object suitable for diagnostics. */
+export function getModuleMetadataSummary(metadata) {
+    if (!metadata)
+        return {};
+    return Object.freeze({
+        description: metadata.description,
+        author: metadata.author,
+        category: metadata.category,
+        tags: metadata.tags,
+        environments: metadata.environments,
+        experimental: metadata.experimental,
+        deprecated: metadata.deprecated,
+        replacement: metadata.replacement,
+    });
+}
+//# sourceMappingURL=moduleMetadata.metadata.js.map

package/dist/modules/moduleMetadata.metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleMetadata.metadata.js","sourceRoot":"","sources":["../../src/modules/moduleMetadata.metadata.ts"],"names":[],"mappings":"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"}

package/dist/modules/moduleRegistry/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Module Registry
+ *
+ * Stores module definitions and tracks their runtime state.
+ */
+export { type ModuleRegistrationState, type ModuleRegistration, type ModuleRegistryOptions, type ModuleRegistryEventType, type ModuleRegistryEvent, type ModuleRegistryListener, type ModuleRegistry, } from "./moduleRegistry.type.js";
+export { DefaultModuleRegistry, createModuleRegistry, isModuleRegistration, } from "./moduleRegistry.registry.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/moduleRegistry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/moduleRegistry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,GACpB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,8BAA8B,CAAC"}

package/dist/modules/moduleRegistry/index.js

@@ -0,0 +1,8 @@
+/**
+ * Module Registry
+ *
+ * Stores module definitions and tracks their runtime state.
+ */
+export {} from "./moduleRegistry.type.js";
+export { DefaultModuleRegistry, createModuleRegistry, isModuleRegistration, } from "./moduleRegistry.registry.js";
+//# sourceMappingURL=index.js.map

package/dist/modules/moduleRegistry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/moduleRegistry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAQN,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,8BAA8B,CAAC"}

package/dist/modules/moduleRegistry/moduleRegistry.registry.d.ts

@@ -0,0 +1,35 @@
+import type { Module, ModuleId } from "../module.js";
+import type { ModuleDefinition } from "../moduleDefinition.definition.js";
+import type { ModuleMetadata } from "../moduleMetadata.metadata.js";
+import type { ModuleDependency } from "../moduleDependency/moduleDependency.type.js";
+import type { ModuleRegistrationState, ModuleRegistration, ModuleRegistryOptions, ModuleRegistryListener, ModuleRegistry } from "./moduleRegistry.type.js";
+/** Default in-memory module registry. */
+export declare class DefaultModuleRegistry implements ModuleRegistry {
+    private readonly registrations;
+    private readonly listeners;
+    private readonly allowReplacement;
+    constructor(options?: ModuleRegistryOptions);
+    register<TModule extends Module>(definition: ModuleDefinition<TModule>): ModuleRegistration<TModule>;
+    registerMany(definitions: readonly ModuleDefinition[]): readonly ModuleRegistration[];
+    get(moduleId: ModuleId): ModuleRegistration | undefined;
+    require(moduleId: ModuleId): ModuleRegistration;
+    has(moduleId: ModuleId): boolean;
+    unregister(moduleId: ModuleId): boolean;
+    getAll(): readonly ModuleRegistration[];
+    getDefinitions(): readonly ModuleDefinition[];
+    getLoadedModules(): readonly Module[];
+    setState(moduleId: ModuleId, state: ModuleRegistrationState, details?: {
+        readonly instance?: Module;
+        readonly error?: unknown;
+    }): ModuleRegistration;
+    getDependencies(moduleId: ModuleId): readonly ModuleDependency[];
+    getMetadata(moduleId: ModuleId): ModuleMetadata | undefined;
+    subscribe(listener: ModuleRegistryListener): () => void;
+    clear(): void;
+    private emit;
+}
+/** Creates a default module registry. */
+export declare function createModuleRegistry(options?: ModuleRegistryOptions): ModuleRegistry;
+/** Type guard for module registrations. */
+export declare function isModuleRegistration(value: unknown): value is ModuleRegistration;
+//# sourceMappingURL=moduleRegistry.registry.d.ts.map

package/dist/modules/moduleRegistry/moduleRegistry.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleRegistry.registry.d.ts","sourceRoot":"","sources":["../../../src/modules/moduleRegistry/moduleRegistry.registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EAErB,sBAAsB,EACtB,cAAc,EACf,MAAM,0BAA0B,CAAC;AAElC,yCAAyC;AACzC,qBAAa,qBAAsB,YAAW,cAAc;IAC1D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2C;IACzE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;IAC/D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAE3C,YAAmB,OAAO,GAAE,qBAA0B,EAErD;IAEM,QAAQ,CAAC,OAAO,SAAS,MAAM,EACpC,UAAU,EAAE,gBAAgB,CAAC,OAAO,CAAC,GACpC,kBAAkB,CAAC,OAAO,CAAC,CAuB7B;IAEM,YAAY,CACjB,WAAW,EAAE,SAAS,gBAAgB,EAAE,GACvC,SAAS,kBAAkB,EAAE,CAK/B;IAEM,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,kBAAkB,GAAG,SAAS,CAE7D;IAEM,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,kBAAkB,CAKrD;IAEM,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAEtC;IAEM,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAW7C;IAEM,MAAM,IAAI,SAAS,kBAAkB,EAAE,CAE7C;IACM,cAAc,IAAI,SAAS,gBAAgB,EAAE,CAInD;IAEM,gBAAgB,IAAI,SAAS,MAAM,EAAE,CAO3C;IAEM,QAAQ,CACb,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,uBAAuB,EAC9B,OAAO,GAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GACrE,kBAAkB,CAoBpB;IAEM,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,gBAAgB,EAAE,CActE;IAEM,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS,CAEjE;IAEM,SAAS,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,IAAI,CAK7D;IAEM,KAAK,IAAI,IAAI,CAGnB;IAED,OAAO,CAAC,IAAI;CAab;AAED,yCAAyC;AACzC,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,qBAA0B,GAClC,cAAc,CAEhB;AAED,2CAA2C;AAC3C,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,kBAAkB,CAS7B"}

package/dist/modules/moduleRegistry/moduleRegistry.registry.js

@@ -0,0 +1,155 @@
+import { isModuleDefinition } from "../moduleDefinition.definition.js";
+/** Default in-memory module registry. */
+export class DefaultModuleRegistry {
+    registrations = new Map();
+    listeners = new Set();
+    allowReplacement;
+    constructor(options = {}) {
+        this.allowReplacement = options.allowReplacement ?? false;
+    }
+    register(definition) {
+        if (!isModuleDefinition(definition))
+            throw new TypeError("Invalid module definition.");
+        const moduleId = definition.id.trim();
+        const existing = this.registrations.get(moduleId);
+        if (existing && !this.allowReplacement)
+            throw new Error(`Module "${moduleId}" is already registered.`);
+        const now = new Date();
+        const registration = Object.freeze({
+            definition,
+            state: "registered",
+            registeredAt: existing?.registeredAt ?? now,
+        });
+        this.registrations.set(moduleId, registration);
+        this.emit({
+            type: existing ? "replaced" : "registered",
+            moduleId,
+            previous: existing,
+            current: registration,
+            timestamp: now,
+        });
+        return registration;
+    }
+    registerMany(definitions) {
+        const registrations = [];
+        for (const definition of definitions)
+            registrations.push(this.register(definition));
+        return Object.freeze(registrations);
+    }
+    get(moduleId) {
+        return this.registrations.get(moduleId);
+    }
+    require(moduleId) {
+        const registration = this.get(moduleId);
+        if (!registration)
+            throw new Error(`Module "${moduleId}" is not registered.`);
+        return registration;
+    }
+    has(moduleId) {
+        return this.registrations.has(moduleId);
+    }
+    unregister(moduleId) {
+        const existing = this.registrations.get(moduleId);
+        if (!existing)
+            return false;
+        this.registrations.delete(moduleId);
+        this.emit({
+            type: "unregistered",
+            moduleId,
+            previous: existing,
+            timestamp: new Date(),
+        });
+        return true;
+    }
+    getAll() {
+        return Object.freeze([...this.registrations.values()]);
+    }
+    getDefinitions() {
+        return Object.freeze([...this.registrations.values()].map((r) => r.definition));
+    }
+    getLoadedModules() {
+        const modules = [];
+        for (const registration of this.registrations.values()) {
+            if (registration.state === "loaded" && registration.instance)
+                modules.push(registration.instance);
+        }
+        return Object.freeze(modules);
+    }
+    setState(moduleId, state, details = {}) {
+        const existing = this.require(moduleId);
+        const now = new Date();
+        const registration = Object.freeze({
+            definition: existing.definition,
+            instance: details.instance ?? existing.instance,
+            state,
+            error: details.error,
+            registeredAt: existing.registeredAt,
+            loadedAt: state === "loaded" ? now : existing.loadedAt,
+        });
+        this.registrations.set(moduleId, registration);
+        this.emit({
+            type: "state-changed",
+            moduleId,
+            previous: existing,
+            current: registration,
+            timestamp: now,
+        });
+        return registration;
+    }
+    getDependencies(moduleId) {
+        const registration = this.require(moduleId);
+        const dependencies = registration.definition.dependencies ?? [];
+        return Object.freeze(dependencies.map((dep) => {
+            if (typeof dep === "string")
+                return Object.freeze({ id: dep, optional: false });
+            return Object.freeze({
+                id: dep.id,
+                optional: dep.optional ?? false,
+                version: dep.version,
+            });
+        }));
+    }
+    getMetadata(moduleId) {
+        return this.require(moduleId).definition.metadata;
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    clear() {
+        const modules = [...this.registrations.keys()];
+        for (const moduleId of modules)
+            this.unregister(moduleId);
+    }
+    emit(event) {
+        for (const listener of this.listeners) {
+            try {
+                const result = listener(event);
+                if (result instanceof Promise)
+                    void result.catch(() => {
+                        /* Listener failures must not corrupt registry state. */
+                    });
+            }
+            catch {
+                /* Registry listeners are observers. Their failures must not interrupt registry operations. */
+            }
+        }
+    }
+}
+/** Creates a default module registry. */
+export function createModuleRegistry(options = {}) {
+    return new DefaultModuleRegistry(options);
+}
+/** Type guard for module registrations. */
+export function isModuleRegistration(value) {
+    if (value === null || typeof value !== "object")
+        return false;
+    const registration = value;
+    return (typeof registration.definition === "object" &&
+        registration.definition !== null &&
+        typeof registration.state === "string" &&
+        registration.registeredAt instanceof Date);
+}
+//# sourceMappingURL=moduleRegistry.registry.js.map

package/dist/modules/moduleRegistry/moduleRegistry.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleRegistry.registry.js","sourceRoot":"","sources":["../../../src/modules/moduleRegistry/moduleRegistry.registry.ts"],"names":[],"mappings":"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"}