@lunora/shard-engine 1.0.0-alpha.3 → 1.0.0-alpha.30

package/dist/conformance/index.mjs

@@ -1 +1 @@
-import{defineEngineContractSuite as t}from"../packem_shared/defineEngineContractSuite-BefTibvY.mjs";export{t as defineEngineContractSuite};
+import{defineEngineContractSuite as t}from"../packem_shared/defineEngineContractSuite-0XtjRA7F.mjs";export{t as defineEngineContractSuite};

package/dist/index.d.mts

@@ -230,6 +230,7 @@ interface ResolveWithOptions {
   groupedCounter: (tableName: string, whereField: string, values: unknown[], policyWhere?: WhereInput) => Promise<Map<unknown, number>>;
   parents: Record<string, unknown>[];
   relationBaseWhere?: (table: string) => undefined | WhereInput;
+  relationMask?: RelationMask;
   schema: {
     readonly tables: Record<string, TableDefinitionLike>;
   };
@@ -250,11 +251,19 @@ interface QueryArgs {
   limit?: number;
   orderBy?: OrderByInput[];
   relationBaseWhere?: (table: string) => undefined | WhereInput;
+  relationMask?: RelationMask;
   restrictsCounts?: boolean;
   select?: ReadonlyArray<string>;
   where?: WhereInput;
   with?: WithInput;
 }
+interface CrossShardReadArgs {
+  orderBy?: OrderByInput[];
+  relationPolicies?: Record<string, WhereInput>;
+  where?: WhereInput;
+  with?: WithInput;
+}
+type RelationMask = (table: string, rows: Record<string, unknown>[]) => Record<string, unknown>[];
 interface QueryPage {
   continueCursor: null | string;
   isDone: boolean;
@@ -359,9 +368,21 @@ interface GeoFilterBuilderLike {
     };
   }) => GeoFilterBuilderLike;
 }
+type ScoredDocument = GeoScoredDocument | SearchScoredDocument;
+interface GeoScoredDocument {
+  distanceMeters: null | number;
+  document: Record<string, unknown>;
+  score?: never;
+}
+interface SearchScoredDocument {
+  distanceMeters?: never;
+  document: Record<string, unknown>;
+  score: number;
+}
 interface TableReaderLike {
   [Symbol.asyncIterator]: () => AsyncIterator<Record<string, unknown>>;
   collect: () => Promise<Record<string, unknown>[]>;
+  collectWithScores: () => Promise<ScoredDocument[]>;
   filter: (predicate: (document: Record<string, unknown>) => boolean) => TableReaderLike;
   first: () => Promise<Record<string, unknown> | null>;
   order: (direction: "asc" | "desc") => TableReaderLike;
@@ -600,6 +621,7 @@ declare class ReactiveCache {
   };
   private dropRangeDeps;
   private collectAndDrop;
+  private dropKeys;
   private dropEntry;
   private evict;
 }
@@ -817,6 +839,7 @@ interface ShapeSubscriptionQuery {
   sinceSeq?: number;
 }
 interface SubscriptionEnvelope {
+  caps?: string[];
   clientId?: string;
   context?: Record<string, unknown>;
   data?: unknown;
@@ -827,6 +850,7 @@ interface SubscriptionEnvelope {
     name: string;
   };
   sinceCheckpoint?: number;
+  sinceChunk?: number;
   sinceEpoch?: string;
   topic?: string;
   type: "ack" | "connect" | "shape_subscribe" | "shape_unsubscribe" | "stream" | "subscribe" | "unsubscribe" | "whisper" | "whisper_subscribe" | "whisper_unsubscribe";
@@ -843,6 +867,7 @@ interface SocketAttachment {
   context?: Record<string, unknown>;
   expiresAt?: number;
   identity?: Record<string, unknown>;
+  pageDeltas?: boolean;
   shapes?: Record<string, ShapeSubscriptionQuery>;
   subs: Record<string, SubscriptionQuery>;
   userId?: string;
@@ -907,11 +932,21 @@ interface RankPageComputation {
 }
 declare const hydrateDocsById: (deps: RankPageDeps, tableName: string, ids: ReadonlyArray<string>) => Map<string, Record<string, unknown>>;
 declare const computeRankPage: (deps: RankPageDeps, tableName: string, indexName: string, rankPageOptions: RankPageOptions) => RankPageComputation;
+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 deleteShapePokeCursor: (sql: SqlExec, connectionId: string, subId: string) => void;
+declare const deleteShapePokeCursorsForConnection: (sql: SqlExec, connectionId: string) => void;
 declare const DATA_MIGRATION_STATE_TABLE = "__lunora_migrations";
 type MigrationDirection = "down" | "up";
 type MigrationStatus = "completed" | "failed" | "in_progress";
 type DataMigrationDocument = Record<string, unknown>;
-type DataMigrationTransform = (document: DataMigrationDocument) => DataMigrationDocument | undefined;
+type DataMigrationReader = Pick<DatabaseWriterLike, "count" | "findFirst" | "findMany" | "get">;
+interface DataMigrationContext {
+  db: DataMigrationReader;
+}
+type DataMigrationTransform = (document: DataMigrationDocument, context: DataMigrationContext) => DataMigrationDocument | Promise<DataMigrationDocument | undefined> | undefined;
 interface DataMigrationLike {
   readonly batchSize?: number;
   readonly down?: DataMigrationTransform;
@@ -966,10 +1001,10 @@ interface DependencyTracker {
 declare const createDependencyTracker: () => DependencyTracker;
 declare const runSql: <Row = Record<string, unknown>>(sql: SqlExec, query: string, ...params: unknown[]) => SqlCursor<Row>;
 declare const runDrizzle: <Row = Record<string, unknown>>(exec: SqlExec, query: SQL) => SqlCursor<Row>;
+declare const quoteIdentifier: (name: string) => string;
 declare const serializeSqlValue: (value: unknown) => unknown;
 declare const DOC_COLUMN = "__doc__";
 declare const geoTableName: (table: string, indexName: string) => string;
-declare const quoteIdentifier: (name: string) => string;
 declare const jsonPath: (field: string) => string;
 declare const jsonPathSql: (field: string) => SQL;
 declare const qualifiedJsonPath: (table: string, field: string) => string;
@@ -990,6 +1025,72 @@ interface RenderedSql {
 }
 declare const renderSql: (engine: SqlEngine, query: SQL) => RenderedSql;
 declare const param: (value: unknown) => SQL;
+declare const unionAll: (branches: ReadonlyArray<SQL>) => SQL;
+declare const sqliteInList: (reference: SQL, items: ReadonlyArray<unknown>, negated: boolean, budget?: number) => SQL;
+type DurableStreamStatus = "complete" | "error" | "running";
+interface DurableStreamRun {
+  error?: string;
+  errorCode?: string;
+  lastSeq: number;
+  startedAt: number;
+  status: DurableStreamStatus;
+}
+interface DurableStreamChunk {
+  dataJson: string;
+  seq: number;
+}
+declare const migrateDurableStreams: (sql: SqlExec) => void;
+declare const readStreamRun: (sql: SqlExec, runKey: string) => DurableStreamRun | undefined;
+declare const claimStreamRun: (sql: SqlExec, runKey: string, startedAt: number, ttlMs: number) => boolean;
+declare const deleteStreamRun: (sql: SqlExec, runKey: string) => void;
+declare const appendStreamChunk: (sql: SqlExec, runKey: string, seq: number, dataJson: string) => void;
+declare const readStreamChunks: (sql: SqlExec, runKey: string, sinceSeq: number) => DurableStreamChunk[];
+declare const finishStreamRun: (sql: SqlExec, runKey: string, status: "complete" | "error", lastSeq: number, failure?: {
+  code: string;
+  message: string;
+}) => void;
+declare const trimStreamRuns: (sql: SqlExec, now: number) => void;
+declare const MAX_DURABLE_STREAM_CHUNKS = 50000;
+declare const MAX_DURABLE_STREAM_BYTES: number;
+interface DurableStreamSink {
+  readonly chunk: (chunk: {
+    data: unknown;
+    seq: number;
+  }) => boolean;
+  readonly complete: () => void;
+  readonly fail: (failure: {
+    code: string;
+    message: string;
+  }) => void;
+}
+type DurableAttachDecision = "attach" | "interrupted" | "reclaim" | "replay-terminal";
+declare const decideDurableAttach: (run: DurableStreamRun | undefined, context: {
+  live: boolean;
+  resuming: boolean;
+}) => DurableAttachDecision;
+interface DurableStreamAttach {
+  readonly iterator: (signal: AbortSignal) => AsyncIterable<unknown>;
+  readonly runKey: string;
+  readonly sinceChunk: number;
+  readonly sink: DurableStreamSink;
+  readonly ttlMs?: number;
+}
+declare class DurableStreamRunner {
+  private lastTrimAt;
+  private readonly runs;
+  private readonly sql;
+  private readonly waitUntil;
+  constructor(dependencies: {
+    sql: () => SqlExec;
+    waitUntil?: (promise: Promise<unknown>) => void;
+  });
+  attach(request: DurableStreamAttach): Promise<void>;
+  detach(runKey: string, sink: DurableStreamSink): void;
+  isLive(runKey: string): boolean;
+  private attachOrThrow;
+  private produce;
+  private trim;
+}
 interface ExternalSourceDiffResult {
   changes: CdcChange[];
   nextBaseline: Map<string, string>;
@@ -1103,6 +1204,7 @@ declare const ADMIN_FUNCTIONS: {
   readonly getMetricSeries: "__lunora_admin__:getMetricSeries";
   readonly listSubscriptions: "__lunora_admin__:listSubscriptions";
   readonly listTableIndexes: "__lunora_admin__:listTableIndexes";
+  readonly listTablesIndexes: "__lunora_admin__:listTablesIndexes";
   readonly getLogs: "__lunora_admin__:getLogs";
   readonly getMetrics: "__lunora_admin__:getMetrics";
   readonly getPitrBookmark: "__lunora_admin__:getPitrBookmark";
@@ -1195,6 +1297,9 @@ interface TableIndexInfo {
 interface TableIndexesResult {
   indexes: TableIndexInfo[];
 }
+interface TablesIndexesResult {
+  indexesByTable: Record<string, TableIndexInfo[]>;
+}
 interface ColumnMeta {
   isStorage?: boolean;
   name: string;
@@ -1225,12 +1330,13 @@ interface AdvisoriesResult {
   advisories: AdvisoryFinding[];
 }
 interface AdvisorProcedure {
-  callsMail: boolean;
+  analyzableBody?: boolean;
+  callsMail?: boolean;
   emitsEvent?: boolean;
   exempt?: boolean;
   exemptReason?: string;
   exportName: string;
-  fanOut: boolean;
+  fanOut?: boolean;
   file: string;
   handlesErrors?: boolean;
   hasEmailArg?: boolean;
@@ -1238,15 +1344,15 @@ interface AdvisorProcedure {
   reachesOutbound?: boolean;
   runsAiGeneration?: boolean;
   throwsBareError?: boolean;
-  unboundedAiGeneration: boolean;
+  unboundedAiGeneration?: boolean;
   usesCaptcha: boolean;
   usesEmailGate: boolean;
-  usesInsertManyUnsafe: boolean;
+  usesInsertManyUnsafe?: boolean;
   usesMask: boolean;
   usesRateLimit: boolean;
   usesRls: boolean;
   visibility: "internal" | "public";
-  writesUserTable: boolean;
+  writesUserTable?: boolean;
 }
 interface AdvisorProceduresResult {
   procedures: AdvisorProcedure[];
@@ -1588,7 +1694,6 @@ declare const clearQueueMessages: (sql: SqlExec) => {
 declare const encodePartitionKey: (partitionBy: ReadonlyArray<string>, source: Record<string, unknown>) => string;
 declare const RANK_TIEBREAK = "__id__";
 declare const sortColumnName: (i: number) => string;
-declare const matchesRankStaticWhere: (document: Record<string, unknown>, predicate: Record<string, unknown>) => boolean;
 declare const resolveRankPartition: (index: RankIndexDefinitionLike, where: Record<string, unknown> | undefined) => Record<string, unknown> | undefined;
 declare const rankTableName: (table: string, indexName: string) => string;
 declare const rankKeyFromDocument: (index: RankIndexDefinitionLike, document_: Record<string, unknown>) => {
@@ -1596,6 +1701,7 @@ declare const rankKeyFromDocument: (index: RankIndexDefinitionLike, document_: R
   rowId: string;
   sortValues: unknown[];
 };
+declare const matchesRankStaticWhere: (document: Record<string, unknown>, predicate: Record<string, unknown>) => boolean;
 interface ReadFootprint {
   onRead: (table: string, idOrScan?: string) => void;
   onReadRange: (range: KeyRange) => void;
@@ -1637,6 +1743,7 @@ declare const containsRelationPredicate: (where: WhereInput, schema: ResolveCont
 declare const assertFlatPredicate: (where: WhereInput | undefined, schema: ResolveContext["schema"], tableName: string, op: string) => void;
 declare const resolveRelationPredicates: (where: WhereInput | undefined, options: ResolveRelationPredicatesOptions) => Promise<WhereInput | undefined>;
 declare const assertShapeShardable: (effectiveWhere: WhereInput | undefined, schema: ResolveContext["schema"], table: string) => void;
+declare const relationHooks: (args: Pick<QueryArgs, "relationBaseWhere" | "relationMask">) => Pick<QueryArgs, "relationBaseWhere" | "relationMask">;
 declare const fanOutScalarCounts: (counter: (tableName: string, where?: WhereInput) => Promise<number>, tableName: string, whereField: string, values: unknown[], policyWhere: WhereInput | undefined) => Promise<Map<unknown, number>>;
 declare const distinctValues: (rows: Record<string, unknown>[], field: string) => unknown[];
 declare const resolveWith: (options: ResolveWithOptions) => Promise<void>;
@@ -1741,15 +1848,10 @@ interface RelayShapePoke {
   type: "relay_shape_poke";
 }
 type OwnerRelayFrame = RelayAttach | RelayDetach | RelayFrame | RelayShapePoke | RelayShapeSubscribe;
-declare const DEFAULT_MAX_RELAYS = 8;
-interface RelayStub {
+interface SiblingStub {
   fetch: (url: string, init?: RequestInit) => Promise<Response>;
 }
-interface RelayNamespaceLike {
-  get: (id: unknown) => RelayStub;
-  getByName?: (name: string) => RelayStub;
-  idFromName: (name: string) => unknown;
-}
+declare const DEFAULT_MAX_RELAYS = 8;
 interface RelayHost {
   buildShapeDiff: (resolved: ResolvedShape, fromCursor: number, toCursor: number) => ShapeRowOp[];
   computeOpLogShapeSeed: (shape: ShapeSubscriptionQuery, resolved: ResolvedShape) => {
@@ -1785,7 +1887,7 @@ declare abstract class RelayLink {
   handleControl(request: Request): Promise<Response>;
   maxRelays(): number;
   protected canAddressSiblings(): boolean;
-  protected relayNamespace(): RelayNamespaceLike | undefined;
+  protected siblingStub(targetName: string): SiblingStub | 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>;
@@ -1826,6 +1928,7 @@ declare class OwnerRelay extends RelayLink {
   protected onWhisperFrame(message: RelayFrame): Promise<void>;
   protected onShapeSubscribe(message: RelayShapeSubscribe): RelayShapeSeed;
   protected onShapePoke(): number;
+  private buildShapePoke;
   private multicastShapePokes;
   private proxyShapePokes;
   private buildShapeSeedFrames;
@@ -1859,6 +1962,61 @@ declare class RelayMember extends RelayLink {
   private deliverShapePoke;
 }
 declare const createRelayLink: (host: RelayHost) => OwnerRelay | RelayMember | undefined;
+declare const REGION_HINTS: readonly ["wnam", "enam", "sam", "weur", "eeur", "apac", "apac-ne", "apac-se", "oc", "afr", "me"];
+type RegionHint = (typeof REGION_HINTS)[number];
+type ReplicaReadiness = "fresh" | "stale" | "unavailable";
+interface ShardSiblingHost {
+  doName: () => string | undefined;
+  env: () => unknown;
+  shardBinding: () => string | undefined;
+  sql: () => SqlExec;
+}
+interface ReplicaOwnerHost extends ShardSiblingHost {
+  exportRows: () => Promise<ExportRow[]>;
+  ownerCursor: () => number | undefined;
+  ownerEpoch: () => string | undefined;
+  ownerFloor: () => number | undefined;
+  readChanges: (sinceSeq: number, limit: number) => {
+    changes: CdcChange[];
+    cursor: number;
+  };
+  rowCount: () => number;
+}
+interface ReplicaFollowerHost extends ShardSiblingHost {
+  applyChanges: (changes: ReadonlyArray<CdcChange>) => Promise<number>;
+  importRows: (rows: ReadonlyArray<ExportRow>) => Promise<{
+    errors: ReadonlyArray<unknown>;
+  }>;
+}
+declare const handleReplicaControl: (host: ReplicaOwnerHost, request: Request) => Promise<Response>;
+declare class ShardReplica {
+  private readonly host;
+  readonly ownerKey: string;
+  readonly region: RegionHint;
+  private divergent;
+  private inFlight;
+  constructor(host: ReplicaFollowerHost, ownerKey: string, region: RegionHint);
+  ensureFresh(minSeq?: number): Promise<ReplicaReadiness>;
+  appliedSeq(): number;
+  isDivergent(): boolean;
+  private advance;
+  private isCaughtUp;
+  private catchUp;
+  private applyPage;
+  private hasDiverged;
+  private bootstrap;
+  private isFreshEnough;
+  private pull;
+  private request;
+}
+declare const createReplicaLink: (host: ReplicaFollowerHost) => ShardReplica | undefined;
+declare const gateReplicaDispatch: (replica: ShardReplica, request: Request, functionPath: string) => Promise<Response | undefined>;
+declare const REPROJECTION_MIGRATION_PREFIX = "__lunora_reproject__";
+declare const reprojectionMigrationId: (table: string) => string;
+declare const reprojectableFields: (definition: TableDefinitionLike) => string[];
+declare const reprojectionTables: (schema: SchemaLike) => string[];
+declare const countLegacyRows: (sql: SqlExec, table: string, fields: ReadonlyArray<string>) => number;
+declare const buildReprojectionMigration: (id: string, schema: SchemaLike, sql: SqlExec) => DataMigrationLike | undefined;
 declare const RLS_UNWRAP_SYMBOL: symbol;
 declare class RlsRequiredError extends LunoraError {
   readonly table: string;
@@ -1874,7 +2032,8 @@ interface GuardableSchema {
   }>;
 }
 type TableOfId = (id: string, expectedTable?: string) => Promise<string | undefined> | string | undefined;
-declare const guardWriter: <W>(raw: W, schema: GuardableSchema, tableOfId: TableOfId) => W;
+type TablesOfIds = (ids: ReadonlyArray<string>, expectedTable?: string) => Promise<ReadonlyMap<string, string>> | ReadonlyMap<string, string>;
+declare const guardWriter: <W>(raw: W, schema: GuardableSchema, tableOfId: TableOfId, tablesOfIds?: TablesOfIds) => W;
 declare const SCHEMA_HISTORY_MAX_VERSIONS = 50;
 interface SchemaVersionRow {
   appliedAt: number;
@@ -1936,7 +2095,17 @@ interface DrainableSink {
   readonly bufferedAmount?: unknown;
 }
 declare const trySendFrame: (ws: FrameSink, frame: string) => boolean;
-declare const sendDeltaFrames: (ws: FrameSink, subId: string, deltaFrames: ReadonlyArray<string>, cursorSuffix: string) => boolean;
+interface SubscriptionFrameInput {
+  cursorSuffix: string;
+  lastMutationId?: number;
+  nextResult: unknown;
+  pageDeltas?: boolean;
+  previousJson?: string;
+  snapshotJson: string;
+  subId: string;
+  table: string;
+}
+declare const subscriptionFrames: (input: SubscriptionFrameInput) => string[];
 declare const awaitWsDrain: (ws: DrainableSink) => Promise<void>;
 interface SubscriptionReadFootprint {
   ranges?: Map<string, KeyRange[]>;
@@ -1967,10 +2136,12 @@ declare const selectExpiredIds: (sql: SqlExec, spec: TtlSweepSpec, now: number,
 type FieldRefSql = (field: string) => SQL;
 type SerializeValue = (value: unknown) => unknown;
 interface WhereSqlStrategy {
+  containsExpr?: (reference: SQL, term: SQL) => SQL;
   fieldRef: FieldRefSql;
-  likeContains?: (reference: SQL, term: SQL) => SQL;
+  inList?: (reference: SQL, items: ReadonlyArray<unknown>, negated: boolean, budget?: number) => SQL;
   relationExists?: (request: unknown) => SQL;
   serialize: SerializeValue;
 }
+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, 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 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 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 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_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, RELATION_EXISTS_KEY, RELATION_FUNCTION_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 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 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, type SchedulableWorkflowReferenceLike, type ScheduledFunctionDoc, type SchedulerLike, type SchemaLike, type SearchFilterBuilderLike, type SearchIndexDefinitionLike, type SelectMatchingIdsOptions, type ServerDefaultContextLike, type SettingEntry, type SettingKind, type SettingsResult, type ShapePokePart, type ShapeRow, type ShapeRowOp, type ShapeSubscriptionQuery, type ShardRankPageResult, ShardRunner, type ShardRunnerOptions, 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 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, appendAuditEntry, appendCdcChange, applyCdcChanges, applyOnDelete, applySelect, armRestore, assertFlatPredicate, assertReadonly, assertShapeShardable, assertValidClientId, awaitWsDrain, backfillAggregateIndexes, backfillRankIndexes, backfillSearchIndexes, backfillSearchIndexesForTable, boundingBoxCenter, boundingBoxGeohashes, buildIndexRange, buildPokeFrames, buildSeekBeforeWhere, buildSeekWhere, buildSettings, bumpCdcEpoch, clampPromotionThresholds, clearCapturedMail, clearQueueMessages, coerceAggregateNumber, compileWhereSql, computeRankPage, containsRelationPredicate, coveringGeohashes, createCompanionSync, createDependencyTracker, createFanoutCounters, createIndexSql, createReadFootprint, createRelayLink, createShardCtxDb, createSystemReader, decodeCursor, deleteGlobalShapeSnapshot, deleteGlobalShapeSnapshotsForConnection, depKey, diffExternalSource, diffGlobalMembership, distinctValues, encodeAggregateKey, encodeCursor, encodeGeohash, encodePartitionKey, encodeRowsPatch, ensureAuditTable, ensureMailTable, exportShardRows, exportShardTable, facetColumn, fanOutScalarCounts, findStorageReferences, foldAggregateTally, geoTableName, guardWriter, hasTrigger, haversineMeters, hydrateDocsById, importShardRows, indexKeysForRow, isDevEnvironment, isFtsAvailable, isLossyBody, isRelationPredicate, isSoftDeleted, isSourceDue, jsonPath, jsonPathSql, keysTouchRanges, liftSourceId, lintReadonlySql, listTables, matchesRankStaticWhere, matchesStaticWhere, materializeExternalRows, materializeExternalRowsIncremental, mergeChangedKeys, mergeWhere, migrateCdcLog, migrateCdcMeta, migrateClientWatermark, migrateGlobalShapeSnapshot, migrateIdempotency, migrateSearchState, minCdcSeq, nextPromotionState, normalizeCountArgument, normalizeIdStructurally, normalizeOrderKeys, normalizeSourceDocument, normalizeSourceValue, param, parseExportShardArgs, parseImportShardArgs, planAggregateLookup, pointInBoundingBox, projectColumns, pullExternalSourceIncrementalTick, pullExternalSourceTick, qualifiedJsonPath, qualifiedJsonPathSql, quoteIdentifier, rankKeyFromDocument as rankKeyFromDoc, rankTableName, reactiveCacheKey, readAggregateValue, readAuditLog, readBookmark, readCapturedMail, readCdcChanges, readCdcCursor, readCdcEpoch, readClientWatermark, readExternalSourceBaseline, readGlobalShapeSnapshot, readIdempotent, readMigrationStatus, readQueueMessageById, readQueueMessages, readSchemaHistory, readSchemaVersion, readSearchBackfillState, readTablePage, recordCapturedMail, recordChangedKeys, recordFanoutPass, recordQueueMessages, recordSchemaVersion, relayCountFor, renderSql, resolveRankPartition, resolveRelationPredicates, resolveWith, rowToDocument, runDataMigration, runDrizzle, runExternalSourceTick, runReadonlySql, runRowValidators, runShardMigrations, runSocketPool, runSql, runTriggers, selectExpiredIds, selectExportTables, selectIndexForAggregate, selectIndexForCount, selectIndexForGroupBy, selectMatchingIds, selectShapeMemberIds, selectShapeRows, sendDeltaFrames, serializeSqlValue, shapeRoutingKey, softDeleteScope, sortColumnName, stableStringify, stableWireKey, subscriptionListDeltas, summarizeFanoutTopics, summarizeSubscriptions, tableColumns, tableFromDepKey, throwingScheduler, trimCdcChanges, trimIdempotent, tryRowToDocument, trySendFrame, validateImportRow, writeGlobalShapeSnapshot, writeIdempotent, writeSearchBackfillState, 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_META_TABLE, CLIENT_WATERMARK_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, 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 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, 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, 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, isRelationPredicate, isSoftDeleted, isSourceDue, jsonPath, jsonPathSql, keysTouchRanges, liftSourceId, lintReadonlySql, listTables, literalInList, matchesRankStaticWhere, matchesStaticWhere, materializeExternalRows, materializeExternalRowsIncremental, mergeChangedKeys, mergeWhere, migrateCdcLog, migrateCdcMeta, migrateClientWatermark, migrateDurableStreams, migrateGlobalShapeSnapshot, migrateIdempotency, 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, readAggregateValue, readAuditLog, readBookmark, readCapturedMail, readCdcChanges, readCdcCursor, readCdcEpoch, readClientWatermark, readExternalSourceBaseline, readGlobalShapeSnapshot, readIdempotent, readMigrationStatus, readQueueMessageById, readQueueMessages, 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, writeSearchBackfillState, writeShapePokeCursor, writeTouchesMemo };