@trainstar/synchro-react-native 0.1.1 → 0.3.1

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

@@ -1,4 +1,16 @@
 export type Row = Record<string, unknown>;
+/** A lossless SQLite BLOB value at the React Native boundary. */
+export interface SQLiteBytes {
+    readonly type: 'bytes';
+    readonly base64: string;
+}
+/** A lossless SQLite INTEGER value outside JavaScript's safe integer range. */
+export interface SQLiteInt64 {
+    readonly type: 'int64';
+    readonly value: string;
+}
+export type SQLiteTaggedValue = SQLiteBytes | SQLiteInt64;
+export type SQLiteBindValue = null | string | number | boolean | SQLiteTaggedValue;
 export interface ExecResult {
     rowsAffected: number;
 }
@@ -7,7 +19,7 @@ export interface BatchResult {
 }
 export interface SQLStatement {
     sql: string;
-    params?: unknown[];
+    params?: readonly SQLiteBindValue[];
 }
 export interface ColumnDef {
     name: string;
@@ -20,17 +32,195 @@ export interface TableOptions {
     ifNotExists?: boolean;
     withoutRowid?: boolean;
 }
-export interface Transaction {
-    query(sql: string, params?: unknown[]): Promise<Row[]>;
-    queryOne(sql: string, params?: unknown[]): Promise<Row | null>;
-    execute(sql: string, params?: unknown[]): Promise<ExecResult>;
+export interface ReadTransaction {
+    query(sql: string, params?: readonly SQLiteBindValue[]): Promise<Row[]>;
+    queryOne(sql: string, params?: readonly SQLiteBindValue[]): Promise<Row | null>;
+}
+export interface Transaction extends ReadTransaction {
+    execute(sql: string, params?: readonly SQLiteBindValue[]): Promise<ExecResult>;
+}
+export declare const SYNC_STATUS_TYPES: readonly ["uninitialized", "local_ready", "connecting", "schema_applying", "ready", "pushing", "pulling", "rebuilding", "backoff", "error", "stopped"];
+export type SyncStatusType = (typeof SYNC_STATUS_TYPES)[number];
+export declare const SYNC_OPERATION_KINDS: readonly ["opening", "connecting", "schema", "pushing", "pulling", "rebuilding", "lifecycle", "database"];
+export type SyncOperationKind = (typeof SYNC_OPERATION_KINDS)[number];
+export declare const SYNC_RECOVERY_ACTIONS: readonly ["retry", "schema_reset", "none"];
+export type SyncRecoveryAction = (typeof SYNC_RECOVERY_ACTIONS)[number];
+export declare const SYNC_FAILURE_CODES: readonly ["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 type SyncFailureCode = (typeof SYNC_FAILURE_CODES)[number];
+export declare const PROTOCOL_ERROR_CODES: readonly ["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"];
+export type ProtocolErrorCode = (typeof PROTOCOL_ERROR_CODES)[number];
+export interface SyncFailure {
+    operation: SyncOperationKind;
+    code: SyncFailureCode;
+    retryable: boolean;
+    message: string;
+    recoveryAction: SyncRecoveryAction;
+    metadata: Record<string, string>;
+}
+type DetailFreeSyncStatus = {
+    [K in Exclude<SyncStatusType, 'backoff' | 'error'>]: {
+        status: K;
+        retryAt: null;
+        operation: null;
+        failure: null;
+    };
+}[Exclude<SyncStatusType, 'backoff' | 'error'>];
+export type SyncStatus = DetailFreeSyncStatus | {
+    status: 'backoff';
+    retryAt: Date;
+    operation: SyncOperationKind;
+    failure: null;
+} | {
+    status: 'error';
+    retryAt: null;
+    operation: null;
+    failure: SyncFailure;
+};
+export type JSONValue = null | boolean | number | string | JSONValue[] | {
+    [key: string]: JSONValue;
+};
+export type MutationOperation = 'insert' | 'upsert' | 'update' | 'delete';
+export type LocalMutationStatus = 'pending' | 'sealed' | 'superseded_before_send' | 'cancelled_before_send' | 'blocked_by_predecessor' | 'server_rejected';
+export type MutationStatus = 'applied' | 'conflict' | 'rejected_terminal';
+export type MutationRejectionCode = 'version_conflict' | 'row_already_exists' | 'row_deleted' | 'row_not_found' | 'schema_incompatible' | 'policy_rejected' | 'validation_failed' | 'table_not_synced';
+export interface SchemaRef {
+    version: number;
+    hash: string;
+}
+export interface AuthoredMutationField {
+    fieldID: string;
+    logicalType: string;
+    value: JSONValue;
+}
+export interface PendingMutationInspection {
+    mutationID: string;
+    localOrder: number;
+    tableID: string;
+    tableName: string;
+    recordID: string;
+    primaryKeyFieldID: string;
+    primaryKeyLogicalType: string;
+    operation: MutationOperation;
+    authoredSchema: SchemaRef;
+    baseVersion: string | null;
+    clientVersion: string;
+    status: LocalMutationStatus;
+    sourceKind: string;
+    dependsOnMutationID: string | null;
+    normalizedMutationID: string | null;
+    sealedBatchID: string | null;
+    sealedOrdinal: number | null;
+    authoredFields: AuthoredMutationField[];
+}
+export interface RejectedMutationInspection {
+    mutationID: string;
+    tableName: string;
+    recordID: string;
+    status: MutationStatus;
+    code: MutationRejectionCode;
+    message: string | null;
+    serverRowJSON: string | null;
+    serverVersion: string | null;
+    mutationJSON: string;
+    rejectionJSON: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ScopeStateInspection {
+    scopeID: string;
+    cursor: string | null;
+    checksum: string | null;
+    localChecksum: string;
+    generation: number;
+}
+export interface ScopeRowInspection {
+    scopeID: string;
+    tableName: string;
+    recordID: string;
+    checksum: string;
+    generation: number;
+}
+export interface RebuildAttemptInspection {
+    scopeID: string;
+    rebuildID: string;
+    clientGeneration: number;
+    schemaVersion: number;
+    schemaHash: string;
+    generation: number;
+    cursor: string | null;
+    pageLimit: number;
+}
+export interface ClientStateInspection {
+    schema: SchemaRef | null;
+    scopeStates: ScopeStateInspection[];
+    scopeRows: ScopeRowInspection[];
+    rebuildAttempts: RebuildAttemptInspection[];
+    applicationRowCount: number;
+    mutationLedgerCount: number;
+    mutationOutcomeCount: number;
+    sealedBatchCount: number;
+    rejectedMutationCount: number;
+    scopeStateCount: number;
+    scopeRowCount: number;
+    provenanceCount: number;
+    rowMetadataCount: number;
+    rebuildAttemptCount: number;
+    rebuildReceiptCount: number;
+    provenanceMaintenanceWorkCursor: string;
+}
+export type TransportOperationClass = 'connect' | 'pull' | 'push' | 'checkpoint' | 'schemas' | 'rebuild' | 'other';
+export interface TransportObservation {
+    sequence: number;
+    operationClass: TransportOperationClass;
+    statusCode: number;
+    durationNanoseconds: number;
+    cursorFingerprints?: string[];
+    cursorFingerprintsComplete?: boolean;
+    requestFacts?: Record<string, JSONValue>;
+    rebuildResponseFacts?: Record<string, JSONValue>;
+    pullResponseFacts?: Record<string, JSONValue>;
+}
+export interface TransportObservationSnapshot {
+    observations: TransportObservation[];
+    overflowed: boolean;
+    sequenceCheckpoint: number;
+}
+export type SchemaAction = 'none' | 'replace' | 'rebuild_local' | 'unsupported';
+export interface SyncSchemaEvent {
+    source: SchemaRef;
+    target: SchemaRef;
+    action: SchemaAction;
+}
+export interface SyncMutationEvent {
+    mutationID: string;
+    tableID: string;
+    status: MutationStatus;
+    rejectionCode: MutationRejectionCode | null;
 }
-export type CheckpointMode = 'passive' | 'full' | 'restart' | 'truncate';
-export type SyncStatusType = 'idle' | 'connecting' | 'syncing' | 'error' | 'stopped';
-export interface SyncStatus {
-    status: SyncStatusType;
-    retryAt: Date | null;
+export interface SyncRebuildEvent {
+    scopeID: string;
+    rebuildID: string;
 }
+export type SyncEvent = {
+    type: 'state_changed';
+    from: SyncStatusType;
+    to: SyncStatusType;
+} | ({
+    type: 'backoff';
+} & {
+    operation: SyncOperationKind;
+    attempt: number;
+    retryAt: Date;
+}) | ({
+    type: 'schema_applying' | 'schema_applied';
+} & SyncSchemaEvent) | ({
+    type: 'mutation_accepted' | 'mutation_rejected';
+} & SyncMutationEvent) | ({
+    type: 'rebuild_requested' | 'rebuild_completed';
+} & SyncRebuildEvent) | {
+    type: 'failure';
+    failure: SyncFailure;
+};
 export interface ConflictEvent {
     table: string;
     recordID: string;
@@ -49,7 +239,9 @@ export interface SynchroConfig {
     maxRetryAttempts?: number;
     pullPageSize?: number;
     pushBatchSize?: number;
-    snapshotPageSize?: number;
+    seedDatabasePath?: string;
 }
 export type Unsubscribe = () => void;
+export type AsyncUnsubscribe = () => Promise<void>;
+export {};
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACvD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IAC/D,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC/D;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAEzE,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,YAAY,GACZ,SAAS,GACT,OAAO,GACP,SAAS,CAAC;AAEd,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,IAAI,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,GAAG,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,GAAG,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trainstar/synchro-react-native",
-  "version": "0.1.1",
+  "version": "0.3.1",
   "description": "React Native bridge for Synchro sync SDK",
   "source": "./src/index.ts",
   "main": "./lib/module/index.js",
@@ -11,6 +11,11 @@
       "types": "./lib/typescript/src/index.d.ts",
       "default": "./lib/module/index.js"
     },
+    "./inspection": {
+      "source": "./src/inspection.ts",
+      "types": "./lib/typescript/src/inspection.d.ts",
+      "default": "./lib/module/inspection.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -35,8 +40,9 @@
     "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
     "prepare": "bob build",
     "pack:dry-run": "npm pack --dry-run",
-    "test:unit": "jest --runInBand",
+    "test:unit": "jest --runInBand --watchman=false",
     "typecheck": "tsc",
+    "lint": "eslint src/ __tests__/ example/e2e/",
     "test": "jest"
   },
   "keywords": [
@@ -58,24 +64,29 @@
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
   },
+  "engines": {
+    "node": ">=20.19.4"
+  },
   "devDependencies": {
     "@react-native/babel-preset": "0.83.0",
     "@testing-library/react-native": "^12.4.0",
     "@types/jest": "^29.5.14",
-    "@types/react": "^19.2.0",
+    "@types/react": "^19.2.4",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
     "del-cli": "^6.0.0",
+    "eslint": "^9.0.0",
     "jest": "^29.7.0",
-    "react": "19.2.0",
+    "react": "19.2.4",
     "react-native": "0.83.0",
     "react-native-builder-bob": "^0.40.18",
-    "react-test-renderer": "^19.2.0",
+    "react-test-renderer": "^19.2.4",
     "ts-jest": "^29.1.0",
-    "turbo": "^2.5.6",
     "typescript": "^5.9.2"
   },
   "peerDependencies": {
-    "react": "*",
-    "react-native": "*"
+    "react": ">=19.2.0 <20.0.0",
+    "react-native": ">=0.83.0 <0.84.0"
   },
   "workspaces": [
     "example"
@@ -123,6 +134,7 @@
       ]
     },
     "moduleNameMapper": {
+      "^@trainstar/synchro-react-native/inspection$": "<rootDir>/src/inspection",
       "^react-native$": "<rootDir>/__tests__/__mocks__/react-native"
     },
     "modulePathIgnorePatterns": [

package/src/NativeSynchro.ts

@@ -1,21 +1,55 @@
 import type { TurboModule } from 'react-native';
-import type { EventEmitter } from 'react-native/Libraries/Types/CodegenTypes';
+import type {
+  EventEmitter,
+  UnsafeObject,
+} from 'react-native/Libraries/Types/CodegenTypes';
 import { TurboModuleRegistry } from 'react-native';
 
-type StatusEvent = { status: string; retryAt: string | null };
+// Codegen does not support a discriminated union of object and primitive
+// parameter types. UnsafeObject keeps the TurboModule boundary representable,
+// while the public client validates the tagged values before crossing it.
+type NativeSQLiteBindValue = string | number | boolean | null | UnsafeObject;
+type NativeRow = UnsafeObject;
+type NativeSQLStatement = {
+  sql: string;
+  params: ReadonlyArray<NativeSQLiteBindValue>;
+};
+type StatusEvent = {
+  status: string;
+  retryAt: string | null;
+  operation: string | null;
+  failure: UnsafeObject | null;
+};
 type ConflictEvent = {
   table: string;
   recordID: string;
   clientDataJson: string | null;
   serverDataJson: string | null;
 };
+type SyncEvent = {
+  type: string;
+  from: string | null;
+  to: string | null;
+  operation: string | null;
+  attempt: number | null;
+  retryAt: string | null;
+  source: UnsafeObject | null;
+  target: UnsafeObject | null;
+  action: string | null;
+  mutationID: string | null;
+  tableID: string | null;
+  mutationStatus: string | null;
+  rejectionCode: string | null;
+  scopeID: string | null;
+  rebuildID: string | null;
+  failure: UnsafeObject | null;
+};
 type AuthRequestEvent = { requestID: string };
-type SnapshotRequiredEvent = { requestID: string };
 type ChangeEvent = { observerID: string };
-type QueryResultEvent = { observerID: string; rowsJson: string };
+type QueryResultEvent = { observerID: string; rows: ReadonlyArray<NativeRow> };
 
 export interface Spec extends TurboModule {
-  // -- Lifecycle --
+  // Lifecycle
   initialize(config: {
     dbPath: string;
     serverURL: string;
@@ -27,40 +61,59 @@ export interface Spec extends TurboModule {
     maxRetryAttempts: number;
     pullPageSize: number;
     pushBatchSize: number;
-    snapshotPageSize: number;
+    seedDatabasePath?: string;
+    transportObservationCapacity: number;
+    requireNewDatabase: boolean;
   }): Promise<void>;
   close(): Promise<void>;
   getPath(): Promise<string>;
 
-  // -- Core SQL --
-  query(sql: string, paramsJson: string): Promise<string>;
-  queryOne(sql: string, paramsJson: string): Promise<string | null>;
+  // Core SQL
+  query(
+    sql: string,
+    params: ReadonlyArray<NativeSQLiteBindValue>
+  ): Promise<ReadonlyArray<NativeRow>>;
+  queryOne(
+    sql: string,
+    params: ReadonlyArray<NativeSQLiteBindValue>
+  ): Promise<NativeRow | null>;
   execute(
     sql: string,
-    paramsJson: string
+    params: ReadonlyArray<NativeSQLiteBindValue>
+  ): Promise<{ rowsAffected: number }>;
+  executeAuthoredWrite(
+    tableName: string,
+    operation: string,
+    columnNames: ReadonlyArray<string>,
+    sql: string,
+    values: ReadonlyArray<NativeSQLiteBindValue>
   ): Promise<{ rowsAffected: number }>;
   executeBatch(
-    statementsJson: string
+    statements: ReadonlyArray<NativeSQLStatement>
   ): Promise<{ totalRowsAffected: number }>;
 
-  // -- Transactions --
+  // Transactions
   beginWriteTransaction(): Promise<string>;
   beginReadTransaction(): Promise<string>;
-  txQuery(txID: string, sql: string, paramsJson: string): Promise<string>;
+  txQuery(
+    txID: string,
+    sql: string,
+    params: ReadonlyArray<NativeSQLiteBindValue>
+  ): Promise<ReadonlyArray<NativeRow>>;
   txQueryOne(
     txID: string,
     sql: string,
-    paramsJson: string
-  ): Promise<string | null>;
+    params: ReadonlyArray<NativeSQLiteBindValue>
+  ): Promise<NativeRow | null>;
   txExecute(
     txID: string,
     sql: string,
-    paramsJson: string
+    params: ReadonlyArray<NativeSQLiteBindValue>
   ): Promise<{ rowsAffected: number }>;
   commitTransaction(txID: string): Promise<void>;
   rollbackTransaction(txID: string): Promise<void>;
 
-  // -- Schema --
+  // Schema
   createTable(
     name: string,
     columnsJson: string,
@@ -73,7 +126,7 @@ export interface Spec extends TurboModule {
     unique: boolean
   ): Promise<void>;
 
-  // -- Observation --
+  // Observation
   addChangeObserver(
     observerID: string,
     tables: ReadonlyArray<string>
@@ -81,32 +134,46 @@ export interface Spec extends TurboModule {
   addQueryObserver(
     observerID: string,
     sql: string,
-    paramsJson: string,
+    params: ReadonlyArray<NativeSQLiteBindValue>,
     tables: ReadonlyArray<string>
   ): Promise<void>;
   removeObserver(observerID: string): Promise<void>;
 
-  // -- Sync --
-  checkpoint(mode: string): Promise<void>;
+  // Sync
   start(): Promise<void>;
   stop(): Promise<void>;
+  enterBackground(): Promise<void>;
+  enterForeground(): Promise<void>;
+  retryAfterError(): Promise<void>;
+  resetSchemaAndStart(): Promise<void>;
   syncNow(): Promise<void>;
   pendingChangeCount(): Promise<number>;
+  getSyncStatus(): Promise<string>;
+  inspectPendingMutations(): Promise<string>;
+  inspectRetainedMutations(): Promise<string>;
+  inspectRejectedMutations(): Promise<string>;
+  inspectClientState(): Promise<string>;
+  inspectDurableState(tableName: string, recordID: string): Promise<string>;
+  inspectTransportObservations(): Promise<string>;
+  armTransportPause(operationClass: string): Promise<void>;
+  awaitTransportPause(operationClass: string, timeoutMs: number): Promise<void>;
+  resumeTransportPause(): Promise<void>;
+  getProcessIdentity(): Promise<string>;
+  clearRejectedMutations(): Promise<void>;
 
-  // -- Bidirectional responses --
+  // Bidirectional responses
   resolveAuthRequest(requestID: string, token: string): void;
   rejectAuthRequest(requestID: string, error: string): void;
-  resolveSnapshotRequest(requestID: string, approved: boolean): void;
 
-  // -- Typed events --
+  // Typed events
   readonly onStatusChange: EventEmitter<StatusEvent>;
+  readonly onSyncEvent: EventEmitter<SyncEvent>;
   readonly onConflict: EventEmitter<ConflictEvent>;
   readonly onAuthRequest: EventEmitter<AuthRequestEvent>;
-  readonly onSnapshotRequired: EventEmitter<SnapshotRequiredEvent>;
   readonly onChange: EventEmitter<ChangeEvent>;
   readonly onQueryResult: EventEmitter<QueryResultEvent>;
 
-  // -- NativeEventEmitter compatibility --
+  // NativeEventEmitter compatibility
   addListener(eventName: string): void;
   removeListeners(count: number): void;
 }