@lmzhen/dsh-evolution-io 0.3.62 → 0.3.64

package/lib/index.js

@@ -8,6 +8,9 @@ var EvolutionIoRegistry = class extends Service {
 	providers = /* @__PURE__ */ new Map();
 	/** Name of the provider that declared itself the default (P2-7, v14). */
 	defaultName;
+	/** P2-3 (v15): per-name dispose — the idempotent re-registration returns
+	* the SAME function instance, so double-dispose is a single removal. */
+	disposals = /* @__PURE__ */ new Map();
 	constructor(ctx) {
 		super(ctx, "evolutionIo");
 	}
@@ -15,26 +18,39 @@ var EvolutionIoRegistry = class extends Service {
 	* @param options.default - mark this provider as the one a nameless
 	* `provider()` resolves. The first explicit default wins; without any
 	* default the registry keeps its historical registration-order fallback.
+	*
+	* P2-3 (v15): re-registering the IDENTICAL provider object is idempotent —
+	* it returns the original dispose and does not throw. This is what lets a
+	* backend (io-node) re-apply (HMR / re-mounted row) without the silent
+	* `hasProvider` early-return the v14 fix used, which had made the
+	* fail-loud-below unreachable for a FOREIGN provider under the same name.
+	* A different object under a registered name still throws.
 	*/
 	registerProvider(provider, options = {}) {
-		if (this.providers.has(provider.name)) throw new Error(`evolution IO provider "${provider.name}" already registered`);
-		this.providers.set(provider.name, provider);
-		if (options.default === true) this.defaultName ??= provider.name;
-		return () => {
-			if (this.providers.get(provider.name) === provider) {
-				this.providers.delete(provider.name);
-				if (this.defaultName === provider.name) this.defaultName = void 0;
-			}
+		const idempotent = this.providers.get(provider.name) === provider;
+		if (!idempotent && this.providers.has(provider.name)) throw new Error(`evolution IO provider "${provider.name}" already registered`);
+		if (options.default === true) {
+			if (this.defaultName !== void 0 && this.defaultName !== provider.name) this.ctx.logger.warn(`evolution IO provider "${provider.name}" declared itself the default, but "${this.defaultName}" already is — the first declaration wins`);
+			this.defaultName ??= provider.name;
+		}
+		if (idempotent) {
+			const existing = this.disposals.get(provider.name);
+			if (existing !== void 0) return existing;
+		}
+		const dispose = () => {
+			if (this.disposals.get(provider.name) !== dispose) return;
+			this.providers.delete(provider.name);
+			this.disposals.delete(provider.name);
+			if (this.defaultName === provider.name) this.defaultName = void 0;
 		};
+		this.providers.set(provider.name, provider);
+		this.disposals.set(provider.name, dispose);
+		return dispose;
 	}
 	/** Whether a provider with this exact name is mounted. */
 	hasProvider(name) {
 		return this.providers.has(name);
 	}
-	/** Whether ANY provider is mounted (used by lazy/boot-time probes). */
-	hasProviders() {
-		return this.providers.size > 0;
-	}
 	provider(name) {
 		if (name) {
 			const provider = this.providers.get(name);
@@ -42,7 +58,7 @@ var EvolutionIoRegistry = class extends Service {
 			throw new Error(`evolution IO provider "${name}" is not registered`);
 		}
 		const first = (this.defaultName === void 0 ? void 0 : this.providers.get(this.defaultName)) ?? this.providers.values().next().value;
-		if (!first) throw new Error("no evolution IO provider registered");
+		if (!first) throw new Error("no evolution IO provider registered — mount evolution-io-node (@lmzhen/dsh-evolution-io-node published, @lmzhen/dsh-evolution-io-node in the dev overlay; ships with evolution-host/evolution-all) and retry");
 		return first;
 	}
 };

package/lib/types/index.d.ts

@@ -30,19 +30,27 @@ export declare class EvolutionIoRegistry extends Service {
     private readonly providers;
     /** Name of the provider that declared itself the default (P2-7, v14). */
     private defaultName;
+    /** P2-3 (v15): per-name dispose — the idempotent re-registration returns
+     * the SAME function instance, so double-dispose is a single removal. */
+    private readonly disposals;
     constructor(ctx: Context);
     /**
      * @param options.default - mark this provider as the one a nameless
      * `provider()` resolves. The first explicit default wins; without any
      * default the registry keeps its historical registration-order fallback.
+     *
+     * P2-3 (v15): re-registering the IDENTICAL provider object is idempotent —
+     * it returns the original dispose and does not throw. This is what lets a
+     * backend (io-node) re-apply (HMR / re-mounted row) without the silent
+     * `hasProvider` early-return the v14 fix used, which had made the
+     * fail-loud-below unreachable for a FOREIGN provider under the same name.
+     * A different object under a registered name still throws.
      */
     registerProvider(provider: EvolutionIo, options?: {
         default?: boolean;
     }): () => void;
     /** Whether a provider with this exact name is mounted. */
     hasProvider(name: string): boolean;
-    /** Whether ANY provider is mounted (used by lazy/boot-time probes). */
-    hasProviders(): boolean;
     provider(name?: string): EvolutionIo;
 }
 export default EvolutionIoRegistry;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-io",
   "description": "IO seam for evolution providers (community build)",
-  "version": "0.3.62",
+  "version": "0.3.64",
   "publishConfig": {
     "access": "public"
   },
@@ -30,7 +30,7 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@lmzhen/dsh-evolution-core": "^0.3.62"
+    "@lmzhen/dsh-evolution-core": "^0.3.64"
   },
   "peerDependencies": {
     "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",