@classytic/mongokit 3.24.0 → 3.25.0

package/dist/pagination-jSUdrACK.d.mts

@@ -0,0 +1,158 @@
+import { a as PopulateSpec, i as ObjectId, l as SortSpec, o as ReadPreferenceType, r as FilterQuery, s as SelectSpec, t as AnyDocument } from "./core-62oo3N1C.mjs";
+import { PipelineStage } from "mongoose";
+//#region src/types/pagination.d.ts
+/** Pagination configuration */
+interface PaginationConfig {
+  /** Default number of documents per page (default: 10) */
+  defaultLimit?: number;
+  /** Maximum allowed limit (default: 100) */
+  maxLimit?: number;
+  /** Maximum allowed page number (default: 10000) */
+  maxPage?: number;
+  /** Page number that triggers performance warning (default: 100) */
+  deepPageThreshold?: number;
+  /** Cursor version for forward compatibility (default: 1) */
+  cursorVersion?: number;
+  /**
+   * Minimum cursor version accepted. Bump alongside `cursorVersion` when a
+   * breaking format change ships so stale client cursors are rejected with a
+   * clear error instead of silently paginating from the wrong position.
+   * Default: 1 (accept any cursor <= cursorVersion).
+   */
+  minCursorVersion?: number;
+  /**
+   * Allowlist of primary sort fields for keyset pagination. When set, any
+   * `getAll({ sort })` whose primary (non-_id) field is not in this list
+   * throws at validation time.
+   *
+   * Use this to lock down keyset pagination to fields that are structurally
+   * guaranteed non-null in your schema — keyset sort across null/non-null
+   * boundaries is lossy (MongoDB's `$lt/$gt` semantics leave a gap at the
+   * type boundary, so not every doc is reachable).
+   *
+   * `_id` is always allowed regardless of this list.
+   * Undefined (default) = no allowlist, any sort field accepted.
+   */
+  strictKeysetSortFields?: string[];
+  /** Use estimatedDocumentCount for faster counts on large collections */
+  useEstimatedCount?: boolean;
+}
+/** MongoDB collation options for locale-aware string comparison */
+interface CollationOptions {
+  locale: string;
+  caseLevel?: boolean;
+  caseFirst?: 'upper' | 'lower' | 'off';
+  strength?: 1 | 2 | 3 | 4 | 5;
+  numericOrdering?: boolean;
+  alternate?: 'non-ignorable' | 'shifted';
+  maxVariable?: 'punct' | 'space';
+  backwards?: boolean;
+}
+/** Base pagination options */
+interface BasePaginationOptions {
+  /** Pagination mode (explicit override) */
+  mode?: 'offset' | 'keyset';
+  /** MongoDB query filters */
+  filters?: FilterQuery<AnyDocument>;
+  /** Sort specification */
+  sort?: SortSpec;
+  /** Number of documents per page */
+  limit?: number;
+  /** Fields to select */
+  select?: SelectSpec;
+  /** Fields to populate */
+  populate?: PopulateSpec;
+  /** Return plain JavaScript objects */
+  lean?: boolean;
+  /** MongoDB session for transactions */
+  session?: unknown;
+  /** Query hint (index name or document) */
+  hint?: string | Record<string, 1 | -1>;
+  /** Maximum execution time in milliseconds */
+  maxTimeMS?: number;
+  /** Read preference for replica sets (e.g. 'secondaryPreferred') */
+  readPreference?: ReadPreferenceType;
+  /** Collation for locale-aware string comparison and case-insensitive sorting */
+  collation?: CollationOptions;
+}
+/** Offset pagination options */
+interface OffsetPaginationOptions extends BasePaginationOptions {
+  /** Page number (1-indexed) */
+  page?: number;
+  /** Count strategy for filtered queries (default: 'exact') */
+  countStrategy?: 'exact' | 'estimated' | 'none';
+  /**
+   * Optional alternate filter used for the count query only. The primary
+   * `filters` is still used for `.find()`. Lets callers (Repository) run a
+   * sort-only query like `$near` for results while counting with a
+   * count-compatible rewrite (e.g. `$geoWithin: $centerSphere`) that
+   * returns the same document set but works with `countDocuments`.
+   */
+  countFilters?: FilterQuery<AnyDocument>;
+}
+/** Keyset (cursor) pagination options */
+interface KeysetPaginationOptions extends BasePaginationOptions {
+  /** Cursor token for next page */
+  after?: string;
+  /** Sort is required for keyset pagination */
+  sort: SortSpec;
+}
+/** Aggregate pagination options */
+interface AggregatePaginationOptions {
+  /** Aggregation pipeline stages */
+  pipeline?: PipelineStage[];
+  /** Page number (1-indexed) */
+  page?: number;
+  /** Number of documents per page */
+  limit?: number;
+  /** MongoDB session for transactions */
+  session?: unknown;
+  /** Query hint (index name or document) for aggregation */
+  hint?: string | Record<string, 1 | -1>;
+  /** Maximum execution time in milliseconds */
+  maxTimeMS?: number;
+  /** Count strategy (default: 'exact' via $facet).
+   * 'estimated' is accepted but treated as 'exact' in aggregation context
+   * since estimatedDocumentCount is not available inside pipelines. */
+  countStrategy?: 'exact' | 'estimated' | 'none';
+  /** Pagination mode (reserved for API consistency) */
+  mode?: 'offset';
+  /** Read preference for replica sets (e.g. 'secondaryPreferred') */
+  readPreference?: ReadPreferenceType;
+}
+/** Value type identifier for cursor serialization */
+type ValueType = 'date' | 'objectid' | 'boolean' | 'number' | 'string' | 'null' | 'unknown';
+/** Cursor payload */
+interface CursorPayload {
+  /** Primary sort field value (legacy single-field) */
+  v: string | number | boolean | null;
+  /** Value type identifier (legacy single-field) */
+  t: ValueType;
+  /** Document ID */
+  id: string;
+  /** ID type identifier */
+  idType: ValueType;
+  /** Sort specification */
+  sort: SortSpec;
+  /** Cursor version */
+  ver: number;
+  /** Compound sort field values (multi-field keyset) */
+  vals?: Record<string, string | number | boolean | null>;
+  /** Compound sort value types */
+  types?: Record<string, ValueType>;
+}
+/** Decoded cursor */
+interface DecodedCursor {
+  /** Primary sort field value (rehydrated) — legacy compat */
+  value: unknown;
+  /** Document ID (rehydrated) */
+  id: ObjectId | string;
+  /** Sort specification */
+  sort: SortSpec;
+  /** Cursor version */
+  version: number;
+  /** All sort field values (rehydrated) — for compound sort */
+  values?: Record<string, unknown>;
+}
+//#endregion
+export { DecodedCursor as a, PaginationConfig as c, CursorPayload as i, ValueType as l, BasePaginationOptions as n, KeysetPaginationOptions as o, CollationOptions as r, OffsetPaginationOptions as s, AggregatePaginationOptions as t };

package/dist/plugin-options-vFufQZMZ.d.mts

@@ -0,0 +1,125 @@
+import { a as PopulateSpec, i as ObjectId, l as SortSpec, s as SelectSpec } from "./core-62oo3N1C.mjs";
+import { h as RepositoryInstance, p as RepositoryContext } from "./repository-DCHRWRXw.mjs";
+import { OffsetPaginationResult } from "@classytic/repo-core/pagination";
+//#region src/types/plugin-options.d.ts
+/** Field preset configuration (field-filter plugin) */
+interface FieldPreset {
+  /** Fields visible to everyone */
+  public: string[];
+  /** Additional fields for authenticated users */
+  authenticated?: string[];
+  /** Additional fields for admins */
+  admin?: string[];
+}
+/** Validator definition (validation-chain plugin) */
+interface ValidatorDefinition {
+  /** Validator name */
+  name: string;
+  /** Operations to apply validator to */
+  operations?: Array<'create' | 'createMany' | 'update' | 'findOneAndUpdate' | 'delete'>;
+  /** Validation function */
+  validate: (context: RepositoryContext, repo?: RepositoryInstance) => void | Promise<void>;
+}
+/** Validation chain options */
+interface ValidationChainOptions {
+  /** Stop on first validation error (default: true) */
+  stopOnFirstError?: boolean;
+}
+/** Logger interface for audit plugin */
+interface Logger {
+  info?(message: string, meta?: Record<string, unknown>): void;
+  error?(message: string, meta?: Record<string, unknown>): void;
+  warn?(message: string, meta?: Record<string, unknown>): void;
+  debug?(message: string, meta?: Record<string, unknown>): void;
+}
+/** Filter mode for soft delete queries */
+type SoftDeleteFilterMode = 'null' | 'exists';
+/** Soft delete plugin options */
+interface SoftDeleteOptions {
+  /** Field name for deletion timestamp (default: 'deletedAt') */
+  deletedField?: string;
+  /** Field name for deleting user (default: 'deletedBy') */
+  deletedByField?: string;
+  /** Enable soft delete (default: true) */
+  soft?: boolean;
+  /**
+   * Filter mode for excluding deleted documents (default: 'null')
+   * - 'null': Filters where deletedField is null (works with `default: null` in schema)
+   * - 'exists': Filters where deletedField does not exist (legacy behavior)
+   */
+  filterMode?: SoftDeleteFilterMode;
+  /** Add restore method to repository (default: true) */
+  addRestoreMethod?: boolean;
+  /** Add getDeleted method to repository (default: true) */
+  addGetDeletedMethod?: boolean;
+  /**
+   * TTL in days for auto-cleanup of deleted documents.
+   * When set, creates a TTL index on the deletedField.
+   * Documents will be automatically removed after the specified days.
+   */
+  ttlDays?: number;
+}
+/** Repository with soft delete methods */
+interface SoftDeleteRepository<TDoc = unknown> {
+  /**
+   * Restore a soft-deleted document by setting deletedAt to null
+   * @param id - Document ID to restore
+   * @param options - Optional session for transactions
+   * @returns The restored document
+   */
+  restore(id: string | ObjectId, options?: {
+    session?: unknown;
+  }): Promise<TDoc>;
+  /**
+   * Get all soft-deleted documents
+   * @param params - Query parameters (filters, pagination, etc.)
+   * @param options - Query options (select, populate, etc.)
+   * @returns Paginated result of deleted documents
+   */
+  getDeleted(params?: {
+    filters?: Record<string, unknown>;
+    sort?: SortSpec | string;
+    page?: number;
+    limit?: number;
+  }, options?: {
+    select?: SelectSpec;
+    populate?: PopulateSpec;
+    lean?: boolean;
+    session?: unknown;
+  }): Promise<OffsetPaginationResult<TDoc>>;
+}
+/** Cascade relation definition */
+interface CascadeRelation {
+  /**
+   * Preferred: a Repository instance for the target collection. When present,
+   * cascade routes deletes through `repo.delete` / `repo.deleteMany`, so the
+   * target's `before:delete` / `before:deleteMany` hooks fire — meaning
+   * multi-tenant scoping, audit logging, cache invalidation, and the target's
+   * own soft-delete plugin (with its configured `deletedField`) all run
+   * correctly. Strongly recommended for any target that has policy plugins.
+   */
+  repo?: RepositoryInstance;
+  /**
+   * Legacy: a Mongoose model name. When set without `repo`, cascade writes
+   * directly via `RelatedModel.updateMany` / `RelatedModel.deleteMany`. This
+   * path bypasses the target's hooks — it will NOT enforce tenant scoping,
+   * fire audit events, or honor a custom `deletedField`. Only safe for
+   * trivial targets with no policy plugins. Prefer `repo` for new code.
+   */
+  model?: string;
+  /** Foreign key field in the related model that references the deleted document */
+  foreignKey: string;
+  /** Whether to use soft delete if available (default: follows parent behavior) */
+  softDelete?: boolean;
+}
+/** Cascade delete plugin options */
+interface CascadeOptions {
+  /** Relations to cascade delete */
+  relations: CascadeRelation[];
+  /** Run cascade deletes in parallel (default: true) */
+  parallel?: boolean;
+  /** Logger for cascade operations */
+  logger?: Logger;
+}
+//#endregion
+export { SoftDeleteFilterMode as a, ValidationChainOptions as c, Logger as i, ValidatorDefinition as l, CascadeRelation as n, SoftDeleteOptions as o, FieldPreset as r, SoftDeleteRepository as s, CascadeOptions as t };

package/dist/plugins/index.d.mts

@@ -1,6 +1,6 @@
-import { Dt as MongoKitPluginName, Et as MONGOKIT_PLUGIN_NAMES, G as Plugin, Ot as RepositoryPluginName } from "../types-BtMuhoX5.mjs";
-import { C as AuditTrailMethods, E as auditTrailPlugin, S as AuditQueryResult, T as AuditTrailQuery, _ as RepositoryCachePluginOptions, a as DateSequentialIdOptions, b as AuditOperation, c as SequentialIdOptions, d as getNextSequence, f as prefixedId, g as RepositoryCacheHandle, h as CacheOptions, i as CustomIdOptions, l as customIdPlugin, m as CacheAdapter, o as IdGenerator, p as sequentialId, r as multiTenantPlugin, s as PrefixedIdOptions, t as MultiTenantOptions, u as dateSequentialId, v as cachePlugin, w as AuditTrailOptions, x as AuditQueryOptions, y as AuditEntry } from "../multi-tenant.plugin-BjXXuc_g.mjs";
-import { A as elasticSearchPlugin, C as LeasePluginOptions, D as immutableStatesPlugin, E as ImmutableStatesPluginOptions, F as auditLogPlugin, I as AppendOnlyPluginOptions, L as appendOnlyPlugin, M as BatchOperationsMethods, O as fieldFilterPlugin, P as batchOperationsPlugin, R as AggregateHelpersMethods, S as LeaseMethods, T as ImmutableClaimView, _ as observabilityPlugin, a as uniqueField, b as MethodRegistryRepository, c as TenantContext, d as SubdocumentMethods, f as subdocumentPlugin, g as OperationMetric, h as ObservabilityOptions, i as requireField, j as cascadePlugin, k as ElasticSearchOptions, l as TenantStore, m as softDeletePlugin, n as blockIf, o as validationChainPlugin, p as SoftDeleteMethods, r as immutableField, s as timestampPlugin, t as autoInject, u as createTenantContext, v as MongoOperationsMethods, w as leasePlugin, x as methodRegistryPlugin, y as mongoOperationsPlugin, z as aggregateHelpersPlugin } from "../validation-chain.plugin-CFJbr964.mjs";
+import { S as RepositoryPluginName, b as MONGOKIT_PLUGIN_NAMES, l as Plugin, x as MongoKitPluginName } from "../repository-DCHRWRXw.mjs";
+import { A as ensureAuditTrailReady, C as AuditTrailMethods, D as AuditTrailQueryOptions, E as AuditTrailQuery, O as EnsureAuditTrailReadyOptions, S as AuditQueryResult, T as AuditTrailOptions, _ as RepositoryCachePluginOptions, a as DateSequentialIdOptions, b as AuditOperation, c as SequentialIdOptions, d as getNextSequence, f as prefixedId, g as RepositoryCacheHandle, h as CacheOptions, i as CustomIdOptions, k as auditTrailPlugin, l as customIdPlugin, m as CacheAdapter, o as IdGenerator, p as sequentialId, r as multiTenantPlugin, s as PrefixedIdOptions, t as MultiTenantOptions, u as dateSequentialId, v as cachePlugin, w as AuditTrailMode, x as AuditQueryOptions, y as AuditEntry } from "../multi-tenant.plugin-DVyVGREb.mjs";
+import { A as elasticSearchPlugin, C as LeasePluginOptions, D as immutableStatesPlugin, E as ImmutableStatesPluginOptions, F as auditLogPlugin, I as AppendOnlyPluginOptions, L as appendOnlyPlugin, M as BatchOperationsMethods, O as fieldFilterPlugin, P as batchOperationsPlugin, R as AggregateHelpersMethods, S as LeaseMethods, T as ImmutableClaimView, _ as observabilityPlugin, a as uniqueField, b as MethodRegistryRepository, c as TenantContext, d as SubdocumentMethods, f as subdocumentPlugin, g as OperationMetric, h as ObservabilityOptions, i as requireField, j as cascadePlugin, k as ElasticSearchOptions, l as TenantStore, m as softDeletePlugin, n as blockIf, o as validationChainPlugin, p as SoftDeleteMethods, r as immutableField, s as timestampPlugin, t as autoInject, u as createTenantContext, v as MongoOperationsMethods, w as leasePlugin, x as methodRegistryPlugin, y as mongoOperationsPlugin, z as aggregateHelpersPlugin } from "../validation-chain.plugin-DxD15h-2.mjs";
 import { ChangeLogStore } from "@classytic/repo-core/sync";
 //#region src/plugins/change-log.plugin.d.ts
 interface ChangeLogPluginOptions {
@@ -15,4 +15,4 @@ interface ChangeLogPluginOptions {
 }
 declare function changeLogPlugin(options: ChangeLogPluginOptions): Plugin;
 //#endregion
-export { type AggregateHelpersMethods, type AppendOnlyPluginOptions, type AuditEntry, type AuditOperation, type AuditQueryOptions, type AuditQueryResult, type AuditTrailMethods, type AuditTrailOptions, AuditTrailQuery, type BatchOperationsMethods, type CacheAdapter, type CacheOptions, type ChangeLogPluginOptions, type CustomIdOptions, type DateSequentialIdOptions, type ElasticSearchOptions, type IdGenerator, type ImmutableClaimView, type ImmutableStatesPluginOptions, type LeaseMethods, type LeasePluginOptions, MONGOKIT_PLUGIN_NAMES, type MethodRegistryRepository, type MongoKitPluginName, type MongoOperationsMethods, type MultiTenantOptions, type ObservabilityOptions, type OperationMetric, type PrefixedIdOptions, type RepositoryCacheHandle, type RepositoryCachePluginOptions, type RepositoryPluginName, type SequentialIdOptions, type SoftDeleteMethods, type SubdocumentMethods, type TenantContext, type TenantStore, aggregateHelpersPlugin, appendOnlyPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, changeLogPlugin, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, fieldFilterPlugin, getNextSequence, immutableField, immutableStatesPlugin, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };
+export { type AggregateHelpersMethods, type AppendOnlyPluginOptions, type AuditEntry, type AuditOperation, type AuditQueryOptions, type AuditQueryResult, type AuditTrailMethods, type AuditTrailMode, type AuditTrailOptions, AuditTrailQuery, type AuditTrailQueryOptions, type BatchOperationsMethods, type CacheAdapter, type CacheOptions, type ChangeLogPluginOptions, type CustomIdOptions, type DateSequentialIdOptions, type ElasticSearchOptions, type EnsureAuditTrailReadyOptions, type IdGenerator, type ImmutableClaimView, type ImmutableStatesPluginOptions, type LeaseMethods, type LeasePluginOptions, MONGOKIT_PLUGIN_NAMES, type MethodRegistryRepository, type MongoKitPluginName, type MongoOperationsMethods, type MultiTenantOptions, type ObservabilityOptions, type OperationMetric, type PrefixedIdOptions, type RepositoryCacheHandle, type RepositoryCachePluginOptions, type RepositoryPluginName, type SequentialIdOptions, type SoftDeleteMethods, type SubdocumentMethods, type TenantContext, type TenantStore, aggregateHelpersPlugin, appendOnlyPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, changeLogPlugin, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, ensureAuditTrailReady, fieldFilterPlugin, getNextSequence, immutableField, immutableStatesPlugin, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };

package/dist/plugins/index.mjs

@@ -1,5 +1,5 @@
-import { a as methodRegistryPlugin, c as getNextSequence, d as cachePlugin, f as batchOperationsPlugin, h as auditLogPlugin, i as multiTenantPlugin, l as prefixedId, m as auditTrailPlugin, n as softDeletePlugin, o as customIdPlugin, p as AuditTrailQuery, s as dateSequentialId, t as timestampPlugin, u as sequentialId } from "../timestamp.plugin-BhSX0Lu_.mjs";
-import { _ as appendOnlyPlugin, a as uniqueField, c as subdocumentPlugin, d as mongoOperationsPlugin, f as leasePlugin, g as cascadePlugin, h as elasticSearchPlugin, i as requireField, l as observabilityPlugin, m as fieldFilterPlugin, n as blockIf, o as validationChainPlugin, p as immutableStatesPlugin, r as immutableField, s as createTenantContext, t as autoInject, u as MONGOKIT_PLUGIN_NAMES, v as aggregateHelpersPlugin } from "../validation-chain.plugin-Dtt4tO7R.mjs";
+import { a as methodRegistryPlugin, c as getNextSequence, d as cachePlugin, f as batchOperationsPlugin, g as auditLogPlugin, h as ensureAuditTrailReady, i as multiTenantPlugin, l as prefixedId, m as auditTrailPlugin, n as softDeletePlugin, o as customIdPlugin, p as AuditTrailQuery, s as dateSequentialId, t as timestampPlugin, u as sequentialId } from "../timestamp.plugin-B8252GuQ.mjs";
+import { _ as appendOnlyPlugin, a as uniqueField, c as subdocumentPlugin, d as mongoOperationsPlugin, f as leasePlugin, g as cascadePlugin, h as elasticSearchPlugin, i as requireField, l as observabilityPlugin, m as fieldFilterPlugin, n as blockIf, o as validationChainPlugin, p as immutableStatesPlugin, r as immutableField, s as createTenantContext, t as autoInject, u as MONGOKIT_PLUGIN_NAMES, v as aggregateHelpersPlugin } from "../validation-chain.plugin-C3Vwp-Rk.mjs";
 //#region src/plugins/change-log.plugin.ts
 const PLUGIN_NAME = "changeLog";
 function isSkipped(context) {
@@ -70,4 +70,4 @@ function changeLogPlugin(options) {
 	};
 }
 //#endregion
-export { AuditTrailQuery, MONGOKIT_PLUGIN_NAMES, aggregateHelpersPlugin, appendOnlyPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, changeLogPlugin, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, fieldFilterPlugin, getNextSequence, immutableField, immutableStatesPlugin, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };
+export { AuditTrailQuery, MONGOKIT_PLUGIN_NAMES, aggregateHelpersPlugin, appendOnlyPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, changeLogPlugin, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, ensureAuditTrailReady, fieldFilterPlugin, getNextSequence, immutableField, immutableStatesPlugin, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };

package/dist/query/primitives/coercion.mjs

@@ -1,4 +1,4 @@
-import { r as isObjectIdInstance } from "../../id-resolution-P2OzcyRl.mjs";
+import { r as isObjectIdInstance } from "../../id-resolution-BqDrk0S2.mjs";
 import mongoose from "mongoose";
 //#region src/query/primitives/coercion.ts
 /**

package/dist/query/primitives/geo.d.mts

@@ -14,7 +14,7 @@
  * `[nearSphere]`, or `[geoWithin]` operator on a field.
  */
 /** Geo operators recognized by the parser */
-declare const GEO_OPERATORS: readonly ['near', 'nearSphere', 'geoWithin', 'withinRadius'];
+declare const GEO_OPERATORS: readonly ["near", "nearSphere", "geoWithin", "withinRadius"];
 type GeoOperator = (typeof GEO_OPERATORS)[number];
 /**
  * True iff `operator` is one of the geo operators we handle.