@lunora/do 1.0.0-alpha.37 → 1.0.0-alpha.39

package/dist/index.d.mts

@@ -1312,6 +1312,13 @@ interface SchemaLike {
 }
 interface TableDefinitionLike {
   readonly aggregateIndexes?: ReadonlyArray<AggregateIndexDefinitionLike>;
+  /**
+   * Mirror of `@lunora/server`'s `TableDefinition.geoIndexes` (set by
+   * `.geoIndex()`). Each declares a geohash companion over a `v.geoPoint()`
+   * column so `withGeoIndex(name, q => q.near(...) | q.within(...))` resolves
+   * proximity / bounding-box reads. Empty/absent ⇒ the table has no geo index.
+   */
+  readonly geoIndexes?: ReadonlyArray<GeoIndexDefinitionLike>;
   readonly indexes: ReadonlyArray<IndexDefinitionLike>;
   /**
    * `true` when `.public()` opted this table OUT of secure-by-default RLS
@@ -1339,6 +1346,15 @@ interface TableDefinitionLike {
     field: string;
   };
   readonly triggerMap?: Record<string, TriggerDefinitionLike>;
+  /**
+   * Mirror of `@lunora/server`'s `TableDefinition.ttlPolicy` (set by `.ttl()`).
+   * Drives the DO alarm-driven expiry sweep — see `ttl-sweep.ts`. Absent ⇒ rows
+   * never auto-expire.
+   */
+  readonly ttlPolicy?: {
+    after?: number;
+    field: string;
+  };
 }
 interface IndexDefinitionLike {
   readonly fields: ReadonlyArray<string>;
@@ -1350,6 +1366,12 @@ interface SearchIndexDefinitionLike {
   readonly filterFields?: ReadonlyArray<string>;
   readonly name: string;
 }
+/** Mirror of `@lunora/server`'s `GeoIndexDefinition` — a geohash companion over a `v.geoPoint()` column. */
+interface GeoIndexDefinitionLike {
+  readonly field: string;
+  readonly name: string;
+  readonly precision?: number;
+}
 /**
  * Column constraints/defaults the write layer honors, mirrored structurally
  * from `@lunora/values`' `ColumnMeta` (kept local so this package doesn't take
@@ -1423,7 +1445,7 @@ type ReadHook = (table: string, idOrScan?: string) => void;
  * No-op by default; called at most once per read (not per row), so it adds no
  * meaningful hot-path cost.
  */
-type IndexUseHook = (table: string, indexName: string, kind: "index" | "rank" | "search") => void;
+type IndexUseHook = (table: string, indexName: string, kind: "geo" | "index" | "rank" | "search") => void;
 /** Pluggable wall clock — defaults to `Date.now`. */
 type Clock = () => number;
 /** Pluggable ID minter — defaults to `crypto.randomUUID()`. */
@@ -1566,6 +1588,22 @@ interface SearchFilterBuilderLike {
   eq: (field: string, value: unknown) => SearchFilterBuilderLike;
   search: (field: string, query: string) => SearchFilterBuilderLike;
 }
+interface GeoFilterBuilderLike {
+  near: (point: {
+    lat: number;
+    lng: number;
+  }, radiusMeters: number) => GeoFilterBuilderLike;
+  within: (box: {
+    ne: {
+      lat: number;
+      lng: number;
+    };
+    sw: {
+      lat: number;
+      lng: number;
+    };
+  }) => GeoFilterBuilderLike;
+}
 /** Options accepted by {@link TableReaderLike.paginate} — Convex-compatible. */
 interface PaginationOptions {
   /** Opaque cursor from a prior page's `continueCursor`; `null`/omitted starts at the first page. */
@@ -1603,6 +1641,7 @@ interface TableReaderLike {
    * more than one matches. Mirrors Convex's `.unique()`.
    */
   unique: () => Promise<Record<string, unknown> | null>;
+  withGeoIndex: (indexName: string, build: (q: GeoFilterBuilderLike) => GeoFilterBuilderLike) => TableReaderLike;
   withIndex: (indexName: string, range?: (q: IndexRangeBuilderLike) => IndexRangeBuilderLike) => TableReaderLike;
   withSearchIndex: (indexName: string, search: (q: SearchFilterBuilderLike) => SearchFilterBuilderLike) => TableReaderLike;
 }
@@ -2218,6 +2257,13 @@ interface MetricEvent {
   name: string;
   /** Shard key for single-shard calls; absent for the unnamed root DO. */
   shardKey?: string;
+  /**
+   * Trace id of the dispatch that recorded this measurement, when it ran inside
+   * one — the measurement's **exemplar**, letting a consumer jump from a metric
+   * point to a trace that produced it (OpenTelemetry's exemplar model). Stamped
+   * by the shard from the current request's trace context, not by the caller.
+   */
+  traceId?: string;
   /** Wall-clock millis when the measurement was recorded. */
   ts: number;
   /**
@@ -2235,6 +2281,21 @@ interface MetricEvent {
  * (32-hex trace, 16-hex span), so a `SpanEvent` composes into an OTLP span with
  * no reformatting.
  */
+/**
+ * Handle the enclosing `ctx.trace` span hands its body, so the body can attach
+ * attributes only known *after* it resolves — an AI call's token usage or dollar
+ * cost, a downstream response's status, a computed row count. The start
+ * attributes passed to `ctx.trace(name, fn, attributes)` are snapshotted before
+ * the body runs (so a mid-span mutation can't rewrite them); anything set through
+ * this handle is merged over that snapshot at record time, with the post-hoc
+ * value winning on a key clash.
+ */
+interface SpanHandle {
+  /** Set one attribute on the enclosing span (merged at record time; post-hoc wins on key clash). */
+  setAttribute: (key: string, value: LogFields[string]) => void;
+  /** Merge attributes onto the enclosing span (post-hoc wins on key clash). */
+  setAttributes: (fields: LogFields) => void;
+}
 interface SpanEvent {
   /**
    * Structured attributes the caller attached, already normalized to a fresh
@@ -2300,8 +2361,12 @@ interface SpanEvent {
  * `LunoraTracer`). Declared here rather than imported so `@lunora/do` takes no
  * dependency on `@lunora/server`; a cross-package assignability guard in
  * `@lunora/testing` fails the build if the two drift apart.
+ *
+ * The body's second argument is the enclosing span's {@link SpanHandle}, through
+ * which it can attach attributes only known *after* it resolves (post-hoc). It is
+ * a trailing parameter, so a `(trace) => …` body that ignores it still conforms.
  */
-type ContextTracer = <T>(name: string, function_: (trace: ContextTracer) => Promise<T> | T, attributes?: LogFields) => Promise<T>;
+type ContextTracer = <T>(name: string, function_: (trace: ContextTracer, span: SpanHandle) => Promise<T> | T, attributes?: LogFields) => Promise<T>;
 /** Structural shape of the `ctx.metrics` recorder (see the server `LunoraMetrics`). */
 interface ContextMetrics {
   count: (name: string, value?: number, attributes?: LogFields) => void;
@@ -2775,6 +2840,7 @@ declare const ADMIN_FUNCTIONS: {
   readonly getFanoutMetrics: "__lunora_admin__:getFanoutMetrics";
   readonly getFunctionStats: "__lunora_admin__:getFunctionStats";
   readonly getIssues: "__lunora_admin__:getIssues";
+  readonly getMetricHistory: "__lunora_admin__:getMetricHistory";
   readonly getMetricSeries: "__lunora_admin__:getMetricSeries";
   readonly listSubscriptions: "__lunora_admin__:listSubscriptions";
   readonly listTableIndexes: "__lunora_admin__:listTableIndexes";
@@ -2899,7 +2965,7 @@ interface FunctionCallStat {
 interface TableIndexInfo {
   fields: string[];
   name: string;
-  type: "index" | "rank" | "search" | "vector";
+  type: "geo" | "index" | "rank" | "search" | "vector";
   unique?: boolean;
 }
 /** Payload of a `__lunora_admin__:listTableIndexes` call: every declared index on the table. */
@@ -3079,7 +3145,12 @@ interface StudioFeaturesResult {
   kv: boolean;
   /** `@lunora/mail` is imported by a `lunora/` source or a declared dependency. */
   mail: boolean;
-  /** `@lunora/payment` is used (import or `ctx.payments`) or a declared dependency. */
+  /**
+   * `@lunora/payment` is used (import or `ctx.payments`), or the app declares the store's
+   * `subscriptions`/`events` tables that the Payments panel reads. Unlike the other flags this
+   * has no declared-dependency arm: the panel queries those tables directly, so a bare dependency
+   * (e.g. reusing the package's pure webhook helpers) must not show a page that would then error.
+   */
   payments: boolean;
   /** `@lunora/queue` / `ctx.queues` is used, the app declares queues, or it is a declared dependency. */
   queues: boolean;
@@ -3543,6 +3614,39 @@ declare const readFunctionMetricsTotals: (sql: SqlExec) => {
   errors: number;
   requests: number;
 };
+/** Default geohash precision (characters) maintained by a `.geoIndex()` companion — ~4.8 m cells. */
+declare const GEO_DEFAULT_PRECISION = 9;
+/** A latitude/longitude point (WGS84 decimal degrees). */
+interface GeoPoint {
+  lat: number;
+  lng: number;
+}
+/** An axis-aligned latitude/longitude bounding box (`sw`/`ne` corners). */
+interface GeoBoundingBox {
+  ne: GeoPoint;
+  sw: GeoPoint;
+}
+/**
+ * Encode `point` to a geohash of `precision` characters. Standard interleaved
+ * lat/lng bisection over the base-32 alphabet.
+ */
+declare const encodeGeohash: (point: GeoPoint, precision: number) => string;
+/** Great-circle distance between two points in metres (Haversine). */
+declare const haversineMeters: (a: GeoPoint, b: GeoPoint) => number;
+/**
+ * The center cell plus its eight neighbours at a precision chosen so each cell is
+ * at least `radiusMeters` wide — the geohash prefixes to range-scan for a
+ * proximity query. Deduplicated (near a pole neighbours can collapse).
+ */
+declare const coveringGeohashes: (center: GeoPoint, radiusMeters: number) => string[];
+/** Whether `point` falls inside `box` (inclusive edges). */
+declare const pointInBoundingBox: (point: GeoPoint, box: GeoBoundingBox) => boolean;
+/**
+ * Geohash prefixes covering `box`: the covering cells of the circle centered on
+ * the box whose radius reaches the north-east corner, guaranteeing every point
+ * in the box is scanned before the exact `pointInBoundingBox` refine.
+ */
+declare const boundingBoxGeohashes: (box: GeoBoundingBox) => string[];
 /**
  * Severity of a `ctx.log.*` call. The five console method names (`log` is the
  * default level, distinct from `info`) plus `trace`/`fatal`, so the logger spans
@@ -4152,6 +4256,28 @@ declare class SessionDO {
   private handleGet;
   private handleRevoke;
 }
+/** One table's resolved TTL policy, as surfaced to the DO alarm by the generated shard subclass. */
+interface TtlSweepSpec {
+  /** Millisecond offset added to `field` to derive the expiry (`field + after`); absent ⇒ `field` is the absolute expiry. */
+  after?: number;
+  /** The epoch-millisecond expiry column. */
+  field: string;
+  /** The `.softDelete()` marker column, when the table soft-deletes — expired-but-already-tombstoned rows are skipped. */
+  softDeleteField?: string;
+  /** The table whose expired rows are swept. */
+  table: string;
+}
+/**
+ * Select up to `limit` ids of rows in `spec.table` whose TTL expired at `now`
+ * (i.e. `field + (after ?? 0) < now`). `hasMore` is `true` when matches remained
+ * beyond `limit`, so the caller can loop a bounded batch. When `spec.softDeleteField`
+ * is set, rows already soft-deleted (marker non-null) are excluded so the sweep
+ * never re-touches a tombstone.
+ */
+declare const selectExpiredIds: (sql: SqlExec, spec: TtlSweepSpec, now: number, limit: number) => {
+  hasMore: boolean;
+  ids: string[];
+};
 /**
  * Diff the previously-sent list snapshot (`previousJson`, the memo's
  * `lastJson`) against the new query result and produce per-row
@@ -5631,6 +5757,35 @@ declare abstract class ShardDO {
    * no-op when the runtime exposes no `setAlarm` (unit harness).
    */
   protected scheduleSourcePoll(): Promise<void>;
+  /**
+   * The resolved TTL policies (`.ttl(field, { after })`) for this DO's schema —
+   * one {@link TtlSweepSpec} per table that declares a TTL. The base `ShardDO`
+   * has no schema, so it returns `[]` and the TTL tier stays dormant. The
+   * codegen subclass overrides it to read each table's `ttlPolicy` (+ its
+   * `.softDelete()` marker) off the imported schema.
+   */
+  protected ttlSweeps(): ReadonlyArray<TtlSweepSpec>;
+  /**
+   * Sweep every `.ttl()` table once: page the rows past their expiry and remove
+   * each THROUGH the schema-aware writer (`deleteRowThroughWriter`) so companions
+   * / CDC / live subscriptions stay correct and a `.softDelete()` table soft-deletes
+   * instead of physically removing the row. Work is bounded per tick
+   * ({@link TTL_SWEEP_BATCH} × {@link TTL_SWEEP_MAX_BATCHES}) so a large backlog
+   * drains across several alarms without stalling the shard.
+   *
+   * Returns the next-due timestamp (a coarse {@link TTL_SWEEP_INTERVAL_MS}
+   * cadence, so freshly-written rows expire within a bounded window) while any
+   * TTL table exists, or `undefined` when there are none — so a DO with no TTL
+   * table never arms this tier.
+   */
+  protected pollTtlSweeps(): Promise<number | undefined>;
+  /**
+   * Arm the shared poll alarm for the TTL sweep. Mirrors {@link scheduleSourcePoll};
+   * the codegen subclass calls it once on construction when the schema declares a
+   * `.ttl()` table so the sweep loop starts, after which {@link ShardDO.alarm}
+   * re-arms itself. Idempotent; a no-op when the runtime exposes no `setAlarm`.
+   */
+  protected scheduleTtlSweep(): Promise<void>;
   /** This DO's shard key (its DO name), or `__root__` for the single-DO default. The `tenantBy` mapper binds it into the source query. */
   protected currentShardKey(): string;
   /** Record a contained external-source ingest failure (one sourced table's poll) into the log ring without aborting the others. */
@@ -7083,4 +7238,4 @@ interface WhereSqlStrategy {
  * `undefined` when the input imposes no constraint (empty `where`).
  */
 declare const compileWhereSql: (where: WhereInput | undefined, strategy: WhereSqlStrategy) => SQL | undefined;
-export { ADMIN_FUNCTIONS, ADMIN_FUNCTION_PREFIX, AGGREGATE_SQL_FUNCTION, AUTH_METRICS_BUCKETS_TABLE, AUTH_METRICS_BUCKET_MS, AUTH_METRICS_BUCKET_RETENTION, AUTH_METRICS_TABLE, type AdvisoriesResult, type AdvisoryFinding, type AggregateIndexDefinitionLike, type AggregateOp, type AggregateOptions, type AggregateResult, type AggregateTally, type ApplyOnDeleteOptions, type AuditEntry, type AuditLogResult, type AuthMetrics, type AuthMetricsBucket, type BroadcastDelta, CDC_LOG_TABLE, type CacheEntry, type CapturedMailRow, type CdcChange, type Clock, type ColumnMeta, type ColumnMetaLike, ConflictError, type ContextMetrics, type ContextTracer, type CountArgs, CountRlsUnsupportedError, type CtxDbOptions, DATA_MIGRATION_STATE_TABLE, DEFAULT_MAX_RELATION_KEYS, 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, FUNCTION_METRICS_BUCKETS_TABLE, FUNCTION_METRICS_BUCKET_MS, FUNCTION_METRICS_BUCKET_RETENTION, FUNCTION_METRICS_INDEX_TABLE, FUNCTION_METRICS_TABLE, type FacetColumnOptions, type FacetColumnResult, type FacetValue, type FieldOperators, type FlagEvaluation, type FlagsResult, type FunctionCallStat, type FunctionMetricBucket, type FunctionMetricIndexHit, type FunctionStatsResult, type GroupByEntry, type GroupByOptions, type HibernatableWebSocket, type IdGenerator, type ImportError, type ImportShardAdminArgs, type ImportShardArgs, type ImportShardResult, type IncrementalMaterializeResult, type IndexDefinitionLike, type IndexRangeBuilderLike, LogBuffer, type LogEntry, type LogEventInput, type LogLevel, type LogSink, MAIL_RETENTION, MAIL_TABLE, MAX_SQL_ROWS, MIN_ADMIN_TOKEN_LENGTH, MIN_AUTH_SECRET_LENGTH, type MaskColumnMetadata, type MaskPoliciesResult, type MaterializeResult, type MetricsDeps, type MigrationDirection, type MigrationRunResult, type MigrationStatus, type MigrationStatusRow, type MutationDelta, type NestedWith, NotFoundError, NotUniqueError, type OnDeleteActionLike, type OrderByInput, type OrderKey, type PaginationOptions, type PitrBookmarkResult, type PitrRestoreArgs, type PitrRestoreResult, type PitrStorage, type QueryArgs, type QueryPage, type QueueMetadata, type QueuesResult, RANK_TIEBREAK, RELATION_FUNCTION_PREFIX, RLS_UNWRAP_SYMBOL, ROOT_DO_SIZE_WARN_BYTES, ROOT_SHARD_NAME, type RankDirection, type RankIndexDefinitionLike, type RankOptions, type RankPage, type RankPageOptions, type RankPageRow, type RankPageRowKey, type RankResult, type RankSortKeyLike, ReactiveCache, type ReactiveCacheOptions, type ReadHook, type ReadTablePageOptions, type RecordAuthEventInput, type RecordFunctionMetricInput, type RecordMailInput, type RelationDefinitionLike, type RenderedSql, type ResolveRelationPredicatesOptions, type ResolveWithOptions, type RestrictableQueryOptions, type RlsPoliciesResult, type RlsPolicyMetadata, RlsRequiredError, type RlsRoleMetadata, type RpcRequest, type RunDataMigrationOptions, type RunShardApplyCdcArgs, type RunShardApplyCdcResult, type RunShardBulkDeleteArgs, type RunShardBulkDeleteResult, type RunShardExportArgs, type RunShardImportArgs, type RunShardMigrationArgs, type RunShardRankBeforeArgs, type RunShardRankPageArgs, type RunShardWriteArgs, type RunShardWriteResult, type RunTriggersOptions, SCAN_DEP, SESSION_DO_TTL_DEFAULT, SHARD_REGISTRY_DO_NAME, type SchedulableWorkflowReferenceLike, type ScheduledFunctionDoc, type SchedulerLike, type SchemaLike, type SearchFilterBuilderLike, type SecurityAuditResult, type SecurityFinding, type SecurityFindingKind, type SecurityFindingLevel, type SelectMatchingIdsOptions, type ServerDefaultContextLike, SessionDO, type SessionRecord, type SettingEntry, type SettingKind, type SettingsResult, type ShapeSubscriptionQuery, ShardDO, type ShardDOOptions, type ShardDOState, type ShardRankPageResult, ShardRegistryDO, type SocketAttachment, type SortDirection, type SourceClientLike, type SourceCursorLike, type SourceRefresh, type SqlConsoleResult, type SqlCursor, type SqlEngine, type SqlExec, type StorageRuleMetadata, type StorageRulesResult, type StudioFeaturesResult, type SubscriptionEnvelope, type SubscriptionOutcome, type SubscriptionQuery, 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 TelemetrySink, type TraceAnchor, type TracerDeps, type TransactionSqlLike, type TriggerContextLike, type TriggerDefinitionLike, type TriggerEventLike, type TriggerOpLike, type TriggerTimingLike, type ValidatorLike, type WhereInput, type WhereSqlStrategy, type WithInput, type WorkflowMetadata, type WorkflowsResult, type WriteEvent, type WriteHook, aggregateSqlFunction, aggregateTableName, applyCdcChanges, applyOnDelete, applySelect, armRestore, assertFlatPredicate, assertReadonly, assertShapeShardable, assertValidClientId, backfillAggregateIndexes, backfillRankIndexes, buildFtsMatch, buildSecurityAudit, buildSeekWhere, clearCapturedMail, coerceAggregateNumber, compileWhereSql, containsRelationPredicate, createDependencyTracker, createMetrics, createShardCtxDb, createSystemReader, createTracer, decodeCursor, depKey, diffExternalSource, dispatchRootSpan, encodeAggregateKey, encodeCursor, encodePartitionKey, ensureAuthMetricsTables, ensureFunctionMetricsTables, ensureMailTable, exportShardRows, exportShardTable, facetColumn, fanOutScalarCounts, foldAggregateTally, ftsTableName, guardWriter, hasTrigger, importShardRows, isRelationPredicate, isSoftDeleted, isSourceDue, liftSourceId, listTables, matchesRankStaticWhere, matchesStaticWhere, materializeExternalRows, materializeExternalRowsIncremental, mergeWhere, normalizeCountArgument, normalizeIdStructurally, normalizeOrderKeys, parseExportShardArgs, parseImportShardArgs, planAggregateLookup, pullExternalSourceIncrementalTick, pullExternalSourceTick, rankTableName, reactiveCacheKey, readAggregateValue, readAuthMetrics, readBookmark, readCapturedMail, readCdcChanges, readExternalSourceBaseline, readFunctionMetricBuckets, readFunctionMetricIndexHits, readFunctionMetrics, readFunctionMetricsTotals, readMigrationStatus, readTablePage, recordAuthEvent, recordCapturedMail, recordFunctionMetric, renderSql, resolveRankPartition, resolveRelationPredicates, resolveWith, runDataMigration, runExternalSourceTick, runReadonlySql, runRowValidators, runShardMigrations, runTriggers, scoreDocument, selectExportTables, selectIndexForAggregate, selectIndexForCount, selectIndexForGroupBy, selectMatchingIds, serveRelationFanout, softDeleteScope, sortColumnName, stableStringify, stableWireKey, stringifySearchText, subscriptionListDeltas, throwingScheduler, tokenizeSearch, trimCdcChanges, validateImportRow };
+export { ADMIN_FUNCTIONS, ADMIN_FUNCTION_PREFIX, AGGREGATE_SQL_FUNCTION, AUTH_METRICS_BUCKETS_TABLE, AUTH_METRICS_BUCKET_MS, AUTH_METRICS_BUCKET_RETENTION, AUTH_METRICS_TABLE, type AdvisoriesResult, type AdvisoryFinding, type AggregateIndexDefinitionLike, type AggregateOp, type AggregateOptions, type AggregateResult, type AggregateTally, type ApplyOnDeleteOptions, type AuditEntry, type AuditLogResult, type AuthMetrics, type AuthMetricsBucket, type BroadcastDelta, CDC_LOG_TABLE, type CacheEntry, type CapturedMailRow, type CdcChange, type Clock, type ColumnMeta, type ColumnMetaLike, ConflictError, type ContextMetrics, type ContextTracer, type CountArgs, CountRlsUnsupportedError, type CtxDbOptions, DATA_MIGRATION_STATE_TABLE, DEFAULT_MAX_RELATION_KEYS, 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, FUNCTION_METRICS_BUCKETS_TABLE, FUNCTION_METRICS_BUCKET_MS, FUNCTION_METRICS_BUCKET_RETENTION, FUNCTION_METRICS_INDEX_TABLE, FUNCTION_METRICS_TABLE, type FacetColumnOptions, type FacetColumnResult, type FacetValue, type FieldOperators, type FlagEvaluation, type FlagsResult, type FunctionCallStat, type FunctionMetricBucket, type FunctionMetricIndexHit, type FunctionStatsResult, GEO_DEFAULT_PRECISION, type GeoBoundingBox, type GeoFilterBuilderLike, type GeoIndexDefinitionLike, type GeoPoint, type GroupByEntry, type GroupByOptions, type HibernatableWebSocket, type IdGenerator, type ImportError, type ImportShardAdminArgs, type ImportShardArgs, type ImportShardResult, type IncrementalMaterializeResult, type IndexDefinitionLike, type IndexRangeBuilderLike, LogBuffer, type LogEntry, type LogEventInput, type LogLevel, type LogSink, MAIL_RETENTION, MAIL_TABLE, MAX_SQL_ROWS, MIN_ADMIN_TOKEN_LENGTH, MIN_AUTH_SECRET_LENGTH, type MaskColumnMetadata, type MaskPoliciesResult, type MaterializeResult, type MetricsDeps, type MigrationDirection, type MigrationRunResult, type MigrationStatus, type MigrationStatusRow, type MutationDelta, type NestedWith, NotFoundError, NotUniqueError, type OnDeleteActionLike, type OrderByInput, type OrderKey, type PaginationOptions, type PitrBookmarkResult, type PitrRestoreArgs, type PitrRestoreResult, type PitrStorage, type QueryArgs, type QueryPage, type QueueMetadata, type QueuesResult, RANK_TIEBREAK, RELATION_FUNCTION_PREFIX, RLS_UNWRAP_SYMBOL, ROOT_DO_SIZE_WARN_BYTES, ROOT_SHARD_NAME, type RankDirection, type RankIndexDefinitionLike, type RankOptions, type RankPage, type RankPageOptions, type RankPageRow, type RankPageRowKey, type RankResult, type RankSortKeyLike, ReactiveCache, type ReactiveCacheOptions, type ReadHook, type ReadTablePageOptions, type RecordAuthEventInput, type RecordFunctionMetricInput, type RecordMailInput, type RelationDefinitionLike, type RenderedSql, type ResolveRelationPredicatesOptions, type ResolveWithOptions, type RestrictableQueryOptions, type RlsPoliciesResult, type RlsPolicyMetadata, RlsRequiredError, type RlsRoleMetadata, type RpcRequest, type RunDataMigrationOptions, type RunShardApplyCdcArgs, type RunShardApplyCdcResult, type RunShardBulkDeleteArgs, type RunShardBulkDeleteResult, type RunShardExportArgs, type RunShardImportArgs, type RunShardMigrationArgs, type RunShardRankBeforeArgs, type RunShardRankPageArgs, type RunShardWriteArgs, type RunShardWriteResult, type RunTriggersOptions, SCAN_DEP, SESSION_DO_TTL_DEFAULT, SHARD_REGISTRY_DO_NAME, type SchedulableWorkflowReferenceLike, type ScheduledFunctionDoc, type SchedulerLike, type SchemaLike, type SearchFilterBuilderLike, type SecurityAuditResult, type SecurityFinding, type SecurityFindingKind, type SecurityFindingLevel, type SelectMatchingIdsOptions, type ServerDefaultContextLike, SessionDO, type SessionRecord, type SettingEntry, type SettingKind, type SettingsResult, type ShapeSubscriptionQuery, ShardDO, type ShardDOOptions, type ShardDOState, type ShardRankPageResult, ShardRegistryDO, type SocketAttachment, type SortDirection, type SourceClientLike, type SourceCursorLike, type SourceRefresh, type SpanHandle, type SqlConsoleResult, type SqlCursor, type SqlEngine, type SqlExec, type StorageRuleMetadata, type StorageRulesResult, type StudioFeaturesResult, type SubscriptionEnvelope, type SubscriptionOutcome, type SubscriptionQuery, 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 TelemetrySink, type TraceAnchor, type TracerDeps, type TransactionSqlLike, type TriggerContextLike, type TriggerDefinitionLike, type TriggerEventLike, type TriggerOpLike, type TriggerTimingLike, type TtlSweepSpec, type ValidatorLike, type WhereInput, type WhereSqlStrategy, type WithInput, type WorkflowMetadata, type WorkflowsResult, type WriteEvent, type WriteHook, aggregateSqlFunction, aggregateTableName, applyCdcChanges, applyOnDelete, applySelect, armRestore, assertFlatPredicate, assertReadonly, assertShapeShardable, assertValidClientId, backfillAggregateIndexes, backfillRankIndexes, boundingBoxGeohashes, buildFtsMatch, buildSecurityAudit, buildSeekWhere, clearCapturedMail, coerceAggregateNumber, compileWhereSql, containsRelationPredicate, coveringGeohashes, createDependencyTracker, createMetrics, createShardCtxDb, createSystemReader, createTracer, decodeCursor, depKey, diffExternalSource, dispatchRootSpan, encodeAggregateKey, encodeCursor, encodeGeohash, encodePartitionKey, ensureAuthMetricsTables, ensureFunctionMetricsTables, ensureMailTable, exportShardRows, exportShardTable, facetColumn, fanOutScalarCounts, foldAggregateTally, ftsTableName, guardWriter, hasTrigger, haversineMeters, importShardRows, isRelationPredicate, isSoftDeleted, isSourceDue, liftSourceId, listTables, matchesRankStaticWhere, matchesStaticWhere, materializeExternalRows, materializeExternalRowsIncremental, mergeWhere, normalizeCountArgument, normalizeIdStructurally, normalizeOrderKeys, parseExportShardArgs, parseImportShardArgs, planAggregateLookup, pointInBoundingBox, pullExternalSourceIncrementalTick, pullExternalSourceTick, rankTableName, reactiveCacheKey, readAggregateValue, readAuthMetrics, readBookmark, readCapturedMail, readCdcChanges, readExternalSourceBaseline, readFunctionMetricBuckets, readFunctionMetricIndexHits, readFunctionMetrics, readFunctionMetricsTotals, readMigrationStatus, readTablePage, recordAuthEvent, recordCapturedMail, recordFunctionMetric, renderSql, resolveRankPartition, resolveRelationPredicates, resolveWith, runDataMigration, runExternalSourceTick, runReadonlySql, runRowValidators, runShardMigrations, runTriggers, scoreDocument, selectExpiredIds, selectExportTables, selectIndexForAggregate, selectIndexForCount, selectIndexForGroupBy, selectMatchingIds, serveRelationFanout, softDeleteScope, sortColumnName, stableStringify, stableWireKey, stringifySearchText, subscriptionListDeltas, throwingScheduler, tokenizeSearch, trimCdcChanges, validateImportRow };

package/dist/index.d.ts

@@ -1312,6 +1312,13 @@ interface SchemaLike {
 }
 interface TableDefinitionLike {
   readonly aggregateIndexes?: ReadonlyArray<AggregateIndexDefinitionLike>;
+  /**
+   * Mirror of `@lunora/server`'s `TableDefinition.geoIndexes` (set by
+   * `.geoIndex()`). Each declares a geohash companion over a `v.geoPoint()`
+   * column so `withGeoIndex(name, q => q.near(...) | q.within(...))` resolves
+   * proximity / bounding-box reads. Empty/absent ⇒ the table has no geo index.
+   */
+  readonly geoIndexes?: ReadonlyArray<GeoIndexDefinitionLike>;
   readonly indexes: ReadonlyArray<IndexDefinitionLike>;
   /**
    * `true` when `.public()` opted this table OUT of secure-by-default RLS
@@ -1339,6 +1346,15 @@ interface TableDefinitionLike {
     field: string;
   };
   readonly triggerMap?: Record<string, TriggerDefinitionLike>;
+  /**
+   * Mirror of `@lunora/server`'s `TableDefinition.ttlPolicy` (set by `.ttl()`).
+   * Drives the DO alarm-driven expiry sweep — see `ttl-sweep.ts`. Absent ⇒ rows
+   * never auto-expire.
+   */
+  readonly ttlPolicy?: {
+    after?: number;
+    field: string;
+  };
 }
 interface IndexDefinitionLike {
   readonly fields: ReadonlyArray<string>;
@@ -1350,6 +1366,12 @@ interface SearchIndexDefinitionLike {
   readonly filterFields?: ReadonlyArray<string>;
   readonly name: string;
 }
+/** Mirror of `@lunora/server`'s `GeoIndexDefinition` — a geohash companion over a `v.geoPoint()` column. */
+interface GeoIndexDefinitionLike {
+  readonly field: string;
+  readonly name: string;
+  readonly precision?: number;
+}
 /**
  * Column constraints/defaults the write layer honors, mirrored structurally
  * from `@lunora/values`' `ColumnMeta` (kept local so this package doesn't take
@@ -1423,7 +1445,7 @@ type ReadHook = (table: string, idOrScan?: string) => void;
  * No-op by default; called at most once per read (not per row), so it adds no
  * meaningful hot-path cost.
  */
-type IndexUseHook = (table: string, indexName: string, kind: "index" | "rank" | "search") => void;
+type IndexUseHook = (table: string, indexName: string, kind: "geo" | "index" | "rank" | "search") => void;
 /** Pluggable wall clock — defaults to `Date.now`. */
 type Clock = () => number;
 /** Pluggable ID minter — defaults to `crypto.randomUUID()`. */
@@ -1566,6 +1588,22 @@ interface SearchFilterBuilderLike {
   eq: (field: string, value: unknown) => SearchFilterBuilderLike;
   search: (field: string, query: string) => SearchFilterBuilderLike;
 }
+interface GeoFilterBuilderLike {
+  near: (point: {
+    lat: number;
+    lng: number;
+  }, radiusMeters: number) => GeoFilterBuilderLike;
+  within: (box: {
+    ne: {
+      lat: number;
+      lng: number;
+    };
+    sw: {
+      lat: number;
+      lng: number;
+    };
+  }) => GeoFilterBuilderLike;
+}
 /** Options accepted by {@link TableReaderLike.paginate} — Convex-compatible. */
 interface PaginationOptions {
   /** Opaque cursor from a prior page's `continueCursor`; `null`/omitted starts at the first page. */
@@ -1603,6 +1641,7 @@ interface TableReaderLike {
    * more than one matches. Mirrors Convex's `.unique()`.
    */
   unique: () => Promise<Record<string, unknown> | null>;
+  withGeoIndex: (indexName: string, build: (q: GeoFilterBuilderLike) => GeoFilterBuilderLike) => TableReaderLike;
   withIndex: (indexName: string, range?: (q: IndexRangeBuilderLike) => IndexRangeBuilderLike) => TableReaderLike;
   withSearchIndex: (indexName: string, search: (q: SearchFilterBuilderLike) => SearchFilterBuilderLike) => TableReaderLike;
 }
@@ -2218,6 +2257,13 @@ interface MetricEvent {
   name: string;
   /** Shard key for single-shard calls; absent for the unnamed root DO. */
   shardKey?: string;
+  /**
+   * Trace id of the dispatch that recorded this measurement, when it ran inside
+   * one — the measurement's **exemplar**, letting a consumer jump from a metric
+   * point to a trace that produced it (OpenTelemetry's exemplar model). Stamped
+   * by the shard from the current request's trace context, not by the caller.
+   */
+  traceId?: string;
   /** Wall-clock millis when the measurement was recorded. */
   ts: number;
   /**
@@ -2235,6 +2281,21 @@ interface MetricEvent {
  * (32-hex trace, 16-hex span), so a `SpanEvent` composes into an OTLP span with
  * no reformatting.
  */
+/**
+ * Handle the enclosing `ctx.trace` span hands its body, so the body can attach
+ * attributes only known *after* it resolves — an AI call's token usage or dollar
+ * cost, a downstream response's status, a computed row count. The start
+ * attributes passed to `ctx.trace(name, fn, attributes)` are snapshotted before
+ * the body runs (so a mid-span mutation can't rewrite them); anything set through
+ * this handle is merged over that snapshot at record time, with the post-hoc
+ * value winning on a key clash.
+ */
+interface SpanHandle {
+  /** Set one attribute on the enclosing span (merged at record time; post-hoc wins on key clash). */
+  setAttribute: (key: string, value: LogFields[string]) => void;
+  /** Merge attributes onto the enclosing span (post-hoc wins on key clash). */
+  setAttributes: (fields: LogFields) => void;
+}
 interface SpanEvent {
   /**
    * Structured attributes the caller attached, already normalized to a fresh
@@ -2300,8 +2361,12 @@ interface SpanEvent {
  * `LunoraTracer`). Declared here rather than imported so `@lunora/do` takes no
  * dependency on `@lunora/server`; a cross-package assignability guard in
  * `@lunora/testing` fails the build if the two drift apart.
+ *
+ * The body's second argument is the enclosing span's {@link SpanHandle}, through
+ * which it can attach attributes only known *after* it resolves (post-hoc). It is
+ * a trailing parameter, so a `(trace) => …` body that ignores it still conforms.
  */
-type ContextTracer = <T>(name: string, function_: (trace: ContextTracer) => Promise<T> | T, attributes?: LogFields) => Promise<T>;
+type ContextTracer = <T>(name: string, function_: (trace: ContextTracer, span: SpanHandle) => Promise<T> | T, attributes?: LogFields) => Promise<T>;
 /** Structural shape of the `ctx.metrics` recorder (see the server `LunoraMetrics`). */
 interface ContextMetrics {
   count: (name: string, value?: number, attributes?: LogFields) => void;
@@ -2775,6 +2840,7 @@ declare const ADMIN_FUNCTIONS: {
   readonly getFanoutMetrics: "__lunora_admin__:getFanoutMetrics";
   readonly getFunctionStats: "__lunora_admin__:getFunctionStats";
   readonly getIssues: "__lunora_admin__:getIssues";
+  readonly getMetricHistory: "__lunora_admin__:getMetricHistory";
   readonly getMetricSeries: "__lunora_admin__:getMetricSeries";
   readonly listSubscriptions: "__lunora_admin__:listSubscriptions";
   readonly listTableIndexes: "__lunora_admin__:listTableIndexes";
@@ -2899,7 +2965,7 @@ interface FunctionCallStat {
 interface TableIndexInfo {
   fields: string[];
   name: string;
-  type: "index" | "rank" | "search" | "vector";
+  type: "geo" | "index" | "rank" | "search" | "vector";
   unique?: boolean;
 }
 /** Payload of a `__lunora_admin__:listTableIndexes` call: every declared index on the table. */
@@ -3079,7 +3145,12 @@ interface StudioFeaturesResult {
   kv: boolean;
   /** `@lunora/mail` is imported by a `lunora/` source or a declared dependency. */
   mail: boolean;
-  /** `@lunora/payment` is used (import or `ctx.payments`) or a declared dependency. */
+  /**
+   * `@lunora/payment` is used (import or `ctx.payments`), or the app declares the store's
+   * `subscriptions`/`events` tables that the Payments panel reads. Unlike the other flags this
+   * has no declared-dependency arm: the panel queries those tables directly, so a bare dependency
+   * (e.g. reusing the package's pure webhook helpers) must not show a page that would then error.
+   */
   payments: boolean;
   /** `@lunora/queue` / `ctx.queues` is used, the app declares queues, or it is a declared dependency. */
   queues: boolean;
@@ -3543,6 +3614,39 @@ declare const readFunctionMetricsTotals: (sql: SqlExec) => {
   errors: number;
   requests: number;
 };
+/** Default geohash precision (characters) maintained by a `.geoIndex()` companion — ~4.8 m cells. */
+declare const GEO_DEFAULT_PRECISION = 9;
+/** A latitude/longitude point (WGS84 decimal degrees). */
+interface GeoPoint {
+  lat: number;
+  lng: number;
+}
+/** An axis-aligned latitude/longitude bounding box (`sw`/`ne` corners). */
+interface GeoBoundingBox {
+  ne: GeoPoint;
+  sw: GeoPoint;
+}
+/**
+ * Encode `point` to a geohash of `precision` characters. Standard interleaved
+ * lat/lng bisection over the base-32 alphabet.
+ */
+declare const encodeGeohash: (point: GeoPoint, precision: number) => string;
+/** Great-circle distance between two points in metres (Haversine). */
+declare const haversineMeters: (a: GeoPoint, b: GeoPoint) => number;
+/**
+ * The center cell plus its eight neighbours at a precision chosen so each cell is
+ * at least `radiusMeters` wide — the geohash prefixes to range-scan for a
+ * proximity query. Deduplicated (near a pole neighbours can collapse).
+ */
+declare const coveringGeohashes: (center: GeoPoint, radiusMeters: number) => string[];
+/** Whether `point` falls inside `box` (inclusive edges). */
+declare const pointInBoundingBox: (point: GeoPoint, box: GeoBoundingBox) => boolean;
+/**
+ * Geohash prefixes covering `box`: the covering cells of the circle centered on
+ * the box whose radius reaches the north-east corner, guaranteeing every point
+ * in the box is scanned before the exact `pointInBoundingBox` refine.
+ */
+declare const boundingBoxGeohashes: (box: GeoBoundingBox) => string[];
 /**
  * Severity of a `ctx.log.*` call. The five console method names (`log` is the
  * default level, distinct from `info`) plus `trace`/`fatal`, so the logger spans
@@ -4152,6 +4256,28 @@ declare class SessionDO {
   private handleGet;
   private handleRevoke;
 }
+/** One table's resolved TTL policy, as surfaced to the DO alarm by the generated shard subclass. */
+interface TtlSweepSpec {
+  /** Millisecond offset added to `field` to derive the expiry (`field + after`); absent ⇒ `field` is the absolute expiry. */
+  after?: number;
+  /** The epoch-millisecond expiry column. */
+  field: string;
+  /** The `.softDelete()` marker column, when the table soft-deletes — expired-but-already-tombstoned rows are skipped. */
+  softDeleteField?: string;
+  /** The table whose expired rows are swept. */
+  table: string;
+}
+/**
+ * Select up to `limit` ids of rows in `spec.table` whose TTL expired at `now`
+ * (i.e. `field + (after ?? 0) < now`). `hasMore` is `true` when matches remained
+ * beyond `limit`, so the caller can loop a bounded batch. When `spec.softDeleteField`
+ * is set, rows already soft-deleted (marker non-null) are excluded so the sweep
+ * never re-touches a tombstone.
+ */
+declare const selectExpiredIds: (sql: SqlExec, spec: TtlSweepSpec, now: number, limit: number) => {
+  hasMore: boolean;
+  ids: string[];
+};
 /**
  * Diff the previously-sent list snapshot (`previousJson`, the memo's
  * `lastJson`) against the new query result and produce per-row
@@ -5631,6 +5757,35 @@ declare abstract class ShardDO {
    * no-op when the runtime exposes no `setAlarm` (unit harness).
    */
   protected scheduleSourcePoll(): Promise<void>;
+  /**
+   * The resolved TTL policies (`.ttl(field, { after })`) for this DO's schema —
+   * one {@link TtlSweepSpec} per table that declares a TTL. The base `ShardDO`
+   * has no schema, so it returns `[]` and the TTL tier stays dormant. The
+   * codegen subclass overrides it to read each table's `ttlPolicy` (+ its
+   * `.softDelete()` marker) off the imported schema.
+   */
+  protected ttlSweeps(): ReadonlyArray<TtlSweepSpec>;
+  /**
+   * Sweep every `.ttl()` table once: page the rows past their expiry and remove
+   * each THROUGH the schema-aware writer (`deleteRowThroughWriter`) so companions
+   * / CDC / live subscriptions stay correct and a `.softDelete()` table soft-deletes
+   * instead of physically removing the row. Work is bounded per tick
+   * ({@link TTL_SWEEP_BATCH} × {@link TTL_SWEEP_MAX_BATCHES}) so a large backlog
+   * drains across several alarms without stalling the shard.
+   *
+   * Returns the next-due timestamp (a coarse {@link TTL_SWEEP_INTERVAL_MS}
+   * cadence, so freshly-written rows expire within a bounded window) while any
+   * TTL table exists, or `undefined` when there are none — so a DO with no TTL
+   * table never arms this tier.
+   */
+  protected pollTtlSweeps(): Promise<number | undefined>;
+  /**
+   * Arm the shared poll alarm for the TTL sweep. Mirrors {@link scheduleSourcePoll};
+   * the codegen subclass calls it once on construction when the schema declares a
+   * `.ttl()` table so the sweep loop starts, after which {@link ShardDO.alarm}
+   * re-arms itself. Idempotent; a no-op when the runtime exposes no `setAlarm`.
+   */
+  protected scheduleTtlSweep(): Promise<void>;
   /** This DO's shard key (its DO name), or `__root__` for the single-DO default. The `tenantBy` mapper binds it into the source query. */
   protected currentShardKey(): string;
   /** Record a contained external-source ingest failure (one sourced table's poll) into the log ring without aborting the others. */
@@ -7083,4 +7238,4 @@ interface WhereSqlStrategy {
  * `undefined` when the input imposes no constraint (empty `where`).
  */
 declare const compileWhereSql: (where: WhereInput | undefined, strategy: WhereSqlStrategy) => SQL | undefined;
-export { ADMIN_FUNCTIONS, ADMIN_FUNCTION_PREFIX, AGGREGATE_SQL_FUNCTION, AUTH_METRICS_BUCKETS_TABLE, AUTH_METRICS_BUCKET_MS, AUTH_METRICS_BUCKET_RETENTION, AUTH_METRICS_TABLE, type AdvisoriesResult, type AdvisoryFinding, type AggregateIndexDefinitionLike, type AggregateOp, type AggregateOptions, type AggregateResult, type AggregateTally, type ApplyOnDeleteOptions, type AuditEntry, type AuditLogResult, type AuthMetrics, type AuthMetricsBucket, type BroadcastDelta, CDC_LOG_TABLE, type CacheEntry, type CapturedMailRow, type CdcChange, type Clock, type ColumnMeta, type ColumnMetaLike, ConflictError, type ContextMetrics, type ContextTracer, type CountArgs, CountRlsUnsupportedError, type CtxDbOptions, DATA_MIGRATION_STATE_TABLE, DEFAULT_MAX_RELATION_KEYS, 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, FUNCTION_METRICS_BUCKETS_TABLE, FUNCTION_METRICS_BUCKET_MS, FUNCTION_METRICS_BUCKET_RETENTION, FUNCTION_METRICS_INDEX_TABLE, FUNCTION_METRICS_TABLE, type FacetColumnOptions, type FacetColumnResult, type FacetValue, type FieldOperators, type FlagEvaluation, type FlagsResult, type FunctionCallStat, type FunctionMetricBucket, type FunctionMetricIndexHit, type FunctionStatsResult, type GroupByEntry, type GroupByOptions, type HibernatableWebSocket, type IdGenerator, type ImportError, type ImportShardAdminArgs, type ImportShardArgs, type ImportShardResult, type IncrementalMaterializeResult, type IndexDefinitionLike, type IndexRangeBuilderLike, LogBuffer, type LogEntry, type LogEventInput, type LogLevel, type LogSink, MAIL_RETENTION, MAIL_TABLE, MAX_SQL_ROWS, MIN_ADMIN_TOKEN_LENGTH, MIN_AUTH_SECRET_LENGTH, type MaskColumnMetadata, type MaskPoliciesResult, type MaterializeResult, type MetricsDeps, type MigrationDirection, type MigrationRunResult, type MigrationStatus, type MigrationStatusRow, type MutationDelta, type NestedWith, NotFoundError, NotUniqueError, type OnDeleteActionLike, type OrderByInput, type OrderKey, type PaginationOptions, type PitrBookmarkResult, type PitrRestoreArgs, type PitrRestoreResult, type PitrStorage, type QueryArgs, type QueryPage, type QueueMetadata, type QueuesResult, RANK_TIEBREAK, RELATION_FUNCTION_PREFIX, RLS_UNWRAP_SYMBOL, ROOT_DO_SIZE_WARN_BYTES, ROOT_SHARD_NAME, type RankDirection, type RankIndexDefinitionLike, type RankOptions, type RankPage, type RankPageOptions, type RankPageRow, type RankPageRowKey, type RankResult, type RankSortKeyLike, ReactiveCache, type ReactiveCacheOptions, type ReadHook, type ReadTablePageOptions, type RecordAuthEventInput, type RecordFunctionMetricInput, type RecordMailInput, type RelationDefinitionLike, type RenderedSql, type ResolveRelationPredicatesOptions, type ResolveWithOptions, type RestrictableQueryOptions, type RlsPoliciesResult, type RlsPolicyMetadata, RlsRequiredError, type RlsRoleMetadata, type RpcRequest, type RunDataMigrationOptions, type RunShardApplyCdcArgs, type RunShardApplyCdcResult, type RunShardBulkDeleteArgs, type RunShardBulkDeleteResult, type RunShardExportArgs, type RunShardImportArgs, type RunShardMigrationArgs, type RunShardRankBeforeArgs, type RunShardRankPageArgs, type RunShardWriteArgs, type RunShardWriteResult, type RunTriggersOptions, SCAN_DEP, SESSION_DO_TTL_DEFAULT, SHARD_REGISTRY_DO_NAME, type SchedulableWorkflowReferenceLike, type ScheduledFunctionDoc, type SchedulerLike, type SchemaLike, type SearchFilterBuilderLike, type SecurityAuditResult, type SecurityFinding, type SecurityFindingKind, type SecurityFindingLevel, type SelectMatchingIdsOptions, type ServerDefaultContextLike, SessionDO, type SessionRecord, type SettingEntry, type SettingKind, type SettingsResult, type ShapeSubscriptionQuery, ShardDO, type ShardDOOptions, type ShardDOState, type ShardRankPageResult, ShardRegistryDO, type SocketAttachment, type SortDirection, type SourceClientLike, type SourceCursorLike, type SourceRefresh, type SqlConsoleResult, type SqlCursor, type SqlEngine, type SqlExec, type StorageRuleMetadata, type StorageRulesResult, type StudioFeaturesResult, type SubscriptionEnvelope, type SubscriptionOutcome, type SubscriptionQuery, 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 TelemetrySink, type TraceAnchor, type TracerDeps, type TransactionSqlLike, type TriggerContextLike, type TriggerDefinitionLike, type TriggerEventLike, type TriggerOpLike, type TriggerTimingLike, type ValidatorLike, type WhereInput, type WhereSqlStrategy, type WithInput, type WorkflowMetadata, type WorkflowsResult, type WriteEvent, type WriteHook, aggregateSqlFunction, aggregateTableName, applyCdcChanges, applyOnDelete, applySelect, armRestore, assertFlatPredicate, assertReadonly, assertShapeShardable, assertValidClientId, backfillAggregateIndexes, backfillRankIndexes, buildFtsMatch, buildSecurityAudit, buildSeekWhere, clearCapturedMail, coerceAggregateNumber, compileWhereSql, containsRelationPredicate, createDependencyTracker, createMetrics, createShardCtxDb, createSystemReader, createTracer, decodeCursor, depKey, diffExternalSource, dispatchRootSpan, encodeAggregateKey, encodeCursor, encodePartitionKey, ensureAuthMetricsTables, ensureFunctionMetricsTables, ensureMailTable, exportShardRows, exportShardTable, facetColumn, fanOutScalarCounts, foldAggregateTally, ftsTableName, guardWriter, hasTrigger, importShardRows, isRelationPredicate, isSoftDeleted, isSourceDue, liftSourceId, listTables, matchesRankStaticWhere, matchesStaticWhere, materializeExternalRows, materializeExternalRowsIncremental, mergeWhere, normalizeCountArgument, normalizeIdStructurally, normalizeOrderKeys, parseExportShardArgs, parseImportShardArgs, planAggregateLookup, pullExternalSourceIncrementalTick, pullExternalSourceTick, rankTableName, reactiveCacheKey, readAggregateValue, readAuthMetrics, readBookmark, readCapturedMail, readCdcChanges, readExternalSourceBaseline, readFunctionMetricBuckets, readFunctionMetricIndexHits, readFunctionMetrics, readFunctionMetricsTotals, readMigrationStatus, readTablePage, recordAuthEvent, recordCapturedMail, recordFunctionMetric, renderSql, resolveRankPartition, resolveRelationPredicates, resolveWith, runDataMigration, runExternalSourceTick, runReadonlySql, runRowValidators, runShardMigrations, runTriggers, scoreDocument, selectExportTables, selectIndexForAggregate, selectIndexForCount, selectIndexForGroupBy, selectMatchingIds, serveRelationFanout, softDeleteScope, sortColumnName, stableStringify, stableWireKey, stringifySearchText, subscriptionListDeltas, throwingScheduler, tokenizeSearch, trimCdcChanges, validateImportRow };
+export { ADMIN_FUNCTIONS, ADMIN_FUNCTION_PREFIX, AGGREGATE_SQL_FUNCTION, AUTH_METRICS_BUCKETS_TABLE, AUTH_METRICS_BUCKET_MS, AUTH_METRICS_BUCKET_RETENTION, AUTH_METRICS_TABLE, type AdvisoriesResult, type AdvisoryFinding, type AggregateIndexDefinitionLike, type AggregateOp, type AggregateOptions, type AggregateResult, type AggregateTally, type ApplyOnDeleteOptions, type AuditEntry, type AuditLogResult, type AuthMetrics, type AuthMetricsBucket, type BroadcastDelta, CDC_LOG_TABLE, type CacheEntry, type CapturedMailRow, type CdcChange, type Clock, type ColumnMeta, type ColumnMetaLike, ConflictError, type ContextMetrics, type ContextTracer, type CountArgs, CountRlsUnsupportedError, type CtxDbOptions, DATA_MIGRATION_STATE_TABLE, DEFAULT_MAX_RELATION_KEYS, 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, FUNCTION_METRICS_BUCKETS_TABLE, FUNCTION_METRICS_BUCKET_MS, FUNCTION_METRICS_BUCKET_RETENTION, FUNCTION_METRICS_INDEX_TABLE, FUNCTION_METRICS_TABLE, type FacetColumnOptions, type FacetColumnResult, type FacetValue, type FieldOperators, type FlagEvaluation, type FlagsResult, type FunctionCallStat, type FunctionMetricBucket, type FunctionMetricIndexHit, type FunctionStatsResult, GEO_DEFAULT_PRECISION, type GeoBoundingBox, type GeoFilterBuilderLike, type GeoIndexDefinitionLike, type GeoPoint, type GroupByEntry, type GroupByOptions, type HibernatableWebSocket, type IdGenerator, type ImportError, type ImportShardAdminArgs, type ImportShardArgs, type ImportShardResult, type IncrementalMaterializeResult, type IndexDefinitionLike, type IndexRangeBuilderLike, LogBuffer, type LogEntry, type LogEventInput, type LogLevel, type LogSink, MAIL_RETENTION, MAIL_TABLE, MAX_SQL_ROWS, MIN_ADMIN_TOKEN_LENGTH, MIN_AUTH_SECRET_LENGTH, type MaskColumnMetadata, type MaskPoliciesResult, type MaterializeResult, type MetricsDeps, type MigrationDirection, type MigrationRunResult, type MigrationStatus, type MigrationStatusRow, type MutationDelta, type NestedWith, NotFoundError, NotUniqueError, type OnDeleteActionLike, type OrderByInput, type OrderKey, type PaginationOptions, type PitrBookmarkResult, type PitrRestoreArgs, type PitrRestoreResult, type PitrStorage, type QueryArgs, type QueryPage, type QueueMetadata, type QueuesResult, RANK_TIEBREAK, RELATION_FUNCTION_PREFIX, RLS_UNWRAP_SYMBOL, ROOT_DO_SIZE_WARN_BYTES, ROOT_SHARD_NAME, type RankDirection, type RankIndexDefinitionLike, type RankOptions, type RankPage, type RankPageOptions, type RankPageRow, type RankPageRowKey, type RankResult, type RankSortKeyLike, ReactiveCache, type ReactiveCacheOptions, type ReadHook, type ReadTablePageOptions, type RecordAuthEventInput, type RecordFunctionMetricInput, type RecordMailInput, type RelationDefinitionLike, type RenderedSql, type ResolveRelationPredicatesOptions, type ResolveWithOptions, type RestrictableQueryOptions, type RlsPoliciesResult, type RlsPolicyMetadata, RlsRequiredError, type RlsRoleMetadata, type RpcRequest, type RunDataMigrationOptions, type RunShardApplyCdcArgs, type RunShardApplyCdcResult, type RunShardBulkDeleteArgs, type RunShardBulkDeleteResult, type RunShardExportArgs, type RunShardImportArgs, type RunShardMigrationArgs, type RunShardRankBeforeArgs, type RunShardRankPageArgs, type RunShardWriteArgs, type RunShardWriteResult, type RunTriggersOptions, SCAN_DEP, SESSION_DO_TTL_DEFAULT, SHARD_REGISTRY_DO_NAME, type SchedulableWorkflowReferenceLike, type ScheduledFunctionDoc, type SchedulerLike, type SchemaLike, type SearchFilterBuilderLike, type SecurityAuditResult, type SecurityFinding, type SecurityFindingKind, type SecurityFindingLevel, type SelectMatchingIdsOptions, type ServerDefaultContextLike, SessionDO, type SessionRecord, type SettingEntry, type SettingKind, type SettingsResult, type ShapeSubscriptionQuery, ShardDO, type ShardDOOptions, type ShardDOState, type ShardRankPageResult, ShardRegistryDO, type SocketAttachment, type SortDirection, type SourceClientLike, type SourceCursorLike, type SourceRefresh, type SpanHandle, type SqlConsoleResult, type SqlCursor, type SqlEngine, type SqlExec, type StorageRuleMetadata, type StorageRulesResult, type StudioFeaturesResult, type SubscriptionEnvelope, type SubscriptionOutcome, type SubscriptionQuery, 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 TelemetrySink, type TraceAnchor, type TracerDeps, type TransactionSqlLike, type TriggerContextLike, type TriggerDefinitionLike, type TriggerEventLike, type TriggerOpLike, type TriggerTimingLike, type TtlSweepSpec, type ValidatorLike, type WhereInput, type WhereSqlStrategy, type WithInput, type WorkflowMetadata, type WorkflowsResult, type WriteEvent, type WriteHook, aggregateSqlFunction, aggregateTableName, applyCdcChanges, applyOnDelete, applySelect, armRestore, assertFlatPredicate, assertReadonly, assertShapeShardable, assertValidClientId, backfillAggregateIndexes, backfillRankIndexes, boundingBoxGeohashes, buildFtsMatch, buildSecurityAudit, buildSeekWhere, clearCapturedMail, coerceAggregateNumber, compileWhereSql, containsRelationPredicate, coveringGeohashes, createDependencyTracker, createMetrics, createShardCtxDb, createSystemReader, createTracer, decodeCursor, depKey, diffExternalSource, dispatchRootSpan, encodeAggregateKey, encodeCursor, encodeGeohash, encodePartitionKey, ensureAuthMetricsTables, ensureFunctionMetricsTables, ensureMailTable, exportShardRows, exportShardTable, facetColumn, fanOutScalarCounts, foldAggregateTally, ftsTableName, guardWriter, hasTrigger, haversineMeters, importShardRows, isRelationPredicate, isSoftDeleted, isSourceDue, liftSourceId, listTables, matchesRankStaticWhere, matchesStaticWhere, materializeExternalRows, materializeExternalRowsIncremental, mergeWhere, normalizeCountArgument, normalizeIdStructurally, normalizeOrderKeys, parseExportShardArgs, parseImportShardArgs, planAggregateLookup, pointInBoundingBox, pullExternalSourceIncrementalTick, pullExternalSourceTick, rankTableName, reactiveCacheKey, readAggregateValue, readAuthMetrics, readBookmark, readCapturedMail, readCdcChanges, readExternalSourceBaseline, readFunctionMetricBuckets, readFunctionMetricIndexHits, readFunctionMetrics, readFunctionMetricsTotals, readMigrationStatus, readTablePage, recordAuthEvent, recordCapturedMail, recordFunctionMetric, renderSql, resolveRankPartition, resolveRelationPredicates, resolveWith, runDataMigration, runExternalSourceTick, runReadonlySql, runRowValidators, runShardMigrations, runTriggers, scoreDocument, selectExpiredIds, selectExportTables, selectIndexForAggregate, selectIndexForCount, selectIndexForGroupBy, selectMatchingIds, serveRelationFanout, softDeleteScope, sortColumnName, stableStringify, stableWireKey, stringifySearchText, subscriptionListDeltas, throwingScheduler, tokenizeSearch, trimCdcChanges, validateImportRow };