@ai-matrx/content-ir-react 0.5.0 → 0.6.0

package/dist/index.d.ts

@@ -381,6 +381,18 @@ declare class ComponentResolver implements ComponentResolutionSource {
     subscribe(listener: () => void): () => void;
     private bumpKind;
     private notifyChanged;
+    /**
+     * A warm metadata shell is resolved enough for routing, but not for the
+     * host's db-component renderer. Its body must still come from the cold
+     * single-kind loader.
+     */
+    private needsColdFetch;
+    /**
+     * Cold rows are the authoritative heavy form of warm metadata shells. Keep
+     * the same first-row-per-key winner contract, but replace an existing shell
+     * so `componentSource` / `propsTransform` can land and repaint the kind.
+     */
+    private ingestColdRows;
     /**
      * The eager lightweight single-kind fetch (streaming path): the moment a
      * cloud kind is identified mid-stream, pull ONLY that kind's resolver rows
@@ -470,10 +482,16 @@ type GenericFallbackReason =
  | "generic-row"
 /**
  * The envelope carries a kind-preserved RAW: the payload identified a
- * registered kind but its value failed the schema (or the schema never
- * arrived before the region closed). The instance is BROKEN, not
- * component-less — the repair is fixing the payload/schema, and the generic
- * floor must acknowledge the kind and surface the recorded problems.
+ * registered kind and its value FAILED a check — a schema violation, an
+ * array-item kind mismatch, a duplicate key, a contradicted speculation.
+ * The instance is BROKEN, not component-less — the repair is fixing the
+ * payload or the schema, and the generic floor must acknowledge the kind and
+ * surface the recorded problems.
+ *
+ * NOT this: a kind whose schema was never available (`kindState:
+ * "unverified"`). Nothing checked that value, so calling it broken is a
+ * false accusation — it routes to its component. The two were one state
+ * until 2026-08-29 and conflating them was a platform-wide outage.
  */
  | "broken-instance"
 /**

package/dist/index.js

@@ -215,6 +215,35 @@ var ComponentResolver = class {
     this.version += 1;
     for (const listener of this.listeners) listener();
   }
+  /**
+   * A warm metadata shell is resolved enough for routing, but not for the
+   * host's db-component renderer. Its body must still come from the cold
+   * single-kind loader.
+   */
+  needsColdFetch(kind, platform, role) {
+    const resolution = this.resolve(kind, platform, role);
+    return resolution === null || resolution.resolvedBy === "db" && resolution.hasComponentSource && resolution.componentSource === null;
+  }
+  /**
+   * Cold rows are the authoritative heavy form of warm metadata shells. Keep
+   * the same first-row-per-key winner contract, but replace an existing shell
+   * so `componentSource` / `propsTransform` can land and repaint the kind.
+   */
+  ingestColdRows(rows) {
+    const winners = /* @__PURE__ */ new Map();
+    for (const row of rows) {
+      const key = keyOf(row.kind, row.platform, row.role);
+      if (!winners.has(key)) winners.set(key, row);
+    }
+    if (winners.size === 0) return;
+    const changedKinds = /* @__PURE__ */ new Set();
+    for (const [key, row] of winners) {
+      this.db.set(key, row);
+      changedKinds.add(row.kind);
+    }
+    for (const kind of changedKinds) this.bumpKind(kind);
+    this.notifyChanged();
+  }
   /**
    * The eager lightweight single-kind fetch (streaming path): the moment a
    * cloud kind is identified mid-stream, pull ONLY that kind's resolver rows
@@ -225,7 +254,7 @@ var ComponentResolver = class {
   requestComponent(kind, platform, role) {
     const loadForKind = this.options.loadForKind;
     if (!loadForKind) return;
-    if (this.resolve(kind, platform, role)) return;
+    if (!this.needsColdFetch(kind, platform, role)) return;
     const missKey = keyOf(kind, platform, role);
     const flightKey = `${kind}${KEY_SEPARATOR}${platform}`;
     if (this.coldInFlight.has(flightKey) || this.coldMisses.has(missKey)) {
@@ -234,8 +263,10 @@ var ComponentResolver = class {
     this.coldInFlight.add(flightKey);
     void (async () => {
       try {
-        this.ingestDbRows(await loadForKind(kind, platform));
-        if (!this.resolve(kind, platform, role)) this.coldMisses.add(missKey);
+        this.ingestColdRows(await loadForKind(kind, platform));
+        if (this.needsColdFetch(kind, platform, role)) {
+          this.coldMisses.add(missKey);
+        }
       } catch (error) {
         this.reportError({
           source: "content-ir",