@tursodatabase/database-common 0.2.0-pre.9 → 0.2.0

package/README.md

@@ -2,7 +2,7 @@
 
 This package is the Turso embedded database common JS library which is shared between final builds for Node and Browser.
 
-Do not use this package directly - instead you must use `@tursodatabase/database` or `@tursodatabase/database-browser`.
+Do not use this package directly - instead you must use `@tursodatabase/database` or `@tursodatabase/database-wasm`.
 
-> **⚠️ Warning:** This software is ALPHA, only use for development, testing, and experimentation. We are working to make it production ready, but do not use it for critical data right now.
+> **⚠️ Warning:** This software is in BETA. It may still contain bugs and unexpected behavior. Use caution with production data and ensure you have backups.
 

package/dist/promise.d.ts

@@ -12,6 +12,7 @@ declare class Database {
     private db;
     private execLock;
     private _inTransaction;
+    protected connected: boolean;
     constructor(db: NativeDatabase);
     /**
      * connect database
@@ -59,6 +60,13 @@ declare class Database {
      */
     close(): Promise<void>;
 }
+interface MaybeLazy<T> {
+    apply(fn: (value: T) => void): any;
+    resolve(): Promise<T>;
+    must(): T;
+}
+declare function maybePromise<T>(arg: () => Promise<T>): MaybeLazy<T>;
+declare function maybeValue<T>(value: T): MaybeLazy<T>;
 /**
  * Statement represents a prepared SQL statement that can be executed.
  */
@@ -66,7 +74,7 @@ declare class Statement {
     private stmt;
     private db;
     private execLock;
-    constructor(stmt: NativeStatement, db: NativeDatabase, execLock: AsyncLock);
+    constructor(stmt: MaybeLazy<NativeStatement>, db: NativeDatabase, execLock: AsyncLock);
     /**
      * Toggle raw mode.
      *
@@ -132,5 +140,5 @@ declare class Statement {
     bind(...bindParameters: any[]): this;
     close(): void;
 }
-export { Database, Statement };
+export { Database, Statement, maybePromise, maybeValue };
 //# sourceMappingURL=promise.d.ts.map

package/dist/promise.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"promise.d.ts","sourceRoot":"","sources":["../promise.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,cAAc,EAAE,eAAe,EAA8C,MAAM,YAAY,CAAC;AAyBzG;;GAEG;AACH,cAAM,QAAQ;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IAEvB,OAAO,CAAC,EAAE,CAAiB;IAC3B,OAAO,CAAC,QAAQ,CAAY;IAC5B,OAAO,CAAC,cAAc,CAAkB;gBAE5B,EAAE,EAAE,cAAc;IAY9B;;OAEG;IACG,OAAO;IAIb;;;;OAIG;IACH,OAAO,CAAC,GAAG,KAAA;IAYX;;;;OAIG;IACH,WAAW,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,OAAA,KAAK,OAAO,CAAC,GAAG,CAAC;IAmClC,MAAM,CAAC,MAAM,KAAA,EAAE,OAAO,KAAA;IAoB5B,MAAM,CAAC,QAAQ,KAAA,EAAE,OAAO,KAAA;IAIxB,SAAS,CAAC,OAAO,KAAA;IAIjB,QAAQ,CAAC,IAAI,KAAA,EAAE,OAAO,KAAA,EAAE,EAAE,KAAA;IAI1B,SAAS,CAAC,IAAI,KAAA,EAAE,OAAO,KAAA;IAIvB,KAAK,CAAC,IAAI,KAAA,EAAE,OAAO,KAAA;IAInB,aAAa,CAAC,IAAI,KAAA;IAIlB,wBAAwB;IAIxB;;;;;OAKG;IACG,IAAI,CAAC,GAAG,KAAA;IAwBd;;OAEG;IACH,SAAS;IAIT;;;;OAIG;IACH,mBAAmB,CAAC,MAAM,KAAA;IAI1B;;OAEG;IACG,KAAK;CAGZ;AAED;;GAEG;AACH,cAAM,SAAS;IACb,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,EAAE,CAAiB;IAC3B,OAAO,CAAC,QAAQ,CAAY;gBAEhB,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS;IAM1E;;;;OAIG;IACH,GAAG,CAAC,GAAG,KAAA;IAKP;;;;OAIG;IACH,KAAK,CAAC,SAAS,KAAA;IAKf;;;;OAIG;IACH,YAAY,CAAC,MAAM,KAAA;IAKnB;;;;OAIG;IACH,OAAO;IAIP,IAAI,MAAM,SAET;IAED,IAAI,MAAM,SAET;IAED,IAAI,QAAQ,mBAEX;IAED;;OAEG;IACG,GAAG,CAAC,GAAG,cAAc,OAAA;;;;IAgC3B;;;;OAIG;IACG,GAAG,CAAC,GAAG,cAAc,OAAA;IAwB3B;;;;OAIG;IACI,OAAO,CAAC,GAAG,cAAc,OAAA;IAwBhC;;;;OAIG;IACG,GAAG,CAAC,GAAG,cAAc,OAAA;IA2B3B;;OAEG;IACH,SAAS;IAKT;;;;;OAKG;IACH,IAAI,CAAC,GAAG,cAAc,OAAA;IAStB,KAAK;CAGN;AAED,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAA"}
+{"version":3,"file":"promise.d.ts","sourceRoot":"","sources":["../promise.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,cAAc,EAAE,eAAe,EAA8C,MAAM,YAAY,CAAC;AAyBzG;;GAEG;AACH,cAAM,QAAQ;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IAEvB,OAAO,CAAC,EAAE,CAAiB;IAC3B,OAAO,CAAC,QAAQ,CAAY;IAC5B,OAAO,CAAC,cAAc,CAAkB;IACxC,SAAS,CAAC,SAAS,EAAE,OAAO,CAAS;gBAEzB,EAAE,EAAE,cAAc;IAY9B;;OAEG;IACG,OAAO;IAMb;;;;OAIG;IACH,OAAO,CAAC,GAAG,KAAA;IAgBX;;;;OAIG;IACH,WAAW,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,OAAA,KAAK,OAAO,CAAC,GAAG,CAAC;IAmClC,MAAM,CAAC,MAAM,KAAA,EAAE,OAAO,KAAA;IAoB5B,MAAM,CAAC,QAAQ,KAAA,EAAE,OAAO,KAAA;IAIxB,SAAS,CAAC,OAAO,KAAA;IAIjB,QAAQ,CAAC,IAAI,KAAA,EAAE,OAAO,KAAA,EAAE,EAAE,KAAA;IAI1B,SAAS,CAAC,IAAI,KAAA,EAAE,OAAO,KAAA;IAIvB,KAAK,CAAC,IAAI,KAAA,EAAE,OAAO,KAAA;IAInB,aAAa,CAAC,IAAI,KAAA;IAIlB,wBAAwB;IAIxB;;;;;OAKG;IACG,IAAI,CAAC,GAAG,KAAA;IAwBd;;OAEG;IACH,SAAS;IAIT;;;;OAIG;IACH,mBAAmB,CAAC,MAAM,KAAA;IAI1B;;OAEG;IACG,KAAK;CAGZ;AAED,UAAU,SAAS,CAAC,CAAC;IACnB,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,OAAE;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,IAAI,CAAC,CAAC;CACX;AAED,iBAAS,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAgC5D;AAED,iBAAS,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAM7C;AAED;;GAEG;AACH,cAAM,SAAS;IACb,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,EAAE,CAAiB;IAC3B,OAAO,CAAC,QAAQ,CAAY;gBAEhB,IAAI,EAAE,SAAS,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS;IAMrF;;;;OAIG;IACH,GAAG,CAAC,GAAG,KAAA;IAKP;;;;OAIG;IACH,KAAK,CAAC,SAAS,KAAA;IAKf;;;;OAIG;IACH,YAAY,CAAC,MAAM,KAAA;IAKnB;;;;OAIG;IACH,OAAO;IAIP,IAAI,MAAM,SAET;IAED,IAAI,MAAM,SAET;IAED,IAAI,QAAQ,mBAEX;IAED;;OAEG;IACG,GAAG,CAAC,GAAG,cAAc,OAAA;;;;IAiC3B;;;;OAIG;IACG,GAAG,CAAC,GAAG,cAAc,OAAA;IA0B3B;;;;OAIG;IACI,OAAO,CAAC,GAAG,cAAc,OAAA;IA0BhC;;;;OAIG;IACG,GAAG,CAAC,GAAG,cAAc,OAAA;IA6B3B;;OAEG;IACH,SAAS;IAKT;;;;;OAKG;IACH,IAAI,CAAC,GAAG,cAAc,OAAA;IAStB,KAAK;CAUN;AAED,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,CAAA"}

package/dist/promise.js

@@ -29,6 +29,7 @@ class Database {
     db;
     execLock;
     _inTransaction = false;
+    connected = false;
     constructor(db) {
         this.db = db;
         this.execLock = new AsyncLock();
@@ -44,7 +45,11 @@ class Database {
      * connect database
      */
     async connect() {
+        if (this.connected) {
+            return;
+        }
         await this.db.connectAsync();
+        this.connected = true;
     }
     /**
      * Prepares a SQL statement for execution.
@@ -56,7 +61,12 @@ class Database {
             throw new RangeError("The supplied SQL string contains no statements");
         }
         try {
-            return new Statement(this.db.prepare(sql), this.db, this.execLock);
+            if (this.connected) {
+                return new Statement(maybeValue(this.db.prepare(sql)), this.db, this.execLock);
+            }
+            else {
+                return new Statement(maybePromise(() => this.connect().then(() => this.db.prepare(sql))), this.db, this.execLock);
+            }
         }
         catch (err) {
             throw convertError(err);
@@ -190,6 +200,46 @@ class Database {
         this.db.close();
     }
 }
+function maybePromise(arg) {
+    let lazy = arg;
+    let promise = null;
+    let value = null;
+    return {
+        apply(fn) {
+            let previous = lazy;
+            lazy = async () => {
+                const result = await previous();
+                fn(result);
+                return result;
+            };
+        },
+        async resolve() {
+            if (promise != null) {
+                return await promise;
+            }
+            let valueResolve, valueReject;
+            promise = new Promise((resolve, reject) => {
+                valueResolve = x => { resolve(x); value = x; };
+                valueReject = reject;
+            });
+            await lazy().then(valueResolve, valueReject);
+            return await promise;
+        },
+        must() {
+            if (value == null) {
+                throw new Error(`database must be connected before execution the function`);
+            }
+            return value;
+        },
+    };
+}
+function maybeValue(value) {
+    return {
+        apply(fn) { fn(value); },
+        resolve() { return Promise.resolve(value); },
+        must() { return value; },
+    };
+}
 /**
  * Statement represents a prepared SQL statement that can be executed.
  */
@@ -208,7 +258,7 @@ class Statement {
      * @param raw Enable or disable raw mode. If you don't pass the parameter, raw mode is enabled.
      */
     raw(raw) {
-        this.stmt.raw(raw);
+        this.stmt.apply(s => s.raw(raw));
         return this;
     }
     /**
@@ -217,7 +267,7 @@ class Statement {
      * @param pluckMode Enable or disable pluck mode. If you don't pass the parameter, pluck mode is enabled.
      */
     pluck(pluckMode) {
-        this.stmt.pluck(pluckMode);
+        this.stmt.apply(s => s.pluck(pluckMode));
         return this;
     }
     /**
@@ -226,7 +276,7 @@ class Statement {
      * @param {boolean} [toggle] - Whether to use safe integers.
      */
     safeIntegers(toggle) {
-        this.stmt.safeIntegers(toggle);
+        this.stmt.apply(s => s.safeIntegers(toggle));
         return this;
     }
     /**
@@ -235,7 +285,7 @@ class Statement {
      * @returns {Array} An array of column objects with name, column, table, database, and type properties.
      */
     columns() {
-        return this.stmt.columns();
+        return this.stmt.must().columns();
     }
     get source() {
         throw new Error("not implemented");
@@ -250,13 +300,14 @@ class Statement {
      * Executes the SQL statement and returns an info object.
      */
     async run(...bindParameters) {
+        let stmt = await this.stmt.resolve();
+        stmt.reset();
+        bindParams(stmt, bindParameters);
         const totalChangesBefore = this.db.totalChanges();
-        this.stmt.reset();
-        bindParams(this.stmt, bindParameters);
         await this.execLock.acquire();
         try {
             while (true) {
-                const stepResult = await this.stmt.stepSync();
+                const stepResult = await stmt.stepSync();
                 if (stepResult === STEP_IO) {
                     await this.db.ioLoopAsync();
                     continue;
@@ -283,12 +334,13 @@ class Statement {
      * @param bindParameters - The bind parameters for executing the statement.
      */
     async get(...bindParameters) {
-        this.stmt.reset();
-        bindParams(this.stmt, bindParameters);
+        let stmt = await this.stmt.resolve();
+        stmt.reset();
+        bindParams(stmt, bindParameters);
         await this.execLock.acquire();
         try {
             while (true) {
-                const stepResult = await this.stmt.stepSync();
+                const stepResult = await stmt.stepSync();
                 if (stepResult === STEP_IO) {
                     await this.db.ioLoopAsync();
                     continue;
@@ -297,7 +349,7 @@ class Statement {
                     return undefined;
                 }
                 if (stepResult === STEP_ROW) {
-                    return this.stmt.row();
+                    return stmt.row();
                 }
             }
         }
@@ -311,12 +363,13 @@ class Statement {
      * @param bindParameters - The bind parameters for executing the statement.
      */
     async *iterate(...bindParameters) {
-        this.stmt.reset();
-        bindParams(this.stmt, bindParameters);
+        let stmt = await this.stmt.resolve();
+        stmt.reset();
+        bindParams(stmt, bindParameters);
         await this.execLock.acquire();
         try {
             while (true) {
-                const stepResult = await this.stmt.stepSync();
+                const stepResult = await stmt.stepSync();
                 if (stepResult === STEP_IO) {
                     await this.db.ioLoopAsync();
                     continue;
@@ -325,7 +378,7 @@ class Statement {
                     break;
                 }
                 if (stepResult === STEP_ROW) {
-                    yield this.stmt.row();
+                    yield stmt.row();
                 }
             }
         }
@@ -339,13 +392,14 @@ class Statement {
      * @param bindParameters - The bind parameters for executing the statement.
      */
     async all(...bindParameters) {
-        this.stmt.reset();
-        bindParams(this.stmt, bindParameters);
+        let stmt = await this.stmt.resolve();
+        stmt.reset();
+        bindParams(stmt, bindParameters);
         const rows = [];
         await this.execLock.acquire();
         try {
             while (true) {
-                const stepResult = await this.stmt.stepSync();
+                const stepResult = await stmt.stepSync();
                 if (stepResult === STEP_IO) {
                     await this.db.ioLoopAsync();
                     continue;
@@ -354,7 +408,7 @@ class Statement {
                     break;
                 }
                 if (stepResult === STEP_ROW) {
-                    rows.push(this.stmt.row());
+                    rows.push(stmt.row());
                 }
             }
             return rows;
@@ -385,7 +439,15 @@ class Statement {
         }
     }
     close() {
-        this.stmt.finalize();
+        let stmt;
+        try {
+            stmt = this.stmt.must();
+        }
+        catch (e) {
+            // ignore error - if stmt wasn't initialized it's fine
+            return;
+        }
+        stmt.finalize();
     }
 }
-export { Database, Statement };
+export { Database, Statement, maybePromise, maybeValue };

package/dist/promise.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=promise.test.d.ts.map

package/dist/promise.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise.test.d.ts","sourceRoot":"","sources":["../promise.test.ts"],"names":[],"mappings":""}

package/dist/promise.test.js

@@ -0,0 +1,14 @@
+import { expect, test } from 'vitest';
+import { maybePromise } from './promise.js';
+test('drizzle-orm', async () => {
+    const lazy = maybePromise(() => fetch('http://google.com'));
+    let status, headers;
+    //@ts-ignore
+    lazy.apply(x => { status = x.status; });
+    //@ts-ignore
+    lazy.apply(x => { headers = x.headers; });
+    let response = await lazy.resolve();
+    expect(response).not.toBeNull();
+    expect(status).toBe(200);
+    expect(headers).not.toBeNull();
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tursodatabase/database-common",
-  "version": "0.2.0-pre.9",
+  "version": "0.2.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/tursodatabase/turso"
@@ -15,11 +15,12 @@
     "README.md"
   ],
   "devDependencies": {
-    "typescript": "^5.9.2"
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
   },
   "scripts": {
     "tsc-build": "npm exec tsc",
     "build": "npm run tsc-build",
-    "test": "echo 'no tests'"
+    "test": "vitest --run"
   }
 }