mongo.do 0.1.0 → 0.1.1

package/dist/types/rpc.js

@@ -1,136 +0,0 @@
-/**
- * Consolidated RPC Types
- *
- * This module contains all shared RPC-related type definitions used across:
- * - src/rpc/rpc-target.ts
- * - src/rpc/rpc-client.ts
- * - src/rpc/endpoint.ts
- * - src/rpc/index.ts
- * - src/wire/backend/workers-proxy.ts
- */
-// ============================================================================
-// Legacy RPC Types (for src/rpc/index.ts message-based protocol)
-// ============================================================================
-/**
- * RPC message types for internal operations
- */
-export var MessageType;
-(function (MessageType) {
-    // Document operations
-    MessageType["INSERT_ONE"] = "insertOne";
-    MessageType["INSERT_MANY"] = "insertMany";
-    MessageType["FIND_ONE"] = "findOne";
-    MessageType["FIND"] = "find";
-    MessageType["UPDATE_ONE"] = "updateOne";
-    MessageType["UPDATE_MANY"] = "updateMany";
-    MessageType["DELETE_ONE"] = "deleteOne";
-    MessageType["DELETE_MANY"] = "deleteMany";
-    // Aggregation
-    MessageType["AGGREGATE"] = "aggregate";
-    MessageType["COUNT"] = "count";
-    MessageType["DISTINCT"] = "distinct";
-    // Index operations
-    MessageType["CREATE_INDEX"] = "createIndex";
-    MessageType["DROP_INDEX"] = "dropIndex";
-    MessageType["LIST_INDEXES"] = "listIndexes";
-    // Collection operations
-    MessageType["CREATE_COLLECTION"] = "createCollection";
-    MessageType["DROP_COLLECTION"] = "dropCollection";
-    MessageType["LIST_COLLECTIONS"] = "listCollections";
-    // Database operations
-    MessageType["STATS"] = "stats";
-    MessageType["HEALTH"] = "health";
-})(MessageType || (MessageType = {}));
-// ============================================================================
-// MongoDB Error Codes
-// ============================================================================
-/**
- * MongoDB-compatible error codes
- */
-export const ErrorCode = {
-    OK: 0,
-    INTERNAL_ERROR: 1,
-    BAD_VALUE: 2,
-    NO_SUCH_KEY: 4,
-    GRAPH_CONTAINS_CYCLE: 5,
-    HOST_UNREACHABLE: 6,
-    HOST_NOT_FOUND: 7,
-    UNKNOWN_ERROR: 8,
-    FAILED_TO_PARSE: 9,
-    CANNOT_MUTATE_OBJECT: 10,
-    USER_NOT_FOUND: 11,
-    UNSUPPORTED_FORMAT: 12,
-    UNAUTHORIZED: 13,
-    TYPE_MISMATCH: 14,
-    OVERFLOW: 15,
-    INVALID_LENGTH: 16,
-    PROTOCOL_ERROR: 17,
-    AUTHENTICATION_FAILED: 18,
-    CANNOT_REUSE_OBJECT: 19,
-    ILLEGAL_OPERATION: 20,
-    EMPTY_ARRAY_OPERATION: 21,
-    INVALID_BSON: 22,
-    ALREADY_INITIALIZED: 23,
-    LOCK_TIMEOUT: 24,
-    REMOTE_VALIDATION_ERROR: 25,
-    NAMESPACE_NOT_FOUND: 26,
-    INDEX_NOT_FOUND: 27,
-    PATH_NOT_VIABLE: 28,
-    NON_EXISTENT_PATH: 29,
-    INVALID_PATH: 30,
-    ROLE_NOT_FOUND: 31,
-    ROLES_NOT_RELATED: 32,
-    PRIVILEGE_NOT_FOUND: 33,
-    CANNOT_BACKFILL_ARRAY: 34,
-    COMMAND_NOT_FOUND: 59,
-    DATABASE_NOT_FOUND: 60,
-    LOCATION_ERROR: 16755,
-    DUPLICATE_KEY: 11000,
-};
-/**
- * Get the code name for an error code
- */
-export function getErrorCodeName(code) {
-    for (const [name, value] of Object.entries(ErrorCode)) {
-        if (value === code) {
-            return name
-                .split('_')
-                .map((word) => word.charAt(0) + word.slice(1).toLowerCase())
-                .join('');
-        }
-    }
-    return 'UnknownError';
-}
-// ============================================================================
-// Response Helper Functions
-// ============================================================================
-/**
- * Create a success response (Document format for wire protocol)
- */
-export function successResponse(data = {}) {
-    return { ok: 1, ...data };
-}
-/**
- * Create an error response (Document format for wire protocol)
- */
-export function errorResponse(code, errmsg, codeName) {
-    return {
-        ok: 0,
-        code,
-        codeName: codeName || getErrorCodeName(code),
-        errmsg,
-    };
-}
-/**
- * Create a legacy success response
- */
-export function legacySuccessResponse(data) {
-    return { success: true, data };
-}
-/**
- * Create a legacy error response
- */
-export function legacyErrorResponse(code, message) {
-    return { success: false, error: { code, message } };
-}
-//# sourceMappingURL=rpc.js.map

package/dist/types/rpc.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../src/types/rpc.ts"],"names":[],"mappings":"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"}

package/dist/types/vectorize.d.ts

@@ -1,136 +0,0 @@
-/**
- * Cloudflare Vectorize types for vector search
- *
- * These interfaces match the Cloudflare Vectorize API for compatibility
- * with the Workers AI embeddings and vector similarity search.
- */
-/**
- * Supported metadata value types for vector storage
- */
-export type VectorizeMetadataValue = string | number | boolean | string[];
-/**
- * Metadata object attached to vectors
- */
-export type VectorizeMetadata = Record<string, VectorizeMetadataValue>;
-/**
- * A vector with its ID, values, and optional metadata
- */
-export interface VectorizeVector {
-    /** Unique identifier for the vector */
-    id: string;
-    /** The embedding vector values */
-    values: number[] | Float32Array | Float64Array;
-    /** Optional namespace for organizing vectors */
-    namespace?: string;
-    /** Optional metadata attached to the vector */
-    metadata?: VectorizeMetadata;
-}
-/**
- * Options for querying vectors
- */
-export interface VectorizeQueryOptions {
-    /** Number of results to return (default: 10) */
-    topK?: number;
-    /** Optional namespace to search within */
-    namespace?: string;
-    /** Whether to return vector values (default: false) */
-    returnValues?: boolean;
-    /** Whether to return metadata (default: false) */
-    returnMetadata?: 'none' | 'indexed' | 'all';
-    /** Optional filter expression for metadata filtering */
-    filter?: Record<string, VectorizeMetadataValue>;
-}
-/**
- * A match result from a vector query
- */
-export interface VectorizeMatch {
-    /** The vector ID */
-    id: string;
-    /** Similarity score (higher is more similar) */
-    score: number;
-    /** The vector values (if returnValues was true) */
-    values?: number[];
-    /** The metadata (if returnMetadata was set) */
-    metadata?: VectorizeMetadata;
-}
-/**
- * Result from a vector query operation
- */
-export interface VectorizeQueryResult {
-    /** Number of matches returned */
-    count: number;
-    /** The matching vectors */
-    matches: VectorizeMatch[];
-}
-/**
- * Result from a vector mutation operation (insert, upsert, delete)
- */
-export interface VectorizeMutationResult {
-    /** Number of vectors affected */
-    count: number;
-    /** IDs of affected vectors */
-    ids: string[];
-}
-/**
- * Vectorize index interface matching Cloudflare's API
- */
-export interface VectorizeIndex {
-    /**
-     * Query the index for similar vectors
-     * @param vector - The query vector
-     * @param options - Query options
-     */
-    query(vector: number[] | Float32Array | Float64Array, options?: VectorizeQueryOptions): Promise<VectorizeQueryResult>;
-    /**
-     * Insert vectors into the index
-     * @param vectors - Vectors to insert
-     */
-    insert(vectors: VectorizeVector[]): Promise<VectorizeMutationResult>;
-    /**
-     * Upsert vectors into the index (insert or update)
-     * @param vectors - Vectors to upsert
-     */
-    upsert(vectors: VectorizeVector[]): Promise<VectorizeMutationResult>;
-    /**
-     * Delete vectors by ID
-     * @param ids - IDs of vectors to delete
-     */
-    deleteByIds(ids: string[]): Promise<VectorizeMutationResult>;
-    /**
-     * Get vectors by ID
-     * @param ids - IDs of vectors to retrieve
-     */
-    getByIds(ids: string[]): Promise<VectorizeVector[]>;
-    /**
-     * Describe the index configuration
-     */
-    describe(): Promise<{
-        dimensions: number;
-        vectorsCount: number;
-        config: {
-            dimensions: number;
-            metric: 'cosine' | 'euclidean' | 'dot-product';
-        };
-    }>;
-}
-/**
- * Workers AI binding interface for embeddings
- */
-export interface Ai {
-    /**
-     * Run an AI model
-     * @param model - The model identifier (e.g., '@cf/baai/bge-m3')
-     * @param inputs - The inputs for the model
-     */
-    run<T = unknown>(model: string, inputs: Record<string, unknown>): Promise<T>;
-}
-/**
- * Result from an embedding model
- */
-export interface EmbeddingResult {
-    /** The embedding vectors for each input */
-    data: number[][];
-    /** Shape of the embeddings [count, dimensions] */
-    shape: [number, number];
-}
-//# sourceMappingURL=vectorize.d.ts.map

package/dist/types/vectorize.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"vectorize.d.ts","sourceRoot":"","sources":["../../src/types/vectorize.ts"],"names":[],"mappings":"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"}

package/dist/types/vectorize.js

@@ -1,8 +0,0 @@
-/**
- * Cloudflare Vectorize types for vector search
- *
- * These interfaces match the Cloudflare Vectorize API for compatibility
- * with the Workers AI embeddings and vector similarity search.
- */
-export {};
-//# sourceMappingURL=vectorize.js.map

package/dist/types/vectorize.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"vectorize.js","sourceRoot":"","sources":["../../src/types/vectorize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/utils/sql-safety.d.ts

@@ -1,64 +0,0 @@
-/**
- * SQL Safety Utilities
- *
- * Functions to validate and sanitize field names and identifiers
- * to prevent SQL injection attacks.
- */
-/**
- * Validates and returns a field name/path for safe use in SQL json_extract expressions.
- * Prevents SQL injection by only allowing safe characters in field paths.
- *
- * @param field - The field name or dot-notation path to validate
- * @returns The validated field name (unchanged if valid)
- * @throws Error if field name contains invalid characters
- *
- * @example
- * validateFieldPath('name')           // returns 'name'
- * validateFieldPath('user.address')   // returns 'user.address'
- * validateFieldPath("foo'; DROP--")   // throws Error
- */
-export declare function validateFieldPath(field: string): string;
-/**
- * Validates an identifier (table name, index name, column name) for safe use in SQL.
- * Only allows alphanumeric characters and underscores, must start with letter or underscore.
- *
- * @param identifier - The identifier to validate
- * @returns The validated identifier (unchanged if valid)
- * @throws Error if identifier contains invalid characters
- *
- * @example
- * validateIdentifier('users')         // returns 'users'
- * validateIdentifier('my_table_1')    // returns 'my_table_1'
- * validateIdentifier('1table')        // throws Error (starts with number)
- * validateIdentifier("users'; DROP--")// throws Error
- */
-export declare function validateIdentifier(identifier: string): string;
-/**
- * Creates a safe JSON path expression for use in json_extract().
- * Validates the field name and returns the properly formatted path.
- *
- * @param field - The field name or dot-notation path
- * @returns The JSON path string (e.g., '$.field.name')
- * @throws Error if field name is invalid
- *
- * @example
- * safeJsonPath('name')         // returns '$.name'
- * safeJsonPath('user.address') // returns '$.user.address'
- * safeJsonPath('$special')     // returns '$.$special' (preserves leading $)
- */
-export declare function safeJsonPath(field: string): string;
-/**
- * Creates a safe json_extract expression for use in SQL.
- * Validates the field name and returns the complete expression.
- *
- * @param dataColumn - The name of the JSON data column (e.g., 'data', 'value')
- * @param field - The field name or dot-notation path
- * @returns The json_extract expression (e.g., "json_extract(data, '$.field')")
- * @throws Error if field name is invalid
- *
- * @example
- * safeJsonExtract('data', 'name')    // returns "json_extract(data, '$.name')"
- * safeJsonExtract('value', 'a.b')    // returns "json_extract(value, '$.a.b')"
- */
-export declare function safeJsonExtract(dataColumn: string, field: string): string;
-//# sourceMappingURL=sql-safety.d.ts.map

package/dist/utils/sql-safety.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sql-safety.d.ts","sourceRoot":"","sources":["../../src/utils/sql-safety.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAyBvD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAkB7D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIzE"}

package/dist/utils/sql-safety.js

@@ -1,112 +0,0 @@
-/**
- * SQL Safety Utilities
- *
- * Functions to validate and sanitize field names and identifiers
- * to prevent SQL injection attacks.
- */
-/**
- * Regular expression pattern for valid MongoDB field names.
- * Allows alphanumeric characters, underscores, dots (for nested paths),
- * hyphens, and dollar signs (for operators/special fields).
- */
-const SAFE_FIELD_PATTERN = /^[a-zA-Z0-9_.$-]+$/;
-/**
- * Regular expression pattern for valid SQL identifiers.
- * Only allows alphanumeric characters and underscores.
- */
-const SAFE_IDENTIFIER_PATTERN = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
-/**
- * Validates and returns a field name/path for safe use in SQL json_extract expressions.
- * Prevents SQL injection by only allowing safe characters in field paths.
- *
- * @param field - The field name or dot-notation path to validate
- * @returns The validated field name (unchanged if valid)
- * @throws Error if field name contains invalid characters
- *
- * @example
- * validateFieldPath('name')           // returns 'name'
- * validateFieldPath('user.address')   // returns 'user.address'
- * validateFieldPath("foo'; DROP--")   // throws Error
- */
-export function validateFieldPath(field) {
-    if (!field || field.length === 0) {
-        throw new Error('Field name cannot be empty');
-    }
-    // Check for null bytes
-    if (field.includes('\0')) {
-        throw new Error('Field name cannot contain null characters');
-    }
-    // Check against safe pattern
-    if (!SAFE_FIELD_PATTERN.test(field)) {
-        throw new Error(`Invalid field name: "${field}". Field names can only contain alphanumeric characters, underscores, dots, hyphens, and dollar signs.`);
-    }
-    // Validate dot notation structure
-    if (field.includes('..') || field.startsWith('.') || field.endsWith('.')) {
-        throw new Error(`Invalid field path: "${field}". Field paths cannot have consecutive, leading, or trailing dots.`);
-    }
-    return field;
-}
-/**
- * Validates an identifier (table name, index name, column name) for safe use in SQL.
- * Only allows alphanumeric characters and underscores, must start with letter or underscore.
- *
- * @param identifier - The identifier to validate
- * @returns The validated identifier (unchanged if valid)
- * @throws Error if identifier contains invalid characters
- *
- * @example
- * validateIdentifier('users')         // returns 'users'
- * validateIdentifier('my_table_1')    // returns 'my_table_1'
- * validateIdentifier('1table')        // throws Error (starts with number)
- * validateIdentifier("users'; DROP--")// throws Error
- */
-export function validateIdentifier(identifier) {
-    if (!identifier || identifier.length === 0) {
-        throw new Error('Identifier cannot be empty');
-    }
-    // Check for null bytes
-    if (identifier.includes('\0')) {
-        throw new Error('Identifier cannot contain null characters');
-    }
-    // Check against safe pattern
-    if (!SAFE_IDENTIFIER_PATTERN.test(identifier)) {
-        throw new Error(`Invalid identifier: "${identifier}". Identifiers can only contain alphanumeric characters and underscores, and must start with a letter or underscore.`);
-    }
-    return identifier;
-}
-/**
- * Creates a safe JSON path expression for use in json_extract().
- * Validates the field name and returns the properly formatted path.
- *
- * @param field - The field name or dot-notation path
- * @returns The JSON path string (e.g., '$.field.name')
- * @throws Error if field name is invalid
- *
- * @example
- * safeJsonPath('name')         // returns '$.name'
- * safeJsonPath('user.address') // returns '$.user.address'
- * safeJsonPath('$special')     // returns '$.$special' (preserves leading $)
- */
-export function safeJsonPath(field) {
-    const validField = validateFieldPath(field);
-    return validField.startsWith('$') ? validField : `$.${validField}`;
-}
-/**
- * Creates a safe json_extract expression for use in SQL.
- * Validates the field name and returns the complete expression.
- *
- * @param dataColumn - The name of the JSON data column (e.g., 'data', 'value')
- * @param field - The field name or dot-notation path
- * @returns The json_extract expression (e.g., "json_extract(data, '$.field')")
- * @throws Error if field name is invalid
- *
- * @example
- * safeJsonExtract('data', 'name')    // returns "json_extract(data, '$.name')"
- * safeJsonExtract('value', 'a.b')    // returns "json_extract(value, '$.a.b')"
- */
-export function safeJsonExtract(dataColumn, field) {
-    validateIdentifier(dataColumn);
-    const jsonPath = safeJsonPath(field);
-    return `json_extract(${dataColumn}, '${jsonPath}')`;
-}
-//# sourceMappingURL=sql-safety.js.map

package/dist/utils/sql-safety.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sql-safety.js","sourceRoot":"","sources":["../../src/utils/sql-safety.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,kBAAkB,GAAG,oBAAoB,CAAA;AAE/C;;;GAGG;AACH,MAAM,uBAAuB,GAAG,0BAA0B,CAAA;AAE1D;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;IAC/C,CAAC;IAED,uBAAuB;IACvB,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAA;IAC9D,CAAC;IAED,6BAA6B;IAC7B,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CACb,wBAAwB,KAAK,wGAAwG,CACtI,CAAA;IACH,CAAC;IAED,kCAAkC;IAClC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CACb,wBAAwB,KAAK,oEAAoE,CAClG,CAAA;IACH,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;IAC/C,CAAC;IAED,uBAAuB;IACvB,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAA;IAC9D,CAAC;IAED,6BAA6B;IAC7B,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,wBAAwB,UAAU,sHAAsH,CACzJ,CAAA;IACH,CAAC;IAED,OAAO,UAAU,CAAA;AACnB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;IAC3C,OAAO,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAA;AACpE,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB,EAAE,KAAa;IAC/D,kBAAkB,CAAC,UAAU,CAAC,CAAA;IAC9B,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IACpC,OAAO,gBAAgB,UAAU,MAAM,QAAQ,IAAI,CAAA;AACrD,CAAC"}

package/dist/validation/document-validator.d.ts

@@ -1,195 +0,0 @@
-/**
- * Document Validator - JSON Schema validation for MongoDB documents
- *
- * Provides MongoDB-compatible document validation using JSON Schema.
- * Supports validation on insert/update operations with proper error reporting.
- */
-import type { Document } from '../types/mongodb';
-/**
- * MongoDB error code for document validation failure
- */
-export declare const DOCUMENT_VALIDATION_FAILURE_CODE = 121;
-export declare const DOCUMENT_VALIDATION_FAILURE_NAME = "DocumentValidationFailure";
-/**
- * JSON Schema types supported by MongoDB
- */
-export type JsonSchemaType = 'string' | 'number' | 'integer' | 'boolean' | 'object' | 'array' | 'null' | 'binData' | 'objectId' | 'date' | 'regex' | 'double' | 'int' | 'long' | 'decimal' | 'timestamp';
-/**
- * JSON Schema definition compatible with MongoDB's $jsonSchema
- */
-export interface JsonSchema {
-    bsonType?: JsonSchemaType | JsonSchemaType[];
-    type?: JsonSchemaType | JsonSchemaType[];
-    title?: string;
-    description?: string;
-    required?: string[];
-    properties?: Record<string, JsonSchema>;
-    additionalProperties?: boolean | JsonSchema;
-    patternProperties?: Record<string, JsonSchema>;
-    items?: JsonSchema | JsonSchema[];
-    additionalItems?: boolean | JsonSchema;
-    minItems?: number;
-    maxItems?: number;
-    uniqueItems?: boolean;
-    minimum?: number;
-    maximum?: number;
-    exclusiveMinimum?: number | boolean;
-    exclusiveMaximum?: number | boolean;
-    multipleOf?: number;
-    minLength?: number;
-    maxLength?: number;
-    pattern?: string;
-    enum?: unknown[];
-    const?: unknown;
-    allOf?: JsonSchema[];
-    anyOf?: JsonSchema[];
-    oneOf?: JsonSchema[];
-    not?: JsonSchema;
-    if?: JsonSchema;
-    then?: JsonSchema;
-    else?: JsonSchema;
-}
-/**
- * MongoDB validator specification
- */
-export interface ValidatorSpec {
-    $jsonSchema?: JsonSchema;
-    $and?: ValidatorSpec[];
-    $or?: ValidatorSpec[];
-    [key: string]: unknown;
-}
-/**
- * Validation level: how strictly to enforce validation
- */
-export type ValidationLevel = 'off' | 'strict' | 'moderate';
-/**
- * Validation action: what to do when validation fails
- */
-export type ValidationAction = 'error' | 'warn';
-/**
- * Validation options for a collection
- */
-export interface ValidationOptions {
-    validator?: ValidatorSpec;
-    validationLevel?: ValidationLevel;
-    validationAction?: ValidationAction;
-}
-/**
- * Validation result
- */
-export interface ValidationResult {
-    valid: boolean;
-    errors: ValidationError[];
-}
-/**
- * Validation error details
- */
-export interface ValidationError {
-    path: string;
-    message: string;
-    schemaPath?: string;
-    keyword?: string;
-    params?: Record<string, unknown>;
-}
-/**
- * MongoDB-style document validation error
- */
-export declare class DocumentValidationError extends Error {
-    readonly code: number;
-    readonly codeName: string;
-    readonly ok: 0;
-    readonly errmsg: string;
-    readonly details: ValidationError[];
-    constructor(message: string, details?: ValidationError[]);
-    /**
-     * Convert to MongoDB error format
-     */
-    toMongoError(): {
-        ok: 0;
-        errmsg: string;
-        code: number;
-        codeName: string;
-    };
-}
-/**
- * Document Validator class
- *
- * Validates documents against JSON Schema specifications
- * following MongoDB's $jsonSchema format.
- */
-export declare class DocumentValidator {
-    private readonly validator;
-    private readonly validationLevel;
-    private readonly validationAction;
-    constructor(options?: ValidationOptions);
-    /**
-     * Check if validation is enabled
-     */
-    get isEnabled(): boolean;
-    /**
-     * Check if validation should throw errors
-     */
-    get shouldError(): boolean;
-    /**
-     * Validate a document for insert
-     *
-     * @param document - The document to validate
-     * @returns Validation result
-     */
-    validateInsert(document: Document): ValidationResult;
-    /**
-     * Validate a document after update
-     *
-     * For 'strict' level: validates the resulting document
-     * For 'moderate' level: only validates if the update modifies fields in the schema
-     *
-     * @param originalDocument - The document before update
-     * @param resultingDocument - The document after update
-     * @param modifiedFields - Set of field paths that were modified
-     * @returns Validation result
-     */
-    validateUpdate(_originalDocument: Document, resultingDocument: Document, modifiedFields?: Set<string>): ValidationResult;
-    /**
-     * Validate a document for replace operation
-     *
-     * @param replacement - The replacement document
-     * @returns Validation result
-     */
-    validateReplace(replacement: Document): ValidationResult;
-    /**
-     * Validate a document against the schema
-     *
-     * @param document - The document to validate
-     * @returns Validation result
-     */
-    private validateDocument;
-    /**
-     * Validate against JSON Schema
-     */
-    private validateJsonSchema;
-    /**
-     * Get BSON type of a value
-     */
-    private getBsonType;
-    /**
-     * Deep equality check
-     */
-    private deepEqual;
-    /**
-     * Get all field paths defined in the schema
-     */
-    private getSchemaFields;
-    /**
-     * Recursively collect property paths from schema
-     */
-    private collectPropertyPaths;
-}
-/**
- * Create a validation error for insert/update operations
- */
-export declare function createValidationError(result: ValidationResult, _operation?: 'insert' | 'update' | 'replace'): DocumentValidationError;
-/**
- * Validate a document and throw if validation fails
- */
-export declare function validateOrThrow(validator: DocumentValidator, document: Document, operation?: 'insert' | 'update' | 'replace'): void;
-//# sourceMappingURL=document-validator.d.ts.map