@zudojs/core 0.0.1

package/dist/configuration/schema/configurationSchema.schema.js

@@ -0,0 +1,155 @@
+/**
+ * Creates a configuration schema.
+ */
+export function createConfigurationSchema(options) {
+    const path = normalizeConfigurationPath(options.path);
+    if (!path) {
+        throw new Error("Configuration schema path cannot be empty.");
+    }
+    const required = options.required ?? true;
+    return Object.freeze({
+        path,
+        required,
+        defaultValue: options.defaultValue,
+        description: options.description,
+        async validate(configuration) {
+            const exists = configuration.has(path);
+            if (!exists) {
+                if (options.defaultValue !== undefined) {
+                    return {
+                        success: true,
+                        value: options.defaultValue,
+                        errors: [],
+                    };
+                }
+                if (required) {
+                    return {
+                        success: false,
+                        errors: [
+                            {
+                                path,
+                                message: `Required configuration "${path}" is not defined.`,
+                                code: "CONFIGURATION_REQUIRED",
+                            },
+                        ],
+                    };
+                }
+                return {
+                    success: true,
+                    value: undefined,
+                    errors: [],
+                };
+            }
+            const value = configuration.get(path);
+            if (!options.validator) {
+                return {
+                    success: true,
+                    value,
+                    errors: [],
+                };
+            }
+            return options.validator(value, {
+                configuration,
+                path,
+            });
+        },
+    });
+}
+/**
+ * Collection of configuration schemas.
+ */
+export class ConfigurationSchemaRegistry {
+    schemas = new Map();
+    /**
+     * Registers a schema.
+     */
+    register(schema) {
+        if (this.schemas.has(schema.path)) {
+            throw new Error(`Configuration schema "${schema.path}" is already registered.`);
+        }
+        this.schemas.set(schema.path, schema);
+    }
+    /**
+     * Registers multiple schemas.
+     */
+    registerMany(schemas) {
+        for (const schema of schemas) {
+            this.register(schema);
+        }
+    }
+    /**
+     * Retrieves a schema.
+     */
+    get(path) {
+        return this.schemas.get(normalizeConfigurationPath(path));
+    }
+    /**
+     * Checks whether a schema exists.
+     */
+    has(path) {
+        return this.schemas.has(normalizeConfigurationPath(path));
+    }
+    /**
+     * Removes a schema.
+     */
+    remove(path) {
+        return this.schemas.delete(normalizeConfigurationPath(path));
+    }
+    /**
+     * Returns all registered schemas.
+     */
+    getAll() {
+        return [...this.schemas.values()];
+    }
+    /**
+     * Returns the number of registered schemas.
+     */
+    size() {
+        return this.schemas.size;
+    }
+    /**
+     * Removes all schemas.
+     */
+    clear() {
+        this.schemas.clear();
+    }
+}
+/**
+ * Creates a schema registry.
+ */
+export function createConfigurationSchemaRegistry() {
+    return new ConfigurationSchemaRegistry();
+}
+/**
+ * Validates every registered schema against a configuration.
+ */
+export async function validateConfiguration(configuration, registry) {
+    const errors = [];
+    for (const schema of registry.getAll()) {
+        const result = await schema.validate(configuration);
+        if (!result.success) {
+            errors.push(...result.errors);
+        }
+    }
+    if (errors.length > 0) {
+        return {
+            success: false,
+            errors,
+        };
+    }
+    return {
+        success: true,
+        value: configuration,
+        errors: [],
+    };
+}
+/**
+ * Normalizes a configuration path.
+ */
+function normalizeConfigurationPath(path) {
+    if (typeof path !== "string") {
+        throw new TypeError("Configuration schema path must be a string.");
+    }
+    return path.trim().replace(/\s+/g, "");
+}
+//# sourceMappingURL=configurationSchema.schema.js.map

package/dist/configuration/schema/configurationSchema.schema.js.map

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

package/dist/configuration/schema/configurationValidation.validator.d.ts

@@ -0,0 +1,82 @@
+import type { Configuration } from "../core/configuration.js";
+import { ConfigurationSchemaRegistry } from "../schema/configurationSchema.schema.js";
+import type { ConfigurationSchema, ConfigurationValidationIssue, ConfigurationValidationResult } from "../schema/configurationSchema.schema.js";
+import { FrameworkError } from "../../errors/frameworkError.error.js";
+/**
+ * Result returned after validating configuration.
+ */
+export interface ConfigurationValidationReport {
+    /**
+     * Whether every registered schema passed validation.
+     */
+    readonly valid: boolean;
+    /**
+     * The configuration that was validated.
+     */
+    readonly configuration: Configuration;
+    /**
+     * All validation issues discovered.
+     */
+    readonly issues: readonly ConfigurationValidationIssue[];
+    /**
+     * Number of schemas that were evaluated.
+     */
+    readonly schemaCount: number;
+    /**
+     * Number of schemas that passed validation.
+     */
+    readonly validSchemaCount: number;
+    /**
+     * Number of schemas that failed validation.
+     */
+    readonly invalidSchemaCount: number;
+}
+/**
+ * Options controlling configuration validation.
+ */
+export interface ConfigurationValidationOptions {
+    /**
+     * Whether validation should stop after the first
+     * failed schema.
+     *
+     * Defaults to false.
+     *
+     * Keeping this false gives developers a complete list
+     * of configuration problems during startup.
+     */
+    readonly failFast?: boolean;
+}
+/**
+ * Error thrown when configuration validation fails.
+ */
+export declare class ConfigurationValidationError extends FrameworkError {
+    /**
+     * All configuration validation issues.
+     */
+    readonly issues: readonly ConfigurationValidationIssue[];
+    /**
+     * Number of schemas evaluated.
+     */
+    readonly schemaCount: number;
+    /**
+     * Number of invalid schemas.
+     */
+    readonly invalidSchemaCount: number;
+    constructor(issues: readonly ConfigurationValidationIssue[], schemaCount: number, invalidSchemaCount: number);
+}
+/**
+ * Validates a configuration against a schema registry.
+ */
+export declare function validateConfiguration(configuration: Configuration, registry: ConfigurationSchemaRegistry, options?: ConfigurationValidationOptions): Promise<ConfigurationValidationReport>;
+/**
+ * Validates configuration and throws when validation fails.
+ *
+ * This is the method application bootstrap code should normally
+ * use when configuration is mandatory for startup.
+ */
+export declare function validateConfigurationOrThrow(configuration: Configuration, registry: ConfigurationSchemaRegistry, options?: ConfigurationValidationOptions): Promise<Configuration>;
+/**
+ * Validates one configuration schema.
+ */
+export declare function validateSchema<T>(configuration: Configuration, schema: ConfigurationSchema<T>): Promise<ConfigurationValidationResult<T>>;
+//# sourceMappingURL=configurationValidation.validator.d.ts.map

package/dist/configuration/schema/configurationValidation.validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configurationValidation.validator.d.ts","sourceRoot":"","sources":["../../../src/configuration/schema/configurationValidation.validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AAEtF,OAAO,KAAK,EACV,mBAAmB,EACnB,4BAA4B,EAC5B,6BAA6B,EAC9B,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAItE;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IAEtC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,4BAA4B,EAAE,CAAC;IAEzD;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,cAAc;IAC9D;;OAEG;IACH,SAAgB,MAAM,EAAE,SAAS,4BAA4B,EAAE,CAAC;IAEhE;;OAEG;IACH,SAAgB,WAAW,EAAE,MAAM,CAAC;IAEpC;;OAEG;IACH,SAAgB,kBAAkB,EAAE,MAAM,CAAC;IAE3C,YACE,MAAM,EAAE,SAAS,4BAA4B,EAAE,EAC/C,WAAW,EAAE,MAAM,EACnB,kBAAkB,EAAE,MAAM,EAkB3B;CACF;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,2BAA2B,EACrC,OAAO,GAAE,8BAAmC,GAC3C,OAAO,CAAC,6BAA6B,CAAC,CAuCxC;AAED;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAChD,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,2BAA2B,EACrC,OAAO,GAAE,8BAAmC,GAC3C,OAAO,CAAC,aAAa,CAAC,CAYxB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC7B,OAAO,CAAC,6BAA6B,CAAC,CAAC,CAAC,CAAC,CAe3C"}

package/dist/configuration/schema/configurationValidation.validator.js

@@ -0,0 +1,110 @@
+import { ConfigurationSchemaRegistry } from "../schema/configurationSchema.schema.js";
+import { FrameworkError } from "../../errors/frameworkError.error.js";
+import { ErrorCode } from "../../errors/errorCode.code.js";
+/**
+ * Error thrown when configuration validation fails.
+ */
+export class ConfigurationValidationError extends FrameworkError {
+    /**
+     * All configuration validation issues.
+     */
+    issues;
+    /**
+     * Number of schemas evaluated.
+     */
+    schemaCount;
+    /**
+     * Number of invalid schemas.
+     */
+    invalidSchemaCount;
+    constructor(issues, schemaCount, invalidSchemaCount) {
+        super(createValidationErrorMessage(issues), {
+            code: ErrorCode.CONFIGURATION_VALIDATION_FAILED,
+            details: {
+                issues,
+                schemaCount,
+                invalidSchemaCount,
+            },
+        });
+        this.name = "ConfigurationValidationError";
+        this.issues = [...issues];
+        this.schemaCount = schemaCount;
+        this.invalidSchemaCount = invalidSchemaCount;
+    }
+}
+/**
+ * Validates a configuration against a schema registry.
+ */
+export async function validateConfiguration(configuration, registry, options = {}) {
+    const schemas = registry.getAll();
+    const issues = [];
+    let validSchemaCount = 0;
+    let invalidSchemaCount = 0;
+    for (const schema of schemas) {
+        const result = await validateSchema(configuration, schema);
+        if (result.success) {
+            validSchemaCount += 1;
+            continue;
+        }
+        invalidSchemaCount += 1;
+        issues.push(...result.errors);
+        if (options.failFast === true) {
+            break;
+        }
+    }
+    return {
+        valid: issues.length === 0,
+        configuration,
+        issues,
+        schemaCount: schemas.length,
+        validSchemaCount,
+        invalidSchemaCount,
+    };
+}
+/**
+ * Validates configuration and throws when validation fails.
+ *
+ * This is the method application bootstrap code should normally
+ * use when configuration is mandatory for startup.
+ */
+export async function validateConfigurationOrThrow(configuration, registry, options = {}) {
+    const report = await validateConfiguration(configuration, registry, options);
+    if (!report.valid) {
+        throw new ConfigurationValidationError(report.issues, report.schemaCount, report.invalidSchemaCount);
+    }
+    return configuration;
+}
+/**
+ * Validates one configuration schema.
+ */
+export async function validateSchema(configuration, schema) {
+    try {
+        return await schema.validate(configuration);
+    }
+    catch (error) {
+        return {
+            success: false,
+            errors: [
+                {
+                    path: schema.path,
+                    message: error instanceof Error ? error.message : String(error),
+                    code: "CONFIGURATION_VALIDATOR_ERROR",
+                },
+            ],
+        };
+    }
+}
+/**
+ * Formats configuration validation issues into
+ * a readable framework error message.
+ */
+function createValidationErrorMessage(issues) {
+    if (issues.length === 0) {
+        return "Configuration validation failed.";
+    }
+    const formatted = issues
+        .map((issue) => `${issue.path}: ${issue.message}`)
+        .join("; ");
+    return `Configuration validation failed: ${formatted}`;
+}
+//# sourceMappingURL=configurationValidation.validator.js.map

package/dist/configuration/schema/configurationValidation.validator.js.map

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

package/dist/configuration/schema/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @zudojs/core/configuration/schema
+ *
+ * Configuration schemas and validation.
+ */
+export { createConfigurationSchema, ConfigurationSchemaRegistry, createConfigurationSchemaRegistry, } from "./configurationSchema.schema.js";
+export type { ConfigurationValidationResult, ConfigurationValidationIssue, ConfigurationValidationContext, ConfigurationValidator, ConfigurationSchema, ConfigurationSchemaOptions, } from "./configurationSchema.schema.js";
+export { validateConfiguration, validateConfigurationOrThrow, validateSchema, } from "./configurationValidation.validator.js";
+export type { ConfigurationValidationReport, ConfigurationValidationOptions, } from "./configurationValidation.validator.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/configuration/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/configuration/schema/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,iCAAiC,GAClC,MAAM,iCAAiC,CAAC;AAEzC,YAAY,EACV,6BAA6B,EAC7B,4BAA4B,EAC5B,8BAA8B,EAC9B,sBAAsB,EACtB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,qBAAqB,EACrB,4BAA4B,EAC5B,cAAc,GACf,MAAM,wCAAwC,CAAC;AAEhD,YAAY,EACV,6BAA6B,EAC7B,8BAA8B,GAC/B,MAAM,wCAAwC,CAAC"}

package/dist/configuration/schema/index.js

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/core/configuration/schema
+ *
+ * Configuration schemas and validation.
+ */
+export { createConfigurationSchema, ConfigurationSchemaRegistry, createConfigurationSchemaRegistry, } from "./configurationSchema.schema.js";
+export { validateConfiguration, validateConfigurationOrThrow, validateSchema, } from "./configurationValidation.validator.js";
+//# sourceMappingURL=index.js.map

package/dist/configuration/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/configuration/schema/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,iCAAiC,GAClC,MAAM,iCAAiC,CAAC;AAWzC,OAAO,EACL,qBAAqB,EACrB,4BAA4B,EAC5B,cAAc,GACf,MAAM,wCAAwC,CAAC"}

package/dist/container/container.d.ts

@@ -0,0 +1,43 @@
+import type { Provider } from "./provider.js";
+import type { Scope } from "./scope.js";
+import type { Token } from "./token.js";
+/**
+ * Dependency Injection container for Zudojs applications.
+ *
+ * The container is responsible for registering and resolving
+ * application dependencies.
+ */
+export declare class Container {
+    private readonly providers;
+    /**
+     * Registers a provider in the container.
+     */
+    register<T>(token: Token<T>, provider: Provider<T>, scope?: Scope): void;
+    /**
+     * Resolves a dependency from the container.
+     */
+    resolve<T>(token: Token<T>): T;
+    /**
+     * Checks whether a token has been registered.
+     */
+    has<T>(token: Token<T>): boolean;
+    /**
+     * Removes a provider from the container.
+     *
+     * Primarily useful for testing and controlled runtime scenarios.
+     */
+    unregister<T>(token: Token<T>): boolean;
+    /**
+     * Clears all registered providers.
+     */
+    clear(): void;
+    /**
+     * Creates an instance from a provider definition.
+     */
+    private createInstance;
+    /**
+     * Produces a readable representation of a dependency token.
+     */
+    private describeToken;
+}
+//# sourceMappingURL=container.d.ts.map

package/dist/container/container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../src/container/container.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAexC;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmD;IAE7E;;OAEG;IACI,QAAQ,CAAC,CAAC,EACf,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EACf,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EACrB,KAAK,GAAE,KAAmB,GACzB,IAAI,CASN;IAED;;OAEG;IACI,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAuBpC;IAED;;OAEG;IACI,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAEtC;IAED;;;;OAIG;IACI,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAE7C;IAED;;OAEG;IACI,KAAK,IAAI,IAAI,CAEnB;IAED;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;OAEG;IACH,OAAO,CAAC,aAAa;CAetB"}

package/dist/container/container.js

@@ -0,0 +1,91 @@
+import { ProviderNotFoundError, ProviderAlreadyRegisteredError, } from "../errors/exceptions.js";
+/**
+ * Dependency Injection container for Zudojs applications.
+ *
+ * The container is responsible for registering and resolving
+ * application dependencies.
+ */
+export class Container {
+    providers = new Map();
+    /**
+     * Registers a provider in the container.
+     */
+    register(token, provider, scope = "singleton") {
+        if (this.providers.has(token)) {
+            throw new ProviderAlreadyRegisteredError(token);
+        }
+        this.providers.set(token, {
+            provider: provider,
+            scope,
+        });
+    }
+    /**
+     * Resolves a dependency from the container.
+     */
+    resolve(token) {
+        const registration = this.providers.get(token);
+        if (!registration) {
+            throw new ProviderNotFoundError(token);
+        }
+        if (registration.scope === "singleton" &&
+            registration.instance !== undefined) {
+            return registration.instance;
+        }
+        const instance = this.createInstance(registration.provider);
+        if (registration.scope === "singleton") {
+            registration.instance = instance;
+        }
+        return instance;
+    }
+    /**
+     * Checks whether a token has been registered.
+     */
+    has(token) {
+        return this.providers.has(token);
+    }
+    /**
+     * Removes a provider from the container.
+     *
+     * Primarily useful for testing and controlled runtime scenarios.
+     */
+    unregister(token) {
+        return this.providers.delete(token);
+    }
+    /**
+     * Clears all registered providers.
+     */
+    clear() {
+        this.providers.clear();
+    }
+    /**
+     * Creates an instance from a provider definition.
+     */
+    createInstance(provider) {
+        if ("useValue" in provider) {
+            return provider.useValue;
+        }
+        if ("useFactory" in provider) {
+            return provider.useFactory(this);
+        }
+        if ("useClass" in provider) {
+            return new provider.useClass();
+        }
+        throw new Error("Invalid provider definition.");
+    }
+    /**
+     * Produces a readable representation of a dependency token.
+     */
+    describeToken(token) {
+        if (typeof token === "string") {
+            return token;
+        }
+        if (typeof token === "symbol") {
+            return token.description ?? token.toString();
+        }
+        if (typeof token === "function") {
+            return token.name || "anonymous class";
+        }
+        return "unknown";
+    }
+}
+//# sourceMappingURL=container.js.map

package/dist/container/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../../src/container/container.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,qBAAqB,EACrB,8BAA8B,GAC/B,MAAM,yBAAyB,CAAC;AAWjC;;;;;GAKG;AACH,MAAM,OAAO,SAAS;IACH,SAAS,GAAG,IAAI,GAAG,EAAwC,CAAC;IAE7E;;OAEG;IACI,QAAQ,CACb,KAAe,EACf,QAAqB,EACrB,KAAK,GAAU,WAAW;QAE1B,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,8BAA8B,CAAC,KAAK,CAAC,CAAC;QAClD,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE;YACxB,QAAQ,EAAE,QAA6B;YACvC,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACI,OAAO,CAAI,KAAe;QAC/B,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAE/C,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,qBAAqB,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;QAED,IACE,YAAY,CAAC,KAAK,KAAK,WAAW;YAClC,YAAY,CAAC,QAAQ,KAAK,SAAS,EACnC,CAAC;YACD,OAAO,YAAY,CAAC,QAAa,CAAC;QACpC,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAClC,YAAY,CAAC,QAAuB,CACrC,CAAC;QAEF,IAAI,YAAY,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YACvC,YAAY,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACnC,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACI,GAAG,CAAI,KAAe;QAC3B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACI,UAAU,CAAI,KAAe;QAClC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACI,KAAK;QACV,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACK,cAAc,CAAI,QAAqB;QAC7C,IAAI,UAAU,IAAI,QAAQ,EAAE,CAAC;YAC3B,OAAO,QAAQ,CAAC,QAAQ,CAAC;QAC3B,CAAC;QAED,IAAI,YAAY,IAAI,QAAQ,EAAE,CAAC;YAC7B,OAAO,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,UAAU,IAAI,QAAQ,EAAE,CAAC;YAC3B,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACjC,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,KAAqB;QACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC/C,CAAC;QAED,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC,IAAI,IAAI,iBAAiB,CAAC;QACzC,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/container/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Dependency Injection Container.
+ */
+export { Container } from "./container.js";
+export { createToken, type Token, type ConstructorToken } from "./token.js";
+export { type Provider, type ClassProvider, type FactoryProvider, type ValueProvider, type Constructor, } from "./provider.js";
+export { type Scope } from "./scope.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/container/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,KAAK,KAAK,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE5E,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,WAAW,GACjB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/container/index.js

@@ -0,0 +1,8 @@
+/**
+ * Dependency Injection Container.
+ */
+export { Container } from "./container.js";
+export { createToken } from "./token.js";
+export {} from "./provider.js";
+export {} from "./scope.js";
+//# sourceMappingURL=index.js.map

package/dist/container/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/container/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAqC,MAAM,YAAY,CAAC;AAE5E,OAAO,EAMN,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAc,MAAM,YAAY,CAAC"}

package/dist/container/provider.d.ts

@@ -0,0 +1,28 @@
+import type { Container } from "./container.js";
+/**
+ * Creates a dependency using the Zudojs dependency container.
+ */
+export interface FactoryProvider<T> {
+    readonly useFactory: (container: Container) => T;
+}
+/**
+ * Provides an already-created value.
+ */
+export interface ValueProvider<T> {
+    readonly useValue: T;
+}
+/**
+ * Creates a dependency from a class constructor.
+ */
+export interface ClassProvider<T> {
+    readonly useClass: Constructor<T>;
+}
+/**
+ * Supported constructor type.
+ */
+export type Constructor<T> = new (...args: never[]) => T;
+/**
+ * A dependency provider understood by the Zudojs container.
+ */
+export type Provider<T> = ClassProvider<T> | FactoryProvider<T> | ValueProvider<T>;
+//# sourceMappingURL=provider.d.ts.map

package/dist/container/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/container/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,CAAC,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IACpB,aAAa,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC"}

package/dist/container/provider.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider.js.map

package/dist/container/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/container/provider.ts"],"names":[],"mappings":""}

package/dist/container/scope.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Defines the lifetime of a dependency registered
+ * with the Zudojs dependency injection container.
+ */
+export type Scope = 
+/**
+ * One instance for the lifetime of the application container.
+ */
+"singleton"
+/**
+ * One instance for the lifetime of an execution context.
+ *
+ * Examples:
+ * HTTP request
+ * Background job
+ * Message consumption
+ * RPC request
+ */
+ | "scoped"
+/**
+ * A new instance every time the dependency is resolved.
+ */
+ | "transient";
+//# sourceMappingURL=scope.d.ts.map

package/dist/container/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/container/scope.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,KAAK;AACf;;GAEG;AACD,WAAW;AAEb;;;;;;;;GAQG;GACD,QAAQ;AAEV;;GAEG;GACD,WAAW,CAAC"}

package/dist/container/scope.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scope.js.map

package/dist/container/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../src/container/scope.ts"],"names":[],"mappings":""}

package/dist/container/token.d.ts

@@ -0,0 +1,18 @@
+/**
+ * A unique identifier used to register and resolve dependencies.
+ *
+ * Zudojs supports classes, strings, and symbols as dependency tokens.
+ */
+export type Token<T = unknown> = ConstructorToken<T> | string | symbol;
+/**
+ * A class that can be used as a dependency token.
+ */
+export type ConstructorToken<T> = new (...args: unknown[]) => T;
+/**
+ * Creates a unique symbol token.
+ *
+ * Useful for interfaces and infrastructure contracts that do not
+ * exist at runtime.
+ */
+export declare function createToken<T = unknown>(description: string): Token<T>;
+//# sourceMappingURL=token.d.ts.map