@lunora/shard-engine 1.0.0-alpha.36 → 1.0.0-alpha.38

package/dist/conformance/index.mjs

@@ -1 +1 @@
-import{defineEngineContractSuite as t}from"../packem_shared/defineEngineContractSuite-iK4MwBOl.mjs";export{t as defineEngineContractSuite};
+import{defineEngineContractSuite as t}from"../packem_shared/defineEngineContractSuite-C6NKOjJn.mjs";export{t as defineEngineContractSuite};

package/dist/index.d.mts

@@ -425,6 +425,13 @@ interface MutationDelta {
 interface DatabaseWriterLike {
   aggregate: (tableName: string, options: AggregateOptions) => Promise<AggregateResult>;
   asId?: (tableName: string, id: string) => string;
+  cdcChangedTables?: (sinceSeq: number, options?: {
+    cursorOnly?: boolean;
+  }) => Promise<{
+    cursor: number;
+    floor?: number;
+    tables: string[];
+  } | undefined>;
   count: (tableName: string, where?: RestrictableQueryOptions | WhereInput) => Promise<number>;
   delete: (id: string, expectedTable?: string, options?: {
     hard?: boolean;
@@ -662,12 +669,18 @@ interface RunTriggersOptions {
 }
 declare const runTriggers: (options: RunTriggersOptions) => Promise<void>;
 declare const hasTrigger: (schema: SchemaLike, tableName: string, op: TriggerOpLike) => boolean;
+interface SearchBackfillProgress {
+  done: boolean;
+  pages: number;
+}
 declare const backfillAggregateIndexes: (sql: SqlExec, schema: SchemaLike) => void;
 declare const backfillRankIndexes: (sql: SqlExec, schema: SchemaLike) => void;
 declare const backfillSearchIndexesForTable: (sql: SqlExec, tableName: string, definition: {
   searchIndexes?: ReadonlyArray<SearchIndexDefinitionLike>;
 }) => void;
-declare const backfillSearchIndexes: (sql: SqlExec, schema: SchemaLike) => void;
+declare const backfillSearchIndexes: (sql: SqlExec, schema: SchemaLike, options?: {
+  maxPages?: number;
+}) => SearchBackfillProgress;
 declare const CDC_LOG_TABLE = "__cdc_log";
 interface CdcChange {
   doc?: Record<string, unknown>;
@@ -677,6 +690,7 @@ interface CdcChange {
   table: string;
   ts: number;
 }
+declare const CDC_LOG_TABLE_SEQ_INDEX = "__cdc_log_table_seq";
 declare const migrateCdcLog: (sql: SqlExec) => void;
 declare const appendCdcChange: (sql: SqlExec, ts: number, table: string, id: string, op: CdcChange["op"], doc: Record<string, unknown> | undefined) => void;
 declare const readCdcChanges: (sql: SqlExec, options?: {
@@ -687,9 +701,22 @@ declare const readCdcChanges: (sql: SqlExec, options?: {
   changes: CdcChange[];
   cursor: number;
 };
-declare const trimCdcChanges: (sql: SqlExec, throughSeq: number) => void;
+declare const cdcTouchesTables: (sql: SqlExec, sinceSeq: number, tables: ReadonlySet<string>) => boolean;
+declare const cdcCanVouchFor: (sql: SqlExec, deps: ReadonlySet<string>) => boolean;
+interface CdcChangeKey {
+  id: string;
+  op: CdcChange["op"];
+  seq: number;
+}
+declare const readCdcChangeKeys: (sql: SqlExec, table: string, sinceSeq: number, upTo: number) => CdcChangeKey[];
+declare const trimCdcChanges: (sql: SqlExec, throughSeq: number, maxRows: number) => void;
+declare const compactCdcDocs: (sql: SqlExec, throughSeq: number, maxRows: number) => void;
+declare const cdcSeqLeavingRows: (sql: SqlExec, keep: number) => number | undefined;
 declare const readCdcCursor: (sql: SqlExec) => number;
+declare const cursorBelowRetainedFloor: (floor: number | undefined, sinceSeq: number) => boolean;
+declare const cdcTrimmedError: (floor: number, sinceSeq: number, scope: "global" | "shard") => LunoraError;
 declare const minCdcSeq: (sql: SqlExec) => number | undefined;
+declare const minCdcReplayableSeq: (sql: SqlExec) => number | undefined;
 declare const CDC_META_TABLE = "__cdc_meta";
 declare const migrateCdcMeta: (sql: SqlExec) => void;
 declare const readCdcEpoch: (sql: SqlExec) => string;
@@ -759,7 +786,7 @@ interface ShapeRow {
   id: string;
 }
 declare const selectShapeRows: (sql: SqlExec, table: string, effectiveWhere: WhereInput | undefined) => ShapeRow[];
-declare const selectShapeMemberIds: (sql: SqlExec, table: string, effectiveWhere: WhereInput | undefined, ids: ReadonlyArray<string>) => Set<string>;
+declare const selectShapeMembers: (sql: SqlExec, table: string, effectiveWhere: WhereInput | undefined, ids: ReadonlyArray<string>) => Map<string, Record<string, unknown>>;
 interface SqlExec {
   exec: <Row = Record<string, unknown>>(sql: string, ...params: unknown[]) => SqlCursor<Row>;
 }
@@ -948,6 +975,7 @@ declare const SHAPE_POKE_CURSOR_TABLE = "__shape_poke_cursor";
 declare const migrateShapePokeCursor: (sql: SqlExec) => void;
 declare const readShapePokeCursor: (sql: SqlExec, connectionId: string, subId: string) => number | undefined;
 declare const writeShapePokeCursor: (sql: SqlExec, connectionId: string, subId: string, cursor: number) => void;
+declare const minShapePokeCursor: (sql: SqlExec) => number | undefined;
 declare const deleteShapePokeCursor: (sql: SqlExec, connectionId: string, subId: string) => void;
 declare const deleteShapePokeCursorsForConnection: (sql: SqlExec, connectionId: string) => void;
 declare const DATA_MIGRATION_STATE_TABLE = "__lunora_migrations";
@@ -1108,6 +1136,8 @@ declare class DurableStreamRunner {
   private produce;
   private trim;
 }
+declare const envPositiveInt: (env: unknown, key: string, fallback: number) => number;
+declare const envOptionalPositiveInt: (env: unknown, key: string) => number | undefined;
 interface ExternalSourceDiffResult {
   changes: CdcChange[];
   nextBaseline: Map<string, string>;
@@ -1187,6 +1217,19 @@ declare const coveringGeohashes: (center: GeoPoint, radiusMeters: number) => str
 declare const pointInBoundingBox: (point: GeoPoint, box: GeoBoundingBox) => boolean;
 declare const boundingBoxCenter: (box: GeoBoundingBox) => GeoPoint;
 declare const boundingBoxGeohashes: (box: GeoBoundingBox) => string[];
+declare class GlobalPollTick {
+  private readonly changedTables;
+  private readonly reads;
+  private resync;
+  private skippedCount;
+  constructor(changedTables?: Set<string>);
+  get readCount(): number;
+  get resyncRequested(): boolean;
+  get skipped(): number;
+  requestResync(): void;
+  rows(key: string | undefined, load: () => Promise<ShapeRow[]>): Promise<ShapeRow[]>;
+  shouldRead(table: string): boolean;
+}
 declare const ADMIN_FUNCTION_PREFIX = "__lunora_admin__:";
 declare const RELATION_FUNCTION_PREFIX = "__lunora_relation__:";
 declare const FLAGS_FUNCTION_PREFIX = "__lunora_flags__:";
@@ -1197,6 +1240,7 @@ declare const ADMIN_FUNCTIONS: {
   readonly aiGenerateSql: "__lunora_admin__:aiGenerateSql";
   readonly aiTableFilter: "__lunora_admin__:aiTableFilter";
   readonly assignIssue: "__lunora_admin__:assignIssue";
+  readonly backfillSearch: "__lunora_admin__:backfillSearch";
   readonly backRelationCounts: "__lunora_admin__:backRelationCounts";
   readonly cdcSync: "__lunora_admin__:cdcSync";
   readonly clearCapturedMail: "__lunora_admin__:clearCapturedMail";
@@ -1588,12 +1632,22 @@ interface FanoutPathCounters {
   socketsIterated: number;
   totalMs: number;
 }
+interface ShapeProbeCounters {
+  run: number;
+  served: number;
+}
+interface GlobalPollCounters {
+  drains: number;
+  pairsSkipped: number;
+}
 interface FanoutMetricsResult {
+  globalPoll: GlobalPollCounters;
   maxRelays: number;
   peakSubscribers: number;
   promoted: boolean;
   relayCount: number;
   shapePoke: FanoutPathCounters;
+  shapeProbe: ShapeProbeCounters;
   sinceMs: number;
   topics: FanoutTopicStat[];
   totalConnections: number;
@@ -1607,6 +1661,10 @@ interface FanoutAttachmentLike {
 }
 declare const DEFAULT_FANOUT_TOPIC_LIMIT = 20;
 declare const createFanoutCounters: () => FanoutPathCounters;
+declare const createShapeProbeCounters: () => ShapeProbeCounters;
+declare const createGlobalPollCounters: () => GlobalPollCounters;
+declare const recordGlobalPollPass: (counters: GlobalPollCounters, drains: number, pairsSkipped: number) => GlobalPollCounters;
+declare const recordShapeProbePass: (counters: ShapeProbeCounters, run: number, served: number) => ShapeProbeCounters;
 declare const recordFanoutPass: (counters: FanoutPathCounters, iterated: number, delivered: number, ms: number) => FanoutPathCounters;
 declare const summarizeFanoutTopics: (attachments: FanoutAttachmentLike[], limit?: number) => {
   peakSubscribers: number;
@@ -1771,6 +1829,8 @@ interface ReadFootprint {
   tables: Set<string>;
 }
 declare const createReadFootprint: () => ReadFootprint;
+declare const UNVOUCHABLE_DEP = "!unvouchable";
+declare const markUnvouchableReads: <T extends object>(facade: T, onRead: ReadFootprint["onRead"] | undefined, methods: ReadonlyArray<string>) => T;
 declare const DEFAULT_MAX_RELATION_KEYS = 5000;
 interface RelationExistsMarker {
   childWhere: WhereInput;
@@ -1830,6 +1890,8 @@ interface ShapeRowOp {
   value?: Record<string, unknown>;
 }
 interface ShapePokePart {
+  baseCheckpoint?: number;
+  reset?: boolean;
   rowsPatch: ShapeRowOp[];
   shapeId: string;
 }
@@ -1920,6 +1982,7 @@ interface RelayHost {
     baseCheckpoint: number | undefined;
     cursor: number;
     epoch: string | undefined;
+    reset: boolean;
     rowsPatch: ShapeRowOp[];
   };
   currentCdcEpoch: () => string | undefined;
@@ -1950,6 +2013,7 @@ declare abstract class RelayLink {
   maxRelays(): number;
   protected canAddressSiblings(): boolean;
   protected siblingStub(targetName: string): SiblingStub | undefined;
+  protected bindingName(): string | undefined;
   protected postRelayMessage(targetName: string, message: OwnerRelayFrame): Promise<void>;
   protected requestRelayMessage(targetName: string, message: OwnerRelayFrame): Promise<Response | undefined>;
   abstract forwardWhisper(topic: string, frame: string): Promise<void>;
@@ -1962,6 +2026,7 @@ declare abstract class RelayLink {
   abstract announceDrain(closing: ShardSocketLike): Promise<void>;
   abstract relayCount(): number;
   abstract isShapeRelayUniform(name: string, args: Record<string, unknown>): boolean;
+  abstract minShapeCursor(): number | undefined;
   protected abstract onAttach(index: number): void;
   protected abstract onDetach(index: number): void;
   protected abstract onWhisperFrame(message: RelayFrame): Promise<void>;
@@ -1971,8 +2036,8 @@ declare abstract class RelayLink {
 declare class OwnerRelay extends RelayLink {
   private readonly shapeUniformCache;
   private relaySetCache;
-  private readonly relayShapeRegistry;
-  private readonly relayShapeProxies;
+  private registryCache;
+  private recordedBinding;
   private promotionState;
   constructor(host: RelayHost, ownerKey: string);
   forwardWhisper(topic: string, frame: string): Promise<void>;
@@ -1984,6 +2049,7 @@ declare class OwnerRelay extends RelayLink {
   announce(): Promise<void>;
   announceDrain(): Promise<void>;
   relayCount(): number;
+  minShapeCursor(): number | undefined;
   isShapeRelayUniform(name: string, args: Record<string, unknown>): boolean;
   protected onAttach(index: number): void;
   protected onDetach(index: number): void;
@@ -1992,9 +2058,14 @@ declare class OwnerRelay extends RelayLink {
   protected onShapePoke(): number;
   private buildShapePoke;
   private multicastShapePokes;
+  private multicastToRelays;
   private proxyShapePokes;
+  private proxyToRelay;
   private buildShapeSeedFrames;
-  private ensureRelayTable;
+  private ensureRelayTables;
+  protected bindingName(): string | undefined;
+  private relayShapes;
+  private rewindShapeCursor;
   private ownerRelaySet;
   private addRelayToSet;
   private removeRelayFromSet;
@@ -2015,6 +2086,7 @@ declare class RelayMember extends RelayLink {
   announceDrain(closing: ShardSocketLike): Promise<void>;
   relayCount(): number;
   isShapeRelayUniform(): boolean;
+  minShapeCursor(): number | undefined;
   protected onAttach(): void;
   protected onDetach(): void;
   protected onWhisperFrame(): Promise<void>;
@@ -2108,6 +2180,24 @@ declare const readSchemaHistory: (sql: SqlExec) => SchemaVersionRow[];
 declare const readSchemaVersion: (sql: SqlExec, hash: string) => SchemaVersionRow | undefined;
 declare const isDevEnvironment: (rawEnv: unknown) => boolean;
 declare const buildSettings: (rawEnv: unknown) => SettingsResult;
+declare class ShapeDiffCache {
+  private readonly keyScans;
+  private readonly memberProbes;
+  private run;
+  private served;
+  get probesRun(): number;
+  get probesServed(): number;
+  changedKeys(rangeKey: string, load: () => CdcChangeKey[]): ReadonlyArray<CdcChangeKey>;
+  members(resolved: ResolvedShape, rangeKey: string, load: () => Map<string, Record<string, unknown>>): ReadonlyMap<string, Record<string, unknown>>;
+  private getOrLoad;
+}
+declare const createShapeDiffCache: () => ShapeDiffCache;
+declare const globalShapeReadKey: (resolved: ResolvedShape, identity: {
+  identity?: Record<string, unknown>;
+  userId?: string;
+}) => string | undefined;
+type ReadShapeCdcKeys = (sql: SqlExec, table: string, sinceSeq: number, upTo: number) => CdcChangeKey[];
+declare const buildShapeDiff: (sql: SqlExec, resolved: ResolvedShape, sinceSeq: number, upTo: number, cache: ShapeDiffCache, readKeys?: ReadShapeCdcKeys) => ShapeRowOp[];
 interface ShardRunnerOptions {
   handlers?: {
     handleAlarm?: () => Promise<void>;
@@ -2206,4 +2296,4 @@ interface WhereSqlStrategy {
 }
 declare const literalInList: (reference: SQL, items: ReadonlyArray<unknown>, negated: boolean) => SQL;
 declare const compileWhereSql: (where: WhereInput | undefined, strategy: WhereSqlStrategy) => SQL | undefined;
-export { ADMIN_FUNCTIONS, ADMIN_FUNCTION_PREFIX, AGGREGATE_SQL_FUNCTION, AGG_COUNT, AGG_KEY, AGG_VALUE, AUDIT_LOG_TABLE, type AdvisorProcedure, type AdvisorProceduresResult, type AdvisoriesResult, type AdvisoryFinding, type AggregateIndexDefinitionLike, type AggregateOp, type AggregateOptions, type AggregateResult, type AggregateTally, type AppendAuditEntry, type ApplyOnDeleteOptions$1 as ApplyOnDeleteOptions, type AuditEntry, type AuditLogResult, type BroadcastDelta, CDC_LOG_TABLE, CDC_META_TABLE, CLIENT_WATERMARK_TABLE, COMMIT_SEQ_FIELD, COMMIT_SEQ_TABLE, type CacheEntry, type CapturedMailRow, type CdcChange, type ChangedKeys, type Clock, type ColumnMeta, type ColumnMetaLike, type CompanionSync, type CompanionSyncDeps, ConflictError, type ConflictKind, type CountArgs, CountRlsUnsupportedError, type CreateWorkflowInstanceResult, type CrossShardReadArgs, type CtxDbOptions, DATA_MIGRATION_STATE_TABLE, DEFAULT_FANOUT_TOPIC_LIMIT, DEFAULT_MAX_RELATION_KEYS, DEFAULT_MAX_RELAYS, DEFAULT_PROMOTION_THRESHOLDS, DEFAULT_TRANSACTION_LIMITS, DOC_COLUMN, type DataMigrationDocument, type DataMigrationLike, type DataMigrationTransform, type DatabaseWriterLike, type DependencyTracker, type DeployInfo, type DurableAttachDecision, type DurableStreamAttach, type DurableStreamRun, DurableStreamRunner, type DurableStreamSink, type ExportRow, type ExportShardAdminArgs, type ExportShardArgs, type ExternalSourceDiffResult, type ExternalSourceLike, FLAGS_FUNCTION_PREFIX, type FacetColumnOptions, type FacetColumnResult, type FacetValue, type FanoutMetricsResult, type FanoutPathCounters, type FanoutTopicStat, type FieldOperators, type FilterClause, type FilterOperator, type FlagEvaluation, type FlagsResult, type FunctionCallStat, type FunctionScanAttribution, type FunctionStatsResult, GEO_DEFAULT_PRECISION, GLOBAL_SHAPE_SNAPSHOT_TABLE, type GeoBoundingBox, type GeoFilterBuilderLike, type GeoIndexDefinitionLike, type GeoPoint, type GeoScoredDocument, type GroupByEntry, type GroupByOptions, type GuardableSchema$1 as GuardableSchema, IDEMPOTENCY_TABLE, type IdGenerator, type IdempotentRecord, type ImportError, type ImportShardAdminArgs, type ImportShardArgs, type ImportShardResult, type IncrementalMaterializeResult, type IndexDefinitionLike, type IndexKeyEntry, type IndexRangeBuilderLike, type KeyRange, type LifecycleDispatchInfo, type LifecycleEvent, MAIL_RETENTION, MAIL_TABLE, MAX_DURABLE_STREAM_BYTES, MAX_DURABLE_STREAM_CHUNKS, MAX_PAGE_SIZE, MAX_SQL_ROWS, type MaskColumnMetadata, type MaskPoliciesResult, type MaterializeResult, type MigrationDirection, type MigrationRunResult, type MigrationStatus, type MigrationStatusRow, type MutationDelta, type NestedWith, NotFoundError, NotUniqueError, type OnDeleteActionLike, type OrderByClause, type OrderByInput, type OrderKey, OwnerRelay, type OwnerRelayFrame, type PaginationOptions, type PitrBookmarkResult, type PitrRestoreArgs, type PitrRestoreResult, type PitrStorage, type PokeFrameMeta, type PromotionState, type PromotionThresholds, QUEUE_TABLE, type QueryArgs, type QueryPage, type QueueMessageOutcome, type QueueMessageRow, type QueueMetadata, type QueuesResult, RANK_TIEBREAK, REACTOR_STATE_TABLE, RELATION_EXISTS_KEY, RELATION_FUNCTION_PREFIX, REPROJECTION_MIGRATION_PREFIX, RLS_UNWRAP_SYMBOL, type RankBeforeOptions, type RankBeforeResult, type RankDirection, type RankIndexDefinitionLike, type RankOptions, type RankPage, type RankPageComputation, type RankPageDeps, type RankPageOptions, type RankPageRow, type RankPageRowKey, type RankResult, type RankSortKeyLike, ReactiveCache, type ReactiveCacheOptions, type ReactorDispatchResult, type ReactorMetadata, type ReactorState, type ReactorStats, type ReactorsResult, type ReadFootprint, type ReadHook, type ReadTablePageOptions, type RecordMailInput, type RecordQueueMessageInput, type RelationDefinitionLike, type RelationExistsMarker, type RelayAttach, type RelayDetach, type RelayFrame, type RelayHost, RelayMember, type RelayShapePoke, type RelayShapeSeed, type RelayShapeSubscribe, type RenderedSql, type ReplicaFollowerHost, type ReplicaOwnerHost, type ReplicaReadiness, type ResolveRelationPredicatesOptions, type ResolveWithOptions, type ResolveWithResult, type ResolvedShape, type RestrictableQueryOptions, type RlsPoliciesResult, type RlsPolicyMetadata, RlsRequiredError, type RlsRoleMetadata, type RpcRequest, type RunDataMigrationOptions, type RunTriggersOptions, SCAN_DEP, SCHEMA_HISTORY_MAX_VERSIONS, SEARCH_STATE_TABLE, SHAPE_POKE_CURSOR_TABLE, type SchedulableWorkflowReferenceLike, type ScheduledFunctionDoc, type SchedulerLike, type SchemaLike, type ScoredDocument, type SearchFilterBuilderLike, type SearchIndexDefinitionLike, type SearchScoredDocument, type SelectMatchingIdsOptions, type ServerDefaultContextLike, type SettingEntry, type SettingKind, type SettingsResult, type ShapePokePart, type ShapeRow, type ShapeRowOp, type ShapeSubscriptionQuery, type ShardRankPageResult, ShardRunner, type ShardRunnerOptions, type ShardSiblingHost, type ShardSocketLike, type SocketAttachment, type SortDirection, type SourceClientLike, type SourceCursorLike, type SourceRefresh, type SqlConsoleResult, type SqlCursor, type SqlEngine, type SqlExec, type SqlLintResult, type StorageMetadata, type StorageReference, type StorageReferenceResult, type StorageRuleMetadata, type StorageRulesResult, type StudioFeaturesResult, type SubscriptionConnection, type SubscriptionEnvelope, type SubscriptionIdentity, type SubscriptionInfo, type SubscriptionQuery, type SubscriptionReadFootprint, type SubscriptionsResult, type SystemDatabaseReader, type SystemDoc, type SystemQuery, type SystemReaderOptions, type SystemReaderSchedulerLike, type SystemReaderStorageLike, type SystemTableName, type TableColumnsResult, type TableDefinitionLike, type TableIndexInfo, type TableIndexesResult, type TableInfo, type TablePage, type TableReaderLike, type TablesColumnsResult, type TablesIndexesResult, type TransactionHeadroom, TransactionHeadroomTracker, type TransactionLimits, type TransactionSqlLike, type TriggerContextLike, type TriggerDefinitionLike, type TriggerEventLike, type TriggerOpLike, type TriggerTimingLike, type TtlSweepSpec, type ValidatorLike, type WhereInput, type WhereSqlStrategy, type WithInput, type WorkflowInstanceState, type WorkflowInstanceStatusResult, type WorkflowMetadata, type WorkflowsResult, type WriteEvent, type WriteHook, advanceClientWatermark, aggUpsertSql, aggregateSqlFunction, aggregateTableName, allocateCommitSeq, appendAuditEntry, appendCdcChange, appendStreamChunk, applyCdcChanges, applyOnDelete, applySelect, armRestore, assertFlatPredicate, assertReadonly, assertShapeShardable, assertValidClientId, awaitWsDrain, backfillAggregateIndexes, backfillRankIndexes, backfillSearchIndexes, backfillSearchIndexesForTable, boundingBoxCenter, boundingBoxGeohashes, buildIndexRange, buildPokeFrames, buildReprojectionMigration, buildSeekBeforeWhere, buildSeekWhere, buildSettings, bumpCdcEpoch, claimStreamRun, clampPromotionThresholds, clearCapturedMail, clearMemoryTables, clearQueueMessages, coerceAggregateNumber, compileWhereSql, computeRankPage, containsRelationPredicate, countLegacyRows, coveringGeohashes, createCompanionSync, createDependencyTracker, createFanoutCounters, createIndexSql, createReadFootprint, createRelayLink, createReplicaLink, createShardCtxDb, createSystemReader, decideDurableAttach, decodeCursor, deleteGlobalShapeSnapshot, deleteGlobalShapeSnapshotsForConnection, deleteShapePokeCursor, deleteShapePokeCursorsForConnection, deleteStreamRun, depKey, diffExternalSource, diffGlobalMembership, distinctValues, encodeAggregateKey, encodeCursor, encodeGeohash, encodePartitionKey, encodeRowsPatch, ensureAuditTable, ensureMailTable, exportShardRows, exportShardTable, facetColumn, fanOutScalarCounts, findStorageReferences, finishStreamRun, foldAggregateTally, gateReplicaDispatch, geoTableName, guardWriter, handleReplicaControl, hasTrigger, haversineMeters, hydrateDocsById, importShardRows, indexKeysForRow, isDevEnvironment, isFtsAvailable, isLossyBody, isMemoryTable, isRelationPredicate, isSoftDeleted, isSourceDue, jsonPath, jsonPathSql, keysTouchRanges, liftSourceId, lintReadonlySql, listReactorStates, listTables, literalInList, matchesRankStaticWhere, matchesStaticWhere, materializeExternalRows, materializeExternalRowsIncremental, memoryTableNames, mergeChangedKeys, mergeWhere, migrateCdcLog, migrateCdcMeta, migrateClientWatermark, migrateCommitSeq, migrateDurableStreams, migrateGlobalShapeSnapshot, migrateIdempotency, migrateReactorState, migrateSearchState, migrateShapePokeCursor, minCdcSeq, nextPromotionState, normalizeCountArgument, normalizeIdStructurally, normalizeOrderKeys, normalizeSourceDocument, normalizeSourceValue, param, parseExportShardArgs, parseImportShardArgs, planAggregateLookup, pointInBoundingBox, projectColumns, pullExternalSourceIncrementalTick, pullExternalSourceTick, qualifiedJsonPath, qualifiedJsonPathSql, quoteIdentifier, rankKeyFromDocument as rankKeyFromDoc, rankTableName, reactiveCacheKey, reactorNeedsRun, readAggregateValue, readAuditLog, readBookmark, readCapturedMail, readCdcChanges, readCdcCursor, readCdcEpoch, readClientWatermark, readCommitSeq, readExternalSourceBaseline, readGlobalShapeSnapshot, readIdempotent, readMigrationStatus, readQueueMessageById, readQueueMessages, readReactorState, readSchemaHistory, readSchemaVersion, readSearchBackfillState, readShapePokeCursor, readStreamChunks, readStreamRun, readTablePage, recordCapturedMail, recordChangedKeys, recordFanoutPass, recordQueueMessages, recordSchemaVersion, relationHooks, relayCountFor, renderSql, reprojectableFields, reprojectionMigrationId, reprojectionTables, resolveRankPartition, resolveRelationPredicates, resolveWith, rowToDocument, runDataMigration, runDrizzle, runExternalSourceTick, runReadonlySql, runRowValidators, runShardMigrations, runSocketPool, runSql, runTriggers, selectExpiredIds, selectExportTables, selectIndexForAggregate, selectIndexForCount, selectIndexForGroupBy, selectMatchingIds, selectShapeMemberIds, selectShapeRows, serializeSqlValue, shapeRoutingKey, softDeleteScope, sortColumnName, sqliteInList, stableStringify, stableWireKey, subscriptionFrames, subscriptionListDeltas, summarizeFanoutTopics, summarizeSubscriptions, tableColumns, tableFromDepKey, throwingScheduler, trimCdcChanges, trimIdempotent, trimStreamRuns, tryRowToDocument, trySendFrame, unionAll, validateImportRow, writeGlobalShapeSnapshot, writeIdempotent, writeReactorState, writeSearchBackfillState, writeShapePokeCursor, writeTouchesMemo };
+export { ADMIN_FUNCTIONS, ADMIN_FUNCTION_PREFIX, AGGREGATE_SQL_FUNCTION, AGG_COUNT, AGG_KEY, AGG_VALUE, AUDIT_LOG_TABLE, type AdvisorProcedure, type AdvisorProceduresResult, type AdvisoriesResult, type AdvisoryFinding, type AggregateIndexDefinitionLike, type AggregateOp, type AggregateOptions, type AggregateResult, type AggregateTally, type AppendAuditEntry, type ApplyOnDeleteOptions$1 as ApplyOnDeleteOptions, type AuditEntry, type AuditLogResult, type BroadcastDelta, CDC_LOG_TABLE, CDC_LOG_TABLE_SEQ_INDEX, CDC_META_TABLE, CLIENT_WATERMARK_TABLE, COMMIT_SEQ_FIELD, COMMIT_SEQ_TABLE, type CacheEntry, type CapturedMailRow, type CdcChange, type CdcChangeKey, type ChangedKeys, type Clock, type ColumnMeta, type ColumnMetaLike, type CompanionSync, type CompanionSyncDeps, ConflictError, type ConflictKind, type CountArgs, CountRlsUnsupportedError, type CreateWorkflowInstanceResult, type CrossShardReadArgs, type CtxDbOptions, DATA_MIGRATION_STATE_TABLE, DEFAULT_FANOUT_TOPIC_LIMIT, DEFAULT_MAX_RELATION_KEYS, DEFAULT_MAX_RELAYS, DEFAULT_PROMOTION_THRESHOLDS, DEFAULT_TRANSACTION_LIMITS, DOC_COLUMN, type DataMigrationDocument, type DataMigrationLike, type DataMigrationTransform, type DatabaseWriterLike, type DependencyTracker, type DeployInfo, type DurableAttachDecision, type DurableStreamAttach, type DurableStreamRun, DurableStreamRunner, type DurableStreamSink, type ExportRow, type ExportShardAdminArgs, type ExportShardArgs, type ExternalSourceDiffResult, type ExternalSourceLike, FLAGS_FUNCTION_PREFIX, type FacetColumnOptions, type FacetColumnResult, type FacetValue, type FanoutMetricsResult, type FanoutPathCounters, type FanoutTopicStat, type FieldOperators, type FilterClause, type FilterOperator, type FlagEvaluation, type FlagsResult, type FunctionCallStat, type FunctionScanAttribution, type FunctionStatsResult, GEO_DEFAULT_PRECISION, GLOBAL_SHAPE_SNAPSHOT_TABLE, type GeoBoundingBox, type GeoFilterBuilderLike, type GeoIndexDefinitionLike, type GeoPoint, type GeoScoredDocument, type GlobalPollCounters, GlobalPollTick, type GroupByEntry, type GroupByOptions, type GuardableSchema$1 as GuardableSchema, IDEMPOTENCY_TABLE, type IdGenerator, type IdempotentRecord, type ImportError, type ImportShardAdminArgs, type ImportShardArgs, type ImportShardResult, type IncrementalMaterializeResult, type IndexDefinitionLike, type IndexKeyEntry, type IndexRangeBuilderLike, type KeyRange, type LifecycleDispatchInfo, type LifecycleEvent, MAIL_RETENTION, MAIL_TABLE, MAX_DURABLE_STREAM_BYTES, MAX_DURABLE_STREAM_CHUNKS, MAX_PAGE_SIZE, MAX_SQL_ROWS, type MaskColumnMetadata, type MaskPoliciesResult, type MaterializeResult, type MigrationDirection, type MigrationRunResult, type MigrationStatus, type MigrationStatusRow, type MutationDelta, type NestedWith, NotFoundError, NotUniqueError, type OnDeleteActionLike, type OrderByClause, type OrderByInput, type OrderKey, OwnerRelay, type OwnerRelayFrame, type PaginationOptions, type PitrBookmarkResult, type PitrRestoreArgs, type PitrRestoreResult, type PitrStorage, type PokeFrameMeta, type PromotionState, type PromotionThresholds, QUEUE_TABLE, type QueryArgs, type QueryPage, type QueueMessageOutcome, type QueueMessageRow, type QueueMetadata, type QueuesResult, RANK_TIEBREAK, REACTOR_STATE_TABLE, RELATION_EXISTS_KEY, RELATION_FUNCTION_PREFIX, REPROJECTION_MIGRATION_PREFIX, RLS_UNWRAP_SYMBOL, type RankBeforeOptions, type RankBeforeResult, type RankDirection, type RankIndexDefinitionLike, type RankOptions, type RankPage, type RankPageComputation, type RankPageDeps, type RankPageOptions, type RankPageRow, type RankPageRowKey, type RankResult, type RankSortKeyLike, ReactiveCache, type ReactiveCacheOptions, type ReactorDispatchResult, type ReactorMetadata, type ReactorState, type ReactorStats, type ReactorsResult, type ReadFootprint, type ReadHook, type ReadTablePageOptions, type RecordMailInput, type RecordQueueMessageInput, type RelationDefinitionLike, type RelationExistsMarker, type RelayAttach, type RelayDetach, type RelayFrame, type RelayHost, RelayMember, type RelayShapePoke, type RelayShapeSeed, type RelayShapeSubscribe, type RenderedSql, type ReplicaFollowerHost, type ReplicaOwnerHost, type ReplicaReadiness, type ResolveRelationPredicatesOptions, type ResolveWithOptions, type ResolveWithResult, type ResolvedShape, type RestrictableQueryOptions, type RlsPoliciesResult, type RlsPolicyMetadata, RlsRequiredError, type RlsRoleMetadata, type RpcRequest, type RunDataMigrationOptions, type RunTriggersOptions, SCAN_DEP, SCHEMA_HISTORY_MAX_VERSIONS, SEARCH_STATE_TABLE, SHAPE_POKE_CURSOR_TABLE, type SchedulableWorkflowReferenceLike, type ScheduledFunctionDoc, type SchedulerLike, type SchemaLike, type ScoredDocument, type SearchBackfillProgress, type SearchFilterBuilderLike, type SearchIndexDefinitionLike, type SearchScoredDocument, type SelectMatchingIdsOptions, type ServerDefaultContextLike, type SettingEntry, type SettingKind, type SettingsResult, ShapeDiffCache, type ShapePokePart, type ShapeProbeCounters, type ShapeRow, type ShapeRowOp, type ShapeSubscriptionQuery, type ShardRankPageResult, ShardRunner, type ShardRunnerOptions, type ShardSiblingHost, type ShardSocketLike, type SocketAttachment, type SortDirection, type SourceClientLike, type SourceCursorLike, type SourceRefresh, type SqlConsoleResult, type SqlCursor, type SqlEngine, type SqlExec, type SqlLintResult, type StorageMetadata, type StorageReference, type StorageReferenceResult, type StorageRuleMetadata, type StorageRulesResult, type StudioFeaturesResult, type SubscriptionConnection, type SubscriptionEnvelope, type SubscriptionIdentity, type SubscriptionInfo, type SubscriptionQuery, type SubscriptionReadFootprint, type SubscriptionsResult, type SystemDatabaseReader, type SystemDoc, type SystemQuery, type SystemReaderOptions, type SystemReaderSchedulerLike, type SystemReaderStorageLike, type SystemTableName, type TableColumnsResult, type TableDefinitionLike, type TableIndexInfo, type TableIndexesResult, type TableInfo, type TablePage, type TableReaderLike, type TablesColumnsResult, type TablesIndexesResult, type TransactionHeadroom, TransactionHeadroomTracker, type TransactionLimits, type TransactionSqlLike, type TriggerContextLike, type TriggerDefinitionLike, type TriggerEventLike, type TriggerOpLike, type TriggerTimingLike, type TtlSweepSpec, UNVOUCHABLE_DEP, type ValidatorLike, type WhereInput, type WhereSqlStrategy, type WithInput, type WorkflowInstanceState, type WorkflowInstanceStatusResult, type WorkflowMetadata, type WorkflowsResult, type WriteEvent, type WriteHook, advanceClientWatermark, aggUpsertSql, aggregateSqlFunction, aggregateTableName, allocateCommitSeq, appendAuditEntry, appendCdcChange, appendStreamChunk, applyCdcChanges, applyOnDelete, applySelect, armRestore, assertFlatPredicate, assertReadonly, assertShapeShardable, assertValidClientId, awaitWsDrain, backfillAggregateIndexes, backfillRankIndexes, backfillSearchIndexes, backfillSearchIndexesForTable, boundingBoxCenter, boundingBoxGeohashes, buildIndexRange, buildPokeFrames, buildReprojectionMigration, buildSeekBeforeWhere, buildSeekWhere, buildSettings, buildShapeDiff, bumpCdcEpoch, cdcCanVouchFor, cdcSeqLeavingRows, cdcTouchesTables, cdcTrimmedError, claimStreamRun, clampPromotionThresholds, clearCapturedMail, clearMemoryTables, clearQueueMessages, coerceAggregateNumber, compactCdcDocs, compileWhereSql, computeRankPage, containsRelationPredicate, countLegacyRows, coveringGeohashes, createCompanionSync, createDependencyTracker, createFanoutCounters, createGlobalPollCounters, createIndexSql, createReadFootprint, createRelayLink, createReplicaLink, createShapeDiffCache, createShapeProbeCounters, createShardCtxDb, createSystemReader, cursorBelowRetainedFloor, decideDurableAttach, decodeCursor, deleteGlobalShapeSnapshot, deleteGlobalShapeSnapshotsForConnection, deleteShapePokeCursor, deleteShapePokeCursorsForConnection, deleteStreamRun, depKey, diffExternalSource, diffGlobalMembership, distinctValues, encodeAggregateKey, encodeCursor, encodeGeohash, encodePartitionKey, encodeRowsPatch, ensureAuditTable, ensureMailTable, envOptionalPositiveInt, envPositiveInt, exportShardRows, exportShardTable, facetColumn, fanOutScalarCounts, findStorageReferences, finishStreamRun, foldAggregateTally, gateReplicaDispatch, geoTableName, globalShapeReadKey, guardWriter, handleReplicaControl, hasTrigger, haversineMeters, hydrateDocsById, importShardRows, indexKeysForRow, isDevEnvironment, isFtsAvailable, isLossyBody, isMemoryTable, isRelationPredicate, isSoftDeleted, isSourceDue, jsonPath, jsonPathSql, keysTouchRanges, liftSourceId, lintReadonlySql, listReactorStates, listTables, literalInList, markUnvouchableReads, matchesRankStaticWhere, matchesStaticWhere, materializeExternalRows, materializeExternalRowsIncremental, memoryTableNames, mergeChangedKeys, mergeWhere, migrateCdcLog, migrateCdcMeta, migrateClientWatermark, migrateCommitSeq, migrateDurableStreams, migrateGlobalShapeSnapshot, migrateIdempotency, migrateReactorState, migrateSearchState, migrateShapePokeCursor, minCdcReplayableSeq, minCdcSeq, minShapePokeCursor, nextPromotionState, normalizeCountArgument, normalizeIdStructurally, normalizeOrderKeys, normalizeSourceDocument, normalizeSourceValue, param, parseExportShardArgs, parseImportShardArgs, planAggregateLookup, pointInBoundingBox, projectColumns, pullExternalSourceIncrementalTick, pullExternalSourceTick, qualifiedJsonPath, qualifiedJsonPathSql, quoteIdentifier, rankKeyFromDocument as rankKeyFromDoc, rankTableName, reactiveCacheKey, reactorNeedsRun, readAggregateValue, readAuditLog, readBookmark, readCapturedMail, readCdcChangeKeys, readCdcChanges, readCdcCursor, readCdcEpoch, readClientWatermark, readCommitSeq, readExternalSourceBaseline, readGlobalShapeSnapshot, readIdempotent, readMigrationStatus, readQueueMessageById, readQueueMessages, readReactorState, readSchemaHistory, readSchemaVersion, readSearchBackfillState, readShapePokeCursor, readStreamChunks, readStreamRun, readTablePage, recordCapturedMail, recordChangedKeys, recordFanoutPass, recordGlobalPollPass, recordQueueMessages, recordSchemaVersion, recordShapeProbePass, relationHooks, relayCountFor, renderSql, reprojectableFields, reprojectionMigrationId, reprojectionTables, resolveRankPartition, resolveRelationPredicates, resolveWith, rowToDocument, runDataMigration, runDrizzle, runExternalSourceTick, runReadonlySql, runRowValidators, runShardMigrations, runSocketPool, runSql, runTriggers, selectExpiredIds, selectExportTables, selectIndexForAggregate, selectIndexForCount, selectIndexForGroupBy, selectMatchingIds, selectShapeMembers, selectShapeRows, serializeSqlValue, shapeRoutingKey, softDeleteScope, sortColumnName, sqliteInList, stableStringify, stableWireKey, subscriptionFrames, subscriptionListDeltas, summarizeFanoutTopics, summarizeSubscriptions, tableColumns, tableFromDepKey, throwingScheduler, trimCdcChanges, trimIdempotent, trimStreamRuns, tryRowToDocument, trySendFrame, unionAll, validateImportRow, writeGlobalShapeSnapshot, writeIdempotent, writeReactorState, writeSearchBackfillState, writeShapePokeCursor, writeTouchesMemo };

package/dist/index.d.ts

@@ -425,6 +425,13 @@ interface MutationDelta {
 interface DatabaseWriterLike {
   aggregate: (tableName: string, options: AggregateOptions) => Promise<AggregateResult>;
   asId?: (tableName: string, id: string) => string;
+  cdcChangedTables?: (sinceSeq: number, options?: {
+    cursorOnly?: boolean;
+  }) => Promise<{
+    cursor: number;
+    floor?: number;
+    tables: string[];
+  } | undefined>;
   count: (tableName: string, where?: RestrictableQueryOptions | WhereInput) => Promise<number>;
   delete: (id: string, expectedTable?: string, options?: {
     hard?: boolean;
@@ -662,12 +669,18 @@ interface RunTriggersOptions {
 }
 declare const runTriggers: (options: RunTriggersOptions) => Promise<void>;
 declare const hasTrigger: (schema: SchemaLike, tableName: string, op: TriggerOpLike) => boolean;
+interface SearchBackfillProgress {
+  done: boolean;
+  pages: number;
+}
 declare const backfillAggregateIndexes: (sql: SqlExec, schema: SchemaLike) => void;
 declare const backfillRankIndexes: (sql: SqlExec, schema: SchemaLike) => void;
 declare const backfillSearchIndexesForTable: (sql: SqlExec, tableName: string, definition: {
   searchIndexes?: ReadonlyArray<SearchIndexDefinitionLike>;
 }) => void;
-declare const backfillSearchIndexes: (sql: SqlExec, schema: SchemaLike) => void;
+declare const backfillSearchIndexes: (sql: SqlExec, schema: SchemaLike, options?: {
+  maxPages?: number;
+}) => SearchBackfillProgress;
 declare const CDC_LOG_TABLE = "__cdc_log";
 interface CdcChange {
   doc?: Record<string, unknown>;
@@ -677,6 +690,7 @@ interface CdcChange {
   table: string;
   ts: number;
 }
+declare const CDC_LOG_TABLE_SEQ_INDEX = "__cdc_log_table_seq";
 declare const migrateCdcLog: (sql: SqlExec) => void;
 declare const appendCdcChange: (sql: SqlExec, ts: number, table: string, id: string, op: CdcChange["op"], doc: Record<string, unknown> | undefined) => void;
 declare const readCdcChanges: (sql: SqlExec, options?: {
@@ -687,9 +701,22 @@ declare const readCdcChanges: (sql: SqlExec, options?: {
   changes: CdcChange[];
   cursor: number;
 };
-declare const trimCdcChanges: (sql: SqlExec, throughSeq: number) => void;
+declare const cdcTouchesTables: (sql: SqlExec, sinceSeq: number, tables: ReadonlySet<string>) => boolean;
+declare const cdcCanVouchFor: (sql: SqlExec, deps: ReadonlySet<string>) => boolean;
+interface CdcChangeKey {
+  id: string;
+  op: CdcChange["op"];
+  seq: number;
+}
+declare const readCdcChangeKeys: (sql: SqlExec, table: string, sinceSeq: number, upTo: number) => CdcChangeKey[];
+declare const trimCdcChanges: (sql: SqlExec, throughSeq: number, maxRows: number) => void;
+declare const compactCdcDocs: (sql: SqlExec, throughSeq: number, maxRows: number) => void;
+declare const cdcSeqLeavingRows: (sql: SqlExec, keep: number) => number | undefined;
 declare const readCdcCursor: (sql: SqlExec) => number;
+declare const cursorBelowRetainedFloor: (floor: number | undefined, sinceSeq: number) => boolean;
+declare const cdcTrimmedError: (floor: number, sinceSeq: number, scope: "global" | "shard") => LunoraError;
 declare const minCdcSeq: (sql: SqlExec) => number | undefined;
+declare const minCdcReplayableSeq: (sql: SqlExec) => number | undefined;
 declare const CDC_META_TABLE = "__cdc_meta";
 declare const migrateCdcMeta: (sql: SqlExec) => void;
 declare const readCdcEpoch: (sql: SqlExec) => string;
@@ -759,7 +786,7 @@ interface ShapeRow {
   id: string;
 }
 declare const selectShapeRows: (sql: SqlExec, table: string, effectiveWhere: WhereInput | undefined) => ShapeRow[];
-declare const selectShapeMemberIds: (sql: SqlExec, table: string, effectiveWhere: WhereInput | undefined, ids: ReadonlyArray<string>) => Set<string>;
+declare const selectShapeMembers: (sql: SqlExec, table: string, effectiveWhere: WhereInput | undefined, ids: ReadonlyArray<string>) => Map<string, Record<string, unknown>>;
 interface SqlExec {
   exec: <Row = Record<string, unknown>>(sql: string, ...params: unknown[]) => SqlCursor<Row>;
 }
@@ -948,6 +975,7 @@ declare const SHAPE_POKE_CURSOR_TABLE = "__shape_poke_cursor";
 declare const migrateShapePokeCursor: (sql: SqlExec) => void;
 declare const readShapePokeCursor: (sql: SqlExec, connectionId: string, subId: string) => number | undefined;
 declare const writeShapePokeCursor: (sql: SqlExec, connectionId: string, subId: string, cursor: number) => void;
+declare const minShapePokeCursor: (sql: SqlExec) => number | undefined;
 declare const deleteShapePokeCursor: (sql: SqlExec, connectionId: string, subId: string) => void;
 declare const deleteShapePokeCursorsForConnection: (sql: SqlExec, connectionId: string) => void;
 declare const DATA_MIGRATION_STATE_TABLE = "__lunora_migrations";
@@ -1108,6 +1136,8 @@ declare class DurableStreamRunner {
   private produce;
   private trim;
 }
+declare const envPositiveInt: (env: unknown, key: string, fallback: number) => number;
+declare const envOptionalPositiveInt: (env: unknown, key: string) => number | undefined;
 interface ExternalSourceDiffResult {
   changes: CdcChange[];
   nextBaseline: Map<string, string>;
@@ -1187,6 +1217,19 @@ declare const coveringGeohashes: (center: GeoPoint, radiusMeters: number) => str
 declare const pointInBoundingBox: (point: GeoPoint, box: GeoBoundingBox) => boolean;
 declare const boundingBoxCenter: (box: GeoBoundingBox) => GeoPoint;
 declare const boundingBoxGeohashes: (box: GeoBoundingBox) => string[];
+declare class GlobalPollTick {
+  private readonly changedTables;
+  private readonly reads;
+  private resync;
+  private skippedCount;
+  constructor(changedTables?: Set<string>);
+  get readCount(): number;
+  get resyncRequested(): boolean;
+  get skipped(): number;
+  requestResync(): void;
+  rows(key: string | undefined, load: () => Promise<ShapeRow[]>): Promise<ShapeRow[]>;
+  shouldRead(table: string): boolean;
+}
 declare const ADMIN_FUNCTION_PREFIX = "__lunora_admin__:";
 declare const RELATION_FUNCTION_PREFIX = "__lunora_relation__:";
 declare const FLAGS_FUNCTION_PREFIX = "__lunora_flags__:";
@@ -1197,6 +1240,7 @@ declare const ADMIN_FUNCTIONS: {
   readonly aiGenerateSql: "__lunora_admin__:aiGenerateSql";
   readonly aiTableFilter: "__lunora_admin__:aiTableFilter";
   readonly assignIssue: "__lunora_admin__:assignIssue";
+  readonly backfillSearch: "__lunora_admin__:backfillSearch";
   readonly backRelationCounts: "__lunora_admin__:backRelationCounts";
   readonly cdcSync: "__lunora_admin__:cdcSync";
   readonly clearCapturedMail: "__lunora_admin__:clearCapturedMail";
@@ -1588,12 +1632,22 @@ interface FanoutPathCounters {
   socketsIterated: number;
   totalMs: number;
 }
+interface ShapeProbeCounters {
+  run: number;
+  served: number;
+}
+interface GlobalPollCounters {
+  drains: number;
+  pairsSkipped: number;
+}
 interface FanoutMetricsResult {
+  globalPoll: GlobalPollCounters;
   maxRelays: number;
   peakSubscribers: number;
   promoted: boolean;
   relayCount: number;
   shapePoke: FanoutPathCounters;
+  shapeProbe: ShapeProbeCounters;
   sinceMs: number;
   topics: FanoutTopicStat[];
   totalConnections: number;
@@ -1607,6 +1661,10 @@ interface FanoutAttachmentLike {
 }
 declare const DEFAULT_FANOUT_TOPIC_LIMIT = 20;
 declare const createFanoutCounters: () => FanoutPathCounters;
+declare const createShapeProbeCounters: () => ShapeProbeCounters;
+declare const createGlobalPollCounters: () => GlobalPollCounters;
+declare const recordGlobalPollPass: (counters: GlobalPollCounters, drains: number, pairsSkipped: number) => GlobalPollCounters;
+declare const recordShapeProbePass: (counters: ShapeProbeCounters, run: number, served: number) => ShapeProbeCounters;
 declare const recordFanoutPass: (counters: FanoutPathCounters, iterated: number, delivered: number, ms: number) => FanoutPathCounters;
 declare const summarizeFanoutTopics: (attachments: FanoutAttachmentLike[], limit?: number) => {
   peakSubscribers: number;
@@ -1771,6 +1829,8 @@ interface ReadFootprint {
   tables: Set<string>;
 }
 declare const createReadFootprint: () => ReadFootprint;
+declare const UNVOUCHABLE_DEP = "!unvouchable";
+declare const markUnvouchableReads: <T extends object>(facade: T, onRead: ReadFootprint["onRead"] | undefined, methods: ReadonlyArray<string>) => T;
 declare const DEFAULT_MAX_RELATION_KEYS = 5000;
 interface RelationExistsMarker {
   childWhere: WhereInput;
@@ -1830,6 +1890,8 @@ interface ShapeRowOp {
   value?: Record<string, unknown>;
 }
 interface ShapePokePart {
+  baseCheckpoint?: number;
+  reset?: boolean;
   rowsPatch: ShapeRowOp[];
   shapeId: string;
 }
@@ -1920,6 +1982,7 @@ interface RelayHost {
     baseCheckpoint: number | undefined;
     cursor: number;
     epoch: string | undefined;
+    reset: boolean;
     rowsPatch: ShapeRowOp[];
   };
   currentCdcEpoch: () => string | undefined;
@@ -1950,6 +2013,7 @@ declare abstract class RelayLink {
   maxRelays(): number;
   protected canAddressSiblings(): boolean;
   protected siblingStub(targetName: string): SiblingStub | undefined;
+  protected bindingName(): string | undefined;
   protected postRelayMessage(targetName: string, message: OwnerRelayFrame): Promise<void>;
   protected requestRelayMessage(targetName: string, message: OwnerRelayFrame): Promise<Response | undefined>;
   abstract forwardWhisper(topic: string, frame: string): Promise<void>;
@@ -1962,6 +2026,7 @@ declare abstract class RelayLink {
   abstract announceDrain(closing: ShardSocketLike): Promise<void>;
   abstract relayCount(): number;
   abstract isShapeRelayUniform(name: string, args: Record<string, unknown>): boolean;
+  abstract minShapeCursor(): number | undefined;
   protected abstract onAttach(index: number): void;
   protected abstract onDetach(index: number): void;
   protected abstract onWhisperFrame(message: RelayFrame): Promise<void>;
@@ -1971,8 +2036,8 @@ declare abstract class RelayLink {
 declare class OwnerRelay extends RelayLink {
   private readonly shapeUniformCache;
   private relaySetCache;
-  private readonly relayShapeRegistry;
-  private readonly relayShapeProxies;
+  private registryCache;
+  private recordedBinding;
   private promotionState;
   constructor(host: RelayHost, ownerKey: string);
   forwardWhisper(topic: string, frame: string): Promise<void>;
@@ -1984,6 +2049,7 @@ declare class OwnerRelay extends RelayLink {
   announce(): Promise<void>;
   announceDrain(): Promise<void>;
   relayCount(): number;
+  minShapeCursor(): number | undefined;
   isShapeRelayUniform(name: string, args: Record<string, unknown>): boolean;
   protected onAttach(index: number): void;
   protected onDetach(index: number): void;
@@ -1992,9 +2058,14 @@ declare class OwnerRelay extends RelayLink {
   protected onShapePoke(): number;
   private buildShapePoke;
   private multicastShapePokes;
+  private multicastToRelays;
   private proxyShapePokes;
+  private proxyToRelay;
   private buildShapeSeedFrames;
-  private ensureRelayTable;
+  private ensureRelayTables;
+  protected bindingName(): string | undefined;
+  private relayShapes;
+  private rewindShapeCursor;
   private ownerRelaySet;
   private addRelayToSet;
   private removeRelayFromSet;
@@ -2015,6 +2086,7 @@ declare class RelayMember extends RelayLink {
   announceDrain(closing: ShardSocketLike): Promise<void>;
   relayCount(): number;
   isShapeRelayUniform(): boolean;
+  minShapeCursor(): number | undefined;
   protected onAttach(): void;
   protected onDetach(): void;
   protected onWhisperFrame(): Promise<void>;
@@ -2108,6 +2180,24 @@ declare const readSchemaHistory: (sql: SqlExec) => SchemaVersionRow[];
 declare const readSchemaVersion: (sql: SqlExec, hash: string) => SchemaVersionRow | undefined;
 declare const isDevEnvironment: (rawEnv: unknown) => boolean;
 declare const buildSettings: (rawEnv: unknown) => SettingsResult;
+declare class ShapeDiffCache {
+  private readonly keyScans;
+  private readonly memberProbes;
+  private run;
+  private served;
+  get probesRun(): number;
+  get probesServed(): number;
+  changedKeys(rangeKey: string, load: () => CdcChangeKey[]): ReadonlyArray<CdcChangeKey>;
+  members(resolved: ResolvedShape, rangeKey: string, load: () => Map<string, Record<string, unknown>>): ReadonlyMap<string, Record<string, unknown>>;
+  private getOrLoad;
+}
+declare const createShapeDiffCache: () => ShapeDiffCache;
+declare const globalShapeReadKey: (resolved: ResolvedShape, identity: {
+  identity?: Record<string, unknown>;
+  userId?: string;
+}) => string | undefined;
+type ReadShapeCdcKeys = (sql: SqlExec, table: string, sinceSeq: number, upTo: number) => CdcChangeKey[];
+declare const buildShapeDiff: (sql: SqlExec, resolved: ResolvedShape, sinceSeq: number, upTo: number, cache: ShapeDiffCache, readKeys?: ReadShapeCdcKeys) => ShapeRowOp[];
 interface ShardRunnerOptions {
   handlers?: {
     handleAlarm?: () => Promise<void>;
@@ -2206,4 +2296,4 @@ interface WhereSqlStrategy {
 }
 declare const literalInList: (reference: SQL, items: ReadonlyArray<unknown>, negated: boolean) => SQL;
 declare const compileWhereSql: (where: WhereInput | undefined, strategy: WhereSqlStrategy) => SQL | undefined;
-export { ADMIN_FUNCTIONS, ADMIN_FUNCTION_PREFIX, AGGREGATE_SQL_FUNCTION, AGG_COUNT, AGG_KEY, AGG_VALUE, AUDIT_LOG_TABLE, type AdvisorProcedure, type AdvisorProceduresResult, type AdvisoriesResult, type AdvisoryFinding, type AggregateIndexDefinitionLike, type AggregateOp, type AggregateOptions, type AggregateResult, type AggregateTally, type AppendAuditEntry, type ApplyOnDeleteOptions$1 as ApplyOnDeleteOptions, type AuditEntry, type AuditLogResult, type BroadcastDelta, CDC_LOG_TABLE, CDC_META_TABLE, CLIENT_WATERMARK_TABLE, COMMIT_SEQ_FIELD, COMMIT_SEQ_TABLE, type CacheEntry, type CapturedMailRow, type CdcChange, type ChangedKeys, type Clock, type ColumnMeta, type ColumnMetaLike, type CompanionSync, type CompanionSyncDeps, ConflictError, type ConflictKind, type CountArgs, CountRlsUnsupportedError, type CreateWorkflowInstanceResult, type CrossShardReadArgs, type CtxDbOptions, DATA_MIGRATION_STATE_TABLE, DEFAULT_FANOUT_TOPIC_LIMIT, DEFAULT_MAX_RELATION_KEYS, DEFAULT_MAX_RELAYS, DEFAULT_PROMOTION_THRESHOLDS, DEFAULT_TRANSACTION_LIMITS, DOC_COLUMN, type DataMigrationDocument, type DataMigrationLike, type DataMigrationTransform, type DatabaseWriterLike, type DependencyTracker, type DeployInfo, type DurableAttachDecision, type DurableStreamAttach, type DurableStreamRun, DurableStreamRunner, type DurableStreamSink, type ExportRow, type ExportShardAdminArgs, type ExportShardArgs, type ExternalSourceDiffResult, type ExternalSourceLike, FLAGS_FUNCTION_PREFIX, type FacetColumnOptions, type FacetColumnResult, type FacetValue, type FanoutMetricsResult, type FanoutPathCounters, type FanoutTopicStat, type FieldOperators, type FilterClause, type FilterOperator, type FlagEvaluation, type FlagsResult, type FunctionCallStat, type FunctionScanAttribution, type FunctionStatsResult, GEO_DEFAULT_PRECISION, GLOBAL_SHAPE_SNAPSHOT_TABLE, type GeoBoundingBox, type GeoFilterBuilderLike, type GeoIndexDefinitionLike, type GeoPoint, type GeoScoredDocument, type GroupByEntry, type GroupByOptions, type GuardableSchema$1 as GuardableSchema, IDEMPOTENCY_TABLE, type IdGenerator, type IdempotentRecord, type ImportError, type ImportShardAdminArgs, type ImportShardArgs, type ImportShardResult, type IncrementalMaterializeResult, type IndexDefinitionLike, type IndexKeyEntry, type IndexRangeBuilderLike, type KeyRange, type LifecycleDispatchInfo, type LifecycleEvent, MAIL_RETENTION, MAIL_TABLE, MAX_DURABLE_STREAM_BYTES, MAX_DURABLE_STREAM_CHUNKS, MAX_PAGE_SIZE, MAX_SQL_ROWS, type MaskColumnMetadata, type MaskPoliciesResult, type MaterializeResult, type MigrationDirection, type MigrationRunResult, type MigrationStatus, type MigrationStatusRow, type MutationDelta, type NestedWith, NotFoundError, NotUniqueError, type OnDeleteActionLike, type OrderByClause, type OrderByInput, type OrderKey, OwnerRelay, type OwnerRelayFrame, type PaginationOptions, type PitrBookmarkResult, type PitrRestoreArgs, type PitrRestoreResult, type PitrStorage, type PokeFrameMeta, type PromotionState, type PromotionThresholds, QUEUE_TABLE, type QueryArgs, type QueryPage, type QueueMessageOutcome, type QueueMessageRow, type QueueMetadata, type QueuesResult, RANK_TIEBREAK, REACTOR_STATE_TABLE, RELATION_EXISTS_KEY, RELATION_FUNCTION_PREFIX, REPROJECTION_MIGRATION_PREFIX, RLS_UNWRAP_SYMBOL, type RankBeforeOptions, type RankBeforeResult, type RankDirection, type RankIndexDefinitionLike, type RankOptions, type RankPage, type RankPageComputation, type RankPageDeps, type RankPageOptions, type RankPageRow, type RankPageRowKey, type RankResult, type RankSortKeyLike, ReactiveCache, type ReactiveCacheOptions, type ReactorDispatchResult, type ReactorMetadata, type ReactorState, type ReactorStats, type ReactorsResult, type ReadFootprint, type ReadHook, type ReadTablePageOptions, type RecordMailInput, type RecordQueueMessageInput, type RelationDefinitionLike, type RelationExistsMarker, type RelayAttach, type RelayDetach, type RelayFrame, type RelayHost, RelayMember, type RelayShapePoke, type RelayShapeSeed, type RelayShapeSubscribe, type RenderedSql, type ReplicaFollowerHost, type ReplicaOwnerHost, type ReplicaReadiness, type ResolveRelationPredicatesOptions, type ResolveWithOptions, type ResolveWithResult, type ResolvedShape, type RestrictableQueryOptions, type RlsPoliciesResult, type RlsPolicyMetadata, RlsRequiredError, type RlsRoleMetadata, type RpcRequest, type RunDataMigrationOptions, type RunTriggersOptions, SCAN_DEP, SCHEMA_HISTORY_MAX_VERSIONS, SEARCH_STATE_TABLE, SHAPE_POKE_CURSOR_TABLE, type SchedulableWorkflowReferenceLike, type ScheduledFunctionDoc, type SchedulerLike, type SchemaLike, type ScoredDocument, type SearchFilterBuilderLike, type SearchIndexDefinitionLike, type SearchScoredDocument, type SelectMatchingIdsOptions, type ServerDefaultContextLike, type SettingEntry, type SettingKind, type SettingsResult, type ShapePokePart, type ShapeRow, type ShapeRowOp, type ShapeSubscriptionQuery, type ShardRankPageResult, ShardRunner, type ShardRunnerOptions, type ShardSiblingHost, type ShardSocketLike, type SocketAttachment, type SortDirection, type SourceClientLike, type SourceCursorLike, type SourceRefresh, type SqlConsoleResult, type SqlCursor, type SqlEngine, type SqlExec, type SqlLintResult, type StorageMetadata, type StorageReference, type StorageReferenceResult, type StorageRuleMetadata, type StorageRulesResult, type StudioFeaturesResult, type SubscriptionConnection, type SubscriptionEnvelope, type SubscriptionIdentity, type SubscriptionInfo, type SubscriptionQuery, type SubscriptionReadFootprint, type SubscriptionsResult, type SystemDatabaseReader, type SystemDoc, type SystemQuery, type SystemReaderOptions, type SystemReaderSchedulerLike, type SystemReaderStorageLike, type SystemTableName, type TableColumnsResult, type TableDefinitionLike, type TableIndexInfo, type TableIndexesResult, type TableInfo, type TablePage, type TableReaderLike, type TablesColumnsResult, type TablesIndexesResult, type TransactionHeadroom, TransactionHeadroomTracker, type TransactionLimits, type TransactionSqlLike, type TriggerContextLike, type TriggerDefinitionLike, type TriggerEventLike, type TriggerOpLike, type TriggerTimingLike, type TtlSweepSpec, type ValidatorLike, type WhereInput, type WhereSqlStrategy, type WithInput, type WorkflowInstanceState, type WorkflowInstanceStatusResult, type WorkflowMetadata, type WorkflowsResult, type WriteEvent, type WriteHook, advanceClientWatermark, aggUpsertSql, aggregateSqlFunction, aggregateTableName, allocateCommitSeq, appendAuditEntry, appendCdcChange, appendStreamChunk, applyCdcChanges, applyOnDelete, applySelect, armRestore, assertFlatPredicate, assertReadonly, assertShapeShardable, assertValidClientId, awaitWsDrain, backfillAggregateIndexes, backfillRankIndexes, backfillSearchIndexes, backfillSearchIndexesForTable, boundingBoxCenter, boundingBoxGeohashes, buildIndexRange, buildPokeFrames, buildReprojectionMigration, buildSeekBeforeWhere, buildSeekWhere, buildSettings, bumpCdcEpoch, claimStreamRun, clampPromotionThresholds, clearCapturedMail, clearMemoryTables, clearQueueMessages, coerceAggregateNumber, compileWhereSql, computeRankPage, containsRelationPredicate, countLegacyRows, coveringGeohashes, createCompanionSync, createDependencyTracker, createFanoutCounters, createIndexSql, createReadFootprint, createRelayLink, createReplicaLink, createShardCtxDb, createSystemReader, decideDurableAttach, decodeCursor, deleteGlobalShapeSnapshot, deleteGlobalShapeSnapshotsForConnection, deleteShapePokeCursor, deleteShapePokeCursorsForConnection, deleteStreamRun, depKey, diffExternalSource, diffGlobalMembership, distinctValues, encodeAggregateKey, encodeCursor, encodeGeohash, encodePartitionKey, encodeRowsPatch, ensureAuditTable, ensureMailTable, exportShardRows, exportShardTable, facetColumn, fanOutScalarCounts, findStorageReferences, finishStreamRun, foldAggregateTally, gateReplicaDispatch, geoTableName, guardWriter, handleReplicaControl, hasTrigger, haversineMeters, hydrateDocsById, importShardRows, indexKeysForRow, isDevEnvironment, isFtsAvailable, isLossyBody, isMemoryTable, isRelationPredicate, isSoftDeleted, isSourceDue, jsonPath, jsonPathSql, keysTouchRanges, liftSourceId, lintReadonlySql, listReactorStates, listTables, literalInList, matchesRankStaticWhere, matchesStaticWhere, materializeExternalRows, materializeExternalRowsIncremental, memoryTableNames, mergeChangedKeys, mergeWhere, migrateCdcLog, migrateCdcMeta, migrateClientWatermark, migrateCommitSeq, migrateDurableStreams, migrateGlobalShapeSnapshot, migrateIdempotency, migrateReactorState, migrateSearchState, migrateShapePokeCursor, minCdcSeq, nextPromotionState, normalizeCountArgument, normalizeIdStructurally, normalizeOrderKeys, normalizeSourceDocument, normalizeSourceValue, param, parseExportShardArgs, parseImportShardArgs, planAggregateLookup, pointInBoundingBox, projectColumns, pullExternalSourceIncrementalTick, pullExternalSourceTick, qualifiedJsonPath, qualifiedJsonPathSql, quoteIdentifier, rankKeyFromDocument as rankKeyFromDoc, rankTableName, reactiveCacheKey, reactorNeedsRun, readAggregateValue, readAuditLog, readBookmark, readCapturedMail, readCdcChanges, readCdcCursor, readCdcEpoch, readClientWatermark, readCommitSeq, readExternalSourceBaseline, readGlobalShapeSnapshot, readIdempotent, readMigrationStatus, readQueueMessageById, readQueueMessages, readReactorState, readSchemaHistory, readSchemaVersion, readSearchBackfillState, readShapePokeCursor, readStreamChunks, readStreamRun, readTablePage, recordCapturedMail, recordChangedKeys, recordFanoutPass, recordQueueMessages, recordSchemaVersion, relationHooks, relayCountFor, renderSql, reprojectableFields, reprojectionMigrationId, reprojectionTables, resolveRankPartition, resolveRelationPredicates, resolveWith, rowToDocument, runDataMigration, runDrizzle, runExternalSourceTick, runReadonlySql, runRowValidators, runShardMigrations, runSocketPool, runSql, runTriggers, selectExpiredIds, selectExportTables, selectIndexForAggregate, selectIndexForCount, selectIndexForGroupBy, selectMatchingIds, selectShapeMemberIds, selectShapeRows, serializeSqlValue, shapeRoutingKey, softDeleteScope, sortColumnName, sqliteInList, stableStringify, stableWireKey, subscriptionFrames, subscriptionListDeltas, summarizeFanoutTopics, summarizeSubscriptions, tableColumns, tableFromDepKey, throwingScheduler, trimCdcChanges, trimIdempotent, trimStreamRuns, tryRowToDocument, trySendFrame, unionAll, validateImportRow, writeGlobalShapeSnapshot, writeIdempotent, writeReactorState, writeSearchBackfillState, writeShapePokeCursor, writeTouchesMemo };
+export { ADMIN_FUNCTIONS, ADMIN_FUNCTION_PREFIX, AGGREGATE_SQL_FUNCTION, AGG_COUNT, AGG_KEY, AGG_VALUE, AUDIT_LOG_TABLE, type AdvisorProcedure, type AdvisorProceduresResult, type AdvisoriesResult, type AdvisoryFinding, type AggregateIndexDefinitionLike, type AggregateOp, type AggregateOptions, type AggregateResult, type AggregateTally, type AppendAuditEntry, type ApplyOnDeleteOptions$1 as ApplyOnDeleteOptions, type AuditEntry, type AuditLogResult, type BroadcastDelta, CDC_LOG_TABLE, CDC_LOG_TABLE_SEQ_INDEX, CDC_META_TABLE, CLIENT_WATERMARK_TABLE, COMMIT_SEQ_FIELD, COMMIT_SEQ_TABLE, type CacheEntry, type CapturedMailRow, type CdcChange, type CdcChangeKey, type ChangedKeys, type Clock, type ColumnMeta, type ColumnMetaLike, type CompanionSync, type CompanionSyncDeps, ConflictError, type ConflictKind, type CountArgs, CountRlsUnsupportedError, type CreateWorkflowInstanceResult, type CrossShardReadArgs, type CtxDbOptions, DATA_MIGRATION_STATE_TABLE, DEFAULT_FANOUT_TOPIC_LIMIT, DEFAULT_MAX_RELATION_KEYS, DEFAULT_MAX_RELAYS, DEFAULT_PROMOTION_THRESHOLDS, DEFAULT_TRANSACTION_LIMITS, DOC_COLUMN, type DataMigrationDocument, type DataMigrationLike, type DataMigrationTransform, type DatabaseWriterLike, type DependencyTracker, type DeployInfo, type DurableAttachDecision, type DurableStreamAttach, type DurableStreamRun, DurableStreamRunner, type DurableStreamSink, type ExportRow, type ExportShardAdminArgs, type ExportShardArgs, type ExternalSourceDiffResult, type ExternalSourceLike, FLAGS_FUNCTION_PREFIX, type FacetColumnOptions, type FacetColumnResult, type FacetValue, type FanoutMetricsResult, type FanoutPathCounters, type FanoutTopicStat, type FieldOperators, type FilterClause, type FilterOperator, type FlagEvaluation, type FlagsResult, type FunctionCallStat, type FunctionScanAttribution, type FunctionStatsResult, GEO_DEFAULT_PRECISION, GLOBAL_SHAPE_SNAPSHOT_TABLE, type GeoBoundingBox, type GeoFilterBuilderLike, type GeoIndexDefinitionLike, type GeoPoint, type GeoScoredDocument, type GlobalPollCounters, GlobalPollTick, type GroupByEntry, type GroupByOptions, type GuardableSchema$1 as GuardableSchema, IDEMPOTENCY_TABLE, type IdGenerator, type IdempotentRecord, type ImportError, type ImportShardAdminArgs, type ImportShardArgs, type ImportShardResult, type IncrementalMaterializeResult, type IndexDefinitionLike, type IndexKeyEntry, type IndexRangeBuilderLike, type KeyRange, type LifecycleDispatchInfo, type LifecycleEvent, MAIL_RETENTION, MAIL_TABLE, MAX_DURABLE_STREAM_BYTES, MAX_DURABLE_STREAM_CHUNKS, MAX_PAGE_SIZE, MAX_SQL_ROWS, type MaskColumnMetadata, type MaskPoliciesResult, type MaterializeResult, type MigrationDirection, type MigrationRunResult, type MigrationStatus, type MigrationStatusRow, type MutationDelta, type NestedWith, NotFoundError, NotUniqueError, type OnDeleteActionLike, type OrderByClause, type OrderByInput, type OrderKey, OwnerRelay, type OwnerRelayFrame, type PaginationOptions, type PitrBookmarkResult, type PitrRestoreArgs, type PitrRestoreResult, type PitrStorage, type PokeFrameMeta, type PromotionState, type PromotionThresholds, QUEUE_TABLE, type QueryArgs, type QueryPage, type QueueMessageOutcome, type QueueMessageRow, type QueueMetadata, type QueuesResult, RANK_TIEBREAK, REACTOR_STATE_TABLE, RELATION_EXISTS_KEY, RELATION_FUNCTION_PREFIX, REPROJECTION_MIGRATION_PREFIX, RLS_UNWRAP_SYMBOL, type RankBeforeOptions, type RankBeforeResult, type RankDirection, type RankIndexDefinitionLike, type RankOptions, type RankPage, type RankPageComputation, type RankPageDeps, type RankPageOptions, type RankPageRow, type RankPageRowKey, type RankResult, type RankSortKeyLike, ReactiveCache, type ReactiveCacheOptions, type ReactorDispatchResult, type ReactorMetadata, type ReactorState, type ReactorStats, type ReactorsResult, type ReadFootprint, type ReadHook, type ReadTablePageOptions, type RecordMailInput, type RecordQueueMessageInput, type RelationDefinitionLike, type RelationExistsMarker, type RelayAttach, type RelayDetach, type RelayFrame, type RelayHost, RelayMember, type RelayShapePoke, type RelayShapeSeed, type RelayShapeSubscribe, type RenderedSql, type ReplicaFollowerHost, type ReplicaOwnerHost, type ReplicaReadiness, type ResolveRelationPredicatesOptions, type ResolveWithOptions, type ResolveWithResult, type ResolvedShape, type RestrictableQueryOptions, type RlsPoliciesResult, type RlsPolicyMetadata, RlsRequiredError, type RlsRoleMetadata, type RpcRequest, type RunDataMigrationOptions, type RunTriggersOptions, SCAN_DEP, SCHEMA_HISTORY_MAX_VERSIONS, SEARCH_STATE_TABLE, SHAPE_POKE_CURSOR_TABLE, type SchedulableWorkflowReferenceLike, type ScheduledFunctionDoc, type SchedulerLike, type SchemaLike, type ScoredDocument, type SearchBackfillProgress, type SearchFilterBuilderLike, type SearchIndexDefinitionLike, type SearchScoredDocument, type SelectMatchingIdsOptions, type ServerDefaultContextLike, type SettingEntry, type SettingKind, type SettingsResult, ShapeDiffCache, type ShapePokePart, type ShapeProbeCounters, type ShapeRow, type ShapeRowOp, type ShapeSubscriptionQuery, type ShardRankPageResult, ShardRunner, type ShardRunnerOptions, type ShardSiblingHost, type ShardSocketLike, type SocketAttachment, type SortDirection, type SourceClientLike, type SourceCursorLike, type SourceRefresh, type SqlConsoleResult, type SqlCursor, type SqlEngine, type SqlExec, type SqlLintResult, type StorageMetadata, type StorageReference, type StorageReferenceResult, type StorageRuleMetadata, type StorageRulesResult, type StudioFeaturesResult, type SubscriptionConnection, type SubscriptionEnvelope, type SubscriptionIdentity, type SubscriptionInfo, type SubscriptionQuery, type SubscriptionReadFootprint, type SubscriptionsResult, type SystemDatabaseReader, type SystemDoc, type SystemQuery, type SystemReaderOptions, type SystemReaderSchedulerLike, type SystemReaderStorageLike, type SystemTableName, type TableColumnsResult, type TableDefinitionLike, type TableIndexInfo, type TableIndexesResult, type TableInfo, type TablePage, type TableReaderLike, type TablesColumnsResult, type TablesIndexesResult, type TransactionHeadroom, TransactionHeadroomTracker, type TransactionLimits, type TransactionSqlLike, type TriggerContextLike, type TriggerDefinitionLike, type TriggerEventLike, type TriggerOpLike, type TriggerTimingLike, type TtlSweepSpec, UNVOUCHABLE_DEP, type ValidatorLike, type WhereInput, type WhereSqlStrategy, type WithInput, type WorkflowInstanceState, type WorkflowInstanceStatusResult, type WorkflowMetadata, type WorkflowsResult, type WriteEvent, type WriteHook, advanceClientWatermark, aggUpsertSql, aggregateSqlFunction, aggregateTableName, allocateCommitSeq, appendAuditEntry, appendCdcChange, appendStreamChunk, applyCdcChanges, applyOnDelete, applySelect, armRestore, assertFlatPredicate, assertReadonly, assertShapeShardable, assertValidClientId, awaitWsDrain, backfillAggregateIndexes, backfillRankIndexes, backfillSearchIndexes, backfillSearchIndexesForTable, boundingBoxCenter, boundingBoxGeohashes, buildIndexRange, buildPokeFrames, buildReprojectionMigration, buildSeekBeforeWhere, buildSeekWhere, buildSettings, buildShapeDiff, bumpCdcEpoch, cdcCanVouchFor, cdcSeqLeavingRows, cdcTouchesTables, cdcTrimmedError, claimStreamRun, clampPromotionThresholds, clearCapturedMail, clearMemoryTables, clearQueueMessages, coerceAggregateNumber, compactCdcDocs, compileWhereSql, computeRankPage, containsRelationPredicate, countLegacyRows, coveringGeohashes, createCompanionSync, createDependencyTracker, createFanoutCounters, createGlobalPollCounters, createIndexSql, createReadFootprint, createRelayLink, createReplicaLink, createShapeDiffCache, createShapeProbeCounters, createShardCtxDb, createSystemReader, cursorBelowRetainedFloor, decideDurableAttach, decodeCursor, deleteGlobalShapeSnapshot, deleteGlobalShapeSnapshotsForConnection, deleteShapePokeCursor, deleteShapePokeCursorsForConnection, deleteStreamRun, depKey, diffExternalSource, diffGlobalMembership, distinctValues, encodeAggregateKey, encodeCursor, encodeGeohash, encodePartitionKey, encodeRowsPatch, ensureAuditTable, ensureMailTable, envOptionalPositiveInt, envPositiveInt, exportShardRows, exportShardTable, facetColumn, fanOutScalarCounts, findStorageReferences, finishStreamRun, foldAggregateTally, gateReplicaDispatch, geoTableName, globalShapeReadKey, guardWriter, handleReplicaControl, hasTrigger, haversineMeters, hydrateDocsById, importShardRows, indexKeysForRow, isDevEnvironment, isFtsAvailable, isLossyBody, isMemoryTable, isRelationPredicate, isSoftDeleted, isSourceDue, jsonPath, jsonPathSql, keysTouchRanges, liftSourceId, lintReadonlySql, listReactorStates, listTables, literalInList, markUnvouchableReads, matchesRankStaticWhere, matchesStaticWhere, materializeExternalRows, materializeExternalRowsIncremental, memoryTableNames, mergeChangedKeys, mergeWhere, migrateCdcLog, migrateCdcMeta, migrateClientWatermark, migrateCommitSeq, migrateDurableStreams, migrateGlobalShapeSnapshot, migrateIdempotency, migrateReactorState, migrateSearchState, migrateShapePokeCursor, minCdcReplayableSeq, minCdcSeq, minShapePokeCursor, nextPromotionState, normalizeCountArgument, normalizeIdStructurally, normalizeOrderKeys, normalizeSourceDocument, normalizeSourceValue, param, parseExportShardArgs, parseImportShardArgs, planAggregateLookup, pointInBoundingBox, projectColumns, pullExternalSourceIncrementalTick, pullExternalSourceTick, qualifiedJsonPath, qualifiedJsonPathSql, quoteIdentifier, rankKeyFromDocument as rankKeyFromDoc, rankTableName, reactiveCacheKey, reactorNeedsRun, readAggregateValue, readAuditLog, readBookmark, readCapturedMail, readCdcChangeKeys, readCdcChanges, readCdcCursor, readCdcEpoch, readClientWatermark, readCommitSeq, readExternalSourceBaseline, readGlobalShapeSnapshot, readIdempotent, readMigrationStatus, readQueueMessageById, readQueueMessages, readReactorState, readSchemaHistory, readSchemaVersion, readSearchBackfillState, readShapePokeCursor, readStreamChunks, readStreamRun, readTablePage, recordCapturedMail, recordChangedKeys, recordFanoutPass, recordGlobalPollPass, recordQueueMessages, recordSchemaVersion, recordShapeProbePass, relationHooks, relayCountFor, renderSql, reprojectableFields, reprojectionMigrationId, reprojectionTables, resolveRankPartition, resolveRelationPredicates, resolveWith, rowToDocument, runDataMigration, runDrizzle, runExternalSourceTick, runReadonlySql, runRowValidators, runShardMigrations, runSocketPool, runSql, runTriggers, selectExpiredIds, selectExportTables, selectIndexForAggregate, selectIndexForCount, selectIndexForGroupBy, selectMatchingIds, selectShapeMembers, selectShapeRows, serializeSqlValue, shapeRoutingKey, softDeleteScope, sortColumnName, sqliteInList, stableStringify, stableWireKey, subscriptionFrames, subscriptionListDeltas, summarizeFanoutTopics, summarizeSubscriptions, tableColumns, tableFromDepKey, throwingScheduler, trimCdcChanges, trimIdempotent, trimStreamRuns, tryRowToDocument, trySendFrame, unionAll, validateImportRow, writeGlobalShapeSnapshot, writeIdempotent, writeReactorState, writeSearchBackfillState, writeShapePokeCursor, writeTouchesMemo };