@calimero-network/mero-react 8.0.0 → 9.1.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, 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';
+import { MeroJs, TokenStore, SetMetadataRequest, SseEventData, GroupMembershipEventData, GroupMigrationEventData, Codec, AddGroupMembersRequest, GetBlobInfoResponseData, CreateContextRequest, CreateGroupInNamespaceRequest, CreateNamespaceRequest, CreateNamespaceInvitationRequest, CreateNamespaceInvitationResponseData, CreateRecursiveInvitationResponseData, GroupUpgradeStatusResponseData, GroupContextEntry, GroupInfo, CreateGroupInvitationRequest, MetadataRecord, JoinGroupRequest, JoinNamespaceRequest, MigrationStatus, MigrationStatusRollup, MemberMigrationStatusEntry, MigrateMyEntriesSummary, Namespace, SubgroupEntry, NamespaceIdentity, NodeIdentity, RemoveGroupMembersRequest, ReparentGroupRequest, ResyncContextRequest, SetDefaultCapabilitiesRequest, SetSubgroupVisibilityRequest, SetTeeAdmissionPolicyRequest, UpdateMemberRoleRequest, UpgradeGroupRequest, UploadBlobRequest, 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';
 
@@ -493,12 +493,12 @@ declare function useGroupInfo(groupId?: string | null): {
     refetch: () => Promise<void>;
 };
 declare function useDeleteGroup(): {
-    deleteGroup: (groupId: string, request?: DeleteGroupRequest) => Promise<_calimero_network_mero_js.DeleteGroupResponseData | null>;
+    deleteGroup: (groupId: string) => Promise<_calimero_network_mero_js.DeleteGroupResponseData | null>;
     loading: boolean;
     error: Error | null;
 };
 declare function useSyncGroup(): {
-    syncGroup: (groupId: string, request?: SyncGroupRequest) => Promise<_calimero_network_mero_js.SyncGroupResponseData | null>;
+    syncGroup: (groupId: string) => Promise<_calimero_network_mero_js.SyncGroupResponseData | null>;
     loading: boolean;
     error: Error | null;
 };
@@ -571,7 +571,7 @@ declare function useCreateNamespace(): {
     error: Error | null;
 };
 declare function useDeleteNamespace(): {
-    deleteNamespace: (namespaceId: string, request?: DeleteNamespaceRequest) => Promise<_calimero_network_mero_js.DeleteNamespaceResponseData | null>;
+    deleteNamespace: (namespaceId: string) => Promise<_calimero_network_mero_js.DeleteNamespaceResponseData | null>;
     loading: boolean;
     error: Error | null;
 };
@@ -677,7 +677,7 @@ declare function useUpgradeGroup(): {
  * 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>;
+    installFromRegistry: (packageName: string, version: string) => Promise<_calimero_network_mero_js.InstallApplicationResponseData | null>;
     loading: boolean;
     error: Error | null;
 };
@@ -698,7 +698,7 @@ declare function useGroupUpgradeStatus(groupId?: string | null): {
     refetch: () => Promise<void>;
 };
 declare function useRetryGroupUpgrade(): {
-    retryGroupUpgrade: (groupId: string, request?: RetryGroupUpgradeRequest) => Promise<_calimero_network_mero_js.UpgradeGroupResponseData | null>;
+    retryGroupUpgrade: (groupId: string) => Promise<_calimero_network_mero_js.UpgradeGroupResponseData | null>;
     loading: boolean;
     error: Error | null;
 };
@@ -715,7 +715,7 @@ declare function useSubgroups(groupId?: string | null): {
     refetch: () => Promise<void>;
 };
 declare function useDetachContextFromGroup(): {
-    detachContextFromGroup: (groupId: string, contextId: string, request?: DetachContextFromGroupRequest) => Promise<void | null>;
+    detachContextFromGroup: (groupId: string, contextId: string) => Promise<void | null>;
     loading: boolean;
     error: Error | null;
 };
@@ -841,6 +841,106 @@ declare function useMyAuthoredMigration(contextId?: string | null): {
     error: Error | null;
     refresh: () => Promise<void>;
 };
+/**
+ * Options for the blob READ hooks.
+ *
+ * `contextId` is what picks the mode, and the two modes have wildly different
+ * costs:
+ *
+ * - **omitted** — local-only read. The node answers from its own blob store
+ *   and returns immediately, or 404s.
+ * - **supplied** — network discovery. The node probes that context's peers
+ *   (availability nodes first) for a holder. Core bounds the search by a ~30s
+ *   deadline, and for {@link useBlobUrl} the byte transfer is on top of that.
+ *
+ * So `loading` is load-bearing UI state on these hooks, not decoration: a
+ * discovery read can plausibly spin for half a minute before it resolves
+ * either way. Render a spinner (or a cancel affordance) accordingly.
+ */
+interface BlobHookOptions {
+    /** Context whose peers to probe. Omit for a local-only read. */
+    contextId?: string;
+}
+/** Options for {@link useBlobUrl}. */
+interface UseBlobUrlOptions extends BlobHookOptions {
+    /**
+     * MIME type stamped on the `Blob` the object URL points at. The blob read
+     * itself carries no type, and a peer-sourced answer has no `mimeType` at
+     * all, so pass it when the consumer needs one (`<img>` sniffs; a download
+     * `<a>` and an `<iframe>` do not).
+     */
+    type?: string;
+}
+/**
+ * A blob's presence and size, WITHOUT downloading it — the cheap half of the
+ * blob surface, and the one to ask before pulling something large.
+ *
+ * `blobId` follows the same `string | null` convention as the other read
+ * hooks: null/undefined means "no read", not "read nothing" — nothing is
+ * fetched and `info` stays null.
+ *
+ * `hash` and `mimeType` on the result are genuinely optional: a peer probe
+ * answers with presence and size only, so a discovery-sourced hit carries
+ * neither. `info.source` (`'local' | 'peer'`, undefined on nodes that predate
+ * the header) tells the two apart — do not treat a missing `mimeType` as a
+ * malformed response.
+ *
+ * `notFound` distinguishes the legitimate "no holder" outcome (the node
+ * answered 404) from a transport failure. `error` is set in BOTH cases — this
+ * hook does not swallow the 404, it only labels it.
+ *
+ * Latency: immediate without `contextId`, up to core's ~30s discovery deadline
+ * with one. See {@link BlobHookOptions}.
+ */
+declare function useBlobInfo(blobId?: string | null, options?: BlobHookOptions): {
+    info: GetBlobInfoResponseData | null;
+    notFound: boolean;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * A blob's bytes as an object URL, ready for `<img src>`, an `<a href>`
+ * download, or an `<iframe>`.
+ *
+ * Lifecycle is handled here so the consumer never has to revoke: the URL is
+ * revoked on unmount, and whenever `blobId`/`contextId`/`type` change. `url`
+ * goes back to null synchronously on such a change, so a revoked URL is never
+ * handed out as the current one — render off `url` and it is always live.
+ *
+ * A response for a superseded `blobId` is dropped before an object URL is even
+ * created, so an out-of-order arrival can neither overwrite the newer result
+ * nor leak.
+ *
+ * Latency: this is the expensive hook. Without `contextId` it is a local read;
+ * with one it is discovery (core's ~30s deadline) PLUS the transfer of the
+ * bytes. Prefer {@link useBlobInfo} to decide whether the download is worth
+ * starting, and always render `loading`.
+ *
+ * `notFound` marks the node's 404 ("no peer holds this") apart from a
+ * transport failure; `error` is set for both.
+ */
+declare function useBlobUrl(blobId?: string | null, options?: UseBlobUrlOptions): {
+    url: string | null;
+    notFound: boolean;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * Upload bytes to the node's blob store. Mutation-shaped, like the other
+ * write hooks: `uploadBlob` resolves to `{ blobId, size }`, or null when the
+ * client is absent or the call failed (read `error` for which).
+ *
+ * Pass `contextId` to announce the blob to that context, which is what lets
+ * the context's other members later discover it with {@link useBlobUrl} /
+ * {@link useBlobInfo}. Without it the blob is only readable on this node.
+ */
+declare function useUploadBlob(): {
+    uploadBlob: (request: UploadBlobRequest) => Promise<_calimero_network_mero_js.BlobInfo | null>;
+    loading: boolean;
+    error: Error | null;
+};
 
 /**
  * Storage utilities for mero-react
@@ -918,4 +1018,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_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 };
+export { type AppContext, AppMode, type ApplicationContextRecord, type BlobHookOptions, 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 UseBlobUrlOptions, 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, useBlobInfo, useBlobUrl, 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, useUploadBlob };

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, NodeIdentity, 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, GetBlobInfoResponseData, CreateContextRequest, CreateGroupInNamespaceRequest, CreateNamespaceRequest, CreateNamespaceInvitationRequest, CreateNamespaceInvitationResponseData, CreateRecursiveInvitationResponseData, GroupUpgradeStatusResponseData, GroupContextEntry, GroupInfo, CreateGroupInvitationRequest, MetadataRecord, JoinGroupRequest, JoinNamespaceRequest, MigrationStatus, MigrationStatusRollup, MemberMigrationStatusEntry, MigrateMyEntriesSummary, Namespace, SubgroupEntry, NamespaceIdentity, NodeIdentity, RemoveGroupMembersRequest, ReparentGroupRequest, ResyncContextRequest, SetDefaultCapabilitiesRequest, SetSubgroupVisibilityRequest, SetTeeAdmissionPolicyRequest, UpdateMemberRoleRequest, UpgradeGroupRequest, UploadBlobRequest, 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';
 
@@ -493,12 +493,12 @@ declare function useGroupInfo(groupId?: string | null): {
     refetch: () => Promise<void>;
 };
 declare function useDeleteGroup(): {
-    deleteGroup: (groupId: string, request?: DeleteGroupRequest) => Promise<_calimero_network_mero_js.DeleteGroupResponseData | null>;
+    deleteGroup: (groupId: string) => Promise<_calimero_network_mero_js.DeleteGroupResponseData | null>;
     loading: boolean;
     error: Error | null;
 };
 declare function useSyncGroup(): {
-    syncGroup: (groupId: string, request?: SyncGroupRequest) => Promise<_calimero_network_mero_js.SyncGroupResponseData | null>;
+    syncGroup: (groupId: string) => Promise<_calimero_network_mero_js.SyncGroupResponseData | null>;
     loading: boolean;
     error: Error | null;
 };
@@ -571,7 +571,7 @@ declare function useCreateNamespace(): {
     error: Error | null;
 };
 declare function useDeleteNamespace(): {
-    deleteNamespace: (namespaceId: string, request?: DeleteNamespaceRequest) => Promise<_calimero_network_mero_js.DeleteNamespaceResponseData | null>;
+    deleteNamespace: (namespaceId: string) => Promise<_calimero_network_mero_js.DeleteNamespaceResponseData | null>;
     loading: boolean;
     error: Error | null;
 };
@@ -677,7 +677,7 @@ declare function useUpgradeGroup(): {
  * 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>;
+    installFromRegistry: (packageName: string, version: string) => Promise<_calimero_network_mero_js.InstallApplicationResponseData | null>;
     loading: boolean;
     error: Error | null;
 };
@@ -698,7 +698,7 @@ declare function useGroupUpgradeStatus(groupId?: string | null): {
     refetch: () => Promise<void>;
 };
 declare function useRetryGroupUpgrade(): {
-    retryGroupUpgrade: (groupId: string, request?: RetryGroupUpgradeRequest) => Promise<_calimero_network_mero_js.UpgradeGroupResponseData | null>;
+    retryGroupUpgrade: (groupId: string) => Promise<_calimero_network_mero_js.UpgradeGroupResponseData | null>;
     loading: boolean;
     error: Error | null;
 };
@@ -715,7 +715,7 @@ declare function useSubgroups(groupId?: string | null): {
     refetch: () => Promise<void>;
 };
 declare function useDetachContextFromGroup(): {
-    detachContextFromGroup: (groupId: string, contextId: string, request?: DetachContextFromGroupRequest) => Promise<void | null>;
+    detachContextFromGroup: (groupId: string, contextId: string) => Promise<void | null>;
     loading: boolean;
     error: Error | null;
 };
@@ -841,6 +841,106 @@ declare function useMyAuthoredMigration(contextId?: string | null): {
     error: Error | null;
     refresh: () => Promise<void>;
 };
+/**
+ * Options for the blob READ hooks.
+ *
+ * `contextId` is what picks the mode, and the two modes have wildly different
+ * costs:
+ *
+ * - **omitted** — local-only read. The node answers from its own blob store
+ *   and returns immediately, or 404s.
+ * - **supplied** — network discovery. The node probes that context's peers
+ *   (availability nodes first) for a holder. Core bounds the search by a ~30s
+ *   deadline, and for {@link useBlobUrl} the byte transfer is on top of that.
+ *
+ * So `loading` is load-bearing UI state on these hooks, not decoration: a
+ * discovery read can plausibly spin for half a minute before it resolves
+ * either way. Render a spinner (or a cancel affordance) accordingly.
+ */
+interface BlobHookOptions {
+    /** Context whose peers to probe. Omit for a local-only read. */
+    contextId?: string;
+}
+/** Options for {@link useBlobUrl}. */
+interface UseBlobUrlOptions extends BlobHookOptions {
+    /**
+     * MIME type stamped on the `Blob` the object URL points at. The blob read
+     * itself carries no type, and a peer-sourced answer has no `mimeType` at
+     * all, so pass it when the consumer needs one (`<img>` sniffs; a download
+     * `<a>` and an `<iframe>` do not).
+     */
+    type?: string;
+}
+/**
+ * A blob's presence and size, WITHOUT downloading it — the cheap half of the
+ * blob surface, and the one to ask before pulling something large.
+ *
+ * `blobId` follows the same `string | null` convention as the other read
+ * hooks: null/undefined means "no read", not "read nothing" — nothing is
+ * fetched and `info` stays null.
+ *
+ * `hash` and `mimeType` on the result are genuinely optional: a peer probe
+ * answers with presence and size only, so a discovery-sourced hit carries
+ * neither. `info.source` (`'local' | 'peer'`, undefined on nodes that predate
+ * the header) tells the two apart — do not treat a missing `mimeType` as a
+ * malformed response.
+ *
+ * `notFound` distinguishes the legitimate "no holder" outcome (the node
+ * answered 404) from a transport failure. `error` is set in BOTH cases — this
+ * hook does not swallow the 404, it only labels it.
+ *
+ * Latency: immediate without `contextId`, up to core's ~30s discovery deadline
+ * with one. See {@link BlobHookOptions}.
+ */
+declare function useBlobInfo(blobId?: string | null, options?: BlobHookOptions): {
+    info: GetBlobInfoResponseData | null;
+    notFound: boolean;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * A blob's bytes as an object URL, ready for `<img src>`, an `<a href>`
+ * download, or an `<iframe>`.
+ *
+ * Lifecycle is handled here so the consumer never has to revoke: the URL is
+ * revoked on unmount, and whenever `blobId`/`contextId`/`type` change. `url`
+ * goes back to null synchronously on such a change, so a revoked URL is never
+ * handed out as the current one — render off `url` and it is always live.
+ *
+ * A response for a superseded `blobId` is dropped before an object URL is even
+ * created, so an out-of-order arrival can neither overwrite the newer result
+ * nor leak.
+ *
+ * Latency: this is the expensive hook. Without `contextId` it is a local read;
+ * with one it is discovery (core's ~30s deadline) PLUS the transfer of the
+ * bytes. Prefer {@link useBlobInfo} to decide whether the download is worth
+ * starting, and always render `loading`.
+ *
+ * `notFound` marks the node's 404 ("no peer holds this") apart from a
+ * transport failure; `error` is set for both.
+ */
+declare function useBlobUrl(blobId?: string | null, options?: UseBlobUrlOptions): {
+    url: string | null;
+    notFound: boolean;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * Upload bytes to the node's blob store. Mutation-shaped, like the other
+ * write hooks: `uploadBlob` resolves to `{ blobId, size }`, or null when the
+ * client is absent or the call failed (read `error` for which).
+ *
+ * Pass `contextId` to announce the blob to that context, which is what lets
+ * the context's other members later discover it with {@link useBlobUrl} /
+ * {@link useBlobInfo}. Without it the blob is only readable on this node.
+ */
+declare function useUploadBlob(): {
+    uploadBlob: (request: UploadBlobRequest) => Promise<_calimero_network_mero_js.BlobInfo | null>;
+    loading: boolean;
+    error: Error | null;
+};
 
 /**
  * Storage utilities for mero-react
@@ -918,4 +1018,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_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 };
+export { type AppContext, AppMode, type ApplicationContextRecord, type BlobHookOptions, 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 UseBlobUrlOptions, 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, useBlobInfo, useBlobUrl, 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, useUploadBlob };

package/dist/index.js

@@ -1949,9 +1949,9 @@ function useDeleteGroup() {
   const { mero } = useMero();
   const { loading, error, run } = useAsyncMutation();
   const deleteGroup = useCallback(
-    async (groupId, request) => {
+    async (groupId) => {
       if (!mero) return null;
-      return run(() => mero.admin.deleteGroup(groupId, request));
+      return run(() => mero.admin.deleteGroup(groupId));
     },
     [mero, run]
   );
@@ -1961,9 +1961,9 @@ function useSyncGroup() {
   const { mero } = useMero();
   const { loading, error, run } = useAsyncMutation();
   const syncGroup = useCallback(
-    async (groupId, request) => {
+    async (groupId) => {
       if (!mero) return null;
-      return run(() => mero.admin.syncGroup(groupId, request));
+      return run(() => mero.admin.syncGroup(groupId));
     },
     [mero, run]
   );
@@ -2054,9 +2054,9 @@ function useDeleteNamespace() {
   const { mero } = useMero();
   const { loading, error, run } = useAsyncMutation();
   const deleteNamespace = useCallback(
-    async (namespaceId, request) => {
+    async (namespaceId) => {
       if (!mero) return null;
-      return run(() => mero.admin.deleteNamespace(namespaceId, request));
+      return run(() => mero.admin.deleteNamespace(namespaceId));
     },
     [mero, run]
   );
@@ -2277,9 +2277,9 @@ function useInstallFromRegistry() {
   const { mero } = useMero();
   const { loading, error, run } = useAsyncMutation();
   const installFromRegistry = useCallback(
-    async (registryUrl, packageName, version) => {
+    async (packageName, version) => {
       if (!mero) return null;
-      return run(() => mero.admin.installFromRegistry(registryUrl, packageName, version));
+      return run(() => mero.admin.installApplication({ package: packageName, version }));
     },
     [mero, run]
   );
@@ -2348,9 +2348,9 @@ function useRetryGroupUpgrade() {
   const { mero } = useMero();
   const { loading, error, run } = useAsyncMutation();
   const retryGroupUpgrade = useCallback(
-    async (groupId, request) => {
+    async (groupId) => {
       if (!mero) return null;
-      return run(() => mero.admin.retryGroupUpgrade(groupId, request));
+      return run(() => mero.admin.retryGroupUpgrade(groupId));
     },
     [mero, run]
   );
@@ -2381,9 +2381,9 @@ function useDetachContextFromGroup() {
   const { mero } = useMero();
   const { loading, error, run } = useAsyncMutation();
   const detachContextFromGroup = useCallback(
-    async (groupId, contextId, request) => {
+    async (groupId, contextId) => {
       if (!mero) return null;
-      return run(() => mero.admin.detachContextFromGroup(groupId, contextId, request));
+      return run(() => mero.admin.detachContextFromGroup(groupId, contextId));
     },
     [mero, run]
   );
@@ -2730,6 +2730,80 @@ function useMyAuthoredMigration(contextId) {
     refresh
   };
 }
+function isBlobNotFound(error) {
+  return !!error && error.status === 404;
+}
+function useBlobInfo(blobId, options) {
+  const { mero } = useMero();
+  const contextId = options?.contextId;
+  const { data, loading, error, refetch } = useAsyncResource(
+    mero && blobId ? () => mero.admin.getBlobInfo(blobId, contextId ? { contextId } : void 0) : null,
+    null,
+    [mero, blobId, contextId]
+  );
+  return { info: data, notFound: isBlobNotFound(error), loading, error, refetch };
+}
+function useBlobUrl(blobId, options) {
+  const { mero } = useMero();
+  const contextId = options?.contextId;
+  const type = options?.type;
+  const mountedRef = useMountedRef();
+  const [url, setUrl] = useState(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const reqRef = useRef(0);
+  const urlRef = useRef(null);
+  const revoke = useCallback(() => {
+    if (urlRef.current) {
+      URL.revokeObjectURL(urlRef.current);
+      urlRef.current = null;
+    }
+  }, []);
+  const refetch = useCallback(async () => {
+    const seq = ++reqRef.current;
+    if (!mero || !blobId) return;
+    if (mountedRef.current) {
+      setLoading(true);
+      setError(null);
+    }
+    try {
+      const bytes = await mero.admin.getBlob(blobId, contextId ? { contextId } : void 0);
+      if (!mountedRef.current || seq !== reqRef.current) return;
+      revoke();
+      const objectUrl = URL.createObjectURL(new Blob([bytes], type ? { type } : void 0));
+      urlRef.current = objectUrl;
+      setUrl(objectUrl);
+    } catch (err) {
+      if (mountedRef.current && seq === reqRef.current) setError(toError(err));
+    } finally {
+      if (mountedRef.current && seq === reqRef.current) setLoading(false);
+    }
+  }, [mero, blobId, contextId, type, revoke, mountedRef]);
+  useEffect(() => {
+    reqRef.current += 1;
+    revoke();
+    setUrl(null);
+    setError(null);
+    setLoading(false);
+  }, [mero, blobId, contextId, type, revoke]);
+  useEffect(() => {
+    void refetch();
+  }, [refetch]);
+  useEffect(() => revoke, [revoke]);
+  return { url, notFound: isBlobNotFound(error), loading, error, refetch };
+}
+function useUploadBlob() {
+  const { mero } = useMero();
+  const { loading, error, run } = useAsyncMutation();
+  const uploadBlob = useCallback(
+    async (request) => {
+      if (!mero) return null;
+      return run(() => mero.admin.uploadBlob(request));
+    },
+    [mero, run]
+  );
+  return { uploadBlob, loading, error };
+}
 function MigrationPendingBanner({
   contextId,
   className,
@@ -2824,6 +2898,6 @@ function MigrationAdminPanel({ namespaceId, pollIntervalMs, className }) {
   ] });
 }
 
-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 };
+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, useBlobInfo, useBlobUrl, 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, useUploadBlob };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map