@calimero-network/mero-react 2.4.0 → 2.6.0

package/dist/index.cjs

@@ -2294,6 +2294,313 @@ function useDetachContextFromGroup() {
   );
   return { detachContextFromGroup, loading, error };
 }
+function useMigrationStatus(namespaceId, options) {
+  const { mero } = useMero();
+  const [status, setStatus] = react.useState(null);
+  const [loading, setLoading] = react.useState(false);
+  const [error, setError] = react.useState(null);
+  const mountedRef = useMountedRef();
+  const reqRef = react.useRef(0);
+  const refetch = react.useCallback(async () => {
+    if (!mero || !namespaceId) {
+      if (mountedRef.current) {
+        setStatus(null);
+        setError(null);
+        setLoading(false);
+      }
+      return;
+    }
+    const seq = ++reqRef.current;
+    if (mountedRef.current) {
+      setLoading(true);
+      setError(null);
+    }
+    try {
+      const result = await mero.admin.getMigrationStatus(namespaceId);
+      if (mountedRef.current && seq === reqRef.current) {
+        setStatus(result);
+      }
+    } catch (err) {
+      const errorValue = toError(err);
+      if (mountedRef.current && seq === reqRef.current) {
+        setError(errorValue);
+      }
+    } finally {
+      if (mountedRef.current && seq === reqRef.current) {
+        setLoading(false);
+      }
+    }
+  }, [namespaceId, mero, mountedRef]);
+  react.useEffect(() => {
+    setStatus(null);
+    setError(null);
+  }, [namespaceId]);
+  react.useEffect(() => {
+    void refetch();
+  }, [refetch]);
+  const pollIntervalMs = options?.pollIntervalMs;
+  react.useEffect(() => {
+    if (!pollIntervalMs || !mero || !namespaceId) return;
+    const handle = setInterval(() => void refetch(), pollIntervalMs);
+    return () => clearInterval(handle);
+  }, [pollIntervalMs, mero, namespaceId, refetch]);
+  const rollup = status?.rollup ?? null;
+  const members = status?.members ?? [];
+  return {
+    status,
+    rollup,
+    members,
+    allMigrated: rollup?.allMigrated ?? false,
+    membersPendingSignature: rollup?.membersPendingSignature ?? 0,
+    /** Members whose migrate aborted (migration-check failed or apply errored). */
+    failed: rollup?.failed ?? 0,
+    loading,
+    error,
+    refetch
+  };
+}
+function useAppVersion(contextId, expected) {
+  const { mero } = useMero();
+  const [appVersion, setAppVersion] = react.useState(void 0);
+  const [loading, setLoading] = react.useState(false);
+  const [error, setError] = react.useState(null);
+  const mountedRef = useMountedRef();
+  const reqRef = react.useRef(0);
+  const refetch = react.useCallback(async () => {
+    if (!mero || !contextId) {
+      if (mountedRef.current) {
+        setAppVersion(void 0);
+        setError(null);
+        setLoading(false);
+      }
+      return;
+    }
+    const seq = ++reqRef.current;
+    if (mountedRef.current) {
+      setLoading(true);
+      setError(null);
+    }
+    try {
+      const context = await mero.admin.getContext(contextId);
+      if (mountedRef.current && seq === reqRef.current) {
+        setAppVersion(context.applicationVersion);
+      }
+    } catch (err) {
+      const errorValue = toError(err);
+      if (mountedRef.current && seq === reqRef.current) {
+        setError(errorValue);
+      }
+    } finally {
+      if (mountedRef.current && seq === reqRef.current) {
+        setLoading(false);
+      }
+    }
+  }, [contextId, mero, mountedRef]);
+  react.useEffect(() => {
+    setAppVersion(void 0);
+    setError(null);
+  }, [contextId]);
+  react.useEffect(() => {
+    void refetch();
+  }, [refetch]);
+  react.useEffect(() => {
+    if (!mero?.events || !contextId) return;
+    const off = mero.events.onAppVersionChanged((event) => {
+      if (event.contextId !== contextId) return;
+      if (mountedRef.current && event.toVersion) {
+        reqRef.current += 1;
+        setAppVersion(event.toVersion);
+      }
+    });
+    return off;
+  }, [mero, contextId, mountedRef]);
+  const isStale = appVersion != null && expected != null && appVersion !== expected;
+  return { appVersion, expected, isStale, loading, error, refetch };
+}
+function useLatestVersion(registryUrl, packageName, currentVersion) {
+  const { mero } = useMero();
+  const [versions, setVersions] = react.useState([]);
+  const [loading, setLoading] = react.useState(false);
+  const [error, setError] = react.useState(null);
+  const mountedRef = useMountedRef();
+  const reqRef = react.useRef(0);
+  const refetch = react.useCallback(async () => {
+    if (!mero || !registryUrl || !packageName) {
+      reqRef.current += 1;
+      if (mountedRef.current) {
+        setVersions([]);
+        setError(null);
+        setLoading(false);
+      }
+      return;
+    }
+    const seq = ++reqRef.current;
+    if (mountedRef.current) {
+      setLoading(true);
+      setError(null);
+    }
+    try {
+      const result = await mero.admin.getRegistryVersions(registryUrl, packageName);
+      if (mountedRef.current && seq === reqRef.current) {
+        setVersions(result);
+      }
+    } catch (err) {
+      const errorValue = toError(err);
+      if (mountedRef.current && seq === reqRef.current) {
+        setError(errorValue);
+      }
+    } finally {
+      if (mountedRef.current && seq === reqRef.current) {
+        setLoading(false);
+      }
+    }
+  }, [mero, registryUrl, packageName, mountedRef]);
+  react.useEffect(() => {
+    setVersions([]);
+    setError(null);
+  }, [registryUrl, packageName]);
+  react.useEffect(() => {
+    void refetch();
+  }, [refetch]);
+  const latestVersion = versions[0] ?? null;
+  const updateAvailable = latestVersion != null && currentVersion != null && meroJs.compareSemver(latestVersion, currentVersion) > 0;
+  return { versions, latestVersion, currentVersion, updateAvailable, loading, error, refetch };
+}
+function useMyAuthoredMigration(contextId) {
+  const { mero } = useMero();
+  const [summary, setSummary] = react.useState(null);
+  const [pendingCount, setPendingCount] = react.useState(0);
+  const mountedRef = useMountedRef();
+  const { loading, error, run } = useAsyncMutation();
+  const reqRef = react.useRef(0);
+  const refresh = react.useCallback(async () => {
+    if (!mero || !contextId) {
+      if (mountedRef.current) setPendingCount(0);
+      return;
+    }
+    const seq = ++reqRef.current;
+    try {
+      const count = await mero.rpc.countMyPending(contextId);
+      if (mountedRef.current && seq === reqRef.current) setPendingCount(count);
+    } catch {
+    }
+  }, [mero, contextId, mountedRef]);
+  react.useEffect(() => {
+    void refresh();
+  }, [refresh]);
+  const authorize = react.useCallback(async () => {
+    if (!mero || !contextId) return null;
+    const result = await run(() => mero.rpc.migrateMyEntries(contextId));
+    if (result && mountedRef.current) {
+      reqRef.current += 1;
+      setSummary(result);
+      setPendingCount(result.remaining);
+    }
+    return result;
+  }, [mero, contextId, run, mountedRef]);
+  return {
+    summary,
+    pendingCount,
+    pending: pendingCount > 0,
+    authorize,
+    loading,
+    error,
+    refresh
+  };
+}
+function MigrationPendingBanner({
+  contextId,
+  className,
+  children,
+  onMigrated
+}) {
+  const { pending, pendingCount, authorize, loading } = useMyAuthoredMigration(contextId);
+  if (!pending) return null;
+  const handleClick = async () => {
+    const result = await authorize();
+    if (result && result.remaining === 0) {
+      onMigrated?.();
+    }
+  };
+  const message = children ?? `You have ${pendingCount} ${pendingCount === 1 ? "entry" : "entries"} to re-sign after a recent upgrade.`;
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className, "data-testid": "migration-pending-banner", role: "status", children: [
+    /* @__PURE__ */ jsxRuntime.jsx("span", { children: message }),
+    /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", onClick: handleClick, disabled: loading, children: loading ? "Migrating\u2026" : "Migrate my data" })
+  ] });
+}
+function MigrationAdminPanel({ namespaceId, pollIntervalMs, className }) {
+  const { status, rollup, members, membersPendingSignature, failed, error } = useMigrationStatus(
+    namespaceId,
+    { pollIntervalMs }
+  );
+  if (error && !status) {
+    return /* @__PURE__ */ jsxRuntime.jsxs("div", { className, "data-testid": "migration-admin-panel", children: [
+      "Failed to load migration status: ",
+      error.message
+    ] });
+  }
+  if (!status || !rollup) {
+    return /* @__PURE__ */ jsxRuntime.jsx("div", { className, "data-testid": "migration-admin-panel", children: "Loading migration status\u2026" });
+  }
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className, "data-testid": "migration-admin-panel", children: [
+    error && // A poll failed after data was already loaded — keep showing the last
+    // good rollup but flag that it may be stale.
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { "data-testid": "migration-status-error", role: "alert", children: [
+      "Could not refresh migration status: ",
+      error.message
+    ] }),
+    /* @__PURE__ */ jsxRuntime.jsxs("dl", { children: [
+      /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+        /* @__PURE__ */ jsxRuntime.jsx("dt", { children: "Target version" }),
+        /* @__PURE__ */ jsxRuntime.jsx("dd", { children: status.targetVersion })
+      ] }),
+      /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+        /* @__PURE__ */ jsxRuntime.jsx("dt", { children: "Migrated" }),
+        /* @__PURE__ */ jsxRuntime.jsx("dd", { children: rollup.migrated })
+      ] }),
+      /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+        /* @__PURE__ */ jsxRuntime.jsx("dt", { children: "In progress" }),
+        /* @__PURE__ */ jsxRuntime.jsx("dd", { children: rollup.inProgress })
+      ] }),
+      /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+        /* @__PURE__ */ jsxRuntime.jsx("dt", { children: "Unknown" }),
+        /* @__PURE__ */ jsxRuntime.jsx("dd", { children: rollup.unknown })
+      ] }),
+      /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+        /* @__PURE__ */ jsxRuntime.jsx("dt", { children: "Failed" }),
+        /* @__PURE__ */ jsxRuntime.jsx("dd", { "data-testid": "migration-failed-count", children: failed })
+      ] }),
+      /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+        /* @__PURE__ */ jsxRuntime.jsx("dt", { children: "Total" }),
+        /* @__PURE__ */ jsxRuntime.jsx("dd", { children: rollup.total })
+      ] }),
+      /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+        /* @__PURE__ */ jsxRuntime.jsx("dt", { children: "All migrated" }),
+        /* @__PURE__ */ jsxRuntime.jsx("dd", { children: rollup.allMigrated ? "yes" : "no" })
+      ] }),
+      /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+        /* @__PURE__ */ jsxRuntime.jsx("dt", { children: "Members pending signature" }),
+        /* @__PURE__ */ jsxRuntime.jsx("dd", { "data-testid": "members-pending-signature", children: membersPendingSignature })
+      ] })
+    ] }),
+    /* @__PURE__ */ jsxRuntime.jsxs("table", { children: [
+      /* @__PURE__ */ jsxRuntime.jsx("thead", { children: /* @__PURE__ */ jsxRuntime.jsxs("tr", { children: [
+        /* @__PURE__ */ jsxRuntime.jsx("th", { children: "Peer" }),
+        /* @__PURE__ */ jsxRuntime.jsx("th", { children: "State" }),
+        /* @__PURE__ */ jsxRuntime.jsx("th", { children: "Schema" }),
+        /* @__PURE__ */ jsxRuntime.jsx("th", { children: "Pending" }),
+        /* @__PURE__ */ jsxRuntime.jsx("th", { children: "Reason" })
+      ] }) }),
+      /* @__PURE__ */ jsxRuntime.jsx("tbody", { children: members.map((m) => /* @__PURE__ */ jsxRuntime.jsxs("tr", { "data-testid": "migration-member-row", children: [
+        /* @__PURE__ */ jsxRuntime.jsx("td", { children: m.peer }),
+        /* @__PURE__ */ jsxRuntime.jsx("td", { children: m.state }),
+        /* @__PURE__ */ jsxRuntime.jsx("td", { children: m.report?.schemaVersion ?? "\u2014" }),
+        /* @__PURE__ */ jsxRuntime.jsx("td", { children: m.report?.authoredRemaining ?? "\u2014" }),
+        /* @__PURE__ */ jsxRuntime.jsx("td", { children: m.report?.migrationFailed ?? "\u2014" })
+      ] }, m.peer)) })
+    ] })
+  ] });
+}
 
 Object.defineProperty(exports, "CAPABILITIES", {
   enumerable: true,
@@ -2319,6 +2626,8 @@ exports.LoginModal = LoginModal;
 exports.MERO_CSS_VARS = MERO_CSS_VARS;
 exports.MeroContext = MeroContext;
 exports.MeroProvider = MeroProvider;
+exports.MigrationAdminPanel = MigrationAdminPanel;
+exports.MigrationPendingBanner = MigrationPendingBanner;
 exports.clearAllStorage = clearAllStorage;
 exports.clearApplicationId = clearApplicationId;
 exports.clearContextId = clearContextId;
@@ -2338,6 +2647,7 @@ exports.setContextIdentity = setContextIdentity;
 exports.setNodeUrl = setNodeUrl;
 exports.themeToCssVars = themeToCssVars;
 exports.useAddGroupMembers = useAddGroupMembers;
+exports.useAppVersion = useAppVersion;
 exports.useApplicationContexts = useApplicationContexts;
 exports.useContextDiscovery = useContextDiscovery;
 exports.useContextGroup = useContextGroup;
@@ -2363,8 +2673,11 @@ exports.useJoinContext = useJoinContext;
 exports.useJoinGroup = useJoinGroup;
 exports.useJoinNamespace = useJoinNamespace;
 exports.useJoinSubgroupInheritance = useJoinSubgroupInheritance;
+exports.useLatestVersion = useLatestVersion;
 exports.useMemberMetadata = useMemberMetadata;
 exports.useMero = useMero;
+exports.useMigrationStatus = useMigrationStatus;
+exports.useMyAuthoredMigration = useMyAuthoredMigration;
 exports.useNamespace = useNamespace;
 exports.useNamespaceGroups = useNamespaceGroups;
 exports.useNamespaceIdentity = useNamespaceIdentity;