@wyrly/core 1.0.0

package/esm/provider.js

@@ -0,0 +1,69 @@
+import { getInjectableMetadata } from "./metadata.js";
+import { graphNodeId, tokenLabel } from "./internal_keys.js";
+import { InvalidProviderError } from "./errors.js";
+export function normalizeProvider(token, provider) {
+    if ("useValue" in provider) {
+        const lt = provider.lifetime ?? "singleton";
+        if (lt !== "singleton") {
+            throw new InvalidProviderError("useValue lifetime must be singleton only.");
+        }
+        return {
+            token,
+            providerType: "value",
+            deps: [],
+            lifetime: "singleton",
+            displayName: tokenLabel(token),
+            useValue: provider.useValue,
+        };
+    }
+    if ("useFactory" in provider) {
+        const deps = provider.deps ?? [];
+        const lifetime = provider.lifetime ?? "singleton";
+        return {
+            token,
+            providerType: "factory",
+            deps,
+            lifetime,
+            displayName: tokenLabel(token),
+            useFactory: provider.useFactory,
+        };
+    }
+    if ("useExisting" in provider) {
+        const lifetime = provider.lifetime ?? "singleton";
+        return {
+            token,
+            providerType: "existing",
+            deps: [provider.useExisting],
+            lifetime,
+            displayName: tokenLabel(token),
+            useExisting: provider.useExisting,
+        };
+    }
+    if ("useClass" in provider) {
+        const meta = getInjectableMetadata(provider.useClass);
+        const deps = provider.deps ?? meta?.deps ?? [];
+        const lifetime = provider.lifetime ?? meta?.lifetime ?? "singleton";
+        return {
+            token,
+            providerType: "class",
+            deps,
+            lifetime,
+            displayName: graphNodeId(provider.useClass),
+            useClass: provider.useClass,
+        };
+    }
+    throw new InvalidProviderError("Unknown provider shape.");
+}
+export function syntheticClassProvider(token) {
+    const meta = getInjectableMetadata(token);
+    const deps = meta?.deps ?? [];
+    const lifetime = meta?.lifetime ?? "singleton";
+    return {
+        token,
+        providerType: "class",
+        deps,
+        lifetime,
+        displayName: graphNodeId(token),
+        useClass: token,
+    };
+}

package/esm/scope.d.ts

@@ -0,0 +1,10 @@
+import type { Provider } from "./provider.js";
+import type { InjectionToken } from "./token.js";
+export interface Scope {
+    resolve<T>(token: InjectionToken<T>): T;
+    register<T>(token: InjectionToken<T>, provider: Provider<T>): void;
+    set<T>(token: InjectionToken<T>, value: T): void;
+    dispose(): Promise<void>;
+    isDisposed(): boolean;
+}
+//# sourceMappingURL=scope.d.ts.map

package/esm/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../src/scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,KAAK;IACpB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACxC,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACnE,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACjD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,IAAI,OAAO,CAAC;CACvB"}

package/esm/scope.js

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

package/esm/token.d.ts

@@ -0,0 +1,12 @@
+/** Typed DI token (at runtime only `id` and `name` carry meaning) */
+export interface Token<T> {
+    readonly kind: "token";
+    readonly id: symbol;
+    readonly name: string;
+    readonly __type?: T;
+}
+/** Class constructor used as an injection token */
+export type ClassToken<T> = abstract new (...args: never[]) => T;
+export type InjectionToken<T> = Token<T> | ClassToken<T>;
+export declare function token<T>(name: string): Token<T>;
+//# sourceMappingURL=token.d.ts.map

package/esm/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../src/token.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,MAAM,WAAW,KAAK,CAAC,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;CACrB;AAED,mDAAmD;AACnD,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAEjE,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;AAEzD,wBAAgB,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAM/C"}

package/esm/token.js

@@ -0,0 +1,7 @@
+export function token(name) {
+    return {
+        kind: "token",
+        id: Symbol(name),
+        name,
+    };
+}

package/esm/types_decorator.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Minimal surface compatible with Deno / TypeScript ClassDecoratorContext.
+ * Defined locally so types work in environments without DOM in `lib`.
+ */
+export interface ClassDecoratorContext<T extends abstract new (...args: never[]) => unknown = abstract new (...args: never[]) => unknown> {
+    readonly kind: "class";
+    readonly name: string | undefined;
+    readonly metadata: unknown;
+    addInitializer(initializer: (this: T) => void): void;
+}
+//# sourceMappingURL=types_decorator.d.ts.map

package/esm/types_decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types_decorator.d.ts","sourceRoot":"","sources":["../src/types_decorator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,qBAAqB,CACpC,CAAC,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,GAAG,QAAQ,MAC7D,GAAG,IAAI,EAAE,KAAK,EAAE,KACb,OAAO;IAEZ,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;CACtD"}

package/esm/types_decorator.js

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

package/esm/validate.d.ts

@@ -0,0 +1,19 @@
+import type { NormalizedProvider } from "./provider.js";
+import { type Locale } from "./i18n.js";
+export interface ValidationIssue {
+    severity: "error" | "warning";
+    code: string;
+    message: string;
+}
+export interface ValidationResult {
+    ok: boolean;
+    issues: ValidationIssue[];
+}
+export interface ValidateOptions {
+    locale?: Locale;
+}
+/**
+ * Build a graph from registered providers and check cycles, lifetimes, and orphans.
+ */
+export declare function validateNormalizedProviders(providers: NormalizedProvider<unknown>[], options?: ValidateOptions): ValidationResult;
+//# sourceMappingURL=validate.d.ts.map

package/esm/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAIxD,OAAO,EACL,KAAK,MAAM,EAIZ,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAiDD;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,kBAAkB,CAAC,OAAO,CAAC,EAAE,EACxC,OAAO,CAAC,EAAE,eAAe,GACxB,gBAAgB,CAiGlB"}

package/esm/validate.js

@@ -0,0 +1,127 @@
+import { buildGraph } from "./graph.js";
+import { getInjectableMetadata } from "./metadata.js";
+import { graphNodeId } from "./internal_keys.js";
+import { resolveLocale, validationMessage, } from "./i18n.js";
+function providerMap(providers) {
+    const m = new Map();
+    for (const p of providers) {
+        m.set(graphNodeId(p.token), p);
+    }
+    return m;
+}
+function isResolvableDependency(dep, byKey) {
+    const id = graphNodeId(dep);
+    if (byKey.has(id))
+        return true;
+    if (typeof dep === "function" && getInjectableMetadata(dep))
+        return true;
+    return false;
+}
+function lifetimeForDepToken(dep, byKey) {
+    const id = graphNodeId(dep);
+    const hit = byKey.get(id);
+    if (hit)
+        return hit.lifetime;
+    if (typeof dep === "function") {
+        const meta = getInjectableMetadata(dep);
+        if (meta)
+            return meta.lifetime ?? "singleton";
+    }
+    return undefined;
+}
+function issue(severity, code, params, locale) {
+    return {
+        severity,
+        code,
+        message: validationMessage(code, params, locale),
+    };
+}
+/**
+ * Build a graph from registered providers and check cycles, lifetimes, and orphans.
+ */
+export function validateNormalizedProviders(providers, options) {
+    const locale = resolveLocale(options);
+    const issues = [];
+    const graph = buildGraph(providers);
+    const byId = providerMap(providers);
+    for (const p of providers) {
+        const fromLt = p.lifetime;
+        const fromId = graphNodeId(p.token);
+        for (const dep of p.deps) {
+            if (!isResolvableDependency(dep, byId)) {
+                issues.push(issue("error", "unresolved_dependency", {
+                    fromId,
+                    depId: graphNodeId(dep),
+                }, locale));
+                continue;
+            }
+            const toLt = lifetimeForDepToken(dep, byId);
+            if (toLt === undefined)
+                continue;
+            if (fromLt === "singleton" && toLt === "scoped") {
+                issues.push(issue("error", "singleton_depends_on_scoped", {
+                    fromId,
+                    depId: graphNodeId(dep),
+                }, locale));
+            }
+            if (fromLt === "transient" && toLt === "scoped") {
+                issues.push(issue("warning", "transient_depends_on_scoped", {
+                    fromId,
+                    depId: graphNodeId(dep),
+                }, locale));
+            }
+        }
+    }
+    const adj = new Map();
+    for (const e of graph.edges) {
+        if (!adj.has(e.from))
+            adj.set(e.from, []);
+        adj.get(e.from).push(e.to);
+    }
+    const visiting = new Set();
+    const visited = new Set();
+    const dfs = (id, stack) => {
+        if (visiting.has(id)) {
+            const idx = stack.indexOf(id);
+            return idx >= 0 ? [...stack.slice(idx), id] : [...stack, id];
+        }
+        if (visited.has(id))
+            return null;
+        visiting.add(id);
+        stack.push(id);
+        for (const to of adj.get(id) ?? []) {
+            const c = dfs(to, stack);
+            if (c)
+                return c;
+        }
+        stack.pop();
+        visiting.delete(id);
+        visited.add(id);
+        return null;
+    };
+    for (const n of graph.nodes) {
+        if (visited.has(n.id))
+            continue;
+        const cycle = dfs(n.id, []);
+        if (cycle && cycle.length > 0) {
+            issues.push(issue("error", "circular_dependency", {
+                fromId: "",
+                depId: "",
+                cycle: cycle.join(" -> "),
+            }, locale));
+            break;
+        }
+    }
+    const hasIncoming = new Set();
+    for (const e of graph.edges) {
+        hasIncoming.add(e.to);
+    }
+    for (const p of providers) {
+        const id = graphNodeId(p.token);
+        if (!hasIncoming.has(id)) {
+            issues.push(issue("warning", "unused_provider", { fromId: id, depId: "" }, locale));
+        }
+    }
+    const errors = issues.filter((i) => i.severity === "error");
+    return { ok: errors.length === 0, issues };
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@wyrly/core",
+  "version": "1.0.0",
+  "description": "Explicit DI for modern TypeScript (core)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wyrly/wyrly.git",
+    "directory": "oss/packages/core"
+  },
+  "license": "Apache-2.0",
+  "module": "./esm/mod.js",
+  "exports": {
+    ".": {
+      "import": "./esm/mod.js"
+    }
+  },
+  "scripts": {},
+  "sideEffects": false,
+  "dependencies": {
+    "@deno/shim-deno": "~0.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.9.0"
+  },
+  "_generatedBy": "dnt@dev"
+}