@onchaindb/sdk 0.4.5 → 2.0.0

package/src/query-sdk/dist/QueryBuilder.js

@@ -1,295 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WhereClause = exports.QueryBuilder = void 0;
-const operators_1 = require("./operators");
-const SelectionBuilder_1 = require("./SelectionBuilder");
-const ConditionBuilder_1 = require("./ConditionBuilder");
-// Main query builder providing fluent API for building queries
-class QueryBuilder {
-    constructor(httpClient, serverUrl, app) {
-        this.httpClient = httpClient;
-        this.serverUrl = serverUrl;
-        this.app = app;
-    }
-    static new(httpClient, serverUrl, app) {
-        return new QueryBuilder(httpClient, serverUrl, app);
-    }
-    // Set HTTP client and server URL (for method chaining)
-    withHttpClient(httpClient) {
-        this.httpClient = httpClient;
-        return this;
-    }
-    withServerUrl(serverUrl) {
-        this.serverUrl = serverUrl;
-        return this;
-    }
-    // Build find conditions using a builder function
-    find(builderFn) {
-        const conditionBuilder = new ConditionBuilder_1.ConditionBuilder();
-        this.findConditions = builderFn(conditionBuilder);
-        return this;
-    }
-    collection(s) {
-        this.collectionName = s;
-        return this;
-    }
-    // Simple field condition (equivalent to Rust's where_field)
-    whereField(fieldName) {
-        return new WhereClause(this, fieldName);
-    }
-    // Build selections using a builder function
-    select(builderFn) {
-        const selectionBuilder = new SelectionBuilder_1.SelectionBuilder();
-        builderFn(selectionBuilder);
-        this.selections = selectionBuilder.build();
-        return this;
-    }
-    // Select specific fields by name
-    selectFields(fields) {
-        const selectionBuilder = new SelectionBuilder_1.SelectionBuilder();
-        selectionBuilder.fields(fields);
-        this.selections = selectionBuilder.build();
-        return this;
-    }
-    // Select all fields (no field filtering)
-    selectAll() {
-        this.selections = SelectionBuilder_1.SelectionBuilder.all();
-        return this;
-    }
-    // Set field mapping for the query
-    withFieldMap(fieldMap) {
-        this.fieldMap = fieldMap;
-        return this;
-    }
-    // Set limit for results
-    limit(limit) {
-        this.limitValue = limit;
-        return this;
-    }
-    // Set offset for results
-    offset(offset) {
-        this.offsetValue = offset;
-        return this;
-    }
-    // Set sorting fields
-    orderBy(fields) {
-        this.sortBy = fields;
-        return this;
-    }
-    // Execute the query via HTTP
-    async execute() {
-        if (!this.httpClient) {
-            throw new Error('HTTP client is required for query execution');
-        }
-        if (!this.serverUrl) {
-            throw new Error('Server URL is required for query execution');
-        }
-        const queryValue = this.buildQueryValue();
-        const request = {
-            ...queryValue,
-            limit: this.limitValue,
-            offset: this.offsetValue,
-            sortBy: this.sortBy,
-            root: `${this.app}::${this.collectionName}`
-        };
-        try {
-            const response = await this.httpClient.post(`${this.serverUrl}/list`, request, { 'Content-Type': 'application/json' });
-            return response?.data || {
-                records: [],
-                limit: 0,
-                page: 0,
-                total: 0,
-            };
-        }
-        catch (error) {
-            throw new Error(`Query execution failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
-        }
-    }
-    // Check if the query is valid (has required components)
-    isValid() {
-        // A query is valid if it has either find conditions or selections
-        return this.findConditions !== undefined || this.selections !== undefined;
-    }
-    // Build raw query JSON (useful for debugging)
-    buildRawQuery() {
-        return {
-            ...this.buildQueryValue(),
-            limit: this.limitValue,
-            offset: this.offsetValue,
-            sortBy: this.sortBy
-        };
-    }
-    // Clone the query builder
-    clone() {
-        const cloned = new QueryBuilder(this.httpClient, this.serverUrl);
-        cloned.findConditions = this.findConditions;
-        cloned.selections = this.selections ? { ...this.selections } : undefined;
-        cloned.fieldMap = this.fieldMap ? { ...this.fieldMap } : undefined;
-        cloned.limitValue = this.limitValue;
-        cloned.offsetValue = this.offsetValue;
-        cloned.sortBy = this.sortBy;
-        return cloned;
-    }
-    // Build the query value object for HTTP requests
-    buildQueryValue() {
-        const find = this.findConditions ? this.findConditions.toComposable() : {};
-        const select = this.selections || SelectionBuilder_1.SelectionBuilder.all();
-        return {
-            find,
-            select
-        };
-    }
-}
-exports.QueryBuilder = QueryBuilder;
-// Helper class for building where clauses with method chaining
-class WhereClause {
-    constructor(queryBuilder, fieldName) {
-        this.queryBuilder = queryBuilder;
-        this.fieldName = fieldName;
-    }
-    equals(value) {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).equals(value);
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    notEquals(value) {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).notEquals(value);
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    greaterThan(value) {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).greaterThan(value);
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    greaterThanOrEqual(value) {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).greaterThanOrEqual(value);
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    lessThan(value) {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).lessThan(value);
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    lessThanOrEqual(value) {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).lessThanOrEqual(value);
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    contains(value) {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).contains(value);
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    startsWith(value) {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).startsWith(value);
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    endsWith(value) {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).endsWith(value);
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    in(values) {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).in(values);
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    notIn(values) {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).notIn(values);
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    exists() {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).exists();
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    notExists() {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).notExists();
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    isNull() {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).isNull();
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    isNotNull() {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).isNotNull();
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    regExpMatches(pattern) {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).regExpMatches(pattern);
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    includesCaseInsensitive(value) {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).includesCaseInsensitive(value);
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    startsWithCaseInsensitive(value) {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).startsWithCaseInsensitive(value);
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    endsWithCaseInsensitive(value) {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).endsWithCaseInsensitive(value);
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    // ===== IP OPERATORS =====
-    isLocalIp() {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).isLocalIp();
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    isExternalIp() {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).isExternalIp();
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    // ===== MISC OPERATORS =====
-    b64(value) {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).b64(value);
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    inDataset(dataset) {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).inDataset(dataset);
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    inCountry(countryCode) {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).inCountry(countryCode);
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    cidr(cidr) {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).cidr(cidr);
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    // ===== BETWEEN OPERATOR =====
-    between(min, max) {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).between(min, max);
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    // ===== CONVENIENCE METHODS =====
-    isTrue() {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).isTrue();
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-    isFalse() {
-        const condition = new operators_1.FieldConditionBuilder(this.fieldName).isFalse();
-        this.queryBuilder.findConditions = operators_1.LogicalOperator.Condition(condition);
-        return this.queryBuilder;
-    }
-}
-exports.WhereClause = WhereClause;

package/src/query-sdk/dist/QueryResult.d.ts

@@ -1,52 +0,0 @@
-export declare class QueryResult<T = any> {
-    data: T[];
-    constructor(data: T[]);
-    len(): number;
-    length(): number;
-    isEmpty(): boolean;
-    first(): T | undefined;
-    last(): T | undefined;
-    get(index: number): T | undefined;
-    any(predicate: (item: T) => boolean): boolean;
-    all(predicate: (item: T) => boolean): boolean;
-    find(predicate: (item: T) => boolean): T | undefined;
-    filter(predicate: (item: T) => boolean): T[];
-    map<U>(transform: (item: T) => U): U[];
-    forEach(callback: (item: T, index: number) => void): void;
-    reduce<U>(callback: (accumulator: U, item: T, index: number) => U, initialValue: U): U;
-    groupBy(field: string): Record<string, T[]>;
-    pluck(field: string): any[];
-    pluckStrings(field: string): (string | null)[];
-    pluckNumbers(field: string): (number | null)[];
-    summarizeNumeric(field: string): NumericSummary | null;
-    sortBy(field: string, ascending?: boolean): T[];
-    sortByMultiple(fields: Array<{
-        field: string;
-        ascending?: boolean;
-    }>): T[];
-    paginate(page: number, pageSize: number): T[];
-    chunk(size: number): T[][];
-    distinctBy(field: string): T[];
-    unique(): T[];
-    count(predicate?: (item: T) => boolean): number;
-    countBy(field: string): Record<string, number>;
-    private getNestedValue;
-    toArray(): T[];
-    toJSON(): string;
-    cast<U>(): QueryResult<U>;
-    innerJoin<U>(other: QueryResult<U>, thisKey: string, otherKey: string): Array<T & U>;
-    leftJoin<U>(other: QueryResult<U>, thisKey: string, otherKey: string): Array<T & Partial<U>>;
-    toCsv(delimiter?: string): string;
-    inspect(limit?: number): void;
-}
-export interface NumericSummary {
-    count: number;
-    sum: number;
-    mean: number;
-    median: number;
-    min: number;
-    max: number;
-    standardDeviation: number;
-    variance: number;
-}
-export declare function createQueryResult<T>(data: T[]): QueryResult<T>;

package/src/query-sdk/dist/QueryResult.js

@@ -1,293 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.QueryResult = void 0;
-exports.createQueryResult = createQueryResult;
-// Query result utilities class matching Rust SDK functionality
-class QueryResult {
-    constructor(data) {
-        this.data = Array.isArray(data) ? data : [data];
-    }
-    // ===== BASIC UTILITIES =====
-    len() {
-        return this.data.length;
-    }
-    length() {
-        return this.len();
-    }
-    isEmpty() {
-        return this.data.length === 0;
-    }
-    first() {
-        return this.data[0];
-    }
-    last() {
-        return this.data[this.data.length - 1];
-    }
-    get(index) {
-        return this.data[index];
-    }
-    // ===== ITERATION UTILITIES =====
-    any(predicate) {
-        return this.data.some(predicate);
-    }
-    all(predicate) {
-        return this.data.every(predicate);
-    }
-    find(predicate) {
-        return this.data.find(predicate);
-    }
-    filter(predicate) {
-        return this.data.filter(predicate);
-    }
-    map(transform) {
-        return this.data.map(transform);
-    }
-    forEach(callback) {
-        this.data.forEach(callback);
-    }
-    reduce(callback, initialValue) {
-        return this.data.reduce(callback, initialValue);
-    }
-    // ===== AGGREGATION UTILITIES =====
-    groupBy(field) {
-        const groups = {};
-        this.data.forEach(item => {
-            const key = this.getNestedValue(item, field);
-            const keyString = String(key ?? 'null');
-            if (!groups[keyString]) {
-                groups[keyString] = [];
-            }
-            groups[keyString].push(item);
-        });
-        return groups;
-    }
-    // Pluck values from a specific field across all records
-    pluck(field) {
-        return this.data.map(item => this.getNestedValue(item, field));
-    }
-    pluckStrings(field) {
-        return this.data.map(item => {
-            const value = this.getNestedValue(item, field);
-            return typeof value === 'string' ? value : (value != null ? String(value) : null);
-        });
-    }
-    pluckNumbers(field) {
-        return this.data.map(item => {
-            const value = this.getNestedValue(item, field);
-            if (typeof value === 'number' && !isNaN(value)) {
-                return value;
-            }
-            const parsed = Number(value);
-            return !isNaN(parsed) ? parsed : null;
-        });
-    }
-    // ===== NUMERIC SUMMARY =====
-    summarizeNumeric(field) {
-        const numbers = this.pluckNumbers(field).filter(n => n !== null);
-        if (numbers.length === 0) {
-            return null;
-        }
-        const sum = numbers.reduce((acc, n) => acc + n, 0);
-        const mean = sum / numbers.length;
-        const min = Math.min(...numbers);
-        const max = Math.max(...numbers);
-        // Calculate median
-        const sortedNumbers = [...numbers].sort((a, b) => a - b);
-        const mid = Math.floor(sortedNumbers.length / 2);
-        const median = sortedNumbers.length % 2 !== 0
-            ? sortedNumbers[mid]
-            : (sortedNumbers[mid - 1] + sortedNumbers[mid]) / 2;
-        // Calculate standard deviation
-        const variance = numbers.reduce((acc, n) => acc + Math.pow(n - mean, 2), 0) / numbers.length;
-        const standardDeviation = Math.sqrt(variance);
-        return {
-            count: numbers.length,
-            sum,
-            mean,
-            median,
-            min,
-            max,
-            standardDeviation,
-            variance
-        };
-    }
-    // ===== SORTING =====
-    sortBy(field, ascending = true) {
-        const sorted = [...this.data].sort((a, b) => {
-            const valueA = this.getNestedValue(a, field);
-            const valueB = this.getNestedValue(b, field);
-            // Handle null/undefined values
-            if (valueA == null && valueB == null)
-                return 0;
-            if (valueA == null)
-                return ascending ? -1 : 1;
-            if (valueB == null)
-                return ascending ? 1 : -1;
-            // Compare values
-            let comparison = 0;
-            if (valueA < valueB)
-                comparison = -1;
-            else if (valueA > valueB)
-                comparison = 1;
-            return ascending ? comparison : -comparison;
-        });
-        return sorted;
-    }
-    // Multiple field sorting
-    sortByMultiple(fields) {
-        const sorted = [...this.data].sort((a, b) => {
-            for (const { field, ascending = true } of fields) {
-                const valueA = this.getNestedValue(a, field);
-                const valueB = this.getNestedValue(b, field);
-                // Handle null/undefined values
-                if (valueA == null && valueB == null)
-                    continue;
-                if (valueA == null)
-                    return ascending ? -1 : 1;
-                if (valueB == null)
-                    return ascending ? 1 : -1;
-                // Compare values
-                let comparison = 0;
-                if (valueA < valueB)
-                    comparison = -1;
-                else if (valueA > valueB)
-                    comparison = 1;
-                if (comparison !== 0) {
-                    return ascending ? comparison : -comparison;
-                }
-            }
-            return 0;
-        });
-        return sorted;
-    }
-    // ===== PAGINATION =====
-    paginate(page, pageSize) {
-        const startIndex = (page - 1) * pageSize;
-        const endIndex = startIndex + pageSize;
-        return this.data.slice(startIndex, endIndex);
-    }
-    chunk(size) {
-        const chunks = [];
-        for (let i = 0; i < this.data.length; i += size) {
-            chunks.push(this.data.slice(i, i + size));
-        }
-        return chunks;
-    }
-    // ===== DISTINCT/UNIQUE =====
-    distinctBy(field) {
-        const seen = new Set();
-        return this.data.filter(item => {
-            const value = this.getNestedValue(item, field);
-            const key = String(value);
-            if (seen.has(key)) {
-                return false;
-            }
-            seen.add(key);
-            return true;
-        });
-    }
-    unique() {
-        return [...new Set(this.data)];
-    }
-    // ===== STATISTICAL FUNCTIONS =====
-    count(predicate) {
-        if (predicate) {
-            return this.data.filter(predicate).length;
-        }
-        return this.data.length;
-    }
-    countBy(field) {
-        const counts = {};
-        this.data.forEach(item => {
-            const key = String(this.getNestedValue(item, field) ?? 'null');
-            counts[key] = (counts[key] || 0) + 1;
-        });
-        return counts;
-    }
-    // ===== UTILITY METHODS =====
-    // Get nested field value using dot notation
-    getNestedValue(obj, path) {
-        return path.split('.').reduce((current, key) => {
-            return current && typeof current === 'object' ? current[key] : undefined;
-        }, obj);
-    }
-    // ===== TRANSFORMATION =====
-    toArray() {
-        return [...this.data];
-    }
-    toJSON() {
-        return JSON.stringify(this.data);
-    }
-    // Convert to QueryResult with different type
-    cast() {
-        return new QueryResult(this.data);
-    }
-    // ===== JOINING (similar to SQL joins) =====
-    innerJoin(other, thisKey, otherKey) {
-        const results = [];
-        this.data.forEach(thisItem => {
-            const thisValue = this.getNestedValue(thisItem, thisKey);
-            other.data.forEach(otherItem => {
-                const otherValue = this.getNestedValue(otherItem, otherKey);
-                if (thisValue === otherValue) {
-                    results.push({ ...thisItem, ...otherItem });
-                }
-            });
-        });
-        return results;
-    }
-    leftJoin(other, thisKey, otherKey) {
-        const results = [];
-        this.data.forEach(thisItem => {
-            const thisValue = this.getNestedValue(thisItem, thisKey);
-            const matches = other.data.filter(otherItem => this.getNestedValue(otherItem, otherKey) === thisValue);
-            if (matches.length > 0) {
-                matches.forEach(match => {
-                    results.push({ ...thisItem, ...match });
-                });
-            }
-            else {
-                results.push({ ...thisItem });
-            }
-        });
-        return results;
-    }
-    // ===== EXPORT/FORMATTING =====
-    toCsv(delimiter = ',') {
-        if (this.data.length === 0)
-            return '';
-        // Get all unique keys from all objects
-        const allKeys = new Set();
-        this.data.forEach(item => {
-            if (typeof item === 'object' && item !== null) {
-                Object.keys(item).forEach(key => allKeys.add(key));
-            }
-        });
-        const headers = Array.from(allKeys);
-        const csvRows = [headers.join(delimiter)];
-        this.data.forEach(item => {
-            const row = headers.map(header => {
-                const value = typeof item === 'object' && item !== null ? item[header] : '';
-                // Escape values that contain the delimiter
-                const stringValue = String(value ?? '');
-                return stringValue.includes(delimiter) ? `"${stringValue}"` : stringValue;
-            });
-            csvRows.push(row.join(delimiter));
-        });
-        return csvRows.join('\n');
-    }
-    // ===== DEBUGGING =====
-    inspect(limit) {
-        const itemsToShow = limit ? this.data.slice(0, limit) : this.data;
-        console.log('QueryResult:', {
-            count: this.data.length,
-            showing: itemsToShow.length,
-            data: itemsToShow
-        });
-    }
-}
-exports.QueryResult = QueryResult;
-// Utility function to create QueryResult
-function createQueryResult(data) {
-    return new QueryResult(data);
-}

package/src/query-sdk/dist/SelectionBuilder.d.ts

@@ -1,20 +0,0 @@
-import { SelectionMap } from '../index';
-export declare class SelectionBuilder {
-    private selections;
-    constructor();
-    static new(): SelectionBuilder;
-    static all(): SelectionMap;
-    field(fieldName: string): SelectionBuilder;
-    fields(fieldNames: string[]): SelectionBuilder;
-    nested<T>(fieldName: string, builderFn: (nested: SelectionBuilder) => T): SelectionBuilder;
-    exclude(fieldName: string): SelectionBuilder;
-    excludeFields(fieldNames: string[]): SelectionBuilder;
-    build(): SelectionMap;
-    clear(): SelectionBuilder;
-    isEmpty(): boolean;
-    getSelectionCount(): number;
-    hasField(fieldName: string): boolean;
-    isFieldExcluded(fieldName: string): boolean;
-    getSelectedFields(): string[];
-    getExcludedFields(): string[];
-}