@fluojs/di 1.1.0 → 3.0.0

package/dist/errors.d.ts

@@ -48,7 +48,8 @@ export declare class ScopeMismatchError extends FluoCodeError {
  *
  * @remarks
  * The formatted message includes the full dependency path plus a first-party hint that points callers toward
- * extracting shared logic or using `forwardRef()` for intentional cycle deferral.
+ * extracting shared logic, introducing a mediator, or moving the interaction to a later boundary.
+ * `forwardRef()` only defers declaration-time token lookup and cannot resolve a true constructor cycle.
  */
 export declare class CircularDependencyError extends FluoCodeError {
     constructor(chain: readonly unknown[], detail?: string);

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAmB,MAAM,cAAc,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAgCD;;;;;;GAMG;AACH,qBAAa,oBAAqB,SAAQ,aAAa;gBACzC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc;CAOtD;AAED;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,aAAa;gBAC7C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc;CAOtD;AAED;;;;;GAKG;AACH,qBAAa,2BAA4B,SAAQ,aAAa;gBAChD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc;CAOtD;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc;CAOtD;AAED;;;;;;GAMG;AACH,qBAAa,uBAAwB,SAAQ,aAAa;gBAC5C,KAAK,EAAE,SAAS,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM;CAWvD;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,aAAa;gBAC3C,KAAK,EAAE,OAAO;CAW3B"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAmB,MAAM,cAAc,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAgCD;;;;;;GAMG;AACH,qBAAa,oBAAqB,SAAQ,aAAa;gBACzC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc;CAOtD;AAED;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,aAAa;gBAC7C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc;CAOtD;AAED;;;;;GAKG;AACH,qBAAa,2BAA4B,SAAQ,aAAa;gBAChD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc;CAOtD;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc;CAOtD;AAED;;;;;;;GAOG;AACH,qBAAa,uBAAwB,SAAQ,aAAa;gBAC5C,KAAK,EAAE,SAAS,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM;CAWvD;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,aAAa;gBAC3C,KAAK,EAAE,OAAO;CAW3B"}

package/dist/errors.js

@@ -85,12 +85,13 @@ export class ScopeMismatchError extends FluoCodeError {
  *
  * @remarks
  * The formatted message includes the full dependency path plus a first-party hint that points callers toward
- * extracting shared logic or using `forwardRef()` for intentional cycle deferral.
+ * extracting shared logic, introducing a mediator, or moving the interaction to a later boundary.
+ * `forwardRef()` only defers declaration-time token lookup and cannot resolve a true constructor cycle.
  */
 export class CircularDependencyError extends FluoCodeError {
   constructor(chain, detail) {
     const path = chain.map(token => formatTokenName(token)).join(' -> ');
-    const hint = 'Break the cycle by extracting shared logic into a separate provider, or use forwardRef() to defer one side of the dependency.';
+    const hint = 'Break the constructor cycle by extracting shared logic into a separate provider, introducing a mediator, or moving the interaction to a later boundary. forwardRef() only defers declaration-time token lookup and cannot resolve a true constructor cycle.';
     super((detail ? `Circular dependency detected: ${path}. ${detail}` : `Circular dependency detected: ${path}`) + `\n  Dependency chain: ${path}` + `\n  Hint: ${hint}`, 'CIRCULAR_DEPENDENCY', {
       meta: {
         chain: chain.map(t => formatTokenName(t)),

package/dist/internal.d.ts

@@ -0,0 +1,18 @@
+import type { Token } from '@fluojs/core';
+import { type MultiContributionResolverOwner } from './multi-contribution-registry.js';
+/**
+ * Resolves one ordered multi-provider contribution through its owning container.
+ *
+ * This integration seam is for Fluo packages such as `@fluojs/runtime` and
+ * `@fluojs/testing`; application code must use `Container.resolve(...)`.
+ *
+ * @param container Container that owns the multi-provider registration.
+ * @param token Multi-provider token.
+ * @param contributionIndex Provider-order index for the contribution.
+ * @returns The canonical container-resolved contribution instance.
+ * @throws {ContainerResolutionError} When the container has no registered internal resolver.
+ */
+export declare function resolveMultiContribution(container: MultiContributionResolverOwner, token: Token, contributionIndex: number): Promise<unknown>;
+export { validateProviderInputs } from './provider-normalization.js';
+export type { Provider } from './types.js';
+//# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAG1C,OAAO,EACL,KAAK,8BAA8B,EAEpC,MAAM,kCAAkC,CAAC;AAE1C;;;;;;;;;;;GAWG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,8BAA8B,EACzC,KAAK,EAAE,KAAK,EACZ,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,OAAO,CAAC,CAWlB;AAED,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/internal.js

@@ -0,0 +1,26 @@
+import { ContainerResolutionError } from './errors.js';
+import { multiContributionResolverFor } from './multi-contribution-registry.js';
+
+/**
+ * Resolves one ordered multi-provider contribution through its owning container.
+ *
+ * This integration seam is for Fluo packages such as `@fluojs/runtime` and
+ * `@fluojs/testing`; application code must use `Container.resolve(...)`.
+ *
+ * @param container Container that owns the multi-provider registration.
+ * @param token Multi-provider token.
+ * @param contributionIndex Provider-order index for the contribution.
+ * @returns The canonical container-resolved contribution instance.
+ * @throws {ContainerResolutionError} When the container has no registered internal resolver.
+ */
+export async function resolveMultiContribution(container, token, contributionIndex) {
+  const resolver = multiContributionResolverFor(container);
+  if (!resolver) {
+    throw new ContainerResolutionError('Container does not expose the internal multi-provider contribution resolver.', {
+      token,
+      hint: 'Create the container through the @fluojs/di Container constructor.'
+    });
+  }
+  return resolver(token, contributionIndex);
+}
+export { validateProviderInputs } from './provider-normalization.js';

package/dist/multi-contribution-registry.d.ts

@@ -0,0 +1,26 @@
+import type { Token } from '@fluojs/core';
+type MultiContributionResolver = (token: Token, contributionIndex: number) => Promise<unknown>;
+/**
+ * Object identity that owns a canonical multi-provider contribution resolver.
+ *
+ * @internal
+ */
+export type MultiContributionResolverOwner = object;
+/**
+ * Associates a container with its canonical multi-provider contribution resolver.
+ *
+ * @internal
+ * @param container Container that owns the resolver.
+ * @param resolver Container-bound resolver that preserves DI lifecycle invariants.
+ */
+export declare function registerMultiContributionResolver(container: MultiContributionResolverOwner, resolver: MultiContributionResolver): void;
+/**
+ * Retrieves the canonical multi-provider contribution resolver for a container.
+ *
+ * @internal
+ * @param container Container that owns the resolver.
+ * @returns The container-bound resolver, if the container registered one.
+ */
+export declare function multiContributionResolverFor(container: MultiContributionResolverOwner): MultiContributionResolver | undefined;
+export {};
+//# sourceMappingURL=multi-contribution-registry.d.ts.map

package/dist/multi-contribution-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-contribution-registry.d.ts","sourceRoot":"","sources":["../src/multi-contribution-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,KAAK,yBAAyB,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE/F;;;;GAIG;AACH,MAAM,MAAM,8BAA8B,GAAG,MAAM,CAAC;AAIpD;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,8BAA8B,EACzC,QAAQ,EAAE,yBAAyB,GAClC,IAAI,CAEN;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,8BAA8B,GACxC,yBAAyB,GAAG,SAAS,CAEvC"}

package/dist/multi-contribution-registry.js

@@ -0,0 +1,29 @@
+/**
+ * Object identity that owns a canonical multi-provider contribution resolver.
+ *
+ * @internal
+ */
+
+const multiContributionResolvers = new WeakMap();
+
+/**
+ * Associates a container with its canonical multi-provider contribution resolver.
+ *
+ * @internal
+ * @param container Container that owns the resolver.
+ * @param resolver Container-bound resolver that preserves DI lifecycle invariants.
+ */
+export function registerMultiContributionResolver(container, resolver) {
+  multiContributionResolvers.set(container, resolver);
+}
+
+/**
+ * Retrieves the canonical multi-provider contribution resolver for a container.
+ *
+ * @internal
+ * @param container Container that owns the resolver.
+ * @returns The container-bound resolver, if the container registered one.
+ */
+export function multiContributionResolverFor(container) {
+  return multiContributionResolvers.get(container);
+}

package/dist/provider-normalization.d.ts

@@ -0,0 +1,17 @@
+import type { NormalizedProvider, Provider } from './types.js';
+/**
+ * Validates and snapshots a public provider declaration for container registration.
+ *
+ * @param provider Provider declaration crossing the container registration boundary.
+ * @returns An immutable provider record with normalized injection and scope fields.
+ */
+export declare function normalizeProvider(provider: Provider): NormalizedProvider;
+/**
+ * Validates provider declarations through the same normalization path used by `Container` registration.
+ *
+ * @param providers Provider declarations crossing an internal framework integration boundary.
+ * @returns The original provider list after every declaration has passed canonical normalization.
+ * @internal
+ */
+export declare function validateProviderInputs(providers: Provider[]): Provider[];
+//# sourceMappingURL=provider-normalization.d.ts.map

package/dist/provider-normalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-normalization.d.ts","sourceRoot":"","sources":["../src/provider-normalization.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAA2B,kBAAkB,EAAiB,QAAQ,EAAE,MAAM,YAAY,CAAC;AA6JvG;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,kBAAkB,CAuFxE;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAMxE"}

package/dist/provider-normalization.js

@@ -0,0 +1,216 @@
+import { getClassDiMetadata } from '@fluojs/core/internal';
+import { InvalidProviderError } from './errors.js';
+import { Scope } from './types.js';
+function isClassConstructor(value) {
+  return isConstructableFunction(value);
+}
+function isProviderObject(value) {
+  return typeof value === 'object' && value !== null;
+}
+function isClassType(value) {
+  return isConstructableFunction(value);
+}
+function isFactoryFunction(value) {
+  return typeof value === 'function';
+}
+function isTokenResolver(value) {
+  return typeof value === 'function';
+}
+function isConstructableFunction(value) {
+  if (typeof value !== 'function') {
+    return false;
+  }
+  try {
+    Reflect.construct(Object, [], value);
+    return true;
+  } catch (error) {
+    if (error instanceof TypeError) {
+      return false;
+    }
+    throw error;
+  }
+}
+function isToken(value) {
+  return typeof value === 'string' || typeof value === 'symbol' || isConstructableFunction(value);
+}
+function isScope(value) {
+  return value === 'singleton' || value === 'request' || value === 'transient';
+}
+function assertProviderToken(provider) {
+  if (!('provide' in provider) || !isToken(provider.provide)) {
+    throw new InvalidProviderError('Provider object must include a string, symbol, or constructable class provide token.');
+  }
+}
+function assertProviderStrategy(provider) {
+  const strategyCount = Number('useValue' in provider) + Number('useFactory' in provider) + Number('useClass' in provider) + Number('useExisting' in provider);
+  if (strategyCount !== 1) {
+    throw new InvalidProviderError('Provider object must declare exactly one of useValue, useFactory, useClass, or useExisting.');
+  }
+}
+function assertObjectProvider(provider) {
+  assertProviderToken(provider);
+  assertProviderStrategy(provider);
+}
+function normalizeProviderScope(scope, providerToken) {
+  if (scope === undefined) {
+    return undefined;
+  }
+  if (isScope(scope)) {
+    return scope;
+  }
+  throw new InvalidProviderError('Provider scope must be one of singleton, request, or transient.', {
+    token: providerToken,
+    scope: String(scope),
+    hint: 'Use Scope.DEFAULT, Scope.REQUEST, Scope.TRANSIENT, or the matching string literal.'
+  });
+}
+function normalizeInjectToken(token, providerToken, index) {
+  if (typeof token === 'object' && token !== null && '__forwardRef__' in token && token.__forwardRef__ === true) {
+    if (!('forwardRef' in token) || !isTokenResolver(token.forwardRef)) {
+      throw new InvalidProviderError(`Provider inject forwardRef wrapper at index ${String(index)} must expose a callable forwardRef function.`, {
+        token: providerToken
+      });
+    }
+    return Object.freeze({
+      __forwardRef__: true,
+      forwardRef: token.forwardRef
+    });
+  }
+  if (typeof token === 'object' && token !== null && '__optional__' in token && token.__optional__ === true) {
+    if (!('token' in token) || !isToken(token.token)) {
+      throw new InvalidProviderError(`Provider inject optional wrapper at index ${String(index)} must contain a valid token.`, {
+        token: providerToken
+      });
+    }
+    return Object.freeze({
+      __optional__: true,
+      token: token.token
+    });
+  }
+  if (isToken(token)) {
+    return token;
+  }
+  throw new InvalidProviderError(`Provider inject entry at index ${String(index)} must be a string, symbol, class, forwardRef(), or optional() token wrapper.`, {
+    token: providerToken,
+    hint: 'Check that every dependency token is defined, and use forwardRef() for declaration-order cycles.'
+  });
+}
+function normalizeInject(inject, providerToken) {
+  if (inject === undefined) {
+    return [];
+  }
+  if (!Array.isArray(inject)) {
+    throw new InvalidProviderError('Provider inject must be an array.', {
+      token: providerToken,
+      hint: 'Pass dependency tokens as inject: [DependencyA, DependencyB].'
+    });
+  }
+  return inject.map((token, index) => normalizeInjectToken(token, providerToken, index));
+}
+function freezeNormalizedProvider(provider) {
+  return Object.freeze({
+    ...provider,
+    inject: Object.freeze([...provider.inject])
+  });
+}
+
+/**
+ * Validates and snapshots a public provider declaration for container registration.
+ *
+ * @param provider Provider declaration crossing the container registration boundary.
+ * @returns An immutable provider record with normalized injection and scope fields.
+ */
+export function normalizeProvider(provider) {
+  if (isClassConstructor(provider)) {
+    const metadata = getClassDiMetadata(provider);
+    return freezeNormalizedProvider({
+      inject: normalizeInject(metadata?.inject, provider),
+      provide: provider,
+      scope: normalizeProviderScope(metadata?.scope, provider) ?? Scope.DEFAULT,
+      type: 'class',
+      useClass: provider
+    });
+  }
+  if (!isProviderObject(provider)) {
+    throw new InvalidProviderError('Unsupported provider type.');
+  }
+  const objectProvider = provider;
+  assertObjectProvider(objectProvider);
+  const explicitScope = normalizeProviderScope(objectProvider.scope, objectProvider.provide);
+  if ('useValue' in objectProvider) {
+    if (Object.hasOwn(objectProvider, 'inject')) {
+      throw new InvalidProviderError('Value providers must not declare inject dependencies.', {
+        token: objectProvider.provide
+      });
+    }
+    return freezeNormalizedProvider({
+      inject: [],
+      multi: objectProvider.multi,
+      provide: objectProvider.provide,
+      scope: Scope.DEFAULT,
+      type: 'value',
+      useValue: objectProvider.useValue
+    });
+  }
+  if ('useFactory' in objectProvider) {
+    if (!isFactoryFunction(objectProvider.useFactory)) {
+      throw new InvalidProviderError('Factory provider useFactory must be a function.', {
+        token: objectProvider.provide
+      });
+    }
+    const metadata = objectProvider.resolverClass ? getClassDiMetadata(objectProvider.resolverClass) : undefined;
+    return freezeNormalizedProvider({
+      inject: normalizeInject(objectProvider.inject, objectProvider.provide),
+      multi: objectProvider.multi,
+      provide: objectProvider.provide,
+      scope: explicitScope ?? normalizeProviderScope(metadata?.scope, objectProvider.provide) ?? Scope.DEFAULT,
+      type: 'factory',
+      useFactory: objectProvider.useFactory
+    });
+  }
+  if ('useClass' in objectProvider) {
+    if (!isClassType(objectProvider.useClass)) {
+      throw new InvalidProviderError('Class provider useClass must be a constructor.', {
+        token: objectProvider.provide
+      });
+    }
+    const metadata = getClassDiMetadata(objectProvider.useClass);
+    return freezeNormalizedProvider({
+      inject: normalizeInject(objectProvider.inject === undefined ? metadata?.inject : objectProvider.inject, objectProvider.provide),
+      multi: objectProvider.multi,
+      provide: objectProvider.provide,
+      scope: explicitScope ?? normalizeProviderScope(metadata?.scope, objectProvider.provide) ?? Scope.DEFAULT,
+      type: 'class',
+      useClass: objectProvider.useClass
+    });
+  }
+  if ('useExisting' in objectProvider) {
+    if (!isToken(objectProvider.useExisting)) {
+      throw new InvalidProviderError('Alias provider useExisting must be a string, symbol, or constructable class token.', {
+        token: objectProvider.provide
+      });
+    }
+    return freezeNormalizedProvider({
+      inject: [],
+      provide: objectProvider.provide,
+      scope: Scope.DEFAULT,
+      type: 'existing',
+      useExisting: objectProvider.useExisting
+    });
+  }
+  throw new InvalidProviderError('Provider object must declare exactly one of useValue, useFactory, useClass, or useExisting.');
+}
+
+/**
+ * Validates provider declarations through the same normalization path used by `Container` registration.
+ *
+ * @param providers Provider declarations crossing an internal framework integration boundary.
+ * @returns The original provider list after every declaration has passed canonical normalization.
+ * @internal
+ */
+export function validateProviderInputs(providers) {
+  for (const provider of providers) {
+    normalizeProvider(provider);
+  }
+  return providers;
+}

package/dist/types.d.ts

@@ -43,6 +43,7 @@ export interface FactoryProvider<T = unknown> {
     inject?: InjectionToken[];
     scope?: Scope;
     multi?: boolean;
+    /** Class metadata source used when the factory should inherit `@Scope(...)` metadata. */
     resolverClass?: ClassType;
 }
 /**
@@ -94,15 +95,15 @@ export interface RequestScopeContainer {
  * {@link ValueProvider}, or {@link ExistingProvider}. The container owns construction of normalized records.
  */
 export interface NormalizedProvider<T = unknown> {
-    inject: InjectionToken[];
-    provide: Token<T>;
-    scope: Scope;
-    type: 'class' | 'factory' | 'value' | 'existing';
-    useClass?: ClassType<T>;
-    useFactory?: (...deps: unknown[]) => MaybePromise<T>;
-    useValue?: T;
-    useExisting?: Token;
-    multi?: boolean;
+    readonly inject: readonly InjectionToken[];
+    readonly provide: Token<T>;
+    readonly scope: Scope;
+    readonly type: 'class' | 'factory' | 'value' | 'existing';
+    readonly useClass?: ClassType<T>;
+    readonly useFactory?: (...deps: unknown[]) => MaybePromise<T>;
+    readonly useValue?: T;
+    readonly useExisting?: Token;
+    readonly multi?: boolean;
 }
 /**
  * Wraps a token factory so DI metadata can defer token lookup until resolution time.

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -63,10 +63,10 @@ export let Scope;
  * ```
  */
 export function forwardRef(fn) {
-  return {
+  return Object.freeze({
     __forwardRef__: true,
     forwardRef: fn
-  };
+  });
 }
 
 /**
@@ -86,10 +86,10 @@ export function isForwardRef(value) {
  * @returns An optional-token wrapper understood by container resolution.
  */
 export function optional(token) {
-  return {
+  return Object.freeze({
     __optional__: true,
     token
-  };
+  });
 }
 
 /**

package/package.json

@@ -9,7 +9,7 @@
     "container",
     "provider"
   ],
-  "version": "1.1.0",
+  "version": "3.0.0",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -18,7 +18,7 @@
     "directory": "packages/di"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=24.0.0 <27"
   },
   "publishConfig": {
     "access": "public"
@@ -28,6 +28,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./internal": {
+      "types": "./dist/internal.d.ts",
+      "import": "./dist/internal.js"
     }
   },
   "main": "./dist/index.js",
@@ -36,15 +40,15 @@
     "dist"
   ],
   "dependencies": {
-    "@fluojs/core": "^1.0.3"
+    "@fluojs/core": "^2.0.0"
   },
   "devDependencies": {
-    "vitest": "^3.2.4"
+    "vitest": "^4.1.11"
   },
   "scripts": {
     "prebuild": "node ../../tooling/scripts/clean-dist.mjs",
     "build": "pnpm exec babel src --extensions .ts --ignore 'src/**/*.test.ts' --out-dir dist --config-file ../../tooling/babel/babel.config.cjs && pnpm exec tsc -p tsconfig.build.json",
-    "typecheck": "pnpm exec tsc -p tsconfig.json --noEmit",
+    "typecheck": "pnpm exec tsc -p tsconfig.typecheck.json --noEmit",
     "test": "pnpm exec vitest run -c vitest.config.ts",
     "test:watch": "pnpm exec vitest -c vitest.config.ts"
   }