@tursodatabase/serverless 0.1.0

package/dist/statement.js

@@ -0,0 +1,94 @@
+import { decodeValue } from './protocol.js';
+import { Session } from './session.js';
+/**
+ * A prepared SQL statement that can be executed in multiple ways.
+ *
+ * Each statement has its own session to avoid conflicts during concurrent execution.
+ * Provides three execution modes:
+ * - `get(args?)`: Returns the first row or null
+ * - `all(args?)`: Returns all rows as an array
+ * - `iterate(args?)`: Returns an async iterator for streaming results
+ */
+export class Statement {
+    constructor(sessionConfig, sql) {
+        this.session = new Session(sessionConfig);
+        this.sql = sql;
+    }
+    /**
+     * Execute the statement and return the first row.
+     *
+     * @param args - Optional array of parameter values for the SQL statement
+     * @returns Promise resolving to the first row or null if no results
+     *
+     * @example
+     * ```typescript
+     * const stmt = client.prepare("SELECT * FROM users WHERE id = ?");
+     * const user = await stmt.get([123]);
+     * if (user) {
+     *   console.log(user.name);
+     * }
+     * ```
+     */
+    async get(args = []) {
+        const result = await this.session.execute(this.sql, args);
+        return result.rows[0] || null;
+    }
+    /**
+     * Execute the statement and return all rows.
+     *
+     * @param args - Optional array of parameter values for the SQL statement
+     * @returns Promise resolving to an array of all result rows
+     *
+     * @example
+     * ```typescript
+     * const stmt = client.prepare("SELECT * FROM users WHERE active = ?");
+     * const activeUsers = await stmt.all([true]);
+     * console.log(`Found ${activeUsers.length} active users`);
+     * ```
+     */
+    async all(args = []) {
+        const result = await this.session.execute(this.sql, args);
+        return result.rows;
+    }
+    /**
+     * Execute the statement and return an async iterator for streaming results.
+     *
+     * This method provides memory-efficient processing of large result sets
+     * by streaming rows one at a time instead of loading everything into memory.
+     *
+     * @param args - Optional array of parameter values for the SQL statement
+     * @returns AsyncGenerator that yields individual rows
+     *
+     * @example
+     * ```typescript
+     * const stmt = client.prepare("SELECT * FROM large_table WHERE category = ?");
+     * for await (const row of stmt.iterate(['electronics'])) {
+     *   // Process each row individually
+     *   console.log(row.id, row.name);
+     * }
+     * ```
+     */
+    async *iterate(args = []) {
+        const { response, entries } = await this.session.executeRaw(this.sql, args);
+        let columns = [];
+        for await (const entry of entries) {
+            switch (entry.type) {
+                case 'step_begin':
+                    if (entry.cols) {
+                        columns = entry.cols.map(col => col.name);
+                    }
+                    break;
+                case 'row':
+                    if (entry.row) {
+                        const decodedRow = entry.row.map(decodeValue);
+                        const rowObject = this.session.createRowObject(decodedRow, columns);
+                        yield rowObject;
+                    }
+                    break;
+                case 'step_error':
+                case 'error':
+                    throw new Error(entry.error?.message || 'SQL execution failed');
+            }
+        }
+    }
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@tursodatabase/serverless",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./compat": {
+      "import": "./dist/compat/index.js",
+      "types": "./dist/compat/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "ava integration-tests/*.test.mjs"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "description": "",
+  "devDependencies": {
+    "@types/node": "^24.0.13",
+    "ava": "^6.4.1",
+    "typescript": "^5.8.3"
+  }
+}