@campfire-interactive/volume-intelligence-ui 0.4.0 → 0.5.0

package/dist/index.d.ts

@@ -258,6 +258,17 @@ interface ClearSourceDataResult {
     criteria: number;
     cleared: true;
 }
+/** Whether a source satisfies every required identity field. The dual-
+ *  satisfaction rule (explicit automotive_field mapping OR the covering
+ *  hierarchy level) is applied server-side, so the UI just renders this. */
+interface RequiredMappingStatus {
+    satisfied: boolean;
+    /** Required fields with neither an explicit mapping nor a covering level. */
+    missing: string[];
+    /** True only for wide base sources — the scope of the ingest/activation gate;
+     *  tall sources carry a minimal identity set and overlays inherit from base. */
+    enforced: boolean;
+}
 /**
  * Everything the source-management components need from the host. VI-webapp
  * implements these against its `adminApi`; OMSF implements them against proxy
@@ -296,6 +307,7 @@ interface SourceAdminTransport {
     setTenantSource(sourceId: string): Promise<TenantVolumeConfig>;
     listUploads(params?: UploadListParams): Promise<UploadListResponse>;
     clearSourceData(sourceId: string, confirm: string): Promise<ClearSourceDataResult>;
+    getRequiredMappingStatus?(sourceId: string): Promise<RequiredMappingStatus>;
 }
 
 interface VolumeFilesTransport {

package/dist/index.js

@@ -1731,6 +1731,18 @@ function VolumeSourceDetail({ transport, sourceId, onOpenSource, onBack, classNa
   const [mappingRows, setMappingRows] = useState7([]);
   const [savingMapping, setSavingMapping] = useState7(false);
   const [baseHierarchyHint, setBaseHierarchyHint] = useState7({});
+  const [requiredStatus, setRequiredStatus] = useState7(null);
+  async function loadRequiredStatus() {
+    if (!id || !transport.getRequiredMappingStatus) {
+      setRequiredStatus(null);
+      return;
+    }
+    try {
+      setRequiredStatus(await transport.getRequiredMappingStatus(id));
+    } catch {
+      setRequiredStatus(null);
+    }
+  }
   async function load() {
     if (!id) return;
     try {
@@ -1777,6 +1789,7 @@ function VolumeSourceDetail({ transport, sourceId, onOpenSource, onBack, classNa
       } else {
         setBaseHierarchyHint({});
       }
+      void loadRequiredStatus();
     } catch (e) {
       setError(e instanceof Error ? e.message : "Failed to load source");
     } finally {
@@ -1817,6 +1830,7 @@ function VolumeSourceDetail({ transport, sourceId, onOpenSource, onBack, classNa
       const hResp = await transport.replaceSegmentMappingCategory(id, "hierarchy_level", hierarchy);
       const aResp = await transport.replaceSegmentMappingCategory(id, "automotive_field", automotive);
       setMappingRows([...hResp.items, ...aResp.items]);
+      void loadRequiredStatus();
     } catch (e) {
       setError(e instanceof Error ? e.message : "Failed to save mapping");
     } finally {
@@ -2136,6 +2150,34 @@ function VolumeSourceDetail({ transport, sourceId, onOpenSource, onBack, classNa
           /* @__PURE__ */ jsx8("h2", { className: "cfi-vi-h2", children: "Segment Mapping" }),
           isOverlay && /* @__PURE__ */ jsx8("span", { className: "cfi-vi-muted", style: { fontSize: "var(--cfi-font-size-xs, 12px)" }, children: "\xB7 Map at least the levels your base source uses for the overlay merge to land." })
         ] }),
+        requiredStatus?.enforced && (requiredStatus.satisfied ? /* @__PURE__ */ jsxs8(
+          "div",
+          {
+            className: "cfi-vi-row",
+            style: { gap: 6, color: "#15803d", fontSize: "var(--cfi-font-size-sm, 13px)", margin: "4px 0 8px" },
+            children: [
+              /* @__PURE__ */ jsx8("span", { "aria-hidden": true, children: "\u2713" }),
+              " All required mappings are set \u2014 this source can be activated and ingested."
+            ]
+          }
+        ) : /* @__PURE__ */ jsxs8(
+          "div",
+          {
+            className: "cfi-vi-lock",
+            style: { display: "flex", alignItems: "flex-start", gap: 8, margin: "4px 0 8px" },
+            children: [
+              /* @__PURE__ */ jsx8(AlertTriangle3, { size: 14, "aria-hidden": true, style: { marginTop: 2, flexShrink: 0 } }),
+              /* @__PURE__ */ jsxs8("span", { children: [
+                "Missing required mapping",
+                requiredStatus.missing.length === 1 ? "" : "s",
+                ":",
+                " ",
+                requiredStatus.missing.map((m) => /* @__PURE__ */ jsx8("span", { className: "cfi-vi-mono", style: { marginRight: 6 }, children: m }, m)),
+                "\u2014 map these (directly, or via the covering hierarchy level) before this source can be activated or ingest."
+              ] })
+            ]
+          }
+        )),
         source.segments.length === 0 ? /* @__PURE__ */ jsx8("p", { className: "cfi-vi-muted", children: "No segments yet. Add segments on the Structure tab (Detect from file or Add manually) before mapping." }) : /* @__PURE__ */ jsx8(
           UnifiedSegmentMapper,
           {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@campfire-interactive/volume-intelligence-ui",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Shared Volume Intelligence UI components (volume import) for the Campfire Suite — embedded by the VI webapp and by consuming apps (OMSF) so there is one import surface, not two that drift.",
   "type": "module",
   "main": "dist/index.js",