@hub3js/core 0.61.1 → 0.61.2-next.0

package/src/hub/hub.ts

@@ -1,6 +1,7 @@
 import type { Namespace, State as NamespaceState } from './namespaces/mod.js';
 import type { Provider, State as ProviderState } from './provider/mod.js';
 import type { Store } from './store/mod.js';
+import type { WalletType } from './types.js';
 
 /**
  * Hub stores providers with heterogeneous `TNS` shapes. `Provider<TNS>` is
@@ -20,19 +21,19 @@ import type { Store } from './store/mod.js';
 type AnyProvider = Provider<any>;
 
 type HubState = {
-  [key in string]: ProviderState & {
+  [key in WalletType]: ProviderState & {
     namespaces: NamespaceState[];
   };
 };
 
 type RunAllResult = {
-  id: string;
+  id: WalletType;
   provider: unknown;
   namespaces: unknown[];
 };
 
 type RunAllArgs = {
-  [providerId: string]: {
+  [providerId: WalletType]: {
     provider?: unknown;
     namespaces?: {
       [namespaceId: string]: unknown;
@@ -45,7 +46,7 @@ interface HubOptions {
 }
 
 export class Hub {
-  #providers = new Map<string, AnyProvider>();
+  #providers = new Map<WalletType, AnyProvider>();
   #options: HubOptions;
 
   constructor(options?: HubOptions) {
@@ -103,7 +104,7 @@ export class Hub {
     return output;
   }
 
-  add(id: string, provider: AnyProvider): this {
+  add(id: WalletType, provider: AnyProvider): this {
     if (this.#options.store) {
       provider.store(this.#options.store);
     }
@@ -111,7 +112,7 @@ export class Hub {
     return this;
   }
 
-  remove(id: string): this {
+  remove(id: WalletType): this {
     const providerToRemove = this.#providers.get(id);
 
     if (!providerToRemove) {
@@ -124,11 +125,11 @@ export class Hub {
     return this;
   }
 
-  get(providerId: string): AnyProvider | undefined {
+  get(providerId: WalletType): AnyProvider | undefined {
     return this.#providers.get(providerId);
   }
 
-  getAll(): Map<string, AnyProvider> {
+  getAll(): Map<WalletType, AnyProvider> {
     return this.#providers;
   }
 

package/src/hub/mod.ts

@@ -10,7 +10,13 @@ export { Provider } from './provider/mod.js';
 export type { RegisteredNamespaces } from './provider/mod.js';
 
 export { Hub } from './hub.js';
-export type { Store, State, ProviderMetadata } from './store/mod.js';
+export type {
+  Store,
+  State,
+  ProviderMetadata,
+  NamespacesProperty,
+  DerivationPathProperty,
+} from './store/mod.js';
 export {
   createStore,
   guessProviderStateSelector,
@@ -18,4 +24,4 @@ export {
 } from './store/mod.js';
 export { generateStoreId } from './helpers.js';
 export type { CanEagerConnect } from './namespaces/types.js';
-export type { FunctionWithContext, AnyFunction } from './types.js';
+export type { FunctionWithContext, AnyFunction, WalletType } from './types.js';

package/src/hub/namespaces/namespace.ts

@@ -13,6 +13,7 @@ import type {
   AndFunction,
   AnyFunction,
   FunctionWithContext,
+  WalletType,
 } from '../types.js';
 
 import { generateStoreId, isAsync } from '../helpers.js';
@@ -42,7 +43,7 @@ class Namespace<T extends Actions<T>> {
   /** it will be used for `store` and accessing to store by its id mainly. */
   public readonly namespaceId: string;
   /** it will be used for `store` and accessing to store by its id mainly. */
-  public readonly providerId: string;
+  public readonly providerId: WalletType;
 
   #actions: RegisteredActions<T>;
   #andOperators: Operators<T> = new Map();
@@ -59,7 +60,7 @@ class Namespace<T extends Actions<T>> {
 
   constructor(
     id: string,
-    providerId: string,
+    providerId: WalletType,
     options: {
       store?: Store;
       configs?: NamespaceConfig;

package/src/hub/provider/provider.ts

@@ -8,7 +8,7 @@ import type {
 } from './types.js';
 import type { FindProxiedNamespace } from '../../builders/mod.js';
 import type { ProviderConfig, ProviderInfo, Store } from '../store/mod.js';
-import type { AnyFunction, FunctionWithContext } from '../types.js';
+import type { AnyFunction, FunctionWithContext, WalletType } from '../types.js';
 
 const VERSION = '1.0';
 
@@ -23,7 +23,7 @@ const VERSION = '1.0';
  * to pass via `new Provider<MyNamespaces>(...)`.
  */
 export class Provider<TNS = unknown> {
-  public readonly id: string;
+  public readonly id: WalletType;
   public readonly version = VERSION;
 
   #namespaces: RegisteredNamespaces<TNS>;
@@ -33,7 +33,7 @@ export class Provider<TNS = unknown> {
   #configs: ProviderConfig<TNS>;
 
   constructor(
-    id: string,
+    id: WalletType,
     namespaces: RegisteredNamespaces<TNS>,
     configs: ProviderConfig<TNS>,
     options?: {

package/src/hub/store/events.ts

@@ -1,19 +1,21 @@
+import type { WalletType } from '../types.js';
+
 export type NamespaceDisconnectedEvent = {
   type: 'namespace_disconnected';
-  provider: string;
+  provider: WalletType;
   namespace: string;
 };
 
 export type NamespaceConnectedEvent = {
   type: 'namespace_connected';
-  provider: string;
+  provider: WalletType;
   namespace: string;
   accounts: string[];
 };
 
 export type NamespaceSwitchedAccountEvent = {
   type: 'namespace_account_switched';
-  provider: string;
+  provider: WalletType;
   namespace: string;
   accounts: string[];
   previousAccounts: string[];
@@ -21,7 +23,7 @@ export type NamespaceSwitchedAccountEvent = {
 
 export type NamespaceSwitchedNetworkEvent = {
   type: 'namespace_network_switched';
-  provider: string;
+  provider: WalletType;
   namespace: string;
   network: string;
   previousNetwork: string | null;
@@ -29,23 +31,23 @@ export type NamespaceSwitchedNetworkEvent = {
 
 export type ProviderDetectedEvent = {
   type: 'provider_detected';
-  provider: string;
+  provider: WalletType;
 };
 
 export type ProviderConnectingEvent = {
   type: 'provider_connecting';
-  provider: string;
+  provider: WalletType;
   value: boolean;
 };
 
 export type ProviderConnectedEvent = {
   type: 'provider_connected';
-  provider: string;
+  provider: WalletType;
 };
 
 export type ProviderDisconnectedEvent = {
   type: 'provider_disconnected';
-  provider: string;
+  provider: WalletType;
 };
 
 export type Event =

package/src/hub/store/mod.ts

@@ -21,6 +21,8 @@ export type {
   ProviderConfig,
   ProviderInfo,
   ProviderProperty,
+  NamespacesProperty,
+  DerivationPathProperty,
 } from './providers.js';
 export type { NamespaceConfig, NamespaceData } from './namespaces.js';
 export { createStore } from './store.js';

package/src/hub/store/namespaces.ts

@@ -1,5 +1,6 @@
 /************ Namespace ************/
 
+import type { WalletType } from '../types.js';
 import type { StateCreator } from 'zustand';
 
 import { produce } from 'immer';
@@ -26,7 +27,7 @@ export interface NamespaceData {
 }
 
 interface NamespaceInfo {
-  providerId: string;
+  providerId: WalletType;
   namespaceId: string;
 }
 

package/src/hub/store/providers.ts

@@ -1,4 +1,5 @@
 import type { State as InternalProviderState } from '../provider/mod.js';
+import type { WalletType } from '../types.js';
 import type { SignerFactory } from 'rango-types';
 import type { StateCreator } from 'zustand';
 
@@ -94,20 +95,20 @@ interface ProviderItem {
 
 type ProviderState = {
   events: ConsumableEvents;
-  list: Record<string, ProviderItem>;
+  list: Record<WalletType, ProviderItem>;
 };
 interface ProviderActions {
-  addProvider: (id: string, config: ProviderConfig) => void;
-  removeProvider: (id: string) => void;
+  addProvider: (id: WalletType, config: ProviderConfig) => void;
+  removeProvider: (id: WalletType) => void;
   updateStatus: <K extends keyof ProviderData>(
-    id: string,
+    id: WalletType,
     key: K,
     value: ProviderData[K],
   ) => void;
 
   _produceEventsWhenUpdatingStatus: <K extends keyof ProviderData>(
     provider: ProviderItem,
-    id: string,
+    id: WalletType,
     key: K,
     value: ProviderData[K],
   ) => void;
@@ -118,7 +119,7 @@ interface ProviderSelectors {
    * Provider has a limited state to itself, to be compatible with legacy, we try to produce same object as legacy
    * which includes namespace state as well.
    */
-  guessNamespacesState: (id: string) => InternalProviderState;
+  guessNamespacesState: (id: WalletType) => InternalProviderState;
 }
 
 export type ProviderStore = ProviderState & ProviderActions & ProviderSelectors;
@@ -164,7 +165,7 @@ const providersStore: ProvidersStateCreator = (set, get) => ({
       }),
     );
   },
-  guessNamespacesState: (providerId: string): InternalProviderState => {
+  guessNamespacesState: (providerId: WalletType): InternalProviderState => {
     return guessProviderStateSelector(get(), providerId);
   },
 

package/src/hub/store/selectors.ts

@@ -6,6 +6,7 @@
  */
 import type { State } from '../mod.js';
 import type { State as InternalProviderState } from '../provider/mod.js';
+import type { WalletType } from '../types.js';
 
 /**
  * Legacy provider state includes `connecting` and `connected` values. It hadn't a separation layer for `namespaces`.
@@ -16,7 +17,7 @@ import type { State as InternalProviderState } from '../provider/mod.js';
  */
 export function guessProviderStateSelector(
   state: State,
-  providerId: string,
+  providerId: WalletType,
 ): InternalProviderState {
   /*
    * We keep namespaces in a separate branch than providers.

package/src/hub/types.ts

@@ -1,3 +1,5 @@
+export type WalletType = string;
+
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export type AnyFunction = (...args: any[]) => any;
 // eslint-disable-next-line @typescript-eslint/no-explicit-any

package/src/mod.ts

@@ -4,6 +4,9 @@ export type {
   Store,
   State,
   ProviderMetadata,
+  NamespacesProperty,
+  DerivationPathProperty,
+  WalletType,
   Subscriber,
   SubscriberCleanUp,
   Context,