@decohere/crucible 0.0.1-dev.115 → 0.0.1-dev.116

package/README.md

@@ -1,14 +1,14 @@
 # @decohere/crucible
 
-Lightweight dependency injection for Decohere. Register classes (or tokens) on a `CrucibleBuilder`, `build()` a container, then `resolve()` graphs of constructor-injected services.
+Lightweight dependency injection for Decohere. Register classes (or tokens) on a `ServiceContainerBuilder`, `build()` a container, then `resolve()` graphs of constructor-injected services.
 
-Higher layers (for example Cortex `Builder.withServices`) register on a `CrucibleBuilder`. You can also build and resolve from a container yourself.
+Higher layers (for example `@decohere/http`'s `Builder.withServices`) register on a `ServiceContainerBuilder`. You can also build and resolve from a container yourself.
 
 ## When to use
 
-| Use Crucible | Do not use Crucible |
+| Use `@decohere/crucible` | Do not use it |
 |---|---|
-| Constructor-injected services and controllers | Replacing Cortex / Protocol / Codex — those compose *on top of* Crucible |
+| Constructor-injected services and controllers | Replacing the HTTP, config or data packages — those compose *on top of* the container |
 | Tokens for interfaces, config objects, and “many of this kind” | Auto-scanning folders or Nest-style modules (not in this package) |
 | Request / singleton / transient lifetimes and `using` disposal | Compile-time graph checking (the graph is checked when a service is first resolved) |
 
@@ -19,7 +19,7 @@ pnpm add @decohere/crucible
 ```
 
 ```ts
-import { CrucibleBuilder, LifetimeScopeToken, Scopes } from "@decohere/crucible";
+import { ServiceContainerBuilder, LifetimeScopeToken, Scopes } from "@decohere/crucible";
 import { inject, injectable } from "@decohere/crucible/decorators";
 ```
 
@@ -34,13 +34,13 @@ Decorator metadata is required. Enable it in `tsconfig.json` (the Decohere scaff
 }
 ```
 
-`@decohere/nexus/reflection` loads `reflect-metadata`. Import Crucible (or Nexus) before constructing decorated classes.
+`@decohere/core/reflection` loads `reflect-metadata`. Import `@decohere/crucible` (or `@decohere/core`) before constructing decorated classes.
 
 ---
 
 ## Constructor injection — `@inject` is usually unnecessary
 
-If the constructor parameter is a **concrete class**, Crucible reads `design:paramtypes` and resolves that class. Mark the *consumer* `@injectable()` so TypeScript/SWC emit that metadata. Do **not** add `@inject` for that parameter.
+If the constructor parameter is a **concrete class**, the container reads `design:paramtypes` and resolves that class. Mark the *consumer* `@injectable()` so TypeScript/SWC emit that metadata. Do **not** add `@inject` for that parameter.
 
 ```ts
 import { injectable } from "@decohere/crucible/decorators";
@@ -53,9 +53,9 @@ export class HelloController {
 ```
 
 ```ts
-import { CrucibleBuilder } from "@decohere/crucible";
+import { ServiceContainerBuilder } from "@decohere/crucible";
 
-const builder = new CrucibleBuilder();
+const builder = new ServiceContainerBuilder();
 builder.registerSingleton(SampleService);
 builder.registerRequestScoped(HelloController);
 const container = builder.build();
@@ -68,7 +68,7 @@ const hello = scope.resolve(HelloController);
 
 ### Do not `import type` injected classes
 
-`import type` is erased at compile time. `emitDecoratorMetadata` then records `Object` (or nothing) instead of the constructor. Crucible cannot tell what to inject and **throws `ResolveError`** when the consumer is resolved, naming the parameter and telling you to add `@inject`.
+`import type` is erased at compile time. `emitDecoratorMetadata` then records `Object` (or nothing) instead of the constructor. The container cannot tell what to inject and **throws `ResolveError`** when the consumer is resolved, naming the parameter and telling you to add `@inject`.
 
 ```ts
 // Wrong — SampleService does not exist at runtime, paramtypes collapse to Object
@@ -84,7 +84,7 @@ Linters that prefer type-only imports (`import type` / `import { type X }`) will
 
 ```ts
 // oxlint-disable-next-line typescript/consistent-type-imports -- constructor injection needs the class at runtime
-import { Workspace } from "@decohere/mesh";
+import { Workspace } from "@decohere/workspace";
 ```
 
 That pattern is used throughout Forge (`Build`, `Clean`, …). Same idea applies to ESLint `consistent-type-imports` or equivalent.
@@ -133,7 +133,7 @@ builder.registerSingleton(SampleStoreToken, store);
 
 ## Registration and lifetimes
 
-Keys match by **identity** ([ADR 0013](../../docs/adr/0013-crucible-keys-and-lifetimes.md)): a class matches only itself, a symbol only itself, a string only an equal string. So `resolve("SampleService")` does not find `registerSingleton(SampleService)`, `Symbol("TokenService")` does not collide with a class `TokenService`, two classes with the same name in different modules stay apart, and minified class names still work.
+Keys match by **identity** ([ADR 0013](../../docs/adr/0013-container-keys-and-lifetimes.md)): a class matches only itself, a symbol only itself, a string only an equal string. So `resolve("SampleService")` does not find `registerSingleton(SampleService)`, `Symbol("TokenService")` does not collide with a class `TokenService`, two classes with the same name in different modules stay apart, and minified class names still work.
 
 Registering the same class (or the same type on a token) twice **throws** `RegistrationError` — silent last-wins hides accidental double-registers. Replace it explicitly:
 
@@ -169,7 +169,7 @@ builder.registerTransient(Token, Helper);
 
 `registerType(type, scope?)` and `registerTypes(...)` are the same registrations without the lifetime in the method name (default **transient**). `Scopes.singleton` is the string `"single-instance"`.
 
-Cortex HTTP: controllers are **request-scoped** (one per request). Services are usually **singletons**.
+HTTP (`@decohere/http`): controllers are **request-scoped** (one per request). Services are usually **singletons**.
 
 `registerSingleton(Class, instance)` binds an existing object under the class. The CLI does this for the workspace:
 
@@ -226,7 +226,7 @@ await using scope = container.beginScope("req-2");
 - Disposing a parent does **not** dispose child scopes. Dispose the scope you created.
 - Singletons are cached on the root container and shared with nested scopes. Resolving a singleton after the root is disposed throws.
 
-Cortex `App.dispose` (Flux HMR / SIGINT) disposes the **root** container, then Scribe. Implement `Symbol.asyncDispose` (or `Symbol.dispose`) on long-lived services — sockets, pools, timers. Only **constructed** instances are disposed (resolve them at boot; transients are not cached). `export default app` is the composition-root contract; do not wrap it for extra teardown.
+`App.dispose` (`@decohere/http`) (Flux HMR / SIGINT) disposes the **root** container, then Scribe. Implement `Symbol.asyncDispose` (or `Symbol.dispose`) on long-lived services — sockets, pools, timers. Only **constructed** instances are disposed (resolve them at boot; transients are not cached). `export default app` is the composition-root contract; do not wrap it for extra teardown.
 
 The current scope is always registered as `LifetimeScopeToken`:
 
@@ -249,7 +249,7 @@ builder.registerRequestScoped("connection", () => createConnection());
 const connection = container.resolve("connection");
 ```
 
-Arrow factories are called as functions (not `new`). Use them when construction needs arguments Crucible should not know about.
+Arrow factories are called as functions (not `new`). Use them when construction needs arguments the container should not know about.
 
 ### Optional / missing dependencies
 
@@ -266,11 +266,11 @@ export class App {
 }
 ```
 
-### Cortex HTTP apps
+### HTTP apps
 
 ```ts
-import { Builder } from "@decohere/cortex";
-import { FastifyProvider } from "@decohere/cortex/providers";
+import { Builder } from "@decohere/http";
+import { FastifyProvider } from "@decohere/http/providers";
 import { SampleService } from "./services/sample.service.js";
 import { HelloController } from "./controllers/hello.controller.js";
 
@@ -287,10 +287,10 @@ await Builder.create()
 
 ### Tests
 
-Prefer constructing the subject with explicit fakes when you do not need the container. Use `CrucibleBuilder` when the test *is* the wiring (scopes, tokens, many-implementations).
+Prefer constructing the subject with explicit fakes when you do not need the container. Use `ServiceContainerBuilder` when the test *is* the wiring (scopes, tokens, many-implementations).
 
 ```ts
-const builder = new CrucibleBuilder();
+const builder = new ServiceContainerBuilder();
 builder.registerSingleton(SampleService, fakeSample);
 builder.registerRequestScoped(HelloController);
 const container = builder.build();
@@ -298,7 +298,7 @@ using scope = container.beginScope("test");
 const hello = scope.resolve(HelloController);
 ```
 
-To assert constructor arguments under DI, use `spyOnConstructor` from `@decohere/nexus/testing` — a bare `vi.spyOn` / `vi.fn` constructor drops `design:paramtypes`. See [Asserting DI constructor arguments](../../docs/testing/how-tos/vitest-constructor-spy-with-crucible-di.md).
+To assert constructor arguments under DI, use `spyOnConstructor` from `@decohere/core/testing` — a bare `vi.spyOn` / `vi.fn` constructor drops `design:paramtypes`. See [Asserting DI constructor arguments](../../docs/testing/how-tos/vitest-constructor-spy-with-di.md).
 
 ---
 
@@ -308,8 +308,8 @@ To assert constructor arguments under DI, use `spyOnConstructor` from `@decohere
 
 | Export | Role |
 |---|---|
-| `CrucibleBuilder` | Fluent registration; `build()` → `Crucible` |
-| `Crucible` | Container: `resolve`, `resolveMany`, `beginScope`, `Symbol.dispose` / `Symbol.asyncDispose` |
+| `ServiceContainerBuilder` | Fluent registration; `build()` → `Container` |
+| `Container` | The container: `resolve`, `resolveMany`, `beginScope`, `Symbol.dispose` / `Symbol.asyncDispose` |
 | `IContainer` / `LifetimeScope` / `ContainerBuilder` / `ServiceProvider` | Composition interfaces |
 | `Scopes` | `{ request, singleton: "single-instance", transient }` |
 | `LifetimeScopeToken` | Symbol for the current scope |
@@ -349,6 +349,6 @@ To assert constructor arguments under DI, use `spyOnConstructor` from `@decohere
 
 | Package | Role |
 |---|---|
-| [`@decohere/nexus`](../nexus) | Reflection helpers for `design:paramtypes` (`getMeta`, `isConstructable`, …) |
+| [`@decohere/core`](../core) | Reflection helpers for `design:paramtypes` (`getMeta`, `isConstructable`, …) |
 
 Layering: [architecture](../../docs/architecture/).

package/commonjs/src/const.js

@@ -9,8 +9,8 @@ function _export(target, all) {
     });
 }
 _export(exports, {
-    get CrucibleMeta () {
-        return CrucibleMeta;
+    get ContainerMeta () {
+        return ContainerMeta;
     },
     get LifetimeScopeToken () {
         return LifetimeScopeToken;
@@ -19,10 +19,10 @@ _export(exports, {
         return Scopes;
     }
 });
-const Crucible = "Crucible";
+const Container = "Container";
 const LifetimeScopeToken = Symbol("LifetimeScope");
-const CrucibleMeta = {
-    injecttoken: `${Crucible}:injecttoken`
+const ContainerMeta = {
+    injecttoken: `${Container}:injecttoken`
 };
 const Scopes = {
     request: "request",

package/commonjs/src/decorators/inject.decorator.js

@@ -16,7 +16,7 @@ _export(exports, {
         return optional;
     }
 });
-const _reflection = require("@decohere/nexus/reflection");
+const _reflection = require("@decohere/core/reflection");
 const _const = require("../const.js");
 function inject(key) {
     return updateToken((token)=>({
@@ -33,8 +33,8 @@ function optional() {
 function updateToken(update) {
     return (target, _propertyKey, idx)=>{
         // Copy: the metadata can be inherited from a base class, which must not change.
-        const metadata = new Map((0, _reflection.getMeta)(_const.CrucibleMeta.injecttoken, target));
+        const metadata = new Map((0, _reflection.getMeta)(_const.ContainerMeta.injecttoken, target));
         metadata.set(idx, update(metadata.get(idx)));
-        (0, _reflection.defineMeta)(_const.CrucibleMeta.injecttoken, metadata, target);
+        (0, _reflection.defineMeta)(_const.ContainerMeta.injecttoken, metadata, target);
     };
 }

package/commonjs/src/services/{crucible.js → container.js}

@@ -2,13 +2,13 @@
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
-Object.defineProperty(exports, "Crucible", {
+Object.defineProperty(exports, "Container", {
     enumerable: true,
     get: function() {
-        return Crucible;
+        return Container;
     }
 });
-const _reflection = require("@decohere/nexus/reflection");
+const _reflection = require("@decohere/core/reflection");
 const _const = require("../const.js");
 const _servicekey = require("../models/service-key.js");
 const _errors = require("../types/errors.js");
@@ -22,7 +22,7 @@ function describePath(path, last) {
         ]
     ].map(_servicekey.describeKey).join(" → ");
 }
-class Crucible {
+class Container {
     key;
     instances = new Map();
     serviceRegistry;
@@ -66,7 +66,7 @@ class Crucible {
         if (name != null && this.scopes.has(name)) {
             throw new _errors.DuplicateScopeError(`Cannot create duplicate scope. Scope with ${name} is already created and has not been disposed.`);
         }
-        const scope = new Crucible({
+        const scope = new Container({
             key: name,
             serviceRegistry: this.serviceRegistry,
             parent: this
@@ -181,7 +181,7 @@ class Crucible {
     }
     resolveDependencies(type, path) {
         const params = (0, _reflection.getMeta)(_reflection.ReflectionMeta.paramtypes, type) ?? [];
-        const injectTokens = (0, _reflection.getMeta)(_const.CrucibleMeta.injecttoken, type) ?? new Map();
+        const injectTokens = (0, _reflection.getMeta)(_const.ContainerMeta.injecttoken, type) ?? new Map();
         return params.map((param, index)=>{
             const token = injectTokens.get(index);
             const key = token?.key ?? param;

package/commonjs/src/services/index.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
-_export_star(require("./crucible.js"), exports);
-_export_star(require("./crucible-builder.js"), exports);
+_export_star(require("./container.js"), exports);
+_export_star(require("./service-container-builder.js"), exports);
 function _export_star(from, to) {
     Object.keys(from).forEach(function(k) {
         if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {

package/commonjs/src/services/{crucible-builder.js → service-container-builder.js}

@@ -2,16 +2,16 @@
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
-Object.defineProperty(exports, "CrucibleBuilder", {
+Object.defineProperty(exports, "ServiceContainerBuilder", {
     enumerable: true,
     get: function() {
-        return CrucibleBuilder;
+        return ServiceContainerBuilder;
     }
 });
 const _const = require("../const.js");
-const _crucible = require("./crucible.js");
+const _container = require("./container.js");
 const _serviceregistry = require("./service-registry.js");
-class CrucibleBuilder {
+class ServiceContainerBuilder {
     serviceRegistry;
     constructor(options){
         this.serviceRegistry = options?.serviceRegistry ?? new _serviceregistry.ServiceRegistry();
@@ -35,7 +35,7 @@ class CrucibleBuilder {
         return this.register(false)(_const.Scopes.request)(typeOrKey, type);
     }
     build() {
-        return new _crucible.Crucible({
+        return new _container.Container({
             serviceRegistry: this.serviceRegistry
         });
     }

package/es6/src/const.js

@@ -1,7 +1,7 @@
-const Crucible = "Crucible";
+const Container = "Container";
 export const LifetimeScopeToken = Symbol("LifetimeScope");
-export const CrucibleMeta = {
-    injecttoken: `${Crucible}:injecttoken`
+export const ContainerMeta = {
+    injecttoken: `${Container}:injecttoken`
 };
 export const Scopes = {
     request: "request",

package/es6/src/decorators/inject.decorator.js

@@ -1,5 +1,5 @@
-import { defineMeta, getMeta } from "@decohere/nexus/reflection";
-import { CrucibleMeta } from "../const.js";
+import { defineMeta, getMeta } from "@decohere/core/reflection";
+import { ContainerMeta } from "../const.js";
 /**
  * Bind a constructor parameter to a registration key. Keys match by identity: a class matches only
  * itself (not a string of its name), and a symbol only itself. Prefer the class; use a symbol for an
@@ -23,8 +23,8 @@ import { CrucibleMeta } from "../const.js";
 function updateToken(update) {
     return (target, _propertyKey, idx)=>{
         // Copy: the metadata can be inherited from a base class, which must not change.
-        const metadata = new Map(getMeta(CrucibleMeta.injecttoken, target));
+        const metadata = new Map(getMeta(ContainerMeta.injecttoken, target));
         metadata.set(idx, update(metadata.get(idx)));
-        defineMeta(CrucibleMeta.injecttoken, metadata, target);
+        defineMeta(ContainerMeta.injecttoken, metadata, target);
     };
 }

package/es6/src/services/{crucible.js → container.js}

@@ -1,5 +1,5 @@
-import { getMeta, isArrayType, isConstructable, ReflectionMeta } from "@decohere/nexus/reflection";
-import { CrucibleMeta, LifetimeScopeToken, Scopes } from "../const.js";
+import { getMeta, isArrayType, isConstructable, ReflectionMeta } from "@decohere/core/reflection";
+import { ContainerMeta, LifetimeScopeToken, Scopes } from "../const.js";
 import { describeKey } from "../models/service-key.js";
 import { DuplicateScopeError, ResolveError } from "../types/errors.js";
 import { ServiceRegistry } from "./service-registry.js";
@@ -12,7 +12,7 @@ function describePath(path, last) {
         ]
     ].map(describeKey).join(" → ");
 }
-export class Crucible {
+export class Container {
     key;
     instances = new Map();
     serviceRegistry;
@@ -56,7 +56,7 @@ export class Crucible {
         if (name != null && this.scopes.has(name)) {
             throw new DuplicateScopeError(`Cannot create duplicate scope. Scope with ${name} is already created and has not been disposed.`);
         }
-        const scope = new Crucible({
+        const scope = new Container({
             key: name,
             serviceRegistry: this.serviceRegistry,
             parent: this
@@ -171,7 +171,7 @@ export class Crucible {
     }
     resolveDependencies(type, path) {
         const params = getMeta(ReflectionMeta.paramtypes, type) ?? [];
-        const injectTokens = getMeta(CrucibleMeta.injecttoken, type) ?? new Map();
+        const injectTokens = getMeta(ContainerMeta.injecttoken, type) ?? new Map();
         return params.map((param, index)=>{
             const token = injectTokens.get(index);
             const key = token?.key ?? param;

package/es6/src/services/index.js

@@ -1,2 +1,2 @@
-export * from "./crucible.js";
-export * from "./crucible-builder.js";
+export * from "./container.js";
+export * from "./service-container-builder.js";

package/es6/src/services/{crucible-builder.js → service-container-builder.js}

@@ -1,7 +1,7 @@
 import { Scopes } from "../const.js";
-import { Crucible } from "./crucible.js";
+import { Container } from "./container.js";
 import { ServiceRegistry } from "./service-registry.js";
-export class CrucibleBuilder {
+export class ServiceContainerBuilder {
     serviceRegistry;
     constructor(options){
         this.serviceRegistry = options?.serviceRegistry ?? new ServiceRegistry();
@@ -25,7 +25,7 @@ export class CrucibleBuilder {
         return this.register(false)(Scopes.request)(typeOrKey, type);
     }
     build() {
-        return new Crucible({
+        return new Container({
             serviceRegistry: this.serviceRegistry
         });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decohere/crucible",
-  "version": "0.0.1-dev.115",
+  "version": "0.0.1-dev.116",
   "description": "Lightweight dependency injection container with decorator-based wiring",
   "keywords": [
     "typescript",
@@ -30,7 +30,7 @@
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "dependencies": {
-    "@decohere/nexus": "0.0.1-dev.115"
+    "@decohere/core": "0.0.1-dev.116"
   },
   "devDependencies": {}
 }

package/types/src/const.d.ts

@@ -1,5 +1,5 @@
 export declare const LifetimeScopeToken: unique symbol;
-export declare const CrucibleMeta: {
+export declare const ContainerMeta: {
     injecttoken: string;
 };
 export declare const Scopes: {

package/types/src/models/service-key.d.ts

@@ -1,4 +1,4 @@
-import type { Constructable, FunctionType } from "@decohere/nexus/reflection";
+import type { Constructable, FunctionType } from "@decohere/core/reflection";
 /**
  * What a service is registered and resolved under, compared by identity: the class (or factory)
  * itself, a symbol, or a string. A string never matches a class with that name, and two symbols

package/types/src/models/service-registration.model.d.ts

@@ -1,4 +1,4 @@
-import type { Constructable, FunctionType } from "@decohere/nexus/reflection";
+import type { Constructable, FunctionType } from "@decohere/core/reflection";
 import type { Scope } from "../types/types.js";
 import type { ServiceKey } from "./service-key.js";
 export declare class ServiceRegistration {

package/types/src/services/{crucible.d.ts → container.d.ts}

@@ -2,10 +2,10 @@ import type { IContainer, ResolveRequest } from "../types/types.js";
 import { ServiceRegistry } from "./service-registry.js";
 type CrucibleOptions = {
     key?: string;
-    parent?: Crucible;
+    parent?: Container;
     serviceRegistry: ServiceRegistry;
 };
-export declare class Crucible implements IContainer {
+export declare class Container implements IContainer {
     key: string;
     protected instances: Map<unknown, object>;
     private serviceRegistry;
@@ -19,7 +19,7 @@ export declare class Crucible implements IContainer {
     resolve<T extends object | object[]>(resolveRequest: ResolveRequest<T>): T;
     private resolveAll;
     private resolveOne;
-    beginScope(name?: string): Crucible;
+    beginScope(name?: string): Container;
     [Symbol.dispose](): void;
     [Symbol.asyncDispose](): Promise<void>;
     private disposeSync;

package/types/src/services/index.d.ts

@@ -1,2 +1,2 @@
-export * from "./crucible.js";
-export * from "./crucible-builder.js";
+export * from "./container.js";
+export * from "./service-container-builder.js";

package/types/src/services/{crucible-builder.d.ts → service-container-builder.d.ts}

@@ -1,12 +1,12 @@
-import type { Constructable, FunctionType } from "@decohere/nexus/reflection";
+import type { Constructable, FunctionType } from "@decohere/core/reflection";
 import type { ServiceRegistration } from "../models/service-registration.model.js";
 import type { ContainerBuilder, ContainerRegistrar, Scope } from "../types/types.js";
-import { Crucible } from "./crucible.js";
+import { Container } from "./container.js";
 import { ServiceRegistry } from "./service-registry.js";
 type ContainerBuilderOptions = {
     serviceRegistry: ServiceRegistry;
 };
-export declare class CrucibleBuilder implements ContainerBuilder {
+export declare class ServiceContainerBuilder implements ContainerBuilder {
     private serviceRegistry;
     constructor(options?: ContainerBuilderOptions);
     get override(): ContainerRegistrar;
@@ -22,7 +22,7 @@ export declare class CrucibleBuilder implements ContainerBuilder {
     registerRequestScoped<T>(key: string | symbol, type: () => T): ServiceRegistration;
     registerRequestScoped(key: string | symbol, type: Constructable): ServiceRegistration;
     registerRequestScoped(type: Constructable): ServiceRegistration;
-    build(): Crucible;
+    build(): Container;
     private register;
     private registerMany;
     private createRegistrar;

package/types/src/services/service-registry.d.ts

@@ -1,4 +1,4 @@
-import type { Constructable, FunctionType } from "@decohere/nexus/reflection";
+import type { Constructable, FunctionType } from "@decohere/core/reflection";
 import { type ServiceKey } from "../models/service-key.js";
 import { ServiceRegistration } from "../models/service-registration.model.js";
 import type { Scope } from "../types/types.js";

package/types/src/types/types.d.ts

@@ -1 +1 @@
-export type { ContainerBuilder, ContainerRegistrar, IContainer, LifetimeScope, ResolveRequest, Scope, ServiceProvider, } from "@decohere/nexus/composition";
+export type { ContainerBuilder, ContainerRegistrar, IContainer, LifetimeScope, ResolveRequest, Scope, ServiceProvider, } from "@decohere/core/composition";