Support provider PII compliance, starting with Atlassian

Author: KrisBraun

.changeset/wild-lies-shout.md

@@ -0,0 +1,6 @@
+---
+"@plotday/tool-jira": minor
+"@plotday/twister": minor
+---
+
+Added: Contact.source for external service PII compliance

tools/jira/src/jira.ts

@@ -382,13 +382,15 @@ export class Jira extends Tool<Jira> implements ProjectTool {
         email: reporter.emailAddress,
         name: reporter.displayName,
         avatar: reporter.avatarUrls?.["48x48"],
+        ...atlassianSource(reporter.accountId),
       };
     }
     if (assignee?.emailAddress) {
       assigneeContact = {
         email: assignee.emailAddress,
         name: assignee.displayName,
         avatar: assignee.avatarUrls?.["48x48"],
+        ...atlassianSource(assignee.accountId),
       };
     }
 
@@ -453,6 +455,7 @@ export class Jira extends Tool<Jira> implements ProjectTool {
           email: author.emailAddress,
           name: author.displayName,
           avatar: author.avatarUrl,
+          ...atlassianSource(author.accountId),
         };
       }
 
@@ -721,13 +724,15 @@ export class Jira extends Tool<Jira> implements ProjectTool {
         email: reporter.emailAddress,
         name: reporter.displayName,
         avatar: reporter.avatarUrls?.["48x48"],
+        ...atlassianSource(reporter.accountId),
       };
     }
     if (assignee?.emailAddress) {
       assigneeContact = {
         email: assignee.emailAddress,
         name: assignee.displayName,
         avatar: assignee.avatarUrls?.["48x48"],
+        ...atlassianSource(assignee.accountId),
       };
     }
 
@@ -814,6 +819,7 @@ export class Jira extends Tool<Jira> implements ProjectTool {
         email: author.emailAddress,
         name: author.displayName,
         avatar: author.avatarUrls?.["48x48"],
+        ...atlassianSource(author.accountId),
       };
     }
 
@@ -873,4 +879,15 @@ export class Jira extends Tool<Jira> implements ProjectTool {
   }
 }
 
+/**
+ * Returns a `source` property for NewContact if the Atlassian accountId is valid.
+ * Used for Atlassian personal data reporting compliance.
+ */
+function atlassianSource(accountId: string | undefined): Pick<NewContact, "source"> | {} {
+  if (accountId && accountId !== "_unknown_") {
+    return { source: { provider: AuthProvider.Atlassian, accountId } };
+  }
+  return {};
+}
+
 export default Jira;

twister/src/plot.ts

@@ -1,11 +1,13 @@
 import { type Tag } from "./tag";
 import { type Callback } from "./tools/callbacks";
+import { type AuthProvider } from "./tools/integrations";
 import { type JSONValue } from "./utils/types";
 import { Uuid } from "./utils/uuid";
 
 export { Tag } from "./tag";
 export { Uuid } from "./utils/uuid";
 export { type JSONValue } from "./utils/types";
+export { type AuthProvider } from "./tools/integrations";
 
 /**
  * @fileoverview
@@ -1243,6 +1245,12 @@ export type NewContact = {
   name?: string;
   /** Optional avatar image URL for the contact */
   avatar?: string;
+  /**
+   * External provider account source. Used for privacy compliance
+   * (e.g. Atlassian personal data reporting for GDPR account closure).
+   * Required for contacts sourced from providers that mandate personal data reporting.
+   */
+  source?: { provider: AuthProvider; accountId: string };
 };
 
 export type ContentType = "text" | "markdown" | "html";