@goodie-ts/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 GOOD Code ApS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/application-context.d.ts

@@ -0,0 +1,69 @@
+import type { BeanDefinition } from './bean-definition.js';
+import type { InjectionToken } from './injection-token.js';
+import type { Constructor } from './types.js';
+/**
+ * The runtime dependency injection container.
+ *
+ * Created from an array of BeanDefinitions (produced by the compile-time
+ * transformer or built manually). Manages scoping, lazy/eager instantiation,
+ * async deduplication, and BeanPostProcessor hooks.
+ */
+export declare class ApplicationContext {
+    private readonly sortedDefs;
+    private readonly defsByToken;
+    private readonly primaryDef;
+    private readonly singletonCache;
+    private readonly asyncInFlight;
+    private readonly postProcessors;
+    private closed;
+    private constructor();
+    /**
+     * Build and initialize an ApplicationContext.
+     *
+     * 1. Topologically sorts definitions
+     * 2. Validates required dependencies exist
+     * 3. Discovers and initializes BeanPostProcessors
+     * 4. Eagerly resolves beans marked with `eager: true`
+     */
+    static create(definitions: BeanDefinition[]): Promise<ApplicationContext>;
+    /**
+     * Synchronously get a bean. Throws if:
+     * - The bean is async and hasn't been resolved yet
+     * - The token has no provider
+     * - The context is closed
+     */
+    get<T>(token: Constructor<T> | InjectionToken<T>): T;
+    /**
+     * Asynchronously get a bean. Always works, even for async factories.
+     */
+    getAsync<T>(token: Constructor<T> | InjectionToken<T>): Promise<T>;
+    /**
+     * Get all beans registered under the given token.
+     */
+    getAll<T>(token: Constructor<T> | InjectionToken<T>): T[];
+    /**
+     * Returns a shallow defensive copy of the bean definitions used to build this context.
+     */
+    getDefinitions(): readonly BeanDefinition[];
+    /**
+     * Close the context. Calls `@PreDestroy` methods on instantiated singletons
+     * in reverse-topological order (dependents destroyed before dependencies),
+     * then clears caches and rejects further calls.
+     */
+    close(): Promise<void>;
+    private assertOpen;
+    private validateDependencies;
+    private initPostProcessors;
+    private initEagerBeans;
+    private resolveDepsSync;
+    private resolveDepsAsync;
+    private resolveSync;
+    private resolveAsync;
+    /**
+     * @param skipPostProcessors - true when resolving post-processors themselves
+     */
+    private resolveAsyncRaw;
+    private applyPostProcessorsSync;
+    private applyPostProcessorsAsync;
+}
+//# sourceMappingURL=application-context.d.ts.map

package/dist/application-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-context.d.ts","sourceRoot":"","sources":["../src/application-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,sBAAsB,CAAC;AAOvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9C;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAQT,OAAO,CAAC,QAAQ,CAAC,UAAU;IAP/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsC;IAClE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAC/D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAC5D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsC;IACpE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2B;IAC1D,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO;IAaP;;;;;;;OAOG;WACU,MAAM,CACjB,WAAW,EAAE,cAAc,EAAE,GAC5B,OAAO,CAAC,kBAAkB,CAAC;IAS9B;;;;;OAKG;IACH,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC;IAwBpD;;OAEG;IACG,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAiCxE;;OAEG;IACH,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE;IAiBzD;;OAEG;IACH,cAAc,IAAI,SAAS,cAAc,EAAE;IAI3C;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B5B,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,oBAAoB;YAad,kBAAkB;YASlB,cAAc;IAQ5B,OAAO,CAAC,eAAe;YAeT,gBAAgB;IAuB9B,OAAO,CAAC,WAAW;YAiBL,YAAY;IAI1B;;OAEG;YACW,eAAe;IAuB7B,OAAO,CAAC,uBAAuB;YAuBjB,wBAAwB;CAiBvC"}

package/dist/application-context.js

@@ -0,0 +1,315 @@
+import { AsyncBeanNotReadyError, ContextClosedError, MissingDependencyError, } from './errors.js';
+import { topoSort } from './topo-sort.js';
+const UNRESOLVED = Symbol('UNRESOLVED');
+/**
+ * The runtime dependency injection container.
+ *
+ * Created from an array of BeanDefinitions (produced by the compile-time
+ * transformer or built manually). Manages scoping, lazy/eager instantiation,
+ * async deduplication, and BeanPostProcessor hooks.
+ */
+export class ApplicationContext {
+    sortedDefs;
+    defsByToken = new Map();
+    primaryDef = new Map();
+    singletonCache = new Map();
+    asyncInFlight = new Map();
+    postProcessors = [];
+    closed = false;
+    constructor(sortedDefs) {
+        this.sortedDefs = sortedDefs;
+        for (const def of sortedDefs) {
+            const existing = this.defsByToken.get(def.token);
+            if (existing) {
+                existing.push(def);
+            }
+            else {
+                this.defsByToken.set(def.token, [def]);
+            }
+            // Last definition wins as primary (matches typical DI override semantics)
+            this.primaryDef.set(def.token, def);
+        }
+    }
+    /**
+     * Build and initialize an ApplicationContext.
+     *
+     * 1. Topologically sorts definitions
+     * 2. Validates required dependencies exist
+     * 3. Discovers and initializes BeanPostProcessors
+     * 4. Eagerly resolves beans marked with `eager: true`
+     */
+    static async create(definitions) {
+        const sorted = topoSort(definitions);
+        const ctx = new ApplicationContext(sorted);
+        ctx.validateDependencies();
+        await ctx.initPostProcessors();
+        await ctx.initEagerBeans();
+        return ctx;
+    }
+    /**
+     * Synchronously get a bean. Throws if:
+     * - The bean is async and hasn't been resolved yet
+     * - The token has no provider
+     * - The context is closed
+     */
+    get(token) {
+        this.assertOpen();
+        const def = this.primaryDef.get(token);
+        if (!def) {
+            throw new MissingDependencyError(tokenName(token));
+        }
+        if (def.scope === 'singleton') {
+            const cached = this.singletonCache.get(token);
+            if (cached !== undefined) {
+                return cached;
+            }
+            if (cached === UNRESOLVED || this.asyncInFlight.has(token)) {
+                throw new AsyncBeanNotReadyError(tokenName(token));
+            }
+            // Attempt synchronous resolution
+            const instance = this.resolveSync(def);
+            return instance;
+        }
+        // Prototype: new instance every time
+        return this.resolveSync(def);
+    }
+    /**
+     * Asynchronously get a bean. Always works, even for async factories.
+     */
+    async getAsync(token) {
+        this.assertOpen();
+        const def = this.primaryDef.get(token);
+        if (!def) {
+            throw new MissingDependencyError(tokenName(token));
+        }
+        if (def.scope === 'singleton') {
+            const cached = this.singletonCache.get(token);
+            if (cached !== undefined && cached !== UNRESOLVED) {
+                return cached;
+            }
+            // Deduplicate concurrent async resolution
+            const inFlight = this.asyncInFlight.get(token);
+            if (inFlight) {
+                return inFlight;
+            }
+            const promise = this.resolveAsync(def);
+            this.asyncInFlight.set(token, promise);
+            try {
+                const instance = await promise;
+                return instance;
+            }
+            finally {
+                this.asyncInFlight.delete(token);
+            }
+        }
+        // Prototype
+        return this.resolveAsync(def);
+    }
+    /**
+     * Get all beans registered under the given token.
+     */
+    getAll(token) {
+        this.assertOpen();
+        const defs = this.defsByToken.get(token);
+        if (!defs || defs.length === 0) {
+            return [];
+        }
+        return defs.map((def) => {
+            if (def.scope === 'singleton') {
+                const cached = this.singletonCache.get(def.token);
+                if (cached !== undefined && cached !== UNRESOLVED) {
+                    return cached;
+                }
+            }
+            return this.resolveSync(def);
+        });
+    }
+    /**
+     * Returns a shallow defensive copy of the bean definitions used to build this context.
+     */
+    getDefinitions() {
+        return [...this.sortedDefs];
+    }
+    /**
+     * Close the context. Calls `@PreDestroy` methods on instantiated singletons
+     * in reverse-topological order (dependents destroyed before dependencies),
+     * then clears caches and rejects further calls.
+     */
+    async close() {
+        this.closed = true;
+        const errors = [];
+        for (const def of [...this.sortedDefs].reverse()) {
+            if (def.scope !== 'singleton')
+                continue;
+            const methods = def.metadata.preDestroyMethods;
+            if (!methods || methods.length === 0)
+                continue;
+            const instance = this.singletonCache.get(def.token);
+            if (instance === undefined || instance === UNRESOLVED)
+                continue;
+            for (const methodName of methods) {
+                try {
+                    await instance[methodName]();
+                }
+                catch (err) {
+                    errors.push(err instanceof Error ? err : new Error(String(err)));
+                }
+            }
+        }
+        this.singletonCache.clear();
+        this.asyncInFlight.clear();
+        if (errors.length === 1)
+            throw errors[0];
+        if (errors.length > 1)
+            throw new AggregateError(errors, 'Errors during bean destruction');
+    }
+    assertOpen() {
+        if (this.closed) {
+            throw new ContextClosedError();
+        }
+    }
+    validateDependencies() {
+        for (const def of this.sortedDefs) {
+            for (const dep of def.dependencies) {
+                if (!dep.optional && !this.primaryDef.has(dep.token)) {
+                    throw new MissingDependencyError(tokenName(dep.token), tokenName(def.token));
+                }
+            }
+        }
+    }
+    async initPostProcessors() {
+        for (const def of this.sortedDefs) {
+            if (def.metadata.isBeanPostProcessor) {
+                const processor = await this.resolveAsyncRaw(def, true);
+                this.postProcessors.push(processor);
+            }
+        }
+    }
+    async initEagerBeans() {
+        for (const def of this.sortedDefs) {
+            if (def.eager && !def.metadata.isBeanPostProcessor) {
+                await this.resolveAsyncRaw(def, false);
+            }
+        }
+    }
+    resolveDepsSync(deps) {
+        return deps.map((dep) => {
+            const depDef = this.primaryDef.get(dep.token);
+            if (!depDef) {
+                if (dep.optional)
+                    return undefined;
+                throw new MissingDependencyError(tokenName(dep.token));
+            }
+            if (depDef.scope === 'singleton') {
+                const cached = this.singletonCache.get(dep.token);
+                if (cached !== undefined && cached !== UNRESOLVED)
+                    return cached;
+            }
+            return this.resolveSync(depDef);
+        });
+    }
+    async resolveDepsAsync(deps) {
+        const resolved = [];
+        for (const dep of deps) {
+            const depDef = this.primaryDef.get(dep.token);
+            if (!depDef) {
+                if (dep.optional) {
+                    resolved.push(undefined);
+                    continue;
+                }
+                throw new MissingDependencyError(tokenName(dep.token));
+            }
+            if (depDef.scope === 'singleton') {
+                const cached = this.singletonCache.get(dep.token);
+                if (cached !== undefined && cached !== UNRESOLVED) {
+                    resolved.push(cached);
+                    continue;
+                }
+            }
+            resolved.push(await this.resolveAsyncRaw(depDef, false));
+        }
+        return resolved;
+    }
+    resolveSync(def) {
+        const deps = this.resolveDepsSync(def.dependencies);
+        const raw = def.factory(...deps);
+        if (raw instanceof Promise) {
+            // Mark as unresolved so sync get() knows to throw
+            if (def.scope === 'singleton') {
+                this.singletonCache.set(def.token, UNRESOLVED);
+            }
+            throw new AsyncBeanNotReadyError(tokenName(def.token));
+        }
+        const instance = this.applyPostProcessorsSync(raw, def);
+        if (def.scope === 'singleton') {
+            this.singletonCache.set(def.token, instance);
+        }
+        return instance;
+    }
+    async resolveAsync(def) {
+        return this.resolveAsyncRaw(def, false);
+    }
+    /**
+     * @param skipPostProcessors - true when resolving post-processors themselves
+     */
+    async resolveAsyncRaw(def, skipPostProcessors) {
+        // Check cache again (may have been resolved while awaiting)
+        if (def.scope === 'singleton') {
+            const cached = this.singletonCache.get(def.token);
+            if (cached !== undefined && cached !== UNRESOLVED)
+                return cached;
+        }
+        const deps = await this.resolveDepsAsync(def.dependencies);
+        let instance = await def.factory(...deps);
+        if (!skipPostProcessors) {
+            instance = await this.applyPostProcessorsAsync(instance, def);
+        }
+        if (def.scope === 'singleton') {
+            this.singletonCache.set(def.token, instance);
+        }
+        return instance;
+    }
+    applyPostProcessorsSync(bean, def) {
+        let current = bean;
+        for (const pp of this.postProcessors) {
+            if (pp.beforeInit) {
+                const result = pp.beforeInit(current, def);
+                if (result instanceof Promise) {
+                    throw new AsyncBeanNotReadyError(tokenName(def.token));
+                }
+                current = result;
+            }
+        }
+        for (const pp of this.postProcessors) {
+            if (pp.afterInit) {
+                const result = pp.afterInit(current, def);
+                if (result instanceof Promise) {
+                    throw new AsyncBeanNotReadyError(tokenName(def.token));
+                }
+                current = result;
+            }
+        }
+        return current;
+    }
+    async applyPostProcessorsAsync(bean, def) {
+        let current = bean;
+        for (const pp of this.postProcessors) {
+            if (pp.beforeInit) {
+                current = await pp.beforeInit(current, def);
+            }
+        }
+        for (const pp of this.postProcessors) {
+            if (pp.afterInit) {
+                current = await pp.afterInit(current, def);
+            }
+        }
+        return current;
+    }
+}
+function tokenName(token) {
+    if (typeof token === 'function') {
+        return token.name || 'Anonymous';
+    }
+    return token.description;
+}
+//# sourceMappingURL=application-context.js.map

package/dist/application-context.js.map

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

package/dist/bean-definition.d.ts

@@ -0,0 +1,25 @@
+import type { InjectionToken } from './injection-token.js';
+import type { Constructor, Scope } from './types.js';
+/** A single dependency of a bean. */
+export interface Dependency {
+    /** The token to resolve. */
+    token: InjectionToken<unknown> | Constructor;
+    /** If true, resolves to `undefined` when no provider is registered. */
+    optional: boolean;
+}
+/** Full metadata describing how to create and manage a bean. */
+export interface BeanDefinition<T = unknown> {
+    /** The token this bean is registered under. */
+    token: InjectionToken<T> | Constructor<T>;
+    /** Singleton (cached) or prototype (new instance per get). */
+    scope: Scope;
+    /** Ordered list of dependencies the factory expects. */
+    dependencies: Dependency[];
+    /** Creates the bean instance, receiving resolved dependencies in order. */
+    factory: (...deps: unknown[]) => T | Promise<T>;
+    /** Whether to instantiate eagerly during context creation. */
+    eager: boolean;
+    /** Arbitrary metadata stashed by decorators — extension libraries use this. */
+    metadata: Record<string, unknown>;
+}
+//# sourceMappingURL=bean-definition.d.ts.map

package/dist/bean-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bean-definition.d.ts","sourceRoot":"","sources":["../src/bean-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD,qCAAqC;AACrC,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC;IAC7C,uEAAuE;IACvE,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,gEAAgE;AAChE,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,+CAA+C;IAC/C,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAC1C,8DAA8D;IAC9D,KAAK,EAAE,KAAK,CAAC;IACb,wDAAwD;IACxD,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,2EAA2E;IAC3E,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAChD,8DAA8D;IAC9D,KAAK,EAAE,OAAO,CAAC;IACf,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC"}

package/dist/bean-definition.js

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

package/dist/bean-definition.js.map

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

package/dist/bean-post-processor.d.ts

@@ -0,0 +1,12 @@
+import type { BeanDefinition } from './bean-definition.js';
+/**
+ * Hook called by ApplicationContext after every bean is created.
+ * Extension libraries (AOP, validation, caching, etc.) implement this.
+ */
+export interface BeanPostProcessor {
+    /** Called before init. Can return a replacement instance. */
+    beforeInit?<T>(bean: T, definition: BeanDefinition<T>): T | Promise<T>;
+    /** Called after init. Can return a replacement instance. */
+    afterInit?<T>(bean: T, definition: BeanDefinition<T>): T | Promise<T>;
+}
+//# sourceMappingURL=bean-post-processor.d.ts.map

package/dist/bean-post-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bean-post-processor.d.ts","sourceRoot":"","sources":["../src/bean-post-processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACvE,4DAA4D;IAC5D,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACvE"}

package/dist/bean-post-processor.js

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

package/dist/bean-post-processor.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,30 @@
+/** Base error for all DI-related failures. */
+export declare class DIError extends Error {
+    constructor(message: string);
+}
+/** Thrown when a required dependency has no registered provider. */
+export declare class MissingDependencyError extends DIError {
+    readonly tokenDescription: string;
+    readonly requiredBy?: string | undefined;
+    constructor(tokenDescription: string, requiredBy?: string | undefined);
+}
+/** Thrown when a circular dependency is detected during topological sort. */
+export declare class CircularDependencyError extends DIError {
+    readonly cyclePath: string[];
+    constructor(cyclePath: string[]);
+}
+/** Thrown when `get()` is called for an async bean that hasn't been resolved yet. */
+export declare class AsyncBeanNotReadyError extends DIError {
+    readonly tokenDescription: string;
+    constructor(tokenDescription: string);
+}
+/** Thrown when trying to use a closed ApplicationContext. */
+export declare class ContextClosedError extends DIError {
+    constructor();
+}
+/** Thrown when overriding a bean whose token doesn't exist in the definitions. */
+export declare class OverrideError extends DIError {
+    readonly tokenDescription: string;
+    constructor(tokenDescription: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,qBAAa,OAAQ,SAAQ,KAAK;gBACpB,OAAO,EAAE,MAAM;CAI5B;AAED,oEAAoE;AACpE,qBAAa,sBAAuB,SAAQ,OAAO;IAE/C,QAAQ,CAAC,gBAAgB,EAAE,MAAM;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM;gBADnB,gBAAgB,EAAE,MAAM,EACxB,UAAU,CAAC,EAAE,MAAM,YAAA;CAQ/B;AAED,6EAA6E;AAC7E,qBAAa,uBAAwB,SAAQ,OAAO;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE;gBAAnB,SAAS,EAAE,MAAM,EAAE;CAIzC;AAED,qFAAqF;AACrF,qBAAa,sBAAuB,SAAQ,OAAO;IACrC,QAAQ,CAAC,gBAAgB,EAAE,MAAM;gBAAxB,gBAAgB,EAAE,MAAM;CAM9C;AAED,6DAA6D;AAC7D,qBAAa,kBAAmB,SAAQ,OAAO;;CAK9C;AAED,kFAAkF;AAClF,qBAAa,aAAc,SAAQ,OAAO;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,MAAM;gBAAxB,gBAAgB,EAAE,MAAM;CAM9C"}

package/dist/errors.js

@@ -0,0 +1,56 @@
+/** Base error for all DI-related failures. */
+export class DIError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DIError';
+    }
+}
+/** Thrown when a required dependency has no registered provider. */
+export class MissingDependencyError extends DIError {
+    tokenDescription;
+    requiredBy;
+    constructor(tokenDescription, requiredBy) {
+        const msg = requiredBy
+            ? `No provider registered for ${tokenDescription} (required by ${requiredBy})`
+            : `No provider registered for ${tokenDescription}`;
+        super(msg);
+        this.tokenDescription = tokenDescription;
+        this.requiredBy = requiredBy;
+        this.name = 'MissingDependencyError';
+    }
+}
+/** Thrown when a circular dependency is detected during topological sort. */
+export class CircularDependencyError extends DIError {
+    cyclePath;
+    constructor(cyclePath) {
+        super(`Circular dependency detected: ${cyclePath.join(' → ')}`);
+        this.cyclePath = cyclePath;
+        this.name = 'CircularDependencyError';
+    }
+}
+/** Thrown when `get()` is called for an async bean that hasn't been resolved yet. */
+export class AsyncBeanNotReadyError extends DIError {
+    tokenDescription;
+    constructor(tokenDescription) {
+        super(`Bean ${tokenDescription} is async and has not been resolved yet. Use getAsync() instead.`);
+        this.tokenDescription = tokenDescription;
+        this.name = 'AsyncBeanNotReadyError';
+    }
+}
+/** Thrown when trying to use a closed ApplicationContext. */
+export class ContextClosedError extends DIError {
+    constructor() {
+        super('ApplicationContext has been closed');
+        this.name = 'ContextClosedError';
+    }
+}
+/** Thrown when overriding a bean whose token doesn't exist in the definitions. */
+export class OverrideError extends DIError {
+    tokenDescription;
+    constructor(tokenDescription) {
+        super(`Cannot override ${tokenDescription}: no bean with this token exists in the definitions`);
+        this.tokenDescription = tokenDescription;
+        this.name = 'OverrideError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,MAAM,OAAO,OAAQ,SAAQ,KAAK;IAChC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;IACxB,CAAC;CACF;AAED,oEAAoE;AACpE,MAAM,OAAO,sBAAuB,SAAQ,OAAO;IAEtC;IACA;IAFX,YACW,gBAAwB,EACxB,UAAmB;QAE5B,MAAM,GAAG,GAAG,UAAU;YACpB,CAAC,CAAC,8BAA8B,gBAAgB,iBAAiB,UAAU,GAAG;YAC9E,CAAC,CAAC,8BAA8B,gBAAgB,EAAE,CAAC;QACrD,KAAK,CAAC,GAAG,CAAC,CAAC;QANF,qBAAgB,GAAhB,gBAAgB,CAAQ;QACxB,eAAU,GAAV,UAAU,CAAS;QAM5B,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,6EAA6E;AAC7E,MAAM,OAAO,uBAAwB,SAAQ,OAAO;IAC7B;IAArB,YAAqB,SAAmB;QACtC,KAAK,CAAC,iCAAiC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAD7C,cAAS,GAAT,SAAS,CAAU;QAEtC,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,qFAAqF;AACrF,MAAM,OAAO,sBAAuB,SAAQ,OAAO;IAC5B;IAArB,YAAqB,gBAAwB;QAC3C,KAAK,CACH,QAAQ,gBAAgB,kEAAkE,CAC3F,CAAC;QAHiB,qBAAgB,GAAhB,gBAAgB,CAAQ;QAI3C,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,6DAA6D;AAC7D,MAAM,OAAO,kBAAmB,SAAQ,OAAO;IAC7C;QACE,KAAK,CAAC,oCAAoC,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,kFAAkF;AAClF,MAAM,OAAO,aAAc,SAAQ,OAAO;IACnB;IAArB,YAAqB,gBAAwB;QAC3C,KAAK,CACH,mBAAmB,gBAAgB,qDAAqD,CACzF,CAAC;QAHiB,qBAAgB,GAAhB,gBAAgB,CAAQ;QAI3C,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/goodie.d.ts

@@ -0,0 +1,29 @@
+import { ApplicationContext } from './application-context.js';
+import type { BeanDefinition } from './bean-definition.js';
+/**
+ * Fluent builder for bootstrapping an ApplicationContext.
+ *
+ * Obtained via `Goodie.build(definitions)`. Call `.start()` to create
+ * and initialize the context.
+ */
+export declare class GoodieBuilder {
+    private readonly definitions;
+    constructor(definitions: BeanDefinition[]);
+    /** Build and start the ApplicationContext. */
+    start(): Promise<ApplicationContext>;
+}
+/**
+ * Entry point for the Goodie framework.
+ *
+ * Usage (in generated code):
+ * ```ts
+ * export const app = Goodie.build(definitions)
+ * const ctx = await app.start()
+ * ```
+ */
+export declare class Goodie {
+    private constructor();
+    /** Create a builder pre-loaded with the given bean definitions. */
+    static build(definitions: BeanDefinition[]): GoodieBuilder;
+}
+//# sourceMappingURL=goodie.d.ts.map

package/dist/goodie.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goodie.d.ts","sourceRoot":"","sources":["../src/goodie.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;GAKG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,cAAc,EAAE;IAE1D,8CAA8C;IACxC,KAAK,IAAI,OAAO,CAAC,kBAAkB,CAAC;CAG3C;AAED;;;;;;;;GAQG;AACH,qBAAa,MAAM;IACjB,OAAO;IAEP,mEAAmE;IACnE,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,cAAc,EAAE,GAAG,aAAa;CAG3D"}

package/dist/goodie.js

@@ -0,0 +1,34 @@
+import { ApplicationContext } from './application-context.js';
+/**
+ * Fluent builder for bootstrapping an ApplicationContext.
+ *
+ * Obtained via `Goodie.build(definitions)`. Call `.start()` to create
+ * and initialize the context.
+ */
+export class GoodieBuilder {
+    definitions;
+    constructor(definitions) {
+        this.definitions = definitions;
+    }
+    /** Build and start the ApplicationContext. */
+    async start() {
+        return ApplicationContext.create(this.definitions);
+    }
+}
+/**
+ * Entry point for the Goodie framework.
+ *
+ * Usage (in generated code):
+ * ```ts
+ * export const app = Goodie.build(definitions)
+ * const ctx = await app.start()
+ * ```
+ */
+export class Goodie {
+    constructor() { }
+    /** Create a builder pre-loaded with the given bean definitions. */
+    static build(definitions) {
+        return new GoodieBuilder(definitions);
+    }
+}
+//# sourceMappingURL=goodie.js.map

package/dist/goodie.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goodie.js","sourceRoot":"","sources":["../src/goodie.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG9D;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,WAA6B;QAA7B,gBAAW,GAAX,WAAW,CAAkB;IAAG,CAAC;IAE9D,8CAA8C;IAC9C,KAAK,CAAC,KAAK;QACT,OAAO,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACrD,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,MAAM;IACjB,gBAAuB,CAAC;IAExB,mEAAmE;IACnE,MAAM,CAAC,KAAK,CAAC,WAA6B;QACxC,OAAO,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import './polyfills.js';
+export { ApplicationContext } from './application-context.js';
+export type { BeanDefinition, Dependency } from './bean-definition.js';
+export type { BeanPostProcessor } from './bean-post-processor.js';
+export { AsyncBeanNotReadyError, CircularDependencyError, ContextClosedError, DIError, MissingDependencyError, OverrideError, } from './errors.js';
+export { Goodie, GoodieBuilder } from './goodie.js';
+export { InjectionToken } from './injection-token.js';
+export { topoSort } from './topo-sort.js';
+export type { Constructor, Scope } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,OAAO,EACP,sBAAsB,EACtB,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+import './polyfills.js';
+export { ApplicationContext } from './application-context.js';
+export { AsyncBeanNotReadyError, CircularDependencyError, ContextClosedError, DIError, MissingDependencyError, OverrideError, } from './errors.js';
+export { Goodie, GoodieBuilder } from './goodie.js';
+export { InjectionToken } from './injection-token.js';
+export { topoSort } from './topo-sort.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG9D,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,OAAO,EACP,sBAAsB,EACtB,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/injection-token.d.ts

@@ -0,0 +1,17 @@
+/**
+ * A typed token used to look up beans in the container.
+ *
+ * Use this for interfaces, primitives, or any type that doesn't have
+ * a class constructor at runtime.
+ *
+ * @example
+ * const DB_URL = new InjectionToken<string>('DB_URL')
+ */
+export declare class InjectionToken<T> {
+    readonly description: string;
+    /** Phantom field to carry the type parameter through the type system. */
+    readonly __type: T;
+    constructor(description: string);
+    toString(): string;
+}
+//# sourceMappingURL=injection-token.d.ts.map

package/dist/injection-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injection-token.d.ts","sourceRoot":"","sources":["../src/injection-token.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,qBAAa,cAAc,CAAC,CAAC;IAIf,QAAQ,CAAC,WAAW,EAAE,MAAM;IAHxC,yEAAyE;IACzE,SAAiB,MAAM,EAAE,CAAC,CAAC;gBAEN,WAAW,EAAE,MAAM;IAExC,QAAQ,IAAI,MAAM;CAGnB"}

package/dist/injection-token.js

@@ -0,0 +1,19 @@
+/**
+ * A typed token used to look up beans in the container.
+ *
+ * Use this for interfaces, primitives, or any type that doesn't have
+ * a class constructor at runtime.
+ *
+ * @example
+ * const DB_URL = new InjectionToken<string>('DB_URL')
+ */
+export class InjectionToken {
+    description;
+    constructor(description) {
+        this.description = description;
+    }
+    toString() {
+        return `InjectionToken(${this.description})`;
+    }
+}
+//# sourceMappingURL=injection-token.js.map

package/dist/injection-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injection-token.js","sourceRoot":"","sources":["../src/injection-token.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,OAAO,cAAc;IAIJ;IAArB,YAAqB,WAAmB;QAAnB,gBAAW,GAAX,WAAW,CAAQ;IAAG,CAAC;IAE5C,QAAQ;QACN,OAAO,kBAAkB,IAAI,CAAC,WAAW,GAAG,CAAC;IAC/C,CAAC;CACF"}

package/dist/polyfills.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=polyfills.d.ts.map

package/dist/polyfills.d.ts.map

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

package/dist/polyfills.js

@@ -0,0 +1,4 @@
+"use strict";
+// Polyfill Symbol.metadata if the runtime doesn't support it yet
+Symbol.metadata ??= Symbol('Symbol.metadata');
+//# sourceMappingURL=polyfills.js.map

package/dist/polyfills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polyfills.js","sourceRoot":"","sources":["../src/polyfills.ts"],"names":[],"mappings":";AAAA,iEAAiE;AAChE,MAAgC,CAAC,QAAQ,KAAK,MAAM,CAAC,iBAAiB,CAAC,CAAC"}

package/dist/topo-sort.d.ts

@@ -0,0 +1,10 @@
+import type { BeanDefinition } from './bean-definition.js';
+/**
+ * Topologically sorts bean definitions so that dependencies come before
+ * the beans that depend on them. Detects cycles and reports the full path.
+ *
+ * Optional dependencies are included in ordering when present but do not
+ * cause failures when missing.
+ */
+export declare function topoSort(definitions: BeanDefinition[]): BeanDefinition[];
+//# sourceMappingURL=topo-sort.d.ts.map

package/dist/topo-sort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topo-sort.d.ts","sourceRoot":"","sources":["../src/topo-sort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAO3D;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,WAAW,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAqDxE"}

package/dist/topo-sort.js

@@ -0,0 +1,59 @@
+import { CircularDependencyError } from './errors.js';
+/**
+ * Topologically sorts bean definitions so that dependencies come before
+ * the beans that depend on them. Detects cycles and reports the full path.
+ *
+ * Optional dependencies are included in ordering when present but do not
+ * cause failures when missing.
+ */
+export function topoSort(definitions) {
+    const defByToken = new Map();
+    for (const def of definitions) {
+        defByToken.set(def.token, def);
+    }
+    const IN_STACK = 1;
+    const DONE = 2;
+    const state = new Map();
+    const sorted = [];
+    // Track the current DFS path for cycle reporting
+    const pathStack = [];
+    function visit(def) {
+        const token = def.token;
+        const s = state.get(token);
+        if (s === DONE)
+            return;
+        if (s === IN_STACK) {
+            // Extract cycle path from the stack
+            const cycleStart = pathStack.indexOf(token);
+            const cyclePath = pathStack.slice(cycleStart).map(tokenName);
+            cyclePath.push(tokenName(token));
+            throw new CircularDependencyError(cyclePath);
+        }
+        state.set(token, IN_STACK);
+        pathStack.push(token);
+        for (const dep of def.dependencies) {
+            const depDef = defByToken.get(dep.token);
+            if (depDef) {
+                visit(depDef);
+            }
+            // If the dep is not found and it's optional, skip silently.
+            // Missing required deps are validated separately by ApplicationContext.
+        }
+        pathStack.pop();
+        state.set(token, DONE);
+        sorted.push(def);
+    }
+    for (const def of definitions) {
+        if (!state.has(def.token)) {
+            visit(def);
+        }
+    }
+    return sorted;
+}
+function tokenName(token) {
+    if (typeof token === 'function') {
+        return token.name || 'Anonymous';
+    }
+    return token.description;
+}
+//# sourceMappingURL=topo-sort.js.map

package/dist/topo-sort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topo-sort.js","sourceRoot":"","sources":["../src/topo-sort.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAMtD;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,WAA6B;IACpD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAyB,CAAC;IACpD,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,CAAC;IACnB,MAAM,IAAI,GAAG,CAAC,CAAC;IAEf,MAAM,KAAK,GAAG,IAAI,GAAG,EAAiB,CAAC;IACvC,MAAM,MAAM,GAAqB,EAAE,CAAC;IAEpC,iDAAiD;IACjD,MAAM,SAAS,GAAY,EAAE,CAAC;IAE9B,SAAS,KAAK,CAAC,GAAmB;QAChC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;QACxB,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAE3B,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO;QAEvB,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;YACnB,oCAAoC;YACpC,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC5C,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC7D,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YACjC,MAAM,IAAI,uBAAuB,CAAC,SAAS,CAAC,CAAC;QAC/C,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC3B,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEtB,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACzC,IAAI,MAAM,EAAE,CAAC;gBACX,KAAK,CAAC,MAAM,CAAC,CAAC;YAChB,CAAC;YACD,4DAA4D;YAC5D,wEAAwE;QAC1E,CAAC;QAED,SAAS,CAAC,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,KAAK,CAAC,GAAG,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,SAAS,CAAC,KAAY;IAC7B,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC,IAAI,IAAI,WAAW,CAAC;IACnC,CAAC;IACD,OAAO,KAAK,CAAC,WAAW,CAAC;AAC3B,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,5 @@
+/** A newable class constructor. */
+export type Constructor<T = unknown> = new (...args: any[]) => T;
+/** Bean lifecycle scope. */
+export type Scope = 'singleton' | 'prototype';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAEjE,4BAA4B;AAC5B,MAAM,MAAM,KAAK,GAAG,WAAW,GAAG,WAAW,CAAC"}

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@goodie-ts/core",
+  "version": "0.1.0",
+  "description": "Runtime dependency injection container for goodie-ts",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/GOOD-Code-ApS/goodie.git",
+    "directory": "packages/core"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}