@tursodatabase/sync-react-native 0.5.0-pre.4

package/lib/commonjs/Statement.js

@@ -0,0 +1,339 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Statement = void 0;
+var _types = require("./types");
+/**
+ * Statement
+ *
+ * High-level wrapper around NativeStatement providing a clean API.
+ * Handles parameter binding, row conversion, and result collection.
+ */
+
+/**
+ * Prepared SQL statement
+ */
+class Statement {
+  _finalized = false;
+  constructor(statement, extraIo) {
+    this._statement = statement;
+    this._extraIo = extraIo;
+  }
+
+  /**
+   * Bind parameters to the statement
+   *
+   * @param params - Parameters to bind (array, object, or single value)
+   * @returns this for chaining
+   */
+  bind(...params) {
+    if (this._finalized) {
+      throw new Error('Statement has been finalized');
+    }
+
+    // Flatten parameters if single array passed
+    let flatParams;
+    if (params.length === 1 && Array.isArray(params[0])) {
+      flatParams = params[0];
+    } else if (params.length === 1 && typeof params[0] === 'object' && params[0] !== null) {
+      // Named parameters
+      const namedParams = params[0];
+      this.bindNamed(namedParams);
+      return this;
+    } else {
+      flatParams = params;
+    }
+
+    // Bind positional parameters
+    this.bindPositional(flatParams);
+    return this;
+  }
+
+  /**
+   * Bind positional parameters (1-indexed)
+   *
+   * @param params - Array of values to bind
+   */
+  bindPositional(params) {
+    for (let i = 0; i < params.length; i++) {
+      const position = i + 1; // 1-indexed
+      const value = params[i];
+      this.bindValue(position, value);
+    }
+  }
+
+  /**
+   * Bind named parameters
+   *
+   * @param params - Object with named parameters
+   */
+  bindNamed(params) {
+    for (const [name, value] of Object.entries(params)) {
+      // Get position for named parameter
+      const position = this._statement.namedPosition(name);
+      if (position < 0) {
+        throw new Error(`Unknown parameter name: ${name}`);
+      }
+      this.bindValue(position, value);
+    }
+  }
+
+  /**
+   * Bind a single value at a position
+   *
+   * @param position - 1-indexed position
+   * @param value - Value to bind
+   */
+  bindValue(position, value) {
+    if (value === null || value === undefined) {
+      this._statement.bindPositionalNull(position);
+    } else if (typeof value === 'number') {
+      // Check if integer or float
+      if (Number.isInteger(value)) {
+        this._statement.bindPositionalInt(position, value);
+      } else {
+        this._statement.bindPositionalDouble(position, value);
+      }
+    } else if (typeof value === 'string') {
+      this._statement.bindPositionalText(position, value);
+    } else if (value instanceof ArrayBuffer || ArrayBuffer.isView(value)) {
+      const buffer = value;
+      this._statement.bindPositionalBlob(position, buffer);
+    } else {
+      throw new Error(`Unsupported parameter type: ${typeof value}`);
+    }
+  }
+
+  /**
+   * Execute statement without returning rows (for INSERT, UPDATE, DELETE)
+   *
+   * @param params - Optional parameters to bind
+   * @returns Result with changes and lastInsertRowid
+   */
+  async run(...params) {
+    if (this._finalized) {
+      throw new Error('Statement has been finalized');
+    }
+
+    // Bind parameters if provided
+    if (params.length > 0) {
+      this.bind(...params);
+    }
+
+    // Execute statement with IO handling
+    const result = await this.executeWithIo();
+
+    // Reset for next execution
+    this._statement.reset();
+    return {
+      changes: result.rowsChanged,
+      lastInsertRowid: 0 // Not available from execute, would need connection
+    };
+  }
+
+  /**
+   * Execute statement handling potential IO (for partial sync)
+   * Matches Python's _run_execute_with_io pattern
+   *
+   * @returns Execution result
+   */
+  async executeWithIo() {
+    while (true) {
+      const result = this._statement.execute();
+      if (result.status === _types.TursoStatus.IO) {
+        // Statement needs IO (e.g., loading missing pages with partial sync)
+        this._statement.runIo();
+
+        // Drain sync engine IO queue
+        if (this._extraIo) {
+          await this._extraIo();
+        }
+        continue;
+      }
+      if (result.status !== _types.TursoStatus.DONE) {
+        throw new Error(`Statement execution failed with status: ${result.status}`);
+      }
+      return result;
+    }
+  }
+
+  /**
+   * Step statement once handling potential IO (for partial sync)
+   * Matches Python's _step_once_with_io pattern
+   *
+   * @returns Status code
+   */
+  async stepWithIo() {
+    while (true) {
+      const status = this._statement.step();
+      if (status === _types.TursoStatus.IO) {
+        // Statement needs IO (e.g., loading missing pages with partial sync)
+        this._statement.runIo();
+
+        // Drain sync engine IO queue
+        if (this._extraIo) {
+          await this._extraIo();
+        }
+        continue;
+      }
+      return status;
+    }
+  }
+
+  /**
+   * Execute statement and return first row
+   *
+   * @param params - Optional parameters to bind
+   * @returns First row or undefined
+   */
+  async get(...params) {
+    if (this._finalized) {
+      throw new Error('Statement has been finalized');
+    }
+
+    // Bind parameters if provided
+    if (params.length > 0) {
+      this.bind(...params);
+    }
+
+    // Step once with async IO handling
+    const status = await this.stepWithIo();
+    if (status === _types.TursoStatus.ROW) {
+      const row = this.readRow();
+      this._statement.reset();
+      return row;
+    }
+    if (status === _types.TursoStatus.DONE) {
+      this._statement.reset();
+      return undefined;
+    }
+    throw new Error(`Statement step failed with status: ${status}`);
+  }
+
+  /**
+   * Execute statement and return all rows
+   *
+   * @param params - Optional parameters to bind
+   * @returns Array of rows
+   */
+  async all(...params) {
+    if (this._finalized) {
+      throw new Error('Statement has been finalized');
+    }
+
+    // Bind parameters if provided
+    if (params.length > 0) {
+      this.bind(...params);
+    }
+    const rows = [];
+
+    // Step through all rows with async IO handling
+    while (true) {
+      const status = await this.stepWithIo();
+      if (status === _types.TursoStatus.ROW) {
+        rows.push(this.readRow());
+      } else if (status === _types.TursoStatus.DONE) {
+        break;
+      } else {
+        throw new Error(`Statement step failed with status: ${status}`);
+      }
+    }
+    this._statement.reset();
+    return rows;
+  }
+
+  /**
+   * Read current row into an object
+   *
+   * @returns Row object with column name keys
+   */
+  readRow() {
+    const row = {};
+    const columnCount = this._statement.columnCount();
+    for (let i = 0; i < columnCount; i++) {
+      const name = this._statement.columnName(i);
+      if (!name) {
+        throw new Error(`Failed to get column name at index ${i}`);
+      }
+      const value = this.readColumnValue(i);
+      row[name] = value;
+    }
+    return row;
+  }
+
+  /**
+   * Read value at column index
+   *
+   * @param index - Column index
+   * @returns Column value
+   */
+  readColumnValue(index) {
+    const kind = this._statement.rowValueKind(index);
+    switch (kind) {
+      case _types.TursoType.NULL:
+        return null;
+      case _types.TursoType.INTEGER:
+        return this._statement.rowValueInt(index);
+      case _types.TursoType.REAL:
+        return this._statement.rowValueDouble(index);
+      case _types.TursoType.TEXT:
+        // Use rowValueText which directly returns a string from C++ (avoids encoding issues)
+        return this._statement.rowValueText(index);
+      case _types.TursoType.BLOB:
+        return this._statement.rowValueBytesPtr(index) || new ArrayBuffer(0);
+      default:
+        throw new Error(`Unknown column type: ${kind}`);
+    }
+  }
+
+  /**
+   * Reset statement for re-execution
+   *
+   * @returns this for chaining
+   */
+  reset() {
+    if (this._finalized) {
+      throw new Error('Statement has been finalized');
+    }
+    this._statement.reset();
+    return this;
+  }
+
+  /**
+   * Finalize and release statement resources
+   */
+  async finalize() {
+    if (this._finalized) {
+      return;
+    }
+    while (true) {
+      const status = this._statement.finalize();
+      if (status === _types.TursoStatus.IO) {
+        // Statement needs IO (e.g., loading missing pages with partial sync)
+        this._statement.runIo();
+
+        // Drain sync engine IO queue
+        if (this._extraIo) {
+          await this._extraIo();
+        }
+        continue;
+      }
+      if (status !== _types.TursoStatus.DONE) {
+        throw new Error(`Statement finalization failed with status: ${status}`);
+      }
+      break;
+    }
+    this._finalized = true;
+  }
+
+  /**
+   * Check if statement has been finalized
+   */
+  get finalized() {
+    return this._finalized;
+  }
+}
+exports.Statement = Statement;
+//# sourceMappingURL=Statement.js.map

package/lib/commonjs/Statement.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_types","require","Statement","_finalized","constructor","statement","extraIo","_statement","_extraIo","bind","params","Error","flatParams","length","Array","isArray","namedParams","bindNamed","bindPositional","i","position","value","bindValue","name","Object","entries","namedPosition","undefined","bindPositionalNull","Number","isInteger","bindPositionalInt","bindPositionalDouble","bindPositionalText","ArrayBuffer","isView","buffer","bindPositionalBlob","run","result","executeWithIo","reset","changes","rowsChanged","lastInsertRowid","execute","status","TursoStatus","IO","runIo","DONE","stepWithIo","step","get","ROW","row","readRow","all","rows","push","columnCount","columnName","readColumnValue","index","kind","rowValueKind","TursoType","NULL","INTEGER","rowValueInt","REAL","rowValueDouble","TEXT","rowValueText","BLOB","rowValueBytesPtr","finalize","finalized","exports"],"sourceRoot":"../../src","sources":["Statement.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/index.js

@@ -0,0 +1,229 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "Database", {
+  enumerable: true,
+  get: function () {
+    return _Database.Database;
+  }
+});
+Object.defineProperty(exports, "Statement", {
+  enumerable: true,
+  get: function () {
+    return _Statement.Statement;
+  }
+});
+exports.connect = connect;
+exports.default = void 0;
+exports.getDbPath = getDbPath;
+exports.paths = void 0;
+Object.defineProperty(exports, "setFileSystemImpl", {
+  enumerable: true,
+  get: function () {
+    return _ioProcessor.setFileSystemImpl;
+  }
+});
+exports.setup = setup;
+exports.version = version;
+var _reactNative = require("react-native");
+var _Database = require("./Database");
+var _ioProcessor = require("./internal/ioProcessor");
+var _Statement = require("./Statement");
+/**
+ * Turso React Native SDK
+ *
+ * Main entry point for the SDK. Supports both local-only and sync databases.
+ */
+
+// Re-export all public types
+
+// Re-export classes
+
+// Export file system configuration function
+
+// Get the native module
+const TursoNative = _reactNative.NativeModules.Turso;
+
+// Check if native module is available
+if (!TursoNative) {
+  throw new Error(`@tursodatabase/sync-react-native: Native module not found. Make sure you have properly linked the library.\n` + `- iOS: Run 'pod install' in your ios directory\n` + `- Android: Make sure the package is properly included in your MainApplication.java`);
+}
+
+// Install the JSI bindings
+const installed = TursoNative.install();
+if (!installed) {
+  throw new Error('@tursodatabase/sync-react-native: Failed to install JSI bindings. Make sure the New Architecture is enabled.');
+}
+
+// Get the proxy that was installed on the global object
+// __TursoProxy is declared globally in types.ts
+const TursoProxy = __TursoProxy;
+if (!TursoProxy) {
+  throw new Error('@tursodatabase/sync-react-native: JSI bindings not found on global object. This is a bug.');
+}
+
+/**
+ * Helper function to construct a database path in a writable directory.
+ * On mobile platforms, you must use writable directories (not relative paths).
+ *
+ * @param filename - Database filename (e.g., 'mydb.db')
+ * @param directory - Directory to use ('documents', 'database', or 'library')
+ * @returns Absolute path to the database file
+ *
+ * @example
+ * ```ts
+ * import { getDbPath, connect } from '@tursodatabase/sync-react-native';
+ *
+ * const dbPath = getDbPath('mydb.db');
+ * const db = await connect({ path: dbPath });
+ * ```
+ */
+function getDbPath(filename, directory = 'documents') {
+  const basePath = paths[directory];
+  if (!basePath || basePath === '.') {
+    throw new Error(`Unable to get ${directory} path for this platform. ` + 'Make sure the native module is properly loaded.');
+  }
+  return `${basePath}/${filename}`;
+}
+
+/**
+ * Connect to a database asynchronously (matches JavaScript bindings API)
+ *
+ * This is the main entry point for the SDK, matching the API from
+ * @tursodatabase/sync-native and @tursodatabase/database-native.
+ *
+ * **Path handling**: Relative paths are automatically placed in writable directories:
+ * - Android: app's database directory (`/data/data/com.app/databases/`)
+ * - iOS: app's documents directory
+ *
+ * Absolute paths and `:memory:` are used as-is.
+ *
+ * @param opts - Database options
+ * @returns Promise resolving to Database instance
+ *
+ * @example Local database (relative path)
+ * ```ts
+ * import { connect } from '@tursodatabase/sync-react-native';
+ *
+ * // Relative path automatically placed in writable directory
+ * const db = await connect({ path: 'local.db' });
+ * await db.exec('CREATE TABLE users (id INTEGER, name TEXT)');
+ * ```
+ *
+ * @example Using :memory: for in-memory database
+ * ```ts
+ * const db = await connect({ path: ':memory:' });
+ * ```
+ *
+ * @example Sync database
+ * ```ts
+ * const db = await connect({
+ *   path: 'replica.db',
+ *   url: 'libsql://mydb.turso.io',
+ *   authToken: 'token-here',
+ * });
+ * const users = await db.all('SELECT * FROM users');
+ * await db.push();
+ * await db.pull();
+ * ```
+ *
+ * @example Using absolute path (advanced)
+ * ```ts
+ * import { connect, paths } from '@tursodatabase/sync-react-native';
+ *
+ * const db = await connect({ path: `${paths.documents}/mydb.db` });
+ * ```
+ */
+async function connect(opts) {
+  const db = new _Database.Database(opts);
+  await db.connect();
+  return db;
+}
+
+/**
+ * Returns the Turso library version.
+ */
+function version() {
+  return TursoProxy.version();
+}
+
+/**
+ * Configure Turso settings such as logging.
+ * Should be called before any database operations.
+ *
+ * @param options - Configuration options
+ * @example
+ * ```ts
+ * import { setup } from '@tursodatabase/sync-react-native';
+ *
+ * setup({ logLevel: 'debug' });
+ * ```
+ */
+function setup(options) {
+  TursoProxy.setup(options);
+}
+
+/**
+ * Platform-specific writable directory paths.
+ * Use these to construct absolute paths for database files.
+ *
+ * NOTE: With automatic path normalization, you typically don't need this.
+ * Just pass relative paths like 'mydb.db' and they'll be placed in the correct directory.
+ *
+ * @example
+ * ```ts
+ * import { paths, connect } from '@tursodatabase/sync-react-native';
+ *
+ * // Create database in app's documents/files directory
+ * const dbPath = `${paths.documents}/mydb.db`;
+ * const db = await connect({ path: dbPath });
+ * ```
+ */
+const paths = exports.paths = {
+  /**
+   * Primary documents/database directory (writable)
+   * - iOS: App's Documents directory (absolute path)
+   * - Android: App's database directory (absolute path) - preferred for databases
+   */
+  get documents() {
+    return TursoNative?.IOS_DOCUMENT_PATH || TursoNative?.ANDROID_DATABASE_PATH || '.';
+  },
+  /**
+   * Database-specific directory (writable)
+   * - iOS: Same as documents
+   * - Android: Database directory (absolute path)
+   */
+  get database() {
+    return TursoNative?.IOS_DOCUMENT_PATH || TursoNative?.ANDROID_DATABASE_PATH || '.';
+  },
+  /**
+   * Files directory (writable)
+   * - iOS: Same as documents
+   * - Android: App's files directory (absolute path)
+   */
+  get files() {
+    return TursoNative?.IOS_DOCUMENT_PATH || TursoNative?.ANDROID_FILES_PATH || '.';
+  },
+  /**
+   * Library directory (iOS only, writable)
+   * - iOS: App's Library directory (absolute path)
+   * - Android: Same as files
+   */
+  get library() {
+    return TursoNative?.IOS_LIBRARY_PATH || TursoNative?.ANDROID_FILES_PATH || '.';
+  }
+};
+
+// Default export
+var _default = exports.default = {
+  connect,
+  version,
+  setup,
+  setFileSystemImpl: _ioProcessor.setFileSystemImpl,
+  getDbPath,
+  paths,
+  Database: _Database.Database
+};
+//# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","_Database","_ioProcessor","_Statement","TursoNative","NativeModules","Turso","Error","installed","install","TursoProxy","__TursoProxy","getDbPath","filename","directory","basePath","paths","connect","opts","db","Database","version","setup","options","exports","documents","IOS_DOCUMENT_PATH","ANDROID_DATABASE_PATH","database","files","ANDROID_FILES_PATH","library","IOS_LIBRARY_PATH","_default","default","setFileSystemImpl"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,IAAAA,YAAA,GAAAC,OAAA;AACA,IAAAC,SAAA,GAAAD,OAAA;AAMA,IAAAE,YAAA,GAAAF,OAAA;AAwBA,IAAAG,UAAA,GAAAH,OAAA;AArCA;AACA;AACA;AACA;AACA;;AAWA;;AAoBA;;AAIA;;AAGA;AACA,MAAMI,WAA0C,GAAGC,0BAAa,CAACC,KAAK;;AAEtE;AACA,IAAI,CAACF,WAAW,EAAE;EAChB,MAAM,IAAIG,KAAK,CACb,8GAA8G,GAC9G,kDAAkD,GAClD,oFACF,CAAC;AACH;;AAEA;AACA,MAAMC,SAAS,GAAGJ,WAAW,CAACK,OAAO,CAAC,CAAC;AACvC,IAAI,CAACD,SAAS,EAAE;EACd,MAAM,IAAID,KAAK,CACb,8GACF,CAAC;AACH;;AAEA;AACA;AACA,MAAMG,UAA0B,GAAGC,YAAY;AAE/C,IAAI,CAACD,UAAU,EAAE;EACf,MAAM,IAAIH,KAAK,CACb,2FACF,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASK,SAASA,CAACC,QAAgB,EAAEC,SAA+C,GAAG,WAAW,EAAU;EACjH,MAAMC,QAAQ,GAAGC,KAAK,CAACF,SAAS,CAAC;EACjC,IAAI,CAACC,QAAQ,IAAIA,QAAQ,KAAK,GAAG,EAAE;IACjC,MAAM,IAAIR,KAAK,CACb,iBAAiBO,SAAS,2BAA2B,GACrD,iDACF,CAAC;EACH;EACA,OAAO,GAAGC,QAAQ,IAAIF,QAAQ,EAAE;AAClC;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,eAAeI,OAAOA,CAACC,IAAkB,EAAqB;EACnE,MAAMC,EAAE,GAAG,IAAIC,kBAAQ,CAACF,IAAI,CAAC;EAC7B,MAAMC,EAAE,CAACF,OAAO,CAAC,CAAC;EAClB,OAAOE,EAAE;AACX;;AAEA;AACA;AACA;AACO,SAASE,OAAOA,CAAA,EAAW;EAChC,OAAOX,UAAU,CAACW,OAAO,CAAC,CAAC;AAC7B;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,KAAKA,CAACC,OAA4B,EAAQ;EACxDb,UAAU,CAACY,KAAK,CAACC,OAAO,CAAC;AAC3B;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMP,KAAK,GAAAQ,OAAA,CAAAR,KAAA,GAAG;EACnB;AACF;AACA;AACA;AACA;EACE,IAAIS,SAASA,CAAA,EAAW;IACtB,OAAOrB,WAAW,EAAEsB,iBAAiB,IAAItB,WAAW,EAAEuB,qBAAqB,IAAI,GAAG;EACpF,CAAC;EAED;AACF;AACA;AACA;AACA;EACE,IAAIC,QAAQA,CAAA,EAAW;IACrB,OAAOxB,WAAW,EAAEsB,iBAAiB,IAAItB,WAAW,EAAEuB,qBAAqB,IAAI,GAAG;EACpF,CAAC;EAED;AACF;AACA;AACA;AACA;EACE,IAAIE,KAAKA,CAAA,EAAW;IAClB,OAAOzB,WAAW,EAAEsB,iBAAiB,IAAItB,WAAW,EAAE0B,kBAAkB,IAAI,GAAG;EACjF,CAAC;EAED;AACF;AACA;AACA;AACA;EACE,IAAIC,OAAOA,CAAA,EAAW;IACpB,OAAO3B,WAAW,EAAE4B,gBAAgB,IAAI5B,WAAW,EAAE0B,kBAAkB,IAAI,GAAG;EAChF;AACF,CAAC;;AAED;AAAA,IAAAG,QAAA,GAAAT,OAAA,CAAAU,OAAA,GACe;EACbjB,OAAO;EACPI,OAAO;EACPC,KAAK;EACLa,iBAAiB,EAAjBA,8BAAiB;EACjBvB,SAAS;EACTI,KAAK;EACLI,QAAQ,EAARA;AACF,CAAC","ignoreList":[]}