@every-app/sdk 0.3.0-rc.10 → 0.3.0-rc.11

package/dist/internal/oauthPresets.js

@@ -1,21 +1,20 @@
 /**
- * OAuth presets (docs/design/2026-10-oauth-providers.md section 4): ready
- * `oauth2-user` specs, in the JSON shape `everyapp provider add` takes,
- * for the providers people most often want a "Connect" button for. A
- * preset becomes a `providers` row when added (`everyapp provider add
- * --oauth github`, the Admin dialog, `everyapp_provider_add` with
- * `preset`), so an operator may `provider show` and edit a copy; nothing
- * here is a hidden catalog entry, and no gateway reserves a preset's
- * setting names until it is added. Google, Microsoft and Slack are
- * catalog clients with a `flow` and are offered in the same picker. The
- * social networks' presets carry the tag `social`.
+ * OAuth presets: ready `oauth2-user` specs, in the JSON shape `everyapp
+ * provider add` takes, for providers people most often want a "Connect"
+ * button for. A preset becomes a `providers` row when added (`everyapp
+ * provider add --oauth github-oauth`, the Admin dialog,
+ * `everyapp_provider_add` with `preset`), so an operator may `provider
+ * show` and edit a copy; nothing here is a hidden catalog entry, and no
+ * gateway reserves a preset's setting names until it is added. Google,
+ * Microsoft and Slack are built in (./oauthBuiltIns.ts) and are offered
+ * in the same picker.
  *
- * Each preset parses with `parseProviderSpec` (oauthPresets.test.ts),
+ * Each preset parses with `parseProviderSpec` (oauthPresets.test.ts) and
  * names a console where the client is made, the API hosts the token is
- * sent to, and scope sets an app declares under `scopes`. Scope strings
- * are the providers' own, verified against their docs on 2026-10-25;
- * the social presets' come from the catalog entries Postiz used, and
- * none of them has been tried against a live connect yet.
+ * sent to, and how the provider spells scopes. Which scopes a connection
+ * holds is each app's `everyapp.config.ts`, never the preset. Endpoints
+ * were checked against the providers' docs on 2026-10-25; only GitHub's
+ * and Google's have been tried against a live connect.
  */
 import { parseProviderSpec, } from "./providerSpec.js";
 export const OAUTH_PRESETS = {
@@ -24,7 +23,7 @@ export const OAUTH_PRESETS = {
         name: "GitHub",
         description: "Repositories, issues, pull requests and the person's profile.",
         docs: "https://github.com/settings/developers",
-        api: "https://docs.github.com/rest",
+        api: "https://docs.github.com/apps/oauth-apps/building-oauth-apps/scopes-for-oauth-apps",
         hosts: ["api.github.com"],
         auth: {
             kind: "oauth2-user",
@@ -36,38 +35,16 @@ export const OAUTH_PRESETS = {
             clientSecret: "GITHUB_OAUTH_CLIENT_SECRET",
             inject: "form",
             pkce: true,
-            scopeDialect: "comma",
+            scopeSeparator: "comma",
             tokenHeaders: { Accept: "application/json" },
+            // GET /user answers with the public profile under any token.
             identity: {
                 url: "https://api.github.com/user",
                 label: "login",
                 id: "id",
             },
         },
-        scopeSets: {
-            identity: {
-                label: "GitHub account (who you are)",
-                access: "read",
-                scopes: ["read:user", "user:email"],
-            },
-            "repo.read": {
-                label: "Repositories (read, private ones included)",
-                access: "read",
-                scopes: ["repo"],
-            },
-            "repo.write": {
-                label: "Repositories (read and write)",
-                access: "write",
-                scopes: ["repo"],
-            },
-            "org.read": {
-                label: "Organizations and teams (read)",
-                access: "read",
-                scopes: ["read:org"],
-            },
-        },
-        access: ["read", "write"],
-        hint: "Register an OAuth App (not a GitHub App) and paste its client id and secret. GitHub's `repo` scope is read and write; a read set with it still lets the Gateway refuse writes.",
+        hint: "Register an OAuth App (not a GitHub App) and paste its client id and secret. GitHub's `repo` scope is read and write.",
     },
     "notion-oauth": {
         id: "notion-oauth",
@@ -84,40 +61,10 @@ export const OAUTH_PRESETS = {
             clientSecret: "NOTION_OAUTH_CLIENT_SECRET",
             inject: "basic",
             pkce: false,
-            scopeDialect: "space",
+            scopeSeparator: "space",
             authorizeParams: { owner: "user" },
         },
-        // Notion reads with GET, and with POST for a search and a database
-        // query; the read set lists those two, so a read grant never creates
-        // or changes a page (POST /v1/pages, PATCH, DELETE need the write set).
-        scopeSets: {
-            "workspace.read": {
-                label: "Shared pages and databases (read)",
-                access: "read",
-                scopes: [],
-                routes: [
-                    {
-                        host: "api.notion.com",
-                        paths: [
-                            "/v1/users",
-                            "/v1/users/",
-                            "/v1/pages/",
-                            "/v1/databases/",
-                            "/v1/blocks/",
-                            "/v1/comments",
-                        ],
-                        posts: ["^/v1/search$", "^/v1/databases/[^/]+/query$"],
-                    },
-                ],
-            },
-            "workspace.write": {
-                label: "Shared pages and databases (read and write)",
-                access: "write",
-                scopes: [],
-            },
-        },
-        access: ["read", "write"],
-        hint: "Notion has no scopes: the person picks the pages to share on Notion's consent screen. Make the integration public to get a client id and secret. Apps send `Notion-Version` on every call.",
+        hint: "Notion has no scopes: an app lists scopes: [] and the person picks the pages to share on Notion's consent screen. Make the integration public to get a client id and secret. Apps send `Notion-Version` on every call.",
     },
     "linear-oauth": {
         id: "linear-oauth",
@@ -135,30 +82,16 @@ export const OAUTH_PRESETS = {
             clientSecret: "LINEAR_OAUTH_CLIENT_SECRET",
             inject: "form",
             pkce: false,
-            scopeDialect: "comma",
-        },
-        // Linear's API is one GraphQL POST, which the Gateway can't tell a
-        // query from a mutation on, so the one set is a write set: an app
-        // lists Linear with access: "write", and Linear's own `read` scope is
-        // what a read-only token holds.
-        scopeSets: {
-            "workspace.write": {
-                label: "Issues, projects and teams (read and write)",
-                access: "write",
-                scopes: ["read", "write"],
-            },
+            scopeSeparator: "comma",
         },
-        access: ["write"],
-        readMethods: [],
-        writeMethods: ["POST"],
-        hint: "Linear's API is GraphQL over POST, so every call needs access: \"write\"; a token's scopes decide what a query may change.",
+        hint: "Linear's scopes are read, write, issues:create and comments:create; its API is GraphQL over POST.",
     },
     "gitlab-oauth": {
         id: "gitlab-oauth",
         name: "GitLab",
         description: "Projects, merge requests and issues on gitlab.com.",
         docs: "https://gitlab.com/-/user_settings/applications",
-        api: "https://docs.gitlab.com/api/rest/",
+        api: "https://docs.gitlab.com/integration/oauth_provider/#view-all-authorized-applications",
         hosts: ["gitlab.com"],
         auth: {
             kind: "oauth2-user",
@@ -169,31 +102,14 @@ export const OAUTH_PRESETS = {
             clientSecret: "GITLAB_OAUTH_CLIENT_SECRET",
             inject: "form",
             pkce: true,
-            scopeDialect: "space",
+            scopeSeparator: "space",
             identity: {
                 url: "https://gitlab.com/api/v4/user",
                 label: "username",
                 id: "id",
-            },
-        },
-        scopeSets: {
-            identity: {
-                label: "GitLab account (who you are)",
-                access: "read",
                 scopes: ["read_user"],
             },
-            "api.read": {
-                label: "Projects, issues and merge requests (read)",
-                access: "read",
-                scopes: ["read_api"],
-            },
-            "api.write": {
-                label: "Projects, issues and merge requests (read and write)",
-                access: "write",
-                scopes: ["api"],
-            },
         },
-        access: ["read", "write"],
         hint: "A self-managed GitLab needs a custom provider with its own host in place of gitlab.com.",
     },
     atlassian: {
@@ -201,7 +117,7 @@ export const OAUTH_PRESETS = {
         name: "Atlassian (Jira and Confluence)",
         description: "Jira issues and Confluence pages on the sites the person grants.",
         docs: "https://developer.atlassian.com/console/myapps/",
-        api: "https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/",
+        api: "https://developer.atlassian.com/cloud/jira/platform/scopes-for-oauth-2-3LO-and-forge-apps/",
         hosts: ["api.atlassian.com"],
         auth: {
             kind: "oauth2-user",
@@ -211,41 +127,16 @@ export const OAUTH_PRESETS = {
             clientSecret: "ATLASSIAN_CLIENT_SECRET",
             inject: "form",
             pkce: false,
-            scopeDialect: "space",
+            scopeSeparator: "space",
             authorizeParams: { audience: "api.atlassian.com", prompt: "consent" },
             identity: {
                 url: "https://api.atlassian.com/me",
                 label: "email",
                 id: "account_id",
+                // `offline_access` is what yields a refresh token.
+                scopes: ["read:me", "offline_access"],
             },
         },
-        scopeSets: {
-            identity: {
-                label: "Atlassian account (who you are)",
-                access: "read",
-                scopes: ["read:me"],
-            },
-            "jira.read": {
-                label: "Jira issues and projects (read)",
-                access: "read",
-                scopes: ["read:jira-work", "read:jira-user"],
-            },
-            "jira.write": {
-                label: "Jira issues (read and write)",
-                access: "write",
-                scopes: ["read:jira-work", "write:jira-work"],
-            },
-            "confluence.read": {
-                label: "Confluence pages (read)",
-                access: "read",
-                scopes: [
-                    "read:confluence-content.all",
-                    "read:confluence-space.summary",
-                ],
-            },
-        },
-        alwaysRequested: ["offline_access"],
-        access: ["read", "write"],
         hint: "Calls go to api.atlassian.com/ex/jira/<cloud id>/… ; the cloud id comes from /oauth/token/accessible-resources.",
     },
     "hubspot-oauth": {
@@ -253,7 +144,7 @@ export const OAUTH_PRESETS = {
         name: "HubSpot",
         description: "CRM contacts, companies and deals.",
         docs: "https://developers.hubspot.com/",
-        api: "https://developers.hubspot.com/docs/reference/api",
+        api: "https://developers.hubspot.com/docs/api/working-with-oauth",
         hosts: ["api.hubapi.com"],
         auth: {
             kind: "oauth2-user",
@@ -263,39 +154,16 @@ export const OAUTH_PRESETS = {
             clientSecret: "HUBSPOT_OAUTH_CLIENT_SECRET",
             inject: "form",
             pkce: false,
-            scopeDialect: "space",
-        },
-        scopeSets: {
-            "contacts.read": {
-                label: "Contacts (read)",
-                access: "read",
-                scopes: ["crm.objects.contacts.read"],
-            },
-            "contacts.write": {
-                label: "Contacts (read and write)",
-                access: "write",
-                scopes: ["crm.objects.contacts.read", "crm.objects.contacts.write"],
-            },
-            "companies.read": {
-                label: "Companies (read)",
-                access: "read",
-                scopes: ["crm.objects.companies.read"],
-            },
-            "deals.read": {
-                label: "Deals (read)",
-                access: "read",
-                scopes: ["crm.objects.deals.read"],
-            },
+            scopeSeparator: "space",
         },
-        access: ["read", "write"],
-        hint: "The app's scopes in HubSpot's developer console must match the sets apps declare, or HubSpot refuses the authorize URL.",
+        hint: "The app's scopes in HubSpot's developer console must include the scopes apps list, or HubSpot refuses the authorize URL.",
     },
     zoom: {
         id: "zoom",
         name: "Zoom",
         description: "The person's meetings and recordings.",
         docs: "https://marketplace.zoom.us/develop/create",
-        api: "https://developers.zoom.us/docs/api/",
+        api: "https://developers.zoom.us/docs/integrations/oauth-scopes-overview/",
         hosts: ["api.zoom.us"],
         auth: {
             kind: "oauth2-user",
@@ -306,48 +174,22 @@ export const OAUTH_PRESETS = {
             clientSecret: "ZOOM_CLIENT_SECRET",
             inject: "basic",
             pkce: true,
-            scopeDialect: "space",
+            scopeSeparator: "space",
             identity: {
                 url: "https://api.zoom.us/v2/users/me",
                 label: "email",
                 id: "id",
-            },
-        },
-        scopeSets: {
-            identity: {
-                label: "Zoom account (who you are)",
-                access: "read",
                 scopes: ["user:read:user"],
             },
-            "meetings.read": {
-                label: "Meetings (read)",
-                access: "read",
-                scopes: ["meeting:read:meeting", "meeting:read:list_meetings"],
-            },
-            "meetings.write": {
-                label: "Meetings (read, create and change)",
-                access: "write",
-                scopes: [
-                    "meeting:read:meeting",
-                    "meeting:write:meeting",
-                    "meeting:update:meeting",
-                ],
-            },
-            "recordings.read": {
-                label: "Cloud recordings (read)",
-                access: "read",
-                scopes: ["cloud_recording:read:list_user_recordings"],
-            },
         },
-        access: ["read", "write"],
-        hint: "A General app with user-managed OAuth; Zoom's granular scope names are the ones listed here.",
+        hint: "A General app with user-managed OAuth, using Zoom's granular scope names.",
     },
     dropbox: {
         id: "dropbox",
         name: "Dropbox",
         description: "Files and folders in the person's Dropbox.",
         docs: "https://www.dropbox.com/developers/apps",
-        api: "https://www.dropbox.com/developers/documentation/http/documentation",
+        api: "https://developers.dropbox.com/oauth-guide",
         hosts: ["api.dropboxapi.com", "content.dropboxapi.com"],
         auth: {
             kind: "oauth2-user",
@@ -358,76 +200,19 @@ export const OAUTH_PRESETS = {
             clientSecret: "DROPBOX_OAUTH_CLIENT_SECRET",
             inject: "form",
             pkce: true,
-            scopeDialect: "space",
+            scopeSeparator: "space",
             authorizeParams: { token_access_type: "offline" },
+            // Dropbox grants account_info.read to every app.
+            tolerated: ["account_info.read"],
         },
-        // Dropbox is POST throughout, so each read set lists the read calls
-        // it unlocks under `posts`; everything else needs the write set.
-        scopeSets: {
-            identity: {
-                label: "Dropbox account (who you are)",
-                access: "read",
-                scopes: ["account_info.read"],
-                routes: [
-                    {
-                        host: "api.dropboxapi.com",
-                        paths: [],
-                        posts: [
-                            "^/2/users/get_current_account$",
-                            "^/2/users/get_space_usage$",
-                        ],
-                    },
-                ],
-            },
-            "files.read": {
-                label: "Files and folders (read)",
-                access: "read",
-                scopes: ["files.metadata.read", "files.content.read"],
-                routes: [
-                    {
-                        host: "api.dropboxapi.com",
-                        paths: [],
-                        posts: [
-                            "^/2/files/list_folder$",
-                            "^/2/files/list_folder/continue$",
-                            "^/2/files/get_metadata$",
-                            "^/2/files/search_v2$",
-                            "^/2/files/search/continue_v2$",
-                            "^/2/files/get_temporary_link$",
-                            "^/2/files/list_revisions$",
-                        ],
-                    },
-                    {
-                        host: "content.dropboxapi.com",
-                        paths: [],
-                        posts: [
-                            "^/2/files/download$",
-                            "^/2/files/get_thumbnail_v2$",
-                            "^/2/files/export$",
-                        ],
-                    },
-                ],
-            },
-            "files.write": {
-                label: "Files and folders (read and write)",
-                access: "write",
-                scopes: [
-                    "files.metadata.read",
-                    "files.content.read",
-                    "files.metadata.write",
-                    "files.content.write",
-                ],
-            },
-        },
-        access: ["read", "write"],
-        hint: 'Dropbox\'s API is POST throughout: a read set unlocks its listed read calls, anything else needs access: "write". `token_access_type=offline` is what yields a refresh token.',
+        hint: "`token_access_type=offline` is what yields a refresh token.",
     },
     spotify: {
         id: "spotify",
         name: "Spotify",
         description: "The person's library, playlists and listening.",
         docs: "https://developer.spotify.com/dashboard",
-        api: "https://developer.spotify.com/documentation/web-api",
+        api: "https://developer.spotify.com/documentation/web-api/concepts/scopes",
         hosts: ["api.spotify.com"],
         auth: {
             kind: "oauth2-user",
@@ -437,610 +222,14 @@ export const OAUTH_PRESETS = {
             clientSecret: "SPOTIFY_CLIENT_SECRET",
             inject: "basic",
             pkce: true,
-            scopeDialect: "space",
+            scopeSeparator: "space",
+            // GET /v1/me names the account under any token.
             identity: {
                 url: "https://api.spotify.com/v1/me",
                 label: "display_name",
                 id: "id",
             },
         },
-        scopeSets: {
-            identity: {
-                label: "Spotify account (who you are)",
-                access: "read",
-                scopes: ["user-read-email", "user-read-private"],
-            },
-            "library.read": {
-                label: "Saved tracks and albums (read)",
-                access: "read",
-                scopes: ["user-library-read"],
-            },
-            "playlists.read": {
-                label: "Playlists (read)",
-                access: "read",
-                scopes: ["playlist-read-private", "playlist-read-collaborative"],
-            },
-            "playlists.write": {
-                label: "Playlists (read and change)",
-                access: "write",
-                scopes: [
-                    "playlist-read-private",
-                    "playlist-modify-private",
-                    "playlist-modify-public",
-                ],
-            },
-        },
-        access: ["read", "write"],
-    },
-    "x-oauth": {
-        id: "x-oauth",
-        name: "X (OAuth 2)",
-        description: "Posts and the person's profile on X, over the v2 API.",
-        docs: "https://developer.x.com/en/portal/dashboard",
-        api: "https://docs.x.com/x-api",
-        hosts: ["api.x.com"],
-        auth: {
-            kind: "oauth2-user",
-            authorizeUrl: "https://x.com/i/oauth2/authorize",
-            tokenUrl: "https://api.x.com/2/oauth2/token",
-            revokeUrl: "https://api.x.com/2/oauth2/revoke",
-            clientId: "X_OAUTH_CLIENT_ID",
-            clientSecret: "X_OAUTH_CLIENT_SECRET",
-            inject: "basic",
-            pkce: true,
-            scopeDialect: "space",
-            identity: {
-                url: "https://api.x.com/2/users/me",
-                label: "data.username",
-                id: "data.id",
-            },
-        },
-        scopeSets: {
-            identity: {
-                label: "X account (who you are)",
-                access: "read",
-                scopes: ["users.read", "tweet.read"],
-            },
-            "posts.read": {
-                label: "Posts and timelines (read)",
-                access: "read",
-                scopes: ["tweet.read", "users.read"],
-            },
-            "posts.write": {
-                label: "Posts (read and publish)",
-                access: "write",
-                scopes: ["tweet.read", "users.read", "tweet.write"],
-            },
-        },
-        alwaysRequested: ["offline.access"],
-        access: ["read", "write"],
-        hint: "OAuth 2 with PKCE on X's v2 API; X's OAuth 1.0a (the v1.1 media upload) stays an app secret.",
-    },
-    // Social networks, tagged `social`: the clients Postiz connected its
-    // channels with, once catalog entries every gateway reserved names for.
-    linkedin: {
-        id: "linkedin",
-        name: "LinkedIn",
-        description: "Posts on a member's profile and on the company pages they admin.",
-        docs: "https://www.linkedin.com/developers/apps",
-        api: "https://learn.microsoft.com/linkedin/",
-        hosts: ["api.linkedin.com"],
-        auth: {
-            kind: "oauth2-user",
-            authorizeUrl: "https://www.linkedin.com/oauth/v2/authorization",
-            tokenUrl: "https://www.linkedin.com/oauth/v2/accessToken",
-            clientId: "LINKEDIN_CLIENT_ID",
-            clientSecret: "LINKEDIN_CLIENT_SECRET",
-            inject: "form",
-            // PKCE is for LinkedIn's native apps; a web client sends the secret.
-            pkce: false,
-            scopeDialect: "space",
-            identity: {
-                url: "https://api.linkedin.com/v2/userinfo",
-                label: "name",
-                id: "sub",
-            },
-        },
-        scopeSets: {
-            identity: {
-                label: "LinkedIn account (who you are)",
-                access: "read",
-                scopes: ["openid", "profile"],
-            },
-            "posts.write": {
-                label: "Posts on your profile",
-                access: "write",
-                scopes: ["openid", "profile", "w_member_social"],
-            },
-            "pages.write": {
-                label: "Company pages you admin (read and post)",
-                access: "write",
-                scopes: [
-                    "rw_organization_admin",
-                    "w_organization_social",
-                    "r_organization_social",
-                ],
-            },
-        },
-        access: ["read", "write"],
-        tags: ["social"],
-        hint: "Add the Sign In with LinkedIn and Share on LinkedIn products to the app; company pages need the Community Management API. Refresh tokens come to approved partners only. Not yet tried against a live connect.",
-    },
-    facebook: {
-        id: "facebook",
-        name: "Facebook Pages",
-        description: "Facebook pages, and the Instagram business accounts linked to them.",
-        docs: "https://developers.facebook.com/apps",
-        api: "https://developers.facebook.com/docs/graph-api",
-        hosts: ["graph.facebook.com"],
-        auth: {
-            kind: "oauth2-user",
-            authorizeUrl: "https://www.facebook.com/v25.0/dialog/oauth",
-            tokenUrl: "https://graph.facebook.com/v25.0/oauth/access_token",
-            clientId: "FACEBOOK_APP_ID",
-            clientSecret: "FACEBOOK_APP_SECRET",
-            inject: "form",
-            pkce: false,
-            scopeDialect: "comma",
-            identity: {
-                url: "https://graph.facebook.com/v25.0/me",
-                label: "name",
-                id: "id",
-            },
-        },
-        scopeSets: {
-            identity: {
-                label: "Facebook account (who you are)",
-                access: "read",
-                scopes: ["public_profile"],
-            },
-            "pages.read": {
-                label: "Pages you manage and their insights (read)",
-                access: "read",
-                scopes: ["pages_show_list", "pages_read_engagement", "read_insights"],
-            },
-            "pages.write": {
-                label: "Pages you manage (read, post and reply)",
-                access: "write",
-                scopes: [
-                    "pages_show_list",
-                    "business_management",
-                    "pages_manage_posts",
-                    "pages_manage_engagement",
-                    "pages_read_engagement",
-                ],
-            },
-            "instagram.write": {
-                label: "Instagram business accounts linked to your pages",
-                access: "write",
-                scopes: [
-                    "pages_show_list",
-                    "instagram_basic",
-                    "instagram_content_publish",
-                    "instagram_manage_comments",
-                    "instagram_manage_insights",
-                ],
-            },
-        },
-        access: ["read", "write"],
-        tags: ["social"],
-        hint: "A Business app with Facebook Login. Meta issues no refresh token: a person reconnects when the token expires. Not yet tried against a live connect.",
-    },
-    instagram: {
-        id: "instagram",
-        name: "Instagram",
-        description: "An Instagram professional account on its own, without a Facebook page.",
-        docs: "https://developers.facebook.com/apps",
-        api: "https://developers.facebook.com/docs/instagram-platform",
-        hosts: ["graph.instagram.com"],
-        auth: {
-            kind: "oauth2-user",
-            authorizeUrl: "https://www.instagram.com/oauth/authorize",
-            tokenUrl: "https://api.instagram.com/oauth/access_token",
-            clientId: "INSTAGRAM_APP_ID",
-            clientSecret: "INSTAGRAM_APP_SECRET",
-            inject: "form",
-            pkce: false,
-            scopeDialect: "comma",
-            identity: {
-                url: "https://graph.instagram.com/me?fields=username",
-                label: "username",
-                id: "id",
-            },
-        },
-        scopeSets: {
-            identity: {
-                label: "Instagram account (who you are)",
-                access: "read",
-                scopes: ["instagram_business_basic"],
-            },
-            "insights.read": {
-                label: "Insights (read)",
-                access: "read",
-                scopes: [
-                    "instagram_business_basic",
-                    "instagram_business_manage_insights",
-                ],
-            },
-            "posts.write": {
-                label: "Posts and comments",
-                access: "write",
-                scopes: [
-                    "instagram_business_basic",
-                    "instagram_business_content_publish",
-                    "instagram_business_manage_comments",
-                ],
-            },
-        },
-        access: ["read", "write"],
-        tags: ["social"],
-        hint: "The Instagram API with Instagram Login, on a Meta app. The token lasts an hour; the long-lived exchange isn't done by the Gateway. Not yet tried against a live connect.",
-    },
-    threads: {
-        id: "threads",
-        name: "Threads",
-        description: "Posts, replies and insights on a Threads profile.",
-        docs: "https://developers.facebook.com/apps",
-        api: "https://developers.facebook.com/docs/threads",
-        hosts: ["graph.threads.net"],
-        auth: {
-            kind: "oauth2-user",
-            authorizeUrl: "https://threads.net/oauth/authorize",
-            tokenUrl: "https://graph.threads.net/oauth/access_token",
-            clientId: "THREADS_APP_ID",
-            clientSecret: "THREADS_APP_SECRET",
-            inject: "form",
-            pkce: false,
-            scopeDialect: "comma",
-            identity: {
-                url: "https://graph.threads.net/v1.0/me?fields=id,username",
-                label: "username",
-                id: "id",
-            },
-        },
-        scopeSets: {
-            identity: {
-                label: "Threads profile (who you are)",
-                access: "read",
-                scopes: ["threads_basic"],
-            },
-            "insights.read": {
-                label: "Insights (read)",
-                access: "read",
-                scopes: ["threads_basic", "threads_manage_insights"],
-            },
-            "posts.write": {
-                label: "Posts and replies",
-                access: "write",
-                scopes: [
-                    "threads_basic",
-                    "threads_content_publish",
-                    "threads_manage_replies",
-                ],
-            },
-        },
-        access: ["read", "write"],
-        tags: ["social"],
-        hint: "The Threads use case on a Meta app. The token lasts an hour; the long-lived exchange isn't done by the Gateway. Not yet tried against a live connect.",
-    },
-    youtube: {
-        id: "youtube",
-        name: "YouTube",
-        description: "YouTube channels and their analytics, and Google Business Profiles.",
-        docs: "https://console.cloud.google.com/apis/credentials",
-        api: "https://developers.google.com/youtube/v3",
-        hosts: [
-            "www.googleapis.com",
-            "youtubeanalytics.googleapis.com",
-            "mybusinessaccountmanagement.googleapis.com",
-            "mybusinessbusinessinformation.googleapis.com",
-            "mybusiness.googleapis.com",
-            "businessprofileperformance.googleapis.com",
-            "openidconnect.googleapis.com",
-        ],
-        auth: {
-            kind: "oauth2-user",
-            authorizeUrl: "https://accounts.google.com/o/oauth2/v2/auth",
-            tokenUrl: "https://oauth2.googleapis.com/token",
-            revokeUrl: "https://oauth2.googleapis.com/revoke",
-            clientId: "YOUTUBE_CLIENT_ID",
-            clientSecret: "YOUTUBE_CLIENT_SECRET",
-            inject: "form",
-            pkce: true,
-            scopeDialect: "google",
-            authorizeParams: { access_type: "offline", prompt: "consent" },
-            identity: {
-                url: "https://openidconnect.googleapis.com/v1/userinfo",
-                label: "email",
-                id: "sub",
-            },
-        },
-        scopeSets: {
-            identity: {
-                label: "Google account (who you are)",
-                access: "read",
-                scopes: [
-                    "https://www.googleapis.com/auth/userinfo.profile",
-                    "https://www.googleapis.com/auth/userinfo.email",
-                ],
-            },
-            "youtube.read": {
-                label: "YouTube channels and analytics (read)",
-                access: "read",
-                scopes: [
-                    "https://www.googleapis.com/auth/youtube.readonly",
-                    "https://www.googleapis.com/auth/yt-analytics.readonly",
-                ],
-            },
-            "youtube.write": {
-                label: "YouTube channels (upload and manage)",
-                access: "write",
-                scopes: [
-                    "https://www.googleapis.com/auth/youtube",
-                    "https://www.googleapis.com/auth/youtube.upload",
-                    "https://www.googleapis.com/auth/youtube.force-ssl",
-                ],
-            },
-            "business.write": {
-                label: "Google Business Profiles (read and post)",
-                access: "write",
-                scopes: ["https://www.googleapis.com/auth/business.manage"],
-            },
-        },
-        access: ["read", "write"],
-        tags: ["social"],
-        hint: "Its own Google Cloud project, apart from google-workspace's: YouTube's scopes need their own verification. Not yet tried against a live connect.",
-    },
-    reddit: {
-        id: "reddit",
-        name: "Reddit",
-        description: "Reading subreddits and posting as the person.",
-        docs: "https://www.reddit.com/prefs/apps",
-        api: "https://www.reddit.com/dev/api",
-        hosts: ["oauth.reddit.com"],
-        auth: {
-            kind: "oauth2-user",
-            authorizeUrl: "https://www.reddit.com/api/v1/authorize",
-            tokenUrl: "https://www.reddit.com/api/v1/access_token",
-            clientId: "REDDIT_CLIENT_ID",
-            clientSecret: "REDDIT_CLIENT_SECRET",
-            inject: "basic",
-            pkce: false,
-            scopeDialect: "space",
-            // A refresh token only with a permanent grant.
-            authorizeParams: { duration: "permanent" },
-            identity: {
-                url: "https://oauth.reddit.com/api/v1/me",
-                label: "name",
-                id: "id",
-            },
-        },
-        scopeSets: {
-            identity: {
-                label: "Reddit account (who you are)",
-                access: "read",
-                scopes: ["identity"],
-            },
-            "posts.read": {
-                label: "Subreddits and posts (read)",
-                access: "read",
-                scopes: ["identity", "read"],
-            },
-            "posts.write": {
-                label: "Posts (read, submit and flair)",
-                access: "write",
-                scopes: ["identity", "read", "submit", "flair"],
-            },
-        },
-        access: ["read", "write"],
-        tags: ["social"],
-        hint: "A web app on Reddit's apps page. Not yet tried against a live connect.",
-    },
-    pinterest: {
-        id: "pinterest",
-        name: "Pinterest",
-        description: "Boards and pins on a Pinterest account.",
-        docs: "https://developers.pinterest.com/apps/",
-        api: "https://developers.pinterest.com/docs/api/v5/",
-        hosts: ["api.pinterest.com"],
-        auth: {
-            kind: "oauth2-user",
-            authorizeUrl: "https://www.pinterest.com/oauth/",
-            tokenUrl: "https://api.pinterest.com/v5/oauth/token",
-            clientId: "PINTEREST_CLIENT_ID",
-            clientSecret: "PINTEREST_CLIENT_SECRET",
-            inject: "basic",
-            pkce: false,
-            scopeDialect: "comma",
-            identity: {
-                url: "https://api.pinterest.com/v5/user_account",
-                label: "username",
-                id: "id",
-            },
-        },
-        scopeSets: {
-            identity: {
-                label: "Pinterest account (who you are)",
-                access: "read",
-                scopes: ["user_accounts:read"],
-            },
-            "pins.read": {
-                label: "Boards and pins (read)",
-                access: "read",
-                scopes: ["user_accounts:read", "boards:read", "pins:read"],
-            },
-            "pins.write": {
-                label: "Boards and pins (read and write)",
-                access: "write",
-                scopes: [
-                    "user_accounts:read",
-                    "boards:read",
-                    "boards:write",
-                    "pins:read",
-                    "pins:write",
-                ],
-            },
-        },
-        access: ["read", "write"],
-        tags: ["social"],
-        hint: "Not yet tried against a live connect.",
-    },
-    discord: {
-        id: "discord",
-        name: "Discord",
-        description: "The person's Discord account and servers, and installing a bot in a server.",
-        docs: "https://discord.com/developers/applications",
-        api: "https://discord.com/developers/docs/reference",
-        hosts: ["discord.com"],
-        auth: {
-            kind: "oauth2-user",
-            authorizeUrl: "https://discord.com/oauth2/authorize",
-            tokenUrl: "https://discord.com/api/oauth2/token",
-            revokeUrl: "https://discord.com/api/oauth2/token/revoke",
-            clientId: "DISCORD_CLIENT_ID",
-            clientSecret: "DISCORD_CLIENT_SECRET",
-            inject: "basic",
-            pkce: true,
-            scopeDialect: "space",
-            identity: {
-                url: "https://discord.com/api/users/@me",
-                label: "username",
-                id: "id",
-            },
-        },
-        scopeSets: {
-            identity: {
-                label: "Discord account (who you are)",
-                access: "read",
-                scopes: ["identify"],
-            },
-            "servers.read": {
-                label: "Servers you are in (read)",
-                access: "read",
-                scopes: ["identify", "guilds"],
-            },
-            "bot.write": {
-                label: "Add the bot to a server",
-                access: "write",
-                scopes: ["identify", "guilds", "bot"],
-            },
-        },
-        access: ["read", "write"],
-        tags: ["social"],
-        hint: "Posting as the bot uses the bot's own token, an app secret the Gateway doesn't hold. Not yet tried against a live connect.",
-    },
-    kick: {
-        id: "kick",
-        name: "Kick",
-        description: "A Kick channel and its chat.",
-        docs: "https://kick.com/settings/developer",
-        api: "https://docs.kick.com/",
-        hosts: ["api.kick.com"],
-        auth: {
-            kind: "oauth2-user",
-            authorizeUrl: "https://id.kick.com/oauth/authorize",
-            tokenUrl: "https://id.kick.com/oauth/token",
-            clientId: "KICK_CLIENT_ID",
-            clientSecret: "KICK_CLIENT_SECRET",
-            inject: "form",
-            pkce: true,
-            scopeDialect: "space",
-        },
-        scopeSets: {
-            identity: {
-                label: "Kick account (who you are)",
-                access: "read",
-                scopes: ["user:read"],
-            },
-            "channel.read": {
-                label: "Your channel (read)",
-                access: "read",
-                scopes: ["user:read", "channel:read"],
-            },
-            "chat.write": {
-                label: "Chat messages",
-                access: "write",
-                scopes: ["user:read", "chat:write"],
-            },
-        },
-        access: ["read", "write"],
-        tags: ["social"],
-        hint: "Not yet tried against a live connect.",
-    },
-    twitch: {
-        id: "twitch",
-        name: "Twitch",
-        description: "A Twitch channel's chat and announcements.",
-        docs: "https://dev.twitch.tv/console/apps",
-        api: "https://dev.twitch.tv/docs/api/",
-        hosts: ["api.twitch.tv"],
-        auth: {
-            kind: "oauth2-user",
-            authorizeUrl: "https://id.twitch.tv/oauth2/authorize",
-            tokenUrl: "https://id.twitch.tv/oauth2/token",
-            clientId: "TWITCH_CLIENT_ID",
-            clientSecret: "TWITCH_CLIENT_SECRET",
-            inject: "form",
-            pkce: false,
-            scopeDialect: "space",
-        },
-        scopeSets: {
-            "chat.read": {
-                label: "Chat (read)",
-                access: "read",
-                scopes: ["user:read:chat"],
-            },
-            "chat.write": {
-                label: "Chat messages and announcements",
-                access: "write",
-                scopes: [
-                    "user:read:chat",
-                    "user:write:chat",
-                    "moderator:manage:announcements",
-                ],
-            },
-        },
-        access: ["read", "write"],
-        tags: ["social"],
-        hint: "Helix also wants the public client id as a Client-Id header on every call. Not yet tried against a live connect.",
-    },
-    tumblr: {
-        id: "tumblr",
-        name: "Tumblr",
-        description: "Posting to the person's Tumblr blogs.",
-        docs: "https://www.tumblr.com/oauth/apps",
-        api: "https://www.tumblr.com/docs/en/api/v2",
-        hosts: ["api.tumblr.com"],
-        auth: {
-            kind: "oauth2-user",
-            authorizeUrl: "https://www.tumblr.com/oauth2/authorize",
-            tokenUrl: "https://api.tumblr.com/v2/oauth2/token",
-            clientId: "TUMBLR_CLIENT_ID",
-            clientSecret: "TUMBLR_CLIENT_SECRET",
-            inject: "form",
-            pkce: false,
-            scopeDialect: "space",
-            identity: {
-                url: "https://api.tumblr.com/v2/user/info",
-                label: "response.user.name",
-            },
-        },
-        scopeSets: {
-            identity: {
-                label: "Tumblr account (who you are)",
-                access: "read",
-                scopes: ["basic"],
-            },
-            "posts.write": {
-                label: "Posts on your blogs",
-                access: "write",
-                scopes: ["basic", "write"],
-            },
-        },
-        alwaysRequested: ["offline_access"],
-        access: ["read", "write"],
-        tags: ["social"],
-        hint: "Not yet tried against a live connect.",
     },
 };
 /** The preset ids, in the order the picker shows them. */