@ekodb/ekodb-client 0.6.1 → 0.7.1

package/dist/client.d.ts

@@ -206,6 +206,9 @@ export declare class EkoDBClient {
     private makeRequest;
     /**
      * Insert a document into a collection
+     * @param collection - Collection name
+     * @param record - Document to insert
+     * @param ttl - Optional TTL: duration string ("1h", "30m"), seconds ("3600"), or ISO8601 timestamp
      */
     insert(collection: string, record: Record, ttl?: string): Promise<Record>;
     /**
@@ -234,7 +237,7 @@ export declare class EkoDBClient {
     /**
      * Find a document by ID
      */
-    findByID(collection: string, id: string): Promise<Record>;
+    findById(collection: string, id: string): Promise<Record>;
     /**
      * Update a document
      */
@@ -260,9 +263,12 @@ export declare class EkoDBClient {
      */
     batchDelete(collection: string, ids: string[], bypassRipple?: boolean): Promise<BatchOperationResult>;
     /**
-     * Set a key-value pair
+     * Set a key-value pair with optional TTL
+     * @param key - The key to set
+     * @param value - The value to store
+     * @param ttl - Optional TTL in seconds
      */
-    kvSet(key: string, value: any): Promise<void>;
+    kvSet(key: string, value: any, ttl?: number): Promise<void>;
     /**
      * Get a value by key
      */
@@ -271,6 +277,53 @@ export declare class EkoDBClient {
      * Delete a key
      */
     kvDelete(key: string): Promise<void>;
+    /**
+     * Check if a key exists
+     * @param key - The key to check
+     * @returns true if the key exists, false otherwise
+     */
+    kvExists(key: string): Promise<boolean>;
+    /**
+     * Query/find KV entries with pattern matching
+     * @param options - Query options including pattern and include_expired
+     * @returns Array of matching records
+     */
+    kvFind(options?: {
+        pattern?: string;
+        include_expired?: boolean;
+    }): Promise<any[]>;
+    /**
+     * Alias for kvFind - query KV store with pattern
+     */
+    kvQuery(options?: {
+        pattern?: string;
+        include_expired?: boolean;
+    }): Promise<any[]>;
+    /**
+     * Begin a new transaction
+     * @param isolationLevel - Transaction isolation level (default: "ReadCommitted")
+     * @returns Transaction ID
+     */
+    beginTransaction(isolationLevel?: string): Promise<string>;
+    /**
+     * Get transaction status
+     * @param transactionId - The transaction ID
+     * @returns Transaction status object
+     */
+    getTransactionStatus(transactionId: string): Promise<{
+        state: string;
+        operations_count: number;
+    }>;
+    /**
+     * Commit a transaction
+     * @param transactionId - The transaction ID to commit
+     */
+    commitTransaction(transactionId: string): Promise<void>;
+    /**
+     * Rollback a transaction
+     * @param transactionId - The transaction ID to rollback
+     */
+    rollbackTransaction(transactionId: string): Promise<void>;
     /**
      * List all collections
      */

package/dist/client.js

@@ -263,11 +263,14 @@ class EkoDBClient {
     }
     /**
      * Insert a document into a collection
+     * @param collection - Collection name
+     * @param record - Document to insert
+     * @param ttl - Optional TTL: duration string ("1h", "30m"), seconds ("3600"), or ISO8601 timestamp
      */
     async insert(collection, record, ttl) {
         const data = { ...record };
         if (ttl) {
-            data.ttl_duration = ttl;
+            data.ttl = ttl;
         }
         return this.makeRequest("POST", `/api/insert/${collection}`, data);
     }
@@ -300,7 +303,7 @@ class EkoDBClient {
     /**
      * Find a document by ID
      */
-    async findByID(collection, id) {
+    async findById(collection, id) {
         return this.makeRequest("GET", `/api/find/${collection}/${id}`);
     }
     /**
@@ -347,10 +350,17 @@ class EkoDBClient {
         return this.makeRequest("DELETE", `/api/batch/delete/${collection}`, { deletes });
     }
     /**
-     * Set a key-value pair
+     * Set a key-value pair with optional TTL
+     * @param key - The key to set
+     * @param value - The value to store
+     * @param ttl - Optional TTL in seconds
      */
-    async kvSet(key, value) {
-        await this.makeRequest("POST", `/api/kv/set/${encodeURIComponent(key)}`, { value }, 0, true);
+    async kvSet(key, value, ttl) {
+        const body = { value };
+        if (ttl !== undefined) {
+            body.ttl = ttl;
+        }
+        await this.makeRequest("POST", `/api/kv/set/${encodeURIComponent(key)}`, body, 0, true);
     }
     /**
      * Get a value by key
@@ -365,6 +375,69 @@ class EkoDBClient {
     async kvDelete(key) {
         await this.makeRequest("DELETE", `/api/kv/delete/${encodeURIComponent(key)}`, undefined, 0, true);
     }
+    /**
+     * Check if a key exists
+     * @param key - The key to check
+     * @returns true if the key exists, false otherwise
+     */
+    async kvExists(key) {
+        try {
+            const result = await this.kvGet(key);
+            return result !== null && result !== undefined;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Query/find KV entries with pattern matching
+     * @param options - Query options including pattern and include_expired
+     * @returns Array of matching records
+     */
+    async kvFind(options) {
+        const result = await this.makeRequest("POST", "/api/kv/find", options || {}, 0, true);
+        return result;
+    }
+    /**
+     * Alias for kvFind - query KV store with pattern
+     */
+    async kvQuery(options) {
+        return this.kvFind(options);
+    }
+    // ============================================================================
+    // Transaction Operations
+    // ============================================================================
+    /**
+     * Begin a new transaction
+     * @param isolationLevel - Transaction isolation level (default: "ReadCommitted")
+     * @returns Transaction ID
+     */
+    async beginTransaction(isolationLevel = "ReadCommitted") {
+        const result = await this.makeRequest("POST", "/api/transactions", { isolation_level: isolationLevel }, 0, true);
+        return result.transaction_id;
+    }
+    /**
+     * Get transaction status
+     * @param transactionId - The transaction ID
+     * @returns Transaction status object
+     */
+    async getTransactionStatus(transactionId) {
+        return this.makeRequest("GET", `/api/transactions/${encodeURIComponent(transactionId)}`, undefined, 0, true);
+    }
+    /**
+     * Commit a transaction
+     * @param transactionId - The transaction ID to commit
+     */
+    async commitTransaction(transactionId) {
+        await this.makeRequest("POST", `/api/transactions/${encodeURIComponent(transactionId)}/commit`, undefined, 0, true);
+    }
+    /**
+     * Rollback a transaction
+     * @param transactionId - The transaction ID to rollback
+     */
+    async rollbackTransaction(transactionId) {
+        await this.makeRequest("POST", `/api/transactions/${encodeURIComponent(transactionId)}/rollback`, undefined, 0, true);
+    }
     /**
      * List all collections
      */

package/dist/functions.d.ts

@@ -174,6 +174,26 @@ export type FunctionStageConfig = {
 } | {
     type: "ReleaseSavepoint";
     name: string;
+} | {
+    type: "KvGet";
+    key: string;
+    output_field?: string;
+} | {
+    type: "KvSet";
+    key: string;
+    value: any;
+    ttl?: number;
+} | {
+    type: "KvDelete";
+    key: string;
+} | {
+    type: "KvExists";
+    key: string;
+    output_field?: string;
+} | {
+    type: "KvQuery";
+    pattern?: string;
+    include_expired?: boolean;
 };
 export interface ChatMessage {
     role: string;
@@ -275,4 +295,9 @@ export declare const Stage: {
     createSavepoint: (name: string) => FunctionStageConfig;
     rollbackToSavepoint: (name: string) => FunctionStageConfig;
     releaseSavepoint: (name: string) => FunctionStageConfig;
+    kvGet: (key: string, output_field?: string) => FunctionStageConfig;
+    kvSet: (key: string, value: any, ttl?: number) => FunctionStageConfig;
+    kvDelete: (key: string) => FunctionStageConfig;
+    kvExists: (key: string, output_field?: string) => FunctionStageConfig;
+    kvQuery: (pattern?: string, include_expired?: boolean) => FunctionStageConfig;
 };

package/dist/functions.js

@@ -206,4 +206,30 @@ exports.Stage = {
         type: "ReleaseSavepoint",
         name,
     }),
+    // KV Store operations - faster than collection lookups for simple key-value data
+    kvGet: (key, output_field) => ({
+        type: "KvGet",
+        key,
+        output_field,
+    }),
+    kvSet: (key, value, ttl) => ({
+        type: "KvSet",
+        key,
+        value,
+        ttl,
+    }),
+    kvDelete: (key) => ({
+        type: "KvDelete",
+        key,
+    }),
+    kvExists: (key, output_field) => ({
+        type: "KvExists",
+        key,
+        output_field,
+    }),
+    kvQuery: (pattern, include_expired) => ({
+        type: "KvQuery",
+        pattern,
+        include_expired,
+    }),
 };

package/dist/index.d.ts

@@ -4,7 +4,8 @@ export { SearchQueryBuilder } from "./search";
 export { SchemaBuilder, FieldTypeSchemaBuilder, VectorIndexAlgorithm, DistanceMetric, } from "./schema";
 export { JoinBuilder } from "./join";
 export { Stage, ChatMessage } from "./functions";
-export { getValue, getValues, extractRecord, getDateTimeValue, getUUIDValue, getDecimalValue, getDurationValue, getBytesValue, getBinaryValue, getArrayValue, getSetValue, getVectorValue, getObjectValue, } from "./utils";
+export { getValue, getValues, extractRecord, getDateTimeValue, getUUIDValue, getDecimalValue, getDurationValue, getBytesValue, getBinaryValue, getArrayValue, getSetValue, getVectorValue, getObjectValue, Field, } from "./utils";
+export type { WrappedFieldValue } from "./utils";
 export type { SearchQuery, SearchResult, SearchResponse } from "./search";
 export type { Schema, FieldTypeSchema, IndexConfig, CollectionMetadata, } from "./schema";
 export type { JoinConfig } from "./join";

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getObjectValue = exports.getVectorValue = exports.getSetValue = exports.getArrayValue = exports.getBinaryValue = exports.getBytesValue = exports.getDurationValue = exports.getDecimalValue = exports.getUUIDValue = exports.getDateTimeValue = exports.extractRecord = exports.getValues = exports.getValue = exports.ChatMessage = exports.Stage = exports.JoinBuilder = exports.DistanceMetric = exports.VectorIndexAlgorithm = exports.FieldTypeSchemaBuilder = exports.SchemaBuilder = exports.SearchQueryBuilder = exports.SortOrder = exports.QueryBuilder = exports.RateLimitError = exports.MergeStrategy = exports.SerializationFormat = exports.WebSocketClient = exports.EkoDBClient = void 0;
+exports.Field = exports.getObjectValue = exports.getVectorValue = exports.getSetValue = exports.getArrayValue = exports.getBinaryValue = exports.getBytesValue = exports.getDurationValue = exports.getDecimalValue = exports.getUUIDValue = exports.getDateTimeValue = exports.extractRecord = exports.getValues = exports.getValue = exports.ChatMessage = exports.Stage = exports.JoinBuilder = exports.DistanceMetric = exports.VectorIndexAlgorithm = exports.FieldTypeSchemaBuilder = exports.SchemaBuilder = exports.SearchQueryBuilder = exports.SortOrder = exports.QueryBuilder = exports.RateLimitError = exports.MergeStrategy = exports.SerializationFormat = exports.WebSocketClient = exports.EkoDBClient = void 0;
 var client_1 = require("./client");
 Object.defineProperty(exports, "EkoDBClient", { enumerable: true, get: function () { return client_1.EkoDBClient; } });
 Object.defineProperty(exports, "WebSocketClient", { enumerable: true, get: function () { return client_1.WebSocketClient; } });
@@ -36,3 +36,4 @@ Object.defineProperty(exports, "getArrayValue", { enumerable: true, get: functio
 Object.defineProperty(exports, "getSetValue", { enumerable: true, get: function () { return utils_1.getSetValue; } });
 Object.defineProperty(exports, "getVectorValue", { enumerable: true, get: function () { return utils_1.getVectorValue; } });
 Object.defineProperty(exports, "getObjectValue", { enumerable: true, get: function () { return utils_1.getObjectValue; } });
+Object.defineProperty(exports, "Field", { enumerable: true, get: function () { return utils_1.Field; } });

package/dist/query-builder.test.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Unit tests for ekoDB TypeScript client QueryBuilder
+ */
+export {};

package/dist/query-builder.test.js

@@ -0,0 +1,318 @@
+"use strict";
+/**
+ * Unit tests for ekoDB TypeScript client QueryBuilder
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const query_builder_1 = require("./query-builder");
+// ============================================================================
+// Basic Tests
+// ============================================================================
+(0, vitest_1.describe)("QueryBuilder basics", () => {
+    (0, vitest_1.it)("creates empty query builder", () => {
+        const qb = new query_builder_1.QueryBuilder();
+        (0, vitest_1.expect)(qb).toBeInstanceOf(query_builder_1.QueryBuilder);
+    });
+    (0, vitest_1.it)("builds empty query", () => {
+        const query = new query_builder_1.QueryBuilder().build();
+        (0, vitest_1.expect)(query).toEqual({});
+    });
+});
+// ============================================================================
+// Equality Operators Tests
+// ============================================================================
+(0, vitest_1.describe)("QueryBuilder equality operators", () => {
+    (0, vitest_1.it)("builds eq filter", () => {
+        const query = new query_builder_1.QueryBuilder().eq("status", "active").build();
+        (0, vitest_1.expect)(query.filter).toEqual({
+            type: "Condition",
+            content: {
+                field: "status",
+                operator: "Eq",
+                value: "active",
+            },
+        });
+    });
+    (0, vitest_1.it)("builds ne filter", () => {
+        const query = new query_builder_1.QueryBuilder().ne("status", "deleted").build();
+        (0, vitest_1.expect)(query.filter.content.operator).toBe("Ne");
+    });
+});
+// ============================================================================
+// Comparison Operators Tests
+// ============================================================================
+(0, vitest_1.describe)("QueryBuilder comparison operators", () => {
+    (0, vitest_1.it)("builds gt filter", () => {
+        const query = new query_builder_1.QueryBuilder().gt("age", 18).build();
+        (0, vitest_1.expect)(query.filter.content.operator).toBe("Gt");
+        (0, vitest_1.expect)(query.filter.content.value).toBe(18);
+    });
+    (0, vitest_1.it)("builds gte filter", () => {
+        const query = new query_builder_1.QueryBuilder().gte("score", 80).build();
+        (0, vitest_1.expect)(query.filter.content.operator).toBe("Gte");
+    });
+    (0, vitest_1.it)("builds lt filter", () => {
+        const query = new query_builder_1.QueryBuilder().lt("price", 100.5).build();
+        (0, vitest_1.expect)(query.filter.content.operator).toBe("Lt");
+    });
+    (0, vitest_1.it)("builds lte filter", () => {
+        const query = new query_builder_1.QueryBuilder().lte("count", 1000).build();
+        (0, vitest_1.expect)(query.filter.content.operator).toBe("Lte");
+    });
+});
+// ============================================================================
+// Array Operators Tests
+// ============================================================================
+(0, vitest_1.describe)("QueryBuilder array operators", () => {
+    (0, vitest_1.it)("builds in filter", () => {
+        const query = new query_builder_1.QueryBuilder()
+            .in("status", ["active", "pending"])
+            .build();
+        (0, vitest_1.expect)(query.filter.content.operator).toBe("In");
+        (0, vitest_1.expect)(query.filter.content.value).toEqual(["active", "pending"]);
+    });
+    (0, vitest_1.it)("builds nin filter", () => {
+        const query = new query_builder_1.QueryBuilder()
+            .nin("role", ["blocked", "deleted"])
+            .build();
+        (0, vitest_1.expect)(query.filter.content.operator).toBe("NotIn");
+    });
+});
+// ============================================================================
+// String Operators Tests
+// ============================================================================
+(0, vitest_1.describe)("QueryBuilder string operators", () => {
+    (0, vitest_1.it)("builds contains filter", () => {
+        const query = new query_builder_1.QueryBuilder().contains("email", "@example.com").build();
+        (0, vitest_1.expect)(query.filter.content.operator).toBe("Contains");
+        (0, vitest_1.expect)(query.filter.content.value).toBe("@example.com");
+    });
+    (0, vitest_1.it)("builds startsWith filter", () => {
+        const query = new query_builder_1.QueryBuilder().startsWith("name", "John").build();
+        (0, vitest_1.expect)(query.filter.content.operator).toBe("StartsWith");
+    });
+    (0, vitest_1.it)("builds endsWith filter", () => {
+        const query = new query_builder_1.QueryBuilder().endsWith("filename", ".pdf").build();
+        (0, vitest_1.expect)(query.filter.content.operator).toBe("EndsWith");
+    });
+    (0, vitest_1.it)("builds regex filter", () => {
+        const query = new query_builder_1.QueryBuilder().regex("phone", "^\\+1").build();
+        (0, vitest_1.expect)(query.filter.content.operator).toBe("Regex");
+    });
+});
+// ============================================================================
+// Logical Operators Tests
+// ============================================================================
+(0, vitest_1.describe)("QueryBuilder logical operators", () => {
+    (0, vitest_1.it)("builds and filter", () => {
+        const conditions = [
+            {
+                type: "Condition",
+                content: { field: "status", operator: "Eq", value: "active" },
+            },
+            {
+                type: "Condition",
+                content: { field: "age", operator: "Gt", value: 18 },
+            },
+        ];
+        const query = new query_builder_1.QueryBuilder().and(conditions).build();
+        (0, vitest_1.expect)(query.filter.type).toBe("Logical");
+        (0, vitest_1.expect)(query.filter.content.operator).toBe("And");
+        (0, vitest_1.expect)(query.filter.content.expressions).toHaveLength(2);
+    });
+    (0, vitest_1.it)("builds or filter", () => {
+        const conditions = [
+            {
+                type: "Condition",
+                content: { field: "role", operator: "Eq", value: "admin" },
+            },
+            {
+                type: "Condition",
+                content: { field: "role", operator: "Eq", value: "super_admin" },
+            },
+        ];
+        const query = new query_builder_1.QueryBuilder().or(conditions).build();
+        (0, vitest_1.expect)(query.filter.content.operator).toBe("Or");
+    });
+    (0, vitest_1.it)("builds not filter", () => {
+        const condition = {
+            type: "Condition",
+            content: { field: "deleted", operator: "Eq", value: true },
+        };
+        const query = new query_builder_1.QueryBuilder().not(condition).build();
+        (0, vitest_1.expect)(query.filter.content.operator).toBe("Not");
+    });
+});
+// ============================================================================
+// Multiple Filters (Auto AND) Tests
+// ============================================================================
+(0, vitest_1.describe)("QueryBuilder multiple filters", () => {
+    (0, vitest_1.it)("combines multiple filters with AND logic", () => {
+        const query = new query_builder_1.QueryBuilder()
+            .eq("status", "active")
+            .gt("age", 18)
+            .contains("email", "@company.com")
+            .build();
+        (0, vitest_1.expect)(query.filter.type).toBe("Logical");
+        (0, vitest_1.expect)(query.filter.content.operator).toBe("And");
+        (0, vitest_1.expect)(query.filter.content.expressions).toHaveLength(3);
+    });
+});
+// ============================================================================
+// Sorting Tests
+// ============================================================================
+(0, vitest_1.describe)("QueryBuilder sorting", () => {
+    (0, vitest_1.it)("builds ascending sort", () => {
+        const query = new query_builder_1.QueryBuilder().sortAsc("name").build();
+        (0, vitest_1.expect)(query.sort).toHaveLength(1);
+        (0, vitest_1.expect)(query.sort[0].field).toBe("name");
+        (0, vitest_1.expect)(query.sort[0].ascending).toBe(true);
+    });
+    (0, vitest_1.it)("builds descending sort", () => {
+        const query = new query_builder_1.QueryBuilder().sortDesc("created_at").build();
+        (0, vitest_1.expect)(query.sort[0].ascending).toBe(false);
+    });
+    (0, vitest_1.it)("builds multiple sorts", () => {
+        const query = new query_builder_1.QueryBuilder()
+            .sortDesc("created_at")
+            .sortAsc("name")
+            .build();
+        (0, vitest_1.expect)(query.sort).toHaveLength(2);
+        (0, vitest_1.expect)(query.sort[0].field).toBe("created_at");
+        (0, vitest_1.expect)(query.sort[0].ascending).toBe(false);
+        (0, vitest_1.expect)(query.sort[1].field).toBe("name");
+        (0, vitest_1.expect)(query.sort[1].ascending).toBe(true);
+    });
+});
+// ============================================================================
+// Pagination Tests
+// ============================================================================
+(0, vitest_1.describe)("QueryBuilder pagination", () => {
+    (0, vitest_1.it)("builds limit", () => {
+        const query = new query_builder_1.QueryBuilder().limit(10).build();
+        (0, vitest_1.expect)(query.limit).toBe(10);
+    });
+    (0, vitest_1.it)("builds skip", () => {
+        const query = new query_builder_1.QueryBuilder().skip(20).build();
+        (0, vitest_1.expect)(query.skip).toBe(20);
+    });
+    (0, vitest_1.it)("builds page (convenience method)", () => {
+        // Page 2 with 20 items per page = skip 40
+        const query = new query_builder_1.QueryBuilder().page(2, 20).build();
+        (0, vitest_1.expect)(query.limit).toBe(20);
+        (0, vitest_1.expect)(query.skip).toBe(40);
+    });
+    (0, vitest_1.it)("builds page 0", () => {
+        const query = new query_builder_1.QueryBuilder().page(0, 10).build();
+        (0, vitest_1.expect)(query.skip).toBe(0);
+        (0, vitest_1.expect)(query.limit).toBe(10);
+    });
+});
+// ============================================================================
+// Join Tests
+// ============================================================================
+(0, vitest_1.describe)("QueryBuilder join", () => {
+    (0, vitest_1.it)("builds join configuration", () => {
+        const joinConfig = {
+            collections: ["users"],
+            local_field: "user_id",
+            foreign_field: "id",
+            as_field: "user",
+        };
+        const query = new query_builder_1.QueryBuilder().join(joinConfig).build();
+        (0, vitest_1.expect)(query.join).toEqual(joinConfig);
+    });
+});
+// ============================================================================
+// Bypass Flags Tests
+// ============================================================================
+(0, vitest_1.describe)("QueryBuilder bypass flags", () => {
+    (0, vitest_1.it)("builds bypass_cache true", () => {
+        const query = new query_builder_1.QueryBuilder().bypassCache(true).build();
+        (0, vitest_1.expect)(query.bypass_cache).toBe(true);
+    });
+    (0, vitest_1.it)("builds bypass_cache false (not included)", () => {
+        const query = new query_builder_1.QueryBuilder().bypassCache(false).build();
+        (0, vitest_1.expect)(query.bypass_cache).toBeUndefined();
+    });
+    (0, vitest_1.it)("builds bypass_cache default (true)", () => {
+        const query = new query_builder_1.QueryBuilder().bypassCache().build();
+        (0, vitest_1.expect)(query.bypass_cache).toBe(true);
+    });
+    (0, vitest_1.it)("builds bypass_ripple", () => {
+        const query = new query_builder_1.QueryBuilder().bypassRipple(true).build();
+        (0, vitest_1.expect)(query.bypass_ripple).toBe(true);
+    });
+});
+// ============================================================================
+// Chaining Tests
+// ============================================================================
+(0, vitest_1.describe)("QueryBuilder chaining", () => {
+    (0, vitest_1.it)("supports full method chaining", () => {
+        const query = new query_builder_1.QueryBuilder()
+            .eq("status", "active")
+            .gt("age", 18)
+            .sortDesc("created_at")
+            .sortAsc("name")
+            .limit(10)
+            .skip(20)
+            .bypassCache(true)
+            .build();
+        // Check filter exists
+        (0, vitest_1.expect)(query.filter).toBeDefined();
+        // Check sort exists
+        (0, vitest_1.expect)(query.sort).toHaveLength(2);
+        // Check pagination
+        (0, vitest_1.expect)(query.limit).toBe(10);
+        (0, vitest_1.expect)(query.skip).toBe(20);
+        // Check bypass flag
+        (0, vitest_1.expect)(query.bypass_cache).toBe(true);
+    });
+    (0, vitest_1.it)("returns this for method chaining", () => {
+        const qb = new query_builder_1.QueryBuilder();
+        (0, vitest_1.expect)(qb.eq("a", 1)).toBe(qb);
+        (0, vitest_1.expect)(qb.ne("b", 2)).toBe(qb);
+        (0, vitest_1.expect)(qb.gt("c", 3)).toBe(qb);
+        (0, vitest_1.expect)(qb.gte("d", 4)).toBe(qb);
+        (0, vitest_1.expect)(qb.lt("e", 5)).toBe(qb);
+        (0, vitest_1.expect)(qb.lte("f", 6)).toBe(qb);
+        (0, vitest_1.expect)(qb.in("g", [7])).toBe(qb);
+        (0, vitest_1.expect)(qb.nin("h", [8])).toBe(qb);
+        (0, vitest_1.expect)(qb.contains("i", "j")).toBe(qb);
+        (0, vitest_1.expect)(qb.startsWith("k", "l")).toBe(qb);
+        (0, vitest_1.expect)(qb.endsWith("m", "n")).toBe(qb);
+        (0, vitest_1.expect)(qb.regex("o", "p")).toBe(qb);
+        (0, vitest_1.expect)(qb.sortAsc("q")).toBe(qb);
+        (0, vitest_1.expect)(qb.sortDesc("r")).toBe(qb);
+        (0, vitest_1.expect)(qb.limit(1)).toBe(qb);
+        (0, vitest_1.expect)(qb.skip(0)).toBe(qb);
+        (0, vitest_1.expect)(qb.bypassCache()).toBe(qb);
+        (0, vitest_1.expect)(qb.bypassRipple()).toBe(qb);
+    });
+});
+// ============================================================================
+// Raw Filter Tests
+// ============================================================================
+(0, vitest_1.describe)("QueryBuilder rawFilter", () => {
+    (0, vitest_1.it)("adds raw filter expression", () => {
+        const rawFilter = {
+            type: "Condition",
+            content: {
+                field: "custom",
+                operator: "CustomOp",
+                value: "custom_value",
+            },
+        };
+        const query = new query_builder_1.QueryBuilder().rawFilter(rawFilter).build();
+        (0, vitest_1.expect)(query.filter).toEqual(rawFilter);
+    });
+});
+// ============================================================================
+// SortOrder Enum Tests
+// ============================================================================
+(0, vitest_1.describe)("SortOrder enum", () => {
+    (0, vitest_1.it)("has correct values", () => {
+        (0, vitest_1.expect)(query_builder_1.SortOrder.Asc).toBe("asc");
+        (0, vitest_1.expect)(query_builder_1.SortOrder.Desc).toBe("desc");
+    });
+});