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

package/lib/module/Statement.js

@@ -0,0 +1,335 @@
+"use strict";
+
+/**
+ * Statement
+ *
+ * High-level wrapper around NativeStatement providing a clean API.
+ * Handles parameter binding, row conversion, and result collection.
+ */
+
+import { TursoStatus, TursoType } from './types';
+
+/**
+ * Prepared SQL statement
+ */
+export 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 === 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 !== 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 === 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 === TursoStatus.ROW) {
+      const row = this.readRow();
+      this._statement.reset();
+      return row;
+    }
+    if (status === 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 === TursoStatus.ROW) {
+        rows.push(this.readRow());
+      } else if (status === 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 TursoType.NULL:
+        return null;
+      case TursoType.INTEGER:
+        return this._statement.rowValueInt(index);
+      case TursoType.REAL:
+        return this._statement.rowValueDouble(index);
+      case TursoType.TEXT:
+        // Use rowValueText which directly returns a string from C++ (avoids encoding issues)
+        return this._statement.rowValueText(index);
+      case 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 === 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 !== 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;
+  }
+}
+//# sourceMappingURL=Statement.js.map

package/lib/module/Statement.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["TursoStatus","TursoType","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","IO","runIo","DONE","stepWithIo","step","get","ROW","row","readRow","all","rows","push","columnCount","columnName","readColumnValue","index","kind","rowValueKind","NULL","INTEGER","rowValueInt","REAL","rowValueDouble","TEXT","rowValueText","BLOB","rowValueBytesPtr","finalize","finalized"],"sourceRoot":"../../src","sources":["Statement.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,205 @@
+"use strict";
+
+/**
+ * Turso React Native SDK
+ *
+ * Main entry point for the SDK. Supports both local-only and sync databases.
+ */
+
+import { NativeModules } from 'react-native';
+import { Database } from './Database';
+import { setFileSystemImpl } from './internal/ioProcessor';
+
+// Re-export all public types
+
+// Re-export classes
+export { Database } from './Database';
+export { Statement } from './Statement';
+
+// Export file system configuration function
+export { setFileSystemImpl } from './internal/ioProcessor';
+
+// Get the native module
+const TursoNative = 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 });
+ * ```
+ */
+export 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` });
+ * ```
+ */
+export async function connect(opts) {
+  const db = new Database(opts);
+  await db.connect();
+  return db;
+}
+
+/**
+ * Returns the Turso library version.
+ */
+export 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' });
+ * ```
+ */
+export 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 });
+ * ```
+ */
+export const 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
+export default {
+  connect,
+  version,
+  setup,
+  setFileSystemImpl,
+  getDbPath,
+  paths,
+  Database
+};
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NativeModules","Database","setFileSystemImpl","Statement","TursoNative","Turso","Error","installed","install","TursoProxy","__TursoProxy","getDbPath","filename","directory","basePath","paths","connect","opts","db","version","setup","options","documents","IOS_DOCUMENT_PATH","ANDROID_DATABASE_PATH","database","files","ANDROID_FILES_PATH","library","IOS_LIBRARY_PATH"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/internal/asyncOperation.js

@@ -0,0 +1,116 @@
+"use strict";
+
+/**
+ * Async Operation Driver
+ *
+ * Drives async operations returned by sync SDK-KIT methods.
+ * This is where ALL the async logic lives - the C++ layer is just a thin bridge.
+ *
+ * Key responsibilities:
+ * - Call resume() in a loop until DONE
+ * - When IO is needed, process all pending IO items
+ * - Extract and return the final result
+ */
+
+import { TursoStatus, SyncOperationResultType } from '../types';
+import { processIoItem } from './ioProcessor';
+/**
+ * Drive an async operation to completion
+ *
+ * @param operation - The native operation to drive
+ * @param database - The native sync database (for IO queue access)
+ * @param context - IO context with auth and URL information
+ * @returns Promise that resolves when operation completes
+ */
+export async function driveOperation(operation, database, context) {
+  while (true) {
+    // Resume the operation
+    const status = operation.resume();
+
+    // Operation completed successfully
+    if (status === TursoStatus.DONE) {
+      // Extract and return the result based on result type
+      const resultKind = operation.resultKind();
+      switch (resultKind) {
+        case SyncOperationResultType.NONE:
+          return undefined;
+        case SyncOperationResultType.CONNECTION:
+          return operation.extractConnection();
+        case SyncOperationResultType.CHANGES:
+          return operation.extractChanges();
+        case SyncOperationResultType.STATS:
+          return operation.extractStats();
+        default:
+          throw new Error(`Unknown result type: ${resultKind}`);
+      }
+    }
+
+    // Operation needs IO
+    if (status === TursoStatus.IO) {
+      // Process all pending IO items
+      await processIoQueue(database, context);
+
+      // Step callbacks after IO processing
+      database.ioStepCallbacks();
+
+      // Continue resume loop
+      continue;
+    }
+
+    // Any other status is an error
+    throw new Error(`Unexpected status from operation.resume(): ${status}`);
+  }
+}
+
+/**
+ * Process all pending IO items in the queue
+ *
+ * @param database - The native sync database
+ * @param context - IO context with auth and URL information
+ */
+async function processIoQueue(database, context) {
+  const promises = [];
+
+  // Take all available IO items from the queue
+  while (true) {
+    const ioItem = database.ioTakeItem();
+    if (!ioItem) {
+      break; // No more items
+    }
+
+    // Process each item (potentially in parallel)
+    promises.push(processIoItem(ioItem, context));
+  }
+
+  // Wait for all IO operations to complete
+  await Promise.all(promises);
+}
+
+/**
+ * Helper type for operations that return connections
+ */
+export async function driveConnectionOperation(operation, database, context) {
+  return driveOperation(operation, database, context);
+}
+
+/**
+ * Helper type for operations that return changes
+ */
+export async function driveChangesOperation(operation, database, context) {
+  return driveOperation(operation, database, context);
+}
+
+/**
+ * Helper type for operations that return stats
+ */
+export async function driveStatsOperation(operation, database, context) {
+  return driveOperation(operation, database, context);
+}
+
+/**
+ * Helper type for operations that return void
+ */
+export async function driveVoidOperation(operation, database, context) {
+  return driveOperation(operation, database, context);
+}
+//# sourceMappingURL=asyncOperation.js.map

package/lib/module/internal/asyncOperation.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["TursoStatus","SyncOperationResultType","processIoItem","driveOperation","operation","database","context","status","resume","DONE","resultKind","NONE","undefined","CONNECTION","extractConnection","CHANGES","extractChanges","STATS","extractStats","Error","IO","processIoQueue","ioStepCallbacks","promises","ioItem","ioTakeItem","push","Promise","all","driveConnectionOperation","driveChangesOperation","driveStatsOperation","driveVoidOperation"],"sourceRoot":"../../../src","sources":["internal/asyncOperation.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AASA,SAASA,WAAW,EAAEC,uBAAuB,QAAQ,UAAU;AAC/D,SAASC,aAAa,QAAQ,eAAe;AAG7C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeC,cAAcA,CAClCC,SAA8B,EAC9BC,QAA4B,EAC5BC,OAAkB,EACN;EACZ,OAAO,IAAI,EAAE;IACX;IACA,MAAMC,MAAM,GAAGH,SAAS,CAACI,MAAM,CAAC,CAAC;;IAEjC;IACA,IAAID,MAAM,KAAKP,WAAW,CAACS,IAAI,EAAE;MAC/B;MACA,MAAMC,UAAU,GAAGN,SAAS,CAACM,UAAU,CAAC,CAAC;MAEzC,QAAQA,UAAU;QAChB,KAAKT,uBAAuB,CAACU,IAAI;UAC/B,OAAOC,SAAS;QAElB,KAAKX,uBAAuB,CAACY,UAAU;UACrC,OAAOT,SAAS,CAACU,iBAAiB,CAAC,CAAC;QAEtC,KAAKb,uBAAuB,CAACc,OAAO;UAClC,OAAOX,SAAS,CAACY,cAAc,CAAC,CAAC;QAEnC,KAAKf,uBAAuB,CAACgB,KAAK;UAChC,OAAOb,SAAS,CAACc,YAAY,CAAC,CAAC;QAEjC;UACE,MAAM,IAAIC,KAAK,CAAC,wBAAwBT,UAAU,EAAE,CAAC;MACzD;IACF;;IAEA;IACA,IAAIH,MAAM,KAAKP,WAAW,CAACoB,EAAE,EAAE;MAC7B;MACA,MAAMC,cAAc,CAAChB,QAAQ,EAAEC,OAAO,CAAC;;MAEvC;MACAD,QAAQ,CAACiB,eAAe,CAAC,CAAC;;MAE1B;MACA;IACF;;IAEA;IACA,MAAM,IAAIH,KAAK,CAAC,8CAA8CZ,MAAM,EAAE,CAAC;EACzE;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,eAAec,cAAcA,CAAChB,QAA4B,EAAEC,OAAkB,EAAiB;EAC7F,MAAMiB,QAAyB,GAAG,EAAE;;EAEpC;EACA,OAAO,IAAI,EAAE;IACX,MAAMC,MAAM,GAAGnB,QAAQ,CAACoB,UAAU,CAAC,CAAC;IACpC,IAAI,CAACD,MAAM,EAAE;MACX,MAAM,CAAC;IACT;;IAEA;IACAD,QAAQ,CAACG,IAAI,CAACxB,aAAa,CAACsB,MAAM,EAAElB,OAAO,CAAC,CAAC;EAC/C;;EAEA;EACA,MAAMqB,OAAO,CAACC,GAAG,CAACL,QAAQ,CAAC;AAC7B;;AAEA;AACA;AACA;AACA,OAAO,eAAeM,wBAAwBA,CAC5CzB,SAA8B,EAC9BC,QAA4B,EAC5BC,OAAkB,EACS;EAC3B,OAAOH,cAAc,CAAmBC,SAAS,EAAEC,QAAQ,EAAEC,OAAO,CAAC;AACvE;;AAEA;AACA;AACA;AACA,OAAO,eAAewB,qBAAqBA,CACzC1B,SAA8B,EAC9BC,QAA4B,EAC5BC,OAAkB,EACiB;EACnC,OAAOH,cAAc,CAA2BC,SAAS,EAAEC,QAAQ,EAAEC,OAAO,CAAC;AAC/E;;AAEA;AACA;AACA;AACA,OAAO,eAAeyB,mBAAmBA,CACvC3B,SAA8B,EAC9BC,QAA4B,EAC5BC,OAAkB,EACE;EACpB,OAAOH,cAAc,CAAYC,SAAS,EAAEC,QAAQ,EAAEC,OAAO,CAAC;AAChE;;AAEA;AACA;AACA;AACA,OAAO,eAAe0B,kBAAkBA,CACtC5B,SAA8B,EAC9BC,QAA4B,EAC5BC,OAAkB,EACH;EACf,OAAOH,cAAc,CAAOC,SAAS,EAAEC,QAAQ,EAAEC,OAAO,CAAC;AAC3D","ignoreList":[]}