@calimero-network/mero-react 9.1.3 → 9.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -2,7 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
2
2
  import * as React from 'react';
3
3
  import React__default, { CSSProperties, ReactNode } from 'react';
4
4
  import * as _calimero_network_mero_js from '@calimero-network/mero-js';
5
- 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';
5
+ import { MeroJs, TokenStore, SetMetadataRequest, SseEventData, GroupMembershipEventData, GroupMigrationEventData, Codec, AddGroupMembersRequest, GetBlobInfoResponseData, CreateContextRequest, CreateGroupInNamespaceRequest, CreateNamespaceRequest, CreateNamespaceInvitationRequest, CreateNamespaceInvitationResponseData, CreateRecursiveInvitationResponseData, GroupUpgradeStatusResponseData, GroupContextEntry, GroupInfo, CreateGroupInvitationRequest, MetadataRecord, ClassifiedError, JoinGroupRequest, JoinNamespaceRequest, MigrationStatus, MigrationStatusRollup, MemberMigrationStatusEntry, MigrateMyEntriesSummary, Namespace, SubgroupEntry, NamespaceIdentity, NodeIdentity, RedeemOutcome, RemoveGroupMembersRequest, ReparentGroupRequest, ResyncContextRequest, SetDefaultCapabilitiesRequest, SetSubgroupVisibilityRequest, SetTeeAdmissionPolicyRequest, UpdateMemberRoleRequest, UpgradeGroupRequest, UploadBlobRequest, TokenData } from '@calimero-network/mero-js';
6
6
  export * from '@calimero-network/mero-js';
7
7
  export { CAPABILITIES, Codec, DEFAULT_LOCAL_NODE_PORTS, DiscoverLocalNodesOptions, EphemeralClient, EphemeralEntry, MetadataRecord, discoverLocalNodes, hasCap, localNodeUrl, nodeEndpoint, probeNodeHealth, withCap, withoutCap } from '@calimero-network/mero-js';
8
8
 
@@ -387,6 +387,19 @@ declare function useEphemeral<T>(contextId: string | null, options?: UseEphemera
387
387
  * `name` to keep the current name.
388
388
  */
389
389
  type SetMetadataInput = SetMetadataRequest;
390
+ /** Options a mutation hook that can fail meaningfully accepts. */
391
+ interface MutationOptions {
392
+ /**
393
+ * Rethrow a failed request from the action, after recording it in `error`
394
+ * and `failure`.
395
+ *
396
+ * By default an action resolves `null` on failure, which a caller awaiting it
397
+ * cannot tell apart from "not connected" — and a `catch` around it never
398
+ * runs, so a refused join reads as a successful one. Set this when the
399
+ * caller branches on the outcome.
400
+ */
401
+ throwOnError?: boolean;
402
+ }
390
403
  /**
391
404
  * Execute RPC methods against a context.
392
405
  * Tracks loading/error state. Unmount-safe.
@@ -470,10 +483,16 @@ declare function useDeleteContext(): {
470
483
  loading: boolean;
471
484
  error: Error | null;
472
485
  };
473
- declare function useJoinContext(): {
486
+ /**
487
+ * Join a context. `failure` says what kind of refusal a failed join was, and
488
+ * whether trying again later could work; pass `{ throwOnError: true }` to have
489
+ * `joinContext` reject instead of resolving `null`.
490
+ */
491
+ declare function useJoinContext(options?: MutationOptions): {
474
492
  joinContext: (contextId: string) => Promise<_calimero_network_mero_js.JoinContextResponseData | null>;
475
493
  loading: boolean;
476
494
  error: Error | null;
495
+ failure: ClassifiedError | null;
477
496
  };
478
497
  declare function useJoinSubgroupInheritance(): {
479
498
  joinSubgroupInheritance: (groupId: string) => Promise<_calimero_network_mero_js.JoinSubgroupInheritanceResponseData | null>;
@@ -580,10 +599,39 @@ declare function useCreateNamespaceInvitation(): {
580
599
  loading: boolean;
581
600
  error: Error | null;
582
601
  };
583
- declare function useJoinNamespace(): {
602
+ /**
603
+ * Join a namespace by invitation. `failure` says what kind of refusal a failed
604
+ * join was, and whether trying again later could work; pass
605
+ * `{ throwOnError: true }` to have `joinNamespace` reject instead of resolving
606
+ * `null`.
607
+ *
608
+ * To follow an invitation link, prefer {@link useRedeemInvitation}: it also
609
+ * recognises a join that landed although its request failed.
610
+ */
611
+ declare function useJoinNamespace(options?: MutationOptions): {
584
612
  joinNamespace: (namespaceId: string, request: JoinNamespaceRequest) => Promise<_calimero_network_mero_js.JoinNamespaceResponseData | null>;
585
613
  loading: boolean;
586
614
  error: Error | null;
615
+ failure: ClassifiedError | null;
616
+ };
617
+ /**
618
+ * Follow an invitation: join its namespace once, then check membership, and
619
+ * report what happened as a {@link RedeemOutcome}.
620
+ *
621
+ * Unlike {@link useJoinNamespace}, a request that failed but whose join landed
622
+ * anyway — the desktop proxy aborts at 30s, a join with no member online takes
623
+ * longer — is `already-member`, not a failure. `shouldRetain(outcome)` from
624
+ * mero-js says whether to keep the invitation for another attempt.
625
+ *
626
+ * `redeem` resolves `null` only when there is no client to send it through.
627
+ */
628
+ declare function useRedeemInvitation(): {
629
+ redeem: (namespaceId: string, invitation: JoinNamespaceRequest["invitation"], options?: {
630
+ groupName?: string;
631
+ teamName?: string;
632
+ }) => Promise<RedeemOutcome | null>;
633
+ outcome: RedeemOutcome | null;
634
+ loading: boolean;
587
635
  };
588
636
  declare function useCreateGroupInNamespace(): {
589
637
  createGroupInNamespace: (namespaceId: string, request?: CreateGroupInNamespaceRequest) => Promise<_calimero_network_mero_js.CreateGroupInNamespaceResponseData | null>;
@@ -1018,4 +1066,4 @@ declare function clearContextIdentity(): void;
1018
1066
  */
1019
1067
  declare function clearAllStorage(): void;
1020
1068
 
1021
- 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 };
1069
+ 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 MutationOptions, 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, useRedeemInvitation, useRemoveGroupMembers, useReparentGroup, useResyncContext, useRetryGroupUpgrade, useSetContextMetadata, useSetDefaultCapabilities, useSetGroupMetadata, useSetMemberMetadata, useSetSubgroupVisibility, useSetTeeAdmissionPolicy, useSubgroupVisibility, useSubgroups, useSubscription, useSyncGroup, useUpdateMemberRole, useUpgradeGroup, useUploadBlob };
package/dist/index.d.ts CHANGED
@@ -2,7 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
2
2
  import * as React from 'react';
3
3
  import React__default, { CSSProperties, ReactNode } from 'react';
4
4
  import * as _calimero_network_mero_js from '@calimero-network/mero-js';
5
- 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';
5
+ import { MeroJs, TokenStore, SetMetadataRequest, SseEventData, GroupMembershipEventData, GroupMigrationEventData, Codec, AddGroupMembersRequest, GetBlobInfoResponseData, CreateContextRequest, CreateGroupInNamespaceRequest, CreateNamespaceRequest, CreateNamespaceInvitationRequest, CreateNamespaceInvitationResponseData, CreateRecursiveInvitationResponseData, GroupUpgradeStatusResponseData, GroupContextEntry, GroupInfo, CreateGroupInvitationRequest, MetadataRecord, ClassifiedError, JoinGroupRequest, JoinNamespaceRequest, MigrationStatus, MigrationStatusRollup, MemberMigrationStatusEntry, MigrateMyEntriesSummary, Namespace, SubgroupEntry, NamespaceIdentity, NodeIdentity, RedeemOutcome, RemoveGroupMembersRequest, ReparentGroupRequest, ResyncContextRequest, SetDefaultCapabilitiesRequest, SetSubgroupVisibilityRequest, SetTeeAdmissionPolicyRequest, UpdateMemberRoleRequest, UpgradeGroupRequest, UploadBlobRequest, TokenData } from '@calimero-network/mero-js';
6
6
  export * from '@calimero-network/mero-js';
7
7
  export { CAPABILITIES, Codec, DEFAULT_LOCAL_NODE_PORTS, DiscoverLocalNodesOptions, EphemeralClient, EphemeralEntry, MetadataRecord, discoverLocalNodes, hasCap, localNodeUrl, nodeEndpoint, probeNodeHealth, withCap, withoutCap } from '@calimero-network/mero-js';
8
8
 
@@ -387,6 +387,19 @@ declare function useEphemeral<T>(contextId: string | null, options?: UseEphemera
387
387
  * `name` to keep the current name.
388
388
  */
389
389
  type SetMetadataInput = SetMetadataRequest;
390
+ /** Options a mutation hook that can fail meaningfully accepts. */
391
+ interface MutationOptions {
392
+ /**
393
+ * Rethrow a failed request from the action, after recording it in `error`
394
+ * and `failure`.
395
+ *
396
+ * By default an action resolves `null` on failure, which a caller awaiting it
397
+ * cannot tell apart from "not connected" — and a `catch` around it never
398
+ * runs, so a refused join reads as a successful one. Set this when the
399
+ * caller branches on the outcome.
400
+ */
401
+ throwOnError?: boolean;
402
+ }
390
403
  /**
391
404
  * Execute RPC methods against a context.
392
405
  * Tracks loading/error state. Unmount-safe.
@@ -470,10 +483,16 @@ declare function useDeleteContext(): {
470
483
  loading: boolean;
471
484
  error: Error | null;
472
485
  };
473
- declare function useJoinContext(): {
486
+ /**
487
+ * Join a context. `failure` says what kind of refusal a failed join was, and
488
+ * whether trying again later could work; pass `{ throwOnError: true }` to have
489
+ * `joinContext` reject instead of resolving `null`.
490
+ */
491
+ declare function useJoinContext(options?: MutationOptions): {
474
492
  joinContext: (contextId: string) => Promise<_calimero_network_mero_js.JoinContextResponseData | null>;
475
493
  loading: boolean;
476
494
  error: Error | null;
495
+ failure: ClassifiedError | null;
477
496
  };
478
497
  declare function useJoinSubgroupInheritance(): {
479
498
  joinSubgroupInheritance: (groupId: string) => Promise<_calimero_network_mero_js.JoinSubgroupInheritanceResponseData | null>;
@@ -580,10 +599,39 @@ declare function useCreateNamespaceInvitation(): {
580
599
  loading: boolean;
581
600
  error: Error | null;
582
601
  };
583
- declare function useJoinNamespace(): {
602
+ /**
603
+ * Join a namespace by invitation. `failure` says what kind of refusal a failed
604
+ * join was, and whether trying again later could work; pass
605
+ * `{ throwOnError: true }` to have `joinNamespace` reject instead of resolving
606
+ * `null`.
607
+ *
608
+ * To follow an invitation link, prefer {@link useRedeemInvitation}: it also
609
+ * recognises a join that landed although its request failed.
610
+ */
611
+ declare function useJoinNamespace(options?: MutationOptions): {
584
612
  joinNamespace: (namespaceId: string, request: JoinNamespaceRequest) => Promise<_calimero_network_mero_js.JoinNamespaceResponseData | null>;
585
613
  loading: boolean;
586
614
  error: Error | null;
615
+ failure: ClassifiedError | null;
616
+ };
617
+ /**
618
+ * Follow an invitation: join its namespace once, then check membership, and
619
+ * report what happened as a {@link RedeemOutcome}.
620
+ *
621
+ * Unlike {@link useJoinNamespace}, a request that failed but whose join landed
622
+ * anyway — the desktop proxy aborts at 30s, a join with no member online takes
623
+ * longer — is `already-member`, not a failure. `shouldRetain(outcome)` from
624
+ * mero-js says whether to keep the invitation for another attempt.
625
+ *
626
+ * `redeem` resolves `null` only when there is no client to send it through.
627
+ */
628
+ declare function useRedeemInvitation(): {
629
+ redeem: (namespaceId: string, invitation: JoinNamespaceRequest["invitation"], options?: {
630
+ groupName?: string;
631
+ teamName?: string;
632
+ }) => Promise<RedeemOutcome | null>;
633
+ outcome: RedeemOutcome | null;
634
+ loading: boolean;
587
635
  };
588
636
  declare function useCreateGroupInNamespace(): {
589
637
  createGroupInNamespace: (namespaceId: string, request?: CreateGroupInNamespaceRequest) => Promise<_calimero_network_mero_js.CreateGroupInNamespaceResponseData | null>;
@@ -1018,4 +1066,4 @@ declare function clearContextIdentity(): void;
1018
1066
  */
1019
1067
  declare function clearAllStorage(): void;
1020
1068
 
1021
- 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 };
1069
+ 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 MutationOptions, 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, useRedeemInvitation, useRemoveGroupMembers, useReparentGroup, useResyncContext, useRetryGroupUpgrade, useSetContextMetadata, useSetDefaultCapabilities, useSetGroupMetadata, useSetMemberMetadata, useSetSubgroupVisibility, useSetTeeAdmissionPolicy, useSubgroupVisibility, useSubgroups, useSubscription, useSyncGroup, useUpdateMemberRole, useUpgradeGroup, useUploadBlob };
package/dist/index.js CHANGED
@@ -1,5 +1,5 @@
1
1
  import { createContext, useMemo, useState, useRef, useCallback, useEffect, useContext } from 'react';
2
- import { LocalStorageTokenStore, parseAuthCallback, MeroJs, buildAuthLoginUrl, DEFAULT_LOCAL_NODE_PORTS, discoverLocalNodes, nodeEndpoint, compareSemver, AuthRevokedError, HTTPError } from '@calimero-network/mero-js';
2
+ import { LocalStorageTokenStore, parseAuthCallback, MeroJs, buildAuthLoginUrl, DEFAULT_LOCAL_NODE_PORTS, discoverLocalNodes, nodeEndpoint, compareSemver, AuthRevokedError, HTTPError, classifyError } from '@calimero-network/mero-js';
3
3
  export * from '@calimero-network/mero-js';
4
4
  export { CAPABILITIES, DEFAULT_LOCAL_NODE_PORTS, discoverLocalNodes, hasCap, localNodeUrl, nodeEndpoint, probeNodeHealth, withCap, withoutCap } from '@calimero-network/mero-js';
5
5
  import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
@@ -1508,23 +1508,26 @@ function useMountedRef() {
1508
1508
  }, []);
1509
1509
  return mountedRef;
1510
1510
  }
1511
- function useAsyncMutation() {
1511
+ function useAsyncMutation({ throwOnError = false } = {}) {
1512
1512
  const mountedRef = useMountedRef();
1513
1513
  const [loading, setLoading] = useState(false);
1514
1514
  const [error, setError] = useState(null);
1515
+ const [failure, setFailure] = useState(null);
1515
1516
  const run = useCallback(
1516
1517
  async (action) => {
1517
1518
  if (mountedRef.current) {
1518
1519
  setLoading(true);
1519
1520
  setError(null);
1521
+ setFailure(null);
1520
1522
  }
1521
1523
  try {
1522
1524
  return await action();
1523
1525
  } catch (err) {
1524
- const errorValue = toError(err);
1525
1526
  if (mountedRef.current) {
1526
- setError(errorValue);
1527
+ setError(toError(err));
1528
+ setFailure(classifyError(err));
1527
1529
  }
1530
+ if (throwOnError) throw err;
1528
1531
  return null;
1529
1532
  } finally {
1530
1533
  if (mountedRef.current) {
@@ -1532,9 +1535,9 @@ function useAsyncMutation() {
1532
1535
  }
1533
1536
  }
1534
1537
  },
1535
- [mountedRef]
1538
+ [mountedRef, throwOnError]
1536
1539
  );
1537
- return { loading, error, run, setError };
1540
+ return { loading, error, failure, run, setError };
1538
1541
  }
1539
1542
  function useAsyncResource(fetcher, initialValue, deps) {
1540
1543
  const mountedRef = useMountedRef();
@@ -1928,9 +1931,9 @@ function useDeleteContext() {
1928
1931
  );
1929
1932
  return { deleteContext, loading, error };
1930
1933
  }
1931
- function useJoinContext() {
1934
+ function useJoinContext(options = {}) {
1932
1935
  const { mero } = useMero();
1933
- const { loading, error, run } = useAsyncMutation();
1936
+ const { loading, error, failure, run } = useAsyncMutation(options);
1934
1937
  const joinContext = useCallback(
1935
1938
  async (contextId) => {
1936
1939
  if (!mero) return null;
@@ -1938,7 +1941,7 @@ function useJoinContext() {
1938
1941
  },
1939
1942
  [mero, run]
1940
1943
  );
1941
- return { joinContext, loading, error };
1944
+ return { joinContext, loading, error, failure };
1942
1945
  }
1943
1946
  function useJoinSubgroupInheritance() {
1944
1947
  const { mero } = useMero();
@@ -2099,9 +2102,9 @@ function useCreateNamespaceInvitation() {
2099
2102
  );
2100
2103
  return { createNamespaceInvitation, loading, error };
2101
2104
  }
2102
- function useJoinNamespace() {
2105
+ function useJoinNamespace(options = {}) {
2103
2106
  const { mero } = useMero();
2104
- const { loading, error, run } = useAsyncMutation();
2107
+ const { loading, error, failure, run } = useAsyncMutation(options);
2105
2108
  const joinNamespace = useCallback(
2106
2109
  async (namespaceId, request) => {
2107
2110
  if (!mero) return null;
@@ -2109,7 +2112,31 @@ function useJoinNamespace() {
2109
2112
  },
2110
2113
  [mero, run]
2111
2114
  );
2112
- return { joinNamespace, loading, error };
2115
+ return { joinNamespace, loading, error, failure };
2116
+ }
2117
+ function useRedeemInvitation() {
2118
+ const { mero } = useMero();
2119
+ const mountedRef = useMountedRef();
2120
+ const [loading, setLoading] = useState(false);
2121
+ const [outcome, setOutcome] = useState(null);
2122
+ const redeem = useCallback(
2123
+ async (namespaceId, invitation, options = {}) => {
2124
+ if (!mero) return null;
2125
+ if (mountedRef.current) {
2126
+ setLoading(true);
2127
+ setOutcome(null);
2128
+ }
2129
+ try {
2130
+ const result = await mero.admin.redeemInvitation(namespaceId, invitation, options);
2131
+ if (mountedRef.current) setOutcome(result);
2132
+ return result;
2133
+ } finally {
2134
+ if (mountedRef.current) setLoading(false);
2135
+ }
2136
+ },
2137
+ [mero, mountedRef]
2138
+ );
2139
+ return { redeem, outcome, loading };
2113
2140
  }
2114
2141
  function useCreateGroupInNamespace() {
2115
2142
  const { mero } = useMero();
@@ -2930,6 +2957,6 @@ function MigrationAdminPanel({ namespaceId, pollIntervalMs, className }) {
2930
2957
  ] });
2931
2958
  }
2932
2959
 
2933
- 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 };
2960
+ 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, useRedeemInvitation, useRemoveGroupMembers, useReparentGroup, useResyncContext, useRetryGroupUpgrade, useSetContextMetadata, useSetDefaultCapabilities, useSetGroupMetadata, useSetMemberMetadata, useSetSubgroupVisibility, useSetTeeAdmissionPolicy, useSubgroupVisibility, useSubgroups, useSubscription, useSyncGroup, useUpdateMemberRole, useUpgradeGroup, useUploadBlob };
2934
2961
  //# sourceMappingURL=index.js.map
2935
2962
  //# sourceMappingURL=index.js.map