Creating Plot Twists
    Preparing search index...

    Type Alias Link

    Link:
        | { type: external; title: string; url: string }
        | { type: conferencing; url: string; provider: ConferencingProvider }
        | {
            type: auth;
            title: string;
            provider: string;
            scopes: string[];
            callback: Callback;
        }
        | { type: callback; title: string; callback: Callback }
        | {
            type: file;
            fileId: string;
            fileName: string;
            fileSize: number;
            mimeType: string;
        }

    Represents a clickable link attached to an activity.

    Activity links are rendered as buttons that enable user interaction with activities. Different link types have specific behaviors and required fields for proper functionality.

    Type Declaration

    • { type: external; title: string; url: string }
      • type: external

        External web link that opens in browser

      • title: string

        Display text for the link button

      • url: string

        URL to open when clicked

    • { type: conferencing; url: string; provider: ConferencingProvider }
      • type: conferencing

        Video conferencing link with provider-specific handling

      • url: string

        URL to join the conference

      • provider: ConferencingProvider

        Conferencing provider for UI customization

    • {
          type: auth;
          title: string;
          provider: string;
          scopes: string[];
          callback: Callback;
      }
      • type: auth

        Authentication link that initiates an OAuth flow

      • title: string

        Display text for the auth button

      • provider: string

        OAuth provider (e.g., "google", "microsoft")

      • scopes: string[]

        Array of OAuth scopes to request

      • callback: Callback

        Callback token for auth completion notification

    • { type: callback; title: string; callback: Callback }
      • type: callback

        Callback link that triggers a twist method when clicked

      • title: string

        Display text for the callback button

      • callback: Callback

        Token identifying the callback to execute

    • {
          type: file;
          fileId: string;
          fileName: string;
          fileSize: number;
          mimeType: string;
      }
      • type: file

        File attachment link stored in R2

      • fileId: string

        Unique identifier for the stored file

      • fileName: string

        Original filename

      • fileSize: number

        File size in bytes

      • mimeType: string

        MIME type of the file

    // External link - opens URL in browser
    const externalLink: Link = {
      type: LinkType.external,
      title: "Open in Google Calendar",
      url: "https://calendar.google.com/event/123",
    };

    // Conferencing link - opens video conference with provider info
    const conferencingLink: Link = {
      type: LinkType.conferencing,
      url: "https://meet.google.com/abc-defg-hij",
      provider: ConferencingProvider.googleMeet,
    };

    // Integrations link - initiates OAuth flow
    const authLink: Link = {
      type: LinkType.auth,
      title: "Continue with Google",
      provider: AuthProvider.Google,
      scopes: ["https://www.googleapis.com/auth/calendar.readonly"],
      callback: "callback-token-for-auth-completion"
    };

    // Callback link - triggers a twist method
    const callbackLink: Link = {
      type: LinkType.callback,
      title: "📅 Primary Calendar",
      token: "callback-token-here"
    };

    Settings

    Member Visibility