@calimero-network/mero-react 9.1.2 → 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 } 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';
@@ -498,7 +498,22 @@ function MeroProvider({
498
498
  const onError = (err) => {
499
499
  if (!active) return;
500
500
  setIsOnline(false);
501
- if (!err.message.includes("401")) return;
501
+ if (err instanceof AuthRevokedError) {
502
+ logout();
503
+ return;
504
+ }
505
+ if (err instanceof HTTPError && err.status === 403) {
506
+ if (err.headers?.get("x-auth-error") === "permission_denied") {
507
+ console.warn(
508
+ "[MeroProvider] This session cannot open an event stream (403 permission_denied): its token predates the context:subscribe grant. Logging out \u2014 a fresh login mints a key that can subscribe."
509
+ );
510
+ logout();
511
+ return;
512
+ }
513
+ return;
514
+ }
515
+ const status = err instanceof HTTPError ? err.status : null;
516
+ if (status !== 401 && !err.message.includes("401")) return;
502
517
  if (recoveringRef.current) return;
503
518
  recoveringRef.current = true;
504
519
  void (async () => {
@@ -1493,23 +1508,26 @@ function useMountedRef() {
1493
1508
  }, []);
1494
1509
  return mountedRef;
1495
1510
  }
1496
- function useAsyncMutation() {
1511
+ function useAsyncMutation({ throwOnError = false } = {}) {
1497
1512
  const mountedRef = useMountedRef();
1498
1513
  const [loading, setLoading] = useState(false);
1499
1514
  const [error, setError] = useState(null);
1515
+ const [failure, setFailure] = useState(null);
1500
1516
  const run = useCallback(
1501
1517
  async (action) => {
1502
1518
  if (mountedRef.current) {
1503
1519
  setLoading(true);
1504
1520
  setError(null);
1521
+ setFailure(null);
1505
1522
  }
1506
1523
  try {
1507
1524
  return await action();
1508
1525
  } catch (err) {
1509
- const errorValue = toError(err);
1510
1526
  if (mountedRef.current) {
1511
- setError(errorValue);
1527
+ setError(toError(err));
1528
+ setFailure(classifyError(err));
1512
1529
  }
1530
+ if (throwOnError) throw err;
1513
1531
  return null;
1514
1532
  } finally {
1515
1533
  if (mountedRef.current) {
@@ -1517,9 +1535,9 @@ function useAsyncMutation() {
1517
1535
  }
1518
1536
  }
1519
1537
  },
1520
- [mountedRef]
1538
+ [mountedRef, throwOnError]
1521
1539
  );
1522
- return { loading, error, run, setError };
1540
+ return { loading, error, failure, run, setError };
1523
1541
  }
1524
1542
  function useAsyncResource(fetcher, initialValue, deps) {
1525
1543
  const mountedRef = useMountedRef();
@@ -1913,9 +1931,9 @@ function useDeleteContext() {
1913
1931
  );
1914
1932
  return { deleteContext, loading, error };
1915
1933
  }
1916
- function useJoinContext() {
1934
+ function useJoinContext(options = {}) {
1917
1935
  const { mero } = useMero();
1918
- const { loading, error, run } = useAsyncMutation();
1936
+ const { loading, error, failure, run } = useAsyncMutation(options);
1919
1937
  const joinContext = useCallback(
1920
1938
  async (contextId) => {
1921
1939
  if (!mero) return null;
@@ -1923,7 +1941,7 @@ function useJoinContext() {
1923
1941
  },
1924
1942
  [mero, run]
1925
1943
  );
1926
- return { joinContext, loading, error };
1944
+ return { joinContext, loading, error, failure };
1927
1945
  }
1928
1946
  function useJoinSubgroupInheritance() {
1929
1947
  const { mero } = useMero();
@@ -2084,9 +2102,9 @@ function useCreateNamespaceInvitation() {
2084
2102
  );
2085
2103
  return { createNamespaceInvitation, loading, error };
2086
2104
  }
2087
- function useJoinNamespace() {
2105
+ function useJoinNamespace(options = {}) {
2088
2106
  const { mero } = useMero();
2089
- const { loading, error, run } = useAsyncMutation();
2107
+ const { loading, error, failure, run } = useAsyncMutation(options);
2090
2108
  const joinNamespace = useCallback(
2091
2109
  async (namespaceId, request) => {
2092
2110
  if (!mero) return null;
@@ -2094,7 +2112,31 @@ function useJoinNamespace() {
2094
2112
  },
2095
2113
  [mero, run]
2096
2114
  );
2097
- 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 };
2098
2140
  }
2099
2141
  function useCreateGroupInNamespace() {
2100
2142
  const { mero } = useMero();
@@ -2915,6 +2957,6 @@ function MigrationAdminPanel({ namespaceId, pollIntervalMs, className }) {
2915
2957
  ] });
2916
2958
  }
2917
2959
 
2918
- 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 };
2919
2961
  //# sourceMappingURL=index.js.map
2920
2962
  //# sourceMappingURL=index.js.map