@calimero-network/mero-react 1.0.0-beta.1 → 1.1.0

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 import React__default from 'react';
-import { MeroJs, TokenStorage } from '@calimero-network/mero-js';
-export { MeroJs, TokenData, TokenStorage } from '@calimero-network/mero-js';
+import * as _calimero_network_mero_js from '@calimero-network/mero-js';
+import { MeroJs, AddGroupMembersRequest, CreateContextRequest, CreateGroupInNamespaceRequest, CreateNamespaceRequest, CreateNamespaceInvitationRequest, CreateNamespaceInvitationResponseData, CreateRecursiveInvitationResponseData, DeleteGroupRequest, DeleteNamespaceRequest, DetachContextFromGroupRequest, GroupContextEntry, GroupInfo, CreateGroupInvitationRequest, GroupMember, GroupUpgradeStatusResponseData, JoinGroupRequest, JoinNamespaceRequest, Namespace, SubgroupEntry, NamespaceIdentity, NestGroupRequest, RegisterGroupSigningKeyRequest, RemoveGroupMembersRequest, RetryGroupUpgradeRequest, SetDefaultCapabilitiesRequest, SetDefaultVisibilityRequest, SetGroupAliasRequest, SetMemberAliasRequest, SetTeeAdmissionPolicyRequest, SseEventData, SyncGroupRequest, UnnestGroupRequest, UpdateGroupSettingsRequest, UpdateMemberRoleRequest, UpgradeGroupRequest, TokenData } from '@calimero-network/mero-js';
+export * from '@calimero-network/mero-js';
 
 /**
  * Types for mero-react
@@ -39,13 +40,6 @@ interface CustomConnectionConfig {
     type: ConnectionType.Custom;
     url: string;
 }
-/**
- * Event streaming mode
- */
-declare enum EventStreamMode {
-    WebSocket = "websocket",
-    SSE = "sse"
-}
 /**
  * Context for an application
  */
@@ -62,6 +56,24 @@ interface ExecutionResult<T = unknown> {
     result?: T;
     error?: string;
 }
+interface ApplicationContextRecord {
+    contextId: string;
+    applicationId: string;
+}
+interface ContextDiscoveryOptions {
+    applicationId: string;
+    knownContextIds?: string[];
+    targetAlias?: string;
+    pollIntervalMs?: number;
+    timeoutMs?: number;
+}
+interface ContextDiscoveryState {
+    context: ApplicationContextRecord | null;
+    loading: boolean;
+    error: Error | null;
+    discover: () => Promise<ApplicationContextRecord | null>;
+    reset: () => void;
+}
 /**
  * Mero context value exposed by useMero hook
  */
@@ -78,6 +90,8 @@ interface MeroContextValue {
     applicationId: string | null;
     /** The context ID (from auth flow) */
     contextId: string | null;
+    /** The context identity / executor public key (from auth flow) */
+    contextIdentity: string | null;
     /** Connect to a node URL and start auth flow */
     connectToNode: (url: string) => void;
     /** Logout and clear tokens */
@@ -97,30 +111,15 @@ interface MeroProviderConfig {
     packageVersion?: string;
     /** Registry URL (optional) */
     registryUrl?: string;
-    /** Legacy: Application ID (hash-based) */
-    applicationId?: string;
-    /** Application path for auth callback */
-    applicationPath?: string;
-    /** Event streaming mode */
-    eventStreamMode?: EventStreamMode;
     /** Request timeout in milliseconds */
     timeoutMs?: number;
 }
 
-declare const MeroContext: React__default.Context<MeroContextValue>;
-/**
- * MeroProvider Props
- */
+declare const MeroContext: React__default.Context<MeroContextValue | null>;
 interface MeroProviderProps extends MeroProviderConfig {
     children: React__default.ReactNode;
 }
-/**
- * MeroProvider - Provides MeroJs instance and auth state to the app
- */
-declare function MeroProvider({ children, mode, packageName, packageVersion, registryUrl, applicationId: propApplicationId, applicationPath, timeoutMs, }: MeroProviderProps): react_jsx_runtime.JSX.Element;
-/**
- * useMero hook - Access MeroJs and auth state
- */
+declare function MeroProvider({ children, mode, packageName, packageVersion, registryUrl, timeoutMs, }: MeroProviderProps): react_jsx_runtime.JSX.Element;
 declare function useMero(): MeroContextValue;
 
 interface ConnectButtonProps {
@@ -151,16 +150,258 @@ interface LoginModalProps {
  */
 declare function LoginModal({ onConnect, onClose, connectionType, isOpen, }: LoginModalProps): React.ReactPortal | null;
 
+/**
+ * Execute RPC methods against a context.
+ * Tracks loading/error state. Unmount-safe.
+ */
+declare function useExecute(contextId: string | null, executorId: string | null): {
+    execute: <T = unknown>(method: string, params?: Record<string, unknown>) => Promise<T | null>;
+    loading: boolean;
+    error: Error | null;
+};
+/**
+ * Subscribe to SSE events for context 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;
+/**
+ * Fetch contexts for the current node, optionally filtered by application ID.
+ */
+declare function useContexts(applicationId?: string | null): {
+    contexts: ApplicationContextRecord[];
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+declare function useApplicationContexts(applicationId?: string | null): {
+    contexts: ApplicationContextRecord[];
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+declare function useGroupMembers(groupId?: string | null): {
+    members: GroupMember[];
+    selfIdentity: string | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+declare function useGroupContexts(groupId?: string | null): {
+    contexts: GroupContextEntry[];
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+declare function useGroupInvitations(): {
+    createInvitation: (groupId: string, request?: CreateGroupInvitationRequest) => Promise<_calimero_network_mero_js.CreateGroupInvitationResponseData | _calimero_network_mero_js.CreateRecursiveGroupInvitationResponseData | null>;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useJoinGroup(): {
+    joinGroup: (request: JoinGroupRequest) => Promise<_calimero_network_mero_js.JoinGroupResponseData | null>;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useGroupCapabilities(groupId?: string | null, memberId?: string | null): {
+    capabilities: number | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<number | null>;
+    setCapabilities: (nextCapabilities: number) => Promise<number | null>;
+};
+declare function useContextDiscovery(options: ContextDiscoveryOptions): ContextDiscoveryState;
+declare function useCreateContext(): {
+    createContext: (request: CreateContextRequest) => Promise<_calimero_network_mero_js.CreateContextResponseData | null>;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useDeleteContext(): {
+    deleteContext: (contextId: string) => Promise<_calimero_network_mero_js.DeleteContextResponseData | null>;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useJoinContext(): {
+    joinContext: (contextId: string) => Promise<_calimero_network_mero_js.JoinContextResponseData | null>;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useContextGroup(contextId?: string | null): {
+    groupId: string | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+declare function useGroupInfo(groupId?: string | null): {
+    groupInfo: GroupInfo | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+declare function useDeleteGroup(): {
+    deleteGroup: (groupId: string, request?: DeleteGroupRequest) => 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>;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useAddGroupMembers(): {
+    addGroupMembers: (groupId: string, request: AddGroupMembersRequest) => Promise<void | null>;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useRemoveGroupMembers(): {
+    removeGroupMembers: (groupId: string, request: RemoveGroupMembersRequest) => Promise<void | null>;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useNamespaces(): {
+    namespaces: Namespace[];
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+declare function useNamespace(namespaceId?: string | null): {
+    namespace: Namespace | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+declare function useNamespaceIdentity(namespaceId?: string | null): {
+    identity: NamespaceIdentity | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+declare function useNamespacesForApplication(applicationId?: string | null): {
+    namespaces: Namespace[];
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+declare function useCreateNamespace(): {
+    createNamespace: (request: CreateNamespaceRequest) => Promise<_calimero_network_mero_js.CreateNamespaceResponseData | null>;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useDeleteNamespace(): {
+    deleteNamespace: (namespaceId: string, request?: DeleteNamespaceRequest) => Promise<_calimero_network_mero_js.DeleteNamespaceResponseData | null>;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useCreateNamespaceInvitation(): {
+    createNamespaceInvitation: (namespaceId: string, request?: CreateNamespaceInvitationRequest) => Promise<CreateNamespaceInvitationResponseData | CreateRecursiveInvitationResponseData | null>;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useJoinNamespace(): {
+    joinNamespace: (namespaceId: string, request: JoinNamespaceRequest) => Promise<_calimero_network_mero_js.JoinNamespaceResponseData | null>;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useCreateGroupInNamespace(): {
+    createGroupInNamespace: (namespaceId: string, request?: CreateGroupInNamespaceRequest) => Promise<_calimero_network_mero_js.CreateGroupInNamespaceResponseData | null>;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useNamespaceGroups(namespaceId?: string | null): {
+    groups: SubgroupEntry[];
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+declare function useUpdateMemberRole(): {
+    updateMemberRole: (groupId: string, identity: string, request: UpdateMemberRoleRequest) => Promise<void | null>;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useSetDefaultCapabilities(): {
+    setDefaultCapabilities: (groupId: string, request: SetDefaultCapabilitiesRequest) => Promise<void | null>;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useSetDefaultVisibility(): {
+    setDefaultVisibility: (groupId: string, request: SetDefaultVisibilityRequest) => Promise<void | null>;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useSetTeeAdmissionPolicy(): {
+    setTeeAdmissionPolicy: (groupId: string, request: SetTeeAdmissionPolicyRequest) => Promise<void | null>;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useUpdateGroupSettings(): {
+    updateGroupSettings: (groupId: string, request: UpdateGroupSettingsRequest) => Promise<void | null>;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useSetGroupAlias(): {
+    setGroupAlias: (groupId: string, request: SetGroupAliasRequest) => Promise<void | null>;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useSetMemberAlias(): {
+    setMemberAlias: (groupId: string, identity: string, request: SetMemberAliasRequest) => Promise<void | null>;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useRegisterGroupSigningKey(): {
+    registerGroupSigningKey: (groupId: string, request: RegisterGroupSigningKeyRequest) => Promise<_calimero_network_mero_js.RegisterGroupSigningKeyResponseData | null>;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useUpgradeGroup(): {
+    upgradeGroup: (groupId: string, request: UpgradeGroupRequest) => Promise<_calimero_network_mero_js.UpgradeGroupResponseData | null>;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useGroupUpgradeStatus(groupId?: string | null): {
+    upgradeStatus: GroupUpgradeStatusResponseData;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+declare function useRetryGroupUpgrade(): {
+    retryGroupUpgrade: (groupId: string, request?: RetryGroupUpgradeRequest) => Promise<_calimero_network_mero_js.UpgradeGroupResponseData | null>;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useNestGroup(): {
+    nestGroup: (parentGroupId: string, request: NestGroupRequest) => Promise<void | null>;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useUnnestGroup(): {
+    unnestGroup: (parentGroupId: string, request: UnnestGroupRequest) => Promise<void | null>;
+    loading: boolean;
+    error: Error | null;
+};
+declare function useSubgroups(groupId?: string | null): {
+    subgroups: SubgroupEntry[];
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+declare function useDetachContextFromGroup(): {
+    detachContextFromGroup: (groupId: string, contextId: string, request?: DetachContextFromGroupRequest) => Promise<void | null>;
+    loading: boolean;
+    error: Error | null;
+};
+
 /**
  * Storage utilities for mero-react
  *
  * Provides localStorage-based token storage and other persistence utilities.
  */
 
-/**
- * localStorage-based TokenStorage implementation for MeroJs
- */
-declare const localStorageTokenStorage: TokenStorage;
+declare const localStorageTokenStorage: {
+    get(): Promise<TokenData | null>;
+    set(token: TokenData): Promise<void>;
+    clear(): Promise<void>;
+};
 /**
  * Get the stored node URL
  */
@@ -185,9 +426,33 @@ declare function setApplicationId(id: string): void;
  * Clear the application ID
  */
 declare function clearApplicationId(): void;
+/**
+ * Get the stored context ID
+ */
+declare function getContextId(): string | null;
+/**
+ * Set the context ID
+ */
+declare function setContextId(id: string): void;
+/**
+ * Clear the context ID
+ */
+declare function clearContextId(): void;
+/**
+ * Get the stored context identity
+ */
+declare function getContextIdentity(): string | null;
+/**
+ * Set the context identity
+ */
+declare function setContextIdentity(id: string): void;
+/**
+ * Clear the context identity
+ */
+declare function clearContextIdentity(): void;
 /**
  * Clear all mero-react storage
  */
 declare function clearAllStorage(): void;
 
-export { type AppContext, AppMode, ConnectButton, type ConnectButtonProps, ConnectionType, type CustomConnectionConfig, EventStreamMode, type ExecutionResult, LoginModal, type LoginModalProps, MeroContext, type MeroContextValue, MeroProvider, type MeroProviderConfig, type MeroProviderProps, clearAllStorage, clearApplicationId, clearNodeUrl, getApplicationId, getNodeUrl, localStorageTokenStorage, setApplicationId, setNodeUrl, useMero };
+export { type AppContext, AppMode, type ApplicationContextRecord, ConnectButton, type ConnectButtonProps, ConnectionType, type ContextDiscoveryOptions, type ContextDiscoveryState, type CustomConnectionConfig, type ExecutionResult, LoginModal, type LoginModalProps, MeroContext, type MeroContextValue, MeroProvider, type MeroProviderConfig, type MeroProviderProps, clearAllStorage, clearApplicationId, clearContextId, clearContextIdentity, clearNodeUrl, getApplicationId, getContextId, getContextIdentity, getNodeUrl, localStorageTokenStorage, setApplicationId, setContextId, setContextIdentity, setNodeUrl, useAddGroupMembers, useApplicationContexts, useContextDiscovery, useContextGroup, useContexts, useCreateContext, useCreateGroupInNamespace, useCreateNamespace, useCreateNamespaceInvitation, useDeleteContext, useDeleteGroup, useDeleteNamespace, useDetachContextFromGroup, useExecute, useGroupCapabilities, useGroupContexts, useGroupInfo, useGroupInvitations, useGroupMembers, useGroupUpgradeStatus, useJoinContext, useJoinGroup, useJoinNamespace, useMero, useNamespace, useNamespaceGroups, useNamespaceIdentity, useNamespaces, useNamespacesForApplication, useNestGroup, useRegisterGroupSigningKey, useRemoveGroupMembers, useRetryGroupUpgrade, useSetDefaultCapabilities, useSetDefaultVisibility, useSetGroupAlias, useSetMemberAlias, useSetTeeAdmissionPolicy, useSubgroups, useSubscription, useSyncGroup, useUnnestGroup, useUpdateGroupSettings, useUpdateMemberRole, useUpgradeGroup };