@trainstar/synchro-react-native 0.1.0

package/lib/module/NativeSynchro.js

@@ -0,0 +1,5 @@
+"use strict";
+
+import { TurboModuleRegistry } from 'react-native';
+export default TurboModuleRegistry.getEnforcing('SynchroModule');
+//# sourceMappingURL=NativeSynchro.js.map

package/lib/module/NativeSynchro.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeSynchro.ts"],"mappings":";;AAEA,SAASA,mBAAmB,QAAQ,cAAc;AA+GlD,eAAeA,mBAAmB,CAACC,YAAY,CAAO,eAAe,CAAC","ignoreList":[]}

package/lib/module/SynchroClient.js

@@ -0,0 +1,295 @@
+"use strict";
+
+import { Platform } from 'react-native';
+import NativeSynchro from "./NativeSynchro.js";
+import { mapNativeError } from "./errors.js";
+let observerCounter = 0;
+function nextObserverID() {
+  return `obs_${++observerCounter}_${Date.now()}`;
+}
+export class SynchroClient {
+  native = NativeSynchro;
+  authSubscription = null;
+  constructor(config) {
+    this.config = config;
+
+    // Wire auth callback using Codegen EventEmitter pattern
+    this.authSubscription = this.native.onAuthRequest(event => {
+      this.config.authProvider().then(token => {
+        this.native.resolveAuthRequest(event.requestID, token);
+      }).catch(err => {
+        this.native.rejectAuthRequest(event.requestID, err instanceof Error ? err.message : String(err));
+      });
+    });
+  }
+  async initialize() {
+    try {
+      await this.native.initialize({
+        dbPath: this.config.dbPath,
+        serverURL: this.config.serverURL,
+        clientID: this.config.clientID,
+        platform: this.config.platform ?? Platform.OS,
+        appVersion: this.config.appVersion,
+        syncInterval: this.config.syncInterval ?? 30,
+        pushDebounce: this.config.pushDebounce ?? 0.5,
+        maxRetryAttempts: this.config.maxRetryAttempts ?? 5,
+        pullPageSize: this.config.pullPageSize ?? 100,
+        pushBatchSize: this.config.pushBatchSize ?? 100,
+        snapshotPageSize: this.config.snapshotPageSize ?? 100
+      });
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+  }
+
+  // -- Core SQL --
+
+  async query(sql, params) {
+    try {
+      const json = await this.native.query(sql, JSON.stringify(params ?? []));
+      return JSON.parse(json);
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+  }
+  async queryOne(sql, params) {
+    try {
+      const json = await this.native.queryOne(sql, JSON.stringify(params ?? []));
+      return json ? JSON.parse(json) : null;
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+  }
+  async execute(sql, params) {
+    try {
+      return await this.native.execute(sql, JSON.stringify(params ?? []));
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+  }
+  async executeBatch(statements) {
+    try {
+      const payload = statements.map(s => ({
+        sql: s.sql,
+        params: s.params ?? []
+      }));
+      return await this.native.executeBatch(JSON.stringify(payload));
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+  }
+
+  // -- Transactions --
+
+  async writeTransaction(callback) {
+    let txID;
+    try {
+      txID = await this.native.beginWriteTransaction();
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+    try {
+      const tx = {
+        query: async (sql, params) => {
+          const json = await this.native.txQuery(txID, sql, JSON.stringify(params ?? []));
+          return JSON.parse(json);
+        },
+        queryOne: async (sql, params) => {
+          const json = await this.native.txQueryOne(txID, sql, JSON.stringify(params ?? []));
+          return json ? JSON.parse(json) : null;
+        },
+        execute: async (sql, params) => {
+          return await this.native.txExecute(txID, sql, JSON.stringify(params ?? []));
+        }
+      };
+      const result = await callback(tx);
+      await this.native.commitTransaction(txID);
+      return result;
+    } catch (error) {
+      try {
+        await this.native.rollbackTransaction(txID);
+      } catch {
+        // rollback best-effort
+      }
+      throw mapNativeError(error);
+    }
+  }
+  async readTransaction(callback) {
+    let txID;
+    try {
+      txID = await this.native.beginReadTransaction();
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+    try {
+      const tx = {
+        query: async (sql, params) => {
+          const json = await this.native.txQuery(txID, sql, JSON.stringify(params ?? []));
+          return JSON.parse(json);
+        },
+        queryOne: async (sql, params) => {
+          const json = await this.native.txQueryOne(txID, sql, JSON.stringify(params ?? []));
+          return json ? JSON.parse(json) : null;
+        },
+        execute: async (sql, params) => {
+          return await this.native.txExecute(txID, sql, JSON.stringify(params ?? []));
+        }
+      };
+      const result = await callback(tx);
+      await this.native.commitTransaction(txID);
+      return result;
+    } catch (error) {
+      try {
+        await this.native.rollbackTransaction(txID);
+      } catch {
+        // rollback best-effort
+      }
+      throw mapNativeError(error);
+    }
+  }
+
+  // -- Schema (local-only) --
+
+  async createTable(name, columns, options) {
+    try {
+      await this.native.createTable(name, JSON.stringify(columns), options ? JSON.stringify(options) : null);
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+  }
+  async alterTable(name, addColumns) {
+    try {
+      await this.native.alterTable(name, JSON.stringify(addColumns));
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+  }
+  async createIndex(table, columns, unique = false) {
+    try {
+      await this.native.createIndex(table, columns, unique);
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+  }
+
+  // -- Observation --
+
+  onChange(tables, callback) {
+    const observerID = nextObserverID();
+    const subscription = this.native.onChange(event => {
+      if (event.observerID === observerID) {
+        callback();
+      }
+    });
+    this.native.addChangeObserver(observerID, tables);
+    return () => {
+      subscription.remove();
+      this.native.removeObserver(observerID);
+    };
+  }
+  watch(sql, params, tables, callback) {
+    const observerID = nextObserverID();
+    const subscription = this.native.onQueryResult(event => {
+      if (event.observerID === observerID) {
+        callback(JSON.parse(event.rowsJson));
+      }
+    });
+    this.native.addQueryObserver(observerID, sql, JSON.stringify(params ?? []), tables);
+    return () => {
+      subscription.remove();
+      this.native.removeObserver(observerID);
+    };
+  }
+
+  // -- WAL --
+
+  async checkpoint(mode = 'passive') {
+    try {
+      await this.native.checkpoint(mode);
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+  }
+
+  // -- Lifecycle --
+
+  async close() {
+    try {
+      await this.native.close();
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+  }
+  async getPath() {
+    try {
+      return await this.native.getPath();
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+  }
+  async pendingChangeCount() {
+    try {
+      return await this.native.pendingChangeCount();
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+  }
+
+  // -- Sync --
+
+  async start() {
+    try {
+      await this.native.start();
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+  }
+  async stop() {
+    try {
+      await this.native.stop();
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+  }
+  async syncNow() {
+    try {
+      await this.native.syncNow();
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+  }
+
+  // -- Status & Events --
+
+  onStatusChange(callback) {
+    const subscription = this.native.onStatusChange(event => {
+      callback({
+        status: event.status,
+        retryAt: event.retryAt ? new Date(event.retryAt) : null
+      });
+    });
+    return () => subscription.remove();
+  }
+  onConflict(callback) {
+    const subscription = this.native.onConflict(event => {
+      callback({
+        table: event.table,
+        recordID: event.recordID,
+        clientData: event.clientDataJson ? JSON.parse(event.clientDataJson) : null,
+        serverData: event.serverDataJson ? JSON.parse(event.serverDataJson) : null
+      });
+    });
+    return () => subscription.remove();
+  }
+  onSnapshotRequired(handler) {
+    const subscription = this.native.onSnapshotRequired(event => {
+      handler().then(approved => {
+        this.native.resolveSnapshotRequest(event.requestID, approved);
+      }).catch(() => {
+        this.native.resolveSnapshotRequest(event.requestID, false);
+      });
+    });
+    return () => subscription.remove();
+  }
+}
+//# sourceMappingURL=SynchroClient.js.map

package/lib/module/SynchroClient.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Platform","NativeSynchro","mapNativeError","observerCounter","nextObserverID","Date","now","SynchroClient","native","authSubscription","constructor","config","onAuthRequest","event","authProvider","then","token","resolveAuthRequest","requestID","catch","err","rejectAuthRequest","Error","message","String","initialize","dbPath","serverURL","clientID","platform","OS","appVersion","syncInterval","pushDebounce","maxRetryAttempts","pullPageSize","pushBatchSize","snapshotPageSize","error","query","sql","params","json","JSON","stringify","parse","queryOne","execute","executeBatch","statements","payload","map","s","writeTransaction","callback","txID","beginWriteTransaction","tx","txQuery","txQueryOne","txExecute","result","commitTransaction","rollbackTransaction","readTransaction","beginReadTransaction","createTable","name","columns","options","alterTable","addColumns","createIndex","table","unique","onChange","tables","observerID","subscription","addChangeObserver","remove","removeObserver","watch","onQueryResult","rowsJson","addQueryObserver","checkpoint","mode","close","getPath","pendingChangeCount","start","stop","syncNow","onStatusChange","status","retryAt","onConflict","recordID","clientData","clientDataJson","serverData","serverDataJson","onSnapshotRequired","handler","approved","resolveSnapshotRequest"],"sourceRoot":"../../src","sources":["SynchroClient.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/errors.js

@@ -0,0 +1,150 @@
+"use strict";
+
+export class SynchroError extends Error {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = 'SynchroError';
+  }
+}
+export class NotConnectedError extends SynchroError {
+  constructor() {
+    super('NOT_CONNECTED', 'Not connected to sync server');
+    this.name = 'NotConnectedError';
+  }
+}
+export class SchemaNotLoadedError extends SynchroError {
+  constructor() {
+    super('SCHEMA_NOT_LOADED', 'Schema has not been loaded from server');
+    this.name = 'SchemaNotLoadedError';
+  }
+}
+export class TableNotSyncedError extends SynchroError {
+  constructor(table) {
+    super('TABLE_NOT_SYNCED', `Table '${table}' is not a synced table`);
+    this.name = 'TableNotSyncedError';
+    this.table = table;
+  }
+}
+export class UpgradeRequiredError extends SynchroError {
+  constructor(currentVersion, minimumVersion) {
+    super('UPGRADE_REQUIRED', `App version ${currentVersion} is below minimum ${minimumVersion}`);
+    this.name = 'UpgradeRequiredError';
+    this.currentVersion = currentVersion;
+    this.minimumVersion = minimumVersion;
+  }
+}
+export class SchemaMismatchError extends SynchroError {
+  constructor(serverVersion, serverHash) {
+    super('SCHEMA_MISMATCH', `Schema mismatch: server version ${serverVersion}, hash ${serverHash}`);
+    this.name = 'SchemaMismatchError';
+    this.serverVersion = serverVersion;
+    this.serverHash = serverHash;
+  }
+}
+export class SnapshotRequiredError extends SynchroError {
+  constructor() {
+    super('SNAPSHOT_REQUIRED', 'Full snapshot required');
+    this.name = 'SnapshotRequiredError';
+  }
+}
+export class PushRejectedError extends SynchroError {
+  constructor(results) {
+    super('PUSH_REJECTED', `Push rejected: ${results.length} record(s)`);
+    this.name = 'PushRejectedError';
+    this.results = results;
+  }
+}
+export class NetworkError extends SynchroError {
+  constructor(message) {
+    super('NETWORK_ERROR', `Network error: ${message}`);
+    this.name = 'NetworkError';
+  }
+}
+export class ServerError extends SynchroError {
+  constructor(status, message) {
+    super('SERVER_ERROR', `Server error ${status}: ${message}`);
+    this.name = 'ServerError';
+    this.status = status;
+  }
+}
+export class DatabaseError extends SynchroError {
+  constructor(message) {
+    super('DATABASE_ERROR', `Database error: ${message}`);
+    this.name = 'DatabaseError';
+  }
+}
+export class InvalidResponseError extends SynchroError {
+  constructor(message) {
+    super('INVALID_RESPONSE', `Invalid response: ${message}`);
+    this.name = 'InvalidResponseError';
+  }
+}
+export class AlreadyStartedError extends SynchroError {
+  constructor() {
+    super('ALREADY_STARTED', 'Sync has already been started');
+    this.name = 'AlreadyStartedError';
+  }
+}
+export class NotStartedError extends SynchroError {
+  constructor() {
+    super('NOT_STARTED', 'Sync has not been started');
+    this.name = 'NotStartedError';
+  }
+}
+export class TransactionTimeoutError extends SynchroError {
+  constructor() {
+    super('TRANSACTION_TIMEOUT', 'Transaction timed out due to inactivity');
+    this.name = 'TransactionTimeoutError';
+  }
+}
+export function mapNativeError(error) {
+  if (error instanceof SynchroError) {
+    return error;
+  }
+  const nativeError = error;
+  const code = nativeError?.code;
+  const message = nativeError?.message ?? 'Unknown error';
+  const userInfo = nativeError?.userInfo ?? {};
+  switch (code) {
+    case 'NOT_CONNECTED':
+      return new NotConnectedError();
+    case 'SCHEMA_NOT_LOADED':
+      return new SchemaNotLoadedError();
+    case 'TABLE_NOT_SYNCED':
+      return new TableNotSyncedError(userInfo.table ?? '');
+    case 'UPGRADE_REQUIRED':
+      return new UpgradeRequiredError(userInfo.currentVersion ?? '', userInfo.minimumVersion ?? '');
+    case 'SCHEMA_MISMATCH':
+      return new SchemaMismatchError(parseInt(userInfo.serverVersion ?? '0', 10), userInfo.serverHash ?? '');
+    case 'SNAPSHOT_REQUIRED':
+      return new SnapshotRequiredError();
+    case 'PUSH_REJECTED':
+      {
+        let results = [];
+        try {
+          results = JSON.parse(userInfo.results ?? '[]');
+        } catch {
+          // leave empty
+        }
+        return new PushRejectedError(results);
+      }
+    case 'NETWORK_ERROR':
+      return new NetworkError(userInfo.message ?? message);
+    case 'SERVER_ERROR':
+      return new ServerError(parseInt(userInfo.status ?? '0', 10), userInfo.message ?? message);
+    case 'DATABASE_ERROR':
+      return new DatabaseError(userInfo.message ?? message);
+    case 'INVALID_RESPONSE':
+      return new InvalidResponseError(userInfo.message ?? message);
+    case 'ALREADY_STARTED':
+      return new AlreadyStartedError();
+    case 'NOT_STARTED':
+      return new NotStartedError();
+    case 'TRANSACTION_TIMEOUT':
+      return new TransactionTimeoutError();
+    default:
+      return new SynchroError(code ?? 'UNKNOWN', message);
+  }
+}
+//# sourceMappingURL=errors.js.map

package/lib/module/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SynchroError","Error","constructor","code","message","name","NotConnectedError","SchemaNotLoadedError","TableNotSyncedError","table","UpgradeRequiredError","currentVersion","minimumVersion","SchemaMismatchError","serverVersion","serverHash","SnapshotRequiredError","PushRejectedError","results","length","NetworkError","ServerError","status","DatabaseError","InvalidResponseError","AlreadyStartedError","NotStartedError","TransactionTimeoutError","mapNativeError","error","nativeError","userInfo","parseInt","JSON","parse"],"sourceRoot":"../../src","sources":["errors.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/hooks/index.js

@@ -0,0 +1,6 @@
+"use strict";
+
+export { useQuery } from "./useQuery.js";
+export { useSyncStatus } from "./useSyncStatus.js";
+export { usePendingChanges } from "./usePendingChanges.js";
+//# sourceMappingURL=index.js.map

package/lib/module/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useQuery","useSyncStatus","usePendingChanges"],"sourceRoot":"../../../src","sources":["hooks/index.ts"],"mappings":";;AAAA,SAASA,QAAQ,QAAQ,eAAY;AACrC,SAASC,aAAa,QAAQ,oBAAiB;AAC/C,SAASC,iBAAiB,QAAQ,wBAAqB","ignoreList":[]}

package/lib/module/hooks/usePendingChanges.js

@@ -0,0 +1,25 @@
+"use strict";
+
+import { useState, useEffect } from 'react';
+export function usePendingChanges(client, pollInterval = 2000) {
+  const [count, setCount] = useState(0);
+  useEffect(() => {
+    let active = true;
+    const poll = async () => {
+      try {
+        const c = await client.pendingChangeCount();
+        if (active) setCount(c);
+      } catch {
+        // ignore poll errors
+      }
+    };
+    poll();
+    const interval = setInterval(poll, pollInterval);
+    return () => {
+      active = false;
+      clearInterval(interval);
+    };
+  }, [client, pollInterval]);
+  return count;
+}
+//# sourceMappingURL=usePendingChanges.js.map

package/lib/module/hooks/usePendingChanges.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useState","useEffect","usePendingChanges","client","pollInterval","count","setCount","active","poll","c","pendingChangeCount","interval","setInterval","clearInterval"],"sourceRoot":"../../../src","sources":["hooks/usePendingChanges.ts"],"mappings":";;AAAA,SAASA,QAAQ,EAAEC,SAAS,QAAQ,OAAO;AAG3C,OAAO,SAASC,iBAAiBA,CAC/BC,MAAqB,EACrBC,YAAY,GAAG,IAAI,EACX;EACR,MAAM,CAACC,KAAK,EAAEC,QAAQ,CAAC,GAAGN,QAAQ,CAAC,CAAC,CAAC;EAErCC,SAAS,CAAC,MAAM;IACd,IAAIM,MAAM,GAAG,IAAI;IAEjB,MAAMC,IAAI,GAAG,MAAAA,CAAA,KAAY;MACvB,IAAI;QACF,MAAMC,CAAC,GAAG,MAAMN,MAAM,CAACO,kBAAkB,CAAC,CAAC;QAC3C,IAAIH,MAAM,EAAED,QAAQ,CAACG,CAAC,CAAC;MACzB,CAAC,CAAC,MAAM;QACN;MAAA;IAEJ,CAAC;IAEDD,IAAI,CAAC,CAAC;IACN,MAAMG,QAAQ,GAAGC,WAAW,CAACJ,IAAI,EAAEJ,YAAY,CAAC;IAEhD,OAAO,MAAM;MACXG,MAAM,GAAG,KAAK;MACdM,aAAa,CAACF,QAAQ,CAAC;IACzB,CAAC;EACH,CAAC,EAAE,CAACR,MAAM,EAAEC,YAAY,CAAC,CAAC;EAE1B,OAAOC,KAAK;AACd","ignoreList":[]}

package/lib/module/hooks/useQuery.js

@@ -0,0 +1,74 @@
+"use strict";
+
+import { useState, useEffect, useCallback, useRef } from 'react';
+function arraysEqual(a, b) {
+  if (a === b) return true;
+  if (!a || !b) return !a && !b;
+  if (a.length !== b.length) return false;
+  for (let i = 0; i < a.length; i += 1) {
+    if (a[i] !== b[i]) return false;
+  }
+  return true;
+}
+function useStableArray(value) {
+  const ref = useRef(value);
+  if (!arraysEqual(ref.current, value)) {
+    ref.current = value ? [...value] : value;
+  }
+  return ref.current;
+}
+export function useQuery(client, sql, params, tables) {
+  const [data, setData] = useState([]);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const refreshCounter = useRef(0);
+  const [, setRefreshTrigger] = useState(0);
+  const stableParams = useStableArray(params);
+  const stableTables = useStableArray(tables);
+  const refresh = useCallback(() => {
+    refreshCounter.current += 1;
+    setRefreshTrigger(refreshCounter.current);
+  }, []);
+  useEffect(() => {
+    if (stableTables && stableTables.length > 0) {
+      // Reactive mode: use watch()
+      setLoading(true);
+      let firstResult = true;
+      const unsubscribe = client.watch(sql, stableParams, stableTables, rows => {
+        setData(rows);
+        setError(null);
+        if (firstResult) {
+          setLoading(false);
+          firstResult = false;
+        }
+      });
+      return unsubscribe;
+    } else {
+      // One-shot mode: use query()
+      let cancelled = false;
+      setLoading(true);
+      client.query(sql, stableParams).then(rows => {
+        if (!cancelled) {
+          setData(rows);
+          setError(null);
+          setLoading(false);
+        }
+      }).catch(err => {
+        if (!cancelled) {
+          setError(err);
+          setLoading(false);
+        }
+      });
+      return () => {
+        cancelled = true;
+      };
+    }
+  }, [client, sql, stableParams, stableTables, refreshCounter.current]);
+  return {
+    data,
+    loading,
+    error,
+    refresh
+  };
+}
+//# sourceMappingURL=useQuery.js.map

package/lib/module/hooks/useQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useState","useEffect","useCallback","useRef","arraysEqual","a","b","length","i","useStableArray","value","ref","current","useQuery","client","sql","params","tables","data","setData","loading","setLoading","error","setError","refreshCounter","setRefreshTrigger","stableParams","stableTables","refresh","firstResult","unsubscribe","watch","rows","cancelled","query","then","catch","err"],"sourceRoot":"../../../src","sources":["hooks/useQuery.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/hooks/useSyncStatus.js

@@ -0,0 +1,15 @@
+"use strict";
+
+import { useState, useEffect } from 'react';
+export function useSyncStatus(client) {
+  const [status, setStatus] = useState({
+    status: 'idle',
+    retryAt: null
+  });
+  useEffect(() => {
+    const unsubscribe = client.onStatusChange(setStatus);
+    return unsubscribe;
+  }, [client]);
+  return status;
+}
+//# sourceMappingURL=useSyncStatus.js.map

package/lib/module/hooks/useSyncStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useState","useEffect","useSyncStatus","client","status","setStatus","retryAt","unsubscribe","onStatusChange"],"sourceRoot":"../../../src","sources":["hooks/useSyncStatus.ts"],"mappings":";;AAAA,SAASA,QAAQ,EAAEC,SAAS,QAAQ,OAAO;AAI3C,OAAO,SAASC,aAAaA,CAACC,MAAqB,EAAc;EAC/D,MAAM,CAACC,MAAM,EAAEC,SAAS,CAAC,GAAGL,QAAQ,CAAa;IAC/CI,MAAM,EAAE,MAAM;IACdE,OAAO,EAAE;EACX,CAAC,CAAC;EAEFL,SAAS,CAAC,MAAM;IACd,MAAMM,WAAW,GAAGJ,MAAM,CAACK,cAAc,CAACH,SAAS,CAAC;IACpD,OAAOE,WAAW;EACpB,CAAC,EAAE,CAACJ,MAAM,CAAC,CAAC;EAEZ,OAAOC,MAAM;AACf","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,8 @@
+"use strict";
+
+export { SynchroClient } from "./SynchroClient.js";
+export { useQuery } from "./hooks/useQuery.js";
+export { useSyncStatus } from "./hooks/useSyncStatus.js";
+export { usePendingChanges } from "./hooks/usePendingChanges.js";
+export { SynchroError, NotConnectedError, SchemaNotLoadedError, TableNotSyncedError, UpgradeRequiredError, SchemaMismatchError, SnapshotRequiredError, PushRejectedError, NetworkError, ServerError, DatabaseError, InvalidResponseError, AlreadyStartedError, NotStartedError, TransactionTimeoutError, mapNativeError } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SynchroClient","useQuery","useSyncStatus","usePendingChanges","SynchroError","NotConnectedError","SchemaNotLoadedError","TableNotSyncedError","UpgradeRequiredError","SchemaMismatchError","SnapshotRequiredError","PushRejectedError","NetworkError","ServerError","DatabaseError","InvalidResponseError","AlreadyStartedError","NotStartedError","TransactionTimeoutError","mapNativeError"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,oBAAiB;AAC/C,SAASC,QAAQ,QAAQ,qBAAkB;AAC3C,SAASC,aAAa,QAAQ,0BAAuB;AACrD,SAASC,iBAAiB,QAAQ,8BAA2B;AAkB7D,SACEC,YAAY,EACZC,iBAAiB,EACjBC,oBAAoB,EACpBC,mBAAmB,EACnBC,oBAAoB,EACpBC,mBAAmB,EACnBC,qBAAqB,EACrBC,iBAAiB,EACjBC,YAAY,EACZC,WAAW,EACXC,aAAa,EACbC,oBAAoB,EACpBC,mBAAmB,EACnBC,eAAe,EACfC,uBAAuB,EACvBC,cAAc,QACT,aAAU","ignoreList":[]}

package/lib/module/package.json

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

package/lib/module/types.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=types.js.map

package/lib/module/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../src","sources":["types.ts"],"mappings":"","ignoreList":[]}

package/lib/typescript/package.json

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