@petradb/client 1.0.1

package/README.md

@@ -0,0 +1,81 @@
+Network client for [petradb-server](https://github.com/edadma/petradb) with the same `Session` API as `@petradb/engine`.
+
+## Installation
+
+```bash
+npm install @petradb/client
+```
+
+## Quick Start
+
+```javascript
+import { Session } from '@petradb/client';
+
+const db = new Session({ host: 'localhost', port: 5432 });
+
+await db.execute(`
+  CREATE TABLE users (
+    id SERIAL,
+    name TEXT NOT NULL,
+    email TEXT,
+    PRIMARY KEY (id)
+  )
+`);
+
+await db.execute("INSERT INTO users (name, email) VALUES ('Alice', 'alice@example.com')");
+
+const [{ rows }] = await db.execute('SELECT * FROM users');
+console.log(rows);
+```
+
+## Swapping Embedded and Network
+
+Both `@petradb/engine` and `@petradb/client` export `Session` with the same `async execute()` API. Switch between them with a one-line import change:
+
+```javascript
+// Embedded (in-process, no server needed)
+import { Session } from '@petradb/engine';
+const db = new Session();
+
+// Network (talks to petradb-server over HTTP)
+import { Session } from '@petradb/client';
+const db = new Session({ host: 'localhost', port: 5432 });
+
+// Everything below works identically
+await db.execute('CREATE TABLE ...');
+const [{ rows }] = await db.execute('SELECT * FROM ...');
+```
+
+## API
+
+### `new Session(options?)`
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `host` | `string` | `'localhost'` | Server hostname |
+| `port` | `number` | `5432` | Server port |
+| `rowMode` | `'object' \| 'array'` | `'object'` | Default row format for SELECT results |
+
+### `db.execute(sql, options?)`
+
+Sends SQL to the server. Returns a promise that resolves to an array of results.
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `rowMode` | `'object' \| 'array'` | constructor default | Row format for this call |
+
+### `db.connect()`
+
+Creates a server-side session. The session ID is sent automatically with subsequent `execute()` calls via the `X-Session-Id` header.
+
+### `db.close()`
+
+Closes the server-side session.
+
+## No Dependencies
+
+Uses the native `fetch` API (Node.js 18+, all modern browsers).
+
+## License
+
+[ISC](https://opensource.org/licenses/ISC)

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+export interface SessionOptions {
+    host?: string;
+    port?: number;
+    rowMode?: "object" | "array";
+}
+export interface ExecuteOptions {
+    rowMode?: "object" | "array";
+}
+export interface FieldInfo {
+    name: string;
+    dataType: string;
+}
+export interface ExecuteResult {
+    command: string;
+    [key: string]: any;
+}
+export declare class Session {
+    private baseUrl;
+    private defaultRowMode;
+    private sessionId;
+    constructor(options?: SessionOptions);
+    execute(sql: string, options?: ExecuteOptions): Promise<ExecuteResult[]>;
+    connect(): Promise<void>;
+    close(): Promise<void>;
+}

package/dist/index.js

@@ -0,0 +1,51 @@
+export class Session {
+    constructor(options = {}) {
+        this.sessionId = null;
+        const host = options.host ?? "localhost";
+        const port = options.port ?? 5432;
+        this.baseUrl = `http://${host}:${port}`;
+        this.defaultRowMode = options.rowMode ?? "object";
+    }
+    async execute(sql, options) {
+        const rowMode = options?.rowMode ?? this.defaultRowMode;
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (this.sessionId) {
+            headers["X-Session-Id"] = this.sessionId;
+        }
+        const res = await fetch(`${this.baseUrl}/sql`, {
+            method: "POST",
+            headers,
+            body: JSON.stringify({ sql, rowMode }),
+        });
+        if (!res.ok) {
+            const body = await res.text();
+            throw new Error(body || `HTTP ${res.status}`);
+        }
+        return (await res.json());
+    }
+    async connect() {
+        const res = await fetch(`${this.baseUrl}/session`, {
+            method: "POST",
+        });
+        if (!res.ok) {
+            const body = await res.text();
+            throw new Error(body || `HTTP ${res.status}`);
+        }
+        const data = (await res.json());
+        this.sessionId = data.sessionId;
+    }
+    async close() {
+        if (!this.sessionId)
+            return;
+        const res = await fetch(`${this.baseUrl}/session/${this.sessionId}`, {
+            method: "DELETE",
+        });
+        if (!res.ok) {
+            const body = await res.text();
+            throw new Error(body || `HTTP ${res.status}`);
+        }
+        this.sessionId = null;
+    }
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@petradb/client",
+  "version": "1.0.1",
+  "description": "Network client for petradb-server with the same Session API as @petradb/engine",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/edadma/petradb.git"
+  },
+  "keywords": [
+    "SQL",
+    "database",
+    "client",
+    "petradb"
+  ],
+  "author": "Edward A. Maxedon, Sr.",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/edadma/petradb/issues"
+  },
+  "homepage": "https://github.com/edadma/petradb#readme",
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}