@lmzhen/dsh-evolution-io 0.26.15 → 0.27.0

package/lib/index.js

@@ -58,28 +58,39 @@ var EvolutionIoRegistry = class extends Service {
 		return first;
 	}
 };
+const mediumObservations = /* @__PURE__ */ new WeakMap();
 /**
-* Resolve the seam implementation for a consumer, preferring a backend the deployment mounted.
-*
-* Contract C2 (declared gaps) has no other shape: a consumer that can work on either medium asks for
-* its preference and the DEPLOYMENT decides which backends exist. The lookup is contained here because
-* the registry deliberately has no presence probe (v20 A-3 removed `hasProvider`; a presence probe goes
-* through `provider(name)`, which fails loud) — so this function is the ONE sanctioned place that turns
-* that failure into a fallback. A caller that needs a SPECIFIC backend must call `provider(name)` and
-* take the error.
-* @param registry - the seam registry (`ctx.evolutionIo`).
-* @param names - preferred provider names, most preferred first.
-* @returns the first registered preference, else the registry default.
-*/
-/**
-* @typeParam T - the seam implementation type the caller works with (`EvolutionIo` or the wider
-*   `EvolutionIoLike`), so the same helper serves every consumer shape.
+* The read-only face of the marker: what served THIS registry, without resolving anything.
+* @param registry - the seam registry the caller already holds.
+* @returns `known` with the observation, or `unknown` when nothing resolved through this registry yet.
 */
+function describeMedium(registry) {
+	const observation = mediumObservations.get(registry);
+	if (observation === void 0) return { state: "unknown" };
+	return {
+		state: "known",
+		requested: observation.requested,
+		resolved: observation.resolved,
+		via: observation.via
+	};
+}
 function preferProvider(registry, names) {
 	for (const name of names) try {
-		return registry.provider(name);
+		const resolved = registry.provider(name);
+		mediumObservations.set(registry, {
+			requested: names,
+			resolved: name,
+			via: "preference"
+		});
+		return resolved;
 	} catch {}
-	return registry.provider();
+	const fallback = registry.provider();
+	mediumObservations.set(registry, {
+		requested: names,
+		resolved: void 0,
+		via: "default"
+	});
+	return fallback;
 }
 //#endregion
-export { EvolutionIoRegistry, EvolutionIoRegistry as default, preferProvider };
+export { EvolutionIoRegistry, EvolutionIoRegistry as default, describeMedium, preferProvider };

package/lib/types/index.d.ts

@@ -52,22 +52,18 @@ export declare class EvolutionIoRegistry extends Service {
     provider(name?: string): EvolutionIo;
 }
 /**
- * Resolve the seam implementation for a consumer, preferring a backend the deployment mounted.
- *
- * Contract C2 (declared gaps) has no other shape: a consumer that can work on either medium asks for
- * its preference and the DEPLOYMENT decides which backends exist. The lookup is contained here because
- * the registry deliberately has no presence probe (v20 A-3 removed `hasProvider`; a presence probe goes
- * through `provider(name)`, which fails loud) — so this function is the ONE sanctioned place that turns
- * that failure into a fallback. A caller that needs a SPECIFIC backend must call `provider(name)` and
- * take the error.
- * @param registry - the seam registry (`ctx.evolutionIo`).
- * @param names - preferred provider names, most preferred first.
- * @returns the first registered preference, else the registry default.
- */
-/**
- * @typeParam T - the seam implementation type the caller works with (`EvolutionIo` or the wider
- *   `EvolutionIoLike`), so the same helper serves every consumer shape.
+ * The read-only face of the marker: what served THIS registry, without resolving anything.
+ * @param registry - the seam registry the caller already holds.
+ * @returns `known` with the observation, or `unknown` when nothing resolved through this registry yet.
  */
+export declare function describeMedium(registry: object): {
+    readonly state: 'known';
+    readonly requested: readonly string[];
+    readonly resolved: string | undefined;
+    readonly via: string;
+} | {
+    readonly state: 'unknown';
+};
 export declare function preferProvider<T>(registry: {
     provider(name?: string): T;
 }, names: readonly string[]): T;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-io",
   "description": "IO seam for evolution providers (community build)",
-  "version": "0.26.15",
+  "version": "0.27.0",
   "publishConfig": {
     "access": "public"
   },
@@ -26,9 +26,12 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@lmzhen/dsh-evolution-core": "^0.26.15"
+    "@lmzhen/dsh-evolution-core": "^0.27.0"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1"
+    "@deepseek-ai/cordis": "^4.0.5"
+  },
+  "engines": {
+    "dsh": ">=0.2.1-rc.1 <0.2.2-0"
   }
 }