@azure-net/kit 6.0.0-next.8 → 6.0.0-next.9

package/README.md

@@ -342,8 +342,8 @@ URLs; external navigation should use browser location APIs.
 ## CompositionRoot
 
 `CreateServiceContainer` remains unchanged. `CompositionRoot` is a lazy class
-facade over it, with a unique internal container name. It can be created at module
-scope; `resolveContainer()` resolves against the current SSR request or browser
+facade over it, with a unique symbol as its internal container identity. It can be created at module
+scope; `resolve()` resolves against the current SSR request or browser
 cache, never a request captured by the constructor.
 
 ```ts
@@ -361,7 +361,7 @@ export const Identity = new CompositionRoot({
 });
 
 // Inside a presenter factory or an active request:
-const { Account } = Identity.resolveContainer();
+const { Account } = Identity.resolve();
 ```
 
 Dependencies accept both other `CompositionRoot` instances and existing
@@ -370,3 +370,6 @@ Only registration metadata is wrapped; there is no extra proxy around services
 and no new caching layer. Repeated resolution preserves existing container/service
 identity. If explicit cleanup is needed, use `await cleanupProvider(Identity.name)`.
 Declare roots once, rather than creating new roots per component render.
+`name` is now a symbol, not a serializable string. Its description is for diagnostics
+only; equal descriptions never share a cache. Existing string keys passed directly
+to `CreateServiceContainer` and `cleanupProvider` remain supported.

package/dist/shared/boundary-provider/CompositionRoot.d.ts

@@ -1,12 +1,12 @@
 import { type ProviderSettings, type ProviderWithType } from './Provider.js';
 type Services = Record<string, () => unknown>;
 type Dependency = ProviderWithType<Services> | {
-    readonly resolveContainer: ProviderWithType<Services>;
+    readonly resolve: ProviderWithType<Services>;
 };
 type Dependencies = Record<string, Dependency>;
 type Providers<D extends Dependencies> = {
     [K in keyof D]: D[K] extends {
-        readonly resolveContainer: infer P extends ProviderWithType<Services>;
+        readonly resolve: infer P extends ProviderWithType<Services>;
     } ? P : D[K] extends ProviderWithType<Services> ? D[K] : never;
 };
 export type CompositionRootSettings<T extends Services, D extends Dependencies = Record<never, never>> = Omit<ProviderSettings<T, Providers<D>>, 'dependsOn'> & {
@@ -14,8 +14,8 @@ export type CompositionRootSettings<T extends Services, D extends Dependencies =
 };
 /** Holds registration metadata only. Resolving always uses the current request's container. */
 export declare class CompositionRoot<T extends Services, D extends Dependencies = Record<never, never>> {
-    readonly name: string;
-    readonly resolveContainer: ProviderWithType<T>;
+    readonly name: symbol;
+    readonly resolve: ProviderWithType<T>;
     constructor(settings: CompositionRootSettings<T, D>);
 }
 export {};

package/dist/shared/boundary-provider/CompositionRoot.js

@@ -1,11 +1,11 @@
 import { CreateServiceContainer } from './Provider.js';
-const toProvider = (dependency) => typeof dependency === 'function' ? dependency : dependency.resolveContainer;
+const toProvider = (dependency) => typeof dependency === 'function' ? dependency : dependency.resolve;
 /** Holds registration metadata only. Resolving always uses the current request's container. */
 export class CompositionRoot {
-    name = `@azure-net/kit:CompositionRoot:${crypto.randomUUID()}`;
-    resolveContainer;
+    name = Symbol('@azure-net/kit:CompositionRoot');
+    resolve;
     constructor(settings) {
         const dependsOn = Object.fromEntries(Object.entries(settings.dependsOn ?? {}).map(([key, dependency]) => [key, toProvider(dependency)]));
-        this.resolveContainer = CreateServiceContainer(this.name, { ...settings, dependsOn });
+        this.resolve = CreateServiceContainer(this.name, { ...settings, dependsOn });
     }
 }

package/dist/shared/boundary-provider/Provider.d.ts

@@ -1,3 +1,4 @@
+export type ProviderKey = string | symbol;
 type ServiceFactory<T> = () => T;
 type ServiceMap = Record<string, ServiceFactory<unknown>>;
 type ResolvedServices<T extends ServiceMap> = {
@@ -16,6 +17,6 @@ export interface ProviderSettings<T extends ServiceMap, D extends Record<string,
     boot?: (services: ResolvedServices<T>) => undefined;
     register: ProviderFactory<T, D>;
 }
-export declare const CreateServiceContainer: <T extends ServiceMap, D extends Record<string, ProviderWithType<ServiceMap>>>(name: string, settings: ProviderSettings<T, D>) => ProviderWithType<T>;
-export declare function cleanupProvider(name: string): Promise<void>;
+export declare const CreateServiceContainer: <T extends ServiceMap, D extends Record<string, ProviderWithType<ServiceMap>>>(name: ProviderKey, settings: ProviderSettings<T, D>) => ProviderWithType<T>;
+export declare function cleanupProvider(name: ProviderKey): Promise<void>;
 export {};

package/dist/shared/boundary-provider/Provider.js

@@ -67,19 +67,20 @@ const getConstructionStack = () => {
     const context = RequestContext.current();
     return (getContextInternals(context).boundaryProviderConstructionStack ??= []);
 };
-const runWithCycleGuard = (key, callback) => {
+const runWithCycleGuard = (provider, member, callback) => {
     const stack = getConstructionStack();
-    if (stack.includes(key)) {
-        const cycleStart = stack.indexOf(key);
-        const cyclePath = [...stack.slice(cycleStart), key].join(' -> ');
+    const cycleStart = stack.findIndex((entry) => entry.provider === provider && entry.member === member);
+    const entry = { provider, member };
+    if (cycleStart !== -1) {
+        const cyclePath = [...stack.slice(cycleStart), entry].map(({ provider, member }) => `${String(provider)}.${member}`).join(' -> ');
         throw new AzureNetKitInternalError(`[BoundaryProvider] Circular provider dependency detected: ${cyclePath}`);
     }
-    stack.push(key);
+    stack.push(entry);
     try {
         return callback();
     }
     finally {
-        const idx = stack.lastIndexOf(key);
+        const idx = stack.lastIndexOf(entry);
         if (idx !== -1)
             stack.splice(idx, 1);
     }
@@ -109,7 +110,7 @@ export const CreateServiceContainer = (name, settings) => {
                     }
                 });
             }
-            factories = runWithCycleGuard(`${name}.register`, () => register(deps));
+            factories = runWithCycleGuard(name, 'register', () => register(deps));
             return factories;
         };
         const providerProxy = new Proxy({}, {
@@ -125,15 +126,15 @@ export const CreateServiceContainer = (name, settings) => {
                         return undefined;
                     if (Reflect.has(target, key))
                         return Reflect.get(target, key, receiver);
-                    throw new AzureNetKitInternalError(`[BoundaryProvider] Service '${key}' not found in provider '${name}'`);
+                    throw new AzureNetKitInternalError(`[BoundaryProvider] Service '${key}' not found in provider '${String(name)}'`);
                 }
                 const factory = factories[key];
                 if (typeof factory !== 'function') {
                     throw new AzureNetKitInternalError('[BoundaryProvider] Factory must be a function');
                 }
-                const instance = runWithCycleGuard(`${name}.${key}`, () => factory());
+                const instance = runWithCycleGuard(name, key, () => factory());
                 if (instance && typeof instance?.then === 'function') {
-                    throw new AzureNetKitInternalError(`[BoundaryProvider] Service '${key}' in provider '${name}' returned Promise.`);
+                    throw new AzureNetKitInternalError(`[BoundaryProvider] Service '${key}' in provider '${String(name)}' returned Promise.`);
                 }
                 cache.set(key, instance);
                 return instance;
@@ -172,7 +173,7 @@ export const CreateServiceContainer = (name, settings) => {
                 const bootResult = boot(providerProxy);
                 if (bootResult && typeof bootResult.then === 'function') {
                     void Promise.resolve(bootResult).catch(() => undefined);
-                    throw new AzureNetKitInternalError(`[BoundaryProvider] Boot for provider '${name}' must be synchronous.`);
+                    throw new AzureNetKitInternalError(`[BoundaryProvider] Boot for provider '${String(name)}' must be synchronous.`);
                 }
                 setBootFlag(name, true);
             }
@@ -192,10 +193,10 @@ export async function cleanupProvider(name) {
             if (service && typeof service === 'object' && 'dispose' in service) {
                 try {
                     const disposeResult = service.dispose();
-                    promises.push(Promise.resolve(disposeResult).catch((err) => console.error(`Error disposing ${name}.${key}:`, err)));
+                    promises.push(Promise.resolve(disposeResult).catch((err) => console.error(`Error disposing ${String(name)}.${key}:`, err)));
                 }
                 catch (err) {
-                    console.error(`Error disposing ${name}.${key}:`, err);
+                    console.error(`Error disposing ${String(name)}.${key}:`, err);
                 }
             }
         }

package/dist/shared/index.d.ts

@@ -1,7 +1,7 @@
 export { UniversalCookie, UniversalCookieInstance, UniversalNamedCookieInstance, type CookieOptions } from './cookie/index.js';
 export { BackgroundTask } from './background-task/index.js';
 export { ClassMirror } from './class-mirror/index.js';
-export { CreateServiceContainer, cleanupProvider, type ProviderSettings } from './boundary-provider/index.js';
+export { CreateServiceContainer, cleanupProvider, type ProviderSettings, type ProviderKey } from './boundary-provider/index.js';
 export { CompositionRoot, type CompositionRootSettings } from './boundary-provider/index.js';
 export * from './app/index.js';
 export { useLogger, LoggerErrors, type ILoggerError, type ILoggerSettings } from './logger/index.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@azure-net/kit",
-  "version": "6.0.0-next.8",
+  "version": "6.0.0-next.9",
   "license": "MIT",
   "author": "Pixel1917",
   "description": "Universal toolkit and library collection, developed as part of the Azure-net ecosystem",