stitchdb 1.0.0 → 1.2.0

package/dist/index.d.mts

@@ -30,15 +30,26 @@ interface ExecResult {
 }
 declare class StitchDBError extends Error {
     status: number;
-    constructor(message: string, status: number);
+    constructor(message: string, status?: number);
 }
+/**
+ * StitchDB client.
+ *
+ * Uses HTTP/2 with persistent connections (via fetch keep-alive).
+ * All requests share one TCP connection — no repeated TLS handshakes.
+ * Batch API sends multiple queries in one request.
+ */
 declare class StitchDB {
     private url;
     private apiKey;
+    private headers;
     constructor(config: StitchDBConfig);
     /** Run a SQL query with parameterized bindings. */
     query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<QueryResult<T>>;
-    /** Run multiple queries atomically in a single batch. */
+    /**
+     * Run multiple queries in a single HTTP request.
+     * All queries execute atomically. One Worker invocation for N queries.
+     */
     batch(queries: {
         sql: string;
         params?: unknown[];
@@ -47,6 +58,11 @@ declare class StitchDB {
     run(sql: string): Promise<ExecResult>;
     /** Insert a row. */
     insert(table: string, data: Record<string, unknown>): Promise<QueryResult>;
+    /**
+     * Insert multiple rows in a single request using batch API.
+     * One Worker invocation regardless of how many rows.
+     */
+    insertMany(table: string, rows: Record<string, unknown>[]): Promise<BatchResult>;
     /** Update rows matching a WHERE clause. */
     update(table: string, data: Record<string, unknown>, where: string, whereParams?: unknown[]): Promise<QueryResult>;
     /** Delete rows matching a WHERE clause. */

package/dist/index.d.ts

@@ -30,15 +30,26 @@ interface ExecResult {
 }
 declare class StitchDBError extends Error {
     status: number;
-    constructor(message: string, status: number);
+    constructor(message: string, status?: number);
 }
+/**
+ * StitchDB client.
+ *
+ * Uses HTTP/2 with persistent connections (via fetch keep-alive).
+ * All requests share one TCP connection — no repeated TLS handshakes.
+ * Batch API sends multiple queries in one request.
+ */
 declare class StitchDB {
     private url;
     private apiKey;
+    private headers;
     constructor(config: StitchDBConfig);
     /** Run a SQL query with parameterized bindings. */
     query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<QueryResult<T>>;
-    /** Run multiple queries atomically in a single batch. */
+    /**
+     * Run multiple queries in a single HTTP request.
+     * All queries execute atomically. One Worker invocation for N queries.
+     */
     batch(queries: {
         sql: string;
         params?: unknown[];
@@ -47,6 +58,11 @@ declare class StitchDB {
     run(sql: string): Promise<ExecResult>;
     /** Insert a row. */
     insert(table: string, data: Record<string, unknown>): Promise<QueryResult>;
+    /**
+     * Insert multiple rows in a single request using batch API.
+     * One Worker invocation regardless of how many rows.
+     */
+    insertMany(table: string, rows: Record<string, unknown>[]): Promise<BatchResult>;
     /** Update rows matching a WHERE clause. */
     update(table: string, data: Record<string, unknown>, where: string, whereParams?: unknown[]): Promise<QueryResult>;
     /** Delete rows matching a WHERE clause. */

package/dist/index.js

@@ -27,7 +27,7 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 var StitchDBError = class extends Error {
-  constructor(message, status) {
+  constructor(message, status = 0) {
     super(message);
     this.name = "StitchDBError";
     this.status = status;
@@ -37,12 +37,19 @@ var StitchDB = class {
   constructor(config) {
     this.url = (config.url || "https://db.stitchdb.com").replace(/\/$/, "");
     this.apiKey = config.apiKey;
+    this.headers = {
+      "Authorization": `Bearer ${this.apiKey}`,
+      "Content-Type": "application/json"
+    };
   }
   /** Run a SQL query with parameterized bindings. */
   async query(sql, params) {
     return this.post("/v1/query", { sql, params });
   }
-  /** Run multiple queries atomically in a single batch. */
+  /**
+   * Run multiple queries in a single HTTP request.
+   * All queries execute atomically. One Worker invocation for N queries.
+   */
   async batch(queries) {
     return this.post("/v1/batch", { queries });
   }
@@ -56,6 +63,16 @@ var StitchDB = class {
     const sql = `INSERT INTO "${table}" (${cols.map((c) => `"${c}"`).join(", ")}) VALUES (${cols.map(() => "?").join(", ")})`;
     return this.query(sql, Object.values(data));
   }
+  /**
+   * Insert multiple rows in a single request using batch API.
+   * One Worker invocation regardless of how many rows.
+   */
+  async insertMany(table, rows) {
+    if (rows.length === 0) return { results: [], meta: { rows_read: 0, rows_written: 0, duration_ms: 0, queries_count: 0 } };
+    const cols = Object.keys(rows[0]);
+    const sql = `INSERT INTO "${table}" (${cols.map((c) => `"${c}"`).join(", ")}) VALUES (${cols.map(() => "?").join(", ")})`;
+    return this.batch(rows.map((row) => ({ sql, params: cols.map((c) => row[c]) })));
+  }
   /** Update rows matching a WHERE clause. */
   async update(table, data, where, whereParams) {
     const set = Object.keys(data).map((c) => `"${c}" = ?`).join(", ");
@@ -83,11 +100,10 @@ var StitchDB = class {
   async post(path, body) {
     const res = await fetch(`${this.url}${path}`, {
       method: "POST",
-      headers: {
-        "Authorization": `Bearer ${this.apiKey}`,
-        "Content-Type": "application/json"
-      },
-      body: JSON.stringify(body)
+      headers: this.headers,
+      body: JSON.stringify(body),
+      // @ts-ignore — keepalive hint for HTTP/2 connection reuse
+      keepalive: true
     });
     const data = await res.json();
     if (!res.ok || data.error) {

package/dist/index.mjs

@@ -1,6 +1,6 @@
 // src/index.ts
 var StitchDBError = class extends Error {
-  constructor(message, status) {
+  constructor(message, status = 0) {
     super(message);
     this.name = "StitchDBError";
     this.status = status;
@@ -10,12 +10,19 @@ var StitchDB = class {
   constructor(config) {
     this.url = (config.url || "https://db.stitchdb.com").replace(/\/$/, "");
     this.apiKey = config.apiKey;
+    this.headers = {
+      "Authorization": `Bearer ${this.apiKey}`,
+      "Content-Type": "application/json"
+    };
   }
   /** Run a SQL query with parameterized bindings. */
   async query(sql, params) {
     return this.post("/v1/query", { sql, params });
   }
-  /** Run multiple queries atomically in a single batch. */
+  /**
+   * Run multiple queries in a single HTTP request.
+   * All queries execute atomically. One Worker invocation for N queries.
+   */
   async batch(queries) {
     return this.post("/v1/batch", { queries });
   }
@@ -29,6 +36,16 @@ var StitchDB = class {
     const sql = `INSERT INTO "${table}" (${cols.map((c) => `"${c}"`).join(", ")}) VALUES (${cols.map(() => "?").join(", ")})`;
     return this.query(sql, Object.values(data));
   }
+  /**
+   * Insert multiple rows in a single request using batch API.
+   * One Worker invocation regardless of how many rows.
+   */
+  async insertMany(table, rows) {
+    if (rows.length === 0) return { results: [], meta: { rows_read: 0, rows_written: 0, duration_ms: 0, queries_count: 0 } };
+    const cols = Object.keys(rows[0]);
+    const sql = `INSERT INTO "${table}" (${cols.map((c) => `"${c}"`).join(", ")}) VALUES (${cols.map(() => "?").join(", ")})`;
+    return this.batch(rows.map((row) => ({ sql, params: cols.map((c) => row[c]) })));
+  }
   /** Update rows matching a WHERE clause. */
   async update(table, data, where, whereParams) {
     const set = Object.keys(data).map((c) => `"${c}" = ?`).join(", ");
@@ -56,11 +73,10 @@ var StitchDB = class {
   async post(path, body) {
     const res = await fetch(`${this.url}${path}`, {
       method: "POST",
-      headers: {
-        "Authorization": `Bearer ${this.apiKey}`,
-        "Content-Type": "application/json"
-      },
-      body: JSON.stringify(body)
+      headers: this.headers,
+      body: JSON.stringify(body),
+      // @ts-ignore — keepalive hint for HTTP/2 connection reuse
+      keepalive: true
     });
     const data = await res.json();
     if (!res.ok || data.error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stitchdb",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "StitchDB client for JavaScript and TypeScript",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -19,7 +19,13 @@
     "build": "tsup src/index.ts --format cjs,esm --dts",
     "prepublishOnly": "npm run build"
   },
-  "keywords": ["stitchdb", "database", "sql", "edge", "serverless"],
+  "keywords": [
+    "stitchdb",
+    "database",
+    "sql",
+    "edge",
+    "serverless"
+  ],
   "license": "MIT",
   "author": {
     "name": "StitchDB",
@@ -35,4 +41,4 @@
     "tsup": "^8.0.0",
     "typescript": "^5.0.0"
   }
-}
+}