@lunora/shard-engine 1.0.0-alpha.2 → 1.0.0-alpha.21

package/dist/conformance/index.mjs

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

package/dist/index.d.mts

@@ -1,6 +1,27 @@
 import { LunoraError } from '@lunora/errors';
 import { SQL, Name } from 'drizzle-orm';
 import { ShardHost, SocketHost, SocketHandle } from '@lunora/platform';
+interface KeyRange {
+  hi: string;
+  index: string;
+  lo: string;
+  table: string;
+}
+interface IndexKeyEntry {
+  index: string;
+  key: string;
+}
+interface StagedCondition {
+  comparator: string;
+  field: string;
+  value: unknown;
+}
+declare const buildIndexRange: (table: string, index: string, fields: ReadonlyArray<string>, conditions: ReadonlyArray<StagedCondition>, serialize: (value: unknown) => unknown) => KeyRange | undefined;
+declare const indexKeysForRow: (indexes: ReadonlyArray<{
+  fields: ReadonlyArray<string>;
+  name: string;
+}>, row: Record<string, unknown>, serialize: (value: unknown) => unknown) => IndexKeyEntry[];
+declare const keysTouchRanges: (ranges: ReadonlyArray<KeyRange> | undefined, keys: ReadonlyArray<IndexKeyEntry> | undefined) => boolean;
 type SystemTableName = "_scheduled_functions" | "_storage";
 interface ScheduledFunctionDoc {
   args: Record<string, unknown>;
@@ -209,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>;
   };
@@ -229,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;
@@ -338,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;
@@ -372,6 +414,7 @@ interface LifecycleDispatchInfo {
   userId: string | undefined;
 }
 interface MutationDelta {
+  indexKeys?: ReadonlyArray<IndexKeyEntry>;
   key: string;
   op: "insert" | "update" | "delete";
   row?: Record<string, unknown>;
@@ -536,6 +579,7 @@ interface CacheEntry {
   bytes: number;
   deps: Set<string>;
   lastUsed: number;
+  ranges: ReadonlyArray<KeyRange>;
   result: unknown;
   subscribers: Set<string>;
 }
@@ -547,6 +591,7 @@ interface ReactiveCacheOptions {
 declare class ReactiveCache {
   private readonly entries;
   private readonly tableIndex;
+  private readonly rangeIndex;
   private totalBytes;
   private hits;
   private misses;
@@ -556,8 +601,8 @@ declare class ReactiveCache {
   private readonly now;
   private monotonic;
   constructor(options?: ReactiveCacheOptions);
-  run<R>(key: string, deps: Set<string>, run: () => Promise<R>): Promise<R>;
-  invalidate(table: string, id: string): string[];
+  run<R>(key: string, deps: Set<string>, run: () => Promise<R>, ranges?: () => ReadonlyArray<KeyRange>): Promise<R>;
+  invalidate(table: string, id: string, indexKeys?: ReadonlyArray<IndexKeyEntry>): string[];
   invalidateTable(table: string): string[];
   subscribe(key: string, subscriberId: string): void;
   unsubscribe(key: string, subscriberId: string): void;
@@ -574,11 +619,37 @@ declare class ReactiveCache {
     hits: number;
     misses: number;
   };
+  private dropRangeDeps;
   private collectAndDrop;
+  private dropKeys;
   private dropEntry;
   private evict;
 }
 declare const reactiveCacheKey: (functionPath: string, args: Record<string, unknown>, identity: null | string) => string;
+interface TransactionLimits {
+  maxReadRows: number;
+  maxWrittenBytes: number;
+  maxWrittenRows: number;
+}
+interface TransactionHeadroom {
+  readRows: number;
+  remainingReadRows: number;
+  remainingWrittenBytes: number;
+  remainingWrittenRows: number;
+  writtenBytes: number;
+  writtenRows: number;
+}
+declare const DEFAULT_TRANSACTION_LIMITS: TransactionLimits;
+declare class TransactionHeadroomTracker {
+  private readRows;
+  private writtenRows;
+  private writtenBytes;
+  private readonly limits;
+  constructor(limits?: Partial<TransactionLimits>);
+  recordRead(count: number): void;
+  recordWrite(row: unknown): void;
+  headroom(): TransactionHeadroom;
+}
 interface RunTriggersOptions {
   ctx: TriggerContextLike;
   event: TriggerEventLike;
@@ -713,10 +784,12 @@ interface CtxDbOptions {
   clock?: Clock;
   enforceRls?: boolean;
   globalDb?: DatabaseWriterLike;
+  headroom?: TransactionHeadroomTracker;
   idGenerator?: IdGenerator;
   maxRelationKeys?: number;
   onIndexUse?: IndexUseHook;
   onRead?: ReadHook;
+  onReadRange?: (range: KeyRange) => void;
   onWrite?: WriteHook;
   relationExistsPushDown?: "always" | "auto" | "never";
   scheduler?: SchedulerLike;
@@ -816,7 +889,11 @@ interface ShardSocketLike {
 }
 interface CompanionSyncDeps {
   broadcast: (delta: MutationDelta) => void;
-  invalidateCache: (table: string, id: string) => void;
+  indexKeysFor: (table: string, document?: Record<string, unknown>) => ReadonlyArray<{
+    index: string;
+    key: string;
+  }> | undefined;
+  invalidateCache: (table: string, id: string, document?: Record<string, unknown>) => void;
   recordCdc: (table: string, id: string, op: "delete" | "insert" | "update", doc?: Record<string, unknown>) => void;
   schema: SchemaLike;
   sql: SqlExec;
@@ -856,7 +933,11 @@ 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;
@@ -911,10 +992,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;
@@ -1048,6 +1129,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";
@@ -1140,6 +1222,9 @@ interface TableIndexInfo {
 interface TableIndexesResult {
   indexes: TableIndexInfo[];
 }
+interface TablesIndexesResult {
+  indexesByTable: Record<string, TableIndexInfo[]>;
+}
 interface ColumnMeta {
   isStorage?: boolean;
   name: string;
@@ -1170,12 +1255,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;
@@ -1183,15 +1269,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[];
@@ -1533,7 +1619,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>) => {
@@ -1541,6 +1626,14 @@ 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;
+  ranges: () => Map<string, KeyRange[]> | undefined;
+  tables: Set<string>;
+}
+declare const createReadFootprint: () => ReadFootprint;
 declare const DEFAULT_MAX_RELATION_KEYS = 5000;
 interface RelationExistsMarker {
   childWhere: WhereInput;
@@ -1575,6 +1668,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>;
@@ -1679,15 +1773,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) => {
@@ -1723,7 +1812,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>;
@@ -1764,6 +1853,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;
@@ -1797,6 +1887,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;
@@ -1812,7 +1957,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;
@@ -1874,8 +2020,16 @@ 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;
+declare const sendDeltaFrames: (ws: FrameSink, subId: string, deltaFrames: ReadonlyArray<string>, cursorSuffix: string, lastMutationId?: number) => boolean;
 declare const awaitWsDrain: (ws: DrainableSink) => Promise<void>;
+interface SubscriptionReadFootprint {
+  ranges?: Map<string, KeyRange[]>;
+  tables: Set<string>;
+}
+type ChangedKeys = Map<string, IndexKeyEntry[] | undefined>;
+declare const mergeChangedKeys: (pending: ChangedKeys | undefined, incoming: ChangedKeys | undefined, changed: Set<string>) => ChangedKeys;
+declare const recordChangedKeys: (pending: ChangedKeys | undefined, table: string, indexKeys: ReadonlyArray<IndexKeyEntry> | undefined) => ChangedKeys;
+declare const writeTouchesMemo: (memo: SubscriptionReadFootprint, changed: Set<string>, changedKeys: ChangedKeys | undefined) => boolean;
 type ConflictKind = "conflict" | "occ" | "restrict" | "trigger" | "unique";
 declare class ConflictError extends LunoraError {
   readonly kind: ConflictKind;
@@ -1903,4 +2057,4 @@ interface WhereSqlStrategy {
   serialize: SerializeValue;
 }
 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 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, 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 IndexRangeBuilderLike, 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 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 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 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, buildPokeFrames, buildSeekBeforeWhere, buildSeekWhere, buildSettings, bumpCdcEpoch, clampPromotionThresholds, clearCapturedMail, clearQueueMessages, coerceAggregateNumber, compileWhereSql, computeRankPage, containsRelationPredicate, coveringGeohashes, createCompanionSync, createDependencyTracker, createFanoutCounters, createIndexSql, 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, isDevEnvironment, isFtsAvailable, isLossyBody, isRelationPredicate, isSoftDeleted, isSourceDue, jsonPath, jsonPathSql, liftSourceId, lintReadonlySql, listTables, matchesRankStaticWhere, matchesStaticWhere, materializeExternalRows, materializeExternalRowsIncremental, 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, 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 };
+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 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_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, 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, applyCdcChanges, applyOnDelete, applySelect, armRestore, assertFlatPredicate, assertReadonly, assertShapeShardable, assertValidClientId, awaitWsDrain, backfillAggregateIndexes, backfillRankIndexes, backfillSearchIndexes, backfillSearchIndexesForTable, boundingBoxCenter, boundingBoxGeohashes, buildIndexRange, buildPokeFrames, buildReprojectionMigration, buildSeekBeforeWhere, buildSeekWhere, buildSettings, bumpCdcEpoch, clampPromotionThresholds, clearCapturedMail, clearQueueMessages, coerceAggregateNumber, compileWhereSql, computeRankPage, containsRelationPredicate, countLegacyRows, coveringGeohashes, createCompanionSync, createDependencyTracker, createFanoutCounters, createIndexSql, createReadFootprint, createRelayLink, createReplicaLink, createShardCtxDb, createSystemReader, decodeCursor, deleteGlobalShapeSnapshot, deleteGlobalShapeSnapshotsForConnection, depKey, diffExternalSource, diffGlobalMembership, distinctValues, encodeAggregateKey, encodeCursor, encodeGeohash, encodePartitionKey, encodeRowsPatch, ensureAuditTable, ensureMailTable, exportShardRows, exportShardTable, facetColumn, fanOutScalarCounts, findStorageReferences, foldAggregateTally, gateReplicaDispatch, geoTableName, guardWriter, handleReplicaControl, 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, 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, sendDeltaFrames, serializeSqlValue, shapeRoutingKey, softDeleteScope, sortColumnName, stableStringify, stableWireKey, subscriptionListDeltas, summarizeFanoutTopics, summarizeSubscriptions, tableColumns, tableFromDepKey, throwingScheduler, trimCdcChanges, trimIdempotent, tryRowToDocument, trySendFrame, validateImportRow, writeGlobalShapeSnapshot, writeIdempotent, writeSearchBackfillState, writeTouchesMemo };