@zodmon/core 0.4.0 → 0.5.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { ObjectId, Collection, MongoClientOptions } from 'mongodb';
+import { ObjectId, FindCursor, Collection, MongoClientOptions } from 'mongodb';
 import { ZodPipe, ZodCustom, ZodTransform, z, ZodDefault } from 'zod';
 
 /**
@@ -290,6 +290,124 @@ type CollectionDefinition<TShape extends z.core.$ZodShape = z.core.$ZodShape> =
 /** Erased collection type for use in generic contexts. */
 type AnyCollection = CollectionDefinition<z.core.$ZodShape>;
 
+/**
+ * Type-safe sort specification for a document type.
+ *
+ * Constrains sort keys to top-level fields of `T` with direction `1` (ascending)
+ * or `-1` (descending). Dot-path sorts deferred to v1.0.
+ *
+ * @example
+ * ```ts
+ * const sort: TypedSort<User> = { name: 1, createdAt: -1 }
+ * ```
+ */
+type TypedSort<T> = Partial<Record<keyof T & string, 1 | -1>>;
+/**
+ * Type-safe cursor wrapping MongoDB's `FindCursor`.
+ *
+ * Provides chainable query modifiers (`sort`, `skip`, `limit`) that return
+ * `this` for fluent chaining, and terminal methods (`toArray`,
+ * `[Symbol.asyncIterator]`) that validate each document against the
+ * collection's Zod schema before returning.
+ *
+ * Created by {@link find} — do not construct directly.
+ *
+ * @typeParam TDef - The collection definition type, used to infer the document type.
+ *
+ * @example
+ * ```ts
+ * const docs = await find(users, { role: 'admin' })
+ *   .sort({ name: 1 })
+ *   .limit(10)
+ *   .toArray()
+ * ```
+ */
+declare class TypedFindCursor<TDef extends AnyCollection> {
+    /** @internal */
+    private cursor;
+    /** @internal */
+    private schema;
+    /** @internal */
+    private collectionName;
+    /** @internal */
+    private mode;
+    /** @internal */
+    constructor(cursor: FindCursor<InferDocument<TDef>>, definition: TDef, mode: ValidationMode | false);
+    /**
+     * Set the sort order for the query.
+     *
+     * Only top-level document fields are accepted as sort keys.
+     * Values must be `1` (ascending) or `-1` (descending).
+     *
+     * @param spec - Sort specification mapping field names to sort direction.
+     * @returns `this` for chaining.
+     *
+     * @example
+     * ```ts
+     * find(users, {}).sort({ name: 1, age: -1 }).toArray()
+     * ```
+     */
+    sort(spec: TypedSort<InferDocument<TDef>>): this;
+    /**
+     * Skip the first `n` documents in the result set.
+     *
+     * @param n - Number of documents to skip.
+     * @returns `this` for chaining.
+     *
+     * @example
+     * ```ts
+     * find(users, {}).skip(10).limit(10).toArray() // page 2
+     * ```
+     */
+    skip(n: number): this;
+    /**
+     * Limit the number of documents returned.
+     *
+     * @param n - Maximum number of documents to return.
+     * @returns `this` for chaining.
+     *
+     * @example
+     * ```ts
+     * find(users, {}).limit(10).toArray() // at most 10 docs
+     * ```
+     */
+    limit(n: number): this;
+    /**
+     * Execute the query and return all matching documents as an array.
+     *
+     * Each document is validated against the collection's Zod schema
+     * according to the resolved validation mode.
+     *
+     * @returns Array of validated documents.
+     * @throws {ZodmonValidationError} When a document fails schema validation in strict/strip mode.
+     *
+     * @example
+     * ```ts
+     * const admins = await find(users, { role: 'admin' }).toArray()
+     * ```
+     */
+    toArray(): Promise<InferDocument<TDef>[]>;
+    /**
+     * Async iterator for streaming documents one at a time.
+     *
+     * Each yielded document is validated against the collection's Zod schema.
+     * Memory-efficient for large result sets.
+     *
+     * @yields Validated documents one at a time.
+     * @throws {ZodmonValidationError} When a document fails schema validation.
+     *
+     * @example
+     * ```ts
+     * for await (const user of find(users, {})) {
+     *   console.log(user.name)
+     * }
+     * ```
+     */
+    [Symbol.asyncIterator](): AsyncGenerator<InferDocument<TDef>>;
+    /** @internal Validate a single raw document against the schema. */
+    private validateDoc;
+}
+
 /**
  * Comparison operators for a field value of type `V`.
  *
@@ -464,6 +582,44 @@ declare function findOne<TDef extends AnyCollection>(handle: CollectionHandle<TD
  * ```
  */
 declare function findOneOrThrow<TDef extends AnyCollection>(handle: CollectionHandle<TDef>, filter: TypedFilter<InferDocument<TDef>>, options?: FindOneOptions): Promise<InferDocument<TDef>>;
+/**
+ * Options for {@link find}.
+ */
+type FindOptions = {
+    /** Override the collection-level validation mode, or `false` to skip validation entirely. */
+    validate?: ValidationMode | false;
+};
+/**
+ * Find all documents matching the filter, returning a chainable typed cursor.
+ *
+ * The cursor is lazy — no query is executed until a terminal method
+ * (`toArray`, `for await`) is called. Use `sort`, `skip`, and `limit`
+ * to shape the query before executing.
+ *
+ * Each document is validated against the collection's Zod schema when
+ * a terminal method consumes it.
+ *
+ * @param handle - The collection handle to query.
+ * @param filter - Type-safe filter to match documents.
+ * @param options - Optional validation overrides.
+ * @returns A typed cursor for chaining query modifiers.
+ *
+ * @example
+ * ```ts
+ * const admins = await find(users, { role: 'admin' })
+ *   .sort({ name: 1 })
+ *   .limit(10)
+ *   .toArray()
+ * ```
+ *
+ * @example
+ * ```ts
+ * for await (const user of find(users, {})) {
+ *   console.log(user.name)
+ * }
+ * ```
+ */
+declare function find<TDef extends AnyCollection>(handle: CollectionHandle<TDef>, filter: TypedFilter<InferDocument<TDef>>, options?: FindOptions): TypedFindCursor<TDef>;
 
 /**
  * Typed wrapper around a MongoDB driver `Collection`.
@@ -561,6 +717,27 @@ declare class CollectionHandle<TDef extends AnyCollection = AnyCollection> {
      * ```
      */
     findOneOrThrow(filter: TypedFilter<InferDocument<TDef>>, options?: FindOneOptions): Promise<InferDocument<TDef>>;
+    /**
+     * Find all documents matching the filter, returning a chainable typed cursor.
+     *
+     * The cursor is lazy — no query is executed until a terminal method
+     * (`toArray`, `for await`) is called. Use `sort`, `skip`, and `limit`
+     * to shape the query before executing.
+     *
+     * @param filter - Type-safe filter to match documents.
+     * @param options - Optional validation overrides.
+     * @returns A typed cursor for chaining query modifiers.
+     *
+     * @example
+     * ```ts
+     * const users = db.use(Users)
+     * const admins = await users.find({ role: 'admin' })
+     *   .sort({ name: 1 })
+     *   .limit(10)
+     *   .toArray()
+     * ```
+     */
+    find(filter: TypedFilter<InferDocument<TDef>>, options?: FindOptions): TypedFindCursor<TDef>;
 }
 
 /**
@@ -1144,4 +1321,4 @@ declare function getRefMetadata(schema: unknown): RefMetadata | undefined;
  */
 declare function installRefExtension(): void;
 
-export { $and, $eq, $exists, $gt, $gte, $in, $lt, $lte, $ne, $nin, $nor, $not, $or, $regex, type AnyCollection, type CollectionDefinition, CollectionHandle, type CollectionOptions, type ComparisonOperators, type CompoundIndexDefinition, Database, type DotPathType, type DotPaths, type FieldIndexDefinition, type FindOneOptions, IndexBuilder, type IndexMetadata, type IndexOptions, type InferDocument, type InferInsert, type RefMarker, type RefMetadata, type ResolvedShape, type TypedFilter, type ValidationMode, type ZodObjectId, ZodmonNotFoundError, ZodmonValidationError, collection, createClient, extractDbName, extractFieldIndexes, findOne, findOneOrThrow, getIndexMetadata, getRefMetadata, index, insertMany, insertOne, installExtensions, installRefExtension, isOid, objectId, oid, raw };
+export { $and, $eq, $exists, $gt, $gte, $in, $lt, $lte, $ne, $nin, $nor, $not, $or, $regex, type AnyCollection, type CollectionDefinition, CollectionHandle, type CollectionOptions, type ComparisonOperators, type CompoundIndexDefinition, Database, type DotPathType, type DotPaths, type FieldIndexDefinition, type FindOneOptions, type FindOptions, IndexBuilder, type IndexMetadata, type IndexOptions, type InferDocument, type InferInsert, type RefMarker, type RefMetadata, type ResolvedShape, type TypedFilter, TypedFindCursor, type TypedSort, type ValidationMode, type ZodObjectId, ZodmonNotFoundError, ZodmonValidationError, collection, createClient, extractDbName, extractFieldIndexes, find, findOne, findOneOrThrow, getIndexMetadata, getRefMetadata, index, insertMany, insertOne, installExtensions, installRefExtension, isOid, objectId, oid, raw };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ObjectId, Collection, MongoClientOptions } from 'mongodb';
+import { ObjectId, FindCursor, Collection, MongoClientOptions } from 'mongodb';
 import { ZodPipe, ZodCustom, ZodTransform, z, ZodDefault } from 'zod';
 
 /**
@@ -290,6 +290,124 @@ type CollectionDefinition<TShape extends z.core.$ZodShape = z.core.$ZodShape> =
 /** Erased collection type for use in generic contexts. */
 type AnyCollection = CollectionDefinition<z.core.$ZodShape>;
 
+/**
+ * Type-safe sort specification for a document type.
+ *
+ * Constrains sort keys to top-level fields of `T` with direction `1` (ascending)
+ * or `-1` (descending). Dot-path sorts deferred to v1.0.
+ *
+ * @example
+ * ```ts
+ * const sort: TypedSort<User> = { name: 1, createdAt: -1 }
+ * ```
+ */
+type TypedSort<T> = Partial<Record<keyof T & string, 1 | -1>>;
+/**
+ * Type-safe cursor wrapping MongoDB's `FindCursor`.
+ *
+ * Provides chainable query modifiers (`sort`, `skip`, `limit`) that return
+ * `this` for fluent chaining, and terminal methods (`toArray`,
+ * `[Symbol.asyncIterator]`) that validate each document against the
+ * collection's Zod schema before returning.
+ *
+ * Created by {@link find} — do not construct directly.
+ *
+ * @typeParam TDef - The collection definition type, used to infer the document type.
+ *
+ * @example
+ * ```ts
+ * const docs = await find(users, { role: 'admin' })
+ *   .sort({ name: 1 })
+ *   .limit(10)
+ *   .toArray()
+ * ```
+ */
+declare class TypedFindCursor<TDef extends AnyCollection> {
+    /** @internal */
+    private cursor;
+    /** @internal */
+    private schema;
+    /** @internal */
+    private collectionName;
+    /** @internal */
+    private mode;
+    /** @internal */
+    constructor(cursor: FindCursor<InferDocument<TDef>>, definition: TDef, mode: ValidationMode | false);
+    /**
+     * Set the sort order for the query.
+     *
+     * Only top-level document fields are accepted as sort keys.
+     * Values must be `1` (ascending) or `-1` (descending).
+     *
+     * @param spec - Sort specification mapping field names to sort direction.
+     * @returns `this` for chaining.
+     *
+     * @example
+     * ```ts
+     * find(users, {}).sort({ name: 1, age: -1 }).toArray()
+     * ```
+     */
+    sort(spec: TypedSort<InferDocument<TDef>>): this;
+    /**
+     * Skip the first `n` documents in the result set.
+     *
+     * @param n - Number of documents to skip.
+     * @returns `this` for chaining.
+     *
+     * @example
+     * ```ts
+     * find(users, {}).skip(10).limit(10).toArray() // page 2
+     * ```
+     */
+    skip(n: number): this;
+    /**
+     * Limit the number of documents returned.
+     *
+     * @param n - Maximum number of documents to return.
+     * @returns `this` for chaining.
+     *
+     * @example
+     * ```ts
+     * find(users, {}).limit(10).toArray() // at most 10 docs
+     * ```
+     */
+    limit(n: number): this;
+    /**
+     * Execute the query and return all matching documents as an array.
+     *
+     * Each document is validated against the collection's Zod schema
+     * according to the resolved validation mode.
+     *
+     * @returns Array of validated documents.
+     * @throws {ZodmonValidationError} When a document fails schema validation in strict/strip mode.
+     *
+     * @example
+     * ```ts
+     * const admins = await find(users, { role: 'admin' }).toArray()
+     * ```
+     */
+    toArray(): Promise<InferDocument<TDef>[]>;
+    /**
+     * Async iterator for streaming documents one at a time.
+     *
+     * Each yielded document is validated against the collection's Zod schema.
+     * Memory-efficient for large result sets.
+     *
+     * @yields Validated documents one at a time.
+     * @throws {ZodmonValidationError} When a document fails schema validation.
+     *
+     * @example
+     * ```ts
+     * for await (const user of find(users, {})) {
+     *   console.log(user.name)
+     * }
+     * ```
+     */
+    [Symbol.asyncIterator](): AsyncGenerator<InferDocument<TDef>>;
+    /** @internal Validate a single raw document against the schema. */
+    private validateDoc;
+}
+
 /**
  * Comparison operators for a field value of type `V`.
  *
@@ -464,6 +582,44 @@ declare function findOne<TDef extends AnyCollection>(handle: CollectionHandle<TD
  * ```
  */
 declare function findOneOrThrow<TDef extends AnyCollection>(handle: CollectionHandle<TDef>, filter: TypedFilter<InferDocument<TDef>>, options?: FindOneOptions): Promise<InferDocument<TDef>>;
+/**
+ * Options for {@link find}.
+ */
+type FindOptions = {
+    /** Override the collection-level validation mode, or `false` to skip validation entirely. */
+    validate?: ValidationMode | false;
+};
+/**
+ * Find all documents matching the filter, returning a chainable typed cursor.
+ *
+ * The cursor is lazy — no query is executed until a terminal method
+ * (`toArray`, `for await`) is called. Use `sort`, `skip`, and `limit`
+ * to shape the query before executing.
+ *
+ * Each document is validated against the collection's Zod schema when
+ * a terminal method consumes it.
+ *
+ * @param handle - The collection handle to query.
+ * @param filter - Type-safe filter to match documents.
+ * @param options - Optional validation overrides.
+ * @returns A typed cursor for chaining query modifiers.
+ *
+ * @example
+ * ```ts
+ * const admins = await find(users, { role: 'admin' })
+ *   .sort({ name: 1 })
+ *   .limit(10)
+ *   .toArray()
+ * ```
+ *
+ * @example
+ * ```ts
+ * for await (const user of find(users, {})) {
+ *   console.log(user.name)
+ * }
+ * ```
+ */
+declare function find<TDef extends AnyCollection>(handle: CollectionHandle<TDef>, filter: TypedFilter<InferDocument<TDef>>, options?: FindOptions): TypedFindCursor<TDef>;
 
 /**
  * Typed wrapper around a MongoDB driver `Collection`.
@@ -561,6 +717,27 @@ declare class CollectionHandle<TDef extends AnyCollection = AnyCollection> {
      * ```
      */
     findOneOrThrow(filter: TypedFilter<InferDocument<TDef>>, options?: FindOneOptions): Promise<InferDocument<TDef>>;
+    /**
+     * Find all documents matching the filter, returning a chainable typed cursor.
+     *
+     * The cursor is lazy — no query is executed until a terminal method
+     * (`toArray`, `for await`) is called. Use `sort`, `skip`, and `limit`
+     * to shape the query before executing.
+     *
+     * @param filter - Type-safe filter to match documents.
+     * @param options - Optional validation overrides.
+     * @returns A typed cursor for chaining query modifiers.
+     *
+     * @example
+     * ```ts
+     * const users = db.use(Users)
+     * const admins = await users.find({ role: 'admin' })
+     *   .sort({ name: 1 })
+     *   .limit(10)
+     *   .toArray()
+     * ```
+     */
+    find(filter: TypedFilter<InferDocument<TDef>>, options?: FindOptions): TypedFindCursor<TDef>;
 }
 
 /**
@@ -1144,4 +1321,4 @@ declare function getRefMetadata(schema: unknown): RefMetadata | undefined;
  */
 declare function installRefExtension(): void;
 
-export { $and, $eq, $exists, $gt, $gte, $in, $lt, $lte, $ne, $nin, $nor, $not, $or, $regex, type AnyCollection, type CollectionDefinition, CollectionHandle, type CollectionOptions, type ComparisonOperators, type CompoundIndexDefinition, Database, type DotPathType, type DotPaths, type FieldIndexDefinition, type FindOneOptions, IndexBuilder, type IndexMetadata, type IndexOptions, type InferDocument, type InferInsert, type RefMarker, type RefMetadata, type ResolvedShape, type TypedFilter, type ValidationMode, type ZodObjectId, ZodmonNotFoundError, ZodmonValidationError, collection, createClient, extractDbName, extractFieldIndexes, findOne, findOneOrThrow, getIndexMetadata, getRefMetadata, index, insertMany, insertOne, installExtensions, installRefExtension, isOid, objectId, oid, raw };
+export { $and, $eq, $exists, $gt, $gte, $in, $lt, $lte, $ne, $nin, $nor, $not, $or, $regex, type AnyCollection, type CollectionDefinition, CollectionHandle, type CollectionOptions, type ComparisonOperators, type CompoundIndexDefinition, Database, type DotPathType, type DotPaths, type FieldIndexDefinition, type FindOneOptions, type FindOptions, IndexBuilder, type IndexMetadata, type IndexOptions, type InferDocument, type InferInsert, type RefMarker, type RefMetadata, type ResolvedShape, type TypedFilter, TypedFindCursor, type TypedSort, type ValidationMode, type ZodObjectId, ZodmonNotFoundError, ZodmonValidationError, collection, createClient, extractDbName, extractFieldIndexes, find, findOne, findOneOrThrow, getIndexMetadata, getRefMetadata, index, insertMany, insertOne, installExtensions, installRefExtension, isOid, objectId, oid, raw };

package/dist/index.js

@@ -2,7 +2,7 @@
 import { MongoClient } from "mongodb";
 
 // src/crud/find.ts
-import { z } from "zod";
+import { z as z2 } from "zod";
 
 // src/errors/not-found.ts
 var ZodmonNotFoundError = class extends Error {
@@ -33,6 +33,127 @@ var ZodmonValidationError = class extends Error {
   }
 };
 
+// src/query/cursor.ts
+import { z } from "zod";
+var TypedFindCursor = class {
+  /** @internal */
+  cursor;
+  /** @internal */
+  schema;
+  /** @internal */
+  collectionName;
+  /** @internal */
+  mode;
+  /** @internal */
+  constructor(cursor, definition, mode) {
+    this.cursor = cursor;
+    this.schema = definition.schema;
+    this.collectionName = definition.name;
+    this.mode = mode;
+  }
+  /**
+   * Set the sort order for the query.
+   *
+   * Only top-level document fields are accepted as sort keys.
+   * Values must be `1` (ascending) or `-1` (descending).
+   *
+   * @param spec - Sort specification mapping field names to sort direction.
+   * @returns `this` for chaining.
+   *
+   * @example
+   * ```ts
+   * find(users, {}).sort({ name: 1, age: -1 }).toArray()
+   * ```
+   */
+  sort(spec) {
+    this.cursor.sort(spec);
+    return this;
+  }
+  /**
+   * Skip the first `n` documents in the result set.
+   *
+   * @param n - Number of documents to skip.
+   * @returns `this` for chaining.
+   *
+   * @example
+   * ```ts
+   * find(users, {}).skip(10).limit(10).toArray() // page 2
+   * ```
+   */
+  skip(n) {
+    this.cursor.skip(n);
+    return this;
+  }
+  /**
+   * Limit the number of documents returned.
+   *
+   * @param n - Maximum number of documents to return.
+   * @returns `this` for chaining.
+   *
+   * @example
+   * ```ts
+   * find(users, {}).limit(10).toArray() // at most 10 docs
+   * ```
+   */
+  limit(n) {
+    this.cursor.limit(n);
+    return this;
+  }
+  /**
+   * Execute the query and return all matching documents as an array.
+   *
+   * Each document is validated against the collection's Zod schema
+   * according to the resolved validation mode.
+   *
+   * @returns Array of validated documents.
+   * @throws {ZodmonValidationError} When a document fails schema validation in strict/strip mode.
+   *
+   * @example
+   * ```ts
+   * const admins = await find(users, { role: 'admin' }).toArray()
+   * ```
+   */
+  async toArray() {
+    const raw2 = await this.cursor.toArray();
+    return raw2.map((doc) => this.validateDoc(doc));
+  }
+  /**
+   * Async iterator for streaming documents one at a time.
+   *
+   * Each yielded document is validated against the collection's Zod schema.
+   * Memory-efficient for large result sets.
+   *
+   * @yields Validated documents one at a time.
+   * @throws {ZodmonValidationError} When a document fails schema validation.
+   *
+   * @example
+   * ```ts
+   * for await (const user of find(users, {})) {
+   *   console.log(user.name)
+   * }
+   * ```
+   */
+  async *[Symbol.asyncIterator]() {
+    for await (const doc of this.cursor) {
+      yield this.validateDoc(doc);
+    }
+  }
+  /** @internal Validate a single raw document against the schema. */
+  validateDoc(raw2) {
+    if (this.mode === false || this.mode === "passthrough") {
+      return raw2;
+    }
+    try {
+      return this.schema.parse(raw2);
+    } catch (err) {
+      if (err instanceof z.ZodError) {
+        throw new ZodmonValidationError(this.collectionName, err);
+      }
+      throw err;
+    }
+  }
+};
+
 // src/crud/find.ts
 async function findOne(handle, filter, options) {
   const findOptions = options?.project ? { projection: options.project } : void 0;
@@ -45,7 +166,7 @@ async function findOne(handle, filter, options) {
   try {
     return handle.definition.schema.parse(raw2);
   } catch (err) {
-    if (err instanceof z.ZodError) {
+    if (err instanceof z2.ZodError) {
       throw new ZodmonValidationError(handle.definition.name, err);
     }
     throw err;
@@ -58,15 +179,21 @@ async function findOneOrThrow(handle, filter, options) {
   }
   return doc;
 }
+function find(handle, filter, options) {
+  const raw2 = handle.native.find(filter);
+  const cursor = raw2;
+  const mode = options?.validate !== void 0 ? options.validate : handle.definition.options.validation;
+  return new TypedFindCursor(cursor, handle.definition, mode);
+}
 
 // src/crud/insert.ts
-import { z as z2 } from "zod";
+import { z as z3 } from "zod";
 async function insertOne(handle, doc) {
   let parsed;
   try {
     parsed = handle.definition.schema.parse(doc);
   } catch (err) {
-    if (err instanceof z2.ZodError) {
+    if (err instanceof z3.ZodError) {
       throw new ZodmonValidationError(handle.definition.name, err);
     }
     throw err;
@@ -81,7 +208,7 @@ async function insertMany(handle, docs) {
     try {
       parsed.push(handle.definition.schema.parse(doc));
     } catch (err) {
-      if (err instanceof z2.ZodError) {
+      if (err instanceof z3.ZodError) {
         throw new ZodmonValidationError(handle.definition.name, err);
       }
       throw err;
@@ -189,6 +316,29 @@ var CollectionHandle = class {
   async findOneOrThrow(filter, options) {
     return await findOneOrThrow(this, filter, options);
   }
+  /**
+   * Find all documents matching the filter, returning a chainable typed cursor.
+   *
+   * The cursor is lazy — no query is executed until a terminal method
+   * (`toArray`, `for await`) is called. Use `sort`, `skip`, and `limit`
+   * to shape the query before executing.
+   *
+   * @param filter - Type-safe filter to match documents.
+   * @param options - Optional validation overrides.
+   * @returns A typed cursor for chaining query modifiers.
+   *
+   * @example
+   * ```ts
+   * const users = db.use(Users)
+   * const admins = await users.find({ role: 'admin' })
+   *   .sort({ name: 1 })
+   *   .limit(10)
+   *   .toArray()
+   * ```
+   */
+  find(filter, options) {
+    return find(this, filter, options);
+  }
 };
 
 // src/client/client.ts
@@ -267,13 +417,13 @@ function createClient(uri, dbNameOrOptions, maybeOptions) {
 
 // src/collection/collection.ts
 import { ObjectId as ObjectId2 } from "mongodb";
-import { z as z6 } from "zod";
+import { z as z7 } from "zod";
 
 // src/schema/extensions.ts
-import { z as z4 } from "zod";
+import { z as z5 } from "zod";
 
 // src/schema/ref.ts
-import { z as z3 } from "zod";
+import { z as z4 } from "zod";
 var refMetadata = /* @__PURE__ */ new WeakMap();
 function getRefMetadata(schema) {
   if (typeof schema !== "object" || schema === null) return void 0;
@@ -281,7 +431,7 @@ function getRefMetadata(schema) {
 }
 var REF_GUARD = /* @__PURE__ */ Symbol.for("zodmon_ref");
 function installRefExtension() {
-  const proto = z3.ZodType.prototype;
+  const proto = z4.ZodType.prototype;
   if (REF_GUARD in proto) return;
   Object.defineProperty(proto, "ref", {
     value(collection2) {
@@ -308,7 +458,7 @@ function getIndexMetadata(schema) {
 }
 var GUARD = /* @__PURE__ */ Symbol.for("zodmon_extensions");
 function installExtensions() {
-  const proto = z4.ZodType.prototype;
+  const proto = z5.ZodType.prototype;
   if (GUARD in proto) return;
   Object.defineProperty(proto, "index", {
     /**
@@ -407,10 +557,10 @@ installExtensions();
 
 // src/schema/object-id.ts
 import { ObjectId } from "mongodb";
-import { z as z5 } from "zod";
+import { z as z6 } from "zod";
 var OBJECT_ID_HEX = /^[a-f\d]{24}$/i;
 function objectId() {
-  return z5.custom((val) => {
+  return z6.custom((val) => {
     if (val instanceof ObjectId) return true;
     return typeof val === "string" && OBJECT_ID_HEX.test(val);
   }, "Invalid ObjectId").transform((val) => val instanceof ObjectId ? val : ObjectId.createFromHexString(val));
@@ -429,7 +579,7 @@ function extractFieldIndexes(shape) {
 }
 function collection(name, shape, options) {
   const resolvedShape = "_id" in shape ? shape : { _id: objectId().default(() => new ObjectId2()), ...shape };
-  const schema = z6.object(resolvedShape);
+  const schema = z7.object(resolvedShape);
   const fieldIndexes = extractFieldIndexes(shape);
   const { indexes: compoundIndexes, validation, ...rest } = options ?? {};
   return {
@@ -528,12 +678,14 @@ export {
   CollectionHandle,
   Database,
   IndexBuilder,
+  TypedFindCursor,
   ZodmonNotFoundError,
   ZodmonValidationError,
   collection,
   createClient,
   extractDbName,
   extractFieldIndexes,
+  find,
   findOne,
   findOneOrThrow,
   getIndexMetadata,