Client

import { Client } from "@muhkoo/connect";

const client = new Client(options);

new Client(options)

Option	Type	Required	Default	Description
apiKey	string	recommended	—	App key (mk_…). Sent as X-Muhkoo-Key.
baseUrl	string	no	the hosted accelerator	Absolute accelerator URL. Trailing slash optional.
circuits	{ wasmUrl: string; zkeyUrl: string }	no	${baseUrl}/circuits/build/preimagePoK{.wasm,_0001.zkey}	ZK circuit assets for login proofs.
sessionStore	SessionStore	no	in-memory	Session-token persistence.
fetch	typeof fetch	no	globalThis.fetch	Custom fetch.
logLevel	string	no	—	SDK log verbosity.
offline	{ enabled?, store?, cacheShards?, maxQueueBytes? }	no	auto (on in browsers)	Offline cache + sync. On by default in browsers, no-op elsewhere.
accessToken	string	no	—	Machine credential (mk_…_at_…) in place of a user sign-in — see access tokens.
authBaseUrl	string	no	auth.muhkoo.dev	Override the hosted sign-in origin (staging/dev only).
functionsHostSuffix	string	no	the hosted functions domain	Override where client.functions resolves function URLs.
p2p	{ enabled?, workerFactory?, iceServers?, maxPeers?, debug? }	no	off	Peer-to-peer shard exchange between members of a Space — see storage.

All options are optional — new Client() targets the hosted accelerator with an in-memory session.

Namespaces

Property	Type	Description
client.auth	AuthNamespace	Authentication — see client.auth.
client.kv	KvNamespace	Encrypted key/value — see client.kv.
client.db	DbNamespace	Scalable app database — see client.db.
client.storage	StorageNamespace	File storage — see client.storage.
client.vfs	VfsNamespace	The user’s filesystem: directories, paths, versions — see client.vfs.
client.message	MessageNamespace	Realtime pub/sub — see client.message.
client.space	SpaceNamespace	Group channels — see client.space.
client.offline	OfflineManager	Offline cache, status & snapshots — see client.offline.
client.agents	AgentsNamespace	Programmable Agents — see client.agents.
client.functions	FunctionsNamespace	Serverless functions — see client.functions.
client.accessTokens	AccessTokensNamespace	Scoped machine credentials — see access tokens.

Properties

Property	Type	Description
client.user	{ username: string; commitment: string } | null	The signed-in user (sync read).
client.isAuthenticated	boolean	Whether a session token is active (sync read).
client.baseUrl	string	The normalized accelerator URL.

Session recovery

When a token-gated request comes back 401 (the session went stale), the client silently re-authenticates if it still holds the user’s identity (i.e. they logged in this session and never reloaded), then retries the request — so a transient expiry self-heals without surfacing an error.

Method	Signature	Description
client.recoverSession()	() => Promise<boolean>	Attempt a silent re-auth now. Concurrent calls share one attempt. Resolves true on success. Call proactively if you like (e.g. on visibilitychange).
client.onSessionExpired(handler)	(() => void) => () => void	Fires when recovery isn’t possible — typically after a reload that kept only a now-stale token. This is your cue to route the user to the login screen. Returns an unsubscribe fn.

const off = client.onSessionExpired(() => router.push("/login"));

SessionStore

interface StoredSession {
  token: string;
  username: string;
  commitment: string;
}

interface SessionStore {
  load(): StoredSession | null | Promise<StoredSession | null>;
  save(session: StoredSession): void | Promise<void>;
  clear(): void | Promise<void>;
}

The SDK ships MemorySessionStore (the default). Provide your own to persist across reloads — see Installation.