@calimero-network/mero-react 4.4.1 → 4.6.0

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, AddGroupMembersRequest, CreateContextRequest, CreateGroupInNamespaceRequest, CreateNamespaceRequest, CreateNamespaceInvitationRequest, CreateNamespaceInvitationResponseData, CreateRecursiveInvitationResponseData, DeleteGroupRequest, DeleteNamespaceRequest, DetachContextFromGroupRequest, GroupContextEntry, GroupInfo, CreateGroupInvitationRequest, MetadataRecord, GroupUpgradeStatusResponseData, JoinGroupRequest, JoinNamespaceRequest, MigrationStatus, MigrationStatusRollup, MemberMigrationStatusEntry, MigrateMyEntriesSummary, Namespace, SubgroupEntry, NamespaceIdentity, RegisterGroupSigningKeyRequest, RemoveGroupMembersRequest, ReparentGroupRequest, ResyncContextRequest, RetryGroupUpgradeRequest, SetDefaultCapabilitiesRequest, SetSubgroupVisibilityRequest, SetTeeAdmissionPolicyRequest, SseEventData, SyncGroupRequest, UpdateGroupSettingsRequest, UpdateMemberRoleRequest, UpgradeGroupRequest, TokenData } from '@calimero-network/mero-js';
+import { MeroJs, TokenStore, SetMetadataRequest, SseEventData, GroupMembershipEventData, AddGroupMembersRequest, CreateContextRequest, CreateGroupInNamespaceRequest, CreateNamespaceRequest, CreateNamespaceInvitationRequest, CreateNamespaceInvitationResponseData, CreateRecursiveInvitationResponseData, DeleteGroupRequest, DeleteNamespaceRequest, DetachContextFromGroupRequest, GroupUpgradeStatusResponseData, GroupContextEntry, GroupInfo, CreateGroupInvitationRequest, MetadataRecord, JoinGroupRequest, JoinNamespaceRequest, MigrationStatus, MigrationStatusRollup, MemberMigrationStatusEntry, MigrateMyEntriesSummary, Namespace, SubgroupEntry, NamespaceIdentity, RegisterGroupSigningKeyRequest, RemoveGroupMembersRequest, ReparentGroupRequest, ResyncContextRequest, RetryGroupUpgradeRequest, SetDefaultCapabilitiesRequest, SetSubgroupVisibilityRequest, SetTeeAdmissionPolicyRequest, SyncGroupRequest, 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';
 
@@ -400,12 +400,20 @@ declare function useExecute(contextId: string | null, executorId: string | null)
     loading: boolean;
     error: Error | null;
 };
+/** Event payload delivered to a `useSubscription` callback. */
+type SubscriptionEventData = SseEventData | GroupMembershipEventData;
+/** Ids to subscribe to. Either can be omitted, but not both. */
+interface SubscriptionInput {
+    contextIds?: string[];
+    groupIds?: string[];
+}
 /**
- * Subscribe to SSE events for context IDs.
+ * Subscribe to SSE events for context and/or group IDs.
  * StrictMode-safe: tracks the SseClient instance in a ref to avoid
  * double-connect on mount/unmount/remount cycles.
  */
-declare function useSubscription(contextIds: string[], callback: (event: SseEventData) => void): void;
+declare function useSubscription(contextIds: string[], callback: (event: SubscriptionEventData) => void): void;
+declare function useSubscription(input: SubscriptionInput, callback: (event: SubscriptionEventData) => void): void;
 /**
  * Fetch contexts for the current node, optionally filtered by application ID.
  */
@@ -633,6 +641,17 @@ declare function useUpgradeGroup(): {
     loading: boolean;
     error: Error | null;
 };
+/**
+ * Install a registry package version onto the node — the discrete "Download"
+ * step an Updates flow runs before an `upgradeGroup`. Resolves the installed
+ * application id (`InstallApplicationResponseData`). Downloading does not by
+ * itself change what any group runs; pair it with a subsequent upgrade.
+ */
+declare function useInstallFromRegistry(): {
+    installFromRegistry: (registryUrl: string, packageName: string, version: string) => Promise<_calimero_network_mero_js.InstallApplicationResponseData | null>;
+    loading: boolean;
+    error: Error | null;
+};
 /**
  * Kick off a full state re-pull for a context — operator recovery for a
  * context stranded mid-sync. `force` re-pulls even when the node does not
@@ -722,6 +741,35 @@ declare function useLatestVersion(registryUrl?: string | null, packageName?: str
     error: Error | null;
     refetch: () => Promise<void>;
 };
+/**
+ * What app version does this group run, and is there a downloaded-but-not-yet-
+ * applied update? Replaces the appKey-vs-installed-blob comparison apps
+ * otherwise hand-roll: `pendingApply` is true when the group's `appKey` (the
+ * blob it targets) is present, non-zero, and differs from the blob actually
+ * installed for its `targetApplicationId`. Deciding whether to render or gate on
+ * that status (admin-only actions, etc.) is the call site's job.
+ *
+ * Resolution stays cheap: the group's record comes from `listNamespaces()` when
+ * the id is a namespace, else from `getGroupInfo()`; `getApplication()` then
+ * reads the installed version and blob. `activeUpgrade` is returned only when it
+ * arrives for free on the group-info path (it is not fetched separately).
+ * Subscribes to `AppVersionChanged` and refetches, since any version flip in the
+ * workspace can make the rollup stale.
+ */
+declare function useGroupAppVersion(groupId?: string): {
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+    /** Semver of the application the group currently targets (`null` until loaded). */
+    version: string | null;
+    /** The group's `targetApplicationId`. */
+    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;
+};
 /**
  * The caller's own identity-gated entries pending re-signature (skew #1).
  * `pending` is `pendingCount > 0` (from `count_my_pending`); `authorize()` runs
@@ -814,4 +862,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, DEFAULT_LOCAL_NODE_PORTS, type DiscoverLocalNodesOptions, 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, clearTokenNodeUrl, cssVar, defaultMeroTheme, discoverLocalNodes, getApplicationId, getContextId, getContextIdentity, getNodeUrl, getTokenNodeUrl, localNodeUrl, localStorageTokenStorage, nodeEndpoint, probeNodeHealth, resolveMeroTheme, setApplicationId, setContextId, setContextIdentity, setNodeUrl, setTokenNodeUrl, 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, useRegisterGroupSigningKey, useRemoveGroupMembers, useReparentGroup, useResyncContext, useRetryGroupUpgrade, useSetContextMetadata, useSetDefaultCapabilities, useSetGroupMetadata, useSetMemberMetadata, useSetSubgroupVisibility, useSetTeeAdmissionPolicy, useSubgroupVisibility, useSubgroups, useSubscription, useSyncGroup, useUpdateGroupSettings, useUpdateMemberRole, useUpgradeGroup };
+export { type AppContext, AppMode, type ApplicationContextRecord, CalimeroLogo, type CalimeroLogoProps, ConnectButton, type ConnectButtonProps, ConnectionType, type ContextDiscoveryOptions, type ContextDiscoveryState, type CustomConnectionConfig, DEFAULT_LOCAL_NODE_PORTS, type DiscoverLocalNodesOptions, 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, clearAllStorage, clearApplicationId, clearContextId, clearContextIdentity, clearNodeUrl, clearTokenNodeUrl, cssVar, defaultMeroTheme, discoverLocalNodes, getApplicationId, getContextId, getContextIdentity, getNodeUrl, getTokenNodeUrl, localNodeUrl, localStorageTokenStorage, nodeEndpoint, probeNodeHealth, resolveMeroTheme, setApplicationId, setContextId, setContextIdentity, setNodeUrl, setTokenNodeUrl, themeToCssVars, useAddGroupMembers, useAppVersion, useApplicationContexts, useContextDiscovery, useContextGroup, useContexts, useCreateContext, useCreateGroupInNamespace, useCreateNamespace, useCreateNamespaceInvitation, useDefaultCapabilities, useDeleteContext, useDeleteGroup, useDeleteNamespace, useDetachContextFromGroup, useExecute, useGroupAppVersion, useGroupCapabilities, useGroupContexts, useGroupInfo, useGroupInvitations, useGroupMembers, useGroupMetadata, useGroupUpgradeStatus, useInstallFromRegistry, useJoinContext, useJoinGroup, useJoinNamespace, useJoinSubgroupInheritance, useLatestVersion, useMemberMetadata, useMero, useMigrationStatus, useMyAuthoredMigration, useNamespace, useNamespaceGroups, useNamespaceIdentity, useNamespaces, useNamespacesForApplication, useRegisterGroupSigningKey, useRemoveGroupMembers, useReparentGroup, useResyncContext, useRetryGroupUpgrade, useSetContextMetadata, useSetDefaultCapabilities, useSetGroupMetadata, useSetMemberMetadata, useSetSubgroupVisibility, useSetTeeAdmissionPolicy, useSubgroupVisibility, useSubgroups, useSubscription, useSyncGroup, useUpdateGroupSettings, 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, AddGroupMembersRequest, CreateContextRequest, CreateGroupInNamespaceRequest, CreateNamespaceRequest, CreateNamespaceInvitationRequest, CreateNamespaceInvitationResponseData, CreateRecursiveInvitationResponseData, DeleteGroupRequest, DeleteNamespaceRequest, DetachContextFromGroupRequest, GroupContextEntry, GroupInfo, CreateGroupInvitationRequest, MetadataRecord, GroupUpgradeStatusResponseData, JoinGroupRequest, JoinNamespaceRequest, MigrationStatus, MigrationStatusRollup, MemberMigrationStatusEntry, MigrateMyEntriesSummary, Namespace, SubgroupEntry, NamespaceIdentity, RegisterGroupSigningKeyRequest, RemoveGroupMembersRequest, ReparentGroupRequest, ResyncContextRequest, RetryGroupUpgradeRequest, SetDefaultCapabilitiesRequest, SetSubgroupVisibilityRequest, SetTeeAdmissionPolicyRequest, SseEventData, SyncGroupRequest, UpdateGroupSettingsRequest, UpdateMemberRoleRequest, UpgradeGroupRequest, TokenData } from '@calimero-network/mero-js';
+import { MeroJs, TokenStore, SetMetadataRequest, SseEventData, GroupMembershipEventData, AddGroupMembersRequest, CreateContextRequest, CreateGroupInNamespaceRequest, CreateNamespaceRequest, CreateNamespaceInvitationRequest, CreateNamespaceInvitationResponseData, CreateRecursiveInvitationResponseData, DeleteGroupRequest, DeleteNamespaceRequest, DetachContextFromGroupRequest, GroupUpgradeStatusResponseData, GroupContextEntry, GroupInfo, CreateGroupInvitationRequest, MetadataRecord, JoinGroupRequest, JoinNamespaceRequest, MigrationStatus, MigrationStatusRollup, MemberMigrationStatusEntry, MigrateMyEntriesSummary, Namespace, SubgroupEntry, NamespaceIdentity, RegisterGroupSigningKeyRequest, RemoveGroupMembersRequest, ReparentGroupRequest, ResyncContextRequest, RetryGroupUpgradeRequest, SetDefaultCapabilitiesRequest, SetSubgroupVisibilityRequest, SetTeeAdmissionPolicyRequest, SyncGroupRequest, 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';
 
@@ -400,12 +400,20 @@ declare function useExecute(contextId: string | null, executorId: string | null)
     loading: boolean;
     error: Error | null;
 };
+/** Event payload delivered to a `useSubscription` callback. */
+type SubscriptionEventData = SseEventData | GroupMembershipEventData;
+/** Ids to subscribe to. Either can be omitted, but not both. */
+interface SubscriptionInput {
+    contextIds?: string[];
+    groupIds?: string[];
+}
 /**
- * Subscribe to SSE events for context IDs.
+ * Subscribe to SSE events for context and/or group IDs.
  * StrictMode-safe: tracks the SseClient instance in a ref to avoid
  * double-connect on mount/unmount/remount cycles.
  */
-declare function useSubscription(contextIds: string[], callback: (event: SseEventData) => void): void;
+declare function useSubscription(contextIds: string[], callback: (event: SubscriptionEventData) => void): void;
+declare function useSubscription(input: SubscriptionInput, callback: (event: SubscriptionEventData) => void): void;
 /**
  * Fetch contexts for the current node, optionally filtered by application ID.
  */
@@ -633,6 +641,17 @@ declare function useUpgradeGroup(): {
     loading: boolean;
     error: Error | null;
 };
+/**
+ * Install a registry package version onto the node — the discrete "Download"
+ * step an Updates flow runs before an `upgradeGroup`. Resolves the installed
+ * application id (`InstallApplicationResponseData`). Downloading does not by
+ * itself change what any group runs; pair it with a subsequent upgrade.
+ */
+declare function useInstallFromRegistry(): {
+    installFromRegistry: (registryUrl: string, packageName: string, version: string) => Promise<_calimero_network_mero_js.InstallApplicationResponseData | null>;
+    loading: boolean;
+    error: Error | null;
+};
 /**
  * Kick off a full state re-pull for a context — operator recovery for a
  * context stranded mid-sync. `force` re-pulls even when the node does not
@@ -722,6 +741,35 @@ declare function useLatestVersion(registryUrl?: string | null, packageName?: str
     error: Error | null;
     refetch: () => Promise<void>;
 };
+/**
+ * What app version does this group run, and is there a downloaded-but-not-yet-
+ * applied update? Replaces the appKey-vs-installed-blob comparison apps
+ * otherwise hand-roll: `pendingApply` is true when the group's `appKey` (the
+ * blob it targets) is present, non-zero, and differs from the blob actually
+ * installed for its `targetApplicationId`. Deciding whether to render or gate on
+ * that status (admin-only actions, etc.) is the call site's job.
+ *
+ * Resolution stays cheap: the group's record comes from `listNamespaces()` when
+ * the id is a namespace, else from `getGroupInfo()`; `getApplication()` then
+ * reads the installed version and blob. `activeUpgrade` is returned only when it
+ * arrives for free on the group-info path (it is not fetched separately).
+ * Subscribes to `AppVersionChanged` and refetches, since any version flip in the
+ * workspace can make the rollup stale.
+ */
+declare function useGroupAppVersion(groupId?: string): {
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+    /** Semver of the application the group currently targets (`null` until loaded). */
+    version: string | null;
+    /** The group's `targetApplicationId`. */
+    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;
+};
 /**
  * The caller's own identity-gated entries pending re-signature (skew #1).
  * `pending` is `pendingCount > 0` (from `count_my_pending`); `authorize()` runs
@@ -814,4 +862,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, DEFAULT_LOCAL_NODE_PORTS, type DiscoverLocalNodesOptions, 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, clearTokenNodeUrl, cssVar, defaultMeroTheme, discoverLocalNodes, getApplicationId, getContextId, getContextIdentity, getNodeUrl, getTokenNodeUrl, localNodeUrl, localStorageTokenStorage, nodeEndpoint, probeNodeHealth, resolveMeroTheme, setApplicationId, setContextId, setContextIdentity, setNodeUrl, setTokenNodeUrl, 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, useRegisterGroupSigningKey, useRemoveGroupMembers, useReparentGroup, useResyncContext, useRetryGroupUpgrade, useSetContextMetadata, useSetDefaultCapabilities, useSetGroupMetadata, useSetMemberMetadata, useSetSubgroupVisibility, useSetTeeAdmissionPolicy, useSubgroupVisibility, useSubgroups, useSubscription, useSyncGroup, useUpdateGroupSettings, useUpdateMemberRole, useUpgradeGroup };
+export { type AppContext, AppMode, type ApplicationContextRecord, CalimeroLogo, type CalimeroLogoProps, ConnectButton, type ConnectButtonProps, ConnectionType, type ContextDiscoveryOptions, type ContextDiscoveryState, type CustomConnectionConfig, DEFAULT_LOCAL_NODE_PORTS, type DiscoverLocalNodesOptions, 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, clearAllStorage, clearApplicationId, clearContextId, clearContextIdentity, clearNodeUrl, clearTokenNodeUrl, cssVar, defaultMeroTheme, discoverLocalNodes, getApplicationId, getContextId, getContextIdentity, getNodeUrl, getTokenNodeUrl, localNodeUrl, localStorageTokenStorage, nodeEndpoint, probeNodeHealth, resolveMeroTheme, setApplicationId, setContextId, setContextIdentity, setNodeUrl, setTokenNodeUrl, themeToCssVars, useAddGroupMembers, useAppVersion, useApplicationContexts, useContextDiscovery, useContextGroup, useContexts, useCreateContext, useCreateGroupInNamespace, useCreateNamespace, useCreateNamespaceInvitation, useDefaultCapabilities, useDeleteContext, useDeleteGroup, useDeleteNamespace, useDetachContextFromGroup, useExecute, useGroupAppVersion, useGroupCapabilities, useGroupContexts, useGroupInfo, useGroupInvitations, useGroupMembers, useGroupMetadata, useGroupUpgradeStatus, useInstallFromRegistry, useJoinContext, useJoinGroup, useJoinNamespace, useJoinSubgroupInheritance, useLatestVersion, useMemberMetadata, useMero, useMigrationStatus, useMyAuthoredMigration, useNamespace, useNamespaceGroups, useNamespaceIdentity, useNamespaces, useNamespacesForApplication, useRegisterGroupSigningKey, useRemoveGroupMembers, useReparentGroup, useResyncContext, useRetryGroupUpgrade, useSetContextMetadata, useSetDefaultCapabilities, useSetGroupMetadata, useSetMemberMetadata, useSetSubgroupVisibility, useSetTeeAdmissionPolicy, useSubgroupVisibility, useSubgroups, useSubscription, useSyncGroup, useUpdateGroupSettings, useUpdateMemberRole, useUpgradeGroup };

package/dist/index.js

@@ -1296,6 +1296,29 @@ function ConnectButton({
     }
   );
 }
+
+// src/utils/base58.ts
+var ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+function base58ToHex(input) {
+  const bytes = [];
+  for (const char of input) {
+    let carry = ALPHABET.indexOf(char);
+    if (carry === -1) throw new Error(`invalid base58 character: ${char}`);
+    for (let i = 0; i < bytes.length; i++) {
+      carry += bytes[i] * 58;
+      bytes[i] = carry & 255;
+      carry >>= 8;
+    }
+    while (carry > 0) {
+      bytes.push(carry & 255);
+      carry >>= 8;
+    }
+  }
+  for (let k = 0; k < input.length && input[k] === "1"; k++) bytes.push(0);
+  return bytes.reverse().map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+
+// src/hooks/index.ts
 function toError(err) {
   return err instanceof Error ? err : new Error(String(err));
 }
@@ -1447,13 +1470,15 @@ function useExecute(contextId, executorId) {
   );
   return { execute, loading, error };
 }
-function useSubscription(contextIds, callback) {
+function useSubscription(input, callback) {
   const { mero } = useMero();
   const callbackRef = useRef(callback);
   callbackRef.current = callback;
+  const { contextIds = [], groupIds = [] } = Array.isArray(input) ? { contextIds: input, groupIds: [] } : input;
   const contextIdsKey = JSON.stringify(contextIds);
+  const groupIdsKey = JSON.stringify(groupIds);
   useEffect(() => {
-    if (!mero || contextIds.length === 0) return;
+    if (!mero || contextIds.length === 0 && groupIds.length === 0) return;
     const sse = mero.events;
     const handler = (event) => {
       callbackRef.current(event);
@@ -1461,12 +1486,12 @@ function useSubscription(contextIds, callback) {
     sse.on("event", handler);
     sse.connect().catch(() => {
     });
-    sse.subscribe(contextIds).catch(() => {
+    sse.subscribe({ contextIds, groupIds }).catch(() => {
     });
     return () => {
       sse.off("event", handler);
     };
-  }, [mero, contextIdsKey]);
+  }, [mero, contextIdsKey, groupIdsKey]);
 }
 function useContexts(applicationId) {
   const { mero } = useMero();
@@ -2117,6 +2142,18 @@ function useUpgradeGroup() {
   );
   return { upgradeGroup, loading, error };
 }
+function useInstallFromRegistry() {
+  const { mero } = useMero();
+  const { loading, error, run } = useAsyncMutation();
+  const installFromRegistry = useCallback(
+    async (registryUrl, packageName, version) => {
+      if (!mero) return null;
+      return run(() => mero.admin.installFromRegistry(registryUrl, packageName, version));
+    },
+    [mero, run]
+  );
+  return { installFromRegistry, loading, error };
+}
 function useResyncContext() {
   const { mero } = useMero();
   const { loading, error, run } = useAsyncMutation();
@@ -2393,6 +2430,96 @@ function useLatestVersion(registryUrl, packageName, currentVersion) {
   const updateAvailable = latestVersion != null && currentVersion != null && compareSemver(latestVersion, currentVersion) > 0;
   return { versions, latestVersion, currentVersion, updateAvailable, loading, error, refetch };
 }
+var EMPTY_GROUP_APP_VERSION = {
+  version: null,
+  applicationId: null,
+  pendingApply: false,
+  upgradePolicy: null,
+  activeUpgrade: null
+};
+function isZeroAppKey(appKey) {
+  return !appKey || /^0+$/.test(appKey);
+}
+function useGroupAppVersion(groupId) {
+  const { mero } = useMero();
+  const [data, setData] = useState(EMPTY_GROUP_APP_VERSION);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const mountedRef = useMountedRef();
+  const reqRef = useRef(0);
+  const refetch = useCallback(async () => {
+    const seq = ++reqRef.current;
+    if (!mero || !groupId) {
+      if (mountedRef.current) {
+        setData(EMPTY_GROUP_APP_VERSION);
+        setError(null);
+        setLoading(false);
+      }
+      return;
+    }
+    if (mountedRef.current) {
+      setLoading(true);
+      setError(null);
+    }
+    try {
+      const namespaces = await mero.admin.listNamespaces();
+      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;
+      } else {
+        const info = await mero.admin.getGroupInfo(groupId);
+        appKey = info.appKey;
+        applicationId = info.targetApplicationId;
+        upgradePolicy = info.upgradePolicy;
+        activeUpgrade = info.activeUpgrade ?? null;
+      }
+      let version = null;
+      let pendingApply = false;
+      if (applicationId) {
+        const { application } = await mero.admin.getApplication(applicationId);
+        version = application?.version ?? null;
+        if (application && !isZeroAppKey(appKey)) {
+          const installedHex = base58ToHex(application.blob.bytecode).toLowerCase();
+          pendingApply = appKey.toLowerCase() !== installedHex;
+        }
+      }
+      if (mountedRef.current && seq === reqRef.current) {
+        setData({ version, applicationId, pendingApply, upgradePolicy, activeUpgrade });
+      }
+    } catch (err) {
+      const errorValue = toError(err);
+      if (mountedRef.current && seq === reqRef.current) {
+        setError(errorValue);
+      }
+    } finally {
+      if (mountedRef.current && seq === reqRef.current) {
+        setLoading(false);
+      }
+    }
+  }, [groupId, mero, mountedRef]);
+  useEffect(() => {
+    reqRef.current += 1;
+    setData(EMPTY_GROUP_APP_VERSION);
+    setError(null);
+  }, [groupId]);
+  useEffect(() => {
+    void refetch();
+  }, [refetch]);
+  useEffect(() => {
+    if (!mero?.events || !groupId) return;
+    const off = mero.events.onAppVersionChanged(() => {
+      if (mountedRef.current) void refetch();
+    });
+    return off;
+  }, [mero, groupId, refetch, mountedRef]);
+  return { ...data, loading, error, refetch };
+}
 function useMyAuthoredMigration(contextId) {
   const { mero } = useMero();
   const [summary, setSummary] = useState(null);
@@ -2534,6 +2661,6 @@ function MigrationAdminPanel({ namespaceId, pollIntervalMs, className }) {
   ] });
 }
 
-export { AppMode, CalimeroLogo, ConnectButton, ConnectionType, DEFAULT_LOCAL_NODE_PORTS, LoginModal, MERO_CSS_VARS, MeroContext, MeroProvider, MigrationAdminPanel, MigrationPendingBanner, clearAllStorage, clearApplicationId, clearContextId, clearContextIdentity, clearNodeUrl, clearTokenNodeUrl, cssVar, defaultMeroTheme, discoverLocalNodes, getApplicationId, getContextId, getContextIdentity, getNodeUrl, getTokenNodeUrl, localNodeUrl, localStorageTokenStorage, nodeEndpoint, probeNodeHealth, resolveMeroTheme, setApplicationId, setContextId, setContextIdentity, setNodeUrl, setTokenNodeUrl, 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, useRegisterGroupSigningKey, useRemoveGroupMembers, useReparentGroup, useResyncContext, useRetryGroupUpgrade, useSetContextMetadata, useSetDefaultCapabilities, useSetGroupMetadata, useSetMemberMetadata, useSetSubgroupVisibility, useSetTeeAdmissionPolicy, useSubgroupVisibility, useSubgroups, useSubscription, useSyncGroup, useUpdateGroupSettings, useUpdateMemberRole, useUpgradeGroup };
+export { AppMode, CalimeroLogo, ConnectButton, ConnectionType, DEFAULT_LOCAL_NODE_PORTS, LoginModal, MERO_CSS_VARS, MeroContext, MeroProvider, MigrationAdminPanel, MigrationPendingBanner, clearAllStorage, clearApplicationId, clearContextId, clearContextIdentity, clearNodeUrl, clearTokenNodeUrl, cssVar, defaultMeroTheme, discoverLocalNodes, getApplicationId, getContextId, getContextIdentity, getNodeUrl, getTokenNodeUrl, localNodeUrl, localStorageTokenStorage, nodeEndpoint, probeNodeHealth, resolveMeroTheme, setApplicationId, setContextId, setContextIdentity, setNodeUrl, setTokenNodeUrl, themeToCssVars, useAddGroupMembers, useAppVersion, useApplicationContexts, useContextDiscovery, useContextGroup, useContexts, useCreateContext, useCreateGroupInNamespace, useCreateNamespace, useCreateNamespaceInvitation, useDefaultCapabilities, useDeleteContext, useDeleteGroup, useDeleteNamespace, useDetachContextFromGroup, useExecute, useGroupAppVersion, useGroupCapabilities, useGroupContexts, useGroupInfo, useGroupInvitations, useGroupMembers, useGroupMetadata, useGroupUpgradeStatus, useInstallFromRegistry, useJoinContext, useJoinGroup, useJoinNamespace, useJoinSubgroupInheritance, useLatestVersion, useMemberMetadata, useMero, useMigrationStatus, useMyAuthoredMigration, useNamespace, useNamespaceGroups, useNamespaceIdentity, useNamespaces, useNamespacesForApplication, useRegisterGroupSigningKey, useRemoveGroupMembers, useReparentGroup, useResyncContext, useRetryGroupUpgrade, useSetContextMetadata, useSetDefaultCapabilities, useSetGroupMetadata, useSetMemberMetadata, useSetSubgroupVisibility, useSetTeeAdmissionPolicy, useSubgroupVisibility, useSubgroups, useSubscription, useSyncGroup, useUpdateGroupSettings, useUpdateMemberRole, useUpgradeGroup };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map