@plotday/twister 0.53.0 → 0.55.0

package/dist/connector.d.ts

@@ -96,6 +96,20 @@ export type ResolvedRecipient = {
     name: string | null;
     /** Platform-specific account identifier pre-resolved at dispatch time (e.g. Slack `U…`, LinkedIn URN, Gmail email address) */
     externalAccountId: string;
+    /**
+     * The contact's role on the originating thread, resolved from
+     * `thread.contact_meta` against the link type's `contactRoles` (e.g.
+     * `"to"` / `"cc"` / `"bcc"` for Gmail). `null` when the contact had no
+     * explicit role entry — connectors should treat `null` as the link
+     * type's default role (the `contactRoles` entry marked `default: true`).
+     *
+     * Connectors that distinguish roles MUST honor this when addressing the
+     * recipient — e.g. Gmail must place `"cc"`/`"bcc"` recipients in the
+     * Cc/Bcc headers, never the To header, so BCC recipients are not
+     * exposed to the other recipients. Connectors that don't distinguish
+     * roles (Slack, Linear) can ignore it.
+     */
+    role: string | null;
 };
 /**
  * Fields captured in Plot when a user initiates creation of a new external
@@ -133,11 +147,12 @@ export type CreateLinkDraft = {
      * `"contacts"` or `"addresses"`.
      *
      * Only populated for those link types; otherwise undefined. Each entry contains the Plot
-     * contact UUID and the platform-specific account ID
+     * contact UUID, the platform-specific account ID
      * (`externalAccountId`) the connector should use to address the
-     * recipient without performing its own lookup. For `"addresses"` link
-     * types, contacts without a connection-scoped row fall back to
-     * `contact.email`.
+     * recipient without performing its own lookup, and the contact's
+     * `role` on the thread (e.g. `"to"` / `"cc"` / `"bcc"`) resolved from
+     * `thread.contact_meta`. For `"addresses"` link types, contacts without
+     * a connection-scoped row fall back to `contact.email`.
      */
     recipients?: ResolvedRecipient[];
     /**
@@ -148,6 +163,31 @@ export type CreateLinkDraft = {
      */
     inviteEmails?: string[];
 };
+/** An optional OAuth scope group the user can toggle at connect time. */
+export type OptionalScopeGroup = {
+    /** Stable id used to track the user's selection. */
+    id: string;
+    /** Value-forward switch label, e.g. "Add names to events using contacts". */
+    label: string;
+    /** Optional secondary line shown under the label. */
+    description?: string;
+    /** The OAuth scope strings this group grants. */
+    scopes: string[];
+    /** Whether the group is requested by default (switch on). */
+    default: boolean;
+};
+/**
+ * Structured scope declaration. `required` scopes must be granted — auth fails
+ * and re-prompts if any is declined. `optional` groups are requested by default
+ * but auth still succeeds if the user declines them; the connector should detect
+ * the absence via the granted `token.scopes` and degrade gracefully.
+ */
+export type ScopeConfig = {
+    required: string[];
+    /** Friendly bullets describing what the always-on (required) access does. */
+    description?: string[];
+    optional?: OptionalScopeGroup[];
+};
 /**
  * Base class for connectors — twists that sync data from external services.
  *
@@ -201,8 +241,9 @@ export declare abstract class Connector<TSelf> extends Twist<TSelf> {
     static readonly isConnector = true;
     /** The OAuth provider this connector authenticates with. */
     readonly provider?: AuthProvider;
-    /** OAuth scopes to request for this connector. */
-    readonly scopes?: string[];
+    /** OAuth scopes to request for this connector — a flat list (all required), or
+     *  a {@link ScopeConfig} declaring required + optional scope groups. */
+    readonly scopes?: string[] | ScopeConfig;
     /**
      * When true, one credential is shared across all users in the workspace,
      * entered once by the installer. When false (default), each user provides

package/dist/connector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../src/connector.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../src/connector.ts"],"names":[],"mappings":"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"}

package/dist/connector.js

@@ -53,7 +53,8 @@ export class Connector extends Twist {
     // ---- Identity (abstract — every connector must declare) ----
     /** The OAuth provider this connector authenticates with. */
     provider;
-    /** OAuth scopes to request for this connector. */
+    /** OAuth scopes to request for this connector — a flat list (all required), or
+     *  a {@link ScopeConfig} declaring required + optional scope groups. */
     scopes;
     // ---- Auth model ----
     /**

package/dist/connector.js.map

@@ -1 +1 @@
-{"version":3,"file":"connector.js","sourceRoot":"","sources":["../src/connector.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"connector.js","sourceRoot":"","sources":["../src/connector.ts"],"names":[],"mappings":"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"}

package/dist/docs/assets/hierarchy.js

@@ -1 +1 @@
-window.hierarchyData = "eJyVlEFrgzAYhv/Ld/6aETXReCuDQS/bYL2NMpxmqzRNisnooPS/j2hX0h1MdvGgT94n+Xz1BIMxzkL9SjOOYoMwyA8lW9cbbaE+gfAX3ewl1LA+9tYBwq7XHdQ0qxC+BgU1tKqxVto75wEyYmTr9gpwegQ1ONst/LrFdAOh3faqG6Qe1UW2OSPQjAe21doYNWszRpGR+p9MIMtzZDzHkhVYFRWKLEchGFJKBVJalEgZr5ByzpGWOUVaVmza4c08UjaYsL8zAsvzv4O2sWj7Ns7bTgO3CRIeSparuKDpyXIVDy5ZEQTfN0q9N+0u4QDtL0qui+K2qqjCmmgnP4dmKmxU2Ac0CZfGtSILp/co3dEMu7hRTyC5LEjwCBZ4npWZ/+RGyUEZRzwaj/cdD/JfnBlkXGA9RkY4RVGUYZsbm9IF5zEywgmKrMjCyhmtZevMMKfpdSe/yRVNkDAeNu2hV3L2HJNgxBLCOb/52+2bQzzbUwnRZU7DV7x3CdGeSomuwnY+HaLf3ZR+AWOC8/kHpegdGA=="
+window.hierarchyData = "eJyVk8FOAyEQht9lziN2WijL3oyJyV7UpL0ZY9Yt6qYUmgVTE9N3N+yqoR4KXvbAfvN/MAyfMDgXPNQPNF+iekQY9IvRXeid9VB/goof2+401LA+9D4Awra3G6hpXiG8DwZq6EzrvfaXIQJsxNhb2BnA6RfUEPzmItZdTAsI3VtvNoO2o1rQ4xGB5svE1qydM2dtzhk2Uv+TKRQkUXCJki+w4gtUVKFSMyQigUR8gSSkRFpKgST5DEkqPu3wpB8lGyzY3xFBkPzbaJ+L9k9jv/3UcF8g4ankqskL2p5dNflgyRdJ8HVrzHPbbQsO0P2g7Lcob6tObI0N+nVop4HNCvuEZmlpXquoSrS3OhzcsM0b7QSy74ICj5olnnvjzj+5UbI3LrCI5uPjjCf5q+AGnRf4iLERLlGc3NC69SWzECLGRrhAMReUjpyzVnfBDec0vd3oD/aLFkiETB/MTW/02XNMghErCF/K9B6aXbvPZ0eqIFrydIRWu1AQHamSaMWT6Lt99t1N6d9gTnA8fgFGxx0A"

package/dist/docs/assets/navigation.js

@@ -1 +1 @@
-window.navigationData = "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"
+window.navigationData = "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"