@codefast/di 0.3.16-canary.2 → 0.4.0-canary.4

package/src/scope.ts

@@ -0,0 +1,77 @@
+import { MissingScopeContextError } from "#/errors";
+import type { BindingIdentifier } from "#/types";
+
+/**
+ * @since 0.3.16-canary.0
+ */
+export class ScopeManager {
+  // Singleton cache: bindingId -> instance
+  private readonly _singletons = new Map<BindingIdentifier, unknown>();
+  // In-flight promises for async singleton creation
+  private readonly _inflight = new Map<BindingIdentifier, Promise<unknown>>();
+  // Scoped cache (for child containers): bindingId -> instance
+  private readonly _scoped = new Map<BindingIdentifier, unknown>();
+
+  readonly isChild: boolean;
+
+  constructor(isChild = false) {
+    this.isChild = isChild;
+  }
+
+  hasSingleton(id: BindingIdentifier): boolean {
+    return this._singletons.has(id);
+  }
+
+  getSingleton<Value>(id: BindingIdentifier): Value {
+    return this._singletons.get(id) as Value;
+  }
+
+  setSingleton(id: BindingIdentifier, instance: unknown): void {
+    this._singletons.set(id, instance);
+  }
+
+  deleteSingleton(id: BindingIdentifier): boolean {
+    return this._singletons.delete(id);
+  }
+
+  getAllSingletons(): ReadonlyMap<BindingIdentifier, unknown> {
+    return this._singletons;
+  }
+
+  getInflight(id: BindingIdentifier): Promise<unknown> | undefined {
+    return this._inflight.get(id);
+  }
+
+  setInflight(id: BindingIdentifier, p: Promise<unknown>): void {
+    this._inflight.set(id, p);
+  }
+
+  clearInflight(id: BindingIdentifier): void {
+    this._inflight.delete(id);
+  }
+
+  hasScoped(id: BindingIdentifier): boolean {
+    return this._scoped.has(id);
+  }
+
+  getScoped<Value>(id: BindingIdentifier): Value {
+    return this._scoped.get(id) as Value;
+  }
+
+  setScoped(id: BindingIdentifier, instance: unknown): void {
+    if (!this.isChild) {
+      throw new MissingScopeContextError("(unknown)");
+    }
+    this._scoped.set(id, instance);
+  }
+
+  getAllScoped(): ReadonlyMap<BindingIdentifier, unknown> {
+    return this._scoped;
+  }
+
+  clearAll(): void {
+    this._singletons.clear();
+    this._inflight.clear();
+    this._scoped.clear();
+  }
+}

package/src/token.ts

@@ -0,0 +1,40 @@
+import type { Constructor } from "#/constructor-type";
+
+declare const TOKEN_BRAND: unique symbol;
+
+/**
+ * @since 0.3.16-canary.0
+ */
+export interface Token<Value> {
+  readonly name: string;
+  readonly [TOKEN_BRAND]: Value;
+}
+
+/**
+ * @since 0.3.16-canary.0
+ */
+export function token<Value>(name: string): Token<Value> {
+  return { name } as Token<Value>;
+}
+
+/**
+ * @since 0.3.16-canary.0
+ */
+export function tokenName(dependency: Token<unknown> | Constructor): string {
+  if (typeof dependency === "function") {
+    return dependency.name;
+  }
+  return dependency.name;
+}
+
+/**
+ * @since 0.3.16-canary.0
+ */
+export function isToken(value: unknown): value is Token<unknown> {
+  return (
+    typeof value === "object" &&
+    value !== null &&
+    "name" in value &&
+    typeof (value as Record<string, unknown>)["name"] === "string"
+  );
+}

package/src/types.ts

@@ -0,0 +1,123 @@
+import type { Constructor } from "#/constructor-type";
+import type { Token } from "#/token";
+
+// Re-export for consumers that import from `#/types`
+export type { Constructor } from "#/constructor-type";
+
+/**
+ * A single [tag, value] pair used in slot constraints and resolve hints.
+ *
+ * @since 0.3.16-canary.0
+ */
+export type BindingTag = readonly [tag: string, value: unknown];
+
+/**
+ * Token or class constructor used as a binding / injection / resolve key.
+ *
+ * @since 0.3.16-canary.0
+ */
+export type DependencyKey = Token<unknown> | Constructor;
+
+// ── BindingScope ────────────────────────────────────────────────────────────
+
+/**
+ * @since 0.3.16-canary.0
+ */
+export type BindingScope = "singleton" | "transient" | "scoped";
+
+// ── BindingIdentifier ────────────────────────────────────────────────────────
+
+declare const BINDING_ID_BRAND: unique symbol;
+/**
+ * @since 0.3.16-canary.0
+ */
+export type BindingIdentifier = string & { readonly [BINDING_ID_BRAND]: true };
+
+// ── BindingKind ───────────────────────────────────────────────────────────────
+
+/**
+ * @since 0.3.16-canary.0
+ */
+export type BindingKind = "class" | "dynamic" | "dynamic-async" | "resolved" | "resolved-async" | "constant" | "alias";
+
+// ── Handlers ─────────────────────────────────────────────────────────────────
+
+/**
+ * @since 0.3.16-canary.0
+ */
+export type ActivationHandler<Value> = (ctx: ResolutionContext, instance: Value) => Value | Promise<Value>;
+
+/**
+ * @since 0.3.16-canary.0
+ */
+export type DeactivationHandler<Value> = (instance: Value) => void | Promise<void>;
+
+// ── ResolveOptions ────────────────────────────────────────────────────────────
+
+/**
+ * @since 0.3.16-canary.0
+ */
+export interface ResolveOptions {
+  name?: string;
+  /**
+   * Single-tag shorthand — semantics match including one pair in `tags`.
+   * Enables fast-path lookup alongside `tags`.
+   */
+  tag?: BindingTag;
+  tags?: ReadonlyArray<BindingTag>;
+}
+
+// ── ResolutionFrame ──────────────────────────────────────────────────────
+
+/**
+ * @since 0.3.16-canary.0
+ */
+export interface ResolutionFrame {
+  readonly tokenName: string;
+  readonly scope: BindingScope;
+  readonly bindingId: BindingIdentifier;
+  readonly kind: BindingKind;
+  readonly slot: {
+    readonly name: string | undefined;
+    readonly tags: ReadonlyArray<BindingTag>;
+  };
+}
+
+// ── ConstraintContext ─────────────────────────────────────────────────────────
+
+/**
+ * @since 0.3.16-canary.0
+ */
+export interface ConstraintContext {
+  readonly resolutionPath: ReadonlyArray<string>;
+  readonly resolutionStack: ReadonlyArray<ResolutionFrame>;
+  readonly parent: ResolutionFrame | undefined;
+  readonly ancestors: ReadonlyArray<ResolutionFrame>;
+  readonly currentResolveHint: ResolveOptions | undefined;
+}
+
+// ── ResolutionContext ─────────────────────────────────────────────────────────
+
+/**
+ * @since 0.3.16-canary.0
+ */
+export interface ResolutionContext {
+  resolve<const Value>(token: Token<Value> | Constructor<Value>, hint?: ResolveOptions): Value;
+  resolveAsync<const Value>(token: Token<Value> | Constructor<Value>, hint?: ResolveOptions): Promise<Value>;
+  resolveOptional<const Value>(token: Token<Value> | Constructor<Value>, hint?: ResolveOptions): Value | undefined;
+  resolveOptionalAsync<const Value>(
+    token: Token<Value> | Constructor<Value>,
+    hint?: ResolveOptions,
+  ): Promise<Value | undefined>;
+  resolveAll<const Value>(token: Token<Value> | Constructor<Value>, hint?: ResolveOptions): Array<Value>;
+  resolveAllAsync<const Value>(token: Token<Value> | Constructor<Value>, hint?: ResolveOptions): Promise<Array<Value>>;
+  readonly graph: ConstraintContext;
+}
+
+// ── TokenValue ────────────────────────────────────────────────────────────────
+
+/**
+ * @since 0.3.16-canary.0
+ */
+export type TokenValue<Type> =
+  Type extends Token<infer Value> ? Value : Type extends Constructor<infer Value> ? Value : never;

package/dist/graph-adapters/types.d.mts

@@ -1,2 +0,0 @@
-import { ContainerGraphJson, GraphEdge, GraphNode, GraphOptions } from "../dependency-graph.mjs";
-export { type ContainerGraphJson, type GraphEdge, type GraphNode, type GraphOptions };

package/dist/graph-adapters/types.mjs

@@ -1 +0,0 @@
-export {};