@calimero-network/mero-react 2.4.0 → 2.6.0

package/dist/index.d.cts

@@ -1,8 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
-import React__default, { CSSProperties } from 'react';
+import React__default, { CSSProperties, ReactNode } from 'react';
 import * as _calimero_network_mero_js from '@calimero-network/mero-js';
-import { MeroJs, SetMetadataRequest, AddGroupMembersRequest, CreateContextRequest, CreateGroupInNamespaceRequest, CreateNamespaceRequest, CreateNamespaceInvitationRequest, CreateNamespaceInvitationResponseData, CreateRecursiveInvitationResponseData, DeleteGroupRequest, DeleteNamespaceRequest, DetachContextFromGroupRequest, GroupContextEntry, GroupInfo, CreateGroupInvitationRequest, GroupMember, MetadataRecord, GroupUpgradeStatusResponseData, JoinGroupRequest, JoinNamespaceRequest, Namespace, SubgroupEntry, NamespaceIdentity, NestGroupRequest, RegisterGroupSigningKeyRequest, RemoveGroupMembersRequest, RetryGroupUpgradeRequest, SetDefaultCapabilitiesRequest, SetSubgroupVisibilityRequest, SetTeeAdmissionPolicyRequest, SseEventData, SyncGroupRequest, UnnestGroupRequest, UpdateGroupSettingsRequest, UpdateMemberRoleRequest, UpgradeGroupRequest, TokenData } from '@calimero-network/mero-js';
+import { MeroJs, SetMetadataRequest, AddGroupMembersRequest, CreateContextRequest, CreateGroupInNamespaceRequest, CreateNamespaceRequest, CreateNamespaceInvitationRequest, CreateNamespaceInvitationResponseData, CreateRecursiveInvitationResponseData, DeleteGroupRequest, DeleteNamespaceRequest, DetachContextFromGroupRequest, GroupContextEntry, GroupInfo, CreateGroupInvitationRequest, GroupMember, MetadataRecord, GroupUpgradeStatusResponseData, JoinGroupRequest, JoinNamespaceRequest, MigrationStatus, MigrationStatusRollup, MemberMigrationStatusEntry, MigrateMyEntriesSummary, Namespace, SubgroupEntry, NamespaceIdentity, NestGroupRequest, RegisterGroupSigningKeyRequest, RemoveGroupMembersRequest, RetryGroupUpgradeRequest, SetDefaultCapabilitiesRequest, SetSubgroupVisibilityRequest, SetTeeAdmissionPolicyRequest, SseEventData, SyncGroupRequest, UnnestGroupRequest, UpdateGroupSettingsRequest, UpdateMemberRoleRequest, UpgradeGroupRequest, TokenData } from '@calimero-network/mero-js';
 export * from '@calimero-network/mero-js';
 export { CAPABILITIES, MetadataRecord, hasCap, withCap, withoutCap } from '@calimero-network/mero-js';
 
@@ -267,6 +267,36 @@ interface CalimeroLogoProps extends React__default.SVGAttributes<SVGSVGElement>
 }
 declare function CalimeroLogo({ size, color, style, ...rest }: CalimeroLogoProps): react_jsx_runtime.JSX.Element;
 
+interface MigrationPendingBannerProps {
+    /** Context whose authored entries to check / convert. */
+    contextId: string;
+    className?: string;
+    /** Override the default prompt text. */
+    children?: ReactNode;
+    /** Fired once a convert leaves nothing pending (`remaining === 0`). */
+    onMigrated?: () => void;
+}
+/**
+ * Shows only when the current identity has entries below the target schema
+ * (skew #1). A single button runs the one-tap `migrate_my_entries` convert and
+ * the banner clears itself once nothing is pending.
+ */
+declare function MigrationPendingBanner({ contextId, className, children, onMigrated, }: MigrationPendingBannerProps): react_jsx_runtime.JSX.Element | null;
+
+interface MigrationAdminPanelProps {
+    /** Namespace whose migration rollup to display. */
+    namespaceId: string;
+    /** Re-fetch interval; migration facts arrive via heartbeat gossip. */
+    pollIntervalMs?: number;
+    className?: string;
+}
+/**
+ * Operator view of a namespace's migration rollup (skew #3): the cohort
+ * counters, `membersPendingSignature`, and a per-member table. Read-only —
+ * pair with the upgrade-trigger hooks to drive a migration.
+ */
+declare function MigrationAdminPanel({ namespaceId, pollIntervalMs, className }: MigrationAdminPanelProps): react_jsx_runtime.JSX.Element;
+
 /**
  * Shape accepted by the metadata-setter hooks — re-exported from mero-js so
  * callers have one canonical type. A `set*Metadata` call **replaces the whole
@@ -548,6 +578,72 @@ declare function useDetachContextFromGroup(): {
     loading: boolean;
     error: Error | null;
 };
+/**
+ * Migration-status rollup for a namespace (skew #3). Migration facts arrive via
+ * heartbeat gossip (no SSE), so liveness is polling: pass `pollIntervalMs` to
+ * re-fetch on an interval. Derived counters are null-safe before the first load.
+ */
+declare function useMigrationStatus(namespaceId?: string | null, options?: {
+    pollIntervalMs?: number;
+}): {
+    status: MigrationStatus | null;
+    rollup: MigrationStatusRollup | null;
+    members: MemberMigrationStatusEntry[];
+    allMigrated: boolean;
+    membersPendingSignature: number;
+    /** Members whose migrate aborted (migration-check failed or apply errored). */
+    failed: number;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * Bundle-version skew (#2): reads the context's installed `applicationVersion`
+ * (semver) and compares it to the app-declared `expected` build constant. Any
+ * mismatch (either direction) is `isStale` → "reload to update". Subscribes to
+ * `AppVersionChanged` so a live flip updates `appVersion` without a refetch.
+ */
+declare function useAppVersion(contextId?: string | null, expected?: string): {
+    appVersion: string | undefined;
+    expected: string | undefined;
+    isStale: boolean;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * "Is a newer version available?" for an Updates view. Reads a package's
+ * published versions from the registry and compares the newest to the running
+ * `currentVersion` (e.g. a context's `applicationVersion`). `updateAvailable`
+ * is true only when the registry's newest is strictly greater. This is the
+ * registry-side check the admin acts on; gate rendering on admin status at the
+ * call site. Pure read — fetching nothing until both `registryUrl` and
+ * `packageName` are provided.
+ */
+declare function useLatestVersion(registryUrl?: string | null, packageName?: string | null, currentVersion?: string | null): {
+    versions: string[];
+    latestVersion: string;
+    currentVersion: string | null | undefined;
+    updateAvailable: boolean;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * The caller's own identity-gated entries pending re-signature (skew #1).
+ * `pending` is `pendingCount > 0` (from `count_my_pending`); `authorize()` runs
+ * the one-tap `migrate_my_entries` convert and folds the resulting `remaining`
+ * back into the count.
+ */
+declare function useMyAuthoredMigration(contextId?: string | null): {
+    summary: MigrateMyEntriesSummary | null;
+    pendingCount: number;
+    pending: boolean;
+    authorize: () => Promise<MigrateMyEntriesSummary | null>;
+    loading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+};
 
 /**
  * Storage utilities for mero-react
@@ -613,4 +709,4 @@ declare function clearContextIdentity(): void;
  */
 declare function clearAllStorage(): void;
 
-export { type AppContext, AppMode, type ApplicationContextRecord, CalimeroLogo, type CalimeroLogoProps, ConnectButton, type ConnectButtonProps, ConnectionType, type ContextDiscoveryOptions, type ContextDiscoveryState, type CustomConnectionConfig, type ExecutionResult, LoginModal, type LoginModalProps, MERO_CSS_VARS, MeroContext, type MeroContextValue, MeroProvider, type MeroProviderConfig, type MeroProviderProps, type MeroTheme, type ResolvedMeroTheme, type SetMetadataInput, clearAllStorage, clearApplicationId, clearContextId, clearContextIdentity, clearNodeUrl, cssVar, defaultMeroTheme, getApplicationId, getContextId, getContextIdentity, getNodeUrl, localStorageTokenStorage, resolveMeroTheme, setApplicationId, setContextId, setContextIdentity, setNodeUrl, themeToCssVars, useAddGroupMembers, useApplicationContexts, useContextDiscovery, useContextGroup, useContexts, useCreateContext, useCreateGroupInNamespace, useCreateNamespace, useCreateNamespaceInvitation, useDefaultCapabilities, useDeleteContext, useDeleteGroup, useDeleteNamespace, useDetachContextFromGroup, useExecute, useGroupCapabilities, useGroupContexts, useGroupInfo, useGroupInvitations, useGroupMembers, useGroupMetadata, useGroupUpgradeStatus, useJoinContext, useJoinGroup, useJoinNamespace, useJoinSubgroupInheritance, useMemberMetadata, useMero, useNamespace, useNamespaceGroups, useNamespaceIdentity, useNamespaces, useNamespacesForApplication, useNestGroup, useRegisterGroupSigningKey, useRemoveGroupMembers, useRetryGroupUpgrade, useSetContextMetadata, useSetDefaultCapabilities, useSetGroupMetadata, useSetMemberMetadata, useSetSubgroupVisibility, useSetTeeAdmissionPolicy, useSubgroupVisibility, useSubgroups, useSubscription, useSyncGroup, useUnnestGroup, useUpdateGroupSettings, useUpdateMemberRole, useUpgradeGroup };
+export { type AppContext, AppMode, type ApplicationContextRecord, CalimeroLogo, type CalimeroLogoProps, ConnectButton, type ConnectButtonProps, ConnectionType, type ContextDiscoveryOptions, type ContextDiscoveryState, type CustomConnectionConfig, type ExecutionResult, LoginModal, type LoginModalProps, MERO_CSS_VARS, MeroContext, type MeroContextValue, MeroProvider, type MeroProviderConfig, type MeroProviderProps, type MeroTheme, MigrationAdminPanel, type MigrationAdminPanelProps, MigrationPendingBanner, type MigrationPendingBannerProps, type ResolvedMeroTheme, type SetMetadataInput, clearAllStorage, clearApplicationId, clearContextId, clearContextIdentity, clearNodeUrl, cssVar, defaultMeroTheme, getApplicationId, getContextId, getContextIdentity, getNodeUrl, localStorageTokenStorage, resolveMeroTheme, setApplicationId, setContextId, setContextIdentity, setNodeUrl, themeToCssVars, useAddGroupMembers, useAppVersion, useApplicationContexts, useContextDiscovery, useContextGroup, useContexts, useCreateContext, useCreateGroupInNamespace, useCreateNamespace, useCreateNamespaceInvitation, useDefaultCapabilities, useDeleteContext, useDeleteGroup, useDeleteNamespace, useDetachContextFromGroup, useExecute, useGroupCapabilities, useGroupContexts, useGroupInfo, useGroupInvitations, useGroupMembers, useGroupMetadata, useGroupUpgradeStatus, useJoinContext, useJoinGroup, useJoinNamespace, useJoinSubgroupInheritance, useLatestVersion, useMemberMetadata, useMero, useMigrationStatus, useMyAuthoredMigration, useNamespace, useNamespaceGroups, useNamespaceIdentity, useNamespaces, useNamespacesForApplication, useNestGroup, useRegisterGroupSigningKey, useRemoveGroupMembers, useRetryGroupUpgrade, useSetContextMetadata, useSetDefaultCapabilities, useSetGroupMetadata, useSetMemberMetadata, useSetSubgroupVisibility, useSetTeeAdmissionPolicy, useSubgroupVisibility, useSubgroups, useSubscription, useSyncGroup, useUnnestGroup, useUpdateGroupSettings, useUpdateMemberRole, useUpgradeGroup };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
-import React__default, { CSSProperties } from 'react';
+import React__default, { CSSProperties, ReactNode } from 'react';
 import * as _calimero_network_mero_js from '@calimero-network/mero-js';
-import { MeroJs, SetMetadataRequest, AddGroupMembersRequest, CreateContextRequest, CreateGroupInNamespaceRequest, CreateNamespaceRequest, CreateNamespaceInvitationRequest, CreateNamespaceInvitationResponseData, CreateRecursiveInvitationResponseData, DeleteGroupRequest, DeleteNamespaceRequest, DetachContextFromGroupRequest, GroupContextEntry, GroupInfo, CreateGroupInvitationRequest, GroupMember, MetadataRecord, GroupUpgradeStatusResponseData, JoinGroupRequest, JoinNamespaceRequest, Namespace, SubgroupEntry, NamespaceIdentity, NestGroupRequest, RegisterGroupSigningKeyRequest, RemoveGroupMembersRequest, RetryGroupUpgradeRequest, SetDefaultCapabilitiesRequest, SetSubgroupVisibilityRequest, SetTeeAdmissionPolicyRequest, SseEventData, SyncGroupRequest, UnnestGroupRequest, UpdateGroupSettingsRequest, UpdateMemberRoleRequest, UpgradeGroupRequest, TokenData } from '@calimero-network/mero-js';
+import { MeroJs, SetMetadataRequest, AddGroupMembersRequest, CreateContextRequest, CreateGroupInNamespaceRequest, CreateNamespaceRequest, CreateNamespaceInvitationRequest, CreateNamespaceInvitationResponseData, CreateRecursiveInvitationResponseData, DeleteGroupRequest, DeleteNamespaceRequest, DetachContextFromGroupRequest, GroupContextEntry, GroupInfo, CreateGroupInvitationRequest, GroupMember, MetadataRecord, GroupUpgradeStatusResponseData, JoinGroupRequest, JoinNamespaceRequest, MigrationStatus, MigrationStatusRollup, MemberMigrationStatusEntry, MigrateMyEntriesSummary, Namespace, SubgroupEntry, NamespaceIdentity, NestGroupRequest, RegisterGroupSigningKeyRequest, RemoveGroupMembersRequest, RetryGroupUpgradeRequest, SetDefaultCapabilitiesRequest, SetSubgroupVisibilityRequest, SetTeeAdmissionPolicyRequest, SseEventData, SyncGroupRequest, UnnestGroupRequest, UpdateGroupSettingsRequest, UpdateMemberRoleRequest, UpgradeGroupRequest, TokenData } from '@calimero-network/mero-js';
 export * from '@calimero-network/mero-js';
 export { CAPABILITIES, MetadataRecord, hasCap, withCap, withoutCap } from '@calimero-network/mero-js';
 
@@ -267,6 +267,36 @@ interface CalimeroLogoProps extends React__default.SVGAttributes<SVGSVGElement>
 }
 declare function CalimeroLogo({ size, color, style, ...rest }: CalimeroLogoProps): react_jsx_runtime.JSX.Element;
 
+interface MigrationPendingBannerProps {
+    /** Context whose authored entries to check / convert. */
+    contextId: string;
+    className?: string;
+    /** Override the default prompt text. */
+    children?: ReactNode;
+    /** Fired once a convert leaves nothing pending (`remaining === 0`). */
+    onMigrated?: () => void;
+}
+/**
+ * Shows only when the current identity has entries below the target schema
+ * (skew #1). A single button runs the one-tap `migrate_my_entries` convert and
+ * the banner clears itself once nothing is pending.
+ */
+declare function MigrationPendingBanner({ contextId, className, children, onMigrated, }: MigrationPendingBannerProps): react_jsx_runtime.JSX.Element | null;
+
+interface MigrationAdminPanelProps {
+    /** Namespace whose migration rollup to display. */
+    namespaceId: string;
+    /** Re-fetch interval; migration facts arrive via heartbeat gossip. */
+    pollIntervalMs?: number;
+    className?: string;
+}
+/**
+ * Operator view of a namespace's migration rollup (skew #3): the cohort
+ * counters, `membersPendingSignature`, and a per-member table. Read-only —
+ * pair with the upgrade-trigger hooks to drive a migration.
+ */
+declare function MigrationAdminPanel({ namespaceId, pollIntervalMs, className }: MigrationAdminPanelProps): react_jsx_runtime.JSX.Element;
+
 /**
  * Shape accepted by the metadata-setter hooks — re-exported from mero-js so
  * callers have one canonical type. A `set*Metadata` call **replaces the whole
@@ -548,6 +578,72 @@ declare function useDetachContextFromGroup(): {
     loading: boolean;
     error: Error | null;
 };
+/**
+ * Migration-status rollup for a namespace (skew #3). Migration facts arrive via
+ * heartbeat gossip (no SSE), so liveness is polling: pass `pollIntervalMs` to
+ * re-fetch on an interval. Derived counters are null-safe before the first load.
+ */
+declare function useMigrationStatus(namespaceId?: string | null, options?: {
+    pollIntervalMs?: number;
+}): {
+    status: MigrationStatus | null;
+    rollup: MigrationStatusRollup | null;
+    members: MemberMigrationStatusEntry[];
+    allMigrated: boolean;
+    membersPendingSignature: number;
+    /** Members whose migrate aborted (migration-check failed or apply errored). */
+    failed: number;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * Bundle-version skew (#2): reads the context's installed `applicationVersion`
+ * (semver) and compares it to the app-declared `expected` build constant. Any
+ * mismatch (either direction) is `isStale` → "reload to update". Subscribes to
+ * `AppVersionChanged` so a live flip updates `appVersion` without a refetch.
+ */
+declare function useAppVersion(contextId?: string | null, expected?: string): {
+    appVersion: string | undefined;
+    expected: string | undefined;
+    isStale: boolean;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * "Is a newer version available?" for an Updates view. Reads a package's
+ * published versions from the registry and compares the newest to the running
+ * `currentVersion` (e.g. a context's `applicationVersion`). `updateAvailable`
+ * is true only when the registry's newest is strictly greater. This is the
+ * registry-side check the admin acts on; gate rendering on admin status at the
+ * call site. Pure read — fetching nothing until both `registryUrl` and
+ * `packageName` are provided.
+ */
+declare function useLatestVersion(registryUrl?: string | null, packageName?: string | null, currentVersion?: string | null): {
+    versions: string[];
+    latestVersion: string;
+    currentVersion: string | null | undefined;
+    updateAvailable: boolean;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * The caller's own identity-gated entries pending re-signature (skew #1).
+ * `pending` is `pendingCount > 0` (from `count_my_pending`); `authorize()` runs
+ * the one-tap `migrate_my_entries` convert and folds the resulting `remaining`
+ * back into the count.
+ */
+declare function useMyAuthoredMigration(contextId?: string | null): {
+    summary: MigrateMyEntriesSummary | null;
+    pendingCount: number;
+    pending: boolean;
+    authorize: () => Promise<MigrateMyEntriesSummary | null>;
+    loading: boolean;
+    error: Error | null;
+    refresh: () => Promise<void>;
+};
 
 /**
  * Storage utilities for mero-react
@@ -613,4 +709,4 @@ declare function clearContextIdentity(): void;
  */
 declare function clearAllStorage(): void;
 
-export { type AppContext, AppMode, type ApplicationContextRecord, CalimeroLogo, type CalimeroLogoProps, ConnectButton, type ConnectButtonProps, ConnectionType, type ContextDiscoveryOptions, type ContextDiscoveryState, type CustomConnectionConfig, type ExecutionResult, LoginModal, type LoginModalProps, MERO_CSS_VARS, MeroContext, type MeroContextValue, MeroProvider, type MeroProviderConfig, type MeroProviderProps, type MeroTheme, type ResolvedMeroTheme, type SetMetadataInput, clearAllStorage, clearApplicationId, clearContextId, clearContextIdentity, clearNodeUrl, cssVar, defaultMeroTheme, getApplicationId, getContextId, getContextIdentity, getNodeUrl, localStorageTokenStorage, resolveMeroTheme, setApplicationId, setContextId, setContextIdentity, setNodeUrl, themeToCssVars, useAddGroupMembers, useApplicationContexts, useContextDiscovery, useContextGroup, useContexts, useCreateContext, useCreateGroupInNamespace, useCreateNamespace, useCreateNamespaceInvitation, useDefaultCapabilities, useDeleteContext, useDeleteGroup, useDeleteNamespace, useDetachContextFromGroup, useExecute, useGroupCapabilities, useGroupContexts, useGroupInfo, useGroupInvitations, useGroupMembers, useGroupMetadata, useGroupUpgradeStatus, useJoinContext, useJoinGroup, useJoinNamespace, useJoinSubgroupInheritance, useMemberMetadata, useMero, useNamespace, useNamespaceGroups, useNamespaceIdentity, useNamespaces, useNamespacesForApplication, useNestGroup, useRegisterGroupSigningKey, useRemoveGroupMembers, useRetryGroupUpgrade, useSetContextMetadata, useSetDefaultCapabilities, useSetGroupMetadata, useSetMemberMetadata, useSetSubgroupVisibility, useSetTeeAdmissionPolicy, useSubgroupVisibility, useSubgroups, useSubscription, useSyncGroup, useUnnestGroup, useUpdateGroupSettings, useUpdateMemberRole, useUpgradeGroup };
+export { type AppContext, AppMode, type ApplicationContextRecord, CalimeroLogo, type CalimeroLogoProps, ConnectButton, type ConnectButtonProps, ConnectionType, type ContextDiscoveryOptions, type ContextDiscoveryState, type CustomConnectionConfig, type ExecutionResult, LoginModal, type LoginModalProps, MERO_CSS_VARS, MeroContext, type MeroContextValue, MeroProvider, type MeroProviderConfig, type MeroProviderProps, type MeroTheme, MigrationAdminPanel, type MigrationAdminPanelProps, MigrationPendingBanner, type MigrationPendingBannerProps, type ResolvedMeroTheme, type SetMetadataInput, clearAllStorage, clearApplicationId, clearContextId, clearContextIdentity, clearNodeUrl, cssVar, defaultMeroTheme, getApplicationId, getContextId, getContextIdentity, getNodeUrl, localStorageTokenStorage, resolveMeroTheme, setApplicationId, setContextId, setContextIdentity, setNodeUrl, themeToCssVars, useAddGroupMembers, useAppVersion, useApplicationContexts, useContextDiscovery, useContextGroup, useContexts, useCreateContext, useCreateGroupInNamespace, useCreateNamespace, useCreateNamespaceInvitation, useDefaultCapabilities, useDeleteContext, useDeleteGroup, useDeleteNamespace, useDetachContextFromGroup, useExecute, useGroupCapabilities, useGroupContexts, useGroupInfo, useGroupInvitations, useGroupMembers, useGroupMetadata, useGroupUpgradeStatus, useJoinContext, useJoinGroup, useJoinNamespace, useJoinSubgroupInheritance, useLatestVersion, useMemberMetadata, useMero, useMigrationStatus, useMyAuthoredMigration, useNamespace, useNamespaceGroups, useNamespaceIdentity, useNamespaces, useNamespacesForApplication, useNestGroup, useRegisterGroupSigningKey, useRemoveGroupMembers, useRetryGroupUpgrade, useSetContextMetadata, useSetDefaultCapabilities, useSetGroupMetadata, useSetMemberMetadata, useSetSubgroupVisibility, useSetTeeAdmissionPolicy, useSubgroupVisibility, useSubgroups, useSubscription, useSyncGroup, useUnnestGroup, useUpdateGroupSettings, useUpdateMemberRole, useUpgradeGroup };

package/dist/index.js

@@ -1,5 +1,5 @@
 import { createContext, useState, useRef, useCallback, useEffect, useMemo, useContext } from 'react';
-import { parseAuthCallback, MeroJs, buildAuthLoginUrl, LocalStorageTokenStore } from '@calimero-network/mero-js';
+import { parseAuthCallback, MeroJs, buildAuthLoginUrl, compareSemver, LocalStorageTokenStore } from '@calimero-network/mero-js';
 export * from '@calimero-network/mero-js';
 export { CAPABILITIES, hasCap, withCap, withoutCap } from '@calimero-network/mero-js';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
@@ -2294,7 +2294,314 @@ function useDetachContextFromGroup() {
   );
   return { detachContextFromGroup, loading, error };
 }
+function useMigrationStatus(namespaceId, options) {
+  const { mero } = useMero();
+  const [status, setStatus] = useState(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const mountedRef = useMountedRef();
+  const reqRef = useRef(0);
+  const refetch = 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]);
+  useEffect(() => {
+    setStatus(null);
+    setError(null);
+  }, [namespaceId]);
+  useEffect(() => {
+    void refetch();
+  }, [refetch]);
+  const pollIntervalMs = options?.pollIntervalMs;
+  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] = useState(void 0);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const mountedRef = useMountedRef();
+  const reqRef = useRef(0);
+  const refetch = 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]);
+  useEffect(() => {
+    setAppVersion(void 0);
+    setError(null);
+  }, [contextId]);
+  useEffect(() => {
+    void refetch();
+  }, [refetch]);
+  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] = useState([]);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const mountedRef = useMountedRef();
+  const reqRef = useRef(0);
+  const refetch = 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]);
+  useEffect(() => {
+    setVersions([]);
+    setError(null);
+  }, [registryUrl, packageName]);
+  useEffect(() => {
+    void refetch();
+  }, [refetch]);
+  const latestVersion = versions[0] ?? null;
+  const updateAvailable = latestVersion != null && currentVersion != null && compareSemver(latestVersion, currentVersion) > 0;
+  return { versions, latestVersion, currentVersion, updateAvailable, loading, error, refetch };
+}
+function useMyAuthoredMigration(contextId) {
+  const { mero } = useMero();
+  const [summary, setSummary] = useState(null);
+  const [pendingCount, setPendingCount] = useState(0);
+  const mountedRef = useMountedRef();
+  const { loading, error, run } = useAsyncMutation();
+  const reqRef = useRef(0);
+  const refresh = 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]);
+  useEffect(() => {
+    void refresh();
+  }, [refresh]);
+  const authorize = 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__ */ jsxs("div", { className, "data-testid": "migration-pending-banner", role: "status", children: [
+    /* @__PURE__ */ jsx("span", { children: message }),
+    /* @__PURE__ */ 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__ */ jsxs("div", { className, "data-testid": "migration-admin-panel", children: [
+      "Failed to load migration status: ",
+      error.message
+    ] });
+  }
+  if (!status || !rollup) {
+    return /* @__PURE__ */ jsx("div", { className, "data-testid": "migration-admin-panel", children: "Loading migration status\u2026" });
+  }
+  return /* @__PURE__ */ 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__ */ jsxs("div", { "data-testid": "migration-status-error", role: "alert", children: [
+      "Could not refresh migration status: ",
+      error.message
+    ] }),
+    /* @__PURE__ */ jsxs("dl", { children: [
+      /* @__PURE__ */ jsxs("div", { children: [
+        /* @__PURE__ */ jsx("dt", { children: "Target version" }),
+        /* @__PURE__ */ jsx("dd", { children: status.targetVersion })
+      ] }),
+      /* @__PURE__ */ jsxs("div", { children: [
+        /* @__PURE__ */ jsx("dt", { children: "Migrated" }),
+        /* @__PURE__ */ jsx("dd", { children: rollup.migrated })
+      ] }),
+      /* @__PURE__ */ jsxs("div", { children: [
+        /* @__PURE__ */ jsx("dt", { children: "In progress" }),
+        /* @__PURE__ */ jsx("dd", { children: rollup.inProgress })
+      ] }),
+      /* @__PURE__ */ jsxs("div", { children: [
+        /* @__PURE__ */ jsx("dt", { children: "Unknown" }),
+        /* @__PURE__ */ jsx("dd", { children: rollup.unknown })
+      ] }),
+      /* @__PURE__ */ jsxs("div", { children: [
+        /* @__PURE__ */ jsx("dt", { children: "Failed" }),
+        /* @__PURE__ */ jsx("dd", { "data-testid": "migration-failed-count", children: failed })
+      ] }),
+      /* @__PURE__ */ jsxs("div", { children: [
+        /* @__PURE__ */ jsx("dt", { children: "Total" }),
+        /* @__PURE__ */ jsx("dd", { children: rollup.total })
+      ] }),
+      /* @__PURE__ */ jsxs("div", { children: [
+        /* @__PURE__ */ jsx("dt", { children: "All migrated" }),
+        /* @__PURE__ */ jsx("dd", { children: rollup.allMigrated ? "yes" : "no" })
+      ] }),
+      /* @__PURE__ */ jsxs("div", { children: [
+        /* @__PURE__ */ jsx("dt", { children: "Members pending signature" }),
+        /* @__PURE__ */ jsx("dd", { "data-testid": "members-pending-signature", children: membersPendingSignature })
+      ] })
+    ] }),
+    /* @__PURE__ */ jsxs("table", { children: [
+      /* @__PURE__ */ jsx("thead", { children: /* @__PURE__ */ jsxs("tr", { children: [
+        /* @__PURE__ */ jsx("th", { children: "Peer" }),
+        /* @__PURE__ */ jsx("th", { children: "State" }),
+        /* @__PURE__ */ jsx("th", { children: "Schema" }),
+        /* @__PURE__ */ jsx("th", { children: "Pending" }),
+        /* @__PURE__ */ jsx("th", { children: "Reason" })
+      ] }) }),
+      /* @__PURE__ */ jsx("tbody", { children: members.map((m) => /* @__PURE__ */ jsxs("tr", { "data-testid": "migration-member-row", children: [
+        /* @__PURE__ */ jsx("td", { children: m.peer }),
+        /* @__PURE__ */ jsx("td", { children: m.state }),
+        /* @__PURE__ */ jsx("td", { children: m.report?.schemaVersion ?? "\u2014" }),
+        /* @__PURE__ */ jsx("td", { children: m.report?.authoredRemaining ?? "\u2014" }),
+        /* @__PURE__ */ jsx("td", { children: m.report?.migrationFailed ?? "\u2014" })
+      ] }, m.peer)) })
+    ] })
+  ] });
+}
 
-export { AppMode, CalimeroLogo, ConnectButton, ConnectionType, LoginModal, MERO_CSS_VARS, MeroContext, MeroProvider, clearAllStorage, clearApplicationId, clearContextId, clearContextIdentity, clearNodeUrl, cssVar, defaultMeroTheme, getApplicationId, getContextId, getContextIdentity, getNodeUrl, localStorageTokenStorage, resolveMeroTheme, setApplicationId, setContextId, setContextIdentity, setNodeUrl, themeToCssVars, useAddGroupMembers, useApplicationContexts, useContextDiscovery, useContextGroup, useContexts, useCreateContext, useCreateGroupInNamespace, useCreateNamespace, useCreateNamespaceInvitation, useDefaultCapabilities, useDeleteContext, useDeleteGroup, useDeleteNamespace, useDetachContextFromGroup, useExecute, useGroupCapabilities, useGroupContexts, useGroupInfo, useGroupInvitations, useGroupMembers, useGroupMetadata, useGroupUpgradeStatus, useJoinContext, useJoinGroup, useJoinNamespace, useJoinSubgroupInheritance, useMemberMetadata, useMero, useNamespace, useNamespaceGroups, useNamespaceIdentity, useNamespaces, useNamespacesForApplication, useNestGroup, useRegisterGroupSigningKey, useRemoveGroupMembers, useRetryGroupUpgrade, useSetContextMetadata, useSetDefaultCapabilities, useSetGroupMetadata, useSetMemberMetadata, useSetSubgroupVisibility, useSetTeeAdmissionPolicy, useSubgroupVisibility, useSubgroups, useSubscription, useSyncGroup, useUnnestGroup, useUpdateGroupSettings, useUpdateMemberRole, useUpgradeGroup };
+export { AppMode, CalimeroLogo, ConnectButton, ConnectionType, LoginModal, MERO_CSS_VARS, MeroContext, MeroProvider, MigrationAdminPanel, MigrationPendingBanner, clearAllStorage, clearApplicationId, clearContextId, clearContextIdentity, clearNodeUrl, cssVar, defaultMeroTheme, getApplicationId, getContextId, getContextIdentity, getNodeUrl, localStorageTokenStorage, resolveMeroTheme, setApplicationId, setContextId, setContextIdentity, setNodeUrl, themeToCssVars, useAddGroupMembers, useAppVersion, useApplicationContexts, useContextDiscovery, useContextGroup, useContexts, useCreateContext, useCreateGroupInNamespace, useCreateNamespace, useCreateNamespaceInvitation, useDefaultCapabilities, useDeleteContext, useDeleteGroup, useDeleteNamespace, useDetachContextFromGroup, useExecute, useGroupCapabilities, useGroupContexts, useGroupInfo, useGroupInvitations, useGroupMembers, useGroupMetadata, useGroupUpgradeStatus, useJoinContext, useJoinGroup, useJoinNamespace, useJoinSubgroupInheritance, useLatestVersion, useMemberMetadata, useMero, useMigrationStatus, useMyAuthoredMigration, useNamespace, useNamespaceGroups, useNamespaceIdentity, useNamespaces, useNamespacesForApplication, useNestGroup, useRegisterGroupSigningKey, useRemoveGroupMembers, useRetryGroupUpgrade, useSetContextMetadata, useSetDefaultCapabilities, useSetGroupMetadata, useSetMemberMetadata, useSetSubgroupVisibility, useSetTeeAdmissionPolicy, useSubgroupVisibility, useSubgroups, useSubscription, useSyncGroup, useUnnestGroup, useUpdateGroupSettings, useUpdateMemberRole, useUpgradeGroup };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map