@tursodatabase/serverless 0.1.2 → 0.1.3

package/README.md

@@ -1,9 +1,22 @@
-# Turso serverless JavaScript driver
+<p align="center">
+  <h1 align="center">Turso Serverless Driver for JavaScript</h1>
+</p>
+
+<p align="center">
+  <a title="JavaScript" target="_blank" href="https://www.npmjs.com/package/@tursodatabase/serverless"><img alt="npm" src="https://img.shields.io/npm/v/@tursodatabase/serverless"></a>
+  <a title="MIT" target="_blank" href="https://github.com/tursodatabase/turso/blob/main/LICENSE.md"><img src="http://img.shields.io/badge/license-MIT-orange.svg?style=flat-square"></a>
+</p>
+<p align="center">
+  <a title="Users Discord" target="_blank" href="https://tur.so/discord"><img alt="Chat with other users of Turso on Discord" src="https://img.shields.io/discord/933071162680958986?label=Discord&logo=Discord&style=social"></a>
+</p>
+
+---
+
+## About
 
 A serverless database driver for Turso Cloud, using only `fetch()`. Connect to your database from serverless and edge functions, such as Cloudflare Workers and Vercel.
 
-> [!NOTE]
-> This driver is experimental and, therefore, subject to change at any time.
+> **📝 Note:** This driver is experimental and, therefore, subject to change at any time.
 
 ## Installation
 
@@ -11,7 +24,9 @@ A serverless database driver for Turso Cloud, using only `fetch()`. Connect to y
 npm install @tursodatabase/serverless
 ```
 
-## Usage
+## Getting Started
+
+### Basic Usage
 
 ```javascript
 import { connect } from "@tursodatabase/serverless";
@@ -36,7 +51,11 @@ console.log(rows);
 for await (const row of stmt.iterate([123])) {
   console.log(row);
 }
+```
+
+### Batch Operations
 
+```javascript
 // Execute multiple statements in a batch
 await conn.batch([
   "CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY, email TEXT)",
@@ -45,9 +64,9 @@ await conn.batch([
 ]);
 ```
 
-### Compatibility layer for libSQL API
+### libSQL Compatibility Layer
 
-This driver supports the libSQL API as a compatibility layer.
+For existing libSQL applications, use the compatibility layer:
 
 ```javascript
 import { createClient } from "@tursodatabase/serverless/compat";
@@ -73,6 +92,21 @@ await client.batch([
 
 Check out the `examples/` directory for complete usage examples.
 
+## API Reference
+
+For complete API documentation, see [JavaScript API Reference](../../docs/javascript-api-reference.md).
+
+## Related Packages
+
+* The [@tursodatabase/database](https://www.npmjs.com/package/@tursodatabase/database) package provides the Turso in-memory database, compatible with SQLite.
+* The [@tursodatabase/sync](https://www.npmjs.com/package/@tursodatabase/sync) package provides bidirectional sync between a local Turso database and Turso Cloud. 
+
 ## License
 
-MIT
+This project is licensed under the [MIT license](../../LICENSE.md).
+
+## Support
+
+- [GitHub Issues](https://github.com/tursodatabase/turso/issues)
+- [Documentation](https://docs.turso.tech)
+- [Discord Community](https://tur.so/discord)

package/dist/connection.d.ts

@@ -14,6 +14,7 @@ export interface Config extends SessionConfig {
 export declare class Connection {
     private config;
     private session;
+    private isOpen;
     constructor(config: Config);
     /**
      * Prepare a SQL statement for execution.

package/dist/connection.js

@@ -8,6 +8,7 @@ import { Statement } from './statement.js';
  */
 export class Connection {
     constructor(config) {
+        this.isOpen = true;
         if (!config.url) {
             throw new Error("invalid config: url is required");
         }
@@ -30,6 +31,9 @@ export class Connection {
      * ```
      */
     prepare(sql) {
+        if (!this.isOpen) {
+            throw new TypeError("The database connection is not open");
+        }
         return new Statement(this.config, sql);
     }
     /**
@@ -45,6 +49,9 @@ export class Connection {
      * ```
      */
     async exec(sql) {
+        if (!this.isOpen) {
+            throw new TypeError("The database connection is not open");
+        }
         return this.session.sequence(sql);
     }
     /**
@@ -73,6 +80,9 @@ export class Connection {
      * @returns Promise resolving to the result of the pragma
      */
     async pragma(pragma) {
+        if (!this.isOpen) {
+            throw new TypeError("The database connection is not open");
+        }
         const sql = `PRAGMA ${pragma}`;
         return this.session.execute(sql);
     }
@@ -82,6 +92,7 @@ export class Connection {
      * This sends a close request to the server to properly clean up the stream.
      */
     async close() {
+        this.isOpen = false;
         await this.session.close();
     }
 }

package/dist/statement.js

@@ -97,11 +97,15 @@ export class Statement {
         const normalizedArgs = this.normalizeArgs(args);
         const result = await this.session.execute(this.sql, normalizedArgs);
         if (this.presentationMode === 'raw') {
-            // In raw mode, return arrays of values
-            // Each row is already an array with column properties added
             return result.rows.map((row) => [...row]);
         }
-        return result.rows;
+        return result.rows.map((row) => {
+            const obj = {};
+            result.columns.forEach((col, i) => {
+                obj[col] = row[i];
+            });
+            return obj;
+        });
     }
     /**
      * Execute the statement and return an async iterator for streaming results.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tursodatabase/serverless",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",