lakesync 0.1.6 → 0.2.0

package/dist/gateway.d.ts

@@ -1,47 +1,16 @@
 import { S as SyncRulesConfig, R as ResolvedClaims, b as SyncRulesContext, i as ActionPush } from './types-Bs-QyOe-.js';
 export { d as ActionDiscovery, g as ActionHandler, j as ActionResponse, l as AuthContext } from './types-Bs-QyOe-.js';
-export { I as IngestTarget, i as isIngestTarget } from './base-poller-BpUyuG2R.js';
-import { T as TableSchema, R as RowDelta, b as SyncPull, S as SyncPush } from './types-CLlD4XOy.js';
-export { c as SyncResponse } from './types-CLlD4XOy.js';
+import { T as TableSchema, R as RowDelta, e as SyncPull, S as SyncPush } from './types-BdGBv2ba.js';
+export { f as SyncResponse } from './types-BdGBv2ba.js';
+export { I as IngestTarget, i as isIngestTarget } from './base-poller-Y7ORYgUv.js';
 export { b as bigintReplacer, a as bigintReviver } from './json-dYtqiL0F.js';
-import { S as SyncGateway } from './gateway-Bpvatd9n.js';
-export { A as ActionDispatcher, B as BufferConfig, D as DeltaBuffer, F as FlushEnvelope, G as GatewayConfig, a as GatewayState, H as HandlePushResult, b as SchemaManager } from './gateway-Bpvatd9n.js';
-import { C as ConnectorConfig } from './types-D-E0VrfS.js';
-import { R as Result, F as FlushError, H as HLCTimestamp } from './result-CojzlFE2.js';
-import { D as DatabaseAdapter } from './db-types-BlN-4KbQ.js';
-import { L as LakeAdapter } from './types-DSC_EiwR.js';
+import { D as DeltaBuffer } from './request-handler-B1I5xDOx.js';
+export { A as ActionCacheConfig, a as ActionDispatcher, B as BufferConfig, C as CachedActionResult, b as ConfigStore, F as FlushEnvelope, G as GatewayConfig, c as GatewayState, H as HandlePushResult, d as HandlerResult, I as IdempotencyCache, e as IdempotencyCacheConfig, M as MemoryConfigStore, f as MemoryIdempotencyCache, S as SchemaManager, g as SyncGateway, h as handleActionRequest, i as handleFlushRequest, j as handleListConnectorTypes, k as handleListConnectors, l as handleMetrics, m as handlePullRequest, n as handlePushRequest, o as handleRegisterConnector, p as handleSaveSchema, q as handleSaveSyncRules, r as handleUnregisterConnector } from './request-handler-B1I5xDOx.js';
 import { N as NessieCatalogueClient } from './nessie-client-DrNikVXy.js';
+import { R as Result, F as FlushError, H as HLCTimestamp } from './result-CojzlFE2.js';
+import { L as LakeAdapter, D as DatabaseAdapter } from './adapter-types-DwsQGQS4.js';
 import './hlc-DiD8QNG3.js';
-
-/**
- * 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>;
-}
+import './types-D2C9jTbL.js';
 
 /** Maximum push payload size (1 MiB). */
 declare const MAX_PUSH_PAYLOAD_BYTES = 1048576;
@@ -51,8 +20,8 @@ declare const MAX_DELTAS_PER_PUSH = 10000;
 declare const MAX_PULL_LIMIT = 10000;
 /** Default number of deltas returned in a pull when no limit is specified. */
 declare const DEFAULT_PULL_LIMIT = 100;
-/** Allowed column types for schema validation. */
-declare const VALID_COLUMN_TYPES: Set<string>;
+/** Allowed column types for schema validation. Derived from core COLUMN_TYPES. */
+declare const VALID_COLUMN_TYPES: ReadonlySet<string>;
 /** Default maximum buffer size before triggering flush (4 MiB). */
 declare const DEFAULT_MAX_BUFFER_BYTES: number;
 /** Default maximum buffer age before triggering flush (30 seconds). */
@@ -64,6 +33,8 @@ interface FlushConfig {
     flushFormat?: "json" | "parquet";
     tableSchema?: TableSchema;
     catalogue?: NessieCatalogueClient;
+    /** Optional callback invoked when materialisation fails. Useful for metrics/alerting. */
+    onMaterialisationFailure?: (table: string, deltaCount: number, error: Error) => void;
 }
 /** Dependencies injected into flush operations. */
 interface FlushDeps {
@@ -77,6 +48,11 @@ declare function hlcRange(entries: RowDelta[]): {
     min: HLCTimestamp;
     max: HLCTimestamp;
 };
+/** Strategy for flushing deltas to a specific adapter type. */
+interface FlushStrategy {
+    /** Flush entries to the target adapter. */
+    flush(entries: RowDelta[], byteSize: number, deps: FlushDeps, keyPrefix?: string): Promise<Result<void, FlushError>>;
+}
 /**
  * Flush a set of entries to the configured adapter.
  *
@@ -92,80 +68,67 @@ declare function flushEntries(entries: RowDelta[], byteSize: number, deps: Flush
  */
 declare function commitToCatalogue(objectKey: string, fileSizeInBytes: number, recordCount: number, catalogue: NessieCatalogueClient, schema: TableSchema): Promise<void>;
 
-/** Result from a request handler, ready for platform-specific serialisation. */
-interface HandlerResult {
-    status: number;
-    body: unknown;
+/** Dependencies for flush operations. */
+interface FlushCoordinatorDeps {
+    /** Gateway configuration for flush. */
+    config: FlushConfig;
+    /** Table schemas for materialisation after flush. */
+    schemas?: ReadonlyArray<TableSchema>;
 }
 /**
- * Handle a push request.
+ * Coordinates flush operations from the buffer to the adapter.
  *
- * @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;
+ * Owns the flushing state to prevent concurrent flushes and handles
+ * entry restoration on failure.
+ */
+declare class FlushCoordinator {
+    private flushing;
+    /** Whether a flush is currently in progress. */
+    get isFlushing(): boolean;
+    /**
+     * Flush all entries from the buffer to the adapter.
+     *
+     * Drains the buffer first, then writes to the adapter. On failure,
+     * entries are restored to the buffer.
+     */
+    flush(buffer: DeltaBuffer, adapter: LakeAdapter | DatabaseAdapter | null, deps: FlushCoordinatorDeps): Promise<Result<void, FlushError>>;
+    /**
+     * Flush a single table's deltas from the buffer.
+     *
+     * Drains only the specified table's deltas and flushes them,
+     * leaving other tables in the buffer.
+     */
+    flushTable(table: string, buffer: DeltaBuffer, adapter: LakeAdapter | DatabaseAdapter | null, deps: FlushCoordinatorDeps): Promise<Result<void, FlushError>>;
+    /** Restore drained entries back to the buffer for retry. */
+    private restoreEntries;
+}
+
 /**
- * Handle metrics request.
- */
-declare function handleMetrics(gateway: SyncGateway, extra?: Record<string, unknown>): HandlerResult;
+ * Registry for named source adapters used in adapter-sourced pulls.
+ *
+ * Manages the mapping of source names to DatabaseAdapter instances,
+ * decoupling source adapter management from the gateway.
+ */
+declare class SourceRegistry {
+    private sources;
+    constructor(initial?: Record<string, DatabaseAdapter>);
+    /** Register a named source adapter. */
+    register(name: string, adapter: DatabaseAdapter): void;
+    /** Unregister a named source adapter. */
+    unregister(name: string): void;
+    /** Get a source adapter by name, or undefined if not registered. */
+    get(name: string): DatabaseAdapter | undefined;
+    /** List all registered source adapter names. */
+    list(): string[];
+}
 
 /** Validation error with HTTP status code. */
 interface RequestError {
     status: number;
     message: string;
 }
+/** Parse a JSON string, returning Err on invalid JSON. */
+declare function parseJson<T>(raw: string, reviver?: (key: string, value: unknown) => unknown): Result<T, RequestError>;
 /**
  * Validate and parse a push request body.
  * Handles JSON parsing with bigint revival.
@@ -198,4 +161,4 @@ declare function pushErrorToStatus(code: string): number;
  */
 declare function buildSyncRulesContext(rules: SyncRulesConfig | undefined, claims: ResolvedClaims): SyncRulesContext | undefined;
 
-export { ActionPush, type ConfigStore, DEFAULT_MAX_BUFFER_AGE_MS, DEFAULT_MAX_BUFFER_BYTES, DEFAULT_PULL_LIMIT, type FlushConfig, type FlushDeps, type HandlerResult, MAX_DELTAS_PER_PUSH, MAX_PULL_LIMIT, MAX_PUSH_PAYLOAD_BYTES, MemoryConfigStore, type RequestError, SyncGateway, SyncPull, SyncPush, VALID_COLUMN_TYPES, buildSyncRulesContext, commitToCatalogue, flushEntries, handleActionRequest, handleFlushRequest, handleListConnectorTypes, handleListConnectors, handleMetrics, handlePullRequest, handlePushRequest, handleRegisterConnector, handleSaveSchema, handleSaveSyncRules, handleUnregisterConnector, hlcRange, parsePullParams, pushErrorToStatus, validateActionBody, validatePushBody, validateSchemaBody };
+export { ActionPush, DEFAULT_MAX_BUFFER_AGE_MS, DEFAULT_MAX_BUFFER_BYTES, DEFAULT_PULL_LIMIT, DeltaBuffer, type FlushConfig, FlushCoordinator, type FlushCoordinatorDeps, type FlushDeps, type FlushStrategy, MAX_DELTAS_PER_PUSH, MAX_PULL_LIMIT, MAX_PUSH_PAYLOAD_BYTES, type RequestError, SourceRegistry, SyncPull, SyncPush, VALID_COLUMN_TYPES, buildSyncRulesContext, commitToCatalogue, flushEntries, hlcRange, parseJson, parsePullParams, pushErrorToStatus, validateActionBody, validatePushBody, validateSchemaBody };

package/dist/gateway.js

@@ -4,11 +4,14 @@ import {
   DEFAULT_MAX_BUFFER_BYTES,
   DEFAULT_PULL_LIMIT,
   DeltaBuffer,
+  FlushCoordinator,
   MAX_DELTAS_PER_PUSH,
   MAX_PULL_LIMIT,
   MAX_PUSH_PAYLOAD_BYTES,
   MemoryConfigStore,
+  MemoryIdempotencyCache,
   SchemaManager,
+  SourceRegistry,
   SyncGateway,
   VALID_COLUMN_TYPES,
   buildSyncRulesContext,
@@ -26,32 +29,35 @@ import {
   handleSaveSyncRules,
   handleUnregisterConnector,
   hlcRange,
+  parseJson,
   parsePullParams,
   pushErrorToStatus,
   validateActionBody,
   validatePushBody,
   validateSchemaBody
-} from "./chunk-IRJ4QRWV.js";
-import "./chunk-GUJWMK5P.js";
-import "./chunk-UAUQGP3B.js";
-import "./chunk-SF7Y6ZUA.js";
+} from "./chunk-FIIHPQMQ.js";
+import "./chunk-U2NV4DUX.js";
+import "./chunk-ZU7RC7CT.js";
 import {
   bigintReplacer,
   bigintReviver,
   isIngestTarget
-} from "./chunk-P3FT7QCW.js";
-import "./chunk-7D4SUZUM.js";
+} from "./chunk-4SG66H5K.js";
+import "./chunk-DGUM43GV.js";
 export {
   ActionDispatcher,
   DEFAULT_MAX_BUFFER_AGE_MS,
   DEFAULT_MAX_BUFFER_BYTES,
   DEFAULT_PULL_LIMIT,
   DeltaBuffer,
+  FlushCoordinator,
   MAX_DELTAS_PER_PUSH,
   MAX_PULL_LIMIT,
   MAX_PUSH_PAYLOAD_BYTES,
   MemoryConfigStore,
+  MemoryIdempotencyCache,
   SchemaManager,
+  SourceRegistry,
   SyncGateway,
   VALID_COLUMN_TYPES,
   bigintReplacer,
@@ -72,6 +78,7 @@ export {
   handleUnregisterConnector,
   hlcRange,
   isIngestTarget,
+  parseJson,
   parsePullParams,
   pushErrorToStatus,
   validateActionBody,

package/dist/index.d.ts

@@ -2,15 +2,16 @@ import { A as Action, a as ActionValidationError, S as SyncRulesConfig, B as Buc
 export { c as ActionDescriptor, d as ActionDiscovery, e as ActionErrorResult, f as ActionExecutionError, g as ActionHandler, h as ActionNotSupportedError, i as ActionPush, j as ActionResponse, k as ActionResult, l as AuthContext, m as SyncRuleFilter, n as SyncRuleOp, o as isActionError, p as isActionHandler } from './types-Bs-QyOe-.js';
 import { H as HLCTimestamp, R as Result, C as ConflictError, L as LakeSyncError, S as SchemaError } from './result-CojzlFE2.js';
 export { A as AdapterError, a as AdapterNotFoundError, B as BackpressureError, b as ClockDriftError, E as Err, F as FlushError, O as Ok, f as flatMapResult, c as fromPromise, m as mapResult, t as toError, u as unwrapOrThrow } from './result-CojzlFE2.js';
-export { A as AuthClaims, a as AuthError, v as verifyToken } from './auth-CAVutXzx.js';
-import { P as PushTarget, B as BaseSourcePoller } from './base-poller-BpUyuG2R.js';
-export { I as IngestTarget, a as PollerMemoryConfig, i as isIngestTarget } from './base-poller-BpUyuG2R.js';
-import { S as SyncPush, R as RowDelta, T as TableSchema } from './types-CLlD4XOy.js';
-export { C as ColumnDelta, D as DeltaOp, a as RowKey, b as SyncPull, c as SyncResponse, r as rowKey } from './types-CLlD4XOy.js';
-import { C as ConflictResolver } from './resolver-CbuXm3nB.js';
-export { C as ConnectorCategory, a as ConnectorDescriptor, g as getConnectorDescriptor, l as listConnectorDescriptors, r as registerConnectorDescriptor, b as registerOutputSchemas } from './registry-CPTgO9jv.js';
-import { C as ConnectorConfig } from './types-D-E0VrfS.js';
-export { B as BigQueryConnectorConfig, a as CONNECTOR_TYPES, b as ConnectorIngestConfig, c as ConnectorIngestTable, d as ConnectorType, J as JiraConnectorConfig, M as MySQLConnectorConfig, P as PostgresConnectorConfig, S as SalesforceConnectorConfig } from './types-D-E0VrfS.js';
+export { D as DatabaseAdapter, a as DatabaseAdapterConfig, L as LakeAdapter, M as Materialisable, O as ObjectInfo, i as isDatabaseAdapter, b as isMaterialisable } from './adapter-types-DwsQGQS4.js';
+export { A as AuthClaims, a as AuthError, P as PollerFactory, b as PollerRegistry, c as createPoller, d as createPollerRegistry, v as verifyToken } from './create-poller-Cc2MGfhh.js';
+import { P as PushTarget } from './base-poller-Y7ORYgUv.js';
+export { B as BaseSourcePoller, C as ChunkedPusher, F as FlushableTarget, I as IngestTarget, a as PollerMemoryConfig, b as PressureManager, i as isIngestTarget } from './base-poller-Y7ORYgUv.js';
+import { R as RowDelta, T as TableSchema, S as SyncPush } from './types-BdGBv2ba.js';
+export { C as COLUMN_TYPES, a as ColumnDelta, b as ColumnReference, c as ColumnType, D as DeltaOp, d as RowKey, e as SyncPull, f as SyncResponse, r as rowKey } from './types-BdGBv2ba.js';
+import { C as ConflictResolver } from './resolver-CXxmC0jR.js';
+export { C as ConnectorCategory, a as ConnectorDescriptor, b as ConnectorRegistry, c as createConnectorRegistry, g as getConnectorDescriptor, l as listConnectorDescriptors, r as registerConnectorDescriptor, d as registerOutputSchemas } from './registry-Dd8JuW8T.js';
+import { C as ConnectorConfig } from './types-D2C9jTbL.js';
+export { B as BigQueryConnectorConfig, a as BigQueryConnectorConfigFull, b as CONNECTOR_TYPES, c as ConnectorConfigBase, d as ConnectorIngestConfig, e as ConnectorIngestTable, f as ConnectorType, J as JiraConnectorConfig, g as JiraConnectorConfigFull, M as MySQLConnectorConfig, h as MySQLConnectorConfigFull, P as PostgresConnectorConfig, i as PostgresConnectorConfigFull, S as SalesforceConnectorConfig, j as SalesforceConnectorConfigFull } from './types-D2C9jTbL.js';
 export { H as HLC } from './hlc-DiD8QNG3.js';
 export { b as bigintReplacer, a as bigintReviver } from './json-dYtqiL0F.js';
 
@@ -36,6 +37,42 @@ declare function generateActionId(params: {
  */
 declare function validateAction(action: unknown): Result<Action, ActionValidationError>;
 
+/**
+ * Apply a delta to an existing row, returning the merged result.
+ *
+ * - DELETE → returns null
+ * - INSERT → creates a new row from delta columns
+ * - UPDATE → merges delta columns onto existing row (immutable — returns a new object)
+ *
+ * @param row - The current row state, or null if no row exists
+ * @param delta - The delta to apply
+ * @returns The merged row, or null for DELETE operations
+ */
+declare function applyDelta(row: Record<string, unknown> | null, delta: RowDelta): Record<string, unknown> | null;
+
+/**
+ * Extract a column-level delta between two row states.
+ *
+ * - `before` null/undefined + `after` present -> INSERT (all columns)
+ * - `before` present + `after` null/undefined -> DELETE (empty columns)
+ * - Both present -> compare each column, emit only changed columns as UPDATE
+ * - No columns changed -> returns null (no-op)
+ *
+ * If `schema` is provided, only columns listed in the schema are considered.
+ *
+ * @param before - The previous row state, or null/undefined for a new row
+ * @param after - The current row state, or null/undefined for a deleted row
+ * @param opts - Table name, row ID, client ID, HLC timestamp, and optional schema
+ * @returns The extracted RowDelta, or null if nothing changed
+ */
+declare function extractDelta(before: Record<string, unknown> | null | undefined, after: Record<string, unknown> | null | undefined, opts: {
+    table: string;
+    rowId: string;
+    clientId: string;
+    hlc: HLCTimestamp;
+    schema?: TableSchema;
+}): Promise<RowDelta | null>;
+
 /**
  * A simple PushTarget implementation that forwards every push to a
  * user-supplied callback. Useful for testing, logging, or lightweight
@@ -102,56 +139,26 @@ declare class ConnectorValidationError extends LakeSyncError {
  */
 declare function validateConnectorConfig(input: unknown): Result<ConnectorConfig, ConnectorValidationError>;
 
-/** Factory function that creates a poller from a ConnectorConfig. */
-type PollerFactory = (config: ConnectorConfig, gateway: PushTarget) => BaseSourcePoller;
-/**
- * Register a poller factory for a connector type.
- * Connector packages call this at module load time so that
- * `createPoller()` can instantiate the correct poller.
- */
-declare function registerPollerFactory(type: string, factory: PollerFactory): void;
-/**
- * Create a poller from a {@link ConnectorConfig}.
- *
- * @throws If no factory has been registered for the config's `type`.
- */
-declare function createPoller(config: ConnectorConfig, gateway: PushTarget): BaseSourcePoller;
-
 /**
- * Apply a delta to an existing row, returning the merged result.
- *
- * - DELETE → returns null
- * - INSERT → creates a new row from delta columns
- * - UPDATE → merges delta columns onto existing row (immutable — returns a new object)
- *
- * @param row - The current row state, or null if no row exists
- * @param delta - The delta to apply
- * @returns The merged row, or null for DELETE operations
- */
-declare function applyDelta(row: Record<string, unknown> | null, delta: RowDelta): Record<string, unknown> | null;
-
-/**
- * Extract a column-level delta between two row states.
- *
- * - `before` null/undefined + `after` present -> INSERT (all columns)
- * - `before` present + `after` null/undefined -> DELETE (empty columns)
- * - Both present -> compare each column, emit only changed columns as UPDATE
- * - No columns changed -> returns null (no-op)
- *
- * If `schema` is provided, only columns listed in the schema are considered.
- *
- * @param before - The previous row state, or null/undefined for a new row
- * @param after - The current row state, or null/undefined for a deleted row
- * @param opts - Table name, row ID, client ID, HLC timestamp, and optional schema
- * @returns The extracted RowDelta, or null if nothing changed
+ * Manages the start/stop lifecycle and timer scheduling for a poll function.
+ * Has no knowledge of deltas, gateways, or sync protocol.
  */
-declare function extractDelta(before: Record<string, unknown> | null | undefined, after: Record<string, unknown> | null | undefined, opts: {
-    table: string;
-    rowId: string;
-    clientId: string;
-    hlc: HLCTimestamp;
-    schema?: TableSchema;
-}): Promise<RowDelta | null>;
+declare class PollingScheduler {
+    private readonly pollFn;
+    private readonly intervalMs;
+    private timer;
+    private running;
+    constructor(pollFn: () => Promise<void>, intervalMs: number);
+    /** Start the polling loop. No-op if already running. */
+    start(): void;
+    /** Stop the polling loop. */
+    stop(): void;
+    /** Whether the scheduler is currently running. */
+    get isRunning(): boolean;
+    /** Execute a single poll cycle without the timer loop. */
+    pollOnce(): Promise<void>;
+    private schedule;
+}
 
 /**
  * Create a pass-all sync rules configuration.
@@ -270,4 +277,4 @@ declare function assertValidIdentifier(name: string): Result<void, SchemaError>;
  */
 declare function quoteIdentifier(name: string): string;
 
-export { Action, ActionValidationError, BaseSourcePoller, BucketDefinition, CallbackPushTarget, ConflictError, ConflictResolver, ConnectorConfig, ConnectorValidationError, HLCTimestamp, LWWResolver, LakeSyncError, type PollerFactory, PushTarget, ResolvedClaims, Result, RowDelta, SchemaError, SyncPush, SyncRuleError, SyncRulesConfig, SyncRulesContext, TableSchema, applyDelta, assertValidIdentifier, createPassAllRules, createPoller, createUserScopedRules, deltaMatchesBucket, extractDelta, filterDeltas, generateActionId, isValidIdentifier, quoteIdentifier, registerPollerFactory, resolveClientBuckets, resolveFilterValue, resolveLWW, validateAction, validateConnectorConfig, validateSyncRules };
+export { Action, ActionValidationError, BucketDefinition, CallbackPushTarget, ConflictError, ConflictResolver, ConnectorConfig, ConnectorValidationError, HLCTimestamp, LWWResolver, LakeSyncError, PollingScheduler, PushTarget, ResolvedClaims, Result, RowDelta, SchemaError, SyncPush, SyncRuleError, SyncRulesConfig, SyncRulesContext, TableSchema, applyDelta, assertValidIdentifier, createPassAllRules, createUserScopedRules, deltaMatchesBucket, extractDelta, filterDeltas, generateActionId, isValidIdentifier, quoteIdentifier, resolveClientBuckets, resolveFilterValue, resolveLWW, validateAction, validateConnectorConfig, validateSyncRules };

package/dist/index.js

@@ -7,8 +7,10 @@ import {
   AuthError,
   BackpressureError,
   BaseSourcePoller,
+  COLUMN_TYPES,
   CONNECTOR_TYPES,
   CallbackPushTarget,
+  ChunkedPusher,
   ClockDriftError,
   ConflictError,
   ConnectorValidationError,
@@ -18,14 +20,18 @@ import {
   LWWResolver,
   LakeSyncError,
   Ok,
+  PollingScheduler,
+  PressureManager,
   SchemaError,
   SyncRuleError,
   applyDelta,
   assertValidIdentifier,
   bigintReplacer,
   bigintReviver,
+  createConnectorRegistry,
   createPassAllRules,
   createPoller,
+  createPollerRegistry,
   createUserScopedRules,
   deltaMatchesBucket,
   extractDelta,
@@ -36,14 +42,15 @@ import {
   getConnectorDescriptor,
   isActionError,
   isActionHandler,
+  isDatabaseAdapter,
   isIngestTarget,
+  isMaterialisable,
   isValidIdentifier,
   listConnectorDescriptors,
   mapResult,
   quoteIdentifier,
   registerConnectorDescriptor,
   registerOutputSchemas,
-  registerPollerFactory,
   resolveClientBuckets,
   resolveFilterValue,
   resolveLWW,
@@ -54,8 +61,8 @@ import {
   validateConnectorConfig,
   validateSyncRules,
   verifyToken
-} from "./chunk-P3FT7QCW.js";
-import "./chunk-7D4SUZUM.js";
+} from "./chunk-4SG66H5K.js";
+import "./chunk-DGUM43GV.js";
 export {
   ActionExecutionError,
   ActionNotSupportedError,
@@ -65,8 +72,10 @@ export {
   AuthError,
   BackpressureError,
   BaseSourcePoller,
+  COLUMN_TYPES,
   CONNECTOR_TYPES,
   CallbackPushTarget,
+  ChunkedPusher,
   ClockDriftError,
   ConflictError,
   ConnectorValidationError,
@@ -76,14 +85,18 @@ export {
   LWWResolver,
   LakeSyncError,
   Ok,
+  PollingScheduler,
+  PressureManager,
   SchemaError,
   SyncRuleError,
   applyDelta,
   assertValidIdentifier,
   bigintReplacer,
   bigintReviver,
+  createConnectorRegistry,
   createPassAllRules,
   createPoller,
+  createPollerRegistry,
   createUserScopedRules,
   deltaMatchesBucket,
   extractDelta,
@@ -94,14 +107,15 @@ export {
   getConnectorDescriptor,
   isActionError,
   isActionHandler,
+  isDatabaseAdapter,
   isIngestTarget,
+  isMaterialisable,
   isValidIdentifier,
   listConnectorDescriptors,
   mapResult,
   quoteIdentifier,
   registerConnectorDescriptor,
   registerOutputSchemas,
-  registerPollerFactory,
   resolveClientBuckets,
   resolveFilterValue,
   resolveLWW,

package/dist/parquet.d.ts

@@ -1,4 +1,4 @@
-import { T as TableSchema, R as RowDelta } from './types-CLlD4XOy.js';
+import { T as TableSchema, R as RowDelta } from './types-BdGBv2ba.js';
 import * as arrow from 'apache-arrow';
 import { R as Result, F as FlushError } from './result-CojzlFE2.js';
 

package/dist/parquet.js

@@ -3,9 +3,9 @@ import {
   deltasToArrowTable,
   readParquetToDeltas,
   writeDeltasToParquet
-} from "./chunk-SF7Y6ZUA.js";
-import "./chunk-P3FT7QCW.js";
-import "./chunk-7D4SUZUM.js";
+} from "./chunk-ZU7RC7CT.js";
+import "./chunk-4SG66H5K.js";
+import "./chunk-DGUM43GV.js";
 export {
   buildArrowSchema,
   deltasToArrowTable,

package/dist/proto.d.ts

@@ -1,6 +1,6 @@
 import { H as HLCTimestamp, R as Result } from './result-CojzlFE2.js';
 import { i as ActionPush$1, j as ActionResponse$1 } from './types-Bs-QyOe-.js';
-import { R as RowDelta$1 } from './types-CLlD4XOy.js';
+import { R as RowDelta$1 } from './types-BdGBv2ba.js';
 import { GenMessage, GenEnum } from '@bufbuild/protobuf/codegenv2';
 import { Message } from '@bufbuild/protobuf';
 

package/dist/proto.js

@@ -29,9 +29,9 @@ import {
   encodeSyncPull,
   encodeSyncPush,
   encodeSyncResponse
-} from "./chunk-FHVTUKXL.js";
-import "./chunk-P3FT7QCW.js";
-import "./chunk-7D4SUZUM.js";
+} from "./chunk-YHYBLU6W.js";
+import "./chunk-4SG66H5K.js";
+import "./chunk-DGUM43GV.js";
 export {
   ActionPushSchema,
   ActionResponseSchema,