@trainstar/synchro-react-native 0.3.2 → 0.4.0-rc.2

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

@@ -82,7 +82,7 @@ export type JSONValue = null | boolean | number | 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' | 'exceeds_push_limit';
 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 type MutationRejectionCode = 'version_conflict' | 'row_already_exists' | 'row_deleted' | 'row_not_found' | 'schema_incompatible' | 'policy_rejected' | 'validation_failed' | 'table_not_synced' | 'atomic_batch_rejected';
 export interface SchemaRef {
     version: number;
     hash: string;
@@ -92,6 +92,7 @@ export interface AuthoredMutationField {
     logicalType: string;
     value: JSONValue;
 }
+/** A retained mutation with its complete ledger binding and authored values. */
 export interface PendingMutationInspection {
     mutationID: string;
     localOrder: number;
@@ -112,6 +113,27 @@ export interface PendingMutationInspection {
     sealedOrdinal: number | null;
     authoredFields: AuthoredMutationField[];
 }
+/**
+ * A retained mutation that a queue from before the mutation ledger imported.
+ * It has only the fields that the old queue stored.
+ */
+export interface LegacyMutationInspection {
+    representation: 'legacy';
+    mutationID: string;
+    localOrder: number;
+    tableName: string;
+    recordID: string;
+    operation: MutationOperation;
+    baseVersion: string | null;
+    clientVersion: string;
+    status: LocalMutationStatus;
+    sourceKind: string;
+}
+/** One retained mutation in its stored representation. */
+export type RetainedMutationInspection = (PendingMutationInspection & {
+    representation: 'current';
+}) | LegacyMutationInspection;
+/** A retained rejection with its exact mutation and rejection JSON. */
 export interface RejectedMutationInspection {
     mutationID: string;
     tableName: string;
@@ -126,6 +148,27 @@ export interface RejectedMutationInspection {
     createdAt: string;
     updatedAt: string;
 }
+/**
+ * A retained rejection that a database from before the mutation ledger stored.
+ * It has only the fields that the old rejection table stored.
+ */
+export interface LegacyRejectionInspection {
+    representation: 'legacy';
+    mutationID: string;
+    tableName: string;
+    recordID: string;
+    status: MutationStatus;
+    code: MutationRejectionCode;
+    message: string | null;
+    serverRowJSON: string | null;
+    serverVersion: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** One retained rejection in its stored representation. */
+export type RetainedRejectionInspection = (RejectedMutationInspection & {
+    representation: 'current';
+}) | LegacyRejectionInspection;
 export interface ScopeStateInspection {
     scopeID: string;
     cursor: string | null;
@@ -168,17 +211,35 @@ export interface ClientStateInspection {
     rebuildReceiptCount: number;
     provenanceMaintenanceWorkCursor: string;
 }
+export type MigrationCheckpoint = 'migration_prepared' | 'migration_committed';
+export interface MigrationJournalInspection {
+    source: SchemaRef;
+    target: SchemaRef;
+    action: string;
+    phase: string;
+    stored: Record<string, string>;
+}
+export interface PhysicalSchemaColumnInspection {
+    table_name: string;
+    name: string;
+    type: string;
+    not_null: boolean;
+    primary_key_position: number;
+}
 export type TransportOperationClass = 'connect' | 'pull' | 'push' | 'checkpoint' | 'schemas' | 'rebuild' | 'other';
 export interface TransportObservation {
     sequence: number;
     operationClass: TransportOperationClass;
     statusCode: number;
+    errorCode?: string;
+    retryable?: boolean;
     durationNanoseconds: number;
     cursorFingerprints?: string[];
     cursorFingerprintsComplete?: boolean;
     requestFacts?: Record<string, JSONValue>;
     rebuildResponseFacts?: Record<string, JSONValue>;
     pullResponseFacts?: Record<string, JSONValue>;
+    connectResponseFacts?: Record<string, JSONValue>;
 }
 export interface TransportObservationSnapshot {
     observations: TransportObservation[];

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"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"}
+{"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,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,WAAW,CAAC;AAE1D,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,iBAAiB,CAAC;AAEnF,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,SAAS,eAAe,EAAE,CAAC;CACrC;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,eAAe;IAC9B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,eAAe,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACxE,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,eAAe,EAAE,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;CACjF;AAED,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,eAAe,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAChF;AAED,eAAO,MAAM,iBAAiB,wJAYpB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,eAAO,MAAM,oBAAoB,2GASvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,eAAO,MAAM,qBAAqB,4CAA6C,CAAC;AAEhF,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,eAAO,MAAM,kBAAkB,+WAkBrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,eAAO,MAAM,oBAAoB,0SAcvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,kBAAkB,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,KAAK,oBAAoB,GAAG;KACzB,CAAC,IAAI,OAAO,CAAC,cAAc,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG;QACnD,MAAM,EAAE,CAAC,CAAC;QACV,OAAO,EAAE,IAAI,CAAC;QACd,SAAS,EAAE,IAAI,CAAC;QAChB,OAAO,EAAE,IAAI,CAAC;KACf;CACF,CAAC,OAAO,CAAC,cAAc,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC;AAEhD,MAAM,MAAM,UAAU,GAClB,oBAAoB,GACpB;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,IAAI,CAAC;IACd,SAAS,EAAE,iBAAiB,CAAC;IAC7B,OAAO,EAAE,IAAI,CAAC;CACf,GACD;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;IACd,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,WAAW,CAAC;CACtB,CAAC;AAEN,MAAM,MAAM,SAAS,GACjB,IAAI,GACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEjC,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE1E,MAAM,MAAM,mBAAmB,GAC3B,SAAS,GACT,QAAQ,GACR,wBAAwB,GACxB,uBAAuB,GACvB,wBAAwB,GACxB,iBAAiB,GACjB,oBAAoB,CAAC;AAEzB,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,mBAAmB,CAAC;AAE1E,MAAM,MAAM,qBAAqB,GAC7B,kBAAkB,GAClB,oBAAoB,GACpB,aAAa,GACb,eAAe,GACf,qBAAqB,GACrB,iBAAiB,GACjB,mBAAmB,GACnB,kBAAkB,GAClB,uBAAuB,CAAC;AAE5B,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,gFAAgF;AAChF,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,cAAc,EAAE,SAAS,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,qBAAqB,EAAE,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,cAAc,EAAE,QAAQ,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,0DAA0D;AAC1D,MAAM,MAAM,0BAA0B,GAClC,CAAC,yBAAyB,GAAG;IAAE,cAAc,EAAE,SAAS,CAAA;CAAE,CAAC,GAC3D,wBAAwB,CAAC;AAE7B,uEAAuE;AACvE,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,qBAAqB,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,QAAQ,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,qBAAqB,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,2DAA2D;AAC3D,MAAM,MAAM,2BAA2B,GACnC,CAAC,0BAA0B,GAAG;IAAE,cAAc,EAAE,SAAS,CAAA;CAAE,CAAC,GAC5D,yBAAyB,CAAC;AAE9B,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,eAAe,EAAE,wBAAwB,EAAE,CAAC;IAC5C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,+BAA+B,EAAE,MAAM,CAAC;CACzC;AAED,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,GAAG,qBAAqB,CAAC;AAE/E,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,8BAA8B;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,uBAAuB,GAC/B,SAAS,GACT,MAAM,GACN,MAAM,GACN,YAAY,GACZ,SAAS,GACT,SAAS,GACT,OAAO,CAAC;AAEZ,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,uBAAuB,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACzC,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjD,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC9C,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,4BAA4B;IAC3C,YAAY,EAAE,oBAAoB,EAAE,CAAC;IACrC,UAAU,EAAE,OAAO,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,eAAe,GAAG,aAAa,CAAC;AAEhF,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,cAAc,CAAC;IACvB,aAAa,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,SAAS,GACjB;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,cAAc,CAAC;IACrB,EAAE,EAAE,cAAc,CAAC;CACpB,GACD,CAAC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG;IACrB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;CACf,CAAC,GACF,CAAC;IAAE,IAAI,EAAE,iBAAiB,GAAG,gBAAgB,CAAA;CAAE,GAAG,eAAe,CAAC,GAClE,CAAC;IAAE,IAAI,EAAE,mBAAmB,GAAG,mBAAmB,CAAA;CAAE,GAAG,iBAAiB,CAAC,GACzE,CAAC;IAAE,IAAI,EAAE,mBAAmB,GAAG,mBAAmB,CAAA;CAAE,GAAG,gBAAgB,CAAC,GACxE;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,WAAW,CAAC;CACtB,CAAC;AAEN,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;AACrC,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trainstar/synchro-react-native",
-  "version": "0.3.2",
+  "version": "0.4.0-rc.2",
   "description": "React Native bridge for Synchro sync SDK",
   "source": "./src/index.ts",
   "main": "./lib/module/index.js",
@@ -16,6 +16,11 @@
       "types": "./lib/typescript/src/inspection.d.ts",
       "default": "./lib/module/inspection.js"
     },
+    "./tooling-patches/apply": "./tooling-patches/apply.cjs",
+    "./tooling-patches/cli-config-android-20.2.0.patch": "./tooling-patches/cli-config-android-20.2.0.patch",
+    "./tooling-patches/cli-clean-20.2.0.patch": "./tooling-patches/cli-clean-20.2.0.patch",
+    "./tooling-patches/react-native-builder-bob-0.40.18.patch": "./tooling-patches/react-native-builder-bob-0.40.18.patch",
+    "./tooling-patches/stream-json-1.9.1.patch": "./tooling-patches/stream-json-1.9.1.patch",
     "./package.json": "./package.json"
   },
   "files": [
@@ -23,6 +28,9 @@
     "lib",
     "android",
     "ios",
+    "ios-test-host",
+    "ios-tests",
+    "tooling-patches",
     "*.podspec",
     "!ios/build",
     "!android/build",
@@ -42,7 +50,7 @@
     "pack:dry-run": "npm pack --dry-run",
     "test:unit": "jest --runInBand --watchman=false",
     "typecheck": "tsc",
-    "lint": "eslint src/ __tests__/ example/e2e/",
+    "lint": "eslint src/ __tests__/ example/e2e/ example/src/",
     "test": "jest"
   },
   "keywords": [
@@ -68,7 +76,7 @@
     "node": ">=20.19.4"
   },
   "devDependencies": {
-    "@react-native/babel-preset": "0.83.0",
+    "@react-native/babel-preset": "0.83.10",
     "@testing-library/react-native": "^12.4.0",
     "@types/jest": "^29.5.14",
     "@types/react": "^19.2.4",
@@ -78,19 +86,26 @@
     "eslint": "^9.0.0",
     "jest": "^29.7.0",
     "react": "19.2.4",
-    "react-native": "0.83.0",
+    "react-native": "0.83.10",
     "react-native-builder-bob": "^0.40.18",
     "react-test-renderer": "^19.2.4",
     "ts-jest": "^29.1.0",
     "typescript": "^5.9.2"
   },
   "peerDependencies": {
-    "react": ">=19.2.0 <20.0.0",
-    "react-native": ">=0.83.0 <0.84.0"
+    "react": ">=19.1.1 <20.0.0",
+    "react-native": ">=0.82.1 <0.84.0"
   },
   "workspaces": [
     "example"
   ],
+  "resolutions": {
+    "@react-native-community/cli-config-android@npm:20.2.0": "patch:@react-native-community/cli-config-android@npm%3A20.2.0#./tooling-patches/cli-config-android-20.2.0.patch",
+    "@react-native-community/cli-clean@npm:20.2.0": "patch:@react-native-community/cli-clean@npm%3A20.2.0#./tooling-patches/cli-clean-20.2.0.patch",
+    "react-native-builder-bob@npm:^0.40.18": "patch:react-native-builder-bob@npm%3A0.40.18#./tooling-patches/react-native-builder-bob-0.40.18.patch",
+    "stream-json@npm:^1.7.4": "patch:stream-json@npm%3A1.9.1#./tooling-patches/stream-json-1.9.1.patch",
+    "stream-json@npm:^1.7.5": "patch:stream-json@npm%3A1.9.1#./tooling-patches/stream-json-1.9.1.patch"
+  },
   "packageManager": "yarn@4.11.0",
   "react-native-builder-bob": {
     "source": "src",

package/src/NativeSynchro.ts

@@ -94,6 +94,7 @@ export interface Spec extends TurboModule {
 
   // Transactions
   beginWriteTransaction(): Promise<string>;
+  beginAtomicWriteTransaction(): Promise<string>;
   beginReadTransaction(): Promise<string>;
   txQuery(
     txID: string,
@@ -151,8 +152,12 @@ export interface Spec extends TurboModule {
   getSyncStatus(): Promise<string>;
   inspectPendingMutations(): Promise<string>;
   inspectRetainedMutations(): Promise<string>;
+  inspectRetainedMutationRecords(): Promise<string>;
   inspectRejectedMutations(): Promise<string>;
-  inspectClientState(): Promise<string>;
+  inspectRejectedMutationRecords(): Promise<string>;
+  inspectClientStateSnapshot(
+    rowStatements: ReadonlyArray<NativeSQLStatement>
+  ): Promise<{ inspection: string; applicationRows: ReadonlyArray<NativeRow> }>;
   inspectDurableState(tableName: string, recordID: string): Promise<string>;
   inspectTransportObservations(): Promise<string>;
   armTransportPause(operationClass: string): Promise<void>;

package/src/SynchroClient.ts

@@ -28,6 +28,8 @@ import type {
   MutationRejectionCode,
   PendingMutationInspection,
   RejectedMutationInspection,
+  RetainedMutationInspection,
+  RetainedRejectionInspection,
   ClientStateInspection,
   ScopeStateInspection,
   ScopeRowInspection,
@@ -117,6 +119,7 @@ const MUTATION_REJECTION_CODES: readonly MutationRejectionCode[] = [
   'policy_rejected',
   'validation_failed',
   'table_not_synced',
+  'atomic_batch_rejected',
 ];
 
 const MUTATION_OPERATIONS = ['insert', 'upsert', 'update', 'delete'] as const;
@@ -438,6 +441,40 @@ function parsePendingMutationInspection(
   };
 }
 
+export function parseRetainedMutationInspection(
+  value: unknown,
+  index: number
+): RetainedMutationInspection {
+  const name = `pending mutation at index ${index}`;
+  if (!isRecord(value)) {
+    throw new InvalidResponseError(`Native bridge returned an invalid ${name}`);
+  }
+  if (value.representation === 'current') {
+    return { representation: 'current', ...parsePendingMutationInspection(value, index) };
+  }
+  if (value.representation !== 'legacy') {
+    throw new InvalidResponseError(`Native bridge returned an invalid ${name} representation`);
+  }
+  if (!MUTATION_OPERATIONS.includes(value.operation as never)) {
+    throw new InvalidResponseError(`Native bridge returned an invalid ${name} operation`);
+  }
+  if (!LOCAL_MUTATION_STATUSES.includes(value.status as never)) {
+    throw new InvalidResponseError(`Native bridge returned an invalid ${name} status`);
+  }
+  return {
+    representation: 'legacy',
+    mutationID: requiredString(value.mutationID, `${name} ID`),
+    localOrder: requiredSafeInteger(value.localOrder, `${name} local order`),
+    tableName: requiredString(value.tableName, `${name} table name`),
+    recordID: requiredString(value.recordID, `${name} record ID`),
+    operation: value.operation as PendingMutationInspection['operation'],
+    baseVersion: nullableString(value.baseVersion, `${name} base version`),
+    clientVersion: requiredString(value.clientVersion, `${name} client version`),
+    status: value.status as PendingMutationInspection['status'],
+    sourceKind: requiredString(value.sourceKind, `${name} source kind`),
+  };
+}
+
 function parseRejectedMutationInspection(
   value: unknown,
   index: number
@@ -466,6 +503,39 @@ function parseRejectedMutationInspection(
   };
 }
 
+export function parseRetainedRejectionInspection(
+  value: unknown,
+  index: number
+): RetainedRejectionInspection {
+  const name = `rejected mutation at index ${index}`;
+  if (!isRecord(value)) {
+    throw new InvalidResponseError(`Native bridge returned an invalid ${name}`);
+  }
+  if (value.representation === 'current') {
+    return { representation: 'current', ...parseRejectedMutationInspection(value, index) };
+  }
+  if (value.representation !== 'legacy') {
+    throw new InvalidResponseError(`Native bridge returned an invalid ${name} representation`);
+  }
+  const code = parseRejectionCode(value.code);
+  if (code === null) {
+    throw new InvalidResponseError(`Native bridge returned a missing ${name} code`);
+  }
+  return {
+    representation: 'legacy',
+    mutationID: requiredString(value.mutationID, `${name} ID`),
+    tableName: requiredString(value.tableName, `${name} table name`),
+    recordID: requiredString(value.recordID, `${name} record ID`),
+    status: parseMutationStatus(value.status),
+    code,
+    message: nullableString(value.message, `${name} message`),
+    serverRowJSON: nullableString(value.serverRowJSON, `${name} server row JSON`),
+    serverVersion: nullableString(value.serverVersion, `${name} server version`),
+    createdAt: requiredString(value.createdAt, `${name} creation time`),
+    updatedAt: requiredString(value.updatedAt, `${name} update time`),
+  };
+}
+
 function parseScopeStateInspection(value: unknown, index: number): ScopeStateInspection {
   const name = `scope state at index ${index}`;
   if (!isRecord(value)) {
@@ -621,6 +691,14 @@ function parseTransportObservation(value: unknown, index: number): TransportObse
   if (!isRecord(value) || !TRANSPORT_OPERATION_CLASSES.includes(value.operation_class as TransportOperationClass)) {
     throw new InvalidResponseError(`Native bridge returned an invalid ${name}`);
   }
+  const errorCode = value.error_code;
+  if (errorCode !== undefined && typeof errorCode !== 'string') {
+    throw new InvalidResponseError(`Native bridge returned invalid ${name} error code`);
+  }
+  const retryable = value.retryable;
+  if (retryable !== undefined && typeof retryable !== 'boolean') {
+    throw new InvalidResponseError(`Native bridge returned invalid ${name} retryability`);
+  }
   const cursorFingerprints = value.cursor_fingerprints;
   if (cursorFingerprints !== undefined && (!Array.isArray(cursorFingerprints) || !cursorFingerprints.every((item) => typeof item === 'string'))) {
     throw new InvalidResponseError(`Native bridge returned invalid ${name} cursor fingerprints`);
@@ -629,16 +707,40 @@ function parseTransportObservation(value: unknown, index: number): TransportObse
   if (cursorFingerprintsComplete !== undefined && typeof cursorFingerprintsComplete !== 'boolean') {
     throw new InvalidResponseError(`Native bridge returned invalid ${name} cursor completeness`);
   }
+  const connectFacts = optionalTransportFacts(value.connect_response_facts, `${name} connect response facts`);
+  if (connectFacts !== undefined) {
+    const affected = connectFacts.affected_scope_fingerprints;
+    const updates = connectFacts.scope_cursor_updates;
+    const hashPattern = /^[0-9a-f]{64}$/;
+    if (
+      value.operation_class !== 'connect' || value.status_code !== 200 ||
+      Object.keys(connectFacts).length !== 7 ||
+      !['none', 'replace', 'rebuild_local', 'unsupported'].includes(connectFacts.action as string) ||
+      typeof connectFacts.schema_version !== 'number' || !Number.isSafeInteger(connectFacts.schema_version) || connectFacts.schema_version <= 0 ||
+      typeof connectFacts.schema_hash !== 'string' || !hashPattern.test(connectFacts.schema_hash) ||
+      !Array.isArray(affected) || affected.length > 16 ||
+      !affected.every((item, position) => typeof item === 'string' && hashPattern.test(item) && (position === 0 || (affected[position - 1] as string) < item)) ||
+      typeof connectFacts.affected_scopes_complete !== 'boolean' ||
+      !isRecord(updates) || Object.keys(updates).length > 16 ||
+      !Object.entries(updates).every(([scope, cursor]) => hashPattern.test(scope) && (cursor === null || typeof cursor === 'string' && hashPattern.test(cursor))) ||
+      typeof connectFacts.scope_cursor_updates_complete !== 'boolean'
+    ) {
+      throw new InvalidResponseError(`Native bridge returned invalid ${name} connect response facts`);
+    }
+  }
   return {
     sequence: requiredSafeInteger(value.sequence, `${name} sequence`),
     operationClass: value.operation_class as TransportOperationClass,
     statusCode: requiredSafeInteger(value.status_code, `${name} status code`),
+    ...(errorCode === undefined ? {} : { errorCode }),
+    ...(retryable === undefined ? {} : { retryable }),
     durationNanoseconds: requiredSafeInteger(value.duration_nanoseconds, `${name} duration`),
     ...(cursorFingerprints === undefined ? {} : { cursorFingerprints: [...cursorFingerprints] as string[] }),
     ...(cursorFingerprintsComplete === undefined ? {} : { cursorFingerprintsComplete }),
     ...(value.request_facts == null ? {} : { requestFacts: optionalTransportRequestFacts(value.request_facts, `${name} request facts`)! }),
     ...(value.rebuild_response_facts == null ? {} : { rebuildResponseFacts: optionalTransportFacts(value.rebuild_response_facts, `${name} rebuild response facts`)! }),
     ...(value.pull_response_facts == null ? {} : { pullResponseFacts: optionalTransportFacts(value.pull_response_facts, `${name} pull response facts`)! }),
+    ...(connectFacts === undefined ? {} : { connectResponseFacts: connectFacts }),
   };
 }
 
@@ -802,10 +904,28 @@ export class SynchroClient {
 
   async writeTransaction<T>(
     callback: (tx: Transaction) => Promise<T>
+  ): Promise<T> {
+    return this.runWriteTransaction(() => this.native.beginWriteTransaction(), callback);
+  }
+
+  /**
+   * Runs a write transaction whose synced mutations the server applies all
+   * together or not at all. The native SDK owns the group. An invalid group
+   * rolls back and rejects with `AtomicGroupInvalidError`.
+   */
+  async atomicWriteTransaction<T>(
+    callback: (tx: Transaction) => Promise<T>
+  ): Promise<T> {
+    return this.runWriteTransaction(() => this.native.beginAtomicWriteTransaction(), callback);
+  }
+
+  private async runWriteTransaction<T>(
+    begin: () => Promise<string>,
+    callback: (tx: Transaction) => Promise<T>
   ): Promise<T> {
     let txID: string;
     try {
-      txID = await this.native.beginWriteTransaction();
+      txID = await begin();
     } catch (error) {
       throw mapNativeError(error);
     }
@@ -1025,6 +1145,11 @@ export class SynchroClient {
     }
   }
 
+  /**
+   * Returns the unresolved queue records.
+   * @deprecated Use {@link SynchroClient.inspectRetainedMutationRecords}. This method keeps its
+   * published behavior. It rejects when the native queue holds a legacy import.
+   */
   async inspectPendingMutations(): Promise<PendingMutationInspection[]> {
     try {
       return parseNativeArray(
@@ -1036,6 +1161,11 @@ export class SynchroClient {
     }
   }
 
+  /**
+   * Returns every retained queue record, including local terminal states.
+   * @deprecated Use {@link SynchroClient.inspectRetainedMutationRecords}. This method keeps its
+   * published behavior. It rejects when the native queue holds a legacy import.
+   */
   async inspectRetainedMutations(): Promise<PendingMutationInspection[]> {
     try {
       return parseNativeArray(
@@ -1047,6 +1177,23 @@ export class SynchroClient {
     }
   }
 
+  /** Returns every retained queue record in its stored representation. */
+  async inspectRetainedMutationRecords(): Promise<RetainedMutationInspection[]> {
+    try {
+      return parseNativeArray(
+        await this.native.inspectRetainedMutationRecords(),
+        'retained mutation inspection'
+      ).map(parseRetainedMutationInspection);
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+  }
+
+  /**
+   * Returns the retained terminal outcomes.
+   * @deprecated Use {@link SynchroClient.inspectRejectedMutationRecords}. This method keeps its
+   * published behavior. It rejects when a legacy rejection is present.
+   */
   async inspectRejectedMutations(): Promise<RejectedMutationInspection[]> {
     try {
       return parseNativeArray(
@@ -1058,6 +1205,18 @@ export class SynchroClient {
     }
   }
 
+  /** Returns the retained terminal outcomes in their stored representation. */
+  async inspectRejectedMutationRecords(): Promise<RetainedRejectionInspection[]> {
+    try {
+      return parseNativeArray(
+        await this.native.inspectRejectedMutationRecords(),
+        'rejected mutation inspection'
+      ).map(parseRetainedRejectionInspection);
+    } catch (error) {
+      throw mapNativeError(error);
+    }
+  }
+
   async clearRejectedMutations(): Promise<void> {
     try {
       await this.native.clearRejectedMutations();

package/src/errors.ts

@@ -33,6 +33,7 @@ export const NATIVE_ERROR_CODES = [
   'TRANSACTION_TIMEOUT',
   'INVALID_CONFIG',
   'CLIENT_ALREADY_ACTIVE',
+  'atomic_group_invalid',
   'UNKNOWN',
 ] as const;
 
@@ -233,6 +234,25 @@ export class TransactionTimeoutError extends SynchroError {
   }
 }
 
+export const ATOMIC_GROUP_INVALID_REASONS = [
+  'deleteFollowedByWrite',
+  'tooManyMutations',
+  'mutationTooLarge',
+  'requestTooLarge',
+] as const;
+
+export type AtomicGroupInvalidReason = (typeof ATOMIC_GROUP_INVALID_REASONS)[number];
+
+export class AtomicGroupInvalidError extends SynchroError {
+  readonly reason: AtomicGroupInvalidReason;
+
+  constructor(reason: AtomicGroupInvalidReason) {
+    super('atomic_group_invalid', `Atomic write group is invalid: ${reason}`);
+    this.name = 'AtomicGroupInvalidError';
+    this.reason = reason;
+  }
+}
+
 interface NativeErrorLike {
   code?: string;
   message?: string;
@@ -439,6 +459,16 @@ export function mapNativeError(error: unknown): SynchroError {
       return new TransactionTimeoutError();
     case 'INVALID_CONFIG':
       return new SynchroError('INVALID_CONFIG', message);
+    case 'atomic_group_invalid':
+      try {
+        return new AtomicGroupInvalidError(
+          requiredEnum(userInfo.reason, ATOMIC_GROUP_INVALID_REASONS, 'atomic group invalid reason')
+        );
+      } catch (parseError) {
+        return parseError instanceof SynchroError
+          ? parseError
+          : new InvalidResponseError('Native bridge returned invalid atomic group details');
+      }
     default:
       return new SynchroError('UNKNOWN', message);
   }

package/src/index.ts

@@ -30,7 +30,11 @@ export type {
   SchemaRef,
   AuthoredMutationField,
   PendingMutationInspection,
+  LegacyMutationInspection,
+  RetainedMutationInspection,
   RejectedMutationInspection,
+  LegacyRejectionInspection,
+  RetainedRejectionInspection,
   SchemaAction,
   SyncSchemaEvent,
   SyncMutationEvent,
@@ -71,6 +75,8 @@ export {
   AlreadyStartedError,
   NotStartedError,
   TransactionTimeoutError,
+  AtomicGroupInvalidError,
+  ATOMIC_GROUP_INVALID_REASONS,
   NATIVE_ERROR_CODES,
   mapNativeError,
 } from './errors';
@@ -78,5 +84,6 @@ export {
 export type {
   NativeErrorCode,
   SchemaUnsupportedReason,
+  AtomicGroupInvalidReason,
   PushRejectedMutation,
 } from './errors';