hyperstack-react 0.3.15 → 0.4.1

package/dist/index.d.ts

@@ -4,10 +4,6 @@ export { AccountCategory, AccountMeta, AccountResolutionOptions, AccountResoluti
 import { UseBoundStore, StoreApi } from 'zustand';
 
 type ViewMode = 'state' | 'list';
-interface NetworkConfig {
-    name: string;
-    websocketUrl: string;
-}
 interface TransactionDefinition<TParams = unknown> {
     build: (params: TParams) => {
         instruction: string;
@@ -18,10 +14,14 @@ interface TransactionDefinition<TParams = unknown> {
         key?: string | ((params: TParams) => string);
     }>;
 }
+/**
+ * Global configuration for HyperstackProvider.
+ *
+ * Note: WebSocket URL is no longer configured here. The URL is:
+ * 1. Embedded in the stack definition (stack.url)
+ * 2. Optionally overridden per-hook via useHyperstack(stack, { url: '...' })
+ */
 interface HyperstackConfig {
-    websocketUrl?: string;
-    network?: 'devnet' | 'mainnet' | 'localnet' | NetworkConfig;
-    apiKey?: string;
     autoConnect?: boolean;
     wallet?: WalletAdapter;
     reconnectIntervals?: number[];
@@ -29,6 +29,13 @@ interface HyperstackConfig {
     maxEntriesPerView?: number | null;
     flushIntervalMs?: number;
 }
+/**
+ * Options for useHyperstack hook
+ */
+interface UseHyperstackOptions {
+    /** Override the stack's embedded URL (useful for local development) */
+    url?: string;
+}
 interface ViewHookOptions {
     enabled?: boolean;
     initialData?: unknown;
@@ -73,15 +80,9 @@ interface ListViewHook<T> {
 }
 
 interface HyperstackContextValue {
-    getOrCreateClient: <TStack extends StackDefinition>(stack: TStack) => Promise<HyperStack<TStack>>;
+    getOrCreateClient: <TStack extends StackDefinition>(stack: TStack, urlOverride?: string) => Promise<HyperStack<TStack>>;
     getClient: <TStack extends StackDefinition>(stack: TStack | undefined) => HyperStack<TStack> | null;
-    config: {
-        websocketUrl: string;
-        autoConnect?: boolean;
-        reconnectIntervals?: number[];
-        maxReconnectAttempts?: number;
-        maxEntriesPerView?: number | null;
-    };
+    config: HyperstackConfig;
 }
 declare function HyperstackProvider({ children, fallback, ...config }: HyperstackConfig & {
     children: ReactNode;
@@ -109,7 +110,6 @@ declare function useInstructionMutation(execute: InstructionExecutor): UseMutati
 
 interface ZustandState {
     entities: Map<string, Map<string, unknown>>;
-    sortedKeys: Map<string, string[]>;
     viewConfigs: Map<string, ViewSortConfig>;
     connectionState: ConnectionState;
     lastError?: string;
@@ -120,7 +120,6 @@ interface ZustandActions {
     _clear: (viewPath?: string) => void;
     _setConnectionState: (state: ConnectionState, error?: string) => void;
     _setViewConfig: (viewPath: string, config: ViewSortConfig) => void;
-    _updateSortedKeys: (viewPath: string, sortedKeys: string[]) => void;
 }
 type HyperStackStore = ZustandState & ZustandActions;
 declare class ZustandAdapter implements StorageAdapter {
@@ -147,7 +146,6 @@ declare class ZustandAdapter implements StorageAdapter {
     setConnectionState(state: ConnectionState, error?: string): void;
     setViewConfig(viewPath: string, config: ViewSortConfig): void;
     getViewConfig(viewPath: string): ViewSortConfig | undefined;
-    private rebuildSortedKeys;
 }
 
 type ViewHookForDef<TDef> = TDef extends ViewDef<infer T, 'state'> ? {
@@ -185,7 +183,7 @@ type StackClient<TStack extends StackDefinition> = {
     isLoading: boolean;
     error: Error | null;
 };
-declare function useHyperstack<TStack extends StackDefinition>(stack: TStack): StackClient<TStack>;
+declare function useHyperstack<TStack extends StackDefinition>(stack: TStack, options?: UseHyperstackOptions): StackClient<TStack>;
 
 export { HyperstackProvider, ZustandAdapter, useConnectionState, useEntity, useHyperstack, useHyperstackContext, useInstructionMutation, useView };
-export type { HyperStackStore, HyperstackConfig, ListParams, ListParamsBase, ListParamsMultiple, ListParamsSingle, ListViewHook, MutationStatus, NetworkConfig, StateViewHook, TransactionDefinition, UseMutationOptions, UseMutationResult, UseMutationReturn, ViewHookOptions, ViewHookResult, ViewMode };
+export type { HyperStackStore, HyperstackConfig, ListParams, ListParamsBase, ListParamsMultiple, ListParamsSingle, ListViewHook, MutationStatus, StateViewHook, TransactionDefinition, UseHyperstackOptions, UseMutationOptions, UseMutationResult, UseMutationReturn, ViewHookOptions, ViewHookResult, ViewMode };