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

package/lib/module/internal/ioProcessor.js

@@ -0,0 +1,309 @@
+"use strict";
+
+/**
+ * IO Processor
+ *
+ * Processes IO requests from the sync engine using JavaScript APIs.
+ * This is the key benefit of the thin JSI layer - all IO is handled by
+ * React Native's standard APIs (fetch, file system), not C++ code.
+ *
+ * Benefits:
+ * - Network requests visible in React Native debugger
+ * - Can customize fetch (add proxies, custom headers, etc.)
+ * - Easier to test (can mock fetch)
+ * - Uses platform-native networking (not C++ HTTP libraries)
+ */
+
+/**
+ * IO context contains auth and URL information for HTTP requests
+ */
+
+// Allow users to optionally override file system implementation
+let fsReadFileOverride = null;
+let fsWriteFileOverride = null;
+
+/**
+ * Set custom file system implementation (optional)
+ * By default, uses built-in JSI file system functions.
+ * Only call this if you need custom behavior (e.g., encryption, compression).
+ *
+ * @param readFile - Function to read file as Uint8Array
+ * @param writeFile - Function to write Uint8Array to file
+ */
+export function setFileSystemImpl(readFile, writeFile) {
+  fsReadFileOverride = readFile;
+  fsWriteFileOverride = writeFile;
+}
+
+/**
+ * Read file using custom implementation or built-in JSI function
+ */
+async function fsReadFile(path) {
+  if (fsReadFileOverride) {
+    return fsReadFileOverride(path);
+  }
+
+  // Use built-in JSI function
+  const buffer = __TursoProxy.fsReadFile(path);
+  if (buffer === null) {
+    // File not found - return empty
+    return new Uint8Array(0);
+  }
+  return new Uint8Array(buffer);
+}
+
+/**
+ * Write file using custom implementation or built-in JSI function
+ */
+async function fsWriteFile(path, data) {
+  if (fsWriteFileOverride) {
+    return fsWriteFileOverride(path, data);
+  }
+
+  // Use built-in JSI function
+  __TursoProxy.fsWriteFile(path, data.buffer);
+}
+
+/**
+ * Process a single IO item
+ *
+ * @param item - The IO item to process
+ * @param context - IO context with auth and URL information
+ */
+export async function processIoItem(item, context) {
+  try {
+    const kind = item.getKind();
+    switch (kind) {
+      case 'HTTP':
+        await processHttpRequest(item, context);
+        break;
+      case 'FULL_READ':
+        await processFullRead(item);
+        break;
+      case 'FULL_WRITE':
+        await processFullWrite(item);
+        break;
+      case 'NONE':
+      default:
+        // Nothing to do
+        item.done();
+        break;
+    }
+  } catch (error) {
+    // Poison the item with error message
+    const errorMsg = error instanceof Error ? error.message : String(error);
+    item.poison(errorMsg);
+  }
+}
+
+/**
+ * Normalize URL from libsql:// to https://
+ */
+function normalizeUrl(url) {
+  if (url.startsWith('libsql://')) {
+    return url.replace('libsql://', 'https://');
+  }
+  return url;
+}
+
+/**
+ * Get auth token from context (handles both string and function)
+ */
+function getAuthToken(context) {
+  if (!context.authToken) {
+    return null;
+  }
+  if (typeof context.authToken === 'function') {
+    return context.authToken();
+  }
+  return context.authToken;
+}
+
+/**
+ * Process an HTTP request using fetch()
+ *
+ * @param item - The IO item
+ * @param context - IO context with auth and URL information
+ */
+async function processHttpRequest(item, context) {
+  const request = item.getHttpRequest();
+
+  // Build full URL
+  let fullUrl = '';
+  if (request.url) {
+    // Normalize URL (libsql:// -> https://)
+    let baseUrl = normalizeUrl(request.url);
+
+    // Combine base URL with path if path is provided
+    if (request.path) {
+      // Ensure proper URL formatting (avoid double slashes, ensure single slash)
+      if (baseUrl.endsWith('/') && request.path.startsWith('/')) {
+        fullUrl = baseUrl + request.path.substring(1);
+      } else if (!baseUrl.endsWith('/') && !request.path.startsWith('/')) {
+        fullUrl = baseUrl + '/' + request.path;
+      } else {
+        fullUrl = baseUrl + request.path;
+      }
+    } else {
+      fullUrl = baseUrl;
+    }
+  } else if (request.path) {
+    // Path without base URL - shouldn't happen
+    throw new Error('HTTP request missing base URL');
+  } else {
+    throw new Error('HTTP request missing URL and path');
+  }
+
+  // Build fetch options
+  const options = {
+    method: request.method,
+    headers: {
+      ...request.headers
+    }
+  };
+
+  // Inject Authorization header if auth token is available
+  const authToken = getAuthToken(context);
+  if (authToken) {
+    options.headers['Authorization'] = `Bearer ${authToken}`;
+  }
+
+  // Add body if present
+  if (request.body) {
+    options.body = request.body;
+  }
+
+  // Debug logging for HTTP requests
+  console.log('[Turso HTTP] Request:', {
+    method: request.method,
+    url: fullUrl,
+    hasBody: !!request.body,
+    bodySize: request.body ? request.body.byteLength : 0,
+    headers: options.headers
+  });
+
+  // Make the HTTP request
+  let response;
+  try {
+    response = await fetch(fullUrl, options);
+  } catch (e) {
+    // Detailed error logging
+    const errorDetails = {
+      url: fullUrl,
+      method: request.method,
+      hasBody: !!request.body,
+      bodySize: request.body ? request.body.byteLength : 0,
+      bodyType: request.body ? Object.prototype.toString.call(options.body) : 'none',
+      error: e instanceof Error ? {
+        message: e.message,
+        name: e.name,
+        stack: e.stack
+      } : String(e)
+    };
+    console.error('[Turso HTTP] Request failed:', JSON.stringify(errorDetails, null, 2));
+    throw new Error(`HTTP request failed: ${e instanceof Error ? e.message : String(e)}. URL: ${fullUrl}, Method: ${request.method}, Body size: ${request.body ? request.body.byteLength : 0} bytes`);
+  }
+
+  // Set status code
+  item.setStatus(response.status);
+
+  // Read response body and push to item
+  const responseData = await response.arrayBuffer();
+  if (responseData.byteLength > 0) {
+    item.pushBuffer(responseData);
+  }
+
+  // Mark as done
+  item.done();
+}
+
+/**
+ * Process a full read request (atomic file read)
+ *
+ * @param item - The IO item
+ */
+async function processFullRead(item) {
+  const path = item.getFullReadPath();
+  try {
+    // Read the file (uses built-in JSI function or custom override)
+    const data = await fsReadFile(path);
+
+    // Push data to item
+    if (data.byteLength > 0) {
+      item.pushBuffer(data.buffer);
+    }
+
+    // Mark as done
+    item.done();
+  } catch (error) {
+    // File not found is okay - treat as empty file
+    if (isFileNotFoundError(error)) {
+      // Empty file - just mark as done without pushing data
+      item.done();
+    } else {
+      throw error;
+    }
+  }
+}
+
+/**
+ * Process a full write request (atomic file write)
+ *
+ * @param item - The IO item
+ */
+async function processFullWrite(item) {
+  const request = item.getFullWriteRequest();
+
+  // Convert ArrayBuffer to Uint8Array
+  const data = request.content ? new Uint8Array(request.content) : new Uint8Array(0);
+
+  // Write the file atomically (uses built-in JSI function or custom override)
+  await fsWriteFile(request.path, data);
+
+  // Mark as done
+  item.done();
+}
+
+/**
+ * Check if error is a file-not-found error
+ *
+ * @param error - The error to check
+ * @returns true if file not found
+ */
+function isFileNotFoundError(error) {
+  if (error instanceof Error) {
+    const message = error.message.toLowerCase();
+    return message.includes('enoent') || message.includes('not found') || message.includes('no such file');
+  }
+  return false;
+}
+
+/**
+ * Drain all pending IO items from sync engine queue and process them.
+ * This is called during statement execution when partial sync needs to load missing pages.
+ *
+ * @param database - The native sync database
+ * @param context - IO context with auth and URL information
+ */
+export async function drainSyncIo(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
+    promises.push(processIoItem(ioItem, context));
+  }
+
+  // Wait for all IO operations to complete
+  await Promise.all(promises);
+
+  // Step callbacks after IO processing
+  // This allows the sync engine to run any post-IO callbacks
+  database.ioStepCallbacks();
+}
+//# sourceMappingURL=ioProcessor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["fsReadFileOverride","fsWriteFileOverride","setFileSystemImpl","readFile","writeFile","fsReadFile","path","buffer","__TursoProxy","Uint8Array","fsWriteFile","data","processIoItem","item","context","kind","getKind","processHttpRequest","processFullRead","processFullWrite","done","error","errorMsg","Error","message","String","poison","normalizeUrl","url","startsWith","replace","getAuthToken","authToken","request","getHttpRequest","fullUrl","baseUrl","endsWith","substring","options","method","headers","body","console","log","hasBody","bodySize","byteLength","response","fetch","e","errorDetails","bodyType","Object","prototype","toString","call","name","stack","JSON","stringify","setStatus","status","responseData","arrayBuffer","pushBuffer","getFullReadPath","isFileNotFoundError","getFullWriteRequest","content","toLowerCase","includes","drainSyncIo","database","promises","ioItem","ioTakeItem","push","Promise","all","ioStepCallbacks"],"sourceRoot":"../../../src","sources":["internal/ioProcessor.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/module/types.js

@@ -0,0 +1,163 @@
+"use strict";
+
+/**
+ * Turso React Native SDK-KIT Types
+ *
+ * Clean TypeScript types matching the SDK-KIT C API patterns.
+ * All logic lives in TypeScript or Rust - the C++ layer is just a thin bridge.
+ */
+
+// ============================================================================
+// Core SDK-KIT Types (Local Database)
+// ============================================================================
+
+/**
+ * Native database interface (local-only)
+ * Thin wrapper around TursoDatabaseHostObject
+ */
+
+/**
+ * Native connection interface
+ * Thin wrapper around TursoConnectionHostObject
+ */
+
+/**
+ * Native statement interface
+ * Thin wrapper around TursoStatementHostObject
+ */
+
+// ============================================================================
+// Sync SDK-KIT Types (Embedded Replica)
+// ============================================================================
+
+/**
+ * Native sync database interface (embedded replica)
+ * Thin wrapper around TursoSyncDatabaseHostObject
+ */
+
+/**
+ * Native sync operation interface
+ * Thin wrapper around TursoSyncOperationHostObject
+ * Represents an async operation that must be driven by calling resume()
+ */
+
+/**
+ * Native sync IO item interface
+ * Thin wrapper around TursoSyncIoItemHostObject
+ * Represents an IO request that JavaScript must process using fetch() or fs
+ */
+
+/**
+ * Native sync changes interface
+ * Thin wrapper around TursoSyncChangesHostObject
+ * Represents changes fetched from remote (opaque, passed to applyChanges)
+ */
+
+// ============================================================================
+// Turso Status Codes
+// ============================================================================
+
+export let TursoStatus = /*#__PURE__*/function (TursoStatus) {
+  TursoStatus[TursoStatus["OK"] = 0] = "OK";
+  TursoStatus[TursoStatus["DONE"] = 1] = "DONE";
+  TursoStatus[TursoStatus["ROW"] = 2] = "ROW";
+  TursoStatus[TursoStatus["IO"] = 3] = "IO";
+  TursoStatus[TursoStatus["BUSY"] = 4] = "BUSY";
+  TursoStatus[TursoStatus["INTERRUPT"] = 5] = "INTERRUPT";
+  TursoStatus[TursoStatus["BUSY_SNAPSHOT"] = 6] = "BUSY_SNAPSHOT";
+  TursoStatus[TursoStatus["ERROR"] = 127] = "ERROR";
+  TursoStatus[TursoStatus["MISUSE"] = 128] = "MISUSE";
+  TursoStatus[TursoStatus["CONSTRAINT"] = 129] = "CONSTRAINT";
+  TursoStatus[TursoStatus["READONLY"] = 130] = "READONLY";
+  TursoStatus[TursoStatus["DATABASE_FULL"] = 131] = "DATABASE_FULL";
+  TursoStatus[TursoStatus["NOTADB"] = 132] = "NOTADB";
+  TursoStatus[TursoStatus["CORRUPT"] = 133] = "CORRUPT";
+  TursoStatus[TursoStatus["IOERR"] = 134] = "IOERR";
+  return TursoStatus;
+}({});
+
+// ============================================================================
+// Turso Value Types
+// ============================================================================
+
+export let TursoType = /*#__PURE__*/function (TursoType) {
+  TursoType[TursoType["UNKNOWN"] = 0] = "UNKNOWN";
+  TursoType[TursoType["INTEGER"] = 1] = "INTEGER";
+  TursoType[TursoType["REAL"] = 2] = "REAL";
+  TursoType[TursoType["TEXT"] = 3] = "TEXT";
+  TursoType[TursoType["BLOB"] = 4] = "BLOB";
+  TursoType[TursoType["NULL"] = 5] = "NULL";
+  return TursoType;
+}({});
+
+// ============================================================================
+// Sync Operation Result Types
+// ============================================================================
+
+export let SyncOperationResultType = /*#__PURE__*/function (SyncOperationResultType) {
+  SyncOperationResultType[SyncOperationResultType["NONE"] = 0] = "NONE";
+  SyncOperationResultType[SyncOperationResultType["CONNECTION"] = 1] = "CONNECTION";
+  SyncOperationResultType[SyncOperationResultType["CHANGES"] = 2] = "CHANGES";
+  SyncOperationResultType[SyncOperationResultType["STATS"] = 3] = "STATS";
+  return SyncOperationResultType;
+}({});
+
+// ============================================================================
+// Public API Types (High-level TypeScript)
+// ============================================================================
+
+/**
+ * Supported SQLite value types for the public API
+ */
+
+/**
+ * Parameters that can be bound to SQL statements
+ */
+
+/**
+ * Result of a run() or exec() operation
+ */
+
+/**
+ * A row returned from a query
+ */
+
+/**
+ * Encryption options (matches JavaScript bindings)
+ */
+
+/**
+ * Database options (matches JavaScript bindings)
+ * Single unified config for both local and sync databases
+ */
+
+/**
+ * Sync stats returned by stats() operation
+ */
+
+/**
+ * HTTP request from sync engine
+ */
+
+/**
+ * Full write request from sync engine
+ */
+
+// ============================================================================
+// Global Turso Proxy Interface
+// ============================================================================
+
+/**
+ * Native proxy interface exposed via JSI
+ */
+
+/**
+ * Native module interface (React Native bridge)
+ */
+
+/**
+ * Global __TursoProxy object injected by native code
+ */
+
+export {};
+//# sourceMappingURL=types.js.map

package/lib/module/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["TursoStatus","TursoType","SyncOperationResultType"],"sourceRoot":"../../src","sources":["types.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;;AAEA;AACA;AACA;AACA;;AAOA;AACA;AACA;AACA;;AAUA;AACA;AACA;AACA;;AAgCA;AACA;AACA;;AAEA;AACA;AACA;AACA;;AAmBA;AACA;AACA;AACA;AACA;;AASA;AACA;AACA;AACA;AACA;;AAcA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;;AAEA,WAAYA,WAAW,0BAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAXA,WAAW,CAAXA,WAAW;EAAA,OAAXA,WAAW;AAAA;;AAkBvB;AACA;AACA;;AAEA,WAAYC,SAAS,0BAATA,SAAS;EAATA,SAAS,CAATA,SAAS;EAATA,SAAS,CAATA,SAAS;EAATA,SAAS,CAATA,SAAS;EAATA,SAAS,CAATA,SAAS;EAATA,SAAS,CAATA,SAAS;EAATA,SAAS,CAATA,SAAS;EAAA,OAATA,SAAS;AAAA;;AASrB;AACA;AACA;;AAEA,WAAYC,uBAAuB,0BAAvBA,uBAAuB;EAAvBA,uBAAuB,CAAvBA,uBAAuB;EAAvBA,uBAAuB,CAAvBA,uBAAuB;EAAvBA,uBAAuB,CAAvBA,uBAAuB;EAAvBA,uBAAuB,CAAvBA,uBAAuB;EAAA,OAAvBA,uBAAuB;AAAA;;AAOnC;AACA;AACA;;AAEA;AACA;AACA;;AAGA;AACA;AACA;;AAMA;AACA;AACA;;AAQA;AACA;AACA;;AAGA;AACA;AACA;;AAsBA;AACA;AACA;AACA;;AAgFA;AACA;AACA;;AAYA;AACA;AACA;;AASA;AACA;AACA;;AAMA;AACA;AACA;;AAEA;AACA;AACA;;AAUA;AACA;AACA;;AAWA;AACA;AACA;;AAMA","ignoreList":[]}

package/lib/typescript/Database.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Database
+ *
+ * Unified high-level API for both local and sync databases.
+ * Constructor determines whether to use local-only or sync mode based on config.
+ */
+import { Statement } from './Statement';
+import type { Row, RunResult, BindParams, DatabaseOpts, SyncStats } from './types';
+/**
+ * Database class - works for both local-only and sync databases
+ *
+ * All database operations are async to properly handle IO requirements:
+ * - For local databases: async allows yielding to JS event loop
+ * - For sync databases: async required for network operations
+ * - For partial sync: async required to load missing pages on-demand
+ */
+export declare class Database {
+    private _opts;
+    private _nativeDb;
+    private _nativeSyncDb;
+    private _connection;
+    private _isSync;
+    private _connected;
+    private _closed;
+    private _extraIo?;
+    private _ioContext?;
+    /**
+     * Create a new database (doesn't connect yet - call connect())
+     *
+     * @param opts - Database options
+     */
+    constructor(opts: DatabaseOpts);
+    /**
+     * Connect to the database (matches JavaScript bindings)
+     * For local databases: opens immediately
+     * For sync databases: bootstraps if needed
+     */
+    connect(): Promise<void>;
+    /**
+     * Initialize local-only database
+     */
+    private initLocalDatabase;
+    /**
+     * Initialize sync database
+     */
+    private initSyncDatabase;
+    /**
+     * Prepare a SQL statement
+     *
+     * @param sql - SQL statement to prepare
+     * @returns Prepared statement
+     */
+    prepare(sql: string): Statement;
+    /**
+     * Execute SQL without returning results (for DDL, multi-statement SQL)
+     *
+     * @param sql - SQL to execute
+     */
+    exec(sql: string): Promise<void>;
+    /**
+     * Execute statement and return result info
+     *
+     * @param sql - SQL statement
+     * @param params - Bind parameters
+     * @returns Run result with changes and lastInsertRowid
+     */
+    run(sql: string, ...params: BindParams[]): Promise<RunResult>;
+    /**
+     * Execute query and return first row
+     *
+     * @param sql - SQL query
+     * @param params - Bind parameters
+     * @returns First row or undefined
+     */
+    get(sql: string, ...params: BindParams[]): Promise<Row | undefined>;
+    /**
+     * Execute query and return all rows
+     *
+     * @param sql - SQL query
+     * @param params - Bind parameters
+     * @returns All rows
+     */
+    all(sql: string, ...params: BindParams[]): Promise<Row[]>;
+    /**
+     * Execute function within a transaction
+     *
+     * @param fn - Function to execute
+     * @returns Function result
+     */
+    transaction<T>(fn: () => T | Promise<T>): Promise<T>;
+    /**
+     * Push local changes to remote (sync databases only)
+     */
+    push(): Promise<void>;
+    /**
+     * Pull remote changes and apply locally (sync databases only)
+     *
+     * @returns true if changes were applied, false if no changes
+     */
+    pull(): Promise<boolean>;
+    /**
+     * Get sync statistics (sync databases only)
+     *
+     * @returns Sync stats
+     */
+    stats(): Promise<SyncStats>;
+    /**
+     * Checkpoint database (sync databases only)
+     */
+    checkpoint(): Promise<void>;
+    /**
+     * Close the database
+     */
+    close(): void;
+    /**
+     * Get database path
+     */
+    get path(): string;
+    /**
+     * Check if database is a sync database
+     */
+    get isSync(): boolean;
+    /**
+     * Check if database is open
+     */
+    get open(): boolean;
+    /**
+     * Check if in transaction
+     */
+    get inTransaction(): boolean;
+    /**
+     * Get last insert rowid
+     */
+    get lastInsertRowid(): number;
+    /**
+     * Check if open and throw if not
+     */
+    private checkOpen;
+}
+//# sourceMappingURL=Database.d.ts.map

package/lib/typescript/Database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Database.d.ts","sourceRoot":"","sources":["../../src/Database.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAIV,GAAG,EACH,SAAS,EAET,UAAU,EACV,YAAY,EACZ,SAAS,EAEV,MAAM,SAAS,CAAC;AA2CjB;;;;;;;GAOG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,aAAa,CAAmC;IACxD,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,CAAsB;IACvC,OAAO,CAAC,UAAU,CAAC,CAGjB;IAEF;;;;OAIG;gBACS,IAAI,EAAE,YAAY;IAK9B;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAc9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;OAEG;YACW,gBAAgB;IA4E9B;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAY/B;;;;OAIG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BtC;;;;;;OAMG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IASnE;;;;;;OAMG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC;IASzE;;;;;;OAMG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAS/D;;;;;OAKG;IACG,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAa1D;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAqB9B;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC;IASjC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IASjC;;OAEG;IACH,KAAK,IAAI,IAAI;IAwBb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,OAAO,CAElB;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,OAAO,CAK3B;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,MAAM,CAK5B;IAED;;OAEG;IACH,OAAO,CAAC,SAAS;CAQlB"}