@absolutejs/sync-capacitor 0.7.0 → 0.9.0

package/README.md

@@ -41,6 +41,14 @@ failures obey the client's delivery ceiling; conflicts and permanent failures
 remain in the principal's dead-letter partition for explicit remediation rather
 than replaying forever.
 
+Generated mutation conflict policies are captured inside each encrypted outbox
+record. The TypeScript foreground/headless runner and the Android WorkManager or
+iOS BGProcessingTask runner therefore make the same bounded decision: manual
+conflicts become dead letters, `server-wins` discards the rejected local intent,
+and `client-wins` retries the unchanged operation ID up to its declared ceiling.
+An explicit argument-changing rebase is left to the foreground remediation API
+and creates a new traceable intent.
+
 The namespace must come from a verified Auth principal, never from an untrusted
 route or form value. AbsoluteJS derives an opaque namespace from the verified
 issuer, public client ID, and subject. Signing out locks that partition by

package/android/src/main/java/js/absolute/sync/AbsoluteBackgroundSyncEngine.java

@@ -79,7 +79,7 @@ final class AbsoluteBackgroundSyncEngine {
     private static int[] settle(Context context,SQLiteDatabase db,AbsoluteBackgroundSyncConfig config,Batch b,JSONObject response)throws Exception{
         if(response.getInt("version")!=1)throw new IllegalStateException("Unsupported Headless Sync response.");Map<String,JSONObject> mutationResults=index(response.getJSONArray("mutations"),"operationId"),pullResults=index(response.getJSONArray("pulls"),"id");int ack=0,pulled=0;db.beginTransaction();
         try{
-            for(Mutation sent:b.mutations.values()){JSONObject current=record(context,db,"absolute_sync_mutations","operation_id","mutation",config.namespace,sent.id);if(current==null||current.optInt("attempts",-1)!=sent.attempts)continue;JSONObject outcome=mutationResults.get(sent.id);if(outcome!=null&&"ack".equals(outcome.optString("status"))){db.delete("absolute_sync_mutations","namespace=? AND operation_id=?",new String[]{config.namespace,sent.id});ack++;continue;}JSONObject rejection=outcome==null?new JSONObject().put("kind","retryable").put("message","Missing mutation response."):outcome.getJSONObject("rejection");current.put("lastError",rejection.optString("message","Mutation rejected.")).put("rejection",rejection);if(!"retryable".equals(rejection.optString("kind"))||sent.attempts>=config.maxAttempts)current.put("state","dead-letter").put("deadLetteredAt",System.currentTimeMillis()).remove("nextAttemptAt");else current.put("state","pending").put("nextAttemptAt",System.currentTimeMillis()+Math.max(0,rejection.optLong("retryAfterMs",Math.min(30000,500L<<Math.min(20,sent.attempts-1)))));updateMutation(context,db,config.namespace,sent.id,current);}
+            for(Mutation sent:b.mutations.values()){JSONObject current=record(context,db,"absolute_sync_mutations","operation_id","mutation",config.namespace,sent.id);if(current==null||current.optInt("attempts",-1)!=sent.attempts)continue;JSONObject outcome=mutationResults.get(sent.id);if(outcome!=null&&"ack".equals(outcome.optString("status"))){db.delete("absolute_sync_mutations","namespace=? AND operation_id=?",new String[]{config.namespace,sent.id});ack++;continue;}JSONObject rejection=outcome==null?new JSONObject().put("kind","retryable").put("message","Missing mutation response."):outcome.getJSONObject("rejection");current.put("lastError",rejection.optString("message","Mutation rejected.")).put("rejection",rejection);JSONObject conflictPolicy=current.optJSONObject("conflictPolicy");String conflictStrategy=conflictPolicy==null?"manual":conflictPolicy.optString("strategy","manual");if("conflict".equals(rejection.optString("kind"))&&"server-wins".equals(conflictStrategy)){db.delete("absolute_sync_mutations","namespace=? AND operation_id=?",new String[]{config.namespace,sent.id});continue;}if("conflict".equals(rejection.optString("kind"))&&"client-wins".equals(conflictStrategy)&&current.optInt("conflictAttempts",0)<conflictPolicy.optInt("maxAttempts",1)){current.put("conflictAttempts",current.optInt("conflictAttempts",0)+1).put("state","pending").remove("nextAttemptAt");updateMutation(context,db,config.namespace,sent.id,current);continue;}if(!"retryable".equals(rejection.optString("kind"))||sent.attempts>=config.maxAttempts)current.put("state","dead-letter").put("deadLetteredAt",System.currentTimeMillis()).remove("nextAttemptAt");else current.put("state","pending").put("nextAttemptAt",System.currentTimeMillis()+Math.max(0,rejection.optLong("retryAfterMs",Math.min(30000,500L<<Math.min(20,sent.attempts-1)))));updateMutation(context,db,config.namespace,sent.id,current);}
             for(Map.Entry<String,JSONObject> requested:b.pulls.entrySet()){JSONObject result=pullResults.get(requested.getKey());if(result==null||"error".equals(result.optString("type")))continue;JSONObject current=record(context,db,"absolute_sync_collections","collection_key","collection",config.namespace,requested.getKey());if(!same(current,requested.getValue()))continue;ContentValues values=new ContentValues();JSONObject next=applyPull(current,result);values.put("record_json",encodeRecord(context,next,"collection",config.namespace,next.optString("collection",requested.getKey())));db.update("absolute_sync_collections",values,"namespace=? AND collection_key=?",new String[]{config.namespace,requested.getKey()});pulled++;}
             db.setTransactionSuccessful();
         }finally{db.endTransaction();}return new int[]{ack,pulled};

package/ios/Sources/AbsoluteSyncCapacitor/AbsoluteBackgroundSyncEngine.swift

@@ -97,6 +97,12 @@ enum AbsoluteBackgroundSyncEngine {
                 if mutationResults[sent.id]?["status"] as? String == "ack" { try execute(db, "DELETE FROM absolute_sync_mutations WHERE namespace=? AND operation_id=?", [config.namespace, sent.id]); acknowledged += 1; continue }
                 let rejection = mutationResults[sent.id]?["rejection"] as? [String: Any] ?? ["kind": "retryable", "message": "Missing mutation response."]
                 current["lastError"] = rejection["message"]; current["rejection"] = rejection
+                let conflictPolicy = current["conflictPolicy"] as? [String: Any]
+                let conflictStrategy = conflictPolicy?["strategy"] as? String ?? "manual"
+                if rejection["kind"] as? String == "conflict" && conflictStrategy == "server-wins" { try execute(db, "DELETE FROM absolute_sync_mutations WHERE namespace=? AND operation_id=?", [config.namespace, sent.id]); continue }
+                let conflictAttempts = (current["conflictAttempts"] as? NSNumber)?.intValue ?? 0
+                let maxConflictAttempts = (conflictPolicy?["maxAttempts"] as? NSNumber)?.intValue ?? 1
+                if rejection["kind"] as? String == "conflict" && conflictStrategy == "client-wins" && conflictAttempts < maxConflictAttempts { current["conflictAttempts"] = conflictAttempts + 1; current["state"] = "pending"; current.removeValue(forKey: "nextAttemptAt"); try updateRecord(db, "absolute_sync_mutations", "operation_id", "mutation", config.namespace, sent.id, current); continue }
                 if rejection["kind"] as? String != "retryable" || sent.attempts >= config.maxAttempts { current["state"] = "dead-letter"; current["deadLetteredAt"] = Date().timeIntervalSince1970 * 1000; current.removeValue(forKey: "nextAttemptAt") }
                 else { let hint = (rejection["retryAfterMs"] as? NSNumber)?.doubleValue ?? min(30_000, 500 * pow(2, Double(max(0, sent.attempts - 1)))); current["state"] = "pending"; current["nextAttemptAt"] = Date().timeIntervalSince1970 * 1000 + max(0, hint) }
                 try updateRecord(db, "absolute_sync_mutations", "operation_id", "mutation", config.namespace, sent.id, current)

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@absolutejs/sync-capacitor",
-	"version": "0.7.0",
+	"version": "0.9.0",
 	"description": "Transactional Capacitor SQLite local store and native lifecycle adapter for @absolutejs/sync",
 	"repository": {
 		"type": "git",
@@ -36,16 +36,16 @@
 		"release": "bun run format && bun run typecheck && bun test && bun run build && npm publish"
 	},
 	"peerDependencies": {
-		"@absolutejs/devices": ">=0.0.3 <0.1.0",
-		"@absolutejs/devices-capacitor": ">=0.1.3 <0.2.0",
-		"@absolutejs/sync": ">=2.27.0 <3",
+		"@absolutejs/devices": ">=0.2.0 <0.3.0",
+		"@absolutejs/devices-capacitor": ">=0.3.1 <0.4.0",
+		"@absolutejs/sync": ">=2.29.0 <3",
 		"@capacitor/core": ">=8 <9",
 		"@capacitor-community/sqlite": ">=8.1.1 <9"
 	},
 	"devDependencies": {
-		"@absolutejs/devices": "0.0.3",
-		"@absolutejs/devices-capacitor": "0.1.3",
-		"@absolutejs/sync": "2.27.0",
+		"@absolutejs/devices": "0.2.0",
+		"@absolutejs/devices-capacitor": "0.3.1",
+		"@absolutejs/sync": "2.29.0",
 		"@capacitor/core": "8.5.0",
 		"@capacitor-community/sqlite": "8.1.1",
 		"@types/bun": "1.3.14",