@trainstar/synchro-react-native 0.1.2 → 0.3.1

package/lib/module/hooks/useSyncStatus.js

@@ -1,15 +1,60 @@
 "use strict";
 
 import { useState, useEffect } from 'react';
+import { mapNativeError } from "../errors.js";
+const uninitialized = {
+  status: 'uninitialized',
+  retryAt: null,
+  operation: null,
+  failure: null
+};
 export function useSyncStatus(client) {
-  const [status, setStatus] = useState({
-    status: 'idle',
-    retryAt: null
+  const [snapshot, setSnapshot] = useState({
+    client,
+    status: uninitialized,
+    error: null
   });
   useEffect(() => {
-    const unsubscribe = client.onStatusChange(setStatus);
-    return unsubscribe;
+    let active = true;
+    let receivedEvent = false;
+    setSnapshot({
+      client,
+      status: uninitialized,
+      error: null
+    });
+    const unsubscribe = client.onStatusChange(status => {
+      if (!active) return;
+      receivedEvent = true;
+      setSnapshot({
+        client,
+        status,
+        error: null
+      });
+    });
+    client.getSyncStatus().then(status => {
+      if (active && !receivedEvent) {
+        setSnapshot({
+          client,
+          status,
+          error: null
+        });
+      }
+    }, error => {
+      if (active && !receivedEvent) {
+        setSnapshot({
+          client,
+          status: uninitialized,
+          error: mapNativeError(error)
+        });
+      }
+    });
+    return () => {
+      active = false;
+      unsubscribe();
+    };
   }, [client]);
-  return status;
+  if (snapshot.client !== client) return uninitialized;
+  if (snapshot.error) throw snapshot.error;
+  return snapshot.status;
 }
 //# sourceMappingURL=useSyncStatus.js.map

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

@@ -1 +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":[]}
+{"version":3,"names":["useState","useEffect","mapNativeError","uninitialized","status","retryAt","operation","failure","useSyncStatus","client","snapshot","setSnapshot","error","active","receivedEvent","unsubscribe","onStatusChange","getSyncStatus","then"],"sourceRoot":"../../../src","sources":["hooks/useSyncStatus.ts"],"mappings":";;AAAA,SAASA,QAAQ,EAAEC,SAAS,QAAQ,OAAO;AAG3C,SAASC,cAAc,QAA2B,cAAW;AAE7D,MAAMC,aAAyB,GAAG;EAChCC,MAAM,EAAE,eAAe;EACvBC,OAAO,EAAE,IAAI;EACbC,SAAS,EAAE,IAAI;EACfC,OAAO,EAAE;AACX,CAAC;AAED,OAAO,SAASC,aAAaA,CAACC,MAAqB,EAAc;EAC/D,MAAM,CAACC,QAAQ,EAAEC,WAAW,CAAC,GAAGX,QAAQ,CAIrC;IAAES,MAAM;IAAEL,MAAM,EAAED,aAAa;IAAES,KAAK,EAAE;EAAK,CAAC,CAAC;EAElDX,SAAS,CAAC,MAAM;IACd,IAAIY,MAAM,GAAG,IAAI;IACjB,IAAIC,aAAa,GAAG,KAAK;IACzBH,WAAW,CAAC;MAAEF,MAAM;MAAEL,MAAM,EAAED,aAAa;MAAES,KAAK,EAAE;IAAK,CAAC,CAAC;IAC3D,MAAMG,WAAW,GAAGN,MAAM,CAACO,cAAc,CAAEZ,MAAM,IAAK;MACpD,IAAI,CAACS,MAAM,EAAE;MACbC,aAAa,GAAG,IAAI;MACpBH,WAAW,CAAC;QAAEF,MAAM;QAAEL,MAAM;QAAEQ,KAAK,EAAE;MAAK,CAAC,CAAC;IAC9C,CAAC,CAAC;IACFH,MAAM,CAACQ,aAAa,CAAC,CAAC,CAACC,IAAI,CACxBd,MAAM,IAAK;MACV,IAAIS,MAAM,IAAI,CAACC,aAAa,EAAE;QAC5BH,WAAW,CAAC;UAAEF,MAAM;UAAEL,MAAM;UAAEQ,KAAK,EAAE;QAAK,CAAC,CAAC;MAC9C;IACF,CAAC,EACAA,KAAc,IAAK;MAClB,IAAIC,MAAM,IAAI,CAACC,aAAa,EAAE;QAC5BH,WAAW,CAAC;UAAEF,MAAM;UAAEL,MAAM,EAAED,aAAa;UAAES,KAAK,EAAEV,cAAc,CAACU,KAAK;QAAE,CAAC,CAAC;MAC9E;IACF,CACF,CAAC;IACD,OAAO,MAAM;MACXC,MAAM,GAAG,KAAK;MACdE,WAAW,CAAC,CAAC;IACf,CAAC;EACH,CAAC,EAAE,CAACN,MAAM,CAAC,CAAC;EAEZ,IAAIC,QAAQ,CAACD,MAAM,KAAKA,MAAM,EAAE,OAAON,aAAa;EACpD,IAAIO,QAAQ,CAACE,KAAK,EAAE,MAAMF,QAAQ,CAACE,KAAK;EACxC,OAAOF,QAAQ,CAACN,MAAM;AACxB","ignoreList":[]}

package/lib/module/index.js

@@ -4,5 +4,6 @@ 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";
+export { SYNC_STATUS_TYPES, SYNC_OPERATION_KINDS, SYNC_RECOVERY_ACTIONS, SYNC_FAILURE_CODES, PROTOCOL_ERROR_CODES } from "./types.js";
+export { SynchroError, NotConnectedError, SchemaNotLoadedError, TableNotSyncedError, UpgradeRequiredError, SchemaMismatchError, PushRejectedError, NetworkError, ServerError, ProtocolError, SyncBlockedError, UnsupportedSchemaError, InvalidStateTransitionError, DatabaseError, InvalidResponseError, InvalidSeedError, AlreadyStartedError, NotStartedError, TransactionTimeoutError, NATIVE_ERROR_CODES, mapNativeError } from "./errors.js";
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +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":[]}
+{"version":3,"names":["SynchroClient","useQuery","useSyncStatus","usePendingChanges","SYNC_STATUS_TYPES","SYNC_OPERATION_KINDS","SYNC_RECOVERY_ACTIONS","SYNC_FAILURE_CODES","PROTOCOL_ERROR_CODES","SynchroError","NotConnectedError","SchemaNotLoadedError","TableNotSyncedError","UpgradeRequiredError","SchemaMismatchError","PushRejectedError","NetworkError","ServerError","ProtocolError","SyncBlockedError","UnsupportedSchemaError","InvalidStateTransitionError","DatabaseError","InvalidResponseError","InvalidSeedError","AlreadyStartedError","NotStartedError","TransactionTimeoutError","NATIVE_ERROR_CODES","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;AA0C7D,SACEC,iBAAiB,EACjBC,oBAAoB,EACpBC,qBAAqB,EACrBC,kBAAkB,EAClBC,oBAAoB,QACf,YAAS;AAEhB,SACEC,YAAY,EACZC,iBAAiB,EACjBC,oBAAoB,EACpBC,mBAAmB,EACnBC,oBAAoB,EACpBC,mBAAmB,EACnBC,iBAAiB,EACjBC,YAAY,EACZC,WAAW,EACXC,aAAa,EACbC,gBAAgB,EAChBC,sBAAsB,EACtBC,2BAA2B,EAC3BC,aAAa,EACbC,oBAAoB,EACpBC,gBAAgB,EAChBC,mBAAmB,EACnBC,eAAe,EACfC,uBAAuB,EACvBC,kBAAkB,EAClBC,cAAc,QACT,aAAU","ignoreList":[]}

package/lib/module/inspection.js

@@ -0,0 +1,121 @@
+"use strict";
+
+import { configureInspection, nativeForInspection, parseClientStateInspection, parseTransportObservationSnapshot } from "./SynchroClient.js";
+import { InvalidResponseError, mapNativeError } from "./errors.js";
+const TRANSPORT_OPERATION_CLASSES = ['connect', 'pull', 'push', 'checkpoint', 'schemas', 'rebuild', 'other'];
+export class SynchroInspection {
+  constructor(client, options = {}) {
+    this.client = client;
+    configureInspection(client, options.transportObservationCapacity ?? 0, options.requireNewDatabase ?? false);
+  }
+  async clientState() {
+    try {
+      return parseClientStateInspection(parseJSON(await nativeForInspection(this.client).inspectClientState()));
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+  }
+  async durableState(tableName, recordID) {
+    if (tableName.length === 0 || recordID.length === 0) {
+      throw new InvalidResponseError('Durable-state identity is invalid');
+    }
+    try {
+      return parseDurableState(parseJSON(await nativeForInspection(this.client).inspectDurableState(tableName, recordID)));
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+  }
+  async processIdentity() {
+    try {
+      const value = await nativeForInspection(this.client).getProcessIdentity();
+      if (!/^(?:ios|android)-app:[1-9][0-9]*$/.test(value)) {
+        throw new InvalidResponseError('Native bridge returned invalid process identity');
+      }
+      return value;
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+  }
+  async transportObservations() {
+    try {
+      return parseTransportObservationSnapshot(parseJSON(await nativeForInspection(this.client).inspectTransportObservations()));
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+  }
+  async armTransportPause(operationClass) {
+    requireTransportOperationClass(operationClass);
+    try {
+      await nativeForInspection(this.client).armTransportPause(operationClass);
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+  }
+  async awaitTransportPause(operationClass, timeoutMs) {
+    requireTransportOperationClass(operationClass);
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 60_000) {
+      throw new InvalidResponseError('Transport pause request is invalid');
+    }
+    try {
+      await nativeForInspection(this.client).awaitTransportPause(operationClass, timeoutMs);
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+  }
+  async resumeTransportPause() {
+    try {
+      await nativeForInspection(this.client).resumeTransportPause();
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+  }
+}
+function parseJSON(source) {
+  try {
+    return JSON.parse(source);
+  } catch {
+    throw new InvalidResponseError('Native bridge returned malformed inspection JSON');
+  }
+}
+function parseDurableState(value) {
+  const proof = requireRecord(value, 'durable state');
+  if (Object.keys(proof).length !== 2 || !Object.prototype.hasOwnProperty.call(proof, 'row_metadata') || !Array.isArray(proof.rebuild_receipts)) {
+    throw new InvalidResponseError('Native bridge returned invalid durable state');
+  }
+  if (proof.row_metadata !== null) {
+    const metadata = requireRecord(proof.row_metadata, 'row metadata');
+    if (Object.keys(metadata).length !== 4 || typeof metadata.table_name !== 'string' || typeof metadata.record_id !== 'string' || typeof metadata.server_version !== 'string' || metadata.row_checksum !== null && typeof metadata.row_checksum !== 'string') {
+      throw new InvalidResponseError('Native bridge returned invalid row metadata');
+    }
+  }
+  for (const receiptValue of proof.rebuild_receipts) {
+    const receipt = requireRecord(receiptValue, 'rebuild receipt');
+    if (Object.keys(receipt).length !== 12 || typeof receipt.rebuild_id_fingerprint !== 'string' || !isNonnegativeSafeInteger(receipt.page_count) || !isNonnegativeSafeInteger(receipt.returned_record_count) || !isStringArray(receipt.request_chain_expected) || !isStringArray(receipt.request_chain_observed) || !isStringArray(receipt.record_identities_hex) || !isStringArray(receipt.received_row_checksums) || !isStringArray(receipt.computed_row_checksums) || !isNullableString(receipt.computed_scope_checksum) || !isNullableString(receipt.final_scope_checksum) || !isNullableString(receipt.stored_scope_checksum) || !isNullableString(receipt.local_scope_checksum)) {
+      throw new InvalidResponseError('Native bridge returned invalid rebuild receipt');
+    }
+  }
+  return proof;
+}
+function requireRecord(value, name) {
+  if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+    throw new InvalidResponseError(`Native bridge returned invalid ${name}`);
+  }
+  return value;
+}
+function isNonnegativeSafeInteger(value) {
+  return typeof value === 'number' && Number.isSafeInteger(value) && value >= 0;
+}
+function isStringArray(value) {
+  return Array.isArray(value) && value.every(item => typeof item === 'string');
+}
+function isNullableString(value) {
+  return value === null || typeof value === 'string';
+}
+function requireTransportOperationClass(value) {
+  if (!TRANSPORT_OPERATION_CLASSES.includes(value)) {
+    throw new InvalidResponseError('Transport operation class is invalid');
+  }
+}
+export { sha256Hex } from "./digest.js";
+export { isCanonicalBase64Url, isCanonicalInt64 } from "./sqliteValues.js";
+//# sourceMappingURL=inspection.js.map

package/lib/module/inspection.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["configureInspection","nativeForInspection","parseClientStateInspection","parseTransportObservationSnapshot","InvalidResponseError","mapNativeError","TRANSPORT_OPERATION_CLASSES","SynchroInspection","constructor","client","options","transportObservationCapacity","requireNewDatabase","clientState","parseJSON","inspectClientState","error","durableState","tableName","recordID","length","parseDurableState","inspectDurableState","processIdentity","value","getProcessIdentity","test","transportObservations","inspectTransportObservations","armTransportPause","operationClass","requireTransportOperationClass","awaitTransportPause","timeoutMs","Number","isSafeInteger","resumeTransportPause","source","JSON","parse","proof","requireRecord","Object","keys","prototype","hasOwnProperty","call","Array","isArray","rebuild_receipts","row_metadata","metadata","table_name","record_id","server_version","row_checksum","receiptValue","receipt","rebuild_id_fingerprint","isNonnegativeSafeInteger","page_count","returned_record_count","isStringArray","request_chain_expected","request_chain_observed","record_identities_hex","received_row_checksums","computed_row_checksums","isNullableString","computed_scope_checksum","final_scope_checksum","stored_scope_checksum","local_scope_checksum","name","every","item","includes","sha256Hex","isCanonicalBase64Url","isCanonicalInt64"],"sourceRoot":"../../src","sources":["inspection.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/sqliteValues.js

@@ -0,0 +1,87 @@
+"use strict";
+
+const MIN_INT64 = -(BigInt(1) << BigInt(63));
+const MAX_INT64 = (BigInt(1) << BigInt(63)) - BigInt(1);
+const BASE64URL_ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_';
+function base64urlValue(character) {
+  return BASE64URL_ALPHABET.indexOf(character);
+}
+
+/** Validate an unpadded, canonical RFC 4648 base64url string. */
+export function isCanonicalBase64Url(value) {
+  if (!/^[A-Za-z0-9_-]*$/.test(value) || value.length % 4 === 1) {
+    return false;
+  }
+  const remainder = value.length % 4;
+  if (remainder === 2) {
+    const last = base64urlValue(value[value.length - 1]);
+    return (last & 0x0f) === 0;
+  }
+  if (remainder === 3) {
+    const last = base64urlValue(value[value.length - 1]);
+    return (last & 0x03) === 0;
+  }
+  return true;
+}
+export function isCanonicalInt64(value) {
+  if (!/^(?:0|-?[1-9][0-9]*)$/.test(value)) {
+    return false;
+  }
+  try {
+    const parsed = BigInt(value);
+    return parsed >= MIN_INT64 && parsed <= MAX_INT64 && parsed.toString() === value;
+  } catch {
+    return false;
+  }
+}
+function invalidBindValue(index, reason) {
+  return new TypeError(`Invalid SQL bind value at index ${index}: ${reason}`);
+}
+
+/** Reject malformed tagged values before they cross the native bridge. */
+export function assertValidSQLiteBindValue(value, index) {
+  if (value === null || typeof value === 'string' || typeof value === 'boolean') {
+    return;
+  }
+  if (typeof value === 'number') {
+    if (!Number.isFinite(value)) {
+      throw invalidBindValue(index, 'number must be finite');
+    }
+    if (Number.isInteger(value) && Math.abs(value) > Number.MAX_SAFE_INTEGER) {
+      throw invalidBindValue(index, 'integer is outside the safe range');
+    }
+    return;
+  }
+  if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+    throw invalidBindValue(index, 'unsupported value type');
+  }
+  const keys = Object.keys(value);
+  if (keys.length !== 2 || !keys.includes('type')) {
+    throw invalidBindValue(index, 'tag must contain exactly type and payload fields');
+  }
+  const tagged = value;
+  if (tagged.type === 'bytes') {
+    if (keys.length !== 2 || !keys.includes('base64') || typeof tagged.base64 !== 'string') {
+      throw invalidBindValue(index, 'bytes tag must contain a base64 string');
+    }
+    if (!isCanonicalBase64Url(tagged.base64)) {
+      throw invalidBindValue(index, 'bytes tag must use canonical base64url');
+    }
+    return;
+  }
+  if (tagged.type === 'int64') {
+    if (keys.length !== 2 || !keys.includes('value') || typeof tagged.value !== 'string') {
+      throw invalidBindValue(index, 'int64 tag must contain a signed decimal string');
+    }
+    if (!isCanonicalInt64(tagged.value)) {
+      throw invalidBindValue(index, 'int64 tag must contain a canonical signed int64');
+    }
+    return;
+  }
+  throw invalidBindValue(index, 'unknown SQL bind tag');
+}
+export function assertValidSQLiteBindParams(values) {
+  values.forEach((value, index) => assertValidSQLiteBindValue(value, index));
+  return values;
+}
+//# sourceMappingURL=sqliteValues.js.map

package/lib/module/sqliteValues.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MIN_INT64","BigInt","MAX_INT64","BASE64URL_ALPHABET","base64urlValue","character","indexOf","isCanonicalBase64Url","value","test","length","remainder","last","isCanonicalInt64","parsed","toString","invalidBindValue","index","reason","TypeError","assertValidSQLiteBindValue","Number","isFinite","isInteger","Math","abs","MAX_SAFE_INTEGER","Array","isArray","keys","Object","includes","tagged","type","base64","assertValidSQLiteBindParams","values","forEach"],"sourceRoot":"../../src","sources":["sqliteValues.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/types.js

@@ -1,2 +1,12 @@
 "use strict";
+
+/** A lossless SQLite BLOB value at the React Native boundary. */
+
+/** A lossless SQLite INTEGER value outside JavaScript's safe integer range. */
+
+export const SYNC_STATUS_TYPES = ['uninitialized', 'local_ready', 'connecting', 'schema_applying', 'ready', 'pushing', 'pulling', 'rebuilding', 'backoff', 'error', 'stopped'];
+export const SYNC_OPERATION_KINDS = ['opening', 'connecting', 'schema', 'pushing', 'pulling', 'rebuilding', 'lifecycle', 'database'];
+export const SYNC_RECOVERY_ACTIONS = ['retry', 'schema_reset', 'none'];
+export const SYNC_FAILURE_CODES = ['auth_required', 'client_retired', 'idempotency_conflict', 'invalid_request', 'invalid_response', 'invalid_schema_reference', 'invalid_state_transition', 'local_database', 'schema_application_failed', 'sync_integrity_failure', 'unsupported_schema', 'upgrade_required', 'schema_mismatch', 'server_error', 'network_error', 'database_error', 'local_failure'];
+export const PROTOCOL_ERROR_CODES = ['invalid_request', 'invalid_schema_reference', 'upgrade_required', 'auth_required', 'idempotency_conflict', 'client_retired', 'client_generation_expired', 'rebuild_restart_required', 'schema_mismatch', 'retry_later', 'sync_integrity_failure', 'capture_pending', 'temporary_unavailable'];
 //# sourceMappingURL=types.js.map

package/lib/module/types.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sourceRoot":"../../src","sources":["types.ts"],"mappings":"","ignoreList":[]}
+{"version":3,"names":["SYNC_STATUS_TYPES","SYNC_OPERATION_KINDS","SYNC_RECOVERY_ACTIONS","SYNC_FAILURE_CODES","PROTOCOL_ERROR_CODES"],"sourceRoot":"../../src","sources":["types.ts"],"mappings":";;AAEA;;AAMA;;AA6CA,OAAO,MAAMA,iBAAiB,GAAG,CAC/B,eAAe,EACf,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,OAAO,EACP,SAAS,EACT,SAAS,EACT,YAAY,EACZ,SAAS,EACT,OAAO,EACP,SAAS,CACD;AAIV,OAAO,MAAMC,oBAAoB,GAAG,CAClC,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,UAAU,CACF;AAIV,OAAO,MAAMC,qBAAqB,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,CAAU;AAI/E,OAAO,MAAMC,kBAAkB,GAAG,CAChC,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,0BAA0B,EAC1B,0BAA0B,EAC1B,gBAAgB,EAChB,2BAA2B,EAC3B,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,CACP;AAIV,OAAO,MAAMC,oBAAoB,GAAG,CAClC,iBAAiB,EACjB,0BAA0B,EAC1B,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,2BAA2B,EAC3B,0BAA0B,EAC1B,iBAAiB,EACjB,aAAa,EACb,wBAAwB,EACxB,iBAAiB,EACjB,uBAAuB,CACf","ignoreList":[]}

package/lib/typescript/example/e2e/corpus-harness.d.ts

@@ -0,0 +1,34 @@
+import { device } from 'detox';
+type LaunchOptions = Parameters<typeof device.launchApp>[0];
+type ExchangeResponse = {
+    schema_version: number;
+    sequence: number;
+} & ({
+    state: 'command';
+    command: Record<string, unknown>;
+} | {
+    state: 'complete';
+    command: null;
+});
+type ConformanceEnvelope = {
+    schema_version: number;
+    outcome: 'passed' | 'error';
+    result: unknown;
+    error_code: string | null;
+    error_detail: string | null;
+};
+export declare function coordinatorConfiguration(): {
+    endpoint: string;
+    token: string;
+};
+export declare function coordinatorCount(name: 'STAGE_COUNT' | 'EXCHANGE_COUNT', minimum: number, maximum?: number): number;
+export declare function exchange(endpoint: string, token: string, sequence: number, rawResult: string): Promise<ExchangeResponse>;
+export declare function pollCorpusResult(timeoutMs: number, timeoutMessage: string): Promise<{
+    raw: string;
+    envelope: ConformanceEnvelope;
+}>;
+export declare function runCorpusCommandLoop(execute: () => Promise<void>): Promise<void>;
+export declare function launchCorpusApp(options: LaunchOptions): Promise<void>;
+export declare function submitCorpusCommand(serialized: string): Promise<void>;
+export {};
+//# sourceMappingURL=corpus-harness.d.ts.map

package/lib/typescript/example/e2e/corpus-harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"corpus-harness.d.ts","sourceRoot":"","sources":["../../../../example/e2e/corpus-harness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,MAAM,EAAoB,MAAM,OAAO,CAAC;AAErD,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AAE5D,KAAK,gBAAgB,GAAG;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,CACnE;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACtD;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,CACvC,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC;AAYF,wBAAgB,wBAAwB,IAAI;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAqB9E;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,aAAa,GAAG,gBAAgB,EACtC,OAAO,EAAE,MAAM,EACf,OAAO,SAA0B,GAChC,MAAM,CAMR;AAqDD,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,gBAAgB,CAAC,CAyB3B;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,mBAAmB,CAAA;CAAE,CAAC,CAkBzD;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAOtF;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAI3E;AAED,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAa3E"}

package/lib/typescript/example/src/conformance/runner.d.ts

@@ -0,0 +1,125 @@
+import type { ClientStateInspection, DurableStateInspection, ScopeRowInspection, TransportObservationSnapshot } from '@trainstar/synchro-react-native/inspection';
+import type { PendingMutationInspection, RejectedMutationInspection, Row } from '@trainstar/synchro-react-native';
+import type { ConformanceCommand, ConformanceErrorCode, JSONScalar, LifecycleOperation, SynchronizeCompletion } from './types';
+export declare class ConformanceUnavailableError extends Error {
+    constructor(message: string);
+}
+export declare class ConformanceCommandError extends Error {
+    readonly code: ConformanceErrorCode;
+    constructor(code: ConformanceErrorCode, cause?: unknown);
+}
+export type RawSyncStatus = {
+    state: string;
+    retry_at: string | null;
+    operation: string | null;
+    failure: RawFailure | null;
+};
+export type RawFailure = {
+    operation: string;
+    code: string;
+    retryable: boolean;
+    recovery_action: string;
+};
+export type RawProcessIdentity = {
+    process_id: string;
+    database_identity_fingerprint: string;
+};
+export type RawEvent = Record<string, JSONScalar | Record<string, JSONScalar> | null>;
+export type ConformanceActionResult = {
+    kind: 'opened';
+    status: RawSyncStatus;
+    process: RawProcessIdentity;
+} | {
+    kind: 'local-action';
+    rows_affected: number;
+    process: RawProcessIdentity;
+} | {
+    kind: 'synchronized';
+    completion: SynchronizeCompletion;
+    status: RawSyncStatus;
+    process: RawProcessIdentity;
+} | {
+    kind: 'call-begun';
+    call_id: string;
+    state: 'in_flight';
+    process: RawProcessIdentity;
+} | {
+    kind: 'call-completed';
+    call_id: string;
+    state: 'completed';
+    completion: SynchronizeCompletion;
+    status: RawSyncStatus;
+    process: RawProcessIdentity;
+} | {
+    kind: 'awaited';
+    status: RawSyncStatus;
+    process: RawProcessIdentity;
+} | {
+    kind: 'lifecycle';
+    operation: LifecycleOperation;
+    status: RawSyncStatus;
+    process: RawProcessIdentity;
+} | {
+    kind: 'capture';
+    capture: ConformanceCapture;
+    process: RawProcessIdentity;
+};
+export interface ConformanceCapture {
+    application_rows?: Row[];
+    pending_mutations?: PendingMutationInspection[];
+    rejected_mutations?: RejectedMutationInspection[];
+    client_state?: ClientStateInspection;
+    durable_proof?: RawDurableProof;
+    provenance?: ScopeRowInspection[];
+    request_trace?: TransportObservationSnapshot;
+    sync_status?: RawSyncStatus;
+    sync_events?: RawEvent[];
+}
+export interface RawDurableProof {
+    row_metadata: DurableStateInspection['row_metadata'];
+    rebuild_receipt_proofs: Array<{
+        rebuild_id_fingerprint: string;
+        page_count: number;
+        returned_record_count: number;
+        request_chain_valid: boolean;
+        records_in_canonical_order: boolean;
+        row_checksums_valid: boolean;
+        scope_checksum_valid: boolean;
+        final_checksum_matches_local: boolean;
+    }>;
+}
+export interface PublicConformanceRunnerOptions {
+    serverURL: string;
+    authToken: string;
+    appVersion: string;
+}
+/**
+ * PublicConformanceRunner maps one closed host action to public JavaScript APIs.
+ * It returns raw facts only. It does not load scenarios or evaluate outcomes.
+ */
+export declare class PublicConformanceRunner {
+    private readonly options;
+    private readonly sessions;
+    private readonly calls;
+    private activeClientKey;
+    constructor(options: PublicConformanceRunnerOptions);
+    execute(command: ConformanceCommand): Promise<ConformanceActionResult>;
+    close(): Promise<void>;
+    private open;
+    private executeLocalAction;
+    private executeLocalActions;
+    private synchronize;
+    private beginCall;
+    private awaitCall;
+    private lifecycle;
+    private awaitStep;
+    private capture;
+    private activate;
+    private requireSession;
+    private requireInspection;
+    private invokeSynchronizeMethod;
+    private waitForCompletion;
+    private processIdentity;
+    private boundedResult;
+}
+//# sourceMappingURL=runner.d.ts.map

package/lib/typescript/example/src/conformance/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../../../example/src/conformance/runner.ts"],"names":[],"mappings":"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"}

package/lib/typescript/example/src/conformance/types.d.ts

@@ -0,0 +1,71 @@
+export type JSONScalar = null | boolean | number | string;
+export type JSONValue = JSONScalar | JSONValue[] | {
+    [key: string]: JSONValue;
+};
+export type JSONObject = {
+    [key: string]: JSONValue;
+};
+export declare const MAXIMUM_COMMAND_BYTES: number;
+export declare const MAXIMUM_RESULT_BYTES: number;
+export declare const MAXIMUM_JSON_DEPTH = 24;
+export declare const MAXIMUM_OBJECT_KEYS = 256;
+export declare const MAXIMUM_ARRAY_ITEMS = 512;
+export declare const MAXIMUM_VALUE_BYTES: number;
+export type SynchronizeMethod = 'start' | 'sync-now' | 'retry-after-error' | 'reset-schema-and-start';
+export type SynchronizeCompletion = 'idle' | 'blocked' | 'error';
+export type LifecycleOperation = 'stop' | 'enter-background' | 'enter-foreground';
+export interface ScenarioOperation {
+    contract_operation: string;
+    name: string;
+    payload: JSONObject;
+}
+export interface ScenarioStep {
+    operation: ScenarioOperation;
+}
+export interface RowSelector {
+    table_name: string;
+    primary_key_field: string;
+    primary_key: JSONScalar;
+}
+export interface ConformanceAction {
+    actor: string;
+    command: string;
+    parameters: JSONObject;
+}
+export interface NativeManifestAction {
+    action: ConformanceAction;
+    steps: ScenarioStep[];
+}
+export interface ConformanceRuntime {
+    client_key: string;
+    database_path: string;
+    client_id: string;
+    seed_database_path?: string;
+    server_url?: string;
+    auth_token?: string;
+    pull_page_size?: number;
+    push_batch_size?: number;
+}
+export interface ConformanceCommand {
+    schema_version: 1;
+    action: NativeManifestAction;
+    runtime: ConformanceRuntime;
+}
+export type ConformanceErrorCode = 'invalid_command' | 'unavailable' | 'execution_failed' | 'capture_query_failed' | 'capture_row_cardinality' | 'capture_inspection_failed';
+export interface ConformanceEnvelope {
+    schema_version: 1;
+    outcome: 'passed' | 'error';
+    result: JSONValue | null;
+    error_code: ConformanceErrorCode | null;
+    error_detail: string | null;
+}
+export declare function isSynchronizeMethod(value: unknown): value is SynchronizeMethod;
+export declare function isLifecycleOperation(value: unknown): value is LifecycleOperation;
+export declare function isCallID(value: unknown): value is string;
+/** Parses one sanitized host command without loading scenario identity or expectations. */
+export declare function parseConformanceCommand(source: string): ConformanceCommand;
+export declare function decodeConformanceCommand(value: unknown): ConformanceCommand;
+export declare function encodeConformanceEnvelope(envelope: ConformanceEnvelope): string;
+export declare function assertBoundedJSON(value: unknown, maximumBytes: number): void;
+export declare function utf8ByteLength(value: string): number;
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/example/src/conformance/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../example/src/conformance/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAC1D,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAChF,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtD,eAAO,MAAM,qBAAqB,QAAc,CAAC;AACjD,eAAO,MAAM,oBAAoB,QAAc,CAAC;AAChD,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,mBAAmB,QAAc,CAAC;AAE/C,MAAM,MAAM,iBAAiB,GACzB,OAAO,GACP,UAAU,GACV,mBAAmB,GACnB,wBAAwB,CAAC;AAC7B,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AACjE,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;AAElF,MAAM,WAAW,iBAAiB;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,iBAAiB,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,CAAC,CAAC;IAClB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,OAAO,EAAE,kBAAkB,CAAC;CAC7B;AAED,MAAM,MAAM,oBAAoB,GAC5B,iBAAiB,GACjB,aAAa,GACb,kBAAkB,GAClB,sBAAsB,GACtB,yBAAyB,GACzB,2BAA2B,CAAC;AAEhC,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,CAAC,CAAC;IAClB,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC5B,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAGxC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAeD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAE9E;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAEhF;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AA8HD,2FAA2F;AAC3F,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAM1E;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAY3E;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,CAe/E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAoC5E;AAwED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAepD"}