inwire 1.0.2 → 1.0.3

package/README.md

@@ -13,7 +13,7 @@ Zero-ceremony dependency injection for TypeScript. Full inference, no decorators
 ## Install
 
 ```bash
-npm/pnpm i inwire
+npm i inwire
 ```
 
 ## Quick Start

package/dist/index.d.mts

@@ -7,7 +7,7 @@
  * const factory: Factory<MyService> = (c) => new MyService(c.db);
  * ```
  */
-type Factory<T = any> = (container: any) => T;
+type Factory<T = unknown> = (container: any) => T;
 /**
  * An object of factory functions — the definition of a container.
  * Each key maps to a factory that produces the dependency.
@@ -53,11 +53,11 @@ interface ScopeOptions {
  * container.inspect(); // ContainerGraph
  * ```
  */
-type Container<T extends Record<string, any> = Record<string, any>> = T & IContainer<T>;
+type Container<T extends Record<string, unknown> = Record<string, unknown>> = T & IContainer<T>;
 /**
  * Container methods interface. Defines the API available on every container.
  */
-interface IContainer<T extends Record<string, any> = Record<string, any>> {
+interface IContainer<T extends Record<string, unknown> = Record<string, unknown>> {
   /**
    * Creates a child container with additional dependencies.
    * Child inherits all parent singletons and can add/override deps.
@@ -72,7 +72,7 @@ interface IContainer<T extends Record<string, any> = Record<string, any>> {
    * request.logger;    // inherited from parent
    * ```
    */
-  scope<E extends DepsDefinition>(extra: E, options?: ScopeOptions): Container<T & ResolvedDeps<E>>;
+  scope<E extends DepsDefinition>(extra: E, options?: ScopeOptions): Container<Omit<T, keyof ResolvedDeps<E>> & ResolvedDeps<E>>;
   /**
    * Returns a new container with additional dependencies.
    * Existing singletons are shared. The original container is not modified.
@@ -82,7 +82,7 @@ interface IContainer<T extends Record<string, any> = Record<string, any>> {
    * const appWithAuth = app.extend(authDeps);
    * ```
    */
-  extend<E extends DepsDefinition>(extra: E): Container<T & ResolvedDeps<E>>;
+  extend<E extends DepsDefinition>(extra: E): Container<Omit<T, keyof ResolvedDeps<E>> & ResolvedDeps<E>>;
   /**
    * Pre-resolves dependencies (warm-up).
    * Call with specific keys to resolve only those, or without arguments to resolve all.
@@ -176,7 +176,7 @@ interface ContainerHealth {
  * A warning detected by the container's runtime analysis.
  */
 interface ContainerWarning {
-  type: 'scope_mismatch' | 'duplicate_key';
+  type: 'scope_mismatch';
   message: string;
   details: Record<string, unknown>;
 }
@@ -215,7 +215,10 @@ declare abstract class ContainerError extends Error {
  */
 declare class ContainerConfigError extends ContainerError {
   readonly hint: string;
-  readonly details: Record<string, unknown>;
+  readonly details: {
+    key: string;
+    actualType: string;
+  };
   constructor(key: string, actualType: string);
 }
 /**
@@ -230,7 +233,10 @@ declare class ContainerConfigError extends ContainerError {
  */
 declare class ReservedKeyError extends ContainerError {
   readonly hint: string;
-  readonly details: Record<string, unknown>;
+  readonly details: {
+    key: string;
+    reserved: string[];
+  };
   constructor(key: string, reserved: readonly string[]);
 }
 /**
@@ -246,7 +252,12 @@ declare class ReservedKeyError extends ContainerError {
  */
 declare class ProviderNotFoundError extends ContainerError {
   readonly hint: string;
-  readonly details: Record<string, unknown>;
+  readonly details: {
+    key: string;
+    chain: string[];
+    registered: string[];
+    suggestion: string | undefined;
+  };
   constructor(key: string, chain: string[], registered: string[], suggestion?: string);
 }
 /**
@@ -260,7 +271,11 @@ declare class ProviderNotFoundError extends ContainerError {
  */
 declare class CircularDependencyError extends ContainerError {
   readonly hint: string;
-  readonly details: Record<string, unknown>;
+  readonly details: {
+    key: string;
+    chain: string[];
+    cycle: string;
+  };
   constructor(key: string, chain: string[]);
 }
 /**
@@ -275,7 +290,10 @@ declare class CircularDependencyError extends ContainerError {
  */
 declare class UndefinedReturnError extends ContainerError {
   readonly hint: string;
-  readonly details: Record<string, unknown>;
+  readonly details: {
+    key: string;
+    chain: string[];
+  };
   constructor(key: string, chain: string[]);
 }
 /**
@@ -290,7 +308,11 @@ declare class UndefinedReturnError extends ContainerError {
  */
 declare class FactoryError extends ContainerError {
   readonly hint: string;
-  readonly details: Record<string, unknown>;
+  readonly details: {
+    key: string;
+    chain: string[];
+    originalError: string;
+  };
   readonly originalError: unknown;
   constructor(key: string, chain: string[], originalError: unknown);
 }
@@ -307,7 +329,10 @@ declare class ScopeMismatchWarning implements ContainerWarning {
   readonly type: "scope_mismatch";
   readonly message: string;
   readonly hint: string;
-  readonly details: Record<string, unknown>;
+  readonly details: {
+    singleton: string;
+    transient: string;
+  };
   constructor(singletonKey: string, transientKey: string);
 }
 //#endregion

package/dist/index.mjs

@@ -1,4 +1,4 @@
-function e(e){return typeof e==`object`&&!!e&&`onInit`in e&&typeof e.onInit==`function`}function t(e){return typeof e==`object`&&!!e&&`onDestroy`in e&&typeof e.onDestroy==`function`}const n=[`scope`,`extend`,`preload`,`reset`,`inspect`,`describe`,`health`,`dispose`,`toString`];var r=class extends Error{constructor(e){super(e),this.name=this.constructor.name}},i=class extends r{hint;details;constructor(e,t){super(`'${e}' must be a factory function, got ${t}.`),this.hint=`Wrap it: ${e}: () => ${JSON.stringify(e===e?`<your ${t} value>`:e)}`,this.details={key:e,actualType:t}}},a=class extends r{hint;details;constructor(e,t){super(`'${e}' is a reserved container method.`),this.hint=`Rename this dependency, e.g. '${e}Service' or 'my${e[0].toUpperCase()}${e.slice(1)}'.`,this.details={key:e,reserved:[...t]}}},o=class extends r{hint;details;constructor(e,t,n,r){let i=t.length>0?`\n\nResolution chain: ${[...t,`${e} (not found)`].join(` -> `)}`:``,a=`\nRegistered keys: [${n.join(`, `)}]`,o=r?`\n\nDid you mean '${r}'?`:``;super(`Cannot resolve '${t[0]??e}': dependency '${e}' not found.${i}${a}${o}`),this.hint=r?`Did you mean '${r}'? Or add '${e}' to your container:\n  createContainer({\n    ...existing,\n    ${e}: (c) => new Your${e[0].toUpperCase()}${e.slice(1)}(/* deps */),\n  });`:`Add '${e}' to your container:\n  createContainer({\n    ...existing,\n    ${e}: (c) => new Your${e[0].toUpperCase()}${e.slice(1)}(/* deps */),\n  });`,this.details={key:e,chain:t,registered:n,suggestion:r}}},s=class extends r{hint;details;constructor(e,t){let n=[...t,e].join(` -> `);super(`Circular dependency detected while resolving '${t[0]}'.\n\nCycle: ${n}`),this.hint=[`To fix:`,`  1. Extract shared logic into a new dependency both can use`,`  2. Restructure so one doesn't depend on the other`,`  3. Use a mediator/event pattern to decouple them`].join(`
+function e(e){return typeof e==`object`&&!!e&&`onInit`in e&&typeof e.onInit==`function`}function t(e){return typeof e==`object`&&!!e&&`onDestroy`in e&&typeof e.onDestroy==`function`}const n=[`scope`,`extend`,`preload`,`reset`,`inspect`,`describe`,`health`,`dispose`,`toString`];var r=class extends Error{constructor(e){super(e),this.name=this.constructor.name}},i=class extends r{hint;details;constructor(e,t){super(`'${e}' must be a factory function, got ${t}.`),this.hint=`Wrap it: ${e}: () => <your ${t} value>`,this.details={key:e,actualType:t}}},a=class extends r{hint;details;constructor(e,t){super(`'${e}' is a reserved container method.`),this.hint=`Rename this dependency, e.g. '${e}Service' or 'my${e[0].toUpperCase()}${e.slice(1)}'.`,this.details={key:e,reserved:[...t]}}},o=class extends r{hint;details;constructor(e,t,n,r){let i=t.length>0?`\n\nResolution chain: ${[...t,`${e} (not found)`].join(` -> `)}`:``,a=`\nRegistered keys: [${n.join(`, `)}]`,o=r?`\n\nDid you mean '${r}'?`:``;super(`Cannot resolve '${t[0]??e}': dependency '${e}' not found.${i}${a}${o}`),this.hint=r?`Did you mean '${r}'? Or add '${e}' to your container:\n  createContainer({\n    ...existing,\n    ${e}: (c) => new Your${e[0].toUpperCase()}${e.slice(1)}(/* deps */),\n  });`:`Add '${e}' to your container:\n  createContainer({\n    ...existing,\n    ${e}: (c) => new Your${e[0].toUpperCase()}${e.slice(1)}(/* deps */),\n  });`,this.details={key:e,chain:t,registered:n,suggestion:r}}},s=class extends r{hint;details;constructor(e,t){let n=[...t,e].join(` -> `);super(`Circular dependency detected while resolving '${t[0]}'.\n\nCycle: ${n}`),this.hint=[`To fix:`,`  1. Extract shared logic into a new dependency both can use`,`  2. Restructure so one doesn't depend on the other`,`  3. Use a mediator/event pattern to decouple them`].join(`
 `),this.details={key:e,chain:t,cycle:n}}},c=class extends r{hint;details;constructor(e,t){let n=t.length>1?`\n\nResolution chain: ${t.join(` -> `)}`:``;super(`Factory '${e}' returned undefined.${n}`),this.hint=`Your factory function returned undefined. Did you forget a return statement?`,this.details={key:e,chain:t}}},l=class extends r{hint;details;originalError;constructor(e,t,n){let r=n instanceof Error?n.message:String(n),i=t.length>1?`\n\nResolution chain: ${[...t.slice(0,-1),`${e} (factory threw)`].join(` -> `)}`:``;super(`Factory '${e}' threw an error: "${r}"${i}`),this.hint=`Check the factory function for '${e}'. The error occurred during instantiation.`,this.details={key:e,chain:t,originalError:r},this.originalError=n}},u=class{type=`scope_mismatch`;message;hint;details;constructor(e,t){this.message=`Singleton '${e}' depends on transient '${t}'.`,this.hint=[`The transient value was resolved once and is now frozen inside the singleton.`,`This is almost always a bug.`,``,`To fix:`,`  1. Make '${e}' transient too: transient((c) => new ${e[0].toUpperCase()}${e.slice(1)}(c.${t}))`,`  2. Make '${t}' singleton if it doesn't need to change`,`  3. Inject a factory instead: ${t}Factory: () => () => <your value>`].join(`
 `),this.details={singleton:e,transient:t}}},d=class{validateConfig(e){for(let[t,r]of Object.entries(e)){if(n.includes(t))throw new a(t,n);if(typeof r!=`function`)throw new i(t,typeof r)}}suggestKey(e,t){let n,r=1/0;for(let i of t){let t=p(e,i);t<r&&(r=t,n=i)}if(!n)return;let i=Math.max(e.length,n.length);return 1-r/i>=.5?n:void 0}};function f(...e){let t=new Map,n=[];for(let r of e)for(let e of Object.keys(r)){let r=(t.get(e)??0)+1;t.set(e,r),r===2&&n.push(e)}return n}function p(e,t){let n=e.length,r=t.length;if(n===0)return r;if(r===0)return n;let i=Array(r+1),a=Array(r+1);for(let e=0;e<=r;e++)i[e]=e;for(let o=1;o<=n;o++){a[0]=o;for(let n=1;n<=r;n++){let r=e[o-1]===t[n-1]?0:1;a[n]=Math.min(i[n]+1,a[n-1]+1,i[n-1]+r)}[i,a]=[a,i]}return i[r]}const m=Symbol.for(`inwire:transient`);function h(e){let t=(t=>e(t));return t[m]=!0,t}function g(e){return typeof e==`function`&&m in e&&e[m]===!0}var _=class{factories;cache;resolving=new Set;depGraph=new Map;warnings=[];validator=new d;parent;name;constructor(e,t,n,r){this.factories=e,this.cache=t??new Map,this.parent=n,this.name=r}getName(){return this.name}resolve(t,n=[]){let r=this.factories.get(t);if(r&&!g(r)&&this.cache.has(t))return this.cache.get(t);if(!r){if(this.parent)return this.parent.resolve(t,n);let e=this.getAllRegisteredKeys();throw new o(t,n,e,this.validator.suggestKey(t,e))}if(this.resolving.has(t))throw new s(t,[...n]);this.resolving.add(t);let i=[...n,t];try{let n=[],a=r(this.createTrackingProxy(t,n,i));if(a===void 0)throw new c(t,i);if(this.depGraph.set(t,n),!g(r))for(let e of n){let n=this.getFactory(e);n&&g(n)&&this.warnings.push(new u(t,e))}if(g(r)||this.cache.set(t,a),e(a)){let e=a.onInit();e instanceof Promise&&e.catch(()=>{})}return a}catch(e){throw e instanceof s||e instanceof o||e instanceof c||e instanceof l?e:new l(t,i,e)}finally{this.resolving.delete(t)}}isResolved(e){return this.cache.has(e)}getDepGraph(){return new Map(this.depGraph)}getResolvedKeys(){return[...this.cache.keys()]}getFactories(){return this.factories}getCache(){return this.cache}getWarnings(){return[...this.warnings]}getAllRegisteredKeys(){let e=new Set(this.factories.keys());if(this.parent)for(let t of this.parent.getAllRegisteredKeys())e.add(t);return[...e]}createTrackingProxy(e,t,n){return new Proxy({},{get:(e,r)=>{if(typeof r==`symbol`)return;let i=r;return t.push(i),this.resolve(i,n)}})}getFactory(e){return this.factories.get(e)??this.parent?.getFactory(e)}},v=class{constructor(e){this.resolver=e}inspect(){let e={};for(let[t,n]of this.resolver.getFactories())e[t]={key:t,resolved:this.resolver.isResolved(t),deps:this.resolver.getDepGraph().get(t)??[],scope:g(n)?`transient`:`singleton`};let t=this.resolver.getName();return t?{name:t,providers:e}:{providers:e}}describe(e){let t=this.resolver.getFactories().get(e);return t?{key:e,resolved:this.resolver.isResolved(e),deps:this.resolver.getDepGraph().get(e)??[],scope:g(t)?`transient`:`singleton`}:{key:e,resolved:!1,deps:[],scope:`singleton`}}health(){let e=[...this.resolver.getFactories().keys()],t=this.resolver.getResolvedKeys(),n=new Set(t),r=this.resolver.getWarnings().map(e=>({type:e.type,message:e.message,details:e.details}));return{totalProviders:e.length,resolved:t,unresolved:e.filter(e=>!n.has(e)),warnings:r}}toString(){let e=[];for(let[t]of this.resolver.getFactories()){let n=this.resolver.isResolved(t),r=this.resolver.getDepGraph().get(t),i=r&&r.length>0?` -> [${r.join(`, `)}]`:``,a=n?`(resolved)`:`(pending)`;e.push(`${t}${i} ${a}`)}let t=this.resolver.getName();return`${t?`Scope(${t})`:`Container`} { ${e.join(`, `)} }`}};function y(e,t,n){let r=new Map;for(let[e,n]of Object.entries(t))r.set(e,n);return S(new _(r,new Map,e,n?.name))}const b=new d;function x(e){b.validateConfig(e);let t=new Map;for(let[n,r]of Object.entries(e))t.set(n,r);return S(new _(t))}function S(e){let n=new v(e),r={scope:(t,n)=>y(e,t,n),extend:t=>{b.validateConfig(t);let n=new Map(e.getFactories());for(let[e,r]of Object.entries(t))n.set(e,r);return S(new _(n,new Map(e.getCache())))},preload:async(...t)=>{let n=t.length>0?t:[...e.getFactories().keys()];for(let t of n)e.resolve(t)},reset:(...t)=>{let n=e.getCache();for(let e of t)n.delete(e)},inspect:()=>n.inspect(),describe:e=>n.describe(e),health:()=>n.health(),toString:()=>n.toString(),dispose:async()=>{let n=e.getCache(),r=[...n.entries()].reverse();for(let[,e]of r)t(e)&&await e.onDestroy();n.clear()}};return new Proxy({},{get(t,i){if(typeof i==`symbol`)return i===Symbol.toPrimitive||i===Symbol.toStringTag?()=>n.toString():void 0;let a=i;return a in r?r[a]:e.resolve(a)},has(t,n){if(typeof n==`symbol`)return!1;let i=n;return i in r||e.getFactories().has(i)||e.getAllRegisteredKeys().includes(i)},ownKeys(){return[...e.getAllRegisteredKeys(),...Object.keys(r)]},getOwnPropertyDescriptor(t,n){if(typeof n==`symbol`)return;let i=n;if(i in r||e.getFactories().has(i)||e.getAllRegisteredKeys().includes(i))return{configurable:!0,enumerable:!(i in r),writable:!1}}})}export{s as CircularDependencyError,i as ContainerConfigError,r as ContainerError,l as FactoryError,o as ProviderNotFoundError,a as ReservedKeyError,u as ScopeMismatchWarning,c as UndefinedReturnError,x as createContainer,f as detectDuplicateKeys,h as transient};
 //# sourceMappingURL=index.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "inwire",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Zero-ceremony dependency injection for TypeScript. Full inference, no decorators, no tokens. Built-in introspection for AI tooling.",
   "type": "module",
   "main": "./dist/index.mjs",