From bf56b7c2c240f08903426042741a41ff074fb521 Mon Sep 17 00:00:00 2001
From: Philipinho <16838612+Philipinho@users.noreply.github.com>
Date: Sun, 9 Aug 2026 15:58:34 +0100
Subject: [PATCH] chore(integration): document cache purge intent

---
 .../src/features/integration/queries/integration-query.ts       | 2 +-
 apps/server/src/core/integration/unfurl/unfurl.service.ts       | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/apps/client/src/features/integration/queries/integration-query.ts b/apps/client/src/features/integration/queries/integration-query.ts
index 9ed30cc15..154d5938c 100644
--- a/apps/client/src/features/integration/queries/integration-query.ts
+++ b/apps/client/src/features/integration/queries/integration-query.ts
@@ -105,7 +105,7 @@ export function useDisconnectIntegration() {
         queryKey: ["integration-connection", variables.integrationId],
       });
       qc.invalidateQueries({ queryKey: ["my-connections"] });
-      // removeQueries, not invalidate: refetchOnMount false would revive stale entries
+      // removeQueries, not invalidate: refetchOnMount false leaves invalidated inactive queries unrefreshed
       qc.removeQueries({ queryKey: ["unfurl"] });
     },
     onError: (error) => {
diff --git a/apps/server/src/core/integration/unfurl/unfurl.service.ts b/apps/server/src/core/integration/unfurl/unfurl.service.ts
index 77efe85da..a0969adb8 100644
--- a/apps/server/src/core/integration/unfurl/unfurl.service.ts
+++ b/apps/server/src/core/integration/unfurl/unfurl.service.ts
@@ -123,6 +123,7 @@ export class UnfurlService {
         }
       }
     } catch (err) {
+      // best-effort by design: never fail a disconnect on cache purge; the TTL is the backstop
       this.logger.error(
         `Failed to purge unfurl cache for user ${userId}: ${(err as Error).message}`,
       );