@drakkar.software/starfish-client 2.0.0 → 2.2.0

package/dist/index.js

@@ -198,6 +198,12 @@ function createSchemaValidator(ajv, schema) {
 }
 
 // src/sync.ts
+var AbortError = class extends Error {
+  constructor() {
+    super("SyncManager was aborted");
+    this.name = "AbortError";
+  }
+};
 var SyncManager = class {
   client;
   pullPath;
@@ -212,6 +218,7 @@ var SyncManager = class {
   lastHash = null;
   lastCheckpoint = 0;
   localData = {};
+  aborted = false;
   constructor(options) {
     this.client = options.client;
     this.pullPath = options.pullPath;
@@ -224,22 +231,35 @@ var SyncManager = class {
     this.validate = options.validate;
     this.encryptor = options.encryptor ?? (options.encryptionSecret && options.encryptionSalt ? createEncryptor(options.encryptionSecret, options.encryptionSalt, options.encryptionInfo) : null);
   }
+  abort() {
+    this.aborted = true;
+  }
+  get isAborted() {
+    return this.aborted;
+  }
   getData() {
     return { ...this.localData };
   }
   getHash() {
     return this.lastHash;
   }
+  /** Set the last-known server hash. Used by persistence layers to restore state across restarts. */
+  setHash(hash) {
+    this.lastHash = hash;
+  }
   getCheckpoint() {
     return this.lastCheckpoint;
   }
   async pull() {
+    if (this.aborted) throw new AbortError();
     this.logger?.pullStart(this.loggerName);
     const start = performance.now();
     try {
       const result = await this.client.pull(this.pullPath, this.lastCheckpoint);
+      if (this.aborted) throw new AbortError();
       if (this.encryptor) {
         const decrypted = await this.encryptor.decrypt(result.data);
+        if (this.aborted) throw new AbortError();
         this.localData = decrypted;
         result.data = decrypted;
       } else if (this.lastCheckpoint > 0) {
@@ -258,6 +278,7 @@ var SyncManager = class {
     }
   }
   async push(data) {
+    if (this.aborted) throw new AbortError();
     if (this.validate) {
       const result = this.validate(data);
       if (result !== true) throw new ValidationError(result);
@@ -269,19 +290,23 @@ var SyncManager = class {
     while (attempt <= this.maxRetries) {
       try {
         const payload = this.encryptor ? await this.encryptor.encrypt(pendingData) : pendingData;
+        if (this.aborted) throw new AbortError();
         const sig = this.signData ? await this.signData(stableStringify(payload)) : void 0;
+        if (this.aborted) throw new AbortError();
         const result = await this.client.push(
           this.pushPath,
           payload,
           this.lastHash,
           sig
         );
+        if (this.aborted) throw new AbortError();
         this.lastHash = result.hash;
         this.lastCheckpoint = result.timestamp;
         this.localData = pendingData;
         this.logger?.pushSuccess(this.loggerName, Math.round(performance.now() - start));
         return result;
       } catch (err) {
+        if (err instanceof AbortError) throw err;
         if (!(err instanceof ConflictError) || attempt >= this.maxRetries) {
           this.logger?.pushError(this.loggerName, err instanceof Error ? err.message : String(err));
           throw err;
@@ -289,11 +314,14 @@ var SyncManager = class {
         this.logger?.conflict(this.loggerName, attempt + 1);
         try {
           const remote = await this.client.pull(this.pullPath);
+          if (this.aborted) throw new AbortError();
           const remoteData = this.encryptor ? await this.encryptor.decrypt(remote.data) : remote.data;
+          if (this.aborted) throw new AbortError();
           this.lastHash = remote.hash;
           this.lastCheckpoint = remote.timestamp;
           pendingData = this.onConflict(pendingData, remoteData);
         } catch (resolveErr) {
+          if (resolveErr instanceof AbortError) throw resolveErr;
           const msg = resolveErr instanceof Error ? resolveErr.message : String(resolveErr);
           this.logger?.pushError(this.loggerName, `Conflict resolution failed (attempt ${attempt + 1}): ${msg}`);
           throw resolveErr;
@@ -1308,6 +1336,7 @@ async function pullEntitlements(client, userId, opts) {
   }
 }
 export {
+  AbortError,
   ConflictError,
   ENCRYPTED_KEY,
   SnapshotHistory,