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

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;
 }
@@ -2899,7 +2938,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. */
@@ -3543,6 +3582,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 +4224,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 +5725,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 +7206,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 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;
 }
@@ -2899,7 +2938,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. */
@@ -3543,6 +3582,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 +4224,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 +5725,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 +7206,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 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.mjs

@@ -4,14 +4,15 @@ export { aggregateTableName, coerceAggregateNumber, encodeAggregateKey, foldAggr
 export { CountRlsUnsupportedError, mergeWhere, planAggregateLookup, selectIndexForAggregate, selectIndexForCount, selectIndexForGroupBy } from './packem_shared/CountRlsUnsupportedError-BGxj0pgS.mjs';
 export { AUTH_METRICS_BUCKETS_TABLE, AUTH_METRICS_BUCKET_MS, AUTH_METRICS_BUCKET_RETENTION, AUTH_METRICS_TABLE, ensureAuthMetricsTables, readAuthMetrics, recordAuthEvent } from './packem_shared/AUTH_METRICS_BUCKETS_TABLE-CiHHYeJi.mjs';
 export { c as createMetrics, a as createTracer, d as dispatchRootSpan } from './packem_shared/context-telemetry-DWfYDxCS.mjs';
-export { NotUniqueError, assertValidClientId, createShardCtxDb, normalizeIdStructurally } from './packem_shared/NotUniqueError-Ca21uDuU.mjs';
+export { NotUniqueError, assertValidClientId, createShardCtxDb, normalizeIdStructurally } from './packem_shared/NotUniqueError-DbtlWwcG.mjs';
 export { DATA_MIGRATION_STATE_TABLE, readMigrationStatus, runDataMigration } from './packem_shared/DATA_MIGRATION_STATE_TABLE-CYwBpyTr.mjs';
 export { SCAN_DEP, createDependencyTracker, depKey } from './packem_shared/SCAN_DEP-DLJF8dsj.mjs';
 export { renderSql } from './packem_shared/renderSql-D6eUcn2N.mjs';
 export { diffExternalSource } from './packem_shared/diffExternalSource-CovHfdyo.mjs';
-export { materializeExternalRows, materializeExternalRowsIncremental, readExternalSourceBaseline, runExternalSourceTick } from './packem_shared/materializeExternalRows-DlQWMlw_.mjs';
-export { isSoftDeleted, isSourceDue, liftSourceId, pullExternalSourceIncrementalTick, pullExternalSourceTick } from './packem_shared/isSoftDeleted-YLKR6JYw.mjs';
+export { materializeExternalRows, materializeExternalRowsIncremental, readExternalSourceBaseline, runExternalSourceTick } from './packem_shared/materializeExternalRows-BtEGs1Fv.mjs';
+export { isSoftDeleted, isSourceDue, liftSourceId, pullExternalSourceIncrementalTick, pullExternalSourceTick } from './packem_shared/isSoftDeleted-CFJmhjFP.mjs';
 export { FUNCTION_METRICS_BUCKETS_TABLE, FUNCTION_METRICS_BUCKET_MS, FUNCTION_METRICS_BUCKET_RETENTION, FUNCTION_METRICS_INDEX_TABLE, FUNCTION_METRICS_TABLE, ensureFunctionMetricsTables, readFunctionMetricBuckets, readFunctionMetricIndexHits, readFunctionMetrics, readFunctionMetricsTotals, recordFunctionMetric } from './packem_shared/FUNCTION_METRICS_BUCKETS_TABLE-UDNVD7FS.mjs';
+export { GEO_DEFAULT_PRECISION, boundingBoxGeohashes, coveringGeohashes, encodeGeohash, haversineMeters, pointInBoundingBox } from './packem_shared/GEO_DEFAULT_PRECISION-BWnsNmpP.mjs';
 export { ADMIN_FUNCTIONS, ADMIN_FUNCTION_PREFIX, FLAGS_FUNCTION_PREFIX, RELATION_FUNCTION_PREFIX, facetColumn, listTables, readTablePage, selectMatchingIds } from './packem_shared/ADMIN_FUNCTIONS-DVk02KpP.mjs';
 export { LogBuffer } from './packem_shared/LogBuffer-B_Ezju_N.mjs';
 export { MAIL_RETENTION, MAIL_TABLE, clearCapturedMail, ensureMailTable, readCapturedMail, recordCapturedMail } from './packem_shared/MAIL_RETENTION-CPpgl-dX.mjs';
@@ -27,16 +28,17 @@ export { RLS_UNWRAP_SYMBOL, RlsRequiredError, guardWriter } from './packem_share
 export { buildFtsMatch, ftsTableName, scoreDocument, stringifySearchText, tokenizeSearch } from './packem_shared/buildFtsMatch-BLEMawrp.mjs';
 export { M as MIN_ADMIN_TOKEN_LENGTH, a as MIN_AUTH_SECRET_LENGTH, b as buildSecurityAudit } from './packem_shared/security-audit-CucgBice.mjs';
 export { SESSION_DO_TTL_DEFAULT, SessionDO } from './packem_shared/SESSION_DO_TTL_DEFAULT-BnSKgVO4.mjs';
-export { ROOT_DO_SIZE_WARN_BYTES, ROOT_SHARD_NAME, ShardDO } from './packem_shared/ROOT_DO_SIZE_WARN_BYTES-CBlw_ir3.mjs';
+export { ROOT_DO_SIZE_WARN_BYTES, ROOT_SHARD_NAME, ShardDO } from './packem_shared/ROOT_DO_SIZE_WARN_BYTES-FAG0bOO5.mjs';
 export { SHARD_REGISTRY_DO_NAME, ShardRegistryDO } from './packem_shared/SHARD_REGISTRY_DO_NAME-D99roc-r.mjs';
 export { MAX_SQL_ROWS, assertReadonly, runReadonlySql } from './packem_shared/MAX_SQL_ROWS-iFAA8FbD.mjs';
 export { createSystemReader } from './packem_shared/createSystemReader-D12eNH13.mjs';
 export { ConflictError } from './packem_shared/ConflictError-CLoq37xH.mjs';
 export { hasTrigger, runTriggers } from './packem_shared/hasTrigger-5N6_Fx0A.mjs';
+export { selectExpiredIds } from './packem_shared/selectExpiredIds-C5W29Upb.mjs';
 export { compileWhereSql } from './packem_shared/compileWhereSql-DE6yfRcQ.mjs';
 export { CDC_LOG_TABLE, applyCdcChanges, readCdcChanges, trimCdcChanges } from './packem_shared/CDC_LOG_TABLE-uwOJxJJZ.mjs';
-export { backfillAggregateIndexes, backfillRankIndexes } from './packem_shared/backfillAggregateIndexes-DDoT-UUI.mjs';
-export { runShardMigrations } from './packem_shared/runShardMigrations-DFzx6Qld.mjs';
+export { backfillAggregateIndexes, backfillRankIndexes } from './packem_shared/backfillAggregateIndexes-BGTwynwh.mjs';
+export { runShardMigrations } from './packem_shared/runShardMigrations-BVax6rYu.mjs';
 export { stableStringify } from './packem_shared/stableStringify-mC40mZts.mjs';
 export { stableWireKey } from './packem_shared/stableWireKey-DKuXO7T5.mjs';
 export { subscriptionListDeltas } from './packem_shared/subscriptionListDeltas-CT76bYny.mjs';

package/dist/packem_shared/GEO_DEFAULT_PRECISION-BWnsNmpP.mjs

@@ -0,0 +1,114 @@
+const BASE32 = "0123456789bcdefghjkmnpqrstuvwxyz";
+const GEO_DEFAULT_PRECISION = 9;
+const EARTH_RADIUS_METERS = 63710088e-1;
+const CELL_WIDTH_METERS = [Number.POSITIVE_INFINITY, 5009400, 1252300, 156500, 39100, 4900, 1200, 152.9, 38.2, 4.77, 1.19, 0.149, 0.037];
+const clampPrecision = (precision) => Math.min(Math.max(Math.trunc(precision), 1), 12);
+const encodeGeohash = (point, precision) => {
+  const chars = clampPrecision(precision);
+  let latMin = -90;
+  let latMax = 90;
+  let lngMin = -180;
+  let lngMax = 180;
+  let hash = "";
+  let bit = 0;
+  let index = 0;
+  let even = true;
+  while (hash.length < chars) {
+    if (even) {
+      const mid = (lngMin + lngMax) / 2;
+      if (point.lng >= mid) {
+        index = index * 2 + 1;
+        lngMin = mid;
+      } else {
+        index *= 2;
+        lngMax = mid;
+      }
+    } else {
+      const mid = (latMin + latMax) / 2;
+      if (point.lat >= mid) {
+        index = index * 2 + 1;
+        latMin = mid;
+      } else {
+        index *= 2;
+        latMax = mid;
+      }
+    }
+    even = !even;
+    if (bit < 4) {
+      bit += 1;
+    } else {
+      hash += BASE32[index] ?? "0";
+      bit = 0;
+      index = 0;
+    }
+  }
+  return hash;
+};
+const haversineMeters = (a, b) => {
+  const toRadians = (degrees) => degrees * Math.PI / 180;
+  const dLat = toRadians(b.lat - a.lat);
+  const dLng = toRadians(b.lng - a.lng);
+  const lat1 = toRadians(a.lat);
+  const lat2 = toRadians(b.lat);
+  const h = Math.sin(dLat / 2) ** 2 + Math.cos(lat1) * Math.cos(lat2) * Math.sin(dLng / 2) ** 2;
+  return 2 * EARTH_RADIUS_METERS * Math.asin(Math.min(1, Math.sqrt(h)));
+};
+const precisionForRadius = (radiusMeters) => {
+  for (let length = CELL_WIDTH_METERS.length - 1; length >= 1; length -= 1) {
+    const width = CELL_WIDTH_METERS[length];
+    if (width !== void 0 && width >= radiusMeters) {
+      return length;
+    }
+  }
+  return 1;
+};
+const NEIGHBOURS = {
+  east: ["bc01fg45238967deuvhjyznpkmstqrwx", "bc01fg45238967deuvhjyznpkmstqrwx"],
+  north: ["p0r21436x8zb9dcf5h7kjnmqesgutwvy", "bc01fg45238967deuvhjyznpkmstqrwx"],
+  south: ["14365h7k9dcfesgujnmqp0r2twvyx8zb", "238967debc01fg45kmstqrwxuvhjyznp"],
+  west: ["238967debc01fg45kmstqrwxuvhjyznp", "238967debc01fg45kmstqrwxuvhjyznp"]
+};
+const BORDERS = {
+  east: ["bcfguvyz", "prxz"],
+  north: ["prxz", "bcfguvyz"],
+  south: ["028b", "0145hjnp"],
+  west: ["0145hjnp", "028b"]
+};
+const adjacent = (hash, direction) => {
+  const lower = hash.toLowerCase();
+  const lastChar = lower.at(-1) ?? "";
+  let base = lower.slice(0, -1);
+  const type = lower.length % 2 === 0 ? 0 : 1;
+  if (BORDERS[direction][type].includes(lastChar) && base !== "") {
+    base = adjacent(base, direction);
+  }
+  return base + (BASE32[NEIGHBOURS[direction][type].indexOf(lastChar)] ?? "");
+};
+const coveringGeohashes = (center, radiusMeters) => {
+  const precision = precisionForRadius(Math.max(radiusMeters, 1));
+  const origin = encodeGeohash(center, precision);
+  const north = adjacent(origin, "north");
+  const south = adjacent(origin, "south");
+  const cells = [
+    origin,
+    north,
+    south,
+    adjacent(origin, "east"),
+    adjacent(origin, "west"),
+    adjacent(north, "east"),
+    adjacent(north, "west"),
+    adjacent(south, "east"),
+    adjacent(south, "west")
+  ];
+  return [...new Set(cells)];
+};
+const pointInBoundingBox = (point, box) => point.lat >= box.sw.lat && point.lat <= box.ne.lat && point.lng >= box.sw.lng && point.lng <= box.ne.lng;
+const boundingBoxCenter = (box) => {
+  return { lat: (box.sw.lat + box.ne.lat) / 2, lng: (box.sw.lng + box.ne.lng) / 2 };
+};
+const boundingBoxGeohashes = (box) => {
+  const center = boundingBoxCenter(box);
+  return coveringGeohashes(center, Math.max(haversineMeters(center, box.ne), 1));
+};
+
+export { GEO_DEFAULT_PRECISION, boundingBoxCenter, boundingBoxGeohashes, coveringGeohashes, encodeGeohash, haversineMeters, pointInBoundingBox };

package/dist/packem_shared/{NotUniqueError-Ca21uDuU.mjs → NotUniqueError-DbtlWwcG.mjs}

@@ -6,8 +6,9 @@ import { mergeWhere, CountRlsUnsupportedError, selectIndexForGroupBy, selectInde
 import { appendCdcChange } from './CDC_LOG_TABLE-uwOJxJJZ.mjs';
 export { CDC_LOG_TABLE, applyCdcChanges, bumpCdcEpoch, minCdcSeq, readCdcChanges, readCdcCursor, readCdcEpoch, trimCdcChanges } from './CDC_LOG_TABLE-uwOJxJJZ.mjs';
 import { r as runDrizzle } from './do-exec-5eQy5cEi.mjs';
-import { i as isFtsAvailable, D as DOC_COLUMN$1, r as rowToDocument, A as AGG_KEY, a as AGG_VALUE, b as AGG_COUNT, d as aggUpsertSql, j as jsonPathSql, q as quoteIdentifier, t as tableColumns, e as qualifiedJsonPathSql } from './do-sql-BCHCWtrD.mjs';
+import { i as isFtsAvailable, D as DOC_COLUMN$1, r as rowToDocument, A as AGG_KEY, a as AGG_VALUE, b as AGG_COUNT, g as geoTableName, d as aggUpsertSql, j as jsonPathSql, q as quoteIdentifier, t as tableColumns, e as qualifiedJsonPathSql } from './do-sql-CGAgiQUz.mjs';
 import { param } from './renderSql-D6eUcn2N.mjs';
+import { encodeGeohash, GEO_DEFAULT_PRECISION, coveringGeohashes, boundingBoxGeohashes, pointInBoundingBox, haversineMeters } from './GEO_DEFAULT_PRECISION-BWnsNmpP.mjs';
 import { sortColumnName, matchesRankStaticWhere, encodePartitionKey, rankTableName, resolveRankPartition, RANK_TIEBREAK } from './RANK_TIEBREAK-CXhdcA1o.mjs';
 import { stringifySearchText, ftsTableName, tokenizeSearch, buildFtsMatch, scoreDocument } from './buildFtsMatch-BLEMawrp.mjs';
 import { s as serializeSqlValue } from './serialize-sql-BlRUoiQe.mjs';
@@ -21,10 +22,10 @@ import { createSystemReader } from './createSystemReader-D12eNH13.mjs';
 import { ConflictError } from './ConflictError-CLoq37xH.mjs';
 import { runTriggers } from './hasTrigger-5N6_Fx0A.mjs';
 import { compileWhereSql } from './compileWhereSql-DE6yfRcQ.mjs';
-export { backfillAggregateIndexes, backfillRankIndexes } from './backfillAggregateIndexes-DDoT-UUI.mjs';
+export { backfillAggregateIndexes, backfillRankIndexes } from './backfillAggregateIndexes-BGTwynwh.mjs';
 export { C as CLIENT_WATERMARK_TABLE, G as GLOBAL_SHAPE_SNAPSHOT_TABLE, I as IDEMPOTENCY_TABLE, c as advanceClientWatermark, d as deleteGlobalShapeSnapshot, e as deleteGlobalShapeSnapshotsForConnection, m as migrateClientWatermark, b as migrateGlobalShapeSnapshot, r as readClientWatermark, f as readGlobalShapeSnapshot, g as readIdempotent, t as trimIdempotent, w as writeGlobalShapeSnapshot, h as writeIdempotent } from './ctx-db-idempotency-BdcNpvY4.mjs';
-export { runShardMigrations } from './runShardMigrations-DFzx6Qld.mjs';
-export { a as selectShapeMemberIds, s as selectShapeRows } from './ctx-db-shapes-Cz9dHyh1.mjs';
+export { runShardMigrations } from './runShardMigrations-BVax6rYu.mjs';
+export { a as selectShapeMemberIds, s as selectShapeRows } from './ctx-db-shapes-DTeFiHYS.mjs';
 
 const rankIndexFieldsUnchanged = (index, previous, next) => {
   const fields = [...index.partitionBy ?? [], ...index.sortBy.map((key) => key.field), ...index.where ? Object.keys(index.where) : []];
@@ -314,8 +315,28 @@ const createCompanionSync = (deps) => {
       }
     }
   };
+  const syncGeo = (tableName, id, document) => {
+    const indexes = schema.tables[tableName]?.geoIndexes;
+    if (!indexes || indexes.length === 0) {
+      return;
+    }
+    for (const index of indexes) {
+      const geoTable = geoTableName(tableName, index.name);
+      runDrizzle(sql$1, sql`DELETE FROM ${sql.identifier(geoTable)} WHERE ${sql.identifier("__id__")} = ${id}`);
+      const point = document?.[index.field];
+      if (point !== null && typeof point === "object" && typeof point.lat === "number" && typeof point.lng === "number") {
+        const { lat, lng } = point;
+        const hash = encodeGeohash({ lat, lng }, index.precision ?? GEO_DEFAULT_PRECISION);
+        runDrizzle(
+          sql$1,
+          sql`INSERT INTO ${sql.identifier(geoTable)} (${sql.identifier("__id__")}, ${sql.identifier("__geohash__")}, ${sql.identifier("__lat__")}, ${sql.identifier("__lng__")}) VALUES (${id}, ${hash}, ${lat}, ${lng})`
+        );
+      }
+    }
+  };
   const syncCompanionsForInsert = (tableName, id, document) => {
     syncSearch(tableName, id, document);
+    syncGeo(tableName, id, document);
     syncAggregates(tableName, void 0, document);
     syncRanks(tableName, id, void 0, document);
     invalidateCache(tableName, id);
@@ -329,6 +350,7 @@ const createCompanionSync = (deps) => {
     ensureRankBackfilledForTable,
     syncAggregates,
     syncCompanionsForInsert,
+    syncGeo,
     syncRanks,
     syncSearch
   };
@@ -599,6 +621,123 @@ const searchViaScan = (sql$1, tableName, search, limit, scopeCondition) => {
   const docs = scored.map((entry) => entry.doc);
   return typeof limit === "number" ? docs.slice(0, Math.max(0, Math.floor(limit))) : docs;
 };
+const createGeoBuilder = (geo, tableName) => {
+  const staged = geo;
+  const builder = {
+    near: (point, radiusMeters) => {
+      if (staged.within) {
+        throw new LunoraError("INTERNAL", `geo index "${staged.indexName}" on table "${tableName}": call .near() or .within(), not both`);
+      }
+      staged.near = { point: { lat: point.lat, lng: point.lng }, radiusMeters };
+      return builder;
+    },
+    within: (box) => {
+      if (staged.near) {
+        throw new LunoraError("INTERNAL", `geo index "${staged.indexName}" on table "${tableName}": call .near() or .within(), not both`);
+      }
+      staged.within = { ne: { lat: box.ne.lat, lng: box.ne.lng }, sw: { lat: box.sw.lat, lng: box.sw.lng } };
+      return builder;
+    }
+  };
+  return builder;
+};
+const readGeoPoint = (document, field) => {
+  const value = document[field];
+  if (value === null || typeof value !== "object") {
+    return void 0;
+  }
+  const { lat, lng } = value;
+  return typeof lat === "number" && typeof lng === "number" ? { lat, lng } : void 0;
+};
+const scoreGeoRow = (record, geo) => {
+  const point = readGeoPoint(record, geo.definition.field);
+  if (!point) {
+    return void 0;
+  }
+  const creationTime = typeof record["_creationTime"] === "number" ? record["_creationTime"] : 0;
+  if (geo.near) {
+    const distance = haversineMeters(geo.near.point, point);
+    return distance <= geo.near.radiusMeters ? { creationTime, distance } : void 0;
+  }
+  return pointInBoundingBox(point, geo.within) ? { creationTime, distance: 0 } : void 0;
+};
+const runGeoFetch = (sql$1, tableName, geo, limit, scopeCondition) => {
+  if (!geo.near && !geo.within) {
+    throw new LunoraError("INTERNAL", `geo index "${geo.indexName}" on table "${tableName}": call .near(point, radius) or .within(box)`);
+  }
+  const prefixes = geo.near ? coveringGeohashes(geo.near.point, geo.near.radiusMeters) : boundingBoxGeohashes(geo.within);
+  const geoTable = geoTableName(tableName, geo.indexName);
+  const prefixClauses = prefixes.map(
+    (prefix) => sql`(g.${sql.identifier("__geohash__")} >= ${prefix} AND g.${sql.identifier("__geohash__")} < ${`${prefix}{`})`
+  );
+  const whereClauses = [sql`(${sql.join(prefixClauses, sql` OR `)})`];
+  if (scopeCondition) {
+    whereClauses.push(scopeCondition);
+  }
+  const query = sql`SELECT m.id, m._creationTime, m.${sql.identifier(DOC_COLUMN$1)} FROM ${sql.identifier(geoTable)} g JOIN ${sql.identifier(tableName)} m ON m.id = g.${sql.identifier("__id__")} WHERE ${sql.join(whereClauses, sql` AND `)}`;
+  const rows = runDrizzle(sql$1, query).toArray();
+  const scored = [];
+  for (const row of rows) {
+    const record = rowToDocument(row);
+    const score = record ? scoreGeoRow(record, geo) : void 0;
+    if (record && score) {
+      scored.push({ creationTime: score.creationTime, distance: score.distance, doc: record });
+    }
+  }
+  scored.sort((a, b) => a.distance - b.distance || b.creationTime - a.creationTime);
+  const docs = scored.map((entry) => entry.doc);
+  return typeof limit === "number" ? docs.slice(0, Math.max(0, Math.floor(limit))) : docs;
+};
+const runGeoTerminal = (sql, tableName, stage, scopeCondition, limit) => {
+  const { geo } = stage;
+  if (!geo) {
+    throw new LunoraError("INTERNAL", "runGeoTerminal called without a staged geo query");
+  }
+  const filtered = stage.inMemoryFilters.length > 0;
+  const docs = runGeoFetch(sql, tableName, geo, filtered ? void 0 : limit, scopeCondition);
+  if (!filtered) {
+    return docs;
+  }
+  const result = [];
+  for (const record of docs) {
+    if (stage.inMemoryFilters.every((predicate) => predicate(record))) {
+      result.push(record);
+      if (typeof limit === "number" && result.length >= limit) {
+        break;
+      }
+    }
+  }
+  return result;
+};
+const runPlainFetch = (sql$1, tableName, stage, scopeCondition, orderClause, limit) => {
+  const whereClauses = [];
+  for (const condition of stage.sqlConditions) {
+    whereClauses.push(sql`${jsonPathSql(condition.field)} ${sql.raw(condition.comparator)} ${serializeSqlValue(condition.value)}`);
+  }
+  if (scopeCondition) {
+    whereClauses.push(scopeCondition);
+  }
+  let query = sql`SELECT id, _creationTime, ${sql.identifier(DOC_COLUMN$1)} FROM ${sql.identifier(tableName)}`;
+  if (whereClauses.length > 0) {
+    query = sql`${query} WHERE ${sql.join(whereClauses, sql` AND `)}`;
+  }
+  query = sql`${query} ORDER BY ${orderClause}`;
+  if (typeof limit === "number" && stage.inMemoryFilters.length === 0) {
+    query = sql`${query} LIMIT ${sql.raw(String(Math.max(0, Math.floor(limit))))}`;
+  }
+  const rows = runDrizzle(sql$1, query).toArray();
+  const docs = [];
+  for (const row of rows) {
+    const record = rowToDocument(row);
+    if (record && stage.inMemoryFilters.every((predicate) => predicate(record))) {
+      docs.push(record);
+      if (typeof limit === "number" && docs.length >= limit) {
+        break;
+      }
+    }
+  }
+  return docs;
+};
 const doWhereSqlStrategy = { fieldRef: jsonPathSql, serialize: serializeSqlValue };
 const makeRelationExistsSqlStrategy = (onRead) => {
   let aliasCounter = 0;
@@ -774,36 +913,10 @@ const buildReader = (sql$1, schema, tableName, onIndexUse = () => void 0) => {
     if (stage.search) {
       return runSearchFetch(limit);
     }
-    const whereClauses = [];
-    for (const condition of stage.sqlConditions) {
-      whereClauses.push(sql`${jsonPathSql(condition.field)} ${sql.raw(condition.comparator)} ${serializeSqlValue(condition.value)}`);
-    }
-    if (scopeCondition) {
-      whereClauses.push(scopeCondition);
+    if (stage.geo) {
+      return runGeoTerminal(sql$1, tableName, stage, scopeCondition, limit);
     }
-    let query = sql`SELECT id, _creationTime, ${sql.identifier(DOC_COLUMN$1)} FROM ${sql.identifier(tableName)}`;
-    if (whereClauses.length > 0) {
-      query = sql`${query} WHERE ${sql.join(whereClauses, sql` AND `)}`;
-    }
-    query = sql`${query} ORDER BY ${buildOrderClause()}`;
-    if (typeof limit === "number" && stage.inMemoryFilters.length === 0) {
-      query = sql`${query} LIMIT ${sql.raw(String(Math.max(0, Math.floor(limit))))}`;
-    }
-    const rows = runDrizzle(sql$1, query).toArray();
-    const docs = [];
-    for (const row of rows) {
-      const record = rowToDocument(row);
-      if (!record) {
-        continue;
-      }
-      if (stage.inMemoryFilters.every((predicate) => predicate(record))) {
-        docs.push(record);
-        if (typeof limit === "number" && docs.length >= limit) {
-          break;
-        }
-      }
-    }
-    return docs;
+    return runPlainFetch(sql$1, tableName, stage, scopeCondition, buildOrderClause(), limit);
   };
   const reader = {
     // eslint-disable-next-line @typescript-eslint/require-await -- TableReaderLike returns Promises (the D1 twin awaits real I/O); the DO impl is synchronous over local SQLite
@@ -828,6 +941,9 @@ const buildReader = (sql$1, schema, tableName, onIndexUse = () => void 0) => {
       if (stage.search) {
         throw new LunoraError("INTERNAL", "pagination is not supported on search queries; use .take(n) or .collect()");
       }
+      if (stage.geo) {
+        throw new LunoraError("INTERNAL", "pagination is not supported on geo queries; use .take(n) or .collect()");
+      }
       return paginateStage(sql$1, tableName, stage, options, scopeCondition);
     },
     // eslint-disable-next-line @typescript-eslint/require-await -- TableReaderLike returns Promises (the D1 twin awaits real I/O); the DO impl is synchronous over local SQLite
@@ -842,6 +958,20 @@ const buildReader = (sql$1, schema, tableName, onIndexUse = () => void 0) => {
       }
       return rows[0] ?? null;
     },
+    withGeoIndex(indexName, build) {
+      const definition = (tableDefinition.geoIndexes ?? []).find((index) => index.name === indexName);
+      if (!definition) {
+        throw new LunoraError("INTERNAL", `unknown geo index "${indexName}" on table "${tableName}"`);
+      }
+      onIndexUse(tableName, indexName, "geo");
+      const geoStage = { definition, indexName };
+      stage.geo = geoStage;
+      build(createGeoBuilder(geoStage, tableName));
+      if (!geoStage.near && !geoStage.within) {
+        throw new LunoraError("INTERNAL", `geo index "${indexName}" on table "${tableName}" requires a .near(point, radius) or .within(box) call`);
+      }
+      return reader;
+    },
     withIndex(indexName, range) {
       const definition = tableDefinition.indexes.find((index) => index.name === indexName);
       if (!definition) {
@@ -1090,6 +1220,7 @@ const createShardCtxDb = (options) => {
     ensureRankBackfilledForTable,
     syncAggregates,
     syncCompanionsForInsert,
+    syncGeo,
     syncRanks,
     syncSearch
   } = createCompanionSync({
@@ -1291,6 +1422,7 @@ const createShardCtxDb = (options) => {
           sql`UPDATE ${sql.identifier(tableName)} SET ${sql.identifier(DOC_COLUMN$1)} = ${JSON.stringify(merged)} WHERE id = ${id} AND ${sql.identifier(DOC_COLUMN$1)} = ${existingJson}`
         );
         syncSearch(tableName, id, merged);
+        syncGeo(tableName, id, void 0);
         syncAggregates(tableName, existing, merged);
         syncRanks(tableName, id, existing, void 0);
         cache?.invalidate(tableName, id);
@@ -1308,6 +1440,7 @@ const createShardCtxDb = (options) => {
         sql`DELETE FROM ${sql.identifier(tableName)} WHERE id = ${id} AND ${sql.identifier(DOC_COLUMN$1)} = ${existingJson}`
       );
       syncSearch(tableName, id, void 0);
+      syncGeo(tableName, id, void 0);
       syncAggregates(tableName, existing, void 0);
       syncRanks(tableName, id, existing, void 0);
       cache?.invalidate(tableName, id);
@@ -1682,6 +1815,7 @@ const createShardCtxDb = (options) => {
         sql`UPDATE ${sql.identifier(tableName)} SET ${sql.identifier(DOC_COLUMN$1)} = ${JSON.stringify(merged)} WHERE id = ${id} AND ${sql.identifier(DOC_COLUMN$1)} = ${existingJson}`
       );
       syncSearch(tableName, id, merged);
+      syncGeo(tableName, id, merged);
       syncAggregates(tableName, existing, merged);
       syncRanks(tableName, id, existing, merged);
       cache?.invalidate(tableName, id);
@@ -1878,6 +2012,7 @@ const createShardCtxDb = (options) => {
         sql`UPDATE ${sql.identifier(tableName)} SET _creationTime = ${creationTime}, ${sql.identifier(DOC_COLUMN$1)} = ${JSON.stringify(replaced)} WHERE id = ${id} AND ${sql.identifier(DOC_COLUMN$1)} = ${existingJson}`
       );
       syncSearch(tableName, id, replaced);
+      syncGeo(tableName, id, replaced);
       syncAggregates(tableName, previous, replaced);
       syncRanks(tableName, id, previous, replaced);
       cache?.invalidate(tableName, id);

package/dist/packem_shared/{ROOT_DO_SIZE_WARN_BYTES-CBlw_ir3.mjs → ROOT_DO_SIZE_WARN_BYTES-FAG0bOO5.mjs}

@@ -22,9 +22,10 @@ import { redact, standardRules } from '@visulima/redact';
 import { i as isDevEnvironment, c as buildSettings, b as buildSecurityAudit } from './security-audit-CucgBice.mjs';
 import { runReadonlySql } from './MAX_SQL_ROWS-iFAA8FbD.mjs';
 import { ConflictError } from './ConflictError-CLoq37xH.mjs';
+import { selectExpiredIds } from './selectExpiredIds-C5W29Upb.mjs';
 import { e as deleteGlobalShapeSnapshotsForConnection, g as readIdempotent, h as writeIdempotent, t as trimIdempotent, r as readClientWatermark, m as migrateClientWatermark, c as advanceClientWatermark, d as deleteGlobalShapeSnapshot, f as readGlobalShapeSnapshot, w as writeGlobalShapeSnapshot } from './ctx-db-idempotency-BdcNpvY4.mjs';
 import { CDC_LOG_TABLE, readCdcChanges, readCdcCursor, readCdcEpoch, minCdcSeq, bumpCdcEpoch } from './CDC_LOG_TABLE-uwOJxJJZ.mjs';
-import { a as selectShapeMemberIds, s as selectShapeRows } from './ctx-db-shapes-Cz9dHyh1.mjs';
+import { a as selectShapeMemberIds, s as selectShapeRows } from './ctx-db-shapes-DTeFiHYS.mjs';
 
 const MAX_BATCH_ENTRIES = 500;
 
@@ -1855,6 +1856,9 @@ const parseRunMigrationArgs = (args) => {
   };
 };
 const SHARD_BULK_DELETE_CAP = MAX_PAGE_SIZE;
+const TTL_SWEEP_BATCH = 200;
+const TTL_SWEEP_MAX_BATCHES = 20;
+const TTL_SWEEP_INTERVAL_MS = 3e4;
 const parseWriteRowArgs = (args) => {
   const { op } = args;
   const table = typeof args["table"] === "string" ? args["table"] : "";
@@ -2461,12 +2465,10 @@ class ShardDO {
    * reason; otherwise the earlier of the two candidate times (never later than
    * `nowMs`, so a source that's already due arms essentially immediately).
    */
-  static nextPollAlarmTarget(globalShapesRemaining, nextSourceDueAt, nowMs) {
+  static nextPollAlarmTarget(globalShapesRemaining, nextSourceDueAt, nextTtlDueAt, nowMs) {
     const globalTarget = globalShapesRemaining > 0 ? nowMs + ShardDO.GLOBAL_SHAPE_POLL_INTERVAL_MS : void 0;
-    if (globalTarget === void 0) {
-      return nextSourceDueAt === void 0 ? void 0 : Math.max(nextSourceDueAt, nowMs);
-    }
-    return nextSourceDueAt === void 0 ? globalTarget : Math.min(globalTarget, nextSourceDueAt);
+    const candidates = [globalTarget, nextSourceDueAt, nextTtlDueAt].filter((value) => value !== void 0).map((value) => Math.max(value, nowMs));
+    return candidates.length > 0 ? Math.min(...candidates) : void 0;
   }
   state;
   env;
@@ -3147,8 +3149,15 @@ class ShardDO {
       this.recordShapeError("source:poll", error);
       nextSourceDueAt = Date.now() + ShardDO.GLOBAL_SHAPE_POLL_INTERVAL_MS;
     }
+    let nextTtlDueAt;
+    try {
+      nextTtlDueAt = await this.pollTtlSweeps();
+    } catch (error) {
+      this.recordShapeError("ttl:sweep", error);
+      nextTtlDueAt = Date.now() + ShardDO.GLOBAL_SHAPE_POLL_INTERVAL_MS;
+    }
     await this.flushChangedTables();
-    const nextAlarmAt = ShardDO.nextPollAlarmTarget(globalShapesRemaining, nextSourceDueAt, Date.now());
+    const nextAlarmAt = ShardDO.nextPollAlarmTarget(globalShapesRemaining, nextSourceDueAt, nextTtlDueAt, Date.now());
     if (nextAlarmAt !== void 0) {
       await this.scheduleGlobalPoll(nextAlarmAt);
     }
@@ -4337,6 +4346,60 @@ class ShardDO {
   scheduleSourcePoll() {
     return this.scheduleGlobalPoll();
   }
+  /**
+   * 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.
+   */
+  // eslint-disable-next-line class-methods-use-this -- base-class override hook: the codegen subclass reads the imported schema
+  ttlSweeps() {
+    return [];
+  }
+  /**
+   * 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.
+   */
+  async pollTtlSweeps() {
+    const specs = this.ttlSweeps();
+    if (specs.length === 0) {
+      return void 0;
+    }
+    const sql = this.sql;
+    const now = Date.now();
+    for (const spec of specs) {
+      let batches = 0;
+      let hasMore = true;
+      while (hasMore && batches < TTL_SWEEP_MAX_BATCHES) {
+        const page = selectExpiredIds(sql, spec, now, TTL_SWEEP_BATCH);
+        for (const id of page.ids) {
+          await this.deleteRowThroughWriter(spec.table, id);
+        }
+        hasMore = page.hasMore;
+        batches += 1;
+      }
+    }
+    return now + TTL_SWEEP_INTERVAL_MS;
+  }
+  /**
+   * 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`.
+   */
+  scheduleTtlSweep() {
+    return this.scheduleGlobalPoll();
+  }
   /** This DO's shard key (its DO name), or `__root__` for the single-DO default. The `tenantBy` mapper binds it into the source query. */
   currentShardKey() {
     return this.state.id?.name ?? ROOT_SHARD_NAME;

package/dist/packem_shared/{backfillAggregateIndexes-DDoT-UUI.mjs → backfillAggregateIndexes-BGTwynwh.mjs}

@@ -2,7 +2,7 @@ import { sql } from 'drizzle-orm';
 import { matchesStaticWhere } from './AGGREGATE_SQL_FUNCTION-CQsu2Xga.mjs';
 import { encodeAggregateKey, foldAggregateTally, aggregateTableName } from './aggregateTableName-CxNqY1Sl.mjs';
 import { r as runDrizzle } from './do-exec-5eQy5cEi.mjs';
-import { D as DOC_COLUMN, r as rowToDocument, A as AGG_KEY, a as AGG_VALUE, b as AGG_COUNT } from './do-sql-BCHCWtrD.mjs';
+import { D as DOC_COLUMN, r as rowToDocument, A as AGG_KEY, a as AGG_VALUE, b as AGG_COUNT } from './do-sql-CGAgiQUz.mjs';
 import { param } from './renderSql-D6eUcn2N.mjs';
 import { sortColumnName, matchesRankStaticWhere, encodePartitionKey, rankTableName } from './RANK_TIEBREAK-CXhdcA1o.mjs';
 import { s as serializeSqlValue } from './serialize-sql-BlRUoiQe.mjs';

package/dist/packem_shared/{ctx-db-shapes-Cz9dHyh1.mjs → ctx-db-shapes-DTeFiHYS.mjs}

@@ -1,6 +1,6 @@
 import { sql } from 'drizzle-orm';
 import { r as runDrizzle } from './do-exec-5eQy5cEi.mjs';
-import { D as DOC_COLUMN, r as rowToDocument, j as jsonPathSql } from './do-sql-BCHCWtrD.mjs';
+import { D as DOC_COLUMN, r as rowToDocument, j as jsonPathSql } from './do-sql-CGAgiQUz.mjs';
 import { compileWhereSql } from './compileWhereSql-DE6yfRcQ.mjs';
 import { s as serializeSqlValue } from './serialize-sql-BlRUoiQe.mjs';
 

package/dist/packem_shared/{do-sql-BCHCWtrD.mjs → do-sql-CGAgiQUz.mjs}

@@ -2,6 +2,7 @@ import { sql } from 'drizzle-orm';
 import { r as runDrizzle } from './do-exec-5eQy5cEi.mjs';
 
 const DOC_COLUMN = "__doc__";
+const geoTableName = (table, indexName) => `${table}__geo_${indexName}`;
 const quoteIdentifier = (name) => `"${name.replaceAll('"', '""')}"`;
 const jsonPath = (field) => {
   if (field === "_id" || field === "id") {
@@ -84,4 +85,4 @@ const isFtsAvailable = (sql$1) => {
   return available;
 };
 
-export { AGG_KEY as A, DOC_COLUMN as D, AGG_VALUE as a, AGG_COUNT as b, createIndexSql as c, aggUpsertSql as d, qualifiedJsonPathSql as e, isFtsAvailable as i, jsonPathSql as j, quoteIdentifier as q, rowToDocument as r, tableColumns as t };
+export { AGG_KEY as A, DOC_COLUMN as D, AGG_VALUE as a, AGG_COUNT as b, createIndexSql as c, aggUpsertSql as d, qualifiedJsonPathSql as e, geoTableName as g, isFtsAvailable as i, jsonPathSql as j, quoteIdentifier as q, rowToDocument as r, tableColumns as t };

package/dist/packem_shared/{isSoftDeleted-YLKR6JYw.mjs → isSoftDeleted-CFJmhjFP.mjs}

@@ -1,7 +1,7 @@
 import { LunoraError } from '@lunora/errors';
 import { sql } from 'drizzle-orm';
 import { r as runDrizzle } from './do-exec-5eQy5cEi.mjs';
-import { runExternalSourceTick, materializeExternalRowsIncremental } from './materializeExternalRows-DlQWMlw_.mjs';
+import { runExternalSourceTick, materializeExternalRowsIncremental } from './materializeExternalRows-BtEGs1Fv.mjs';
 
 const SOURCE_CURSOR_TABLE = "__lunora_source_cursor";
 const serializeCursor = (value) => {

package/dist/packem_shared/{materializeExternalRows-DlQWMlw_.mjs → materializeExternalRows-BtEGs1Fv.mjs}

@@ -1,5 +1,5 @@
 import { applyCdcChanges } from './CDC_LOG_TABLE-uwOJxJJZ.mjs';
-import { s as selectShapeRows } from './ctx-db-shapes-Cz9dHyh1.mjs';
+import { s as selectShapeRows } from './ctx-db-shapes-DTeFiHYS.mjs';
 import { diffExternalSource, projectExternalSourceRow } from './diffExternalSource-CovHfdyo.mjs';
 import { stableStringify } from './stableStringify-mC40mZts.mjs';
 

package/dist/packem_shared/{runShardMigrations-DFzx6Qld.mjs → runShardMigrations-BVax6rYu.mjs}

@@ -3,7 +3,7 @@ import { aggregateTableName } from './aggregateTableName-CxNqY1Sl.mjs';
 import { migrateCdcLog, migrateCdcMeta } from './CDC_LOG_TABLE-uwOJxJJZ.mjs';
 import { m as migrateClientWatermark, a as migrateIdempotency, b as migrateGlobalShapeSnapshot } from './ctx-db-idempotency-BdcNpvY4.mjs';
 import { r as runDrizzle } from './do-exec-5eQy5cEi.mjs';
-import { D as DOC_COLUMN, j as jsonPathSql, c as createIndexSql, t as tableColumns, i as isFtsAvailable, A as AGG_KEY, a as AGG_VALUE, b as AGG_COUNT } from './do-sql-BCHCWtrD.mjs';
+import { D as DOC_COLUMN, j as jsonPathSql, c as createIndexSql, t as tableColumns, i as isFtsAvailable, A as AGG_KEY, a as AGG_VALUE, b as AGG_COUNT, g as geoTableName } from './do-sql-CGAgiQUz.mjs';
 import { sortColumnName, rankTableName } from './RANK_TIEBREAK-CXhdcA1o.mjs';
 import { ftsTableName } from './buildFtsMatch-BLEMawrp.mjs';
 
@@ -36,6 +36,20 @@ const migrateSearchIndexes = (sql$1, tableName, definition) => {
     );
   }
 };
+const migrateGeoIndexes = (sql$1, tableName, definition) => {
+  if (!definition.geoIndexes) {
+    return;
+  }
+  for (const index of definition.geoIndexes) {
+    const geoTable = geoTableName(tableName, index.name);
+    runDrizzle(
+      sql$1,
+      sql`CREATE TABLE IF NOT EXISTS ${sql.identifier(geoTable)} (${sql.identifier("__id__")} TEXT PRIMARY KEY, ${sql.identifier("__geohash__")} TEXT NOT NULL, ${sql.identifier("__lat__")} REAL NOT NULL, ${sql.identifier("__lng__")} REAL NOT NULL)`
+    );
+    const btreeName = `${tableName}__geo_${index.name}__btree`;
+    runDrizzle(sql$1, createIndexSql(btreeName, geoTable, sql`${sql.identifier("__geohash__")} ASC, ${sql.identifier("__id__")} ASC`, false));
+  }
+};
 const migrateAggregateIndexes = (sql$1, tableName, definition) => {
   if (!definition.aggregateIndexes) {
     return;
@@ -90,6 +104,7 @@ const runShardMigrations = (sql$1, schema, options = {}) => {
     );
     migrateSecondaryIndexes(sql$1, tableName, definition);
     migrateSearchIndexes(sql$1, tableName, definition);
+    migrateGeoIndexes(sql$1, tableName, definition);
     migrateAggregateIndexes(sql$1, tableName, definition);
     migrateRankIndexes(sql$1, tableName, definition);
   }

package/dist/packem_shared/selectExpiredIds-C5W29Upb.mjs

@@ -0,0 +1,18 @@
+import { sql } from 'drizzle-orm';
+import { r as runDrizzle } from './do-exec-5eQy5cEi.mjs';
+import { j as jsonPathSql } from './do-sql-CGAgiQUz.mjs';
+
+const selectExpiredIds = (sql$1, spec, now, limit) => {
+  const cutoff = now - (spec.after ?? 0);
+  const conditions = [sql`${jsonPathSql(spec.field)} IS NOT NULL`, sql`${jsonPathSql(spec.field)} < ${cutoff}`];
+  if (spec.softDeleteField !== void 0) {
+    conditions.push(sql`${jsonPathSql(spec.softDeleteField)} IS NULL`);
+  }
+  const query = sql`SELECT id FROM ${sql.identifier(spec.table)} WHERE ${sql.join(conditions, sql` AND `)} LIMIT ${sql.raw(String(Math.max(0, Math.floor(limit)) + 1))}`;
+  const rows = runDrizzle(sql$1, query).toArray();
+  const hasMore = rows.length > limit;
+  const ids = rows.slice(0, limit).map((row) => row.id);
+  return { hasMore, ids };
+};
+
+export { selectExpiredIds };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/do",
-  "version": "1.0.0-alpha.37",
+  "version": "1.0.0-alpha.38",
   "description": "Lunora Durable Objects: ShardDO (SQLite, OCC, hibernated WebSocket subscriptions) and SessionDO",
   "keywords": [
     "cloudflare",
@@ -46,7 +46,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/errors": "1.0.0-alpha.6",
+    "@lunora/errors": "1.0.0-alpha.7",
     "@lunora/fingerprint": "1.0.0-alpha.3",
     "@visulima/redact": "3.0.0",
     "drizzle-orm": "^0.45.2"