@hanzo/base 0.2.0

package/dist/react/index.js

@@ -0,0 +1,283 @@
+import { BaseClient } from '../chunk-LBAV5X5P.js';
+export { BaseClient, BaseClientError } from '../chunk-LBAV5X5P.js';
+import { CRDTDocument, CRDTSync } from '../chunk-5NHFZRMO.js';
+import { createContext, useRef, useEffect, useContext, useState, useCallback } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+var BaseContext = createContext(null);
+function BaseProvider({ url, authStore, client: externalClient, children }) {
+  const clientRef = useRef(null);
+  if (externalClient) {
+    clientRef.current = externalClient;
+  } else if (!clientRef.current && url) {
+    const config = { url };
+    if (authStore) config.authStore = authStore;
+    clientRef.current = new BaseClient(config);
+  }
+  const client = clientRef.current;
+  if (!client) {
+    throw new Error("BaseProvider: provide either `url` or `client` prop");
+  }
+  useEffect(() => {
+    return () => {
+      if (!externalClient) {
+        client.disconnect();
+      }
+    };
+  }, [client, externalClient]);
+  return /* @__PURE__ */ jsx(BaseContext, { value: client, children });
+}
+function useBase() {
+  const client = useContext(BaseContext);
+  if (!client) {
+    throw new Error("useBase: must be used within a <BaseProvider>");
+  }
+  return client;
+}
+function useQuery(collection, options) {
+  const client = useBase();
+  const [data, setData] = useState([]);
+  const [isLoading, setIsLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const filter = options?.filter ?? "";
+  const sort = options?.sort;
+  const expand = options?.expand;
+  const fields = options?.fields;
+  const page = options?.page;
+  const perPage = options?.perPage;
+  const realtimeEnabled = options?.realtime !== false;
+  const enabled = options?.enabled !== false;
+  const fetchData = useCallback(async () => {
+    if (!enabled) return;
+    setIsLoading(true);
+    setError(null);
+    try {
+      const result = await client.list(collection, {
+        filter,
+        sort,
+        expand,
+        fields,
+        page,
+        perPage
+      });
+      setData(result.items);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      setIsLoading(false);
+    }
+  }, [client, collection, filter, sort, expand, fields, page, perPage, enabled]);
+  useEffect(() => {
+    fetchData();
+  }, [fetchData]);
+  useEffect(() => {
+    if (!enabled) return;
+    const unsubscribe = client.store.subscribe(collection, filter, (records) => {
+      setData(records);
+    });
+    return unsubscribe;
+  }, [client, collection, filter, enabled]);
+  useEffect(() => {
+    if (!realtimeEnabled || !enabled) return;
+    const unsubscribe = client.subscribeAndSync(collection, "*");
+    return unsubscribe;
+  }, [client, collection, realtimeEnabled, enabled]);
+  return { data, isLoading, error, refetch: fetchData };
+}
+function useMutation(collection, action) {
+  const client = useBase();
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const mutate = useCallback(
+    async (data, opts) => {
+      setIsLoading(true);
+      setError(null);
+      let optimisticId;
+      try {
+        if (opts?.optimistic && action !== "delete") {
+          const tempRecord = {
+            id: data.id ?? `_temp_${Date.now()}`,
+            ...data
+          };
+          optimisticId = client.store.optimisticSet(collection, tempRecord);
+        } else if (opts?.optimistic && action === "delete" && data.id) {
+          optimisticId = client.store.optimisticDelete(collection, data.id);
+        }
+        let result = void 0;
+        switch (action) {
+          case "create":
+            result = await client.create(collection, data);
+            break;
+          case "update": {
+            const id = data.id;
+            if (!id) throw new Error("useMutation: update requires data.id");
+            const { id: _id, ...rest } = data;
+            result = await client.update(collection, id, rest);
+            break;
+          }
+          case "delete": {
+            const id = data.id;
+            if (!id) throw new Error("useMutation: delete requires data.id");
+            await client.delete(collection, id);
+            break;
+          }
+        }
+        if (optimisticId) {
+          client.store.rollbackOptimistic(optimisticId);
+        }
+        return result;
+      } catch (err) {
+        if (optimisticId) {
+          client.store.rollbackOptimistic(optimisticId);
+        }
+        const e = err instanceof Error ? err : new Error(String(err));
+        setError(e);
+        throw e;
+      } finally {
+        setIsLoading(false);
+      }
+    },
+    [client, collection, action]
+  );
+  return { mutate, isLoading, error };
+}
+function useAuth(collection = "users") {
+  const client = useBase();
+  const [user, setUser] = useState(client.authStore.record);
+  const [token, setToken] = useState(client.authStore.token);
+  useEffect(() => {
+    const unsubscribe = client.authStore.onChange((newToken, newRecord) => {
+      setToken(newToken);
+      setUser(newRecord);
+    });
+    return unsubscribe;
+  }, [client]);
+  const signIn = useCallback(
+    async (identity, password) => {
+      await client.signInWithPassword(collection, identity, password);
+    },
+    [client, collection]
+  );
+  const signUp = useCallback(
+    async (data) => {
+      return client.signUp(collection, data);
+    },
+    [client, collection]
+  );
+  const signOut = useCallback(() => {
+    client.signOut();
+  }, [client]);
+  return {
+    user,
+    token,
+    isValid: client.authStore.isValid,
+    signIn,
+    signUp,
+    signOut,
+    onChange: client.authStore.onChange.bind(client.authStore)
+  };
+}
+function useRealtime(collection, topic, callback) {
+  const client = useBase();
+  const callbackRef = useRef(callback);
+  callbackRef.current = callback;
+  useEffect(() => {
+    const unsubscribe = client.realtime.subscribe(collection, topic, (event) => {
+      callbackRef.current(event);
+    });
+    return unsubscribe;
+  }, [client, collection, topic]);
+}
+function useConnectionState() {
+  const client = useBase();
+  const [state, setState] = useState(client.realtime.state);
+  useEffect(() => {
+    const unsubscribe = client.realtime.onConnectionChange((s) => {
+      setState(s);
+    });
+    return unsubscribe;
+  }, [client]);
+  return state;
+}
+function usePresence(sync) {
+  const [peers, setPeers] = useState(/* @__PURE__ */ new Map());
+  const [myState, setMyState] = useState({});
+  useEffect(() => {
+    const unsubscribe = sync.onPeersChange((p) => {
+      setPeers(new Map(p));
+    });
+    return unsubscribe;
+  }, [sync]);
+  const updateState = useCallback(
+    (meta) => {
+      setMyState(meta);
+      sync.updatePresence(meta);
+    },
+    [sync]
+  );
+  return { peers, myState, updateState };
+}
+function useCRDT(documentId, wsUrl) {
+  const client = useBase();
+  const docRef = useRef(null);
+  const syncRef = useRef(null);
+  const [syncState, setSyncState] = useState("disconnected");
+  if (!docRef.current || docRef.current.id !== documentId) {
+    docRef.current = new CRDTDocument(documentId);
+  }
+  if (!syncRef.current) {
+    syncRef.current = new CRDTSync();
+  }
+  const doc = docRef.current;
+  const sync = syncRef.current;
+  useEffect(() => {
+    const url = wsUrl ?? deriveCrdtWsUrl(client.url);
+    const token = client.authStore.token || void 0;
+    sync.connect(url, doc, token);
+    const unsubState = sync.onStateChange((s) => {
+      setSyncState(s);
+    });
+    return () => {
+      unsubState();
+      sync.disconnect();
+    };
+  }, [doc, sync, client, wsUrl]);
+  const text = useCallback((field) => doc.getText(field), [doc]);
+  const counter = useCallback((field) => doc.getCounter(field), [doc]);
+  const set = useCallback((field) => doc.getSet(field), [doc]);
+  const register = useCallback((field) => doc.getRegister(field), [doc]);
+  return { doc, text, counter, set, register, sync, syncState };
+}
+function useCRDTText(doc, field) {
+  const textCrdt = doc.getText(field);
+  const [value, setValue] = useState(() => textCrdt.toString());
+  useEffect(() => {
+    const unsubscribe = textCrdt.onChange((text) => {
+      setValue(text);
+    });
+    return unsubscribe;
+  }, [textCrdt]);
+  return value;
+}
+function useCRDTCounter(doc, field) {
+  const counterCrdt = doc.getCounter(field);
+  const [value, setValue] = useState(() => counterCrdt.value);
+  useEffect(() => {
+    const unsubscribe = counterCrdt.onChange((v) => {
+      setValue(v);
+    });
+    return unsubscribe;
+  }, [counterCrdt]);
+  return value;
+}
+function deriveCrdtWsUrl(httpUrl) {
+  const url = httpUrl.replace(/\/$/, "");
+  if (url.startsWith("https://")) {
+    return url.replace("https://", "wss://") + "/api/crdt";
+  }
+  return url.replace("http://", "ws://") + "/api/crdt";
+}
+
+export { BaseProvider, useAuth, useBase, useCRDT, useCRDTCounter, useCRDTText, useConnectionState, useMutation, usePresence, useQuery, useRealtime };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/context.tsx","../../src/react/hooks.ts"],"names":["useEffect","useRef"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * BaseProvider -- React context providing the BaseClient instance.\n *\n * Usage:\n *   <BaseProvider url=\"https://myapp.hanzo.ai\">\n *     <App />\n *   </BaseProvider>\n *\n *   // or with an existing client:\n *   <BaseProvider client={myClient}>\n *     <App />\n *   </BaseProvider>\n */\n\nimport { createContext, useContext, useRef, useEffect, type ReactNode } from 'react'\nimport { BaseClient, type AuthStore, type ClientConfig } from '../core/client.js'\n\n// ---------------------------------------------------------------------------\n// Context\n// ---------------------------------------------------------------------------\n\nconst BaseContext = createContext<BaseClient | null>(null)\n\n// ---------------------------------------------------------------------------\n// Provider props\n// ---------------------------------------------------------------------------\n\nexport interface BaseProviderProps {\n  /** Base URL for automatic client creation. */\n  url?: string\n  /** Optional auth store override. */\n  authStore?: AuthStore\n  /** Pre-created BaseClient (takes precedence over url). */\n  client?: BaseClient\n  children: ReactNode\n}\n\n// ---------------------------------------------------------------------------\n// Provider\n// ---------------------------------------------------------------------------\n\nexport function BaseProvider({ url, authStore, client: externalClient, children }: BaseProviderProps) {\n  // Use a ref to hold the client so it survives re-renders without\n  // creating a new client on every render.\n  const clientRef = useRef<BaseClient | null>(null)\n\n  if (externalClient) {\n    clientRef.current = externalClient\n  } else if (!clientRef.current && url) {\n    const config: ClientConfig = { url }\n    if (authStore) config.authStore = authStore\n    clientRef.current = new BaseClient(config)\n  }\n\n  const client = clientRef.current\n  if (!client) {\n    throw new Error('BaseProvider: provide either `url` or `client` prop')\n  }\n\n  // Cleanup: disconnect realtime on unmount.\n  useEffect(() => {\n    return () => {\n      // Only disconnect if we own the client (created from url).\n      if (!externalClient) {\n        client.disconnect()\n      }\n    }\n  }, [client, externalClient])\n\n  return <BaseContext value={client}>{children}</BaseContext>\n}\n\n// ---------------------------------------------------------------------------\n// Hook\n// ---------------------------------------------------------------------------\n\n/**\n * Get the BaseClient from the nearest BaseProvider.\n * Throws if used outside a provider.\n */\nexport function useBase(): BaseClient {\n  const client = useContext(BaseContext)\n  if (!client) {\n    throw new Error('useBase: must be used within a <BaseProvider>')\n  }\n  return client\n}\n","/**\n * React hooks for Hanzo Base.\n *\n * All hooks use the BaseClient from the nearest BaseProvider context.\n * They manage subscriptions, cleanup, and state transitions correctly\n * with React 19 patterns (useEffect, useState, useCallback, useRef).\n */\n\nimport {\n  useState,\n  useEffect,\n  useCallback,\n  useRef,\n} from 'react'\n\nimport { useBase } from './context.js'\nimport type { BaseRecord } from '../core/state.js'\nimport type { ListOptions, AuthStore } from '../core/client.js'\nimport type { RealtimeEvent, ConnectionState } from '../core/realtime.js'\nimport type { CRDTDocument } from '../crdt/document.js'\nimport type { CRDTText } from '../crdt/text.js'\nimport type { CRDTCounter } from '../crdt/counter.js'\nimport type { CRDTSet } from '../crdt/set.js'\nimport type { CRDTRegister } from '../crdt/register.js'\nimport type { PeerState, SyncState } from '../crdt/sync.js'\nimport { CRDTSync } from '../crdt/sync.js'\nimport { CRDTDocument as CRDTDocumentImpl } from '../crdt/document.js'\n\n// ---------------------------------------------------------------------------\n// useQuery -- reactive collection query with SSE subscription\n// ---------------------------------------------------------------------------\n\nexport interface UseQueryOptions extends ListOptions {\n  /** Whether to auto-subscribe to realtime updates. Default: true. */\n  realtime?: boolean\n  /** Whether to run the query immediately. Default: true. */\n  enabled?: boolean\n}\n\nexport interface UseQueryResult<T = BaseRecord> {\n  data: T[]\n  isLoading: boolean\n  error: Error | null\n  /** Manually refetch the query. */\n  refetch: () => Promise<void>\n}\n\n/**\n * Reactive query hook.\n *\n * Fetches records from a collection and subscribes to realtime updates.\n * Results are cached in the QueryStore for deduplication across components.\n */\nexport function useQuery<T extends BaseRecord = BaseRecord>(\n  collection: string,\n  options?: UseQueryOptions,\n): UseQueryResult<T> {\n  const client = useBase()\n  const [data, setData] = useState<T[]>([])\n  const [isLoading, setIsLoading] = useState(true)\n  const [error, setError] = useState<Error | null>(null)\n\n  // Stabilize options reference.\n  const filter = options?.filter ?? ''\n  const sort = options?.sort\n  const expand = options?.expand\n  const fields = options?.fields\n  const page = options?.page\n  const perPage = options?.perPage\n  const realtimeEnabled = options?.realtime !== false\n  const enabled = options?.enabled !== false\n\n  const fetchData = useCallback(async () => {\n    if (!enabled) return\n    setIsLoading(true)\n    setError(null)\n    try {\n      const result = await client.list(collection, {\n        filter, sort, expand, fields, page, perPage,\n      })\n      setData(result.items as T[])\n    } catch (err) {\n      setError(err instanceof Error ? err : new Error(String(err)))\n    } finally {\n      setIsLoading(false)\n    }\n  }, [client, collection, filter, sort, expand, fields, page, perPage, enabled])\n\n  // Initial fetch.\n  useEffect(() => {\n    fetchData()\n  }, [fetchData])\n\n  // Subscribe to QueryStore for optimistic + server updates.\n  useEffect(() => {\n    if (!enabled) return\n\n    const unsubscribe = client.store.subscribe(collection, filter, (records) => {\n      setData(records as T[])\n    })\n\n    return unsubscribe\n  }, [client, collection, filter, enabled])\n\n  // SSE realtime subscription.\n  useEffect(() => {\n    if (!realtimeEnabled || !enabled) return\n\n    const unsubscribe = client.subscribeAndSync(collection, '*')\n    return unsubscribe\n  }, [client, collection, realtimeEnabled, enabled])\n\n  return { data, isLoading, error, refetch: fetchData }\n}\n\n// ---------------------------------------------------------------------------\n// useMutation -- mutation with optimistic update support\n// ---------------------------------------------------------------------------\n\nexport type MutationAction = 'create' | 'update' | 'delete'\n\nexport interface MutateOptions {\n  /** If true, apply an optimistic update to the QueryStore before the server responds. */\n  optimistic?: boolean\n}\n\nexport interface UseMutationResult {\n  mutate: (data: Record<string, unknown>, options?: MutateOptions) => Promise<BaseRecord | void>\n  isLoading: boolean\n  error: Error | null\n}\n\n/**\n * Mutation hook.\n *\n * Performs a create, update, or delete mutation against a collection.\n * Supports optimistic updates that are automatically rolled back on failure.\n */\nexport function useMutation(\n  collection: string,\n  action: MutationAction,\n): UseMutationResult {\n  const client = useBase()\n  const [isLoading, setIsLoading] = useState(false)\n  const [error, setError] = useState<Error | null>(null)\n\n  const mutate = useCallback(\n    async (data: Record<string, unknown>, opts?: MutateOptions): Promise<BaseRecord | void> => {\n      setIsLoading(true)\n      setError(null)\n\n      let optimisticId: string | undefined\n\n      try {\n        // Optimistic update.\n        if (opts?.optimistic && action !== 'delete') {\n          const tempRecord: BaseRecord = {\n            id: data.id as string ?? `_temp_${Date.now()}`,\n            ...data,\n          }\n          optimisticId = client.store.optimisticSet(collection, tempRecord)\n        } else if (opts?.optimistic && action === 'delete' && data.id) {\n          optimisticId = client.store.optimisticDelete(collection, data.id as string)\n        }\n\n        // Server request.\n        let result: BaseRecord | void = undefined\n        switch (action) {\n          case 'create':\n            result = await client.create(collection, data)\n            break\n          case 'update': {\n            const id = data.id as string\n            if (!id) throw new Error('useMutation: update requires data.id')\n            const { id: _id, ...rest } = data\n            result = await client.update(collection, id, rest)\n            break\n          }\n          case 'delete': {\n            const id = data.id as string\n            if (!id) throw new Error('useMutation: delete requires data.id')\n            await client.delete(collection, id)\n            break\n          }\n        }\n\n        // On success, remove optimistic entry (server truth takes over via applyServerUpdate).\n        if (optimisticId) {\n          client.store.rollbackOptimistic(optimisticId)\n        }\n\n        return result\n      } catch (err) {\n        // Rollback optimistic on failure.\n        if (optimisticId) {\n          client.store.rollbackOptimistic(optimisticId)\n        }\n        const e = err instanceof Error ? err : new Error(String(err))\n        setError(e)\n        throw e\n      } finally {\n        setIsLoading(false)\n      }\n    },\n    [client, collection, action],\n  )\n\n  return { mutate, isLoading, error }\n}\n\n// ---------------------------------------------------------------------------\n// useAuth -- auth state\n// ---------------------------------------------------------------------------\n\nexport interface UseAuthResult {\n  user: BaseRecord | null\n  token: string\n  isValid: boolean\n  signIn: (identity: string, password: string) => Promise<void>\n  signUp: (data: Record<string, unknown>) => Promise<BaseRecord>\n  signOut: () => void\n  /** Subscribe to auth changes. Returns unsubscribe. */\n  onChange: AuthStore['onChange']\n}\n\n/**\n * Auth state hook.\n *\n * Returns the current auth state and provides sign-in, sign-up, and\n * sign-out methods. Re-renders when auth state changes.\n *\n * @param collection - Auth collection name (default: \"users\").\n */\nexport function useAuth(collection = 'users'): UseAuthResult {\n  const client = useBase()\n  const [user, setUser] = useState<BaseRecord | null>(client.authStore.record)\n  const [token, setToken] = useState(client.authStore.token)\n\n  useEffect(() => {\n    const unsubscribe = client.authStore.onChange((newToken, newRecord) => {\n      setToken(newToken)\n      setUser(newRecord)\n    })\n    return unsubscribe\n  }, [client])\n\n  const signIn = useCallback(\n    async (identity: string, password: string) => {\n      await client.signInWithPassword(collection, identity, password)\n    },\n    [client, collection],\n  )\n\n  const signUp = useCallback(\n    async (data: Record<string, unknown>) => {\n      return client.signUp(collection, data)\n    },\n    [client, collection],\n  )\n\n  const signOut = useCallback(() => {\n    client.signOut()\n  }, [client])\n\n  return {\n    user,\n    token,\n    isValid: client.authStore.isValid,\n    signIn,\n    signUp,\n    signOut,\n    onChange: client.authStore.onChange.bind(client.authStore),\n  }\n}\n\n// ---------------------------------------------------------------------------\n// useRealtime -- low-level SSE subscription\n// ---------------------------------------------------------------------------\n\n/**\n * Low-level realtime subscription hook.\n *\n * Subscribes to SSE events for a collection topic on mount and\n * unsubscribes on unmount.\n */\nexport function useRealtime(\n  collection: string,\n  topic: string,\n  callback: (event: RealtimeEvent) => void,\n): void {\n  const client = useBase()\n  const callbackRef = useRef(callback)\n  callbackRef.current = callback\n\n  useEffect(() => {\n    const unsubscribe = client.realtime.subscribe(collection, topic, (event) => {\n      callbackRef.current(event)\n    })\n    return unsubscribe\n  }, [client, collection, topic])\n}\n\n// ---------------------------------------------------------------------------\n// useConnectionState -- realtime connection state\n// ---------------------------------------------------------------------------\n\nexport function useConnectionState(): ConnectionState {\n  const client = useBase()\n  const [state, setState] = useState<ConnectionState>(client.realtime.state)\n\n  useEffect(() => {\n    const unsubscribe = client.realtime.onConnectionChange((s) => {\n      setState(s)\n    })\n    return unsubscribe\n  }, [client])\n\n  return state\n}\n\n// ---------------------------------------------------------------------------\n// usePresence -- presence tracking via CRDT sync\n// ---------------------------------------------------------------------------\n\nexport interface UsePresenceResult {\n  /** Map of peer siteId to their state. */\n  peers: Map<string, PeerState>\n  /** Our own presence metadata. */\n  myState: Record<string, unknown>\n  /** Update our presence metadata. */\n  updateState: (meta: Record<string, unknown>) => void\n}\n\n/**\n * Presence tracking hook.\n *\n * Requires a CRDTSync instance (usually obtained from useCRDT).\n * Tracks peers connected to the same document.\n */\nexport function usePresence(sync: CRDTSync): UsePresenceResult {\n  const [peers, setPeers] = useState<Map<string, PeerState>>(new Map())\n  const [myState, setMyState] = useState<Record<string, unknown>>({})\n\n  useEffect(() => {\n    const unsubscribe = sync.onPeersChange((p) => {\n      setPeers(new Map(p))\n    })\n    return unsubscribe\n  }, [sync])\n\n  const updateState = useCallback(\n    (meta: Record<string, unknown>) => {\n      setMyState(meta)\n      sync.updatePresence(meta)\n    },\n    [sync],\n  )\n\n  return { peers, myState, updateState }\n}\n\n// ---------------------------------------------------------------------------\n// useCRDT -- CRDT document hook with auto-sync\n// ---------------------------------------------------------------------------\n\nexport interface UseCRDTResult {\n  /** The CRDTDocument instance. */\n  doc: CRDTDocument\n  /** Convenience accessor for text fields. */\n  text: (field: string) => CRDTText\n  /** Convenience accessor for counter fields. */\n  counter: (field: string) => CRDTCounter\n  /** Convenience accessor for set fields. */\n  set: <T = unknown>(field: string) => CRDTSet<T>\n  /** Convenience accessor for register fields. */\n  register: <T = unknown>(field: string) => CRDTRegister<T>\n  /** The CRDTSync instance for advanced usage (presence, state listeners). */\n  sync: CRDTSync\n  /** Current sync state. */\n  syncState: SyncState\n}\n\n/**\n * CRDT document hook.\n *\n * Creates a CRDTDocument and CRDTSync, connects to the server via\n * WebSocket, and auto-syncs all local operations.\n *\n * @param documentId - Unique document identifier.\n * @param wsUrl - WebSocket URL for the CRDT sync endpoint. If not provided,\n *                derives it from the BaseClient URL (http->ws, https->wss).\n */\nexport function useCRDT(documentId: string, wsUrl?: string): UseCRDTResult {\n  const client = useBase()\n\n  // Stable refs for document and sync -- created once per documentId.\n  const docRef = useRef<CRDTDocument | null>(null)\n  const syncRef = useRef<CRDTSync | null>(null)\n  const [syncState, setSyncState] = useState<SyncState>('disconnected')\n\n  // Create document and sync on first render or documentId change.\n  if (!docRef.current || docRef.current.id !== documentId) {\n    docRef.current = new CRDTDocumentImpl(documentId)\n  }\n  if (!syncRef.current) {\n    syncRef.current = new CRDTSync()\n  }\n\n  const doc = docRef.current\n  const sync = syncRef.current\n\n  // Connect on mount, disconnect on unmount.\n  useEffect(() => {\n    const url = wsUrl ?? deriveCrdtWsUrl(client.url)\n    const token = client.authStore.token || undefined\n\n    sync.connect(url, doc, token)\n\n    const unsubState = sync.onStateChange((s) => {\n      setSyncState(s)\n    })\n\n    return () => {\n      unsubState()\n      sync.disconnect()\n    }\n  }, [doc, sync, client, wsUrl])\n\n  // Convenience accessors that delegate to the document.\n  const text = useCallback((field: string) => doc.getText(field), [doc])\n  const counter = useCallback((field: string) => doc.getCounter(field), [doc])\n  const set = useCallback(<T = unknown>(field: string) => doc.getSet<T>(field), [doc])\n  const register = useCallback(<T = unknown>(field: string) => doc.getRegister<T>(field), [doc])\n\n  return { doc, text, counter, set, register, sync, syncState }\n}\n\n// ---------------------------------------------------------------------------\n// useCRDTText -- subscribe to a CRDT text field's content\n// ---------------------------------------------------------------------------\n\n/**\n * Subscribe to a specific CRDTText field's current string value.\n * Re-renders whenever the text changes (local or remote).\n */\nexport function useCRDTText(doc: CRDTDocument, field: string): string {\n  const textCrdt = doc.getText(field)\n  const [value, setValue] = useState(() => textCrdt.toString())\n\n  useEffect(() => {\n    const unsubscribe = textCrdt.onChange((text) => {\n      setValue(text)\n    })\n    return unsubscribe\n  }, [textCrdt])\n\n  return value\n}\n\n// ---------------------------------------------------------------------------\n// useCRDTCounter -- subscribe to a CRDT counter field\n// ---------------------------------------------------------------------------\n\nexport function useCRDTCounter(doc: CRDTDocument, field: string): number {\n  const counterCrdt = doc.getCounter(field)\n  const [value, setValue] = useState(() => counterCrdt.value)\n\n  useEffect(() => {\n    const unsubscribe = counterCrdt.onChange((v) => {\n      setValue(v)\n    })\n    return unsubscribe\n  }, [counterCrdt])\n\n  return value\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/** Derive WebSocket URL from HTTP URL: https://x -> wss://x/api/crdt */\nfunction deriveCrdtWsUrl(httpUrl: string): string {\n  const url = httpUrl.replace(/\\/$/, '')\n  if (url.startsWith('https://')) {\n    return url.replace('https://', 'wss://') + '/api/crdt'\n  }\n  return url.replace('http://', 'ws://') + '/api/crdt'\n}\n"]}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@hanzo/base",
+  "version": "0.2.0",
+  "description": "Hanzo Base SDK - Reactive queries, CRDT, realtime, and PocketBase-compatible client",
+  "type": "module",
+  "main": "./dist/core/index.js",
+  "module": "./dist/core/index.js",
+  "types": "./dist/core/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/core/index.js",
+      "types": "./dist/core/index.d.ts"
+    },
+    "./compat": {
+      "import": "./dist/compat/index.js",
+      "types": "./dist/compat/index.d.ts"
+    },
+    "./react": {
+      "import": "./dist/react/index.js",
+      "types": "./dist/react/index.d.ts"
+    },
+    "./crdt": {
+      "import": "./dist/crdt/index.js",
+      "types": "./dist/crdt/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "pocketbase": "^0.26.5"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hanzoai/base.git",
+    "directory": "sdk/base-js"
+  },
+  "keywords": [
+    "hanzo",
+    "base",
+    "sdk",
+    "backend",
+    "realtime",
+    "reactive",
+    "crdt",
+    "pocketbase"
+  ]
+}

package/src/compat/index.ts

@@ -0,0 +1,24 @@
+/**
+ * @hanzoai/base/compat -- PocketBase-compatible client re-exports.
+ *
+ * Provides a drop-in replacement for the `pocketbase` npm package
+ * so that existing code can migrate to `@hanzoai/base` without changes.
+ *
+ * Usage:
+ *   import Base, { LocalAuthStore, isTokenExpired } from '@hanzoai/base/compat'
+ */
+
+export {
+  default,
+  default as PocketBase,
+  default as Base,
+  LocalAuthStore,
+  AsyncAuthStore,
+  BaseAuthStore,
+  isTokenExpired,
+  ClientResponseError,
+  cookieParse,
+  cookieSerialize,
+  getTokenPayload,
+  normalizeUnknownQueryParams,
+} from 'pocketbase'