@anuma/sdk 7.1.0 → 7.1.1

package/README.md

@@ -74,6 +74,16 @@ The SDK provides entry points for different platforms:
 - `@anuma/sdk/expo` — React Native / Expo
 - `@anuma/sdk/client` — Generated API client and types
 
+### iCloud backups
+
+Add a `backupRevision` field with type `String` to the `ConversationBackup`
+record type in the development schema.
+[Deploy the schema to production](https://developer.apple.com/documentation/cloudkit/deploying-an-icloud-container-s-schema)
+before you release a client that uses iCloud backup.
+
+The SDK compares this saved revision with the local conversation and message
+data. The next backup replaces older files that have no saved revision.
+
 ## Features
 
 The SDK gives you access to a unified API across multiple LLM providers through

package/dist/react/index.cjs

@@ -30968,7 +30968,7 @@ async function requestICloudSignIn() {
   }
   return container.whenUserSignsIn();
 }
-async function uploadFileToICloud(filename, content) {
+async function uploadFileToICloud(filename, content, backupRevision) {
   const container = await getContainer();
   const database = container.privateCloudDatabase;
   const recordName = `backup_${filename.replace(/[^a-zA-Z0-9]/g, "_")}`;
@@ -30981,7 +30981,8 @@ async function uploadFileToICloud(filename, content) {
       filename: { value: filename },
       data: { value: base64Data },
       size: { value: content.size },
-      contentType: { value: content.type || "application/json" }
+      contentType: { value: content.type || "application/json" },
+      ...backupRevision ? { backupRevision: { value: backupRevision } } : {}
     }
   };
   const response = await database.saveRecords(record2);
@@ -30993,7 +30994,8 @@ async function uploadFileToICloud(filename, content) {
     recordName: savedRecord.recordName,
     filename,
     modifiedAt: new Date(savedRecord.modified?.timestamp ?? Date.now()),
-    size: content.size
+    size: content.size,
+    backupRevision: savedRecord.fields.backupRevision?.value
   };
 }
 async function listICloudFiles() {
@@ -31014,6 +31016,7 @@ async function listICloudFiles() {
     recordName: record2.recordName,
     filename: record2.fields.filename?.value ?? "",
     modifiedAt: new Date(record2.modified?.timestamp ?? Date.now()),
+    backupRevision: record2.fields.backupRevision?.value,
     size: typeof record2.fields.data?.value === "object" && record2.fields.data?.value !== null ? record2.fields.data.value.size : 0
   }));
   return files.sort((a, b) => b.modifiedAt.getTime() - a.modifiedAt.getTime());
@@ -31067,35 +31070,53 @@ async function findICloudFile(filename) {
     recordName: record2.recordName,
     filename: record2.fields.filename?.value ?? "",
     modifiedAt: new Date(record2.modified?.timestamp ?? Date.now()),
+    backupRevision: record2.fields.backupRevision?.value,
     size: typeof record2.fields.data?.value === "object" && record2.fields.data?.value !== null ? record2.fields.data.value.size : 0
   };
 }
 
 // src/lib/backup/icloud/backup.ts
 var isAuthError = (err) => err instanceof Error && (err.message.includes("AUTHENTICATION") || err.message.includes("NOT_AUTHENTICATED") || err.message.includes("sign in"));
+var UNREVISIONED_COLUMNS = /* @__PURE__ */ new Set([
+  "updated_at",
+  "vector",
+  "embedding_model",
+  "chunks",
+  "origin"
+]);
+async function getBackupRevision(database, conversationId) {
+  const serialized = await database.read(async () => {
+    const { Q: Q20 } = await import("@nozbe/watermelondb");
+    const tables = await Promise.all(
+      ["conversations", "history"].map(
+        (table) => database.get(table).query(Q20.where("conversation_id", conversationId), Q20.sortBy("id", Q20.asc)).unsafeFetchRaw()
+      )
+    );
+    return JSON.stringify(
+      tables.map(
+        (rows) => rows.map(
+          (row) => Object.entries(row).filter(([key]) => !key.startsWith("_") && !UNREVISIONED_COLUMNS.has(key)).sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0)
+        )
+      )
+    );
+  });
+  const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(serialized));
+  return "v1:" + Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, "0")).join("");
+}
 async function pushConversationToICloud(database, conversationId, userAddress, deps, _retried = false) {
   try {
     await deps.requestEncryptionKey(userAddress);
     const filename = `${conversationId}.json`;
     const existingFile = await findICloudFile(filename);
-    if (existingFile) {
-      const { Q: Q20 } = await import("@nozbe/watermelondb");
-      const conversationsCollection = database.get("conversations");
-      const records = await conversationsCollection.query(Q20.where("conversation_id", conversationId)).fetch();
-      if (records.length > 0) {
-        const conversation = conversationToStoredRaw(records[0]);
-        const localUpdated = conversation.updatedAt.getTime();
-        const remoteModified = existingFile.modifiedAt.getTime();
-        if (localUpdated <= remoteModified) {
-          return "skipped";
-        }
-      }
+    const backupRevision = await getBackupRevision(database, conversationId);
+    if (existingFile?.backupRevision === backupRevision) {
+      return "skipped";
     }
     const exportResult = await deps.exportConversation(conversationId, userAddress);
     if (!exportResult.success || !exportResult.blob) {
       return "failed";
     }
-    await uploadFileToICloud(filename, exportResult.blob);
+    await uploadFileToICloud(filename, exportResult.blob, backupRevision);
     return "uploaded";
   } catch (err) {
     if (isAuthError(err) && !_retried) {

package/dist/react/index.d.mts

@@ -109,6 +109,9 @@ interface CloudKitRecord {
                 size: number;
             };
         };
+        backupRevision?: {
+            value: string;
+        };
     };
     modified?: {
         timestamp: number;

package/dist/react/index.d.ts

@@ -109,6 +109,9 @@ interface CloudKitRecord {
                 size: number;
             };
         };
+        backupRevision?: {
+            value: string;
+        };
     };
     modified?: {
         timestamp: number;

package/dist/react/index.mjs

@@ -29112,7 +29112,7 @@ async function requestICloudSignIn() {
   }
   return container.whenUserSignsIn();
 }
-async function uploadFileToICloud(filename, content) {
+async function uploadFileToICloud(filename, content, backupRevision) {
   const container = await getContainer();
   const database = container.privateCloudDatabase;
   const recordName = `backup_${filename.replace(/[^a-zA-Z0-9]/g, "_")}`;
@@ -29125,7 +29125,8 @@ async function uploadFileToICloud(filename, content) {
       filename: { value: filename },
       data: { value: base64Data },
       size: { value: content.size },
-      contentType: { value: content.type || "application/json" }
+      contentType: { value: content.type || "application/json" },
+      ...backupRevision ? { backupRevision: { value: backupRevision } } : {}
     }
   };
   const response = await database.saveRecords(record2);
@@ -29137,7 +29138,8 @@ async function uploadFileToICloud(filename, content) {
     recordName: savedRecord.recordName,
     filename,
     modifiedAt: new Date(savedRecord.modified?.timestamp ?? Date.now()),
-    size: content.size
+    size: content.size,
+    backupRevision: savedRecord.fields.backupRevision?.value
   };
 }
 async function listICloudFiles() {
@@ -29158,6 +29160,7 @@ async function listICloudFiles() {
     recordName: record2.recordName,
     filename: record2.fields.filename?.value ?? "",
     modifiedAt: new Date(record2.modified?.timestamp ?? Date.now()),
+    backupRevision: record2.fields.backupRevision?.value,
     size: typeof record2.fields.data?.value === "object" && record2.fields.data?.value !== null ? record2.fields.data.value.size : 0
   }));
   return files.sort((a, b) => b.modifiedAt.getTime() - a.modifiedAt.getTime());
@@ -29211,35 +29214,53 @@ async function findICloudFile(filename) {
     recordName: record2.recordName,
     filename: record2.fields.filename?.value ?? "",
     modifiedAt: new Date(record2.modified?.timestamp ?? Date.now()),
+    backupRevision: record2.fields.backupRevision?.value,
     size: typeof record2.fields.data?.value === "object" && record2.fields.data?.value !== null ? record2.fields.data.value.size : 0
   };
 }
 
 // src/lib/backup/icloud/backup.ts
 var isAuthError = (err) => err instanceof Error && (err.message.includes("AUTHENTICATION") || err.message.includes("NOT_AUTHENTICATED") || err.message.includes("sign in"));
+var UNREVISIONED_COLUMNS = /* @__PURE__ */ new Set([
+  "updated_at",
+  "vector",
+  "embedding_model",
+  "chunks",
+  "origin"
+]);
+async function getBackupRevision(database, conversationId) {
+  const serialized = await database.read(async () => {
+    const { Q: Q20 } = await import("@nozbe/watermelondb");
+    const tables = await Promise.all(
+      ["conversations", "history"].map(
+        (table) => database.get(table).query(Q20.where("conversation_id", conversationId), Q20.sortBy("id", Q20.asc)).unsafeFetchRaw()
+      )
+    );
+    return JSON.stringify(
+      tables.map(
+        (rows) => rows.map(
+          (row) => Object.entries(row).filter(([key]) => !key.startsWith("_") && !UNREVISIONED_COLUMNS.has(key)).sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0)
+        )
+      )
+    );
+  });
+  const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(serialized));
+  return "v1:" + Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, "0")).join("");
+}
 async function pushConversationToICloud(database, conversationId, userAddress, deps, _retried = false) {
   try {
     await deps.requestEncryptionKey(userAddress);
     const filename = `${conversationId}.json`;
     const existingFile = await findICloudFile(filename);
-    if (existingFile) {
-      const { Q: Q20 } = await import("@nozbe/watermelondb");
-      const conversationsCollection = database.get("conversations");
-      const records = await conversationsCollection.query(Q20.where("conversation_id", conversationId)).fetch();
-      if (records.length > 0) {
-        const conversation = conversationToStoredRaw(records[0]);
-        const localUpdated = conversation.updatedAt.getTime();
-        const remoteModified = existingFile.modifiedAt.getTime();
-        if (localUpdated <= remoteModified) {
-          return "skipped";
-        }
-      }
+    const backupRevision = await getBackupRevision(database, conversationId);
+    if (existingFile?.backupRevision === backupRevision) {
+      return "skipped";
     }
     const exportResult = await deps.exportConversation(conversationId, userAddress);
     if (!exportResult.success || !exportResult.blob) {
       return "failed";
     }
-    await uploadFileToICloud(filename, exportResult.blob);
+    await uploadFileToICloud(filename, exportResult.blob, backupRevision);
     return "uploaded";
   } catch (err) {
     if (isAuthError(err) && !_retried) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anuma/sdk",
-  "version": "7.1.0",
+  "version": "7.1.1",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",