@takyonic/sdk 1.0.0

package/dist/client.js

@@ -0,0 +1,229 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TakyonicClient = void 0;
+const table_builder_1 = require("./table-builder");
+const errors_1 = require("./errors");
+/**
+ * Default configuration values
+ */
+const DEFAULT_TIMEOUT = 30000;
+/**
+ * Takyonic Client - The main entry point for interacting with the Takyonic engine.
+ *
+ * @example
+ * ```typescript
+ * const db = new TakyonicClient({
+ *   endpoint: 'http://localhost:8080',
+ *   token: 'your-api-token'
+ * });
+ *
+ * // Query a table
+ * const logs = await db.table('logs').where('severity', '>', 4).get();
+ *
+ * // Insert a record
+ * await db.table('users').insert({ id: 'user-1', name: 'John' });
+ * ```
+ */
+class TakyonicClient {
+    endpoint;
+    token;
+    timeout;
+    constructor(config) {
+        // Remove trailing slash from endpoint
+        this.endpoint = config.endpoint.replace(/\/+$/, '');
+        this.token = config.token;
+        this.timeout = config.timeout ?? DEFAULT_TIMEOUT;
+    }
+    /**
+     * Creates a TableBuilder for the specified table.
+     * This is the starting point for all table operations.
+     *
+     * @param name - The name of the table to query
+     * @returns A TableBuilder instance for fluent query building
+     *
+     * @example
+     * ```typescript
+     * const results = await db.table('logs')
+     *   .where('severity', '>=', 3)
+     *   .get();
+     * ```
+     */
+    table(name) {
+        return new table_builder_1.TableBuilder(this, name);
+    }
+    /**
+     * Fetches server statistics including cache hits, misses, and performance metrics.
+     *
+     * @returns Promise resolving to server statistics
+     *
+     * @example
+     * ```typescript
+     * const stats = await db.stats();
+     * console.log(`Cache hit rate: ${stats.cache_hits / stats.total_requests * 100}%`);
+     * ```
+     */
+    async stats() {
+        return this.request({
+            method: 'GET',
+            path: '/v1/stats',
+        });
+    }
+    /**
+     * Fetches the database schema including all tables, columns, and relationships.
+     *
+     * @returns Promise resolving to the schema information
+     *
+     * @example
+     * ```typescript
+     * const schema = await db.schema();
+     * for (const table of schema.tables) {
+     *   console.log(`Table: ${table.name}, Columns: ${table.columns.length}`);
+     * }
+     * ```
+     */
+    async schema() {
+        const tables = await this.request({
+            method: 'GET',
+            path: '/v1/schema',
+        });
+        return { tables };
+    }
+    /**
+     * Fetches the database schema as a formatted .takyonic DSL string.
+     * This is the authoritative format from the Rust backend.
+     *
+     * @returns Promise resolving to the DSL string content
+     *
+     * @example
+     * ```typescript
+     * const dsl = await db.schemaDsl();
+     * fs.writeFileSync('.takyonic', dsl);
+     * ```
+     */
+    async schemaDsl() {
+        const url = `${this.endpoint}/v1/schema/dsl`;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url, {
+                method: 'GET',
+                headers: {
+                    'Authorization': `Bearer ${this.token}`,
+                },
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                let errorResponse;
+                try {
+                    errorResponse = await response.json();
+                }
+                catch {
+                    // Response body might not be valid JSON
+                }
+                throw (0, errors_1.createErrorFromStatus)(response.status, errorResponse);
+            }
+            return await response.text();
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof Error && error.name.includes('Error') && 'statusCode' in error) {
+                throw error;
+            }
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new errors_1.NetworkError(`Request timed out after ${this.timeout}ms`);
+            }
+            if (error instanceof TypeError) {
+                throw new errors_1.NetworkError(`Network request failed: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Internal method to make HTTP requests to the Takyonic server.
+     * Handles authentication, error handling, and response parsing.
+     *
+     * @internal
+     */
+    async request(options) {
+        const { method, path, body, queryParams } = options;
+        // Build URL with query parameters
+        let url = `${this.endpoint}${path}`;
+        if (queryParams && Object.keys(queryParams).length > 0) {
+            const searchParams = new URLSearchParams();
+            for (const [key, value] of Object.entries(queryParams)) {
+                searchParams.append(key, value);
+            }
+            url += `?${searchParams.toString()}`;
+        }
+        // Build request options
+        const fetchOptions = {
+            method,
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.token}`,
+            },
+        };
+        if (body !== undefined) {
+            fetchOptions.body = JSON.stringify(body);
+        }
+        // Create abort controller for timeout
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        fetchOptions.signal = controller.signal;
+        try {
+            const response = await fetch(url, fetchOptions);
+            clearTimeout(timeoutId);
+            // Handle non-OK responses
+            if (!response.ok) {
+                let errorResponse;
+                try {
+                    errorResponse = await response.json();
+                }
+                catch {
+                    // Response body might not be valid JSON
+                }
+                throw (0, errors_1.createErrorFromStatus)(response.status, errorResponse);
+            }
+            // Handle empty responses (like 204 No Content)
+            const contentType = response.headers.get('content-type');
+            if (!contentType || !contentType.includes('application/json')) {
+                return {};
+            }
+            return await response.json();
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            // Re-throw TakyonicError instances
+            if (error instanceof Error && error.name.includes('Error') && 'statusCode' in error) {
+                throw error;
+            }
+            // Handle abort (timeout)
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new errors_1.NetworkError(`Request timed out after ${this.timeout}ms`);
+            }
+            // Handle network errors
+            if (error instanceof TypeError) {
+                throw new errors_1.NetworkError(`Network request failed: ${error.message}`);
+            }
+            // Re-throw unknown errors
+            throw error;
+        }
+    }
+    /**
+     * Gets the configured endpoint URL.
+     * @internal
+     */
+    getEndpoint() {
+        return this.endpoint;
+    }
+    /**
+     * Gets the configured timeout.
+     * @internal
+     */
+    getTimeout() {
+        return this.timeout;
+    }
+}
+exports.TakyonicClient = TakyonicClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,47 @@
+import type { ErrorResponse } from './types';
+/**
+ * Base error class for all Takyonic SDK errors
+ */
+export declare class TakyonicError extends Error {
+    /** HTTP status code from the response */
+    readonly statusCode: number;
+    /** Raw error response from the server */
+    readonly response?: ErrorResponse;
+    constructor(message: string, statusCode: number, response?: ErrorResponse);
+}
+/**
+ * Error thrown when authentication fails (401 Unauthorized)
+ */
+export declare class AuthenticationError extends TakyonicError {
+    constructor(message?: string, response?: ErrorResponse);
+}
+/**
+ * Error thrown when a resource is not found (404 Not Found)
+ */
+export declare class NotFoundError extends TakyonicError {
+    constructor(message?: string, response?: ErrorResponse);
+}
+/**
+ * Error thrown when request validation fails (400 Bad Request)
+ */
+export declare class ValidationError extends TakyonicError {
+    constructor(message?: string, response?: ErrorResponse);
+}
+/**
+ * Error thrown when the server encounters an internal error (500 Internal Server Error)
+ */
+export declare class ServerError extends TakyonicError {
+    constructor(message?: string, response?: ErrorResponse);
+}
+/**
+ * Error thrown when a network request fails or times out
+ */
+export declare class NetworkError extends TakyonicError {
+    constructor(message?: string);
+}
+/**
+ * Creates the appropriate error based on HTTP status code
+ * @internal
+ */
+export declare function createErrorFromStatus(statusCode: number, response?: ErrorResponse): TakyonicError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,yCAAyC;IACzC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,yCAAyC;IACzC,SAAgB,QAAQ,CAAC,EAAE,aAAa,CAAC;gBAE7B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa;CAW1E;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;gBACxC,OAAO,GAAE,MAAuD,EAAE,QAAQ,CAAC,EAAE,aAAa;CAIvG;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,aAAa;gBAClC,OAAO,GAAE,MAA8B,EAAE,QAAQ,CAAC,EAAE,aAAa;CAI9E;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,GAAE,MAA6B,EAAE,QAAQ,CAAC,EAAE,aAAa;CAI7E;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,aAAa;gBAChC,OAAO,GAAE,MAAiC,EAAE,QAAQ,CAAC,EAAE,aAAa;CAIjF;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,aAAa;gBACjC,OAAO,GAAE,MAAkC;CAIxD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,aAAa,GACvB,aAAa,CAkBf"}

package/dist/errors.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NetworkError = exports.ServerError = exports.ValidationError = exports.NotFoundError = exports.AuthenticationError = exports.TakyonicError = void 0;
+exports.createErrorFromStatus = createErrorFromStatus;
+/**
+ * Base error class for all Takyonic SDK errors
+ */
+class TakyonicError extends Error {
+    /** HTTP status code from the response */
+    statusCode;
+    /** Raw error response from the server */
+    response;
+    constructor(message, statusCode, response) {
+        super(message);
+        this.name = 'TakyonicError';
+        this.statusCode = statusCode;
+        this.response = response;
+        // Maintains proper stack trace for where our error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+}
+exports.TakyonicError = TakyonicError;
+/**
+ * Error thrown when authentication fails (401 Unauthorized)
+ */
+class AuthenticationError extends TakyonicError {
+    constructor(message = 'Authentication failed. Check your API token.', response) {
+        super(message, 401, response);
+        this.name = 'AuthenticationError';
+    }
+}
+exports.AuthenticationError = AuthenticationError;
+/**
+ * Error thrown when a resource is not found (404 Not Found)
+ */
+class NotFoundError extends TakyonicError {
+    constructor(message = 'Resource not found.', response) {
+        super(message, 404, response);
+        this.name = 'NotFoundError';
+    }
+}
+exports.NotFoundError = NotFoundError;
+/**
+ * Error thrown when request validation fails (400 Bad Request)
+ */
+class ValidationError extends TakyonicError {
+    constructor(message = 'Validation failed.', response) {
+        super(message, 400, response);
+        this.name = 'ValidationError';
+    }
+}
+exports.ValidationError = ValidationError;
+/**
+ * Error thrown when the server encounters an internal error (500 Internal Server Error)
+ */
+class ServerError extends TakyonicError {
+    constructor(message = 'Internal server error.', response) {
+        super(message, 500, response);
+        this.name = 'ServerError';
+    }
+}
+exports.ServerError = ServerError;
+/**
+ * Error thrown when a network request fails or times out
+ */
+class NetworkError extends TakyonicError {
+    constructor(message = 'Network request failed.') {
+        super(message, 0);
+        this.name = 'NetworkError';
+    }
+}
+exports.NetworkError = NetworkError;
+/**
+ * Creates the appropriate error based on HTTP status code
+ * @internal
+ */
+function createErrorFromStatus(statusCode, response) {
+    const message = response?.message || response?.error || 'Unknown error';
+    switch (statusCode) {
+        case 400:
+            return new ValidationError(message, response);
+        case 401:
+            return new AuthenticationError(message, response);
+        case 404:
+            return new NotFoundError(message, response);
+        case 500:
+        case 502:
+        case 503:
+        case 504:
+            return new ServerError(message, response);
+        default:
+            return new TakyonicError(message, statusCode, response);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AA8EA,sDAqBC;AAjGD;;GAEG;AACH,MAAa,aAAc,SAAQ,KAAK;IACtC,yCAAyC;IACzB,UAAU,CAAS;IACnC,yCAAyC;IACzB,QAAQ,CAAiB;IAEzC,YAAY,OAAe,EAAE,UAAkB,EAAE,QAAwB;QACvE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAEzB,qFAAqF;QACrF,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;CACF;AAjBD,sCAiBC;AAED;;GAEG;AACH,MAAa,mBAAoB,SAAQ,aAAa;IACpD,YAAY,UAAkB,8CAA8C,EAAE,QAAwB;QACpG,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,kDAKC;AAED;;GAEG;AACH,MAAa,aAAc,SAAQ,aAAa;IAC9C,YAAY,UAAkB,qBAAqB,EAAE,QAAwB;QAC3E,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AALD,sCAKC;AAED;;GAEG;AACH,MAAa,eAAgB,SAAQ,aAAa;IAChD,YAAY,UAAkB,oBAAoB,EAAE,QAAwB;QAC1E,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AALD,0CAKC;AAED;;GAEG;AACH,MAAa,WAAY,SAAQ,aAAa;IAC5C,YAAY,UAAkB,wBAAwB,EAAE,QAAwB;QAC9E,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AALD,kCAKC;AAED;;GAEG;AACH,MAAa,YAAa,SAAQ,aAAa;IAC7C,YAAY,UAAkB,yBAAyB;QACrD,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AALD,oCAKC;AAED;;;GAGG;AACH,SAAgB,qBAAqB,CACnC,UAAkB,EAClB,QAAwB;IAExB,MAAM,OAAO,GAAG,QAAQ,EAAE,OAAO,IAAI,QAAQ,EAAE,KAAK,IAAI,eAAe,CAAC;IAExE,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,GAAG;YACN,OAAO,IAAI,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAChD,KAAK,GAAG;YACN,OAAO,IAAI,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACpD,KAAK,GAAG;YACN,OAAO,IAAI,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC9C,KAAK,GAAG,CAAC;QACT,KAAK,GAAG,CAAC;QACT,KAAK,GAAG,CAAC;QACT,KAAK,GAAG;YACN,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC5C;YACE,OAAO,IAAI,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @takyonic/sdk - Official Node.js SDK for Takyonic
+ *
+ * A high-performance caching engine client with fluent API.
+ *
+ * @example
+ * ```typescript
+ * import { TakyonicClient } from '@takyonic/sdk';
+ *
+ * const db = new TakyonicClient({
+ *   endpoint: 'http://localhost:8080',
+ *   token: 'your-api-token'
+ * });
+ *
+ * // Query with filters
+ * const logs = await db.table('logs')
+ *   .where('severity', '>', 4)
+ *   .get();
+ *
+ * // Insert a record
+ * await db.table('users').insert({
+ *   id: 'user-1',
+ *   name: 'John Doe'
+ * });
+ *
+ * // Bulk insert with automatic batching
+ * await db.table('logs').insertMany(thousandsOfRecords);
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { TakyonicClient } from './client';
+export { AdminClient } from './admin-client';
+export { TableBuilder } from './table-builder';
+export { TakyonicError, AuthenticationError, NotFoundError, ValidationError, ServerError, NetworkError, } from './errors';
+export type { TakyonicConfig, AdminConfig, ComparisonOperator, Filter, BaseRecord, WriteResult, BulkInsertResult, MigrationResult, ServerStats, SchemaResponse, TableSchema, ColumnSchema, IndexInfo, ForeignKeyInfo, ErrorResponse, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG1C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,WAAW,EACX,YAAY,GACb,MAAM,UAAU,CAAC;AAGlB,YAAY,EACV,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,MAAM,EACN,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,cAAc,EACd,WAAW,EACX,YAAY,EACZ,SAAS,EACT,cAAc,EACd,aAAa,GACd,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * @takyonic/sdk - Official Node.js SDK for Takyonic
+ *
+ * A high-performance caching engine client with fluent API.
+ *
+ * @example
+ * ```typescript
+ * import { TakyonicClient } from '@takyonic/sdk';
+ *
+ * const db = new TakyonicClient({
+ *   endpoint: 'http://localhost:8080',
+ *   token: 'your-api-token'
+ * });
+ *
+ * // Query with filters
+ * const logs = await db.table('logs')
+ *   .where('severity', '>', 4)
+ *   .get();
+ *
+ * // Insert a record
+ * await db.table('users').insert({
+ *   id: 'user-1',
+ *   name: 'John Doe'
+ * });
+ *
+ * // Bulk insert with automatic batching
+ * await db.table('logs').insertMany(thousandsOfRecords);
+ * ```
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NetworkError = exports.ServerError = exports.ValidationError = exports.NotFoundError = exports.AuthenticationError = exports.TakyonicError = exports.TableBuilder = exports.AdminClient = exports.TakyonicClient = void 0;
+// Main client
+var client_1 = require("./client");
+Object.defineProperty(exports, "TakyonicClient", { enumerable: true, get: function () { return client_1.TakyonicClient; } });
+// Admin client for privileged operations
+var admin_client_1 = require("./admin-client");
+Object.defineProperty(exports, "AdminClient", { enumerable: true, get: function () { return admin_client_1.AdminClient; } });
+// Table builder for fluent API
+var table_builder_1 = require("./table-builder");
+Object.defineProperty(exports, "TableBuilder", { enumerable: true, get: function () { return table_builder_1.TableBuilder; } });
+// Error classes
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "TakyonicError", { enumerable: true, get: function () { return errors_1.TakyonicError; } });
+Object.defineProperty(exports, "AuthenticationError", { enumerable: true, get: function () { return errors_1.AuthenticationError; } });
+Object.defineProperty(exports, "NotFoundError", { enumerable: true, get: function () { return errors_1.NotFoundError; } });
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_1.ValidationError; } });
+Object.defineProperty(exports, "ServerError", { enumerable: true, get: function () { return errors_1.ServerError; } });
+Object.defineProperty(exports, "NetworkError", { enumerable: true, get: function () { return errors_1.NetworkError; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;;;AAEH,cAAc;AACd,mCAA0C;AAAjC,wGAAA,cAAc,OAAA;AAEvB,yCAAyC;AACzC,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AAEpB,+BAA+B;AAC/B,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AAErB,gBAAgB;AAChB,mCAOkB;AANhB,uGAAA,aAAa,OAAA;AACb,6GAAA,mBAAmB,OAAA;AACnB,uGAAA,aAAa,OAAA;AACb,yGAAA,eAAe,OAAA;AACf,qGAAA,WAAW,OAAA;AACX,sGAAA,YAAY,OAAA"}

package/dist/table-builder.d.ts

@@ -0,0 +1,159 @@
+import type { TakyonicClient } from './client';
+import type { ComparisonOperator, BaseRecord, WriteResult, BulkInsertResult } from './types';
+/**
+ * TableBuilder provides a fluent/chainable API for querying and modifying table data.
+ *
+ * @example
+ * ```typescript
+ * // Search with filters
+ * const logs = await db.table('logs')
+ *   .where('severity', '>', 4)
+ *   .where('event', '=', 'error')
+ *   .get();
+ *
+ * // Find a single record
+ * const user = await db.table('users').findById('user-123');
+ *
+ * // Insert records
+ * await db.table('logs').insert({ id: 'log-1', message: 'Hello' });
+ *
+ * // Bulk insert with automatic batching
+ * await db.table('logs').insertMany(thousandsOfRecords);
+ * ```
+ */
+export declare class TableBuilder<T extends BaseRecord = BaseRecord> {
+    private readonly client;
+    private readonly tableName;
+    private filters;
+    constructor(client: TakyonicClient, tableName: string);
+    /**
+     * Adds a filter condition to the query.
+     * Multiple calls to where() are combined with AND logic.
+     *
+     * @param column - The column name to filter on
+     * @param operator - Comparison operator ('>', '<', '>=', '<=', '=', '!=')
+     * @param value - The value to compare against
+     * @returns The TableBuilder instance for chaining
+     *
+     * @example
+     * ```typescript
+     * const results = await db.table('logs')
+     *   .where('severity', '>=', 3)
+     *   .where('event', '=', 'login')
+     *   .get();
+     * ```
+     */
+    where(column: string, operator: ComparisonOperator, value: string | number | boolean): TableBuilder<T>;
+    /**
+     * Adds a full-text search filter using PostgreSQL FTS.
+     * Uses GIN indexes for sub-millisecond text searching across large datasets.
+     * Multiple search() calls are combined with AND logic.
+     *
+     * @param column - The column name to search in (text, varchar, or jsonb)
+     * @param query - The search terms (words are combined with AND logic)
+     * @returns The TableBuilder instance for chaining
+     *
+     * @example
+     * ```typescript
+     * // Find logs containing "critical" in the event field
+     * const logs = await db.table('logs')
+     *   .search('event', 'critical')
+     *   .get();
+     *
+     * // Combine FTS with regular filters
+     * const errorLogs = await db.table('logs')
+     *   .search('payload', 'database connection')
+     *   .where('severity', '>', 3)
+     *   .get();
+     * ```
+     */
+    search(column: string, query: string): TableBuilder<T>;
+    /**
+     * Executes the query with all applied filters and returns the matching records.
+     *
+     * @returns Promise resolving to an array of matching records
+     *
+     * @example
+     * ```typescript
+     * const logs = await db.table('logs')
+     *   .where('severity', '>', 4)
+     *   .get();
+     * ```
+     */
+    get(): Promise<T[]>;
+    /**
+     * Fetches a single record by its ID.
+     *
+     * @param id - The unique identifier of the record
+     * @returns Promise resolving to the record, or null if not found
+     *
+     * @example
+     * ```typescript
+     * const user = await db.table('users').findById('user-123');
+     * if (user) {
+     *   console.log(user.name);
+     * }
+     * ```
+     */
+    findById(id: string): Promise<T | null>;
+    /**
+     * Inserts a new record or updates an existing one (upsert).
+     * The record must have an 'id' field.
+     *
+     * @param data - The record data to insert
+     * @returns Promise resolving to the write result
+     *
+     * @example
+     * ```typescript
+     * await db.table('users').insert({
+     *   id: 'user-123',
+     *   name: 'John Doe',
+     *   email: 'john@example.com'
+     * });
+     * ```
+     */
+    insert(data: T): Promise<WriteResult>;
+    /**
+     * Alias for insert(). Inserts a new record or updates an existing one.
+     *
+     * @param data - The record data to upsert
+     * @returns Promise resolving to the write result
+     */
+    upsert(data: T): Promise<WriteResult>;
+    /**
+     * Inserts multiple records with automatic batching.
+     * Large arrays are automatically chunked into batches of 1000 records
+     * to comply with the server's bulk write limit.
+     *
+     * @param records - Array of records to insert
+     * @returns Promise resolving to the bulk insert result
+     *
+     * @example
+     * ```typescript
+     * const logs = Array.from({ length: 5000 }, (_, i) => ({
+     *   id: `log-${i}`,
+     *   message: `Log entry ${i}`,
+     *   severity: Math.floor(Math.random() * 5)
+     * }));
+     *
+     * const result = await db.table('logs').insertMany(logs);
+     * console.log(`Inserted ${result.totalInserted} records in ${result.batchesProcessed} batches`);
+     * ```
+     */
+    insertMany(records: T[]): Promise<BulkInsertResult>;
+    /**
+     * Invalidates the cache for a specific record.
+     * This forces the next read to fetch from the database.
+     *
+     * @param id - The unique identifier of the record to invalidate
+     * @returns Promise that resolves when the cache is invalidated
+     *
+     * @example
+     * ```typescript
+     * // After an external update, invalidate the cache
+     * await db.table('users').invalidateCache('user-123');
+     * ```
+     */
+    invalidateCache(id: string): Promise<void>;
+}
+//# sourceMappingURL=table-builder.d.ts.map

package/dist/table-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-builder.d.ts","sourceRoot":"","sources":["../src/table-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAEV,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAQjB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,YAAY,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,OAAO,CAAgB;gBAEnB,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM;IAMrD;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CACH,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAC/B,YAAY,CAAC,CAAC,CAAC;IAOlB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC;IAMtD;;;;;;;;;;;OAWG;IACG,GAAG,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IAmBzB;;;;;;;;;;;;;OAaG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAe7C;;;;;;;;;;;;;;;OAeG;IACG,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;IAQ3C;;;;;OAKG;IACG,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;IAI3C;;;;;;;;;;;;;;;;;;;OAmBG;IACG,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqCzD;;;;;;;;;;;;OAYG;IACG,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMjD"}