@anvailabs/proximadb-client 0.3.0 → 0.5.0

package/dist/esm/filter.js

@@ -1,228 +0,0 @@
-/**
- * ProximaDB TypeScript SDK - Filter Builder
- *
- * Provides a fluent API for building metadata filters on vector searches.
- *
- * Copyright 2025 ProximaDB Contributors
- * Licensed under the Apache License, Version 2.0
- */
-import { FilterOp, LogicalOp, } from "./types";
-/**
- * Check if a node is a FilterCondition
- */
-function isFilterCondition(node) {
-    return "field" in node && "operation" in node;
-}
-/**
- * Check if a node is a FilterGroup
- */
-function isFilterGroup(node) {
-    return "operator" in node && "conditions" in node;
-}
-/**
- * Convert a filter condition to expression string
- */
-function conditionToExpression(condition) {
-    const { field, operation, value } = condition;
-    if (value === undefined) {
-        const opStr = operation === "exists" ? "EXISTS" : "IS NULL";
-        return field + " " + opStr;
-    }
-    let valStr;
-    if (typeof value === "string") {
-        valStr = "'" + value + "'";
-    }
-    else if (Array.isArray(value)) {
-        const items = value.map((x) => typeof x === "string" ? "'" + x + "'" : String(x));
-        valStr = "[" + items.join(", ") + "]";
-    }
-    else {
-        valStr = String(value);
-    }
-    const opMap = {
-        equals: "=",
-        not_equals: "!=",
-        gt: ">",
-        gte: ">=",
-        lt: "<",
-        lte: "<=",
-        in: "IN",
-        not_in: "NOT IN",
-        contains: "CONTAINS",
-        starts_with: "STARTS WITH",
-        ends_with: "ENDS WITH",
-    };
-    const opStr = opMap[operation] ?? operation;
-    return field + " " + opStr + " " + valStr;
-}
-/**
- * Convert a filter group to expression string
- */
-function groupToExpression(group) {
-    const exprs = group.conditions
-        .map((node) => {
-        if (isFilterCondition(node)) {
-            return conditionToExpression(node);
-        }
-        else if (isFilterGroup(node)) {
-            return "(" + groupToExpression(node) + ")";
-        }
-        return "";
-    })
-        .filter((s) => s.length > 0);
-    const sep = group.operator === "and" ? " AND " : " OR ";
-    return exprs.join(sep);
-}
-/**
- * Builder for constructing complex filter expressions
- */
-export class FilterBuilder {
-    conditions = [];
-    currentOperator = LogicalOp.And;
-    pendingOperator = null;
-    static new() {
-        return new FilterBuilder();
-    }
-    eq(field, value) {
-        this.addCondition({ field, operation: FilterOp.Eq, value });
-        return this;
-    }
-    ne(field, value) {
-        this.addCondition({ field, operation: FilterOp.Ne, value });
-        return this;
-    }
-    gt(field, value) {
-        this.addCondition({ field, operation: FilterOp.Gt, value });
-        return this;
-    }
-    gte(field, value) {
-        this.addCondition({ field, operation: FilterOp.Gte, value });
-        return this;
-    }
-    lt(field, value) {
-        this.addCondition({ field, operation: FilterOp.Lt, value });
-        return this;
-    }
-    lte(field, value) {
-        this.addCondition({ field, operation: FilterOp.Lte, value });
-        return this;
-    }
-    inList(field, values) {
-        this.addCondition({ field, operation: FilterOp.In, value: values });
-        return this;
-    }
-    notIn(field, values) {
-        this.addCondition({ field, operation: FilterOp.NotIn, value: values });
-        return this;
-    }
-    contains(field, value) {
-        this.addCondition({ field, operation: FilterOp.Contains, value });
-        return this;
-    }
-    startsWith(field, prefixVal) {
-        this.addCondition({ field, operation: FilterOp.StartsWith, value: prefixVal });
-        return this;
-    }
-    endsWith(field, suffixVal) {
-        this.addCondition({ field, operation: FilterOp.EndsWith, value: suffixVal });
-        return this;
-    }
-    prefix(field, prefixVal) {
-        return this.startsWith(field, prefixVal);
-    }
-    suffix(field, suffixVal) {
-        return this.endsWith(field, suffixVal);
-    }
-    exists(field) {
-        this.addCondition({ field, operation: FilterOp.Exists });
-        return this;
-    }
-    isNull(field) {
-        this.addCondition({ field, operation: FilterOp.IsNull });
-        return this;
-    }
-    range(field, min, max) {
-        this.addCondition({ field, operation: FilterOp.Gte, value: min });
-        this.addCondition({ field, operation: FilterOp.Lte, value: max });
-        return this;
-    }
-    and() {
-        this.pendingOperator = LogicalOp.And;
-        return this;
-    }
-    or() {
-        this.pendingOperator = LogicalOp.Or;
-        return this;
-    }
-    group(builderFn) {
-        const inner = builderFn(new FilterBuilder());
-        const filter = inner.build();
-        this.conditions.push({
-            operator: filter.operator,
-            conditions: filter.conditions,
-        });
-        return this;
-    }
-    addCondition(condition) {
-        if (this.pendingOperator !== null) {
-            if (this.pendingOperator === LogicalOp.Or &&
-                this.currentOperator === LogicalOp.And) {
-                this.currentOperator = LogicalOp.Or;
-            }
-            this.pendingOperator = null;
-        }
-        this.conditions.push(condition);
-    }
-    build() {
-        return {
-            operator: this.currentOperator,
-            conditions: [...this.conditions],
-        };
-    }
-    toExpression() {
-        const filter = this.build();
-        return groupToExpression({
-            operator: filter.operator,
-            conditions: filter.conditions,
-        });
-    }
-    toJson() {
-        return JSON.stringify(this.build());
-    }
-}
-export function eq(field, value) {
-    return FilterBuilder.new().eq(field, value).build();
-}
-export function ne(field, value) {
-    return FilterBuilder.new().ne(field, value).build();
-}
-export function gt(field, value) {
-    return FilterBuilder.new().gt(field, value).build();
-}
-export function lt(field, value) {
-    return FilterBuilder.new().lt(field, value).build();
-}
-export function inList(field, values) {
-    return FilterBuilder.new().inList(field, values).build();
-}
-export function range(field, min, max) {
-    return FilterBuilder.new().range(field, min, max).build();
-}
-export function andFilters(filters) {
-    const conditions = filters.flatMap((f) => f.conditions);
-    return { operator: LogicalOp.And, conditions };
-}
-export function orFilters(filters) {
-    const conditions = filters.map((f) => ({
-        operator: f.operator,
-        conditions: f.conditions,
-    }));
-    return { operator: LogicalOp.Or, conditions };
-}
-export function filterToExpression(filter) {
-    return groupToExpression({
-        operator: filter.operator,
-        conditions: filter.conditions,
-    });
-}
-//# sourceMappingURL=filter.js.map

package/dist/esm/filter.js.map

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

package/dist/esm/generated/schema.js

@@ -1,6 +0,0 @@
-/**
- * This file was auto-generated by openapi-typescript.
- * Do not make direct changes to the file.
- */
-export {};
-//# sourceMappingURL=schema.js.map

package/dist/esm/generated/schema.js.map

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