@calimero-network/mero-react 5.1.0 → 6.0.1

package/dist/index.d.cts

@@ -2,7 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 import React__default, { CSSProperties, ReactNode } from 'react';
 import * as _calimero_network_mero_js from '@calimero-network/mero-js';
-import { MeroJs, TokenStore, SetMetadataRequest, SseEventData, GroupMembershipEventData, GroupMigrationEventData, Codec, AddGroupMembersRequest, CreateContextRequest, CreateGroupInNamespaceRequest, CreateNamespaceRequest, CreateNamespaceInvitationRequest, CreateNamespaceInvitationResponseData, CreateRecursiveInvitationResponseData, DeleteGroupRequest, DeleteNamespaceRequest, DetachContextFromGroupRequest, GroupUpgradeStatusResponseData, GroupContextEntry, GroupInfo, CreateGroupInvitationRequest, MetadataRecord, JoinGroupRequest, JoinNamespaceRequest, MigrationStatus, MigrationStatusRollup, MemberMigrationStatusEntry, MigrateMyEntriesSummary, Namespace, SubgroupEntry, NamespaceIdentity, RemoveGroupMembersRequest, ReparentGroupRequest, ResyncContextRequest, RetryGroupUpgradeRequest, SetDefaultCapabilitiesRequest, SetSubgroupVisibilityRequest, SetTeeAdmissionPolicyRequest, SyncGroupRequest, UpdateMemberRoleRequest, UpgradeGroupRequest, TokenData } from '@calimero-network/mero-js';
+import { MeroJs, TokenStore, SetMetadataRequest, SseEventData, GroupMembershipEventData, GroupMigrationEventData, Codec, AddGroupMembersRequest, CreateContextRequest, CreateGroupInNamespaceRequest, CreateNamespaceRequest, CreateNamespaceInvitationRequest, CreateNamespaceInvitationResponseData, CreateRecursiveInvitationResponseData, DeleteGroupRequest, DeleteNamespaceRequest, DetachContextFromGroupRequest, GroupUpgradeStatusResponseData, GroupContextEntry, GroupInfo, CreateGroupInvitationRequest, MetadataRecord, JoinGroupRequest, JoinNamespaceRequest, MigrationStatus, MigrationStatusRollup, MemberMigrationStatusEntry, MigrateMyEntriesSummary, Namespace, SubgroupEntry, NamespaceIdentity, NodeIdentity, RemoveGroupMembersRequest, ReparentGroupRequest, ResyncContextRequest, RetryGroupUpgradeRequest, SetDefaultCapabilitiesRequest, SetSubgroupVisibilityRequest, SetTeeAdmissionPolicyRequest, SyncGroupRequest, UpdateMemberRoleRequest, UpgradeGroupRequest, TokenData } from '@calimero-network/mero-js';
 export * from '@calimero-network/mero-js';
 export { CAPABILITIES, Codec, DEFAULT_LOCAL_NODE_PORTS, DiscoverLocalNodesOptions, EphemeralClient, EphemeralEntry, MetadataRecord, discoverLocalNodes, hasCap, localNodeUrl, nodeEndpoint, probeNodeHealth, withCap, withoutCap } from '@calimero-network/mero-js';
 
@@ -447,6 +447,11 @@ declare function useJoinGroup(): {
     loading: boolean;
     error: Error | null;
 };
+/**
+ * Takes the member's ACCOUNT (64 hex), as `useGroupMembers` rows are keyed by
+ * and `useNodeIdentity().identity?.accountId` returns - NOT a signing key.
+ * Both are 32-byte strings, so passing a key names nobody and raises nothing.
+ */
 declare function useGroupCapabilities(groupId?: string | null, memberId?: string | null): {
     capabilities: number | null;
     loading: boolean;
@@ -497,11 +502,22 @@ declare function useSyncGroup(): {
     loading: boolean;
     error: Error | null;
 };
+/**
+ * Takes the invitee's signing KEY (bs58) - the one call on this resource that
+ * does, because someone being added may have no account here yet. Every other
+ * member call, including `useRemoveGroupMembers`, takes the ACCOUNT, so a value
+ * round-tripped from an add is the wrong one to remove with.
+ */
 declare function useAddGroupMembers(): {
     addGroupMembers: (groupId: string, request: AddGroupMembersRequest) => Promise<void | null>;
     loading: boolean;
     error: Error | null;
 };
+/**
+ * Takes the member's ACCOUNT (64 hex), as `useGroupMembers` rows are keyed by
+ * and `useNodeIdentity().identity?.accountId` returns - NOT a signing key.
+ * Both are 32-byte strings, so passing a key names nobody and raises nothing.
+ */
 declare function useRemoveGroupMembers(): {
     removeGroupMembers: (groupId: string, request: RemoveGroupMembersRequest) => Promise<void | null>;
     loading: boolean;
@@ -519,6 +535,24 @@ declare function useNamespace(namespaceId?: string | null): {
     error: Error | null;
     refetch: () => Promise<void>;
 };
+/**
+ * Who this node is: `accountId` is what member-addressing takes and what
+ * `useGroupMembers` rows are keyed by — `publicKey` is the signing key and
+ * addresses nobody. Both are 32-byte strings, so a swap fails silently.
+ */
+declare function useNodeIdentity(): {
+    identity: NodeIdentity | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * @deprecated Use {@link useNodeIdentity}. Identity is per-node, not
+ * per-namespace, and this no longer gates on participation: it answers for a
+ * namespace this node never joined, so `identity != null` is not "am I a
+ * member?" — ask `useNamespaces` for that. Its `publicKey` is the signing key,
+ * NOT the account member-addressing wants.
+ */
 declare function useNamespaceIdentity(namespaceId?: string | null): {
     identity: NamespaceIdentity | null;
     loading: boolean;
@@ -562,6 +596,11 @@ declare function useNamespaceGroups(namespaceId?: string | null): {
     error: Error | null;
     refetch: () => Promise<void>;
 };
+/**
+ * Takes the member's ACCOUNT (64 hex), as `useGroupMembers` rows are keyed by
+ * and `useNodeIdentity().identity?.accountId` returns - NOT a signing key.
+ * Both are 32-byte strings, so passing a key names nobody and raises nothing.
+ */
 declare function useUpdateMemberRole(): {
     updateMemberRole: (groupId: string, identity: string, request: UpdateMemberRoleRequest) => Promise<void | null>;
     loading: boolean;
@@ -599,6 +638,11 @@ declare function useSetGroupMetadata(): {
     loading: boolean;
     error: Error | null;
 };
+/**
+ * Takes the member's ACCOUNT (64 hex), as `useGroupMembers` rows are keyed by
+ * and `useNodeIdentity().identity?.accountId` returns - NOT a signing key.
+ * Both are 32-byte strings, so passing a key names nobody and raises nothing.
+ */
 declare function useSetMemberMetadata(): {
     setMemberMetadata: (groupId: string, identity: string, request: SetMetadataInput) => Promise<void | null>;
     loading: boolean;
@@ -676,9 +720,31 @@ declare function useDetachContextFromGroup(): {
     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.
+ * Subscribe to a namespace's `GroupMigration` events, invoking `onEvent` per
+ * frame and unsubscribing on unmount.
+ *
+ * A non-admin subscriber never sees `CascadeProgress`; core delivers that to
+ * namespace admins only, so a UI must not wait on it to decide progress.
+ */
+/**
+ * Fallback poll cadence for `useMigrationStatus` when the SSE stream is
+ * unavailable (no token, a proxy that buffers, an older node) and the caller
+ * named no interval of its own. Chosen to match the heartbeat cadence that
+ * migration facts actually arrive on; an explicit `pollIntervalMs` overrides it.
+ */
+declare const DEFAULT_MIGRATION_POLL_INTERVAL_MS = 5000;
+declare function useMigrationEvents(namespaceId: string | null | undefined, onEvent: (event: GroupMigrationEventData) => void): boolean;
+/**
+ * Migration-status rollup for a namespace (skew #3).
+ *
+ * Live: subscribes to the `GroupMigration` event family and re-reads on each
+ * frame. It re-READS rather than folding the event's counters in, because the
+ * rollup is recomputed from raw member rows and is the authoritative answer.
+ * `pollIntervalMs` stays as the fallback when SSE is unavailable, and when the
+ * caller names none it defaults to `DEFAULT_MIGRATION_POLL_INTERVAL_MS` for
+ * exactly as long as the stream is down - so the panel can never sit silently
+ * frozen with neither transport.
+ * Derived counters are null-safe before the first load.
  */
 declare function useMigrationStatus(namespaceId?: string | null, options?: {
     pollIntervalMs?: number;
@@ -687,6 +753,12 @@ declare function useMigrationStatus(namespaceId?: string | null, options?: {
     rollup: MigrationStatusRollup | null;
     members: MemberMigrationStatusEntry[];
     allMigrated: boolean;
+    /**
+     * When this node watched the fleet converge, or `null`. Durable, unlike
+     * `allMigrated`, which is recomputed from in-TTL heartbeats and lapses back
+     * to false when a member simply goes quiet.
+     */
+    fleetCompletedAt: number | null;
     membersPendingSignature: number;
     /** Members whose migrate aborted (migration-check failed or apply errored). */
     failed: number;
@@ -751,7 +823,6 @@ declare function useGroupAppVersion(groupId?: string): {
     applicationId: string | null;
     /** The installed blob differs from the one the group targets (see hook doc). */
     pendingApply: boolean;
-    upgradePolicy: string | null;
     /** Only populated via the group-info path; `null` in the namespace path. */
     activeUpgrade: GroupUpgradeStatusResponseData;
 };
@@ -847,4 +918,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, MigrationAdminPanel, type MigrationAdminPanelProps, MigrationPendingBanner, type MigrationPendingBannerProps, type ResolvedMeroTheme, type SetMetadataInput, type SubscriptionEventData, type SubscriptionInput, type UseEphemeralOptions, type UseEphemeralResult, clearAllStorage, clearApplicationId, clearContextId, clearContextIdentity, clearNodeUrl, clearTokenNodeUrl, cssVar, defaultMeroTheme, getApplicationId, getContextId, getContextIdentity, getNodeUrl, getTokenNodeUrl, localStorageTokenStorage, resolveMeroTheme, setApplicationId, setContextId, setContextIdentity, setNodeUrl, setTokenNodeUrl, themeToCssVars, useAddGroupMembers, useAppVersion, useApplicationContexts, useContextDiscovery, useContextGroup, useContexts, useCreateContext, useCreateGroupInNamespace, useCreateNamespace, useCreateNamespaceInvitation, useDefaultCapabilities, useDeleteContext, useDeleteGroup, useDeleteNamespace, useDetachContextFromGroup, useEphemeral, useExecute, useGroupAppVersion, useGroupCapabilities, useGroupContexts, useGroupInfo, useGroupInvitations, useGroupMembers, useGroupMetadata, useGroupUpgradeStatus, useInstallFromRegistry, useJoinContext, useJoinGroup, useJoinNamespace, useJoinSubgroupInheritance, useLatestVersion, useMemberMetadata, useMero, useMigrationStatus, useMyAuthoredMigration, useNamespace, useNamespaceGroups, useNamespaceIdentity, useNamespaces, useNamespacesForApplication, useRemoveGroupMembers, useReparentGroup, useResyncContext, useRetryGroupUpgrade, useSetContextMetadata, useSetDefaultCapabilities, useSetGroupMetadata, useSetMemberMetadata, useSetSubgroupVisibility, useSetTeeAdmissionPolicy, useSubgroupVisibility, useSubgroups, useSubscription, useSyncGroup, useUpdateMemberRole, useUpgradeGroup };
+export { type AppContext, AppMode, type ApplicationContextRecord, CalimeroLogo, type CalimeroLogoProps, ConnectButton, type ConnectButtonProps, ConnectionType, type ContextDiscoveryOptions, type ContextDiscoveryState, type CustomConnectionConfig, DEFAULT_MIGRATION_POLL_INTERVAL_MS, 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, type SubscriptionEventData, type SubscriptionInput, type UseEphemeralOptions, type UseEphemeralResult, clearAllStorage, clearApplicationId, clearContextId, clearContextIdentity, clearNodeUrl, clearTokenNodeUrl, cssVar, defaultMeroTheme, getApplicationId, getContextId, getContextIdentity, getNodeUrl, getTokenNodeUrl, localStorageTokenStorage, resolveMeroTheme, setApplicationId, setContextId, setContextIdentity, setNodeUrl, setTokenNodeUrl, themeToCssVars, useAddGroupMembers, useAppVersion, useApplicationContexts, useContextDiscovery, useContextGroup, useContexts, useCreateContext, useCreateGroupInNamespace, useCreateNamespace, useCreateNamespaceInvitation, useDefaultCapabilities, useDeleteContext, useDeleteGroup, useDeleteNamespace, useDetachContextFromGroup, useEphemeral, useExecute, useGroupAppVersion, useGroupCapabilities, useGroupContexts, useGroupInfo, useGroupInvitations, useGroupMembers, useGroupMetadata, useGroupUpgradeStatus, useInstallFromRegistry, useJoinContext, useJoinGroup, useJoinNamespace, useJoinSubgroupInheritance, useLatestVersion, useMemberMetadata, useMero, useMigrationEvents, useMigrationStatus, useMyAuthoredMigration, useNamespace, useNamespaceGroups, useNamespaceIdentity, useNamespaces, useNamespacesForApplication, useNodeIdentity, useRemoveGroupMembers, useReparentGroup, useResyncContext, useRetryGroupUpgrade, useSetContextMetadata, useSetDefaultCapabilities, useSetGroupMetadata, useSetMemberMetadata, useSetSubgroupVisibility, useSetTeeAdmissionPolicy, useSubgroupVisibility, useSubgroups, useSubscription, useSyncGroup, useUpdateMemberRole, useUpgradeGroup };

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 import React__default, { CSSProperties, ReactNode } from 'react';
 import * as _calimero_network_mero_js from '@calimero-network/mero-js';
-import { MeroJs, TokenStore, SetMetadataRequest, SseEventData, GroupMembershipEventData, GroupMigrationEventData, Codec, AddGroupMembersRequest, CreateContextRequest, CreateGroupInNamespaceRequest, CreateNamespaceRequest, CreateNamespaceInvitationRequest, CreateNamespaceInvitationResponseData, CreateRecursiveInvitationResponseData, DeleteGroupRequest, DeleteNamespaceRequest, DetachContextFromGroupRequest, GroupUpgradeStatusResponseData, GroupContextEntry, GroupInfo, CreateGroupInvitationRequest, MetadataRecord, JoinGroupRequest, JoinNamespaceRequest, MigrationStatus, MigrationStatusRollup, MemberMigrationStatusEntry, MigrateMyEntriesSummary, Namespace, SubgroupEntry, NamespaceIdentity, RemoveGroupMembersRequest, ReparentGroupRequest, ResyncContextRequest, RetryGroupUpgradeRequest, SetDefaultCapabilitiesRequest, SetSubgroupVisibilityRequest, SetTeeAdmissionPolicyRequest, SyncGroupRequest, UpdateMemberRoleRequest, UpgradeGroupRequest, TokenData } from '@calimero-network/mero-js';
+import { MeroJs, TokenStore, SetMetadataRequest, SseEventData, GroupMembershipEventData, GroupMigrationEventData, Codec, AddGroupMembersRequest, CreateContextRequest, CreateGroupInNamespaceRequest, CreateNamespaceRequest, CreateNamespaceInvitationRequest, CreateNamespaceInvitationResponseData, CreateRecursiveInvitationResponseData, DeleteGroupRequest, DeleteNamespaceRequest, DetachContextFromGroupRequest, GroupUpgradeStatusResponseData, GroupContextEntry, GroupInfo, CreateGroupInvitationRequest, MetadataRecord, JoinGroupRequest, JoinNamespaceRequest, MigrationStatus, MigrationStatusRollup, MemberMigrationStatusEntry, MigrateMyEntriesSummary, Namespace, SubgroupEntry, NamespaceIdentity, NodeIdentity, RemoveGroupMembersRequest, ReparentGroupRequest, ResyncContextRequest, RetryGroupUpgradeRequest, SetDefaultCapabilitiesRequest, SetSubgroupVisibilityRequest, SetTeeAdmissionPolicyRequest, SyncGroupRequest, UpdateMemberRoleRequest, UpgradeGroupRequest, TokenData } from '@calimero-network/mero-js';
 export * from '@calimero-network/mero-js';
 export { CAPABILITIES, Codec, DEFAULT_LOCAL_NODE_PORTS, DiscoverLocalNodesOptions, EphemeralClient, EphemeralEntry, MetadataRecord, discoverLocalNodes, hasCap, localNodeUrl, nodeEndpoint, probeNodeHealth, withCap, withoutCap } from '@calimero-network/mero-js';
 
@@ -447,6 +447,11 @@ declare function useJoinGroup(): {
     loading: boolean;
     error: Error | null;
 };
+/**
+ * Takes the member's ACCOUNT (64 hex), as `useGroupMembers` rows are keyed by
+ * and `useNodeIdentity().identity?.accountId` returns - NOT a signing key.
+ * Both are 32-byte strings, so passing a key names nobody and raises nothing.
+ */
 declare function useGroupCapabilities(groupId?: string | null, memberId?: string | null): {
     capabilities: number | null;
     loading: boolean;
@@ -497,11 +502,22 @@ declare function useSyncGroup(): {
     loading: boolean;
     error: Error | null;
 };
+/**
+ * Takes the invitee's signing KEY (bs58) - the one call on this resource that
+ * does, because someone being added may have no account here yet. Every other
+ * member call, including `useRemoveGroupMembers`, takes the ACCOUNT, so a value
+ * round-tripped from an add is the wrong one to remove with.
+ */
 declare function useAddGroupMembers(): {
     addGroupMembers: (groupId: string, request: AddGroupMembersRequest) => Promise<void | null>;
     loading: boolean;
     error: Error | null;
 };
+/**
+ * Takes the member's ACCOUNT (64 hex), as `useGroupMembers` rows are keyed by
+ * and `useNodeIdentity().identity?.accountId` returns - NOT a signing key.
+ * Both are 32-byte strings, so passing a key names nobody and raises nothing.
+ */
 declare function useRemoveGroupMembers(): {
     removeGroupMembers: (groupId: string, request: RemoveGroupMembersRequest) => Promise<void | null>;
     loading: boolean;
@@ -519,6 +535,24 @@ declare function useNamespace(namespaceId?: string | null): {
     error: Error | null;
     refetch: () => Promise<void>;
 };
+/**
+ * Who this node is: `accountId` is what member-addressing takes and what
+ * `useGroupMembers` rows are keyed by — `publicKey` is the signing key and
+ * addresses nobody. Both are 32-byte strings, so a swap fails silently.
+ */
+declare function useNodeIdentity(): {
+    identity: NodeIdentity | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * @deprecated Use {@link useNodeIdentity}. Identity is per-node, not
+ * per-namespace, and this no longer gates on participation: it answers for a
+ * namespace this node never joined, so `identity != null` is not "am I a
+ * member?" — ask `useNamespaces` for that. Its `publicKey` is the signing key,
+ * NOT the account member-addressing wants.
+ */
 declare function useNamespaceIdentity(namespaceId?: string | null): {
     identity: NamespaceIdentity | null;
     loading: boolean;
@@ -562,6 +596,11 @@ declare function useNamespaceGroups(namespaceId?: string | null): {
     error: Error | null;
     refetch: () => Promise<void>;
 };
+/**
+ * Takes the member's ACCOUNT (64 hex), as `useGroupMembers` rows are keyed by
+ * and `useNodeIdentity().identity?.accountId` returns - NOT a signing key.
+ * Both are 32-byte strings, so passing a key names nobody and raises nothing.
+ */
 declare function useUpdateMemberRole(): {
     updateMemberRole: (groupId: string, identity: string, request: UpdateMemberRoleRequest) => Promise<void | null>;
     loading: boolean;
@@ -599,6 +638,11 @@ declare function useSetGroupMetadata(): {
     loading: boolean;
     error: Error | null;
 };
+/**
+ * Takes the member's ACCOUNT (64 hex), as `useGroupMembers` rows are keyed by
+ * and `useNodeIdentity().identity?.accountId` returns - NOT a signing key.
+ * Both are 32-byte strings, so passing a key names nobody and raises nothing.
+ */
 declare function useSetMemberMetadata(): {
     setMemberMetadata: (groupId: string, identity: string, request: SetMetadataInput) => Promise<void | null>;
     loading: boolean;
@@ -676,9 +720,31 @@ declare function useDetachContextFromGroup(): {
     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.
+ * Subscribe to a namespace's `GroupMigration` events, invoking `onEvent` per
+ * frame and unsubscribing on unmount.
+ *
+ * A non-admin subscriber never sees `CascadeProgress`; core delivers that to
+ * namespace admins only, so a UI must not wait on it to decide progress.
+ */
+/**
+ * Fallback poll cadence for `useMigrationStatus` when the SSE stream is
+ * unavailable (no token, a proxy that buffers, an older node) and the caller
+ * named no interval of its own. Chosen to match the heartbeat cadence that
+ * migration facts actually arrive on; an explicit `pollIntervalMs` overrides it.
+ */
+declare const DEFAULT_MIGRATION_POLL_INTERVAL_MS = 5000;
+declare function useMigrationEvents(namespaceId: string | null | undefined, onEvent: (event: GroupMigrationEventData) => void): boolean;
+/**
+ * Migration-status rollup for a namespace (skew #3).
+ *
+ * Live: subscribes to the `GroupMigration` event family and re-reads on each
+ * frame. It re-READS rather than folding the event's counters in, because the
+ * rollup is recomputed from raw member rows and is the authoritative answer.
+ * `pollIntervalMs` stays as the fallback when SSE is unavailable, and when the
+ * caller names none it defaults to `DEFAULT_MIGRATION_POLL_INTERVAL_MS` for
+ * exactly as long as the stream is down - so the panel can never sit silently
+ * frozen with neither transport.
+ * Derived counters are null-safe before the first load.
  */
 declare function useMigrationStatus(namespaceId?: string | null, options?: {
     pollIntervalMs?: number;
@@ -687,6 +753,12 @@ declare function useMigrationStatus(namespaceId?: string | null, options?: {
     rollup: MigrationStatusRollup | null;
     members: MemberMigrationStatusEntry[];
     allMigrated: boolean;
+    /**
+     * When this node watched the fleet converge, or `null`. Durable, unlike
+     * `allMigrated`, which is recomputed from in-TTL heartbeats and lapses back
+     * to false when a member simply goes quiet.
+     */
+    fleetCompletedAt: number | null;
     membersPendingSignature: number;
     /** Members whose migrate aborted (migration-check failed or apply errored). */
     failed: number;
@@ -751,7 +823,6 @@ declare function useGroupAppVersion(groupId?: string): {
     applicationId: string | null;
     /** The installed blob differs from the one the group targets (see hook doc). */
     pendingApply: boolean;
-    upgradePolicy: string | null;
     /** Only populated via the group-info path; `null` in the namespace path. */
     activeUpgrade: GroupUpgradeStatusResponseData;
 };
@@ -847,4 +918,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, MigrationAdminPanel, type MigrationAdminPanelProps, MigrationPendingBanner, type MigrationPendingBannerProps, type ResolvedMeroTheme, type SetMetadataInput, type SubscriptionEventData, type SubscriptionInput, type UseEphemeralOptions, type UseEphemeralResult, clearAllStorage, clearApplicationId, clearContextId, clearContextIdentity, clearNodeUrl, clearTokenNodeUrl, cssVar, defaultMeroTheme, getApplicationId, getContextId, getContextIdentity, getNodeUrl, getTokenNodeUrl, localStorageTokenStorage, resolveMeroTheme, setApplicationId, setContextId, setContextIdentity, setNodeUrl, setTokenNodeUrl, themeToCssVars, useAddGroupMembers, useAppVersion, useApplicationContexts, useContextDiscovery, useContextGroup, useContexts, useCreateContext, useCreateGroupInNamespace, useCreateNamespace, useCreateNamespaceInvitation, useDefaultCapabilities, useDeleteContext, useDeleteGroup, useDeleteNamespace, useDetachContextFromGroup, useEphemeral, useExecute, useGroupAppVersion, useGroupCapabilities, useGroupContexts, useGroupInfo, useGroupInvitations, useGroupMembers, useGroupMetadata, useGroupUpgradeStatus, useInstallFromRegistry, useJoinContext, useJoinGroup, useJoinNamespace, useJoinSubgroupInheritance, useLatestVersion, useMemberMetadata, useMero, useMigrationStatus, useMyAuthoredMigration, useNamespace, useNamespaceGroups, useNamespaceIdentity, useNamespaces, useNamespacesForApplication, useRemoveGroupMembers, useReparentGroup, useResyncContext, useRetryGroupUpgrade, useSetContextMetadata, useSetDefaultCapabilities, useSetGroupMetadata, useSetMemberMetadata, useSetSubgroupVisibility, useSetTeeAdmissionPolicy, useSubgroupVisibility, useSubgroups, useSubscription, useSyncGroup, useUpdateMemberRole, useUpgradeGroup };
+export { type AppContext, AppMode, type ApplicationContextRecord, CalimeroLogo, type CalimeroLogoProps, ConnectButton, type ConnectButtonProps, ConnectionType, type ContextDiscoveryOptions, type ContextDiscoveryState, type CustomConnectionConfig, DEFAULT_MIGRATION_POLL_INTERVAL_MS, 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, type SubscriptionEventData, type SubscriptionInput, type UseEphemeralOptions, type UseEphemeralResult, clearAllStorage, clearApplicationId, clearContextId, clearContextIdentity, clearNodeUrl, clearTokenNodeUrl, cssVar, defaultMeroTheme, getApplicationId, getContextId, getContextIdentity, getNodeUrl, getTokenNodeUrl, localStorageTokenStorage, resolveMeroTheme, setApplicationId, setContextId, setContextIdentity, setNodeUrl, setTokenNodeUrl, themeToCssVars, useAddGroupMembers, useAppVersion, useApplicationContexts, useContextDiscovery, useContextGroup, useContexts, useCreateContext, useCreateGroupInNamespace, useCreateNamespace, useCreateNamespaceInvitation, useDefaultCapabilities, useDeleteContext, useDeleteGroup, useDeleteNamespace, useDetachContextFromGroup, useEphemeral, useExecute, useGroupAppVersion, useGroupCapabilities, useGroupContexts, useGroupInfo, useGroupInvitations, useGroupMembers, useGroupMetadata, useGroupUpgradeStatus, useInstallFromRegistry, useJoinContext, useJoinGroup, useJoinNamespace, useJoinSubgroupInheritance, useLatestVersion, useMemberMetadata, useMero, useMigrationEvents, useMigrationStatus, useMyAuthoredMigration, useNamespace, useNamespaceGroups, useNamespaceIdentity, useNamespaces, useNamespacesForApplication, useNodeIdentity, useRemoveGroupMembers, useReparentGroup, useResyncContext, useRetryGroupUpgrade, useSetContextMetadata, useSetDefaultCapabilities, useSetGroupMetadata, useSetMemberMetadata, useSetSubgroupVisibility, useSetTeeAdmissionPolicy, useSubgroupVisibility, useSubgroups, useSubscription, useSyncGroup, useUpdateMemberRole, useUpgradeGroup };

package/dist/index.js

@@ -328,6 +328,7 @@ function MeroProvider({
   const [contextId, setContextIdState] = useState(() => getContextId());
   const [contextIdentity, setContextIdentityState] = useState(() => getContextIdentity());
   const meroRef = useRef(null);
+  const recoveringRef = useRef(false);
   const callbackRef = useRef(void 0);
   if (callbackRef.current === void 0 && isBrowser) {
     callbackRef.current = parseAuthCallback(window.location.href);
@@ -351,12 +352,18 @@ function MeroProvider({
     async (instance) => {
       const accessToken = tokenStore.getTokens()?.access_token;
       if (!accessToken) return false;
-      try {
-        const { valid } = await instance.auth.validateToken(accessToken);
-        return valid;
-      } catch {
-        return false;
-      }
+      const validate = async (token) => {
+        try {
+          const { valid } = await instance.auth.validateToken(token);
+          return valid;
+        } catch {
+          return false;
+        }
+      };
+      if (await validate(accessToken)) return true;
+      const rotated = tokenStore.getTokens()?.access_token;
+      if (!rotated || rotated === accessToken) return false;
+      return validate(rotated);
     },
     [tokenStore]
   );
@@ -483,9 +490,23 @@ function MeroProvider({
     const onError = (err) => {
       if (!active) return;
       setIsOnline(false);
-      if (err.message.includes("401")) {
-        logout();
-      }
+      if (!err.message.includes("401")) return;
+      if (recoveringRef.current) return;
+      recoveringRef.current = true;
+      void (async () => {
+        try {
+          const instance = meroRef.current;
+          if (!instance) return;
+          if (await checkAuth(instance)) {
+            if (active) await instance.events.connect().catch(() => {
+            });
+            return;
+          }
+          if (active) logout();
+        } finally {
+          recoveringRef.current = false;
+        }
+      })();
     };
     sse.on("connect", onConnect);
     sse.on("error", onError);
@@ -497,7 +518,7 @@ function MeroProvider({
       sse.off("connect", onConnect);
       sse.off("error", onError);
     };
-  }, [isAuthenticated, mero]);
+  }, [isAuthenticated, mero, checkAuth, logout]);
   const contextValue = useMemo(
     () => ({
       mero,
@@ -1990,6 +2011,15 @@ function useNamespace(namespaceId) {
   );
   return { namespace: data, loading, error, refetch };
 }
+function useNodeIdentity() {
+  const { mero } = useMero();
+  const { data, loading, error, refetch } = useAsyncResource(
+    mero ? () => mero.admin.getNodeIdentity() : null,
+    null,
+    [mero]
+  );
+  return { identity: data, loading, error, refetch };
+}
 function useNamespaceIdentity(namespaceId) {
   const { mero } = useMero();
   const { data, loading, error, refetch } = useAsyncResource(
@@ -2359,6 +2389,35 @@ function useDetachContextFromGroup() {
   );
   return { detachContextFromGroup, loading, error };
 }
+var DEFAULT_MIGRATION_POLL_INTERVAL_MS = 5e3;
+function useMigrationEvents(namespaceId, onEvent) {
+  const { mero } = useMero();
+  const mountedRef = useMountedRef();
+  const [live, setLive] = useState(false);
+  const handlerRef = useRef(onEvent);
+  handlerRef.current = onEvent;
+  useEffect(() => {
+    if (!mero || !namespaceId) return;
+    const sse = mero.events;
+    const unsubscribe = sse.onMigrationEvent((event) => handlerRef.current(event));
+    let cancelled = false;
+    void (async () => {
+      try {
+        await sse.connect();
+        await sse.subscribe({ groupIds: [namespaceId] });
+        if (!cancelled && mountedRef.current) setLive(true);
+      } catch {
+        if (!cancelled && mountedRef.current) setLive(false);
+      }
+    })();
+    return () => {
+      cancelled = true;
+      if (mountedRef.current) setLive(false);
+      unsubscribe();
+    };
+  }, [mero, namespaceId, mountedRef]);
+  return live;
+}
 function useMigrationStatus(namespaceId, options) {
   const { mero } = useMero();
   const [status, setStatus] = useState(null);
@@ -2403,7 +2462,8 @@ function useMigrationStatus(namespaceId, options) {
   useEffect(() => {
     void refetch();
   }, [refetch]);
-  const pollIntervalMs = options?.pollIntervalMs;
+  const sseLive = useMigrationEvents(namespaceId, () => void refetch());
+  const pollIntervalMs = options?.pollIntervalMs ?? (sseLive ? void 0 : DEFAULT_MIGRATION_POLL_INTERVAL_MS);
   useEffect(() => {
     if (!pollIntervalMs || !mero || !namespaceId) return;
     const handle = setInterval(() => void refetch(), pollIntervalMs);
@@ -2416,6 +2476,12 @@ function useMigrationStatus(namespaceId, options) {
     rollup,
     members,
     allMigrated: rollup?.allMigrated ?? false,
+    /**
+     * When this node watched the fleet converge, or `null`. Durable, unlike
+     * `allMigrated`, which is recomputed from in-TTL heartbeats and lapses back
+     * to false when a member simply goes quiet.
+     */
+    fleetCompletedAt: status?.fleetCompletedAt ?? null,
     membersPendingSignature: rollup?.membersPendingSignature ?? 0,
     /** Members whose migrate aborted (migration-check failed or apply errored). */
     failed: rollup?.failed ?? 0,
@@ -2535,7 +2601,6 @@ var EMPTY_GROUP_APP_VERSION = {
   version: null,
   applicationId: null,
   pendingApply: false,
-  upgradePolicy: null,
   activeUpgrade: null
 };
 function isZeroAppKey(appKey) {
@@ -2567,17 +2632,14 @@ function useGroupAppVersion(groupId) {
       const namespace = namespaces.find((entry) => entry.namespaceId === groupId);
       let appKey;
       let applicationId;
-      let upgradePolicy;
       let activeUpgrade = null;
       if (namespace) {
         appKey = namespace.appKey;
         applicationId = namespace.targetApplicationId;
-        upgradePolicy = namespace.upgradePolicy ?? null;
       } else {
         const info = await mero.admin.getGroupInfo(groupId);
         appKey = info.appKey;
         applicationId = info.targetApplicationId;
-        upgradePolicy = info.upgradePolicy ?? null;
         activeUpgrade = info.activeUpgrade ?? null;
       }
       let version = null;
@@ -2591,7 +2653,7 @@ function useGroupAppVersion(groupId) {
         }
       }
       if (mountedRef.current && seq === reqRef.current) {
-        setData({ version, applicationId, pendingApply, upgradePolicy, activeUpgrade });
+        setData({ version, applicationId, pendingApply, activeUpgrade });
       }
     } catch (err) {
       const errorValue = toError(err);
@@ -2762,6 +2824,6 @@ function MigrationAdminPanel({ namespaceId, pollIntervalMs, className }) {
   ] });
 }
 
-export { AppMode, CalimeroLogo, ConnectButton, ConnectionType, LoginModal, MERO_CSS_VARS, MeroContext, MeroProvider, MigrationAdminPanel, MigrationPendingBanner, clearAllStorage, clearApplicationId, clearContextId, clearContextIdentity, clearNodeUrl, clearTokenNodeUrl, cssVar, defaultMeroTheme, getApplicationId, getContextId, getContextIdentity, getNodeUrl, getTokenNodeUrl, localStorageTokenStorage, resolveMeroTheme, setApplicationId, setContextId, setContextIdentity, setNodeUrl, setTokenNodeUrl, themeToCssVars, useAddGroupMembers, useAppVersion, useApplicationContexts, useContextDiscovery, useContextGroup, useContexts, useCreateContext, useCreateGroupInNamespace, useCreateNamespace, useCreateNamespaceInvitation, useDefaultCapabilities, useDeleteContext, useDeleteGroup, useDeleteNamespace, useDetachContextFromGroup, useEphemeral, useExecute, useGroupAppVersion, useGroupCapabilities, useGroupContexts, useGroupInfo, useGroupInvitations, useGroupMembers, useGroupMetadata, useGroupUpgradeStatus, useInstallFromRegistry, useJoinContext, useJoinGroup, useJoinNamespace, useJoinSubgroupInheritance, useLatestVersion, useMemberMetadata, useMero, useMigrationStatus, useMyAuthoredMigration, useNamespace, useNamespaceGroups, useNamespaceIdentity, useNamespaces, useNamespacesForApplication, useRemoveGroupMembers, useReparentGroup, useResyncContext, useRetryGroupUpgrade, useSetContextMetadata, useSetDefaultCapabilities, useSetGroupMetadata, useSetMemberMetadata, useSetSubgroupVisibility, useSetTeeAdmissionPolicy, useSubgroupVisibility, useSubgroups, useSubscription, useSyncGroup, useUpdateMemberRole, useUpgradeGroup };
+export { AppMode, CalimeroLogo, ConnectButton, ConnectionType, DEFAULT_MIGRATION_POLL_INTERVAL_MS, LoginModal, MERO_CSS_VARS, MeroContext, MeroProvider, MigrationAdminPanel, MigrationPendingBanner, clearAllStorage, clearApplicationId, clearContextId, clearContextIdentity, clearNodeUrl, clearTokenNodeUrl, cssVar, defaultMeroTheme, getApplicationId, getContextId, getContextIdentity, getNodeUrl, getTokenNodeUrl, localStorageTokenStorage, resolveMeroTheme, setApplicationId, setContextId, setContextIdentity, setNodeUrl, setTokenNodeUrl, themeToCssVars, useAddGroupMembers, useAppVersion, useApplicationContexts, useContextDiscovery, useContextGroup, useContexts, useCreateContext, useCreateGroupInNamespace, useCreateNamespace, useCreateNamespaceInvitation, useDefaultCapabilities, useDeleteContext, useDeleteGroup, useDeleteNamespace, useDetachContextFromGroup, useEphemeral, useExecute, useGroupAppVersion, useGroupCapabilities, useGroupContexts, useGroupInfo, useGroupInvitations, useGroupMembers, useGroupMetadata, useGroupUpgradeStatus, useInstallFromRegistry, useJoinContext, useJoinGroup, useJoinNamespace, useJoinSubgroupInheritance, useLatestVersion, useMemberMetadata, useMero, useMigrationEvents, useMigrationStatus, useMyAuthoredMigration, useNamespace, useNamespaceGroups, useNamespaceIdentity, useNamespaces, useNamespacesForApplication, useNodeIdentity, useRemoveGroupMembers, useReparentGroup, useResyncContext, useRetryGroupUpgrade, useSetContextMetadata, useSetDefaultCapabilities, useSetGroupMetadata, useSetMemberMetadata, useSetSubgroupVisibility, useSetTeeAdmissionPolicy, useSubgroupVisibility, useSubgroups, useSubscription, useSyncGroup, useUpdateMemberRole, useUpgradeGroup };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map