injeca 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Neko Ayaka
+
+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/README.md

@@ -0,0 +1,100 @@
+# Injeca
+
+Pure function programming based dependency injection library
+
+> Heavily inspired by [uber/fig](https://go.uber.org/fig) and [uber/dig](https://go.uber.org/dig) in Golang ecosystem.
+
+[![npm version][npm-version-src]][npm-version-href]
+[![npm downloads][npm-downloads-src]][npm-downloads-href]
+[![bundle][bundle-src]][bundle-href]
+[![JSDocs][jsdocs-src]][jsdocs-href]
+[![License][license-src]][license-href]
+
+## Installation
+
+```sh
+npm install injeca
+pnpm add injeca
+bun add injeca
+ni injeca
+yarn add injeca
+```
+
+## Basic usage
+
+`injeca` ships with a global singleton container exposed as `injecta`. You can register
+providers, declare their dependencies, and run invocations once everything is ready.
+
+```ts
+import { createServer } from 'node:http'
+
+import { injecta, lifecycle } from 'injeca'
+
+// Providers return a value once and are cached inside the container.
+const config = injecta.provide('config', () => ({ port: 3000 }))
+
+const server = injecta.provide({
+  dependsOn: { config, lifecycle },
+  async build({ dependsOn }) {
+    const { config, lifecycle } = dependsOn
+    const app = createServer()
+
+    lifecycle.appHooks.onStart(() => app.listen(config.port))
+    lifecycle.appHooks.onStop(() => app.close())
+
+    return app
+  },
+})
+
+injecta.invoke({
+  dependsOn: { server },
+  async callback({ server }) {
+    // eslint-disable-next-line no-console
+    console.log('HTTP server ready:', await server.address())
+  },
+})
+
+await injecta.start()
+
+process.once('SIGINT', async () => {
+  await injecta.stop()
+})
+```
+
+### Manual containers
+
+If you need multiple containers (for tests or per-request scopes), create them
+explicitly and pass the container reference into `provide`, `invoke`, `start`, and
+`stop`.
+
+```ts
+import { createContainer, invoke, provide, start, stop } from 'injeca'
+
+const container = createContainer()
+
+const token = provide(container, 'token', () => crypto.randomUUID())
+
+invoke(container, {
+  dependsOn: { token },
+  // eslint-disable-next-line no-console
+  callback: ({ token }) => console.log('token', token),
+})
+
+await start(container)
+await stop(container)
+```
+
+## License
+
+MIT
+
+[npm-version-src]: https://img.shields.io/npm/v/injeca?style=flat&colorA=080f12&colorB=1fa669
+[npm-version-href]: https://npmjs.com/package/injeca
+[npm-downloads-src]: https://img.shields.io/npm/dm/injeca?style=flat&colorA=080f12&colorB=1fa669
+[npm-downloads-href]: https://npmjs.com/package/injeca
+[bundle-src]: https://img.shields.io/bundlephobia/minzip/injeca?style=flat&colorA=080f12&colorB=1fa669&label=minzip
+[bundle-href]: https://bundlephobia.com/result?p=injeca
+[license-src]: https://img.shields.io/github/license/moeru-ai/injeca.svg?style=flat&colorA=080f12&colorB=1fa669
+[license-href]: https://github.com/moeru-ai/injeca/blob/main/LICENSE
+[jsdocs-src]: https://img.shields.io/badge/jsdocs-reference-080f12?style=flat&colorA=080f12&colorB=1fa669
+[jsdocs-href]: https://www.jsdocs.io/package/injeca

package/dist/builtin-BN5UvvMB.mjs

@@ -0,0 +1,25 @@
+//#region src/builtin.ts
+function buildLifecycle() {
+	const onStartHooks = [];
+	const onStopHooks = [];
+	return {
+		appHooks: {
+			onStart(hook) {
+				if (hook) onStartHooks.push(hook);
+			},
+			onStop(hook) {
+				if (hook) onStopHooks.push(hook);
+			}
+		},
+		emitOnStart: async () => {
+			for (const hook of onStartHooks) await hook();
+		},
+		emitOnStop: async () => {
+			for (const hook of onStopHooks) await hook();
+		}
+	};
+}
+
+//#endregion
+export { buildLifecycle };
+//# sourceMappingURL=builtin-BN5UvvMB.mjs.map

package/dist/builtin-BN5UvvMB.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-BN5UvvMB.mjs","names":["onStartHooks: (() => void | Promise<void>)[]","onStopHooks: (() => void | Promise<void>)[]"],"sources":["../src/builtin.ts"],"sourcesContent":["export interface LifecycleAppHooks {\n  onStart: (hook: () => void | Promise<void>) => void\n  onStop: (hook: () => void | Promise<void>) => void\n}\n\nexport interface Lifecycle {\n  appHooks: LifecycleAppHooks\n}\n\nexport interface LifecycleTriggerable extends Lifecycle {\n  emitOnStart: () => Promise<void>\n  emitOnStop: () => Promise<void>\n}\n\nexport function buildLifecycle(): Lifecycle {\n  const onStartHooks: (() => void | Promise<void>)[] = []\n  const onStopHooks: (() => void | Promise<void>)[] = []\n\n  const lifecycle: LifecycleTriggerable = {\n    appHooks: {\n      onStart(hook: () => void | Promise<void>) {\n        if (hook) {\n          onStartHooks.push(hook)\n        }\n      },\n      onStop(hook: () => void | Promise<void>) {\n        if (hook) {\n          onStopHooks.push(hook)\n        }\n      },\n    },\n    emitOnStart: async () => {\n      for (const hook of onStartHooks) {\n        await hook()\n      }\n    },\n    emitOnStop: async () => {\n      for (const hook of onStopHooks) {\n        await hook()\n      }\n    },\n  }\n\n  return lifecycle\n}\n"],"mappings":";AAcA,SAAgB,iBAA4B;CAC1C,MAAMA,eAA+C,EAAE;CACvD,MAAMC,cAA8C,EAAE;AA2BtD,QAzBwC;EACtC,UAAU;GACR,QAAQ,MAAkC;AACxC,QAAI,KACF,cAAa,KAAK,KAAK;;GAG3B,OAAO,MAAkC;AACvC,QAAI,KACF,aAAY,KAAK,KAAK;;GAG3B;EACD,aAAa,YAAY;AACvB,QAAK,MAAM,QAAQ,aACjB,OAAM,MAAM;;EAGhB,YAAY,YAAY;AACtB,QAAK,MAAM,QAAQ,YACjB,OAAM,MAAM;;EAGjB"}

package/dist/index.d.mts

@@ -0,0 +1,122 @@
+import { Logg } from "@guiiai/logg";
+
+//#region src/builtin.d.ts
+interface LifecycleAppHooks {
+  onStart: (hook: () => void | Promise<void>) => void;
+  onStop: (hook: () => void | Promise<void>) => void;
+}
+interface Lifecycle {
+  appHooks: LifecycleAppHooks;
+}
+interface LifecycleTriggerable extends Lifecycle {
+  emitOnStart: () => Promise<void>;
+  emitOnStop: () => Promise<void>;
+}
+//#endregion
+//#region src/logger.d.ts
+interface Logger {
+  provide: (name: string, dependencies: string[]) => void;
+  invoke: (dependencies: string[]) => void;
+  beforeRun: (name: string) => void;
+  run: (name: string, duration: number) => void;
+  hookOnStart: (name: string) => void;
+  hookOnStartComplete: (name: string, duration: number) => void;
+  hookOnStop: (name: string) => void;
+  hookOnStopComplete: (name: string, duration: number) => void;
+  running: () => void;
+}
+interface LoggerOptions {
+  enabled?: boolean;
+  logger?: Logger;
+}
+declare function createDefaultLogger(): Logger;
+declare function createLoggLogger(logg: Logg): Logger;
+declare function createNoopLogger(): Logger;
+//#endregion
+//#region src/scoped.d.ts
+type DependencyMap = Record<string, any>;
+interface Container {
+  providers: Map<string, ProvideOptionObject<any, any>>;
+  instances: Map<string, any>;
+  lifecycleHooks: Map<string, LifecycleTriggerable>;
+  dependencyGraph: Map<string, string[]>;
+  invocations: InvokeOptionObject<any>[];
+  logger: Logger;
+}
+type BuildContext<D extends DependencyMap | undefined = undefined> = {
+  container: Container;
+  name: string;
+} & (D extends undefined ? {
+  dependsOn?: unknown;
+} : {
+  dependsOn: D;
+});
+type ResolveDependencyDeclaration<Deps extends Record<string, string | ProvidedKey<any, any, any>>> = { [K in keyof Deps]: Deps[K] extends ProvidedKey<any, infer T, any> ? T : any };
+type ProvideOptionObject<T$1, D extends DependencyMap | undefined = undefined> = {
+  build: (context: BuildContext<D>) => T$1 | Promise<T$1>;
+} & (D extends undefined ? {
+  dependsOn?: Record<string, never>;
+} : {
+  dependsOn: { [K in keyof D]: string };
+});
+type ProvideOptionFunc<T$1, D extends DependencyMap | undefined = undefined> = (context: BuildContext<D>) => T$1 | Promise<T$1>;
+type ProvideOption<T$1, D extends DependencyMap | undefined = undefined> = ProvideOptionObject<T$1, D> | ProvideOptionFunc<T$1, D>;
+interface ProvideOptionObjectWithKeys<T$1, Deps extends Record<string, string | ProvidedKey<any, any, any>>> {
+  build: (context: BuildContext<ResolveDependencyDeclaration<Deps>>) => T$1 | Promise<T$1>;
+  dependsOn: Deps;
+}
+type ProvideOptionWithKeys<T$1, Deps extends Record<string, string | ProvidedKey<any, any, any>>> = ProvideOptionObjectWithKeys<T$1, Deps>;
+type InvokeOptionObject<D extends DependencyMap | undefined = undefined> = {
+  callback: (dependencies: D) => void | Promise<void>;
+} & (D extends undefined ? {
+  dependsOn?: Record<string, never>;
+} : {
+  dependsOn: { [K in keyof D]: string };
+});
+type InvokeOptionFunc<D extends DependencyMap | undefined = undefined> = (dependencies: D) => void | Promise<void>;
+type InvokeOption<D extends DependencyMap | undefined = undefined> = InvokeOptionObject<D> | InvokeOptionFunc<D>;
+interface InvokeOptionObjectWithKeys<Deps extends Record<string, string | ProvidedKey<any, any, any>>> {
+  callback: (dependencies: ResolveDependencyDeclaration<Deps>) => void | Promise<void>;
+  dependsOn: Deps;
+}
+type InvokeOptionWithKeys<Deps extends Record<string, string | ProvidedKey<any, any, any>>> = InvokeOptionObjectWithKeys<Deps>;
+declare const lifecycle: ProvidedKey<'lifecycle', Lifecycle, undefined>;
+declare function createContainer(options?: LoggerOptions): Container;
+interface ProvidedKey<Key, T$1, D extends DependencyMap | undefined> {
+  key: Key;
+}
+declare function provide<T$1, Key extends string, Deps extends Record<string, string | ProvidedKey<any, any, any>>>(container: Container, name: Key, option: ProvideOptionWithKeys<T$1, Deps>): ProvidedKey<Key, T$1, ResolveDependencyDeclaration<Deps>>;
+declare function provide<T$1, Key extends string, Deps extends Record<string, string | ProvidedKey<any, any, any>>>(container: Container, option: ProvideOptionWithKeys<T$1, Deps> & {
+  autoNameStackIndex?: number;
+}): ProvidedKey<Key, T$1, ResolveDependencyDeclaration<Deps>>;
+declare function provide<D extends DependencyMap | undefined, T$1 = any, Key extends string = string>(container: Container, name: Key, option: ProvideOption<T$1, D>): ProvidedKey<Key, T$1, D>;
+declare function provide<D extends DependencyMap | undefined, T$1 = any, Key extends string = string>(container: Container, option: ProvideOption<T$1, D> & {
+  autoNameStackIndex?: number;
+}): ProvidedKey<Key, T$1, D>;
+declare function invoke<Deps extends Record<string, string | ProvidedKey<any, any, any>>>(container: Container, option: InvokeOptionWithKeys<Deps>): void;
+declare function invoke<D extends DependencyMap>(container: Container, option: InvokeOption<D>): void;
+declare function start(container: Container): Promise<void>;
+declare function stop(container: Container): Promise<void>;
+//#endregion
+//#region src/global.d.ts
+declare function setLogger(logger: Logger): void;
+declare function provide$1<T$1, Key extends string, Deps extends Record<string, string | ProvidedKey<any, any, any>>>(name: Key, option: ProvideOptionWithKeys<T$1, Deps>): ProvidedKey<Key, T$1, ResolveDependencyDeclaration<Deps>>;
+declare function provide$1<D extends DependencyMap | undefined, T$1 = any, Key extends string = string>(name: Key, option: ProvideOption<T$1, D>): ProvidedKey<Key, T$1, D>;
+declare function provide$1<T$1, Key extends string, Deps extends Record<string, string | ProvidedKey<any, any, any>>>(option: ProvideOptionWithKeys<T$1, Deps>): ProvidedKey<Key, T$1, ResolveDependencyDeclaration<Deps>>;
+declare function provide$1<D extends DependencyMap | undefined, T$1 = any, Key extends string = string>(option: ProvideOption<T$1, D>): ProvidedKey<Key, T$1, D>;
+declare function invoke$1<Deps extends Record<string, string | ProvidedKey<any, any, any>>>(option: InvokeOptionWithKeys<Deps>): void;
+declare function invoke$1<D extends DependencyMap>(option: InvokeOption<D>): void;
+declare function start$1(): Promise<void>;
+declare function stop$1(): Promise<void>;
+//#endregion
+//#region src/index.d.ts
+declare const injecta: {
+  provide: typeof provide$1;
+  invoke: typeof invoke$1;
+  start: typeof start$1;
+  stop: typeof stop$1;
+  setLogger: typeof setLogger;
+};
+//#endregion
+export { type BuildContext, type Container, type DependencyMap, type InvokeOption, type InvokeOptionFunc, type InvokeOptionObject, type InvokeOptionObjectWithKeys, type InvokeOptionWithKeys, type Lifecycle, type Logger, type LoggerOptions, type ProvideOption, type ProvideOptionFunc, type ProvideOptionObject, type ProvideOptionObjectWithKeys, type ProvideOptionWithKeys, type ProvidedKey, type ResolveDependencyDeclaration, createContainer, createDefaultLogger, createLoggLogger, createNoopLogger, injecta, invoke, lifecycle, provide, start, stop };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,272 @@
+import ErrorStackParser from "error-stack-parser";
+import { nanoid } from "nanoid";
+
+//#region src/global.ts
+let globalContainer = createContainer();
+function setLogger(logger) {
+	globalContainer.logger = logger;
+}
+function provide$1(nameOrOption, option) {
+	if (option != null && typeof option === "function") return provide(globalContainer, nameOrOption, {
+		build: option,
+		autoNameStackIndex: 2
+	});
+	return provide(globalContainer, nameOrOption, {
+		...option,
+		autoNameStackIndex: 2
+	});
+}
+function invoke$1(option) {
+	if (typeof option === "function") globalContainer.invocations.push({ callback: option });
+	else globalContainer.invocations.push(option);
+}
+function start$1() {
+	return start(globalContainer);
+}
+function stop$1() {
+	return stop(globalContainer);
+}
+
+//#endregion
+//#region package.json
+var name = "injeca";
+
+//#endregion
+//#region src/logger.ts
+function formatDuration(ms) {
+	if (ms < 1) return `${(ms * 1e3).toFixed(3)}µs`;
+	if (ms < 1e3) return `${ms.toFixed(3)}ms`;
+	return `${(ms / 1e3).toFixed(3)}s`;
+}
+function createDefaultLogger() {
+	return {
+		provide: (name$1, dependencies) => {
+			const depsStr = dependencies.length > 0 ? ` (depends on: ${dependencies.join(", ")})` : "";
+			console.log(`[${name$1}] PROVIDE    ${name$1}${depsStr}`);
+		},
+		invoke: (dependencies) => {
+			const depsStr = dependencies.length > 0 ? ` (depends on: ${dependencies.join(", ")})` : "";
+			console.log(`[${name}] INVOKE${depsStr}`);
+		},
+		beforeRun: (name$1) => {
+			console.log(`[${name$1}] BEFORE RUN provide: ${name$1}()`);
+		},
+		run: (name$1, duration) => {
+			console.log(`[${name$1}] RUN        provide: ${name$1}() in ${formatDuration(duration)}`);
+		},
+		hookOnStart: (name$1) => {
+			console.log(`[${name$1}] HOOK OnStart        ${name$1}() executing`);
+		},
+		hookOnStartComplete: (name$1, duration) => {
+			console.log(`[${name$1}] HOOK OnStart        ${name$1}() ran successfully in ${formatDuration(duration)}`);
+		},
+		hookOnStop: (name$1) => {
+			console.log(`[${name$1}] HOOK OnStop         ${name$1}() executing`);
+		},
+		hookOnStopComplete: (name$1, duration) => {
+			console.log(`[${name$1}] HOOK OnStop         ${name$1}() ran successfully in ${formatDuration(duration)}`);
+		},
+		running: () => {
+			console.log(`[${name}] RUNNING`);
+		}
+	};
+}
+function createLoggLogger(logg) {
+	return {
+		provide: (name$1, dependencies) => {
+			const depsStr = dependencies.length > 0 ? ` (depends on: ${dependencies.join(", ")})` : "";
+			logg.log(`PROVIDE    ${name$1}${depsStr}`);
+		},
+		invoke: (dependencies) => {
+			const depsStr = dependencies.length > 0 ? ` (depends on: ${dependencies.join(", ")})` : "";
+			logg.log(`INVOKE${depsStr}`);
+		},
+		beforeRun: (name$1) => {
+			logg.log(`BEFORE RUN provide: ${name$1}()`);
+		},
+		run: (name$1, duration) => {
+			logg.log(`RUN        provide: ${name$1}() in ${formatDuration(duration)}`);
+		},
+		hookOnStart: (name$1) => {
+			logg.log(`HOOK OnStart        ${name$1}() executing`);
+		},
+		hookOnStartComplete: (name$1, duration) => {
+			logg.log(`HOOK OnStart        ${name$1}() ran successfully in ${formatDuration(duration)}`);
+		},
+		hookOnStop: (name$1) => {
+			logg.log(`HOOK OnStop         ${name$1}() executing`);
+		},
+		hookOnStopComplete: (name$1, duration) => {
+			logg.log(`HOOK OnStop         ${name$1}() ran successfully in ${formatDuration(duration)}`);
+		},
+		running: () => {
+			logg.log(`RUNNING`);
+		}
+	};
+}
+function createNoopLogger() {
+	return {
+		provide: () => {},
+		invoke: () => {},
+		beforeRun: () => {},
+		run: () => {},
+		hookOnStart: () => {},
+		hookOnStartComplete: () => {},
+		hookOnStop: () => {},
+		hookOnStopComplete: () => {},
+		running: () => {}
+	};
+}
+
+//#endregion
+//#region src/scoped.ts
+const lifecycle = { key: "lifecycle" };
+function createContainer(options) {
+	const logger = options?.enabled === false ? createNoopLogger() : options?.logger ?? createDefaultLogger();
+	return {
+		providers: /* @__PURE__ */ new Map(),
+		instances: /* @__PURE__ */ new Map(),
+		lifecycleHooks: /* @__PURE__ */ new Map(),
+		dependencyGraph: /* @__PURE__ */ new Map(),
+		invocations: [],
+		logger
+	};
+}
+function normalizeName(nameOrProvidedKey) {
+	if (typeof nameOrProvidedKey === "object" && nameOrProvidedKey !== null && "key" in nameOrProvidedKey) return nameOrProvidedKey.key;
+	return nameOrProvidedKey;
+}
+function normalizeProvideOption(nameOrOption, option) {
+	if (typeof nameOrOption === "string") {
+		if (option == null || !("build" in option) && typeof option !== "function") throw new Error("When using provide(...) as named callback, the second argument must be either a valid ProvideOptionObject<T, D> or a ProvideOptionFunc<T, D>.");
+		if (typeof option === "function") return { build: option };
+		return option;
+	}
+	if (typeof nameOrOption === "object" && "key" in nameOrOption) {
+		if (option == null || !("build" in option) && typeof option !== "function") throw new Error("When using provide(...) as typed ProvideOptionWithKeys<T, D, Key> callback, the second argument must be either a valid ProvideOptionObject<T, D> or a ProvideOptionFunc<T, D>.");
+		if (typeof option === "function") return { build: option };
+		return option;
+	}
+	if (typeof nameOrOption === "function") return { build: nameOrOption };
+	return nameOrOption;
+}
+function provide(container, nameOrOption, option) {
+	const parentFile = ErrorStackParser.parse(/* @__PURE__ */ new Error("providing"))[option?.autoNameStackIndex ?? 1];
+	const name$1 = typeof nameOrOption === "string" ? nameOrOption : `${parentFile.fileName ?? `unknown-${nanoid()}`}:${parentFile.lineNumber ?? 0}:${parentFile.columnNumber ?? 0}`;
+	const providerObject = normalizeProvideOption(nameOrOption, option);
+	if (providerObject.dependsOn) {
+		const resolvedDependsOn = {};
+		for (const [key, value] of Object.entries(providerObject.dependsOn)) resolvedDependsOn[key] = normalizeName(value);
+		providerObject.dependsOn = resolvedDependsOn;
+	}
+	container.providers.set(name$1, providerObject);
+	const dependencies = providerObject.dependsOn ? Object.values(providerObject.dependsOn) : [];
+	container.logger.provide(name$1, dependencies);
+	container.dependencyGraph.set(name$1, dependencies);
+	return { key: name$1 };
+}
+function invoke(container, option) {
+	const invocationObject = typeof option === "function" ? { callback: option } : option;
+	if (invocationObject.dependsOn) {
+		const resolvedDependsOn = {};
+		for (const [key, value] of Object.entries(invocationObject.dependsOn)) resolvedDependsOn[key] = normalizeName(value);
+		invocationObject.dependsOn = resolvedDependsOn;
+	}
+	const dependencies = invocationObject.dependsOn ? Object.values(invocationObject.dependsOn) : [];
+	container.logger.invoke(dependencies);
+	container.invocations.push(invocationObject);
+}
+async function resolveInstance(container, name$1) {
+	if (container.instances.has(name$1)) return container.instances.get(name$1);
+	const provider = container.providers.get(name$1);
+	if (!provider) throw new Error(`No provider found for '${name$1}'`);
+	const resolvedDependencies = {};
+	let serviceLifecycle = null;
+	if (provider.dependsOn) for (const [key, depName] of Object.entries(provider.dependsOn)) if (depName === "lifecycle") {
+		const { buildLifecycle } = await import("./builtin-BN5UvvMB.mjs");
+		serviceLifecycle = buildLifecycle();
+		resolvedDependencies[key] = serviceLifecycle;
+		container.lifecycleHooks.set(name$1, serviceLifecycle);
+	} else resolvedDependencies[key] = await resolveInstance(container, depName);
+	const context = {
+		container,
+		dependsOn: resolvedDependencies,
+		name: name$1
+	};
+	container.logger.beforeRun(name$1);
+	const startTime = performance.now();
+	const instance = await provider.build(context);
+	const duration = performance.now() - startTime;
+	container.logger.run(name$1, duration);
+	container.instances.set(name$1, instance);
+	return instance;
+}
+function topologicalSort(dependencyGraph) {
+	const visited = /* @__PURE__ */ new Set();
+	const visiting = /* @__PURE__ */ new Set();
+	const result = [];
+	function visit(node) {
+		if (visiting.has(node)) throw new Error(`Circular dependency detected involving '${node}'`);
+		if (visited.has(node)) return;
+		visiting.add(node);
+		const dependencies = dependencyGraph.get(node) || [];
+		for (const dep of dependencies) visit(dep);
+		visiting.delete(node);
+		visited.add(node);
+		result.push(node);
+	}
+	for (const node of dependencyGraph.keys()) if (!visited.has(node)) visit(node);
+	return result;
+}
+async function startLifecycleHooks(container) {
+	const sortedServices = topologicalSort(container.dependencyGraph);
+	for (const serviceName of sortedServices) {
+		const lifecycle$1 = container.lifecycleHooks.get(serviceName);
+		if (lifecycle$1?.emitOnStart) {
+			container.logger.hookOnStart(serviceName);
+			const startTime = performance.now();
+			await lifecycle$1.emitOnStart();
+			const duration = performance.now() - startTime;
+			container.logger.hookOnStartComplete(serviceName, duration);
+		}
+	}
+}
+async function stopLifecycleHooks(container) {
+	const sortedServices = topologicalSort(container.dependencyGraph);
+	for (const serviceName of sortedServices.reverse()) {
+		const lifecycle$1 = container.lifecycleHooks.get(serviceName);
+		if (lifecycle$1?.emitOnStop) {
+			container.logger.hookOnStop(serviceName);
+			const startTime = performance.now();
+			await lifecycle$1.emitOnStop();
+			const duration = performance.now() - startTime;
+			container.logger.hookOnStopComplete(serviceName, duration);
+		}
+	}
+}
+async function start(container) {
+	await startLifecycleHooks(container);
+	for (const invocation of container.invocations) {
+		const resolvedDependencies = {};
+		if (invocation.dependsOn) for (const [key, depName] of Object.entries(invocation.dependsOn)) resolvedDependencies[key] = await resolveInstance(container, normalizeName(depName));
+		await invocation.callback(resolvedDependencies);
+	}
+	container.logger.running();
+}
+async function stop(container) {
+	await stopLifecycleHooks(container);
+}
+
+//#endregion
+//#region src/index.ts
+const injecta = {
+	provide: provide$1,
+	invoke: invoke$1,
+	start: start$1,
+	stop: stop$1,
+	setLogger
+};
+
+//#endregion
+export { createContainer, createDefaultLogger, createLoggLogger, createNoopLogger, injecta, invoke, lifecycle, provide, start, stop };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["provide","indexProvide","invoke","start","indexStart","stop","indexStop","name","lifecycle: ProvidedKey<'lifecycle', Lifecycle, undefined>","name","resolvedDependsOn: Record<string, string>","resolvedDependencies: Record<string, any>","serviceLifecycle: any","context: BuildContext<typeof provider.dependsOn>","result: string[]","lifecycle","globalProvide","globalInvoke","globalStart","globalStop","globalSetLogger"],"sources":["../src/global.ts","../package.json","../src/logger.ts","../src/scoped.ts","../src/index.ts"],"sourcesContent":["import type { DependencyMap, InvokeOption, InvokeOptionWithKeys, Logger, ProvideOption, ProvideOptionWithKeys, ResolveDependencyDeclaration } from '.'\nimport type { ProvidedKey } from './scoped'\n\nimport { createContainer, provide as indexProvide, start as indexStart, stop as indexStop } from '.'\n\nlet globalContainer = createContainer()\n\nexport function setLogger(logger: Logger) {\n  globalContainer.logger = logger\n}\n\nexport function resetContainer() {\n  globalContainer = createContainer()\n}\n\nexport function provide<T, Key extends string, Deps extends Record<string, string | ProvidedKey<any, any, any>>>(name: Key, option: ProvideOptionWithKeys<T, Deps>): ProvidedKey<Key, T, ResolveDependencyDeclaration<Deps>>\nexport function provide<D extends DependencyMap | undefined, T = any, Key extends string = string>(name: Key, option: ProvideOption<T, D>): ProvidedKey<Key, T, D>\nexport function provide<T, Key extends string, Deps extends Record<string, string | ProvidedKey<any, any, any>>>(option: ProvideOptionWithKeys<T, Deps>): ProvidedKey<Key, T, ResolveDependencyDeclaration<Deps>>\nexport function provide<D extends DependencyMap | undefined, T = any, Key extends string = string>(option: ProvideOption<T, D>): ProvidedKey<Key, T, D>\nexport function provide<D extends DependencyMap | undefined, T = any, Key extends string = string>(nameOrOption: Key | ProvideOption<T, D> | ProvideOptionWithKeys<T, any>, option?: ProvideOption<T, D> | ProvideOptionWithKeys<T, any>): ProvidedKey<Key, T, D> {\n  if (option != null && typeof option === 'function') {\n    return indexProvide(globalContainer, nameOrOption as any, { build: option, autoNameStackIndex: 2 } as any)\n  }\n\n  return indexProvide(globalContainer, nameOrOption as any, { ...option, autoNameStackIndex: 2 } as any)\n}\n\nexport function invoke<Deps extends Record<string, string | ProvidedKey<any, any, any>>>(option: InvokeOptionWithKeys<Deps>): void\nexport function invoke<D extends DependencyMap>(option: InvokeOption<D>): void\nexport function invoke<D extends DependencyMap>(option: InvokeOption<D> | InvokeOptionWithKeys<any>): void {\n  if (typeof option === 'function') {\n    globalContainer.invocations.push({ callback: option } as any)\n  }\n  else {\n    globalContainer.invocations.push(option as any)\n  }\n}\n\nexport function start(): Promise<void> {\n  return indexStart(globalContainer)\n}\n\nexport function stop(): Promise<void> {\n  return indexStop(globalContainer)\n}\n","{\n  \"name\": \"injeca\",\n  \"type\": \"module\",\n  \"packageManager\": \"pnpm@10.22.0\",\n  \"description\": \"Pure function programming based dependency injection library inspired by go.uber.org/fig and go.uber.org/dig.\",\n  \"author\": {\n    \"name\": \"Moeru AI Project AIRI Team\",\n    \"email\": \"airi@moeru.ai\",\n    \"url\": \"https://github.com/moeru-ai\"\n  },\n  \"license\": \"MIT\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"https://github.com/moeru-ai/injeca.git\"\n  },\n  \"exports\": {\n    \".\": {\n      \"type\": \"./dist/index.d.js\",\n      \"default\": \"./dist/index.js\"\n    }\n  },\n  \"files\": [\n    \"README.md\",\n    \"dist\"\n  ],\n  \"scripts\": {\n    \"build\": \"tsdown\",\n    \"test\": \"vitest --coverage\",\n    \"test:run\": \"vitest run\",\n    \"lint\": \"eslint --cache .\",\n    \"lint:fix\": \"eslint --cache --fix .\",\n    \"typecheck\": \"tsc --noEmit\",\n    \"up\": \"taze -w -r -I -f && pnpm prune && pnpm dedupe\"\n  },\n  \"peerDependencies\": {\n    \"@guiiai/logg\": \">= 1\",\n    \"error-stack-parser\": \"^2.1.4\",\n    \"nanoid\": \">=5\"\n  },\n  \"peerDependenciesMeta\": {\n    \"@guiiai/logg\": {\n      \"optional\": true\n    }\n  },\n  \"devDependencies\": {\n    \"@antfu/eslint-config\": \"^6.2.0\",\n    \"@moeru/eslint-config\": \"0.1.0-beta.13\",\n    \"@moeru/tsconfig\": \"0.1.0-beta.13\",\n    \"@types/node\": \"^24.10.1\",\n    \"bumpp\": \"^10.3.1\",\n    \"eslint\": \"^9.39.1\",\n    \"eslint-plugin-oxlint\": \"^1.28.0\",\n    \"oxlint\": \"^1.28.0\",\n    \"publint\": \"^0.3.15\",\n    \"taze\": \"^19.9.0\",\n    \"tsdown\": \"^0.16.4\",\n    \"typescript\": \"^5.9.3\",\n    \"unplugin-unused\": \"^0.5.6\",\n    \"vite\": \"^7.2.2\",\n    \"vitest\": \"^4.0.9\"\n  }\n}\n","import type { Logg as LoggLogger } from '@guiiai/logg'\n\nimport { name } from '../package.json'\n\nexport interface Logger {\n  provide: (name: string, dependencies: string[]) => void\n  invoke: (dependencies: string[]) => void\n  beforeRun: (name: string) => void\n  run: (name: string, duration: number) => void\n  hookOnStart: (name: string) => void\n  hookOnStartComplete: (name: string, duration: number) => void\n  hookOnStop: (name: string) => void\n  hookOnStopComplete: (name: string, duration: number) => void\n  running: () => void\n}\n\nexport interface LoggerOptions {\n  enabled?: boolean\n  logger?: Logger\n}\n\nfunction formatDuration(ms: number): string {\n  if (ms < 1) {\n    return `${(ms * 1000).toFixed(3)}µs`\n  }\n  if (ms < 1000) {\n    return `${ms.toFixed(3)}ms`\n  }\n  return `${(ms / 1000).toFixed(3)}s`\n}\n\nexport function createDefaultLogger(): Logger {\n  return {\n    provide: (name: string, dependencies: string[]) => {\n      const depsStr = dependencies.length > 0 ? ` (depends on: ${dependencies.join(', ')})` : ''\n      // eslint-disable-next-line no-console\n      console.log(`[${name}] PROVIDE    ${name}${depsStr}`)\n    },\n\n    invoke: (dependencies: string[]) => {\n      const depsStr = dependencies.length > 0 ? ` (depends on: ${dependencies.join(', ')})` : ''\n      // eslint-disable-next-line no-console\n      console.log(`[${name}] INVOKE${depsStr}`)\n    },\n\n    beforeRun: (name: string) => {\n      // eslint-disable-next-line no-console\n      console.log(`[${name}] BEFORE RUN provide: ${name}()`)\n    },\n\n    run: (name: string, duration: number) => {\n      // eslint-disable-next-line no-console\n      console.log(`[${name}] RUN        provide: ${name}() in ${formatDuration(duration)}`)\n    },\n\n    hookOnStart: (name: string) => {\n      // eslint-disable-next-line no-console\n      console.log(`[${name}] HOOK OnStart        ${name}() executing`)\n    },\n\n    hookOnStartComplete: (name: string, duration: number) => {\n      // eslint-disable-next-line no-console\n      console.log(`[${name}] HOOK OnStart        ${name}() ran successfully in ${formatDuration(duration)}`)\n    },\n\n    hookOnStop: (name: string) => {\n      // eslint-disable-next-line no-console\n      console.log(`[${name}] HOOK OnStop         ${name}() executing`)\n    },\n\n    hookOnStopComplete: (name: string, duration: number) => {\n      // eslint-disable-next-line no-console\n      console.log(`[${name}] HOOK OnStop         ${name}() ran successfully in ${formatDuration(duration)}`)\n    },\n\n    running: () => {\n      // eslint-disable-next-line no-console\n      console.log(`[${name}] RUNNING`)\n    },\n  }\n}\n\nexport function createLoggLogger(logg: LoggLogger): Logger {\n  return {\n    provide: (name: string, dependencies: string[]) => {\n      const depsStr = dependencies.length > 0 ? ` (depends on: ${dependencies.join(', ')})` : ''\n      logg.log(`PROVIDE    ${name}${depsStr}`)\n    },\n\n    invoke: (dependencies: string[]) => {\n      const depsStr = dependencies.length > 0 ? ` (depends on: ${dependencies.join(', ')})` : ''\n      logg.log(`INVOKE${depsStr}`)\n    },\n\n    beforeRun: (name: string) => {\n      logg.log(`BEFORE RUN provide: ${name}()`)\n    },\n\n    run: (name: string, duration: number) => {\n      logg.log(`RUN        provide: ${name}() in ${formatDuration(duration)}`)\n    },\n\n    hookOnStart: (name: string) => {\n      logg.log(`HOOK OnStart        ${name}() executing`)\n    },\n\n    hookOnStartComplete: (name: string, duration: number) => {\n      logg.log(`HOOK OnStart        ${name}() ran successfully in ${formatDuration(duration)}`)\n    },\n\n    hookOnStop: (name: string) => {\n      logg.log(`HOOK OnStop         ${name}() executing`)\n    },\n\n    hookOnStopComplete: (name: string, duration: number) => {\n      logg.log(`HOOK OnStop         ${name}() ran successfully in ${formatDuration(duration)}`)\n    },\n\n    running: () => {\n      logg.log(`RUNNING`)\n    },\n  }\n}\n\nexport function createNoopLogger(): Logger {\n  return {\n    provide: () => {},\n    invoke: () => {},\n    beforeRun: () => {},\n    run: () => {},\n    hookOnStart: () => {},\n    hookOnStartComplete: () => {},\n    hookOnStop: () => {},\n    hookOnStopComplete: () => {},\n    running: () => {},\n  }\n}\n","import type { Lifecycle, LifecycleTriggerable } from './builtin'\nimport type { Logger, LoggerOptions } from './logger'\n\nimport ErrorStackParser from 'error-stack-parser'\n\nimport { nanoid } from 'nanoid'\n\nimport { createDefaultLogger, createNoopLogger } from './logger'\n\nexport type DependencyMap = Record<string, any>\n\nexport interface Container {\n  providers: Map<string, ProvideOptionObject<any, any>>\n  instances: Map<string, any>\n  lifecycleHooks: Map<string, LifecycleTriggerable>\n  dependencyGraph: Map<string, string[]>\n  invocations: InvokeOptionObject<any>[]\n  logger: Logger\n}\n\nexport type BuildContext<D extends DependencyMap | undefined = undefined> = {\n  container: Container\n  name: string\n} & (D extends undefined ? { dependsOn?: unknown } : { dependsOn: D })\n\nexport type ResolveDependencyDeclaration<Deps extends Record<string, string | ProvidedKey<any, any, any>>> = {\n  [K in keyof Deps]: Deps[K] extends ProvidedKey<any, infer T, any> ? T : any\n}\n\nexport type ProvideOptionObject<T, D extends DependencyMap | undefined = undefined> = { build: (context: BuildContext<D>) => T | Promise<T> } & (D extends undefined ? { dependsOn?: Record<string, never> } : { dependsOn: { [K in keyof D]: string } })\nexport type ProvideOptionFunc<T, D extends DependencyMap | undefined = undefined> = (context: BuildContext<D>) => T | Promise<T>\nexport type ProvideOption<T, D extends DependencyMap | undefined = undefined> = ProvideOptionObject<T, D> | ProvideOptionFunc<T, D>\n\nexport interface ProvideOptionObjectWithKeys<T, Deps extends Record<string, string | ProvidedKey<any, any, any>>> {\n  build: (context: BuildContext<ResolveDependencyDeclaration<Deps>>) => T | Promise<T>\n  dependsOn: Deps\n}\nexport type ProvideOptionWithKeys<T, Deps extends Record<string, string | ProvidedKey<any, any, any>>> = ProvideOptionObjectWithKeys<T, Deps>\n\nexport type InvokeOptionObject<D extends DependencyMap | undefined = undefined> = { callback: (dependencies: D) => void | Promise<void> } & (D extends undefined ? { dependsOn?: Record<string, never> } : { dependsOn: { [K in keyof D]: string } })\nexport type InvokeOptionFunc<D extends DependencyMap | undefined = undefined> = (dependencies: D) => void | Promise<void>\nexport type InvokeOption<D extends DependencyMap | undefined = undefined> = InvokeOptionObject<D> | InvokeOptionFunc<D>\n\nexport interface InvokeOptionObjectWithKeys<Deps extends Record<string, string | ProvidedKey<any, any, any>>> {\n  callback: (dependencies: ResolveDependencyDeclaration<Deps>) => void | Promise<void>\n  dependsOn: Deps\n}\nexport type InvokeOptionWithKeys<Deps extends Record<string, string | ProvidedKey<any, any, any>>> = InvokeOptionObjectWithKeys<Deps>\n\nexport const lifecycle: ProvidedKey<'lifecycle', Lifecycle, undefined> = { key: 'lifecycle' }\n\nexport function createContainer(options?: LoggerOptions): Container {\n  const logger = options?.enabled === false\n    ? createNoopLogger()\n    : (options?.logger ?? createDefaultLogger())\n\n  return {\n    providers: new Map(),\n    instances: new Map(),\n    lifecycleHooks: new Map(),\n    dependencyGraph: new Map(),\n    invocations: [],\n    logger,\n  }\n}\n\n// eslint-disable-next-line unused-imports/no-unused-vars\nexport interface ProvidedKey<Key, T, D extends DependencyMap | undefined> {\n  key: Key\n}\n\nexport function normalizeName(nameOrProvidedKey: string | ProvidedKey<any, any, any>): string {\n  if (typeof nameOrProvidedKey === 'object' && nameOrProvidedKey !== null && 'key' in nameOrProvidedKey) {\n    return (nameOrProvidedKey as ProvidedKey<any, any, any>).key as string\n  }\n\n  return nameOrProvidedKey as string\n}\n\nexport function normalizeProvideOption<D extends DependencyMap | undefined, T = any, Key extends string = string>(nameOrOption: Key | ProvidedKey<Key, T, D> | ProvideOption<T, D> | ProvideOptionWithKeys<T, any>, option?: (ProvideOption<T, D> | ProvideOptionWithKeys<T, any>) & { autoNameStackIndex?: number }): ProvideOptionObject<T, D> {\n  if (typeof nameOrOption === 'string') {\n    if (option == null || (!('build' in option) && typeof option !== 'function')) {\n      throw new Error('When using provide(...) as named callback, the second argument must be either a valid ProvideOptionObject<T, D> or a ProvideOptionFunc<T, D>.')\n    }\n    if (typeof option === 'function') {\n      return { build: option } as ProvideOptionObject<T, D>\n    }\n\n    return option as ProvideOptionObject<T, D>\n  }\n  if (typeof nameOrOption === 'object' && 'key' in nameOrOption) {\n    if (option == null || (!('build' in option) && typeof option !== 'function')) {\n      throw new Error('When using provide(...) as typed ProvideOptionWithKeys<T, D, Key> callback, the second argument must be either a valid ProvideOptionObject<T, D> or a ProvideOptionFunc<T, D>.')\n    }\n    if (typeof option === 'function') {\n      return { build: option } as ProvideOptionObject<T, D>\n    }\n\n    return option as ProvideOptionObject<T, D>\n  }\n\n  if (typeof nameOrOption === 'function') {\n    return { build: nameOrOption } as ProvideOptionObject<T, D>\n  }\n\n  return nameOrOption as ProvideOptionObject<T, D>\n}\n\nexport function provide<T, Key extends string, Deps extends Record<string, string | ProvidedKey<any, any, any>>>(container: Container, name: Key, option: ProvideOptionWithKeys<T, Deps>): ProvidedKey<Key, T, ResolveDependencyDeclaration<Deps>>\nexport function provide<T, Key extends string, Deps extends Record<string, string | ProvidedKey<any, any, any>>>(container: Container, option: ProvideOptionWithKeys<T, Deps> & { autoNameStackIndex?: number }): ProvidedKey<Key, T, ResolveDependencyDeclaration<Deps>>\nexport function provide<D extends DependencyMap | undefined, T = any, Key extends string = string>(container: Container, name: Key, option: ProvideOption<T, D>): ProvidedKey<Key, T, D>\nexport function provide<D extends DependencyMap | undefined, T = any, Key extends string = string>(container: Container, option: ProvideOption<T, D> & { autoNameStackIndex?: number }): ProvidedKey<Key, T, D>\nexport function provide<D extends DependencyMap | undefined, T = any, Key extends string = string>(container: Container, nameOrOption: Key | ProvideOption<T, D> | ProvideOptionWithKeys<T, any>, option?: (ProvideOption<T, D> | ProvideOptionWithKeys<T, any>) & { autoNameStackIndex?: number }): ProvidedKey<Key, T, D> {\n  const parentFile = ErrorStackParser.parse(new Error('providing'))[option?.autoNameStackIndex ?? 1]\n  const name = typeof nameOrOption === 'string'\n    ? nameOrOption\n    : `${parentFile.fileName ?? `unknown-${nanoid()}`}:${parentFile.lineNumber ?? 0}:${parentFile.columnNumber ?? 0}`\n\n  const providerObject = normalizeProvideOption<D, T, Key>(nameOrOption, option) as unknown as ProvideOptionObject<any, any>\n  if (providerObject.dependsOn) {\n    const resolvedDependsOn: Record<string, string> = {}\n    for (const [key, value] of Object.entries(providerObject.dependsOn)) {\n      resolvedDependsOn[key] = normalizeName(value)\n    }\n\n    providerObject.dependsOn = resolvedDependsOn\n  }\n\n  container.providers.set(name, providerObject)\n\n  const dependencies = providerObject.dependsOn ? Object.values(providerObject.dependsOn) : []\n  container.logger.provide(name, dependencies)\n  container.dependencyGraph.set(name, dependencies)\n\n  return { key: name } as ProvidedKey<Key, T, D>\n}\n\nexport function invoke<Deps extends Record<string, string | ProvidedKey<any, any, any>>>(container: Container, option: InvokeOptionWithKeys<Deps>): void\nexport function invoke<D extends DependencyMap>(container: Container, option: InvokeOption<D>): void\nexport function invoke<D extends DependencyMap>(container: Container, option: InvokeOption<D> | InvokeOptionWithKeys<any>): void {\n  const invocationObject = typeof option === 'function'\n    ? { callback: option } as InvokeOptionObject<any>\n    : option as InvokeOptionObject<any>\n\n  if (invocationObject.dependsOn) {\n    const resolvedDependsOn: Record<string, string> = {}\n    for (const [key, value] of Object.entries(invocationObject.dependsOn)) {\n      resolvedDependsOn[key] = normalizeName(value)\n    }\n\n    invocationObject.dependsOn = resolvedDependsOn\n  }\n\n  const dependencies = invocationObject.dependsOn ? Object.values(invocationObject.dependsOn) : []\n\n  container.logger.invoke(dependencies)\n  container.invocations.push(invocationObject)\n}\n\nasync function resolveInstance<T>(container: Container, name: string): Promise<T> {\n  if (container.instances.has(name)) {\n    return container.instances.get(name) as T\n  }\n\n  const provider = container.providers.get(name)\n  if (!provider) {\n    throw new Error(`No provider found for '${name}'`)\n  }\n\n  const resolvedDependencies: Record<string, any> = {}\n  let serviceLifecycle: any = null\n\n  if (provider.dependsOn) {\n    for (const [key, depName] of Object.entries(provider.dependsOn)) {\n      if (depName === 'lifecycle') {\n        // Create individual lifecycle instance for this service\n        const { buildLifecycle } = await import('./builtin')\n        serviceLifecycle = buildLifecycle()\n        resolvedDependencies[key] = serviceLifecycle\n\n        // Track this service's lifecycle\n        container.lifecycleHooks.set(name, serviceLifecycle)\n      }\n      else {\n        resolvedDependencies[key] = await resolveInstance(container, depName)\n      }\n    }\n  }\n\n  const context: BuildContext<typeof provider.dependsOn> = {\n    container,\n    dependsOn: resolvedDependencies,\n    name,\n  }\n\n  container.logger.beforeRun(name)\n\n  const startTime = performance.now()\n  const instance = await provider.build(context)\n  const duration = performance.now() - startTime\n\n  container.logger.run(name, duration)\n\n  container.instances.set(name, instance)\n\n  return instance as T\n}\n\nfunction topologicalSort(dependencyGraph: Map<string, string[]>): string[] {\n  const visited = new Set<string>()\n  const visiting = new Set<string>()\n  const result: string[] = []\n\n  function visit(node: string) {\n    if (visiting.has(node)) {\n      throw new Error(`Circular dependency detected involving '${node}'`)\n    }\n    if (visited.has(node)) {\n      return\n    }\n\n    visiting.add(node)\n    const dependencies = dependencyGraph.get(node) || []\n    for (const dep of dependencies) {\n      visit(dep)\n    }\n    visiting.delete(node)\n    visited.add(node)\n    result.push(node)\n  }\n\n  for (const node of dependencyGraph.keys()) {\n    if (!visited.has(node)) {\n      visit(node)\n    }\n  }\n\n  return result\n}\n\nexport async function startLifecycleHooks(container: Container): Promise<void> {\n  const sortedServices = topologicalSort(container.dependencyGraph)\n\n  for (const serviceName of sortedServices) {\n    const lifecycle = container.lifecycleHooks.get(serviceName)\n    if (lifecycle?.emitOnStart) {\n      container.logger.hookOnStart(serviceName)\n\n      const startTime = performance.now()\n      await lifecycle.emitOnStart()\n      const duration = performance.now() - startTime\n\n      container.logger.hookOnStartComplete(serviceName, duration)\n    }\n  }\n}\n\nexport async function stopLifecycleHooks(container: Container): Promise<void> {\n  const sortedServices = topologicalSort(container.dependencyGraph)\n\n  // Shutdown in reverse order\n  for (const serviceName of sortedServices.reverse()) {\n    const lifecycle = container.lifecycleHooks.get(serviceName)\n    if (lifecycle?.emitOnStop) {\n      container.logger.hookOnStop(serviceName)\n\n      const startTime = performance.now()\n      await lifecycle.emitOnStop()\n      const duration = performance.now() - startTime\n\n      container.logger.hookOnStopComplete(serviceName, duration)\n    }\n  }\n}\n\nexport async function start(container: Container): Promise<void> {\n  await startLifecycleHooks(container)\n\n  for (const invocation of container.invocations) {\n    const resolvedDependencies: Record<string, any> = {}\n\n    if (invocation.dependsOn) {\n      for (const [key, depName] of Object.entries(invocation.dependsOn)) {\n        resolvedDependencies[key] = await resolveInstance(container, normalizeName(depName))\n      }\n    }\n\n    await invocation.callback(resolvedDependencies)\n  }\n\n  container.logger.running()\n}\n\nexport async function stop(container: Container): Promise<void> {\n  await stopLifecycleHooks(container)\n}\n","import {\n  invoke as globalInvoke,\n  provide as globalProvide,\n  setLogger as globalSetLogger,\n  start as globalStart,\n  stop as globalStop,\n} from './global'\n\nexport type { Lifecycle } from './builtin'\n\nexport type { Logger, LoggerOptions } from './logger'\n\nexport {\n  createDefaultLogger,\n  createLoggLogger,\n  createNoopLogger,\n} from './logger'\n\nexport {\n  createContainer,\n  invoke,\n  lifecycle,\n  provide,\n  start,\n  stop,\n} from './scoped'\nexport type {\n  BuildContext,\n  Container,\n  DependencyMap,\n  InvokeOption,\n  InvokeOptionFunc,\n  InvokeOptionObject,\n  InvokeOptionObjectWithKeys,\n  InvokeOptionWithKeys,\n  ProvidedKey,\n  ProvideOption,\n  ProvideOptionFunc,\n  ProvideOptionObject,\n  ProvideOptionObjectWithKeys,\n  ProvideOptionWithKeys,\n  ResolveDependencyDeclaration,\n} from './scoped'\n\nexport const injecta = {\n  provide: globalProvide,\n  invoke: globalInvoke,\n  start: globalStart,\n  stop: globalStop,\n  setLogger: globalSetLogger,\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "injeca",
+  "type": "module",
+  "version": "0.0.1",
+  "description": "Pure function programming based dependency injection library inspired by go.uber.org/fig and go.uber.org/dig.",
+  "author": {
+    "name": "Moeru AI Project AIRI Team",
+    "email": "airi@moeru.ai",
+    "url": "https://github.com/moeru-ai"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/moeru-ai/injeca.git"
+  },
+  "exports": {
+    ".": {
+      "type": "./dist/index.d.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "README.md",
+    "dist"
+  ],
+  "peerDependencies": {
+    "@guiiai/logg": ">= 1",
+    "error-stack-parser": "^2.1.4",
+    "nanoid": ">=5"
+  },
+  "peerDependenciesMeta": {
+    "@guiiai/logg": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "^6.2.0",
+    "@moeru/eslint-config": "0.1.0-beta.13",
+    "@moeru/tsconfig": "0.1.0-beta.13",
+    "@types/node": "^24.10.1",
+    "bumpp": "^10.3.1",
+    "eslint": "^9.39.1",
+    "eslint-plugin-oxlint": "^1.28.0",
+    "oxlint": "^1.28.0",
+    "publint": "^0.3.15",
+    "taze": "^19.9.0",
+    "tsdown": "^0.16.4",
+    "typescript": "^5.9.3",
+    "unplugin-unused": "^0.5.6",
+    "vite": "^7.2.2",
+    "vitest": "^4.0.9"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest --coverage",
+    "test:run": "vitest run",
+    "lint": "eslint --cache .",
+    "lint:fix": "eslint --cache --fix .",
+    "typecheck": "tsc --noEmit",
+    "up": "taze -w -r -I -f && pnpm prune && pnpm dedupe"
+  }
+}