@zvndev/powdb-client 0.5.0 → 0.6.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.5.1 - 2026-06-17
+
+- Kept the npm client release in lockstep with PowDB workspace v0.5.1.
+- No TypeScript API changes; this is a dependency/version-alignment release.
+
+
 All notable changes to `@zvndev/powdb-client`.
 
 ## Compatibility

package/dist/index.d.ts

@@ -18,7 +18,7 @@ import * as tls from "node:tls";
 import { EventEmitter } from "node:events";
 import { type TypedRow, type TypedSchema } from "./typed.js";
 /** Client library version. Compared to the server's reported version. */
-export declare const CLIENT_VERSION = "0.4.0";
+export declare const CLIENT_VERSION = "0.6.1";
 export type QueryResult = {
     kind: "rows";
     columns: string[];
@@ -114,6 +114,13 @@ export declare class Client extends EventEmitter<ClientEvents> {
     }, maybeOpts?: {
         signal?: AbortSignal;
     }): Promise<QueryResult>;
+    /**
+     * Run a SQL statement through the server-side SQL frontend. The plain
+     * {@link query} method remains PowQL for wire compatibility.
+     */
+    querySql(query: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<QueryResult>;
     /**
      * Like {@link query}, but coerces string result columns to typed JS values
      * using the caller-supplied schema. See `./typed.ts` for the coercion

package/dist/index.js

@@ -21,7 +21,10 @@ import { encode, tryDecode, } from "./protocol.js";
 import { PowDBError } from "./errors.js";
 import { coerceRows, } from "./typed.js";
 /** Client library version. Compared to the server's reported version. */
-export const CLIENT_VERSION = "0.4.0";
+export const CLIENT_VERSION = "0.6.1";
+function socketChunkToBuffer(chunk) {
+    return typeof chunk === "string" ? Buffer.from(chunk) : chunk;
+}
 /** Map a JS {@link QueryParam} to its wire encoding. */
 function toWireParam(p) {
     if (p === null)
@@ -76,7 +79,7 @@ export class Client extends EventEmitter {
         super();
         this.socket = socket;
         this.serverVersion = serverVersion;
-        this.socket.on("data", (chunk) => this.onData(chunk));
+        this.socket.on("data", (chunk) => this.onData(socketChunkToBuffer(chunk)));
         this.socket.on("error", (err) => this.onClose(err));
         this.socket.on("close", () => this.onClose(null));
     }
@@ -94,7 +97,7 @@ export class Client extends EventEmitter {
                 socket.removeListener("close", onClose);
             };
             const onData = (chunk) => {
-                scratch = Buffer.concat([scratch, chunk]);
+                scratch = Buffer.concat([scratch, socketChunkToBuffer(chunk)]);
                 let decoded;
                 try {
                     decoded = tryDecode(scratch);
@@ -216,6 +219,51 @@ export class Client extends EventEmitter {
             throw err;
         }
     }
+    /**
+     * Run a SQL statement through the server-side SQL frontend. The plain
+     * {@link query} method remains PowQL for wire compatibility.
+     */
+    async querySql(query, opts) {
+        const start = Date.now();
+        try {
+            const reply = await this.send({ type: "QuerySql", query }, opts);
+            let result;
+            switch (reply.type) {
+                case "ResultRows":
+                    result = { kind: "rows", columns: reply.columns, rows: reply.rows };
+                    break;
+                case "ResultScalar":
+                    result = { kind: "scalar", value: reply.value };
+                    break;
+                case "ResultOk":
+                    result = { kind: "ok", affected: reply.affected };
+                    break;
+                case "ResultMessage":
+                    result = { kind: "message", message: reply.message };
+                    break;
+                case "Error":
+                    throw new PowDBError(`query failed: ${reply.message}`, "query_failed");
+                default:
+                    throw new PowDBError(`unexpected reply: ${reply.type}`, "protocol_error");
+            }
+            this.emit("query", {
+                query,
+                durationMs: Date.now() - start,
+                ok: true,
+                kind: result.kind,
+            });
+            return result;
+        }
+        catch (err) {
+            this.emit("query", {
+                query,
+                durationMs: Date.now() - start,
+                ok: false,
+                error: err,
+            });
+            throw err;
+        }
+    }
     /**
      * Like {@link query}, but coerces string result columns to typed JS values
      * using the caller-supplied schema. See `./typed.ts` for the coercion

package/dist/protocol.d.ts

@@ -15,6 +15,8 @@ export declare const MSG_QUERY = 3;
  * plain `MSG_QUERY` frame is unchanged. Requires powdb-server ≥ 0.4.7.
  */
 export declare const MSG_QUERY_PARAMS = 4;
+/** SQL query frame. Plain Query remains PowQL for backward compatibility. */
+export declare const MSG_QUERY_SQL = 5;
 export declare const MSG_RESULT_ROWS = 7;
 export declare const MSG_RESULT_SCALAR = 8;
 export declare const MSG_RESULT_OK = 9;
@@ -73,6 +75,9 @@ export type Message = {
 } | {
     type: "Query";
     query: string;
+} | {
+    type: "QuerySql";
+    query: string;
 } | {
     type: "QueryWithParams";
     query: string;

package/dist/protocol.js

@@ -15,6 +15,8 @@ export const MSG_QUERY = 0x03;
  * plain `MSG_QUERY` frame is unchanged. Requires powdb-server ≥ 0.4.7.
  */
 export const MSG_QUERY_PARAMS = 0x04;
+/** SQL query frame. Plain Query remains PowQL for backward compatibility. */
+export const MSG_QUERY_SQL = 0x05;
 export const MSG_RESULT_ROWS = 0x07;
 export const MSG_RESULT_SCALAR = 0x08;
 export const MSG_RESULT_OK = 0x09;
@@ -60,6 +62,10 @@ export function encode(msg) {
             payload = encodeString(msg.query);
             msgType = MSG_QUERY;
             break;
+        case "QuerySql":
+            payload = encodeString(msg.query);
+            msgType = MSG_QUERY_SQL;
+            break;
         case "QueryWithParams": {
             const parts = [encodeString(msg.query)];
             const count = Buffer.alloc(2);
@@ -194,6 +200,10 @@ function decodePayload(msgType, payload) {
             return { type: "ConnectOk", version: decodeString(payload, cursor) };
         case MSG_QUERY:
             return { type: "Query", query: decodeString(payload, cursor) };
+        case MSG_QUERY_SQL: {
+            const query = decodeString(payload, cursor);
+            return { type: "QuerySql", query };
+        }
         case MSG_QUERY_PARAMS: {
             const query = decodeString(payload, cursor);
             const count = readU16(payload, cursor, "param count");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zvndev/powdb-client",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "TypeScript client for PowDB (PowQL wire protocol)",
   "type": "module",
   "packageManager": "pnpm@10.29.3",