@calimero-network/mero-react 4.0.1 → 4.1.1

package/dist/index.d.cts

@@ -274,11 +274,17 @@ interface LoginModalProps {
     isOpen: boolean;
     /** Theme overrides — accepts any subset of `MeroTheme` tokens */
     theme?: MeroTheme;
+    /**
+     * Ports probed when discovering remote/local nodes. Defaults to the
+     * well-known Calimero dev ports (2428, 2429, 2528, 2529). Mostly an escape
+     * hatch for non-standard setups and tests.
+     */
+    localNodePorts?: readonly number[];
 }
 /**
  * LoginModal - Connection modal component
  */
-declare function LoginModal({ onConnect, onClose, connectionType, isOpen, theme, }: LoginModalProps): React.ReactPortal | null;
+declare function LoginModal({ onConnect, onClose, connectionType, isOpen, theme, localNodePorts, }: LoginModalProps): React.ReactPortal | null;
 
 interface CalimeroLogoProps extends React__default.SVGAttributes<SVGSVGElement> {
     /** Width / height shorthand (applied to both). Default: 24. */
@@ -316,6 +322,54 @@ interface MigrationAdminPanelProps {
  */
 declare function MigrationAdminPanel({ namespaceId, pollIntervalMs, className }: MigrationAdminPanelProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Local-node discovery.
+ *
+ * Calimero dev/desktop nodes expose a public, unauthenticated health endpoint
+ * at `GET {nodeUrl}/admin-api/health` that returns `{ "data": { "status":
+ * "alive" } }`. The most common local layouts run on a small, well-known set of
+ * ports, so instead of forcing the user to type a URL we probe those ports and
+ * offer whatever is actually running.
+ */
+/**
+ * Default ports probed when discovering local nodes. Covers the two-node dev
+ * stacks used across the Calimero apps (RPC + alt ports for node1 / node2).
+ */
+declare const DEFAULT_LOCAL_NODE_PORTS: readonly [2428, 2429, 2528, 2529];
+interface DiscoverLocalNodesOptions {
+    /** Ports to probe. Defaults to {@link DEFAULT_LOCAL_NODE_PORTS}. */
+    ports?: readonly number[];
+    /** Per-probe timeout in ms. Defaults to 2000. */
+    timeoutMs?: number;
+    /** Abort the whole discovery (e.g. when the modal closes). */
+    signal?: AbortSignal;
+}
+/** Build the canonical base URL for a local node on the given port. */
+declare function localNodeUrl(port: number): string;
+/**
+ * Resolve an API `path` against a node `baseUrl`. Ensures the base ends with a
+ * slash first, so a base that carries a path prefix (e.g. a `NODE_PATH_PREFIX`
+ * deployment like `http://host/node1`) keeps that segment instead of having it
+ * stripped by relative URL resolution.
+ */
+declare function nodeEndpoint(baseUrl: string, path: string): string;
+/**
+ * Probe a single node's health endpoint. Resolves `true` only when the node
+ * answers with a 2xx and (when the body is JSON) reports a non-dead status.
+ * Any network error, timeout, or non-ok response resolves `false` — never
+ * throws (except on an external abort, which is swallowed as `false`).
+ */
+declare function probeNodeHealth(baseUrl: string, options?: {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}): Promise<boolean>;
+/**
+ * Probe the configured local ports in parallel and return the base URLs that
+ * responded as healthy, in the same order as the `ports` argument (which
+ * defaults to ascending). Returns an empty array when nothing local is running.
+ */
+declare function discoverLocalNodes(options?: DiscoverLocalNodesOptions): Promise<string[]>;
+
 /**
  * Shape accepted by the metadata-setter hooks — re-exported from mero-js so
  * callers have one canonical type. A `set*Metadata` call **replaces the whole
@@ -734,4 +788,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, type ExecutionResult, LoginModal, type LoginModalProps, MERO_CSS_VARS, MeroContext, type MeroContextValue, MeroProvider, type MeroProviderConfig, type MeroProviderProps, type MeroTheme, MigrationAdminPanel, type MigrationAdminPanelProps, MigrationPendingBanner, type MigrationPendingBannerProps, type ResolvedMeroTheme, type SetMetadataInput, clearAllStorage, clearApplicationId, clearContextId, clearContextIdentity, clearNodeUrl, cssVar, defaultMeroTheme, getApplicationId, getContextId, getContextIdentity, getNodeUrl, localStorageTokenStorage, resolveMeroTheme, setApplicationId, setContextId, setContextIdentity, setNodeUrl, themeToCssVars, useAddGroupMembers, useAppVersion, useApplicationContexts, useContextDiscovery, useContextGroup, useContexts, useCreateContext, useCreateGroupInNamespace, useCreateNamespace, useCreateNamespaceInvitation, useDefaultCapabilities, useDeleteContext, useDeleteGroup, useDeleteNamespace, useDetachContextFromGroup, useExecute, useGroupCapabilities, useGroupContexts, useGroupInfo, useGroupInvitations, useGroupMembers, useGroupMetadata, useGroupUpgradeStatus, useJoinContext, useJoinGroup, useJoinNamespace, useJoinSubgroupInheritance, useLatestVersion, useMemberMetadata, useMero, useMigrationStatus, useMyAuthoredMigration, useNamespace, useNamespaceGroups, useNamespaceIdentity, useNamespaces, useNamespacesForApplication, useRegisterGroupSigningKey, useRemoveGroupMembers, useReparentGroup, useResyncContext, useRetryGroupUpgrade, useSetContextMetadata, useSetDefaultCapabilities, useSetGroupMetadata, useSetMemberMetadata, useSetSubgroupVisibility, useSetTeeAdmissionPolicy, useSubgroupVisibility, useSubgroups, useSubscription, useSyncGroup, useUpdateGroupSettings, useUpdateMemberRole, useUpgradeGroup };
+export { type AppContext, AppMode, type ApplicationContextRecord, CalimeroLogo, type CalimeroLogoProps, ConnectButton, type ConnectButtonProps, ConnectionType, type ContextDiscoveryOptions, type ContextDiscoveryState, type CustomConnectionConfig, DEFAULT_LOCAL_NODE_PORTS, type DiscoverLocalNodesOptions, type ExecutionResult, LoginModal, type LoginModalProps, MERO_CSS_VARS, MeroContext, type MeroContextValue, MeroProvider, type MeroProviderConfig, type MeroProviderProps, type MeroTheme, MigrationAdminPanel, type MigrationAdminPanelProps, MigrationPendingBanner, type MigrationPendingBannerProps, type ResolvedMeroTheme, type SetMetadataInput, clearAllStorage, clearApplicationId, clearContextId, clearContextIdentity, clearNodeUrl, cssVar, defaultMeroTheme, discoverLocalNodes, getApplicationId, getContextId, getContextIdentity, getNodeUrl, localNodeUrl, localStorageTokenStorage, nodeEndpoint, probeNodeHealth, resolveMeroTheme, setApplicationId, setContextId, setContextIdentity, setNodeUrl, themeToCssVars, useAddGroupMembers, useAppVersion, useApplicationContexts, useContextDiscovery, useContextGroup, useContexts, useCreateContext, useCreateGroupInNamespace, useCreateNamespace, useCreateNamespaceInvitation, useDefaultCapabilities, useDeleteContext, useDeleteGroup, useDeleteNamespace, useDetachContextFromGroup, useExecute, useGroupCapabilities, useGroupContexts, useGroupInfo, useGroupInvitations, useGroupMembers, useGroupMetadata, useGroupUpgradeStatus, useJoinContext, useJoinGroup, useJoinNamespace, useJoinSubgroupInheritance, useLatestVersion, useMemberMetadata, useMero, useMigrationStatus, useMyAuthoredMigration, useNamespace, useNamespaceGroups, useNamespaceIdentity, useNamespaces, useNamespacesForApplication, useRegisterGroupSigningKey, useRemoveGroupMembers, useReparentGroup, useResyncContext, useRetryGroupUpgrade, useSetContextMetadata, useSetDefaultCapabilities, useSetGroupMetadata, useSetMemberMetadata, useSetSubgroupVisibility, useSetTeeAdmissionPolicy, useSubgroupVisibility, useSubgroups, useSubscription, useSyncGroup, useUpdateGroupSettings, useUpdateMemberRole, useUpgradeGroup };

package/dist/index.d.ts

@@ -274,11 +274,17 @@ interface LoginModalProps {
     isOpen: boolean;
     /** Theme overrides — accepts any subset of `MeroTheme` tokens */
     theme?: MeroTheme;
+    /**
+     * Ports probed when discovering remote/local nodes. Defaults to the
+     * well-known Calimero dev ports (2428, 2429, 2528, 2529). Mostly an escape
+     * hatch for non-standard setups and tests.
+     */
+    localNodePorts?: readonly number[];
 }
 /**
  * LoginModal - Connection modal component
  */
-declare function LoginModal({ onConnect, onClose, connectionType, isOpen, theme, }: LoginModalProps): React.ReactPortal | null;
+declare function LoginModal({ onConnect, onClose, connectionType, isOpen, theme, localNodePorts, }: LoginModalProps): React.ReactPortal | null;
 
 interface CalimeroLogoProps extends React__default.SVGAttributes<SVGSVGElement> {
     /** Width / height shorthand (applied to both). Default: 24. */
@@ -316,6 +322,54 @@ interface MigrationAdminPanelProps {
  */
 declare function MigrationAdminPanel({ namespaceId, pollIntervalMs, className }: MigrationAdminPanelProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Local-node discovery.
+ *
+ * Calimero dev/desktop nodes expose a public, unauthenticated health endpoint
+ * at `GET {nodeUrl}/admin-api/health` that returns `{ "data": { "status":
+ * "alive" } }`. The most common local layouts run on a small, well-known set of
+ * ports, so instead of forcing the user to type a URL we probe those ports and
+ * offer whatever is actually running.
+ */
+/**
+ * Default ports probed when discovering local nodes. Covers the two-node dev
+ * stacks used across the Calimero apps (RPC + alt ports for node1 / node2).
+ */
+declare const DEFAULT_LOCAL_NODE_PORTS: readonly [2428, 2429, 2528, 2529];
+interface DiscoverLocalNodesOptions {
+    /** Ports to probe. Defaults to {@link DEFAULT_LOCAL_NODE_PORTS}. */
+    ports?: readonly number[];
+    /** Per-probe timeout in ms. Defaults to 2000. */
+    timeoutMs?: number;
+    /** Abort the whole discovery (e.g. when the modal closes). */
+    signal?: AbortSignal;
+}
+/** Build the canonical base URL for a local node on the given port. */
+declare function localNodeUrl(port: number): string;
+/**
+ * Resolve an API `path` against a node `baseUrl`. Ensures the base ends with a
+ * slash first, so a base that carries a path prefix (e.g. a `NODE_PATH_PREFIX`
+ * deployment like `http://host/node1`) keeps that segment instead of having it
+ * stripped by relative URL resolution.
+ */
+declare function nodeEndpoint(baseUrl: string, path: string): string;
+/**
+ * Probe a single node's health endpoint. Resolves `true` only when the node
+ * answers with a 2xx and (when the body is JSON) reports a non-dead status.
+ * Any network error, timeout, or non-ok response resolves `false` — never
+ * throws (except on an external abort, which is swallowed as `false`).
+ */
+declare function probeNodeHealth(baseUrl: string, options?: {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}): Promise<boolean>;
+/**
+ * Probe the configured local ports in parallel and return the base URLs that
+ * responded as healthy, in the same order as the `ports` argument (which
+ * defaults to ascending). Returns an empty array when nothing local is running.
+ */
+declare function discoverLocalNodes(options?: DiscoverLocalNodesOptions): Promise<string[]>;
+
 /**
  * Shape accepted by the metadata-setter hooks — re-exported from mero-js so
  * callers have one canonical type. A `set*Metadata` call **replaces the whole
@@ -734,4 +788,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, type ExecutionResult, LoginModal, type LoginModalProps, MERO_CSS_VARS, MeroContext, type MeroContextValue, MeroProvider, type MeroProviderConfig, type MeroProviderProps, type MeroTheme, MigrationAdminPanel, type MigrationAdminPanelProps, MigrationPendingBanner, type MigrationPendingBannerProps, type ResolvedMeroTheme, type SetMetadataInput, clearAllStorage, clearApplicationId, clearContextId, clearContextIdentity, clearNodeUrl, cssVar, defaultMeroTheme, getApplicationId, getContextId, getContextIdentity, getNodeUrl, localStorageTokenStorage, resolveMeroTheme, setApplicationId, setContextId, setContextIdentity, setNodeUrl, themeToCssVars, useAddGroupMembers, useAppVersion, useApplicationContexts, useContextDiscovery, useContextGroup, useContexts, useCreateContext, useCreateGroupInNamespace, useCreateNamespace, useCreateNamespaceInvitation, useDefaultCapabilities, useDeleteContext, useDeleteGroup, useDeleteNamespace, useDetachContextFromGroup, useExecute, useGroupCapabilities, useGroupContexts, useGroupInfo, useGroupInvitations, useGroupMembers, useGroupMetadata, useGroupUpgradeStatus, useJoinContext, useJoinGroup, useJoinNamespace, useJoinSubgroupInheritance, useLatestVersion, useMemberMetadata, useMero, useMigrationStatus, useMyAuthoredMigration, useNamespace, useNamespaceGroups, useNamespaceIdentity, useNamespaces, useNamespacesForApplication, useRegisterGroupSigningKey, useRemoveGroupMembers, useReparentGroup, useResyncContext, useRetryGroupUpgrade, useSetContextMetadata, useSetDefaultCapabilities, useSetGroupMetadata, useSetMemberMetadata, useSetSubgroupVisibility, useSetTeeAdmissionPolicy, useSubgroupVisibility, useSubgroups, useSubscription, useSyncGroup, useUpdateGroupSettings, useUpdateMemberRole, useUpgradeGroup };
+export { type AppContext, AppMode, type ApplicationContextRecord, CalimeroLogo, type CalimeroLogoProps, ConnectButton, type ConnectButtonProps, ConnectionType, type ContextDiscoveryOptions, type ContextDiscoveryState, type CustomConnectionConfig, DEFAULT_LOCAL_NODE_PORTS, type DiscoverLocalNodesOptions, type ExecutionResult, LoginModal, type LoginModalProps, MERO_CSS_VARS, MeroContext, type MeroContextValue, MeroProvider, type MeroProviderConfig, type MeroProviderProps, type MeroTheme, MigrationAdminPanel, type MigrationAdminPanelProps, MigrationPendingBanner, type MigrationPendingBannerProps, type ResolvedMeroTheme, type SetMetadataInput, clearAllStorage, clearApplicationId, clearContextId, clearContextIdentity, clearNodeUrl, cssVar, defaultMeroTheme, discoverLocalNodes, getApplicationId, getContextId, getContextIdentity, getNodeUrl, localNodeUrl, localStorageTokenStorage, nodeEndpoint, probeNodeHealth, resolveMeroTheme, setApplicationId, setContextId, setContextIdentity, setNodeUrl, themeToCssVars, useAddGroupMembers, useAppVersion, useApplicationContexts, useContextDiscovery, useContextGroup, useContexts, useCreateContext, useCreateGroupInNamespace, useCreateNamespace, useCreateNamespaceInvitation, useDefaultCapabilities, useDeleteContext, useDeleteGroup, useDeleteNamespace, useDetachContextFromGroup, useExecute, useGroupCapabilities, useGroupContexts, useGroupInfo, useGroupInvitations, useGroupMembers, useGroupMetadata, useGroupUpgradeStatus, useJoinContext, useJoinGroup, useJoinNamespace, useJoinSubgroupInheritance, useLatestVersion, useMemberMetadata, useMero, useMigrationStatus, useMyAuthoredMigration, useNamespace, useNamespaceGroups, useNamespaceIdentity, useNamespaces, useNamespacesForApplication, useRegisterGroupSigningKey, useRemoveGroupMembers, useReparentGroup, useResyncContext, useRetryGroupUpgrade, useSetContextMetadata, useSetDefaultCapabilities, useSetGroupMetadata, useSetMemberMetadata, useSetSubgroupVisibility, useSetTeeAdmissionPolicy, useSubgroupVisibility, useSubgroups, useSubscription, useSyncGroup, useUpdateGroupSettings, useUpdateMemberRole, useUpgradeGroup };