@plotday/twister 0.54.0 → 0.55.0

package/src/tools/integrations.ts

@@ -17,6 +17,26 @@ export type Channel = {
   id: string;
   /** Display name shown in the UI */
   title: string;
+  /**
+   * Whether this channel should be selected by default when the user first
+   * adds the connection. Tri-state:
+   * - `true`  — pre-select it (e.g. the user's own/primary calendar).
+   * - `false` — exclude it from the default selection (low-value or
+   *   irrelevant resources that would crowd the user's view, or containers
+   *   whose contents are too broad to sync wholesale — e.g. a holiday or
+   *   someone-else's shared calendar, a GitHub org that cascades to every
+   *   repo, a Microsoft Teams team container). The user can still enable it
+   *   manually.
+   * - `undefined` — no opinion; the client decides. The client defaults to
+   *   enabling the channel unless its title looks low-value (holidays,
+   *   birthdays, spam/sent/draft, …).
+   *
+   * The guiding principle is "sync everything the user would reasonably want
+   * by default" — for most connectors that's all channels, so only set this
+   * where the connector can distinguish the user's own/relevant channels from
+   * low-value ones (e.g. Google Calendar via `accessRole === "owner"`).
+   */
+  enabledByDefault?: boolean;
   /** Optional nested channel resources (e.g., subfolders) */
   children?: Channel[];
   /** Per-channel link type configs. Overrides twist-level linkTypes when present. */
@@ -39,6 +59,28 @@ export type LinkTypeConfig = {
    * when omitted. Use the singular noun in title case (e.g. "Comment").
    */
   noteLabel?: string;
+  /**
+   * Placeholder shown in the editor when this link type is the target of a
+   * new thread (NewThreadPage). Example: "Send a Gmail email".
+   * If unset, Plot derives "Create a new {connector} {label.toLowerCase()}".
+   */
+  composePlaceholder?: string;
+  /**
+   * Label for the Send button on NewThreadPage when this link type is the
+   * target. Example: "Send". If unset, defaults to "Create".
+   */
+  composeVerb?: string;
+  /**
+   * Placeholder shown in the in-thread editor for the default reply mode.
+   * Example: "Reply" (Gmail), "Add a comment" (Linear). If unset, Plot derives
+   * "Add a {noteLabel.toLowerCase()}" or "Add a note".
+   */
+  replyPlaceholder?: string;
+  /**
+   * Label for the Send button in the in-thread editor. Example: "Send"
+   * (Gmail), "Comment" (Linear). If unset, defaults to "Send".
+   */
+  replyVerb?: string;
   /** URL to an icon for this link type (light mode). Prefer Iconify `logos/*` URLs. */
   logo?: string;
   /** URL to an icon for dark mode. Use when the default logo is invisible on dark backgrounds (e.g., Iconify `simple-icons/*` with `?color=`). */
@@ -72,6 +114,16 @@ export type LinkTypeConfig = {
   }>;
   /** Whether this link type supports displaying and changing the assignee */
   supportsAssignee?: boolean;
+  /**
+   * Whether this link type produces time-anchored schedule/agenda items
+   * (i.e. calendar events). The Plot app shows the agenda (the bottom-nav
+   * tab on mobile and the left-sidebar agenda on desktop) only when the
+   * user has at least one active connection whose link types include one
+   * with `includesSchedules: true`. Calendar connectors (Google / Apple /
+   * Outlook Calendar) set this on their `event` link type. Defaults to
+   * false — non-calendar link types (messages, issues, tasks, docs) omit it.
+   */
+  includesSchedules?: boolean;
   /** Default thread creation mode for this link type: 'all' | 'actionable' | 'manual' */
   defaultCreateThreads?: string;
   /**
@@ -103,6 +155,22 @@ export type LinkTypeConfig = {
    * false when omitted.
    */
   supportsContactChanges?: boolean;
+  /**
+   * Whether a note/reply on this link type can carry a link (a pasted URL or
+   * connector-created item) that Plot forwards to the source. When false (the
+   * default), the "Add link" button is hidden for threads of this link type.
+   * Only set true if the connector's reply path actually forwards the link
+   * action to the source. Private Plot notes (no link type) always allow links.
+   */
+  supportsLinks?: boolean;
+  /**
+   * Whether a note/reply on this link type can carry an uploaded file that Plot
+   * forwards to the source as an attachment. When false (the default), the
+   * "Attach file" button is hidden for threads of this link type. Only set true
+   * if the connector's reply path actually uploads file actions to the source.
+   * Private Plot notes (no link type) always allow attachments.
+   */
+  supportsFileAttachments?: boolean;
   /**
    * Declares how sharing on threads of this link type is scoped:
    *
@@ -114,12 +182,16 @@ export type LinkTypeConfig = {
    * - `"message"`: each note carries its own recipient set via
    *   `note.access_contacts`; the thread roster is the union across
    *   all messages. Email.
+   * - `"none"`: the link type has no recipient roster at all. No
+   *   contacts/sharing UI is shown for these threads. Use for purely
+   *   personal destinations with no sharing concept (e.g. Google
+   *   Tasks). The per-thread `contacts` array is ignored for sharing UI.
    *
    * Omit to default to `"thread"`. When set to `"message"`, every
    * note this connector ingests must populate `access_contacts`
    * explicitly (never NULL).
    */
-  sharingModel?: "thread" | "channel" | "message";
+  sharingModel?: "thread" | "channel" | "message" | "none";
 };
 
 /**