@zudojs/container 0.1.0 → 1.1.0

package/dist/containerToken/containerToken.type.d.ts

@@ -2,8 +2,15 @@
  * Dependency injection token definitions for Zudojs.
  * Tokens identify dependencies within the container.
  */
+/**
+ * A class constructor usable as a token or provider implementation.
+ *
+ * The parameter list is intentionally loose (`any[]`) so classes with typed
+ * constructor parameters are accepted; the container supplies arguments via
+ * the provider's `inject` list (or none for zero-arg constructors).
+ */
 export interface Constructor<T = unknown> {
-    new (...args: unknown[]): T;
+    new (...args: any[]): T;
 }
 export type TokenSymbol = symbol;
 export type TokenString = string;
@@ -12,7 +19,25 @@ export interface InjectionToken<T = unknown> {
     readonly token: Token<T>;
     readonly description?: string;
 }
+/**
+ * Creates a unique, typed injection token backed by a fresh `Symbol`.
+ *
+ * Note on typing: plain string and symbol tokens are *untyped casts* — the
+ * container cannot verify at compile time that the value registered under a
+ * string/symbol actually has type `T`. Prefer `InjectionToken`s created here
+ * (or constructor tokens) so the association between token and type lives in
+ * one place.
+ */
 export declare function createToken<T>(description: string): InjectionToken<T>;
+/**
+ * Creates a typed injection token backed by `Symbol.for(key)`.
+ *
+ * Because `Symbol.for` uses the process-wide global symbol registry, two
+ * independent calls (even from different packages) with the same `key`
+ * produce the SAME token and will collide in the container — this is by
+ * design for cross-package sharing, but means keys must be namespaced
+ * (e.g. `"myapp:db"`). Use {@link createToken} for collision-free tokens.
+ */
 export declare function createGlobalToken<T>(key: string): InjectionToken<T>;
 export declare function unwrapToken<T>(token: Token<T> | InjectionToken<T>): Token<T>;
 export declare function isInjectionToken<T = unknown>(value: unknown): value is InjectionToken<T>;

package/dist/containerToken/containerToken.type.js

@@ -2,9 +2,27 @@
  * Dependency injection token definitions for Zudojs.
  * Tokens identify dependencies within the container.
  */
+/**
+ * Creates a unique, typed injection token backed by a fresh `Symbol`.
+ *
+ * Note on typing: plain string and symbol tokens are *untyped casts* — the
+ * container cannot verify at compile time that the value registered under a
+ * string/symbol actually has type `T`. Prefer `InjectionToken`s created here
+ * (or constructor tokens) so the association between token and type lives in
+ * one place.
+ */
 export function createToken(description) {
     return Object.freeze({ token: Symbol(description), description });
 }
+/**
+ * Creates a typed injection token backed by `Symbol.for(key)`.
+ *
+ * Because `Symbol.for` uses the process-wide global symbol registry, two
+ * independent calls (even from different packages) with the same `key`
+ * produce the SAME token and will collide in the container — this is by
+ * design for cross-package sharing, but means keys must be namespaced
+ * (e.g. `"myapp:db"`). Use {@link createToken} for collision-free tokens.
+ */
 export function createGlobalToken(key) {
     return Object.freeze({ token: Symbol.for(key), description: key });
 }

package/dist/index.d.ts

@@ -12,4 +12,5 @@ export * from "./containerRegistry/index.js";
 export * from "./containerResolution/index.js";
 export * from "./containerScope/index.js";
 export * from "./containerToken/index.js";
+export { CircularDependencyError, DuplicateRegistrationError, RegistrationNotFoundError, ProviderResolutionError, } from "@zudojs/errors";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -12,4 +12,7 @@ export * from "./containerRegistry/index.js";
 export * from "./containerResolution/index.js";
 export * from "./containerScope/index.js";
 export * from "./containerToken/index.js";
+// Error classes the container throws but that live in @zudojs/errors,
+// re-exported so `instanceof` checks need only this package.
+export { CircularDependencyError, DuplicateRegistrationError, RegistrationNotFoundError, ProviderResolutionError, } from "@zudojs/errors";
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zudojs/container",
-  "version": "0.1.0",
+  "version": "1.1.0",
   "description": "Token-based dependency injection container for managing application dependencies and service lifetimes.",
   "type": "module",
   "main": "./dist/index.js",
@@ -12,27 +12,29 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "!dist/**/*.map",
+    "!dist/**/*.tsbuildinfo",
+    "!dist/.tsbuildinfo"
   ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "clean": "tsc -p tsconfig.json --clean"
-  },
   "dependencies": {
-    "@zudojs/errors": "0.1.0"
+    "@zudojs/errors": "1.0.1"
   },
   "devDependencies": {
-    "typescript": "^7.0.2"
+    "typescript": "7.0.2",
+    "vitest": "^4.1.11"
   },
   "license": "MIT",
+  "author": {
+    "name": "Oluwayemi Oyinlola",
+    "url": "https://github.com/oyinlola-tech"
+  },
   "publishConfig": {
     "access": "public"
   },
   "engines": {
     "node": ">=24.0.0"
   },
-  "module": "./dist/index.js",
   "keywords": [
     "zudojs",
     "di",
@@ -40,8 +42,19 @@
     "container"
   ],
   "homepage": "https://github.com/oyinlola-tech/zudo#readme",
+  "bugs": {
+    "url": "https://github.com/oyinlola-tech/zudo/issues"
+  },
   "repository": {
     "type": "git",
-    "url": "https://github.com/oyinlola-tech/zudo"
+    "url": "https://github.com/oyinlola-tech/zudo",
+    "directory": "packages/container"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json --noEmit",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
-}
+}