@reifydb/client 0.0.1-alpha.1

package/dist/index.d.ts

@@ -0,0 +1,74 @@
+import { Params, SchemaNode, FrameResults } from '@reifydb/core';
+export { Diagnostic, DiagnosticColumn, FrameResults, ReifyError, SingleFrameResult, Span, asFrameResults } from '@reifydb/core';
+
+/**
+ * MIT License
+ * Copyright (c) 2025 ReifyDB
+ * See license.md file for full license text
+ */
+
+interface CommandRequest {
+    id: string;
+    type: "Command";
+    payload: {
+        statements: string[];
+        params?: Params;
+    };
+}
+interface QueryRequest {
+    id: string;
+    type: "Query";
+    payload: {
+        statements: string[];
+        params?: Params;
+    };
+}
+
+interface WsClientOptions {
+    url: string;
+    timeoutMs?: number;
+    token?: string;
+}
+declare class WsClient {
+    private options;
+    private nextId;
+    private socket;
+    private pending;
+    private constructor();
+    static connect(options: WsClientOptions): Promise<WsClient>;
+    /**
+     * Execute command(s) with schemas for each statement for proper type inference
+     * @param statements - Single statement or array of RQL commands
+     * @param params - Parameters for the commands (use null or {} if no params)
+     * @param schemas - Schema for each statement's result
+     */
+    command<const S extends readonly SchemaNode[]>(statements: string | string[], params: any, schemas: S): Promise<FrameResults<S>>;
+    /**
+     * Execute query(s) with schemas for each statement for proper type inference
+     * @param statements - Single statement or array of RQL queries
+     * @param params - Parameters for the queries (use null or {} if no params)
+     * @param schemas - Schema for each statement's result
+     */
+    query<const S extends readonly SchemaNode[]>(statements: string | string[], params: any, schemas: S): Promise<FrameResults<S>>;
+    send(req: CommandRequest | QueryRequest): Promise<any>;
+    private transformResult;
+    disconnect(): void;
+}
+
+/**
+ * MIT License
+ * Copyright (c) 2025 ReifyDB
+ * See license.md file for full license text
+ */
+
+declare class Client {
+    /**
+     * Connect to ReifyDB via WebSocket
+     * @param url WebSocket URL
+     * @param options Optional configuration
+     * @returns Connected WebSocket client
+     */
+    static connect_ws(url: string, options?: Omit<WsClientOptions, 'url'>): Promise<WsClient>;
+}
+
+export { Client, WsClient, type WsClientOptions };

package/dist/index.js

@@ -0,0 +1,325 @@
+// src/ws.ts
+import {
+  decode
+} from "@reifydb/core";
+
+// src/types.ts
+import {
+  Params,
+  Frame,
+  DiagnosticColumn,
+  Span,
+  Diagnostic,
+  Column,
+  ErrorResponse,
+  ReifyError
+} from "@reifydb/core";
+
+// src/encoder.ts
+import { UNDEFINED_VALUE } from "@reifydb/core";
+function encodeValue(value) {
+  if (value === null || value === void 0) {
+    return { type: "Undefined", value: UNDEFINED_VALUE };
+  }
+  if (value && typeof value === "object" && "encode" in value && typeof value.encode === "function") {
+    return value.encode();
+  }
+  if (typeof value === "boolean") {
+    return { type: "Bool", value: value.toString() };
+  }
+  if (typeof value === "number") {
+    if (Number.isInteger(value)) {
+      if (value >= -128 && value <= 127) {
+        return { type: "Int1", value: value.toString() };
+      } else if (value >= -32768 && value <= 32767) {
+        return { type: "Int2", value: value.toString() };
+      } else if (value >= -2147483648 && value <= 2147483647) {
+        return { type: "Int4", value: value.toString() };
+      } else {
+        return { type: "Int8", value: value.toString() };
+      }
+    } else {
+      return { type: "Float8", value: value.toString() };
+    }
+  }
+  if (typeof value === "string") {
+    if (/^[0-9a-f]{8}-[0-9a-f]{4}-[47][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value)) {
+      const version = value[14];
+      if (version === "4") {
+        return { type: "Uuid4", value };
+      } else if (version === "7") {
+        return { type: "Uuid7", value };
+      }
+    }
+    return { type: "Utf8", value };
+  }
+  if (typeof value === "bigint") {
+    if (value >= BigInt(0)) {
+      if (value <= BigInt(255)) {
+        return { type: "Uint1", value: value.toString() };
+      } else if (value <= BigInt(65535)) {
+        return { type: "Uint2", value: value.toString() };
+      } else if (value <= BigInt(4294967295)) {
+        return { type: "Uint4", value: value.toString() };
+      } else if (value <= BigInt("18446744073709551615")) {
+        return { type: "Uint8", value: value.toString() };
+      } else {
+        return { type: "Uint16", value: value.toString() };
+      }
+    } else {
+      if (value >= BigInt("-9223372036854775808")) {
+        return { type: "Int8", value: value.toString() };
+      } else {
+        return { type: "Int16", value: value.toString() };
+      }
+    }
+  }
+  if (value instanceof Date) {
+    return { type: "DateTime", value: value.toISOString() };
+  }
+  if (value instanceof Uint8Array) {
+    const hex = Array.from(value).map((b) => b.toString(16).padStart(2, "0")).join("");
+    return { type: "Blob", value: "0x" + hex };
+  }
+  if (value instanceof ArrayBuffer) {
+    const uint8Array = new Uint8Array(value);
+    const hex = Array.from(uint8Array).map((b) => b.toString(16).padStart(2, "0")).join("");
+    return { type: "Blob", value: "0x" + hex };
+  }
+  throw new Error(`Cannot encode value of type ${typeof value}: ${value}`);
+}
+function encodeParams(params) {
+  if (params === void 0 || params === null) {
+    return [];
+  }
+  if (Array.isArray(params)) {
+    return params.map((param) => encodeValue(param));
+  } else if (typeof params === "object") {
+    const encoded = {};
+    for (const [key, value] of Object.entries(params)) {
+      encoded[key] = encodeValue(value);
+    }
+    return encoded;
+  }
+  throw new Error(`Invalid parameters type: expected array or object, got ${typeof params}`);
+}
+
+// src/ws.ts
+async function createWebSocket(url) {
+  if (typeof window !== "undefined" && typeof window.WebSocket !== "undefined") {
+    return new WebSocket(url);
+  } else {
+    const wsModule = await import("ws");
+    return new wsModule.WebSocket(url);
+  }
+}
+var WsClient = class _WsClient {
+  constructor(socket, options) {
+    this.pending = /* @__PURE__ */ new Map();
+    this.options = options;
+    this.nextId = 1;
+    this.socket = socket;
+    this.socket.onmessage = (event) => {
+      const msg = JSON.parse(event.data);
+      const { id, type, payload } = msg;
+      const handler = this.pending.get(id);
+      if (!handler) {
+        return;
+      }
+      this.pending.delete(id);
+      handler({ id, type, payload });
+    };
+    this.socket.onerror = (err) => {
+      console.error("WebSocket error", err);
+    };
+  }
+  static async connect(options) {
+    const socket = await createWebSocket(options.url);
+    if (socket.readyState !== socket.OPEN) {
+      await new Promise((resolve, reject) => {
+        const onOpen = () => {
+          socket.removeEventListener("open", onOpen);
+          socket.removeEventListener("error", onError);
+          resolve();
+        };
+        const onError = () => {
+          socket.removeEventListener("open", onOpen);
+          socket.removeEventListener("error", onError);
+          reject(new Error("WebSocket connection failed"));
+        };
+        socket.addEventListener("open", onOpen);
+        socket.addEventListener("error", onError);
+      });
+    }
+    socket.send('{"id":"reifydb-auth-1","type":"Auth","payload":{"token":"mysecrettoken"}}');
+    return new _WsClient(socket, options);
+  }
+  /**
+   * Execute command(s) with schemas for each statement for proper type inference
+   * @param statements - Single statement or array of RQL commands
+   * @param params - Parameters for the commands (use null or {} if no params)
+   * @param schemas - Schema for each statement's result
+   */
+  async command(statements, params, schemas) {
+    const id = `req-${this.nextId++}`;
+    const statementArray = Array.isArray(statements) ? statements : [statements];
+    const encodedParams = params !== void 0 && params !== null ? encodeParams(params) : void 0;
+    const result = await this.send({
+      id,
+      type: "Command",
+      payload: {
+        statements: statementArray,
+        params: encodedParams
+      }
+    });
+    const transformedFrames = result.map((frame, frameIndex) => {
+      const frameSchema = schemas[frameIndex];
+      if (!frameSchema) {
+        return frame;
+      }
+      return frame.map((row) => this.transformResult(row, frameSchema));
+    });
+    return transformedFrames;
+  }
+  /**
+   * Execute query(s) with schemas for each statement for proper type inference
+   * @param statements - Single statement or array of RQL queries
+   * @param params - Parameters for the queries (use null or {} if no params)
+   * @param schemas - Schema for each statement's result
+   */
+  async query(statements, params, schemas) {
+    const id = `req-${this.nextId++}`;
+    const statementArray = Array.isArray(statements) ? statements : [statements];
+    const encodedParams = params !== void 0 && params !== null ? encodeParams(params) : void 0;
+    const result = await this.send({
+      id,
+      type: "Query",
+      payload: {
+        statements: statementArray,
+        params: encodedParams
+      }
+    });
+    const transformedFrames = result.map((frame, frameIndex) => {
+      const frameSchema = schemas[frameIndex];
+      if (!frameSchema) {
+        return frame;
+      }
+      return frame.map((row) => this.transformResult(row, frameSchema));
+    });
+    return transformedFrames;
+  }
+  async send(req) {
+    const id = req.id;
+    const response = await new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => {
+        this.pending.delete(id);
+        reject(new Error("ReifyDB query timeout"));
+      }, this.options.timeoutMs);
+      this.pending.set(id, (res) => {
+        clearTimeout(timeout);
+        resolve(res);
+      });
+      this.socket.send(JSON.stringify(req));
+    });
+    if (response.type === "Err") {
+      throw new ReifyError(response);
+    }
+    if (response.type !== req.type) {
+      throw new Error(`Unexpected response type: ${response.type}`);
+    }
+    return response.payload.frames.map(
+      (frame) => columnsToRows(frame.columns)
+    );
+  }
+  transformResult(row, resultSchema) {
+    if (resultSchema && resultSchema.kind === "object" && resultSchema.properties) {
+      const transformedRow = {};
+      for (const [key, value] of Object.entries(row)) {
+        const propertySchema = resultSchema.properties[key];
+        if (propertySchema && propertySchema.kind === "primitive") {
+          if (value && typeof value === "object" && "value" in value) {
+            const rawValue = value.value;
+            if (propertySchema.type === "RowNumber" && typeof rawValue === "number") {
+              transformedRow[key] = BigInt(rawValue);
+            } else {
+              transformedRow[key] = rawValue;
+            }
+          } else {
+            transformedRow[key] = value;
+          }
+        } else if (propertySchema && propertySchema.kind === "value") {
+          transformedRow[key] = value;
+        } else {
+          transformedRow[key] = propertySchema ? this.transformResult(value, propertySchema) : value;
+        }
+      }
+      return transformedRow;
+    }
+    if (resultSchema && resultSchema.kind === "primitive") {
+      if (row && typeof row === "object" && "value" in row) {
+        const rawValue = row.value;
+        if (resultSchema.type === "RowNumber" && typeof rawValue === "number") {
+          return BigInt(rawValue);
+        }
+        return rawValue;
+      }
+      return row;
+    }
+    if (resultSchema && resultSchema.kind === "value") {
+      return row;
+    }
+    if (resultSchema && resultSchema.kind === "array") {
+      if (Array.isArray(row)) {
+        return row.map((item) => this.transformResult(item, resultSchema.items));
+      }
+      return row;
+    }
+    if (resultSchema && resultSchema.kind === "optional") {
+      if (row === void 0 || row === null) {
+        return void 0;
+      }
+      return this.transformResult(row, resultSchema.schema);
+    }
+    return row;
+  }
+  disconnect() {
+    this.socket.close();
+  }
+};
+function columnsToRows(columns) {
+  const rowCount = columns[0]?.data.length ?? 0;
+  return Array.from({ length: rowCount }, (_, i) => {
+    const row = {};
+    for (const col of columns) {
+      row[col.name] = decode({ type: col.ty, value: col.data[i] });
+    }
+    return row;
+  });
+}
+
+// src/index.ts
+import { ReifyError as ReifyError2, Diagnostic as Diagnostic2, Span as Span2, DiagnosticColumn as DiagnosticColumn2 } from "@reifydb/core";
+import { FrameResults as FrameResults2, SingleFrameResult, asFrameResults } from "@reifydb/core";
+var Client = class {
+  /**
+   * Connect to ReifyDB via WebSocket
+   * @param url WebSocket URL
+   * @param options Optional configuration
+   * @returns Connected WebSocket client
+   */
+  static async connect_ws(url, options = {}) {
+    return WsClient.connect({ url, ...options });
+  }
+};
+export {
+  Client,
+  Diagnostic2 as Diagnostic,
+  DiagnosticColumn2 as DiagnosticColumn,
+  FrameResults2 as FrameResults,
+  ReifyError2 as ReifyError,
+  SingleFrameResult,
+  Span2 as Span,
+  WsClient,
+  asFrameResults
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ws.ts","../src/types.ts","../src/encoder.ts","../src/index.ts"],"sourcesContent":["/*\n * MIT License\n * Copyright (c) 2025 ReifyDB\n * See license.md file for full license text\n */\nimport {\n    decode,\n    Value,\n    SchemaNode,\n    InferSchemas,\n    FrameResults\n} from \"@reifydb/core\";\n\nimport {\n    CommandRequest,\n    CommandResponse,\n    ErrorResponse,\n    QueryRequest,\n    QueryResponse,\n    ReifyError,\n    Column,\n    Params\n} from \"./types\";\nimport {encodeParams} from \"./encoder\";\n\nexport interface WsClientOptions {\n    url: string;\n    timeoutMs?: number;\n    token?: string;\n}\n\ntype ResponsePayload = ErrorResponse | CommandResponse | QueryResponse;\n\nasync function createWebSocket(url: string): Promise<WebSocket> {\n    if (typeof window !== \"undefined\" && typeof window.WebSocket !== \"undefined\") {\n        return new WebSocket(url);\n    } else {\n        //@ts-ignore\n        const wsModule = await import(\"ws\");\n        return new wsModule.WebSocket(url);\n    }\n}\n\n\nexport class WsClient {\n    private options: WsClientOptions;\n    private nextId: number;\n    private socket: WebSocket;\n    private pending = new Map<string, (response: ResponsePayload) => void>();\n\n    private constructor(socket: WebSocket, options: WsClientOptions) {\n        this.options = options;\n        this.nextId = 1;\n        this.socket = socket;\n\n        this.socket.onmessage = (event) => {\n            const msg = JSON.parse(event.data);\n            const {id, type, payload} = msg;\n\n            const handler = this.pending.get(id);\n            if (!handler) {\n                return;\n            }\n\n            this.pending.delete(id);\n            handler({id, type, payload});\n        };\n\n        this.socket.onerror = (err) => {\n            console.error(\"WebSocket error\", err);\n        };\n    }\n\n    static async connect(options: WsClientOptions): Promise<WsClient> {\n        const socket = await createWebSocket(options.url);\n\n        // Wait for connection to open if not already open\n        if (socket.readyState !== socket.OPEN) {\n            await new Promise<void>((resolve, reject) => {\n                const onOpen = () => {\n                    socket.removeEventListener(\"open\", onOpen);\n                    socket.removeEventListener(\"error\", onError);\n                    resolve();\n                };\n\n                const onError = () => {\n                    socket.removeEventListener(\"open\", onOpen);\n                    socket.removeEventListener(\"error\", onError);\n                    reject(new Error(\"WebSocket connection failed\"));\n                };\n\n                socket.addEventListener(\"open\", onOpen);\n                socket.addEventListener(\"error\", onError);\n            });\n        }\n\n        socket.send(\"{\\\"id\\\":\\\"reifydb-auth-1\\\",\\\"type\\\":\\\"Auth\\\",\\\"payload\\\":{\\\"token\\\":\\\"mysecrettoken\\\"}}\");\n\n        return new WsClient(socket, options);\n    }\n\n    /**\n     * Execute command(s) with schemas for each statement for proper type inference\n     * @param statements - Single statement or array of RQL commands\n     * @param params - Parameters for the commands (use null or {} if no params)\n     * @param schemas - Schema for each statement's result\n     */\n    async command<const S extends readonly SchemaNode[]>(\n        statements: string | string[],\n        params: any,\n        schemas: S\n    ): Promise<FrameResults<S>> {\n        const id = `req-${this.nextId++}`;\n\n        // Normalize statements to array\n        const statementArray = Array.isArray(statements) ? statements : [statements];\n\n        // Encode params without schema assumptions\n        const encodedParams = params !== undefined && params !== null\n            ? encodeParams(params)\n            : undefined;\n\n        const result = await this.send({\n            id,\n            type: \"Command\",\n            payload: {\n                statements: statementArray,\n                params: encodedParams\n            },\n        });\n\n        // Transform each frame with its corresponding schema\n        const transformedFrames = result.map((frame: any, frameIndex: number) => {\n            const frameSchema = schemas[frameIndex];\n            if (!frameSchema) {\n                return frame; // No schema for this frame, return as-is\n            }\n            return frame.map((row: any) => this.transformResult(row, frameSchema));\n        });\n\n        return transformedFrames as FrameResults<S>;\n    }\n\n\n    /**\n     * Execute query(s) with schemas for each statement for proper type inference\n     * @param statements - Single statement or array of RQL queries\n     * @param params - Parameters for the queries (use null or {} if no params)\n     * @param schemas - Schema for each statement's result\n     */\n    async query<const S extends readonly SchemaNode[]>(\n        statements: string | string[],\n        params: any,\n        schemas: S\n    ): Promise<FrameResults<S>> {\n        const id = `req-${this.nextId++}`;\n\n        // Normalize statements to array\n        const statementArray = Array.isArray(statements) ? statements : [statements];\n\n        // Encode params without schema assumptions\n        const encodedParams = params !== undefined && params !== null\n            ? encodeParams(params)\n            : undefined;\n\n        const result = await this.send({\n            id,\n            type: \"Query\",\n            payload: {\n                statements: statementArray,\n                params: encodedParams\n            },\n        });\n\n        // Transform each frame with its corresponding schema\n        const transformedFrames = result.map((frame: any, frameIndex: number) => {\n            const frameSchema = schemas[frameIndex];\n            if (!frameSchema) {\n                return frame; // No schema for this frame, return as-is\n            }\n            return frame.map((row: any) => this.transformResult(row, frameSchema));\n        });\n\n        return transformedFrames as FrameResults<S>;\n    }\n\n    async send(req: CommandRequest | QueryRequest): Promise<any> {\n        const id = req.id;\n\n        const response = await new Promise<ResponsePayload>((resolve, reject) => {\n            const timeout = setTimeout(() => {\n                this.pending.delete(id);\n                reject(new Error(\"ReifyDB query timeout\"));\n            }, this.options.timeoutMs);\n\n            this.pending.set(id, (res) => {\n                clearTimeout(timeout);\n                resolve(res);\n            });\n\n            this.socket.send(JSON.stringify(req));\n        });\n\n        if (response.type === \"Err\") {\n            throw new ReifyError(response);\n\n        }\n\n        if (response.type !== req.type) {\n            throw new Error(`Unexpected response type: ${response.type}`);\n        }\n\n        return response.payload.frames.map((frame) =>\n            columnsToRows(frame.columns)\n        );\n    }\n\n\n    private transformResult(row: any, resultSchema: any): any {\n        // Handle object schema with primitive or value properties\n        if (resultSchema && resultSchema.kind === 'object' && resultSchema.properties) {\n            const transformedRow: any = {};\n            for (const [key, value] of Object.entries(row)) {\n                const propertySchema = resultSchema.properties[key];\n                if (propertySchema && propertySchema.kind === 'primitive') {\n                    // Convert Value objects to primitives for primitive schema properties\n                    if (value && typeof value === 'object' && 'value' in value) {\n                        const rawValue = (value as any).value;\n                        // Special handling for RowNumber - ensure it's returned as bigint\n                        if (propertySchema.type === 'RowNumber' && typeof rawValue === 'number') {\n                            transformedRow[key] = BigInt(rawValue);\n                        } else {\n                            transformedRow[key] = rawValue;\n                        }\n                    } else {\n                        transformedRow[key] = value;\n                    }\n                } else if (propertySchema && propertySchema.kind === 'value') {\n                    // Keep Value objects as-is for value schema properties\n                    transformedRow[key] = value;\n                } else {\n                    // Recursively transform nested structures\n                    transformedRow[key] = propertySchema ? this.transformResult(value, propertySchema) : value;\n                }\n            }\n            return transformedRow;\n        }\n\n        // Handle primitive schema transformation\n        if (resultSchema && resultSchema.kind === 'primitive') {\n            // Single primitive value - extract from Value object if needed\n            if (row && typeof row === 'object' && 'value' in row) {\n                const rawValue = row.value;\n                // Special handling for RowNumber - ensure it's returned as bigint\n                if (resultSchema.type === 'RowNumber' && typeof rawValue === 'number') {\n                    return BigInt(rawValue);\n                }\n                return rawValue;\n            }\n            return row;\n        }\n\n        // Handle value schema transformation - keep Value objects as-is\n        if (resultSchema && resultSchema.kind === 'value') {\n            return row;\n        }\n\n        // Handle array schema\n        if (resultSchema && resultSchema.kind === 'array') {\n            if (Array.isArray(row)) {\n                return row.map((item: any) => this.transformResult(item, resultSchema.items));\n            }\n            return row;\n        }\n\n        // Handle optional schema\n        if (resultSchema && resultSchema.kind === 'optional') {\n            if (row === undefined || row === null) {\n                return undefined;\n            }\n            return this.transformResult(row, resultSchema.schema);\n        }\n\n        // Default: return as-is\n        return row;\n    }\n\n    disconnect() {\n        this.socket.close();\n    }\n}\n\n\nfunction columnsToRows(columns: Column[]): Record<string, Value>[] {\n    const rowCount = columns[0]?.data.length ?? 0;\n    return Array.from({length: rowCount}, (_, i) => {\n        const row: Record<string, Value> = {};\n        for (const col of columns) {\n            row[col.name] = decode({type: col.ty, value: col.data[i]});\n        }\n        return row;\n    });\n}","/**\n * MIT License\n * Copyright (c) 2025 ReifyDB\n * See license.md file for full license text\n */\n\nimport { Params, Frame } from \"@reifydb/core\";\n\n// Re-export common types from core\nexport {\n    Params,\n    Frame,\n    DiagnosticColumn,\n    Span,\n    Diagnostic,\n    Column,\n    ErrorResponse,\n    ReifyError\n} from \"@reifydb/core\";\n\nexport interface CommandRequest {\n    id: string;\n    type: \"Command\";\n    payload: {\n        statements: string[];\n        params?: Params;\n    }\n}\n\nexport interface CommandResponse {\n    id: string;\n    type: \"Command\";\n    payload: {\n        frames: Frame[];\n    };\n}\n\nexport interface QueryRequest {\n    id: string;\n    type: \"Query\";\n    payload: {\n        statements: string[];\n        params?: Params;\n    }\n}\n\nexport interface QueryResponse {\n    id: string;\n    type: \"Query\";\n    payload: {\n        frames: Frame[];\n    };\n}","/**\n * MIT License\n * Copyright (c) 2025 ReifyDB\n * See license.md file for full license text\n */\n\nimport {Type, UNDEFINED_VALUE} from \"@reifydb/core\";\n\nexport interface TypeValuePair {\n    type: Type;\n    value: string;\n}\n\nexport function encodeValue(value: any): TypeValuePair {\n\n    if (value === null || value === undefined) {\n        return { type: 'Undefined', value: UNDEFINED_VALUE };\n    }\n    \n    if (value && typeof value === 'object' && 'encode' in value && typeof value.encode === 'function') {\n        return value.encode();\n    }\n    \n    if (typeof value === 'boolean') {\n        return { type: 'Bool', value: value.toString() };\n    }\n    \n    if (typeof value === 'number') {\n        if (Number.isInteger(value)) {\n            // Choose appropriate integer type based on value range\n            if (value >= -128 && value <= 127) {\n                return { type: 'Int1', value: value.toString() };\n            } else if (value >= -32768 && value <= 32767) {\n                return { type: 'Int2', value: value.toString() };\n            } else if (value >= -2147483648 && value <= 2147483647) {\n                return { type: 'Int4', value: value.toString() };\n            } else {\n                return { type: 'Int8', value: value.toString() };\n            }\n        } else {\n            // Floating point number\n            return { type: 'Float8', value: value.toString() };\n        }\n    }\n    \n    if (typeof value === 'string') {\n        if (/^[0-9a-f]{8}-[0-9a-f]{4}-[47][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value)) {\n            const version = value[14];\n            if (version === '4') {\n                return { type: 'Uuid4', value: value };\n            } else if (version === '7') {\n                return { type: 'Uuid7', value: value };\n            }\n        }\n        return { type: 'Utf8', value: value };\n    }\n    \n    if (typeof value === 'bigint') {\n        if (value >= BigInt(0)) {\n            if (value <= BigInt(255)) {\n                return { type: 'Uint1', value: value.toString() };\n            } else if (value <= BigInt(65535)) {\n                return { type: 'Uint2', value: value.toString() };\n            } else if (value <= BigInt(4294967295)) {\n                return { type: 'Uint4', value: value.toString() };\n            } else if (value <= BigInt('18446744073709551615')) {\n                return { type: 'Uint8', value: value.toString() };\n            } else {\n                return { type: 'Uint16', value: value.toString() };\n            }\n        } else {\n            if (value >= BigInt('-9223372036854775808')) {\n                return { type: 'Int8', value: value.toString() };\n            } else {\n                return { type: 'Int16', value: value.toString() };\n            }\n        }\n    }\n    \n    if (value instanceof Date) {\n        return { type: 'DateTime', value: value.toISOString() };\n    }\n    \n    if (value instanceof Uint8Array) {\n        const hex = Array.from(value)\n            .map(b => b.toString(16).padStart(2, '0'))\n            .join('');\n        return { type: 'Blob', value: '0x' + hex };\n    }\n    \n    if (value instanceof ArrayBuffer) {\n        const uint8Array = new Uint8Array(value);\n        const hex = Array.from(uint8Array)\n            .map(b => b.toString(16).padStart(2, '0'))\n            .join('');\n        return { type: 'Blob', value: '0x' + hex };\n    }\n    \n    throw new Error(`Cannot encode value of type ${typeof value}: ${value}`);\n}\n\nexport function encodeParams(params: any): TypeValuePair[] | Record<string, TypeValuePair> {\n    if (params === undefined || params === null) {\n        return [];\n    }\n    \n    if (Array.isArray(params)) {\n        return params.map(param => encodeValue(param));\n    } else if (typeof params === 'object') {\n        const encoded: Record<string, TypeValuePair> = {};\n        for (const [key, value] of Object.entries(params)) {\n            encoded[key] = encodeValue(value);\n        }\n        return encoded;\n    }\n    \n    throw new Error(`Invalid parameters type: expected array or object, got ${typeof params}`);\n}","/**\n * MIT License\n * Copyright (c) 2025 ReifyDB\n * See license.md file for full license text\n */\n\nimport {WsClient, WsClientOptions} from \"./ws\";\n\nexport class Client {\n    /**\n     * Connect to ReifyDB via WebSocket\n     * @param url WebSocket URL\n     * @param options Optional configuration\n     * @returns Connected WebSocket client\n     */\n    static async connect_ws(url: string, options: Omit<WsClientOptions, 'url'> = {}): Promise<WsClient> {\n        return WsClient.connect({url, ...options});\n    }\n}\n\nexport {ReifyError, Diagnostic, Span, DiagnosticColumn} from \"@reifydb/core\";\nexport {WsClient, WsClientOptions} from \"./ws\";\nexport {FrameResults, SingleFrameResult, asFrameResults} from \"@reifydb/core\";"],"mappings":";AAKA;AAAA,EACI;AAAA,OAKG;;;ACFP;AAAA,EACI;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACG;;;ACZP,SAAc,uBAAsB;AAO7B,SAAS,YAAY,OAA2B;AAEnD,MAAI,UAAU,QAAQ,UAAU,QAAW;AACvC,WAAO,EAAE,MAAM,aAAa,OAAO,gBAAgB;AAAA,EACvD;AAEA,MAAI,SAAS,OAAO,UAAU,YAAY,YAAY,SAAS,OAAO,MAAM,WAAW,YAAY;AAC/F,WAAO,MAAM,OAAO;AAAA,EACxB;AAEA,MAAI,OAAO,UAAU,WAAW;AAC5B,WAAO,EAAE,MAAM,QAAQ,OAAO,MAAM,SAAS,EAAE;AAAA,EACnD;AAEA,MAAI,OAAO,UAAU,UAAU;AAC3B,QAAI,OAAO,UAAU,KAAK,GAAG;AAEzB,UAAI,SAAS,QAAQ,SAAS,KAAK;AAC/B,eAAO,EAAE,MAAM,QAAQ,OAAO,MAAM,SAAS,EAAE;AAAA,MACnD,WAAW,SAAS,UAAU,SAAS,OAAO;AAC1C,eAAO,EAAE,MAAM,QAAQ,OAAO,MAAM,SAAS,EAAE;AAAA,MACnD,WAAW,SAAS,eAAe,SAAS,YAAY;AACpD,eAAO,EAAE,MAAM,QAAQ,OAAO,MAAM,SAAS,EAAE;AAAA,MACnD,OAAO;AACH,eAAO,EAAE,MAAM,QAAQ,OAAO,MAAM,SAAS,EAAE;AAAA,MACnD;AAAA,IACJ,OAAO;AAEH,aAAO,EAAE,MAAM,UAAU,OAAO,MAAM,SAAS,EAAE;AAAA,IACrD;AAAA,EACJ;AAEA,MAAI,OAAO,UAAU,UAAU;AAC3B,QAAI,4EAA4E,KAAK,KAAK,GAAG;AACzF,YAAM,UAAU,MAAM,EAAE;AACxB,UAAI,YAAY,KAAK;AACjB,eAAO,EAAE,MAAM,SAAS,MAAa;AAAA,MACzC,WAAW,YAAY,KAAK;AACxB,eAAO,EAAE,MAAM,SAAS,MAAa;AAAA,MACzC;AAAA,IACJ;AACA,WAAO,EAAE,MAAM,QAAQ,MAAa;AAAA,EACxC;AAEA,MAAI,OAAO,UAAU,UAAU;AAC3B,QAAI,SAAS,OAAO,CAAC,GAAG;AACpB,UAAI,SAAS,OAAO,GAAG,GAAG;AACtB,eAAO,EAAE,MAAM,SAAS,OAAO,MAAM,SAAS,EAAE;AAAA,MACpD,WAAW,SAAS,OAAO,KAAK,GAAG;AAC/B,eAAO,EAAE,MAAM,SAAS,OAAO,MAAM,SAAS,EAAE;AAAA,MACpD,WAAW,SAAS,OAAO,UAAU,GAAG;AACpC,eAAO,EAAE,MAAM,SAAS,OAAO,MAAM,SAAS,EAAE;AAAA,MACpD,WAAW,SAAS,OAAO,sBAAsB,GAAG;AAChD,eAAO,EAAE,MAAM,SAAS,OAAO,MAAM,SAAS,EAAE;AAAA,MACpD,OAAO;AACH,eAAO,EAAE,MAAM,UAAU,OAAO,MAAM,SAAS,EAAE;AAAA,MACrD;AAAA,IACJ,OAAO;AACH,UAAI,SAAS,OAAO,sBAAsB,GAAG;AACzC,eAAO,EAAE,MAAM,QAAQ,OAAO,MAAM,SAAS,EAAE;AAAA,MACnD,OAAO;AACH,eAAO,EAAE,MAAM,SAAS,OAAO,MAAM,SAAS,EAAE;AAAA,MACpD;AAAA,IACJ;AAAA,EACJ;AAEA,MAAI,iBAAiB,MAAM;AACvB,WAAO,EAAE,MAAM,YAAY,OAAO,MAAM,YAAY,EAAE;AAAA,EAC1D;AAEA,MAAI,iBAAiB,YAAY;AAC7B,UAAM,MAAM,MAAM,KAAK,KAAK,EACvB,IAAI,OAAK,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG,CAAC,EACxC,KAAK,EAAE;AACZ,WAAO,EAAE,MAAM,QAAQ,OAAO,OAAO,IAAI;AAAA,EAC7C;AAEA,MAAI,iBAAiB,aAAa;AAC9B,UAAM,aAAa,IAAI,WAAW,KAAK;AACvC,UAAM,MAAM,MAAM,KAAK,UAAU,EAC5B,IAAI,OAAK,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG,CAAC,EACxC,KAAK,EAAE;AACZ,WAAO,EAAE,MAAM,QAAQ,OAAO,OAAO,IAAI;AAAA,EAC7C;AAEA,QAAM,IAAI,MAAM,+BAA+B,OAAO,KAAK,KAAK,KAAK,EAAE;AAC3E;AAEO,SAAS,aAAa,QAA8D;AACvF,MAAI,WAAW,UAAa,WAAW,MAAM;AACzC,WAAO,CAAC;AAAA,EACZ;AAEA,MAAI,MAAM,QAAQ,MAAM,GAAG;AACvB,WAAO,OAAO,IAAI,WAAS,YAAY,KAAK,CAAC;AAAA,EACjD,WAAW,OAAO,WAAW,UAAU;AACnC,UAAM,UAAyC,CAAC;AAChD,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAM,GAAG;AAC/C,cAAQ,GAAG,IAAI,YAAY,KAAK;AAAA,IACpC;AACA,WAAO;AAAA,EACX;AAEA,QAAM,IAAI,MAAM,0DAA0D,OAAO,MAAM,EAAE;AAC7F;;;AFpFA,eAAe,gBAAgB,KAAiC;AAC5D,MAAI,OAAO,WAAW,eAAe,OAAO,OAAO,cAAc,aAAa;AAC1E,WAAO,IAAI,UAAU,GAAG;AAAA,EAC5B,OAAO;AAEH,UAAM,WAAW,MAAM,OAAO,IAAI;AAClC,WAAO,IAAI,SAAS,UAAU,GAAG;AAAA,EACrC;AACJ;AAGO,IAAM,WAAN,MAAM,UAAS;AAAA,EAMV,YAAY,QAAmB,SAA0B;AAFjE,SAAQ,UAAU,oBAAI,IAAiD;AAGnE,SAAK,UAAU;AACf,SAAK,SAAS;AACd,SAAK,SAAS;AAEd,SAAK,OAAO,YAAY,CAAC,UAAU;AAC/B,YAAM,MAAM,KAAK,MAAM,MAAM,IAAI;AACjC,YAAM,EAAC,IAAI,MAAM,QAAO,IAAI;AAE5B,YAAM,UAAU,KAAK,QAAQ,IAAI,EAAE;AACnC,UAAI,CAAC,SAAS;AACV;AAAA,MACJ;AAEA,WAAK,QAAQ,OAAO,EAAE;AACtB,cAAQ,EAAC,IAAI,MAAM,QAAO,CAAC;AAAA,IAC/B;AAEA,SAAK,OAAO,UAAU,CAAC,QAAQ;AAC3B,cAAQ,MAAM,mBAAmB,GAAG;AAAA,IACxC;AAAA,EACJ;AAAA,EAEA,aAAa,QAAQ,SAA6C;AAC9D,UAAM,SAAS,MAAM,gBAAgB,QAAQ,GAAG;AAGhD,QAAI,OAAO,eAAe,OAAO,MAAM;AACnC,YAAM,IAAI,QAAc,CAAC,SAAS,WAAW;AACzC,cAAM,SAAS,MAAM;AACjB,iBAAO,oBAAoB,QAAQ,MAAM;AACzC,iBAAO,oBAAoB,SAAS,OAAO;AAC3C,kBAAQ;AAAA,QACZ;AAEA,cAAM,UAAU,MAAM;AAClB,iBAAO,oBAAoB,QAAQ,MAAM;AACzC,iBAAO,oBAAoB,SAAS,OAAO;AAC3C,iBAAO,IAAI,MAAM,6BAA6B,CAAC;AAAA,QACnD;AAEA,eAAO,iBAAiB,QAAQ,MAAM;AACtC,eAAO,iBAAiB,SAAS,OAAO;AAAA,MAC5C,CAAC;AAAA,IACL;AAEA,WAAO,KAAK,2EAAyF;AAErG,WAAO,IAAI,UAAS,QAAQ,OAAO;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,QACF,YACA,QACA,SACwB;AACxB,UAAM,KAAK,OAAO,KAAK,QAAQ;AAG/B,UAAM,iBAAiB,MAAM,QAAQ,UAAU,IAAI,aAAa,CAAC,UAAU;AAG3E,UAAM,gBAAgB,WAAW,UAAa,WAAW,OACnD,aAAa,MAAM,IACnB;AAEN,UAAM,SAAS,MAAM,KAAK,KAAK;AAAA,MAC3B;AAAA,MACA,MAAM;AAAA,MACN,SAAS;AAAA,QACL,YAAY;AAAA,QACZ,QAAQ;AAAA,MACZ;AAAA,IACJ,CAAC;AAGD,UAAM,oBAAoB,OAAO,IAAI,CAAC,OAAY,eAAuB;AACrE,YAAM,cAAc,QAAQ,UAAU;AACtC,UAAI,CAAC,aAAa;AACd,eAAO;AAAA,MACX;AACA,aAAO,MAAM,IAAI,CAAC,QAAa,KAAK,gBAAgB,KAAK,WAAW,CAAC;AAAA,IACzE,CAAC;AAED,WAAO;AAAA,EACX;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,MACF,YACA,QACA,SACwB;AACxB,UAAM,KAAK,OAAO,KAAK,QAAQ;AAG/B,UAAM,iBAAiB,MAAM,QAAQ,UAAU,IAAI,aAAa,CAAC,UAAU;AAG3E,UAAM,gBAAgB,WAAW,UAAa,WAAW,OACnD,aAAa,MAAM,IACnB;AAEN,UAAM,SAAS,MAAM,KAAK,KAAK;AAAA,MAC3B;AAAA,MACA,MAAM;AAAA,MACN,SAAS;AAAA,QACL,YAAY;AAAA,QACZ,QAAQ;AAAA,MACZ;AAAA,IACJ,CAAC;AAGD,UAAM,oBAAoB,OAAO,IAAI,CAAC,OAAY,eAAuB;AACrE,YAAM,cAAc,QAAQ,UAAU;AACtC,UAAI,CAAC,aAAa;AACd,eAAO;AAAA,MACX;AACA,aAAO,MAAM,IAAI,CAAC,QAAa,KAAK,gBAAgB,KAAK,WAAW,CAAC;AAAA,IACzE,CAAC;AAED,WAAO;AAAA,EACX;AAAA,EAEA,MAAM,KAAK,KAAkD;AACzD,UAAM,KAAK,IAAI;AAEf,UAAM,WAAW,MAAM,IAAI,QAAyB,CAAC,SAAS,WAAW;AACrE,YAAM,UAAU,WAAW,MAAM;AAC7B,aAAK,QAAQ,OAAO,EAAE;AACtB,eAAO,IAAI,MAAM,uBAAuB,CAAC;AAAA,MAC7C,GAAG,KAAK,QAAQ,SAAS;AAEzB,WAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ;AAC1B,qBAAa,OAAO;AACpB,gBAAQ,GAAG;AAAA,MACf,CAAC;AAED,WAAK,OAAO,KAAK,KAAK,UAAU,GAAG,CAAC;AAAA,IACxC,CAAC;AAED,QAAI,SAAS,SAAS,OAAO;AACzB,YAAM,IAAI,WAAW,QAAQ;AAAA,IAEjC;AAEA,QAAI,SAAS,SAAS,IAAI,MAAM;AAC5B,YAAM,IAAI,MAAM,6BAA6B,SAAS,IAAI,EAAE;AAAA,IAChE;AAEA,WAAO,SAAS,QAAQ,OAAO;AAAA,MAAI,CAAC,UAChC,cAAc,MAAM,OAAO;AAAA,IAC/B;AAAA,EACJ;AAAA,EAGQ,gBAAgB,KAAU,cAAwB;AAEtD,QAAI,gBAAgB,aAAa,SAAS,YAAY,aAAa,YAAY;AAC3E,YAAM,iBAAsB,CAAC;AAC7B,iBAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,GAAG,GAAG;AAC5C,cAAM,iBAAiB,aAAa,WAAW,GAAG;AAClD,YAAI,kBAAkB,eAAe,SAAS,aAAa;AAEvD,cAAI,SAAS,OAAO,UAAU,YAAY,WAAW,OAAO;AACxD,kBAAM,WAAY,MAAc;AAEhC,gBAAI,eAAe,SAAS,eAAe,OAAO,aAAa,UAAU;AACrE,6BAAe,GAAG,IAAI,OAAO,QAAQ;AAAA,YACzC,OAAO;AACH,6BAAe,GAAG,IAAI;AAAA,YAC1B;AAAA,UACJ,OAAO;AACH,2BAAe,GAAG,IAAI;AAAA,UAC1B;AAAA,QACJ,WAAW,kBAAkB,eAAe,SAAS,SAAS;AAE1D,yBAAe,GAAG,IAAI;AAAA,QAC1B,OAAO;AAEH,yBAAe,GAAG,IAAI,iBAAiB,KAAK,gBAAgB,OAAO,cAAc,IAAI;AAAA,QACzF;AAAA,MACJ;AACA,aAAO;AAAA,IACX;AAGA,QAAI,gBAAgB,aAAa,SAAS,aAAa;AAEnD,UAAI,OAAO,OAAO,QAAQ,YAAY,WAAW,KAAK;AAClD,cAAM,WAAW,IAAI;AAErB,YAAI,aAAa,SAAS,eAAe,OAAO,aAAa,UAAU;AACnE,iBAAO,OAAO,QAAQ;AAAA,QAC1B;AACA,eAAO;AAAA,MACX;AACA,aAAO;AAAA,IACX;AAGA,QAAI,gBAAgB,aAAa,SAAS,SAAS;AAC/C,aAAO;AAAA,IACX;AAGA,QAAI,gBAAgB,aAAa,SAAS,SAAS;AAC/C,UAAI,MAAM,QAAQ,GAAG,GAAG;AACpB,eAAO,IAAI,IAAI,CAAC,SAAc,KAAK,gBAAgB,MAAM,aAAa,KAAK,CAAC;AAAA,MAChF;AACA,aAAO;AAAA,IACX;AAGA,QAAI,gBAAgB,aAAa,SAAS,YAAY;AAClD,UAAI,QAAQ,UAAa,QAAQ,MAAM;AACnC,eAAO;AAAA,MACX;AACA,aAAO,KAAK,gBAAgB,KAAK,aAAa,MAAM;AAAA,IACxD;AAGA,WAAO;AAAA,EACX;AAAA,EAEA,aAAa;AACT,SAAK,OAAO,MAAM;AAAA,EACtB;AACJ;AAGA,SAAS,cAAc,SAA4C;AAC/D,QAAM,WAAW,QAAQ,CAAC,GAAG,KAAK,UAAU;AAC5C,SAAO,MAAM,KAAK,EAAC,QAAQ,SAAQ,GAAG,CAAC,GAAG,MAAM;AAC5C,UAAM,MAA6B,CAAC;AACpC,eAAW,OAAO,SAAS;AACvB,UAAI,IAAI,IAAI,IAAI,OAAO,EAAC,MAAM,IAAI,IAAI,OAAO,IAAI,KAAK,CAAC,EAAC,CAAC;AAAA,IAC7D;AACA,WAAO;AAAA,EACX,CAAC;AACL;;;AG1RA,SAAQ,cAAAA,aAAY,cAAAC,aAAY,QAAAC,OAAM,oBAAAC,yBAAuB;AAE7D,SAAQ,gBAAAC,eAAc,mBAAmB,sBAAqB;AAdvD,IAAM,SAAN,MAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOhB,aAAa,WAAW,KAAa,UAAwC,CAAC,GAAsB;AAChG,WAAO,SAAS,QAAQ,EAAC,KAAK,GAAG,QAAO,CAAC;AAAA,EAC7C;AACJ;","names":["ReifyError","Diagnostic","Span","DiagnosticColumn","FrameResults"]}

package/license.md

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 The ReifyDB Developers <license@reifydb.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@reifydb/client",
+  "type": "module",
+  "version": "0.0.1-alpha.1",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "dependencies": {
+    "@reifydb/core": "^0.0.1",
+    "uuid": "^11.1.0",
+    "ws": "^8.18.3"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.10",
+    "@vitest/coverage-v8": "^2.1.8",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.3",
+    "vitest": "^2.1.8"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "keywords": [
+    "reifydb",
+    "database",
+    "websocket",
+    "client",
+    "typescript"
+  ],
+  "files": [
+    "dist/",
+    "package.json",
+    "readme.md",
+    "license.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/reifydb/reifydb.git",
+    "directory": "pkg/typescript/client"
+  },
+  "homepage": "https://github.com/reifydb/reifydb#readme",
+  "bugs": {
+    "url": "https://github.com/reifydb/reifydb/issues"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --dts --format esm --sourcemap",
+    "test": "pnpm test:integration",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "test:integration:watch": "vitest --config vitest.integration.config.ts",
+    "test:integration:coverage": "vitest run --coverage --config vitest.integration.config.ts",
+    "test:coverage": "pnpm test:integration:coverage",
+    "pretest:integration": "pnpm build",
+    "publish:npm": "pnpm publish --access public"
+  }
+}

package/readme.md

@@ -0,0 +1 @@
+# ReifyDB Client