lakesync 0.1.6 → 0.1.8

package/dist/react.js

@@ -1,4 +1,4 @@
-import "./chunk-7D4SUZUM.js";
+import "./chunk-DGUM43GV.js";
 
 // ../react/src/context.ts
 import {
@@ -10,7 +10,8 @@ import {
   useMemo,
   useState
 } from "react";
-var LakeSyncContext = createContext(null);
+var LakeSyncStableContext = createContext(null);
+var LakeSyncDataContext = createContext(null);
 function LakeSyncProvider(props) {
   const { coordinator, children } = props;
   const [dataVersion, setDataVersion] = useState(0);
@@ -26,35 +27,60 @@ function LakeSyncProvider(props) {
       coordinator.off("onChange", handleChange);
     };
   }, [coordinator]);
-  const value = useMemo(
+  const stableValue = useMemo(
     () => ({
       coordinator,
-      tracker: coordinator.tracker,
+      tracker: coordinator.tracker
+    }),
+    [coordinator]
+  );
+  const dataValue = useMemo(
+    () => ({
       dataVersion,
       invalidate
     }),
-    [coordinator, dataVersion, invalidate]
+    [dataVersion, invalidate]
+  );
+  return createElement(
+    LakeSyncStableContext.Provider,
+    { value: stableValue },
+    createElement(LakeSyncDataContext.Provider, { value: dataValue }, children)
   );
-  return createElement(LakeSyncContext.Provider, { value }, children);
 }
-function useLakeSync() {
-  const ctx = useContext(LakeSyncContext);
+function useLakeSyncStable() {
+  const ctx = useContext(LakeSyncStableContext);
   if (!ctx) {
-    throw new Error("useLakeSync must be used within a <LakeSyncProvider>");
+    throw new Error("useLakeSyncStable must be used within a <LakeSyncProvider>");
   }
   return ctx;
 }
+function useLakeSyncData() {
+  const ctx = useContext(LakeSyncDataContext);
+  if (!ctx) {
+    throw new Error("useLakeSyncData must be used within a <LakeSyncProvider>");
+  }
+  return ctx;
+}
+function useLakeSync() {
+  const stable = useLakeSyncStable();
+  const data = useLakeSyncData();
+  return { ...stable, ...data };
+}
 
 // ../react/src/use-action.ts
-import { useCallback as useCallback2, useEffect as useEffect2, useState as useState2 } from "react";
+import { useCallback as useCallback2, useEffect as useEffect2, useRef, useState as useState2 } from "react";
 function useAction() {
-  const { coordinator } = useLakeSync();
+  const { coordinator } = useLakeSyncStable();
   const [lastResult, setLastResult] = useState2(null);
   const [isPending, setIsPending] = useState2(false);
+  const waitingForCompletion = useRef(false);
   useEffect2(() => {
     const handleComplete = (_actionId, result) => {
-      setLastResult(result);
-      setIsPending(false);
+      if (waitingForCompletion.current) {
+        waitingForCompletion.current = false;
+        setLastResult(result);
+        setIsPending(false);
+      }
     };
     coordinator.on("onActionComplete", handleComplete);
     return () => {
@@ -64,6 +90,8 @@ function useAction() {
   const execute = useCallback2(
     async (params) => {
       setIsPending(true);
+      setLastResult(null);
+      waitingForCompletion.current = true;
       await coordinator.executeAction(params);
     },
     [coordinator]
@@ -71,7 +99,7 @@ function useAction() {
   return { execute, lastResult, isPending };
 }
 function useActionDiscovery() {
-  const { coordinator } = useLakeSync();
+  const { coordinator } = useLakeSyncStable();
   const [connectors, setConnectors] = useState2({});
   const [isLoading, setIsLoading] = useState2(true);
   const [error, setError] = useState2(null);
@@ -105,7 +133,7 @@ function useActionDiscovery() {
 // ../react/src/use-connector-types.ts
 import { useCallback as useCallback3, useEffect as useEffect3, useState as useState3 } from "react";
 function useConnectorTypes() {
-  const { coordinator } = useLakeSync();
+  const { coordinator } = useLakeSyncStable();
   const [types, setTypes] = useState3([]);
   const [isLoading, setIsLoading] = useState3(true);
   const [error, setError] = useState3(null);
@@ -139,7 +167,8 @@ function useConnectorTypes() {
 // ../react/src/use-mutation.ts
 import { useCallback as useCallback4 } from "react";
 function useMutation() {
-  const { tracker, invalidate } = useLakeSync();
+  const { tracker } = useLakeSyncStable();
+  const { invalidate } = useLakeSyncData();
   const insert = useCallback4(
     async (table, rowId, data) => {
       const result = await tracker.insert(table, rowId, data);
@@ -168,15 +197,16 @@ function useMutation() {
 }
 
 // ../react/src/use-query.ts
-import { useCallback as useCallback5, useEffect as useEffect4, useRef, useState as useState4 } from "react";
+import { useCallback as useCallback5, useEffect as useEffect4, useRef as useRef2, useState as useState4 } from "react";
 function useQuery(sql, params) {
-  const { tracker, dataVersion } = useLakeSync();
+  const { tracker } = useLakeSyncStable();
+  const { dataVersion } = useLakeSyncData();
   const [data, setData] = useState4([]);
   const [error, setError] = useState4(null);
   const [isLoading, setIsLoading] = useState4(true);
   const [manualTrigger, setManualTrigger] = useState4(0);
   const paramsKey = JSON.stringify(params ?? []);
-  const paramsRef = useRef(params);
+  const paramsRef = useRef2(params);
   paramsRef.current = params;
   const refetch = useCallback5(() => {
     setManualTrigger((v) => v + 1);
@@ -207,44 +237,60 @@ function useQuery(sql, params) {
 // ../react/src/use-sync-status.ts
 import { useCallback as useCallback6, useEffect as useEffect5, useState as useState5 } from "react";
 function useSyncStatus() {
-  const { coordinator, dataVersion } = useLakeSync();
-  const [isSyncing, setIsSyncing] = useState5(false);
-  const [lastSyncTime, setLastSyncTime] = useState5(null);
-  const [queueDepth, setQueueDepth] = useState5(0);
-  const [error, setError] = useState5(null);
-  const refreshQueueDepth = useCallback6(async () => {
+  const { coordinator } = useLakeSyncStable();
+  const [status, setStatus] = useState5({
+    isSyncing: false,
+    lastSyncTime: null,
+    queueDepth: 0,
+    error: null
+  });
+  const refreshStatus = useCallback6(async () => {
+    const state = coordinator.state;
     const depth = await coordinator.queueDepth();
-    setQueueDepth(depth);
+    setStatus((prev) => ({
+      isSyncing: state.syncing,
+      lastSyncTime: state.lastSyncTime,
+      queueDepth: depth,
+      error: prev.error
+    }));
   }, [coordinator]);
   useEffect5(() => {
+    const handleSyncStart = () => {
+      setStatus((prev) => ({ ...prev, isSyncing: true }));
+    };
     const handleSyncComplete = () => {
-      setIsSyncing(false);
-      setLastSyncTime(coordinator.lastSyncTime);
-      setError(null);
-      refreshQueueDepth();
+      const state = coordinator.state;
+      setStatus((prev) => ({
+        ...prev,
+        isSyncing: false,
+        lastSyncTime: state.lastSyncTime,
+        error: null
+      }));
+      refreshStatus();
     };
     const handleError = (err) => {
-      setIsSyncing(false);
-      setError(err);
+      setStatus((prev) => ({
+        ...prev,
+        isSyncing: false,
+        error: err
+      }));
     };
     const handleChange = () => {
-      refreshQueueDepth();
+      refreshStatus();
     };
+    coordinator.on("onSyncStart", handleSyncStart);
     coordinator.on("onSyncComplete", handleSyncComplete);
     coordinator.on("onError", handleError);
     coordinator.on("onChange", handleChange);
-    refreshQueueDepth();
+    refreshStatus();
     return () => {
+      coordinator.off("onSyncStart", handleSyncStart);
       coordinator.off("onSyncComplete", handleSyncComplete);
       coordinator.off("onError", handleError);
       coordinator.off("onChange", handleChange);
     };
-  }, [coordinator, refreshQueueDepth]);
-  useEffect5(() => {
-    void dataVersion;
-    refreshQueueDepth();
-  }, [dataVersion, refreshQueueDepth]);
-  return { isSyncing, lastSyncTime, queueDepth, error };
+  }, [coordinator, refreshStatus]);
+  return status;
 }
 export {
   LakeSyncProvider,
@@ -252,6 +298,8 @@ export {
   useActionDiscovery,
   useConnectorTypes,
   useLakeSync,
+  useLakeSyncData,
+  useLakeSyncStable,
   useMutation,
   useQuery,
   useSyncStatus

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../react/src/context.ts","../../react/src/use-action.ts","../../react/src/use-connector-types.ts","../../react/src/use-mutation.ts","../../react/src/use-query.ts","../../react/src/use-sync-status.ts"],"sourcesContent":["import type { SyncCoordinator, SyncTracker } from \"@lakesync/client\";\nimport {\n\tcreateContext,\n\tcreateElement,\n\tuseCallback,\n\tuseContext,\n\tuseEffect,\n\tuseMemo,\n\tuseState,\n} from \"react\";\n\n/** Internal context value shared across all hooks. */\nexport interface LakeSyncContextValue {\n\tcoordinator: SyncCoordinator;\n\ttracker: SyncTracker;\n\t/** Monotonically increasing counter — bumped on every data change. */\n\tdataVersion: number;\n\t/** Increment dataVersion to trigger query re-runs. */\n\tinvalidate: () => void;\n}\n\nconst LakeSyncContext = createContext<LakeSyncContextValue | null>(null);\n\n/** Props for the LakeSyncProvider component. */\nexport interface LakeSyncProviderProps {\n\t/** An already-constructed SyncCoordinator instance. */\n\tcoordinator: SyncCoordinator;\n\tchildren: React.ReactNode;\n}\n\n/**\n * Provides LakeSync context to the component tree.\n *\n * Subscribes to `onChange` events from the coordinator and maintains a\n * `dataVersion` counter that increments on every remote delta application,\n * triggering reactive query re-runs in `useQuery`.\n */\nexport function LakeSyncProvider(props: LakeSyncProviderProps) {\n\tconst { coordinator, children } = props;\n\tconst [dataVersion, setDataVersion] = useState(0);\n\n\tconst invalidate = useCallback(() => {\n\t\tsetDataVersion((v) => v + 1);\n\t}, []);\n\n\tuseEffect(() => {\n\t\tconst handleChange = () => {\n\t\t\tsetDataVersion((v) => v + 1);\n\t\t};\n\t\tcoordinator.on(\"onChange\", handleChange);\n\t\treturn () => {\n\t\t\tcoordinator.off(\"onChange\", handleChange);\n\t\t};\n\t}, [coordinator]);\n\n\tconst value = useMemo<LakeSyncContextValue>(\n\t\t() => ({\n\t\t\tcoordinator,\n\t\t\ttracker: coordinator.tracker,\n\t\t\tdataVersion,\n\t\t\tinvalidate,\n\t\t}),\n\t\t[coordinator, dataVersion, invalidate],\n\t);\n\n\treturn createElement(LakeSyncContext.Provider, { value }, children);\n}\n\n/**\n * Access the raw LakeSync SDK instances from context.\n *\n * @throws if called outside a `<LakeSyncProvider>`.\n */\nexport function useLakeSync(): LakeSyncContextValue {\n\tconst ctx = useContext(LakeSyncContext);\n\tif (!ctx) {\n\t\tthrow new Error(\"useLakeSync must be used within a <LakeSyncProvider>\");\n\t}\n\treturn ctx;\n}\n","import type {\n\tActionDescriptor,\n\tActionErrorResult,\n\tActionResult,\n\tLakeSyncError,\n} from \"@lakesync/core\";\nimport { useCallback, useEffect, useState } from \"react\";\nimport { useLakeSync } from \"./context\";\n\n/** Parameters for a single action execution. */\nexport interface ActionParams {\n\tconnector: string;\n\tactionType: string;\n\tparams: Record<string, unknown>;\n\tidempotencyKey?: string;\n}\n\n/** Return type of `useAction`. */\nexport interface UseActionResult {\n\t/** Execute an action against a connector via the gateway. */\n\texecute: (params: ActionParams) => Promise<void>;\n\t/** Last action result (success or error). Null before first execution. */\n\tlastResult: ActionResult | ActionErrorResult | null;\n\t/** Whether an action is currently in flight. */\n\tisPending: boolean;\n}\n\n/**\n * Execute imperative actions against external systems via the gateway.\n *\n * Wraps `SyncCoordinator.executeAction()` and subscribes to\n * `onActionComplete` events to track the latest result.\n *\n * ```ts\n * const { execute, lastResult, isPending } = useAction();\n *\n * await execute({\n *   connector: \"slack\",\n *   actionType: \"send_message\",\n *   params: { channel: \"#general\", text: \"Hello\" },\n * });\n * ```\n */\nexport function useAction(): UseActionResult {\n\tconst { coordinator } = useLakeSync();\n\tconst [lastResult, setLastResult] = useState<ActionResult | ActionErrorResult | null>(null);\n\tconst [isPending, setIsPending] = useState(false);\n\n\tuseEffect(() => {\n\t\tconst handleComplete = (_actionId: string, result: ActionResult | ActionErrorResult) => {\n\t\t\tsetLastResult(result);\n\t\t\tsetIsPending(false);\n\t\t};\n\n\t\tcoordinator.on(\"onActionComplete\", handleComplete);\n\t\treturn () => {\n\t\t\tcoordinator.off(\"onActionComplete\", handleComplete);\n\t\t};\n\t}, [coordinator]);\n\n\tconst execute = useCallback(\n\t\tasync (params: ActionParams): Promise<void> => {\n\t\t\tsetIsPending(true);\n\t\t\tawait coordinator.executeAction(params);\n\t\t},\n\t\t[coordinator],\n\t);\n\n\treturn { execute, lastResult, isPending };\n}\n\n/** Return type of `useActionDiscovery`. */\nexport interface UseActionDiscoveryResult {\n\t/** Map of connector name to supported action descriptors. */\n\tconnectors: Record<string, ActionDescriptor[]>;\n\t/** Whether discovery is loading. */\n\tisLoading: boolean;\n\t/** Error from the last fetch, or null. */\n\terror: LakeSyncError | null;\n\t/** Manually re-fetch available actions. */\n\trefetch: () => void;\n}\n\n/**\n * Discover available connectors and their supported action types.\n *\n * Calls `transport.describeActions()` on mount and returns the result\n * reactively. Use this to build dynamic UI based on available actions.\n *\n * ```ts\n * const { connectors, isLoading } = useActionDiscovery();\n *\n * for (const [name, actions] of Object.entries(connectors)) {\n *   console.log(name, actions.map(a => a.actionType));\n * }\n * ```\n */\nexport function useActionDiscovery(): UseActionDiscoveryResult {\n\tconst { coordinator } = useLakeSync();\n\tconst [connectors, setConnectors] = useState<Record<string, ActionDescriptor[]>>({});\n\tconst [isLoading, setIsLoading] = useState(true);\n\tconst [error, setError] = useState<LakeSyncError | null>(null);\n\tconst [trigger, setTrigger] = useState(0);\n\n\tconst refetch = useCallback(() => {\n\t\tsetTrigger((v) => v + 1);\n\t}, []);\n\n\tuseEffect(() => {\n\t\tvoid trigger;\n\t\tlet cancelled = false;\n\n\t\tconst run = async () => {\n\t\t\tsetIsLoading(true);\n\t\t\tconst result = await coordinator.describeActions();\n\t\t\tif (cancelled) return;\n\n\t\t\tif (result.ok) {\n\t\t\t\tsetConnectors(result.value.connectors);\n\t\t\t\tsetError(null);\n\t\t\t} else {\n\t\t\t\tsetError(result.error);\n\t\t\t}\n\t\t\tsetIsLoading(false);\n\t\t};\n\n\t\trun();\n\n\t\treturn () => {\n\t\t\tcancelled = true;\n\t\t};\n\t}, [coordinator, trigger]);\n\n\treturn { connectors, isLoading, error, refetch };\n}\n","import type { ConnectorDescriptor, LakeSyncError } from \"@lakesync/core\";\nimport { useCallback, useEffect, useState } from \"react\";\nimport { useLakeSync } from \"./context\";\n\n/** Return type of `useConnectorTypes`. */\nexport interface UseConnectorTypesResult {\n\t/** Array of available connector type descriptors. */\n\ttypes: ConnectorDescriptor[];\n\t/** Whether discovery is loading. */\n\tisLoading: boolean;\n\t/** Error from the last fetch, or null. */\n\terror: LakeSyncError | null;\n\t/** Manually re-fetch connector types. */\n\trefetch: () => void;\n}\n\n/**\n * Discover available connector types and their configuration schemas.\n *\n * Calls `coordinator.listConnectorTypes()` on mount and returns the\n * result reactively. Use this to build dynamic \"Add Connector\" forms.\n *\n * ```ts\n * const { types, isLoading } = useConnectorTypes();\n *\n * for (const t of types) {\n *   console.log(t.displayName, t.configSchema);\n * }\n * ```\n */\nexport function useConnectorTypes(): UseConnectorTypesResult {\n\tconst { coordinator } = useLakeSync();\n\tconst [types, setTypes] = useState<ConnectorDescriptor[]>([]);\n\tconst [isLoading, setIsLoading] = useState(true);\n\tconst [error, setError] = useState<LakeSyncError | null>(null);\n\tconst [trigger, setTrigger] = useState(0);\n\n\tconst refetch = useCallback(() => {\n\t\tsetTrigger((v) => v + 1);\n\t}, []);\n\n\tuseEffect(() => {\n\t\tvoid trigger;\n\t\tlet cancelled = false;\n\n\t\tconst run = async () => {\n\t\t\tsetIsLoading(true);\n\t\t\tconst result = await coordinator.listConnectorTypes();\n\t\t\tif (cancelled) return;\n\n\t\t\tif (result.ok) {\n\t\t\t\tsetTypes(result.value);\n\t\t\t\tsetError(null);\n\t\t\t} else {\n\t\t\t\tsetError(result.error);\n\t\t\t}\n\t\t\tsetIsLoading(false);\n\t\t};\n\n\t\trun();\n\n\t\treturn () => {\n\t\t\tcancelled = true;\n\t\t};\n\t}, [coordinator, trigger]);\n\n\treturn { types, isLoading, error, refetch };\n}\n","import type { LakeSyncError, Result } from \"@lakesync/core\";\nimport { useCallback } from \"react\";\nimport { useLakeSync } from \"./context\";\n\n/** Return type of `useMutation`. */\nexport interface UseMutationResult {\n\tinsert: (\n\t\ttable: string,\n\t\trowId: string,\n\t\tdata: Record<string, unknown>,\n\t) => Promise<Result<void, LakeSyncError>>;\n\tupdate: (\n\t\ttable: string,\n\t\trowId: string,\n\t\tdata: Record<string, unknown>,\n\t) => Promise<Result<void, LakeSyncError>>;\n\tremove: (table: string, rowId: string) => Promise<Result<void, LakeSyncError>>;\n}\n\n/**\n * Wraps SyncTracker mutations with automatic query invalidation.\n *\n * After each successful mutation, `dataVersion` is incremented so all\n * active `useQuery` hooks re-run.\n */\nexport function useMutation(): UseMutationResult {\n\tconst { tracker, invalidate } = useLakeSync();\n\n\tconst insert = useCallback(\n\t\tasync (\n\t\t\ttable: string,\n\t\t\trowId: string,\n\t\t\tdata: Record<string, unknown>,\n\t\t): Promise<Result<void, LakeSyncError>> => {\n\t\t\tconst result = await tracker.insert(table, rowId, data);\n\t\t\tif (result.ok) invalidate();\n\t\t\treturn result;\n\t\t},\n\t\t[tracker, invalidate],\n\t);\n\n\tconst update = useCallback(\n\t\tasync (\n\t\t\ttable: string,\n\t\t\trowId: string,\n\t\t\tdata: Record<string, unknown>,\n\t\t): Promise<Result<void, LakeSyncError>> => {\n\t\t\tconst result = await tracker.update(table, rowId, data);\n\t\t\tif (result.ok) invalidate();\n\t\t\treturn result;\n\t\t},\n\t\t[tracker, invalidate],\n\t);\n\n\tconst remove = useCallback(\n\t\tasync (table: string, rowId: string): Promise<Result<void, LakeSyncError>> => {\n\t\t\tconst result = await tracker.delete(table, rowId);\n\t\t\tif (result.ok) invalidate();\n\t\t\treturn result;\n\t\t},\n\t\t[tracker, invalidate],\n\t);\n\n\treturn { insert, update, remove };\n}\n","import type { DbError } from \"@lakesync/client\";\nimport { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useLakeSync } from \"./context\";\n\n/** Return type of `useQuery`. */\nexport interface UseQueryResult<T> {\n\tdata: T[];\n\terror: DbError | null;\n\tisLoading: boolean;\n\trefetch: () => void;\n}\n\n/**\n * Reactive SQL query hook.\n *\n * Re-runs automatically when:\n * - Remote deltas are applied (via `onChange`)\n * - A local mutation completes (via `invalidate()`)\n * - The `sql` or `params` arguments change\n *\n * @param sql - SQL query string\n * @param params - Optional bind parameters\n */\nexport function useQuery<T>(sql: string, params?: unknown[]): UseQueryResult<T> {\n\tconst { tracker, dataVersion } = useLakeSync();\n\tconst [data, setData] = useState<T[]>([]);\n\tconst [error, setError] = useState<DbError | null>(null);\n\tconst [isLoading, setIsLoading] = useState(true);\n\tconst [manualTrigger, setManualTrigger] = useState(0);\n\n\t// Stable serialisation of params for dependency comparison\n\tconst paramsKey = JSON.stringify(params ?? []);\n\tconst paramsRef = useRef(params);\n\tparamsRef.current = params;\n\n\tconst refetch = useCallback(() => {\n\t\tsetManualTrigger((v) => v + 1);\n\t}, []);\n\n\t// Combine all trigger values into a single version for the effect.\n\t// This satisfies exhaustive-deps: the effect reads `version` directly.\n\tconst version = `${dataVersion}:${manualTrigger}:${paramsKey}`;\n\n\tuseEffect(() => {\n\t\t// Read version to establish dependency\n\t\tvoid version;\n\t\tlet cancelled = false;\n\n\t\tconst run = async () => {\n\t\t\tconst result = await tracker.query<T>(sql, paramsRef.current);\n\t\t\tif (cancelled) return;\n\n\t\t\tif (result.ok) {\n\t\t\t\tsetData(result.value);\n\t\t\t\tsetError(null);\n\t\t\t} else {\n\t\t\t\tsetError(result.error);\n\t\t\t}\n\t\t\tsetIsLoading(false);\n\t\t};\n\n\t\trun();\n\n\t\treturn () => {\n\t\t\tcancelled = true;\n\t\t};\n\t}, [tracker, sql, version]);\n\n\treturn { data, error, isLoading, refetch };\n}\n","import { useCallback, useEffect, useState } from \"react\";\nimport { useLakeSync } from \"./context\";\n\n/** Return type of `useSyncStatus`. */\nexport interface UseSyncStatusResult {\n\tisSyncing: boolean;\n\tlastSyncTime: Date | null;\n\tqueueDepth: number;\n\terror: Error | null;\n}\n\n/**\n * Observe the sync lifecycle.\n *\n * Tracks whether a sync is in progress, last successful sync time,\n * outbox queue depth, and the most recent sync error (cleared on success).\n */\nexport function useSyncStatus(): UseSyncStatusResult {\n\tconst { coordinator, dataVersion } = useLakeSync();\n\tconst [isSyncing, setIsSyncing] = useState(false);\n\tconst [lastSyncTime, setLastSyncTime] = useState<Date | null>(null);\n\tconst [queueDepth, setQueueDepth] = useState(0);\n\tconst [error, setError] = useState<Error | null>(null);\n\n\tconst refreshQueueDepth = useCallback(async () => {\n\t\tconst depth = await coordinator.queueDepth();\n\t\tsetQueueDepth(depth);\n\t}, [coordinator]);\n\n\tuseEffect(() => {\n\t\tconst handleSyncComplete = () => {\n\t\t\tsetIsSyncing(false);\n\t\t\tsetLastSyncTime(coordinator.lastSyncTime);\n\t\t\tsetError(null);\n\t\t\trefreshQueueDepth();\n\t\t};\n\n\t\tconst handleError = (err: Error) => {\n\t\t\tsetIsSyncing(false);\n\t\t\tsetError(err);\n\t\t};\n\n\t\tconst handleChange = () => {\n\t\t\trefreshQueueDepth();\n\t\t};\n\n\t\tcoordinator.on(\"onSyncComplete\", handleSyncComplete);\n\t\tcoordinator.on(\"onError\", handleError);\n\t\tcoordinator.on(\"onChange\", handleChange);\n\n\t\t// Initial queue depth\n\t\trefreshQueueDepth();\n\n\t\treturn () => {\n\t\t\tcoordinator.off(\"onSyncComplete\", handleSyncComplete);\n\t\t\tcoordinator.off(\"onError\", handleError);\n\t\t\tcoordinator.off(\"onChange\", handleChange);\n\t\t};\n\t}, [coordinator, refreshQueueDepth]);\n\n\t// Also refresh queue depth when dataVersion changes (local mutations)\n\tuseEffect(() => {\n\t\tvoid dataVersion;\n\t\trefreshQueueDepth();\n\t}, [dataVersion, refreshQueueDepth]);\n\n\treturn { isSyncing, lastSyncTime, queueDepth, error };\n}\n"],"mappings":"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","names":["useCallback","useEffect","useState","useState","useEffect","useCallback","useCallback","useEffect","useState","useState","useCallback","useEffect","useCallback","useCallback","useCallback","useEffect","useState","useState","useCallback","useEffect","useCallback","useEffect","useState","useState","useCallback","useEffect"]}
+{"version":3,"sources":["../../react/src/context.ts","../../react/src/use-action.ts","../../react/src/use-connector-types.ts","../../react/src/use-mutation.ts","../../react/src/use-query.ts","../../react/src/use-sync-status.ts"],"sourcesContent":["import type { SyncCoordinator, SyncTracker } from \"@lakesync/client\";\nimport {\n\tcreateContext,\n\tcreateElement,\n\tuseCallback,\n\tuseContext,\n\tuseEffect,\n\tuseMemo,\n\tuseState,\n} from \"react\";\n\n/** Stable context value — coordinator and tracker references that never change. */\nexport interface LakeSyncStableContextValue {\n\tcoordinator: SyncCoordinator;\n\ttracker: SyncTracker;\n}\n\n/** Reactive context value — data version that changes on every delta. */\nexport interface LakeSyncDataContextValue {\n\t/** Monotonically increasing counter — bumped on every data change. */\n\tdataVersion: number;\n\t/** Increment dataVersion to trigger query re-runs. */\n\tinvalidate: () => void;\n}\n\n/**\n * Combined context value for backwards compatibility.\n * @see useLakeSync\n */\nexport interface LakeSyncContextValue\n\textends LakeSyncStableContextValue,\n\t\tLakeSyncDataContextValue {}\n\nconst LakeSyncStableContext = createContext<LakeSyncStableContextValue | null>(null);\nconst LakeSyncDataContext = createContext<LakeSyncDataContextValue | null>(null);\n\n/** Props for the LakeSyncProvider component. */\nexport interface LakeSyncProviderProps {\n\t/** An already-constructed SyncCoordinator instance. */\n\tcoordinator: SyncCoordinator;\n\tchildren: React.ReactNode;\n}\n\n/**\n * Provides LakeSync context to the component tree.\n *\n * Subscribes to `onChange` events from the coordinator and maintains a\n * `dataVersion` counter that increments on every remote delta application,\n * triggering reactive query re-runs in `useQuery`.\n *\n * Uses a split context pattern: stable refs (coordinator, tracker) are\n * provided separately from reactive data (dataVersion) so that hooks\n * like `useSyncStatus` and `useAction` do not re-render on data changes.\n */\nexport function LakeSyncProvider(props: LakeSyncProviderProps) {\n\tconst { coordinator, children } = props;\n\tconst [dataVersion, setDataVersion] = useState(0);\n\n\tconst invalidate = useCallback(() => {\n\t\tsetDataVersion((v) => v + 1);\n\t}, []);\n\n\tuseEffect(() => {\n\t\tconst handleChange = () => {\n\t\t\tsetDataVersion((v) => v + 1);\n\t\t};\n\t\tcoordinator.on(\"onChange\", handleChange);\n\t\treturn () => {\n\t\t\tcoordinator.off(\"onChange\", handleChange);\n\t\t};\n\t}, [coordinator]);\n\n\tconst stableValue = useMemo<LakeSyncStableContextValue>(\n\t\t() => ({\n\t\t\tcoordinator,\n\t\t\ttracker: coordinator.tracker,\n\t\t}),\n\t\t[coordinator],\n\t);\n\n\tconst dataValue = useMemo<LakeSyncDataContextValue>(\n\t\t() => ({\n\t\t\tdataVersion,\n\t\t\tinvalidate,\n\t\t}),\n\t\t[dataVersion, invalidate],\n\t);\n\n\treturn createElement(\n\t\tLakeSyncStableContext.Provider,\n\t\t{ value: stableValue },\n\t\tcreateElement(LakeSyncDataContext.Provider, { value: dataValue }, children),\n\t);\n}\n\n/**\n * Access the stable LakeSync SDK instances from context.\n *\n * This hook does NOT cause re-renders when dataVersion changes.\n * Use {@link useLakeSyncData} for reactive data.\n *\n * @throws if called outside a `<LakeSyncProvider>`.\n */\nexport function useLakeSyncStable(): LakeSyncStableContextValue {\n\tconst ctx = useContext(LakeSyncStableContext);\n\tif (!ctx) {\n\t\tthrow new Error(\"useLakeSyncStable must be used within a <LakeSyncProvider>\");\n\t}\n\treturn ctx;\n}\n\n/**\n * Access reactive data (dataVersion, invalidate) from context.\n *\n * @throws if called outside a `<LakeSyncProvider>`.\n */\nexport function useLakeSyncData(): LakeSyncDataContextValue {\n\tconst ctx = useContext(LakeSyncDataContext);\n\tif (!ctx) {\n\t\tthrow new Error(\"useLakeSyncData must be used within a <LakeSyncProvider>\");\n\t}\n\treturn ctx;\n}\n\n/**\n * Access the raw LakeSync SDK instances from context.\n *\n * Returns both stable and reactive values for backwards compatibility.\n *\n * @throws if called outside a `<LakeSyncProvider>`.\n */\nexport function useLakeSync(): LakeSyncContextValue {\n\tconst stable = useLakeSyncStable();\n\tconst data = useLakeSyncData();\n\treturn { ...stable, ...data };\n}\n","import type {\n\tActionDescriptor,\n\tActionErrorResult,\n\tActionResult,\n\tLakeSyncError,\n} from \"@lakesync/core\";\nimport { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useLakeSyncStable } from \"./context\";\n\n/** Parameters for a single action execution. */\nexport interface ActionParams {\n\tconnector: string;\n\tactionType: string;\n\tparams: Record<string, unknown>;\n\tidempotencyKey?: string;\n}\n\n/** Return type of `useAction`. */\nexport interface UseActionResult {\n\t/** Execute an action against a connector via the gateway. */\n\texecute: (params: ActionParams) => Promise<void>;\n\t/** Last action result (success or error). Null before first execution. */\n\tlastResult: ActionResult | ActionErrorResult | null;\n\t/** Whether an action is currently in flight. */\n\tisPending: boolean;\n}\n\n/**\n * Execute imperative actions against external systems via the gateway.\n *\n * Wraps `SyncCoordinator.executeAction()` and subscribes to\n * `onActionComplete` events to track the latest result.\n *\n * Uses a `pendingRef` to track whether we are waiting for a completion.\n * When `execute()` is called, we set the ref to `true` so the next\n * `onActionComplete` event is captured. This avoids the identity bug\n * where a stale action completion from a different hook instance would\n * overwrite state.\n *\n * ```ts\n * const { execute, lastResult, isPending } = useAction();\n *\n * await execute({\n *   connector: \"slack\",\n *   actionType: \"send_message\",\n *   params: { channel: \"#general\", text: \"Hello\" },\n * });\n * ```\n */\nexport function useAction(): UseActionResult {\n\tconst { coordinator } = useLakeSyncStable();\n\tconst [lastResult, setLastResult] = useState<ActionResult | ActionErrorResult | null>(null);\n\tconst [isPending, setIsPending] = useState(false);\n\tconst waitingForCompletion = useRef(false);\n\n\tuseEffect(() => {\n\t\tconst handleComplete = (_actionId: string, result: ActionResult | ActionErrorResult) => {\n\t\t\tif (waitingForCompletion.current) {\n\t\t\t\twaitingForCompletion.current = false;\n\t\t\t\tsetLastResult(result);\n\t\t\t\tsetIsPending(false);\n\t\t\t}\n\t\t};\n\n\t\tcoordinator.on(\"onActionComplete\", handleComplete);\n\t\treturn () => {\n\t\t\tcoordinator.off(\"onActionComplete\", handleComplete);\n\t\t};\n\t}, [coordinator]);\n\n\tconst execute = useCallback(\n\t\tasync (params: ActionParams): Promise<void> => {\n\t\t\tsetIsPending(true);\n\t\t\tsetLastResult(null);\n\t\t\twaitingForCompletion.current = true;\n\t\t\tawait coordinator.executeAction(params);\n\t\t},\n\t\t[coordinator],\n\t);\n\n\treturn { execute, lastResult, isPending };\n}\n\n/** Return type of `useActionDiscovery`. */\nexport interface UseActionDiscoveryResult {\n\t/** Map of connector name to supported action descriptors. */\n\tconnectors: Record<string, ActionDescriptor[]>;\n\t/** Whether discovery is loading. */\n\tisLoading: boolean;\n\t/** Error from the last fetch, or null. */\n\terror: LakeSyncError | null;\n\t/** Manually re-fetch available actions. */\n\trefetch: () => void;\n}\n\n/**\n * Discover available connectors and their supported action types.\n *\n * Calls `transport.describeActions()` on mount and returns the result\n * reactively. Use this to build dynamic UI based on available actions.\n *\n * ```ts\n * const { connectors, isLoading } = useActionDiscovery();\n *\n * for (const [name, actions] of Object.entries(connectors)) {\n *   console.log(name, actions.map(a => a.actionType));\n * }\n * ```\n */\nexport function useActionDiscovery(): UseActionDiscoveryResult {\n\tconst { coordinator } = useLakeSyncStable();\n\tconst [connectors, setConnectors] = useState<Record<string, ActionDescriptor[]>>({});\n\tconst [isLoading, setIsLoading] = useState(true);\n\tconst [error, setError] = useState<LakeSyncError | null>(null);\n\tconst [trigger, setTrigger] = useState(0);\n\n\tconst refetch = useCallback(() => {\n\t\tsetTrigger((v) => v + 1);\n\t}, []);\n\n\tuseEffect(() => {\n\t\tvoid trigger;\n\t\tlet cancelled = false;\n\n\t\tconst run = async () => {\n\t\t\tsetIsLoading(true);\n\t\t\tconst result = await coordinator.describeActions();\n\t\t\tif (cancelled) return;\n\n\t\t\tif (result.ok) {\n\t\t\t\tsetConnectors(result.value.connectors);\n\t\t\t\tsetError(null);\n\t\t\t} else {\n\t\t\t\tsetError(result.error);\n\t\t\t}\n\t\t\tsetIsLoading(false);\n\t\t};\n\n\t\trun();\n\n\t\treturn () => {\n\t\t\tcancelled = true;\n\t\t};\n\t}, [coordinator, trigger]);\n\n\treturn { connectors, isLoading, error, refetch };\n}\n","import type { ConnectorDescriptor, LakeSyncError } from \"@lakesync/core\";\nimport { useCallback, useEffect, useState } from \"react\";\nimport { useLakeSyncStable } from \"./context\";\n\n/** Return type of `useConnectorTypes`. */\nexport interface UseConnectorTypesResult {\n\t/** Array of available connector type descriptors. */\n\ttypes: ConnectorDescriptor[];\n\t/** Whether discovery is loading. */\n\tisLoading: boolean;\n\t/** Error from the last fetch, or null. */\n\terror: LakeSyncError | null;\n\t/** Manually re-fetch connector types. */\n\trefetch: () => void;\n}\n\n/**\n * Discover available connector types and their configuration schemas.\n *\n * Calls `coordinator.listConnectorTypes()` on mount and returns the\n * result reactively. Use this to build dynamic \"Add Connector\" forms.\n *\n * ```ts\n * const { types, isLoading } = useConnectorTypes();\n *\n * for (const t of types) {\n *   console.log(t.displayName, t.configSchema);\n * }\n * ```\n */\nexport function useConnectorTypes(): UseConnectorTypesResult {\n\tconst { coordinator } = useLakeSyncStable();\n\tconst [types, setTypes] = useState<ConnectorDescriptor[]>([]);\n\tconst [isLoading, setIsLoading] = useState(true);\n\tconst [error, setError] = useState<LakeSyncError | null>(null);\n\tconst [trigger, setTrigger] = useState(0);\n\n\tconst refetch = useCallback(() => {\n\t\tsetTrigger((v) => v + 1);\n\t}, []);\n\n\tuseEffect(() => {\n\t\tvoid trigger;\n\t\tlet cancelled = false;\n\n\t\tconst run = async () => {\n\t\t\tsetIsLoading(true);\n\t\t\tconst result = await coordinator.listConnectorTypes();\n\t\t\tif (cancelled) return;\n\n\t\t\tif (result.ok) {\n\t\t\t\tsetTypes(result.value);\n\t\t\t\tsetError(null);\n\t\t\t} else {\n\t\t\t\tsetError(result.error);\n\t\t\t}\n\t\t\tsetIsLoading(false);\n\t\t};\n\n\t\trun();\n\n\t\treturn () => {\n\t\t\tcancelled = true;\n\t\t};\n\t}, [coordinator, trigger]);\n\n\treturn { types, isLoading, error, refetch };\n}\n","import type { LakeSyncError, Result } from \"@lakesync/core\";\nimport { useCallback } from \"react\";\nimport { useLakeSyncData, useLakeSyncStable } from \"./context\";\n\n/** Return type of `useMutation`. */\nexport interface UseMutationResult {\n\tinsert: (\n\t\ttable: string,\n\t\trowId: string,\n\t\tdata: Record<string, unknown>,\n\t) => Promise<Result<void, LakeSyncError>>;\n\tupdate: (\n\t\ttable: string,\n\t\trowId: string,\n\t\tdata: Record<string, unknown>,\n\t) => Promise<Result<void, LakeSyncError>>;\n\tremove: (table: string, rowId: string) => Promise<Result<void, LakeSyncError>>;\n}\n\n/**\n * Wraps SyncTracker mutations with automatic query invalidation.\n *\n * After each successful mutation, `dataVersion` is incremented so all\n * active `useQuery` hooks re-run.\n */\nexport function useMutation(): UseMutationResult {\n\tconst { tracker } = useLakeSyncStable();\n\tconst { invalidate } = useLakeSyncData();\n\n\tconst insert = useCallback(\n\t\tasync (\n\t\t\ttable: string,\n\t\t\trowId: string,\n\t\t\tdata: Record<string, unknown>,\n\t\t): Promise<Result<void, LakeSyncError>> => {\n\t\t\tconst result = await tracker.insert(table, rowId, data);\n\t\t\tif (result.ok) invalidate();\n\t\t\treturn result;\n\t\t},\n\t\t[tracker, invalidate],\n\t);\n\n\tconst update = useCallback(\n\t\tasync (\n\t\t\ttable: string,\n\t\t\trowId: string,\n\t\t\tdata: Record<string, unknown>,\n\t\t): Promise<Result<void, LakeSyncError>> => {\n\t\t\tconst result = await tracker.update(table, rowId, data);\n\t\t\tif (result.ok) invalidate();\n\t\t\treturn result;\n\t\t},\n\t\t[tracker, invalidate],\n\t);\n\n\tconst remove = useCallback(\n\t\tasync (table: string, rowId: string): Promise<Result<void, LakeSyncError>> => {\n\t\t\tconst result = await tracker.delete(table, rowId);\n\t\t\tif (result.ok) invalidate();\n\t\t\treturn result;\n\t\t},\n\t\t[tracker, invalidate],\n\t);\n\n\treturn { insert, update, remove };\n}\n","import type { DbError } from \"@lakesync/client\";\nimport { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useLakeSyncData, useLakeSyncStable } from \"./context\";\n\n/** Return type of `useQuery`. */\nexport interface UseQueryResult<T> {\n\tdata: T[];\n\terror: DbError | null;\n\tisLoading: boolean;\n\trefetch: () => void;\n}\n\n/**\n * Reactive SQL query hook.\n *\n * Re-runs automatically when:\n * - Remote deltas are applied (via `onChange`)\n * - A local mutation completes (via `invalidate()`)\n * - The `sql` or `params` arguments change\n *\n * @param sql - SQL query string\n * @param params - Optional bind parameters\n */\nexport function useQuery<T>(sql: string, params?: unknown[]): UseQueryResult<T> {\n\tconst { tracker } = useLakeSyncStable();\n\tconst { dataVersion } = useLakeSyncData();\n\tconst [data, setData] = useState<T[]>([]);\n\tconst [error, setError] = useState<DbError | null>(null);\n\tconst [isLoading, setIsLoading] = useState(true);\n\tconst [manualTrigger, setManualTrigger] = useState(0);\n\n\t// Stable serialisation of params for dependency comparison\n\tconst paramsKey = JSON.stringify(params ?? []);\n\tconst paramsRef = useRef(params);\n\tparamsRef.current = params;\n\n\tconst refetch = useCallback(() => {\n\t\tsetManualTrigger((v) => v + 1);\n\t}, []);\n\n\t// Combine all trigger values into a single version for the effect.\n\t// This satisfies exhaustive-deps: the effect reads `version` directly.\n\tconst version = `${dataVersion}:${manualTrigger}:${paramsKey}`;\n\n\tuseEffect(() => {\n\t\t// Read version to establish dependency\n\t\tvoid version;\n\t\tlet cancelled = false;\n\n\t\tconst run = async () => {\n\t\t\tconst result = await tracker.query<T>(sql, paramsRef.current);\n\t\t\tif (cancelled) return;\n\n\t\t\tif (result.ok) {\n\t\t\t\tsetData(result.value);\n\t\t\t\tsetError(null);\n\t\t\t} else {\n\t\t\t\tsetError(result.error);\n\t\t\t}\n\t\t\tsetIsLoading(false);\n\t\t};\n\n\t\trun();\n\n\t\treturn () => {\n\t\t\tcancelled = true;\n\t\t};\n\t}, [tracker, sql, version]);\n\n\treturn { data, error, isLoading, refetch };\n}\n","import { useCallback, useEffect, useState } from \"react\";\nimport { useLakeSyncStable } from \"./context\";\n\n/** Return type of `useSyncStatus`. */\nexport interface UseSyncStatusResult {\n\tisSyncing: boolean;\n\tlastSyncTime: Date | null;\n\tqueueDepth: number;\n\terror: Error | null;\n}\n\n/**\n * Observe the sync lifecycle.\n *\n * Reads `coordinator.state` directly for sync status and subscribes to\n * events only for invalidation (re-reading the state snapshot).\n * Uses the stable context so it does not re-render on data version changes.\n */\nexport function useSyncStatus(): UseSyncStatusResult {\n\tconst { coordinator } = useLakeSyncStable();\n\tconst [status, setStatus] = useState<UseSyncStatusResult>({\n\t\tisSyncing: false,\n\t\tlastSyncTime: null,\n\t\tqueueDepth: 0,\n\t\terror: null,\n\t});\n\n\tconst refreshStatus = useCallback(async () => {\n\t\tconst state = coordinator.state;\n\t\tconst depth = await coordinator.queueDepth();\n\t\tsetStatus((prev) => ({\n\t\t\tisSyncing: state.syncing,\n\t\t\tlastSyncTime: state.lastSyncTime,\n\t\t\tqueueDepth: depth,\n\t\t\terror: prev.error,\n\t\t}));\n\t}, [coordinator]);\n\n\tuseEffect(() => {\n\t\tconst handleSyncStart = () => {\n\t\t\tsetStatus((prev) => ({ ...prev, isSyncing: true }));\n\t\t};\n\n\t\tconst handleSyncComplete = () => {\n\t\t\tconst state = coordinator.state;\n\t\t\tsetStatus((prev) => ({\n\t\t\t\t...prev,\n\t\t\t\tisSyncing: false,\n\t\t\t\tlastSyncTime: state.lastSyncTime,\n\t\t\t\terror: null,\n\t\t\t}));\n\t\t\trefreshStatus();\n\t\t};\n\n\t\tconst handleError = (err: Error) => {\n\t\t\tsetStatus((prev) => ({\n\t\t\t\t...prev,\n\t\t\t\tisSyncing: false,\n\t\t\t\terror: err,\n\t\t\t}));\n\t\t};\n\n\t\tconst handleChange = () => {\n\t\t\trefreshStatus();\n\t\t};\n\n\t\tcoordinator.on(\"onSyncStart\", handleSyncStart);\n\t\tcoordinator.on(\"onSyncComplete\", handleSyncComplete);\n\t\tcoordinator.on(\"onError\", handleError);\n\t\tcoordinator.on(\"onChange\", handleChange);\n\n\t\t// Initial status read\n\t\trefreshStatus();\n\n\t\treturn () => {\n\t\t\tcoordinator.off(\"onSyncStart\", handleSyncStart);\n\t\t\tcoordinator.off(\"onSyncComplete\", handleSyncComplete);\n\t\t\tcoordinator.off(\"onError\", handleError);\n\t\t\tcoordinator.off(\"onChange\", handleChange);\n\t\t};\n\t}, [coordinator, refreshStatus]);\n\n\treturn status;\n}\n"],"mappings":"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","names":["useCallback","useEffect","useState","useState","useEffect","useCallback","useCallback","useEffect","useState","useState","useCallback","useEffect","useCallback","useCallback","useCallback","useEffect","useRef","useState","useState","useRef","useCallback","useEffect","useCallback","useEffect","useState","useState","useCallback","useEffect"]}

package/dist/{registry-CPTgO9jv.d.ts → registry-BcspAtZI.d.ts}

@@ -1,5 +1,5 @@
-import { T as TableSchema } from './types-CLlD4XOy.js';
-import { d as ConnectorType } from './types-D-E0VrfS.js';
+import { T as TableSchema } from './types-BdGBv2ba.js';
+import { d as ConnectorType } from './types-BrcD1oJg.js';
 
 /** Connector category — determines the ingest model. */
 type ConnectorCategory = "database" | "api";
@@ -25,8 +25,23 @@ interface ConnectorDescriptor {
     /** Output table schemas for API connectors. Null for database connectors. */
     outputTables: ReadonlyArray<TableSchema> | null;
 }
+/** Immutable registry of connector descriptors. */
+interface ConnectorRegistry {
+    /** Look up a single descriptor by type. */
+    get(type: string): ConnectorDescriptor | undefined;
+    /** List all descriptors, sorted alphabetically by type. */
+    list(): ConnectorDescriptor[];
+    /** Create a new registry with an additional or replaced descriptor. */
+    with(descriptor: ConnectorDescriptor): ConnectorRegistry;
+    /** Create a new registry with output schemas attached to a type. */
+    withOutputSchemas(type: string, schemas: ReadonlyArray<TableSchema>): ConnectorRegistry;
+}
+/**
+ * Create an immutable {@link ConnectorRegistry} from a list of descriptors.
+ */
+declare function createConnectorRegistry(descriptors: ConnectorDescriptor[]): ConnectorRegistry;
 /**
- * Register (or replace) a connector descriptor.
+ * Register (or replace) a connector descriptor in the global registry.
  *
  * Called at module load time by built-in registration and by connector
  * packages that need to attach output schemas.
@@ -50,4 +65,4 @@ declare function getConnectorDescriptor(type: string): ConnectorDescriptor | und
  */
 declare function listConnectorDescriptors(): ConnectorDescriptor[];
 
-export { type ConnectorCategory as C, type ConnectorDescriptor as a, registerOutputSchemas as b, getConnectorDescriptor as g, listConnectorDescriptors as l, registerConnectorDescriptor as r };
+export { type ConnectorCategory as C, type ConnectorDescriptor as a, type ConnectorRegistry as b, createConnectorRegistry as c, registerOutputSchemas as d, getConnectorDescriptor as g, listConnectorDescriptors as l, registerConnectorDescriptor as r };

package/dist/{gateway-Bpvatd9n.d.ts → request-handler-pUvL7ozF.d.ts}

@@ -1,22 +1,33 @@
-import { g as ActionHandler, i as ActionPush, l as AuthContext, j as ActionResponse, a as ActionValidationError, d as ActionDiscovery, b as SyncRulesContext } from './types-Bs-QyOe-.js';
 import { H as HLCTimestamp, R as Result, S as SchemaError, b as ClockDriftError, B as BackpressureError, a as AdapterNotFoundError, A as AdapterError, F as FlushError } from './result-CojzlFE2.js';
-import { I as IngestTarget } from './base-poller-BpUyuG2R.js';
-import { R as RowDelta, a as RowKey, T as TableSchema, S as SyncPush, b as SyncPull, c as SyncResponse } from './types-CLlD4XOy.js';
-import { D as DatabaseAdapter } from './db-types-BlN-4KbQ.js';
+import { g as ActionHandler, i as ActionPush, l as AuthContext, j as ActionResponse, a as ActionValidationError, d as ActionDiscovery, S as SyncRulesConfig, b as SyncRulesContext, R as ResolvedClaims } from './types-Bs-QyOe-.js';
+import { R as RowDelta, d as RowKey, T as TableSchema, S as SyncPush, e as SyncPull, f as SyncResponse } from './types-BdGBv2ba.js';
+import { C as ConnectorConfig } from './types-BrcD1oJg.js';
+import { I as IngestTarget } from './base-poller-Bj9kX9dv.js';
+import { D as DatabaseAdapter } from './db-types-CfLMUBfW.js';
 import { L as LakeAdapter } from './types-DSC_EiwR.js';
 import { N as NessieCatalogueClient } from './nessie-client-DrNikVXy.js';
 
+/** Configuration for ActionDispatcher caches. */
+interface ActionCacheConfig {
+    /** Maximum number of entries in the executed actions set and idempotency map. */
+    maxSize?: number;
+    /** Time-to-live for idempotency entries in milliseconds. */
+    ttlMs?: number;
+}
 /**
  * Dispatches imperative actions to registered handlers.
  *
  * Manages idempotency via actionId deduplication and idempotencyKey mapping.
+ * Caches are bounded by max size and TTL to prevent unbounded growth.
  * Completely decoupled from the HLC clock — takes a callback for timestamp generation.
  */
 declare class ActionDispatcher {
     private actionHandlers;
     private executedActions;
     private idempotencyMap;
-    constructor(handlers?: Record<string, ActionHandler>);
+    private readonly maxCacheSize;
+    private readonly cacheTtlMs;
+    constructor(handlers?: Record<string, ActionHandler>, cacheConfig?: ActionCacheConfig);
     /**
      * Dispatch an action push to registered handlers.
      *
@@ -60,6 +71,10 @@ declare class ActionDispatcher {
     describe(): ActionDiscovery;
     /** Cache an action result for idempotency deduplication. */
     private cacheActionResult;
+    /** Get a cached result if it exists and hasn't expired. */
+    private getCachedResult;
+    /** Evict expired entries and trim to max size. */
+    private evictStaleEntries;
 }
 
 /**
@@ -100,6 +115,19 @@ declare class DeltaBuffer {
     }>;
     /** Drain only the specified table's deltas, leaving other tables intact. */
     drainTable(table: string): RowDelta[];
+    /**
+     * Snapshot the current buffer state without clearing it.
+     *
+     * Useful for inspecting the buffer contents without draining.
+     * Use {@link clear} separately after a successful flush for
+     * transactional semantics.
+     */
+    snapshot(): {
+        entries: RowDelta[];
+        byteSize: number;
+    };
+    /** Clear all buffer state. */
+    clear(): void;
     /** Drain the log for flush. Returns log entries and clears both structures. */
     drain(): RowDelta[];
     /** Number of log entries */
@@ -112,6 +140,36 @@ declare class DeltaBuffer {
     get averageDeltaBytes(): number;
 }
 
+/**
+ * Platform-agnostic configuration storage interface.
+ *
+ * Implemented by MemoryConfigStore (tests, gateway-server) and
+ * DurableStorageConfigStore (gateway-worker).
+ */
+interface ConfigStore {
+    getSchema(gatewayId: string): Promise<TableSchema | undefined>;
+    setSchema(gatewayId: string, schema: TableSchema): Promise<void>;
+    getSyncRules(gatewayId: string): Promise<SyncRulesConfig | undefined>;
+    setSyncRules(gatewayId: string, rules: SyncRulesConfig): Promise<void>;
+    getConnectors(): Promise<Record<string, ConnectorConfig>>;
+    setConnectors(connectors: Record<string, ConnectorConfig>): Promise<void>;
+}
+/**
+ * In-memory implementation of ConfigStore.
+ * Used by tests and gateway-server.
+ */
+declare class MemoryConfigStore implements ConfigStore {
+    private schemas;
+    private syncRules;
+    private connectors;
+    getSchema(gatewayId: string): Promise<TableSchema | undefined>;
+    setSchema(gatewayId: string, schema: TableSchema): Promise<void>;
+    getSyncRules(gatewayId: string): Promise<SyncRulesConfig | undefined>;
+    setSyncRules(gatewayId: string, rules: SyncRulesConfig): Promise<void>;
+    getConnectors(): Promise<Record<string, ConnectorConfig>>;
+    setConnectors(connectors: Record<string, ConnectorConfig>): Promise<void>;
+}
+
 /**
  * Manages schema versioning and validation for the gateway.
  *
@@ -225,7 +283,8 @@ interface FlushEnvelope {
 /**
  * Sync gateway -- coordinates delta ingestion, conflict resolution, and flush.
  *
- * Thin facade composing ActionDispatcher, DeltaBuffer, and flushEntries.
+ * Thin facade composing DeltaBuffer, ActionDispatcher, SourceRegistry,
+ * and FlushCoordinator. Public methods delegate to composed modules.
  */
 declare class SyncGateway implements IngestTarget {
     private hlc;
@@ -233,10 +292,9 @@ declare class SyncGateway implements IngestTarget {
     readonly actions: ActionDispatcher;
     private config;
     private adapter;
-    private flushing;
+    private readonly sources;
+    private readonly flushCoordinator;
     constructor(config: GatewayConfig, adapter?: LakeAdapter | DatabaseAdapter);
-    /** Restore drained entries back to the buffer for retry. */
-    private restoreEntries;
     /**
      * Handle an incoming push from a client.
      *
@@ -247,6 +305,8 @@ declare class SyncGateway implements IngestTarget {
      *          or a `ClockDriftError` if the client clock is too far ahead.
      */
     handlePush(msg: SyncPush): Result<HandlePushResult, ClockDriftError | SchemaError | BackpressureError>;
+    /** Check buffer backpressure. */
+    private checkBackpressure;
     /**
      * Handle a pull request from a client.
      *
@@ -336,4 +396,73 @@ declare class SyncGateway implements IngestTarget {
     };
 }
 
-export { ActionDispatcher as A, type BufferConfig as B, DeltaBuffer as D, type FlushEnvelope as F, type GatewayConfig as G, type HandlePushResult as H, SyncGateway as S, type GatewayState as a, SchemaManager as b };
+/** Result from a request handler, ready for platform-specific serialisation. */
+interface HandlerResult {
+    status: number;
+    body: unknown;
+}
+/**
+ * Handle a push request.
+ *
+ * @param gateway - The SyncGateway instance.
+ * @param raw - The raw request body string.
+ * @param headerClientId - Client ID from auth header (for mismatch check).
+ * @param opts - Optional callbacks for persistence and broadcast.
+ */
+declare function handlePushRequest(gateway: SyncGateway, raw: string, headerClientId?: string | null, opts?: {
+    /** Persist deltas before processing (WAL-style). */
+    persistBatch?: (deltas: RowDelta[]) => void;
+    /** Clear persisted deltas after successful push. */
+    clearPersistence?: () => void;
+    /** Broadcast deltas to connected clients. */
+    broadcastFn?: (deltas: RowDelta[], serverHlc: HLCTimestamp, excludeClientId: string) => void | Promise<void>;
+}): HandlerResult;
+/**
+ * Handle a pull request.
+ */
+declare function handlePullRequest(gateway: SyncGateway, params: {
+    since: string | null;
+    clientId: string | null;
+    limit: string | null;
+    source: string | null;
+}, claims?: ResolvedClaims, syncRules?: SyncRulesConfig): Promise<HandlerResult>;
+/**
+ * Handle an action request.
+ */
+declare function handleActionRequest(gateway: SyncGateway, raw: string, headerClientId?: string | null, claims?: ResolvedClaims): Promise<HandlerResult>;
+/**
+ * Handle a flush request.
+ */
+declare function handleFlushRequest(gateway: SyncGateway, opts?: {
+    clearPersistence?: () => void;
+}): Promise<HandlerResult>;
+/**
+ * Handle saving a table schema.
+ */
+declare function handleSaveSchema(raw: string, store: ConfigStore, gatewayId: string): Promise<HandlerResult>;
+/**
+ * Handle saving sync rules.
+ */
+declare function handleSaveSyncRules(raw: string, store: ConfigStore, gatewayId: string): Promise<HandlerResult>;
+/**
+ * Handle registering a connector.
+ */
+declare function handleRegisterConnector(raw: string, store: ConfigStore): Promise<HandlerResult>;
+/**
+ * Handle unregistering a connector.
+ */
+declare function handleUnregisterConnector(name: string, store: ConfigStore): Promise<HandlerResult>;
+/**
+ * Handle listing connectors.
+ */
+declare function handleListConnectors(store: ConfigStore): Promise<HandlerResult>;
+/**
+ * Handle listing available connector types (static metadata).
+ */
+declare function handleListConnectorTypes(): HandlerResult;
+/**
+ * Handle metrics request.
+ */
+declare function handleMetrics(gateway: SyncGateway, extra?: Record<string, unknown>): HandlerResult;
+
+export { type ActionCacheConfig as A, type BufferConfig as B, type ConfigStore as C, DeltaBuffer as D, type FlushEnvelope as F, type GatewayConfig as G, type HandlePushResult as H, MemoryConfigStore as M, SchemaManager as S, ActionDispatcher as a, type GatewayState as b, type HandlerResult as c, SyncGateway as d, handleFlushRequest as e, handleListConnectorTypes as f, handleListConnectors as g, handleActionRequest as h, handleMetrics as i, handlePullRequest as j, handlePushRequest as k, handleRegisterConnector as l, handleSaveSchema as m, handleSaveSyncRules as n, handleUnregisterConnector as o };

package/dist/{resolver-CbuXm3nB.d.ts → resolver-CXxmC0jR.d.ts}

@@ -1,4 +1,4 @@
-import { R as RowDelta } from './types-CLlD4XOy.js';
+import { R as RowDelta } from './types-BdGBv2ba.js';
 import { R as Result, C as ConflictError } from './result-CojzlFE2.js';
 
 /** Strategy for resolving conflicting row deltas */

package/dist/{src-FPJQYQNA.js → src-B6NLV3FP.js}

@@ -9,9 +9,9 @@ import {
   mapLead,
   mapOpportunity,
   testConnection
-} from "./chunk-NCZYFZ3B.js";
-import "./chunk-P3FT7QCW.js";
-import "./chunk-7D4SUZUM.js";
+} from "./chunk-QNITY4F6.js";
+import "./chunk-LDFFCG2K.js";
+import "./chunk-DGUM43GV.js";
 export {
   SALESFORCE_TABLE_SCHEMAS,
   SalesforceApiError,
@@ -24,4 +24,4 @@ export {
   mapOpportunity,
   testConnection
 };
-//# sourceMappingURL=src-FPJQYQNA.js.map
+//# sourceMappingURL=src-B6NLV3FP.js.map