@ekodb/ekodb-client 0.1.0

package/dist/search.js

@@ -0,0 +1,183 @@
+"use strict";
+/**
+ * Full-text and vector search support for ekoDB
+ *
+ * This module provides comprehensive search capabilities including:
+ * - Full-text search with fuzzy matching
+ * - Vector/semantic search
+ * - Hybrid search (text + vector)
+ * - Field weighting and boosting
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchQueryBuilder = void 0;
+/**
+ * Builder for constructing search queries with fluent API
+ *
+ * @example
+ * ```typescript
+ * const query = new SearchQueryBuilder("john")
+ *   .fields(["name", "email"])
+ *   .fuzzy(true)
+ *   .minScore(0.5)
+ *   .limit(10)
+ *   .build();
+ *
+ * const results = await client.search("users", query);
+ * ```
+ */
+class SearchQueryBuilder {
+    constructor(queryString) {
+        this.query = { query: queryString };
+    }
+    /**
+     * Set the language for stemming
+     */
+    language(language) {
+        this.query.language = language;
+        return this;
+    }
+    /**
+     * Enable case-sensitive search
+     */
+    caseSensitive(enabled = true) {
+        this.query.case_sensitive = enabled;
+        return this;
+    }
+    /**
+     * Enable fuzzy matching
+     */
+    fuzzy(enabled = true) {
+        this.query.fuzzy = enabled;
+        return this;
+    }
+    /**
+     * Set minimum score threshold
+     */
+    minScore(score) {
+        this.query.min_score = score;
+        return this;
+    }
+    /**
+     * Set fields to search in
+     */
+    fields(fields) {
+        this.query.fields = fields;
+        return this;
+    }
+    /**
+     * Set field weights
+     */
+    weights(weights) {
+        this.query.weights = weights;
+        return this;
+    }
+    /**
+     * Enable stemming
+     */
+    enableStemming(enabled = true) {
+        this.query.enable_stemming = enabled;
+        return this;
+    }
+    /**
+     * Boost exact matches
+     */
+    boostExact(enabled = true) {
+        this.query.boost_exact = enabled;
+        return this;
+    }
+    /**
+     * Set maximum edit distance for fuzzy matching
+     */
+    maxEditDistance(distance) {
+        this.query.max_edit_distance = distance;
+        return this;
+    }
+    /**
+     * Set query vector for semantic search
+     */
+    vector(vector) {
+        this.query.vector = vector;
+        return this;
+    }
+    /**
+     * Set vector field name
+     */
+    vectorField(field) {
+        this.query.vector_field = field;
+        return this;
+    }
+    /**
+     * Set vector similarity metric
+     */
+    vectorMetric(metric) {
+        this.query.vector_metric = metric;
+        return this;
+    }
+    /**
+     * Set number of vector results (k-nearest neighbors)
+     */
+    vectorK(k) {
+        this.query.vector_k = k;
+        return this;
+    }
+    /**
+     * Set minimum similarity threshold
+     */
+    vectorThreshold(threshold) {
+        this.query.vector_threshold = threshold;
+        return this;
+    }
+    /**
+     * Set text search weight for hybrid search
+     */
+    textWeight(weight) {
+        this.query.text_weight = weight;
+        return this;
+    }
+    /**
+     * Set vector search weight for hybrid search
+     */
+    vectorWeight(weight) {
+        this.query.vector_weight = weight;
+        return this;
+    }
+    /**
+     * Bypass ripple cache
+     */
+    bypassRipple(bypass = true) {
+        this.query.bypass_ripple = bypass;
+        return this;
+    }
+    /**
+     * Bypass cache
+     */
+    bypassCache(bypass = true) {
+        this.query.bypass_cache = bypass;
+        return this;
+    }
+    /**
+     * Set maximum number of results to return
+     */
+    limit(limit) {
+        this.query.limit = limit;
+        return this;
+    }
+    /**
+     * Build the final SearchQuery object
+     */
+    build() {
+        // Normalize fields to comma-separated string if array
+        if (Array.isArray(this.query.fields)) {
+            this.query.fields = this.query.fields.join(",");
+        }
+        // Normalize weights to string format if object
+        if (this.query.weights && typeof this.query.weights === "object") {
+            const weightEntries = Object.entries(this.query.weights)
+                .map(([field, weight]) => `${field}:${weight}`)
+                .join(",");
+            this.query.weights = weightEntries;
+        }
+        return this.query;
+    }
+}
+exports.SearchQueryBuilder = SearchQueryBuilder;

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@ekodb/ekodb-client",
+  "version": "0.1.0",
+  "description": "Official TypeScript/JavaScript client for ekoDB",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "ekodb",
+    "database",
+    "client",
+    "typescript"
+  ],
+  "author": "ekoDB",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/ws": "^8.5.10",
+    "typescript": "^5.3.0"
+  },
+  "dependencies": {
+    "ws": "^8.16.0"
+  }
+}