Add Vercel Plugin

.github/CODEOWNERS

@@ -3,6 +3,9 @@
 /LICENSE             @squaredup/community-moderators
 /.github/*           @squaredup/community-moderators
 
+# Fallback – if a plugin has no specified author
+plugins/* @squaredup/community-moderators
+
 # Request review from original author
 plugins/AutoTask/*  @TimWheeler-SQUP
 plugins/DattoRMM/*  @TimWheeler-SQUP
@@ -25,7 +28,6 @@ plugins/UniFi/*  @adamkinniburgh
 plugins/UptimeRobot/*  @kieranlangton
 plugins/WorldCup2026/*  @TimWheeler-SQUP
 plugins/Algolia/* @andrewmumblebee
+plugins/Vercel/* @andrewmumblebee
 
 
-# Fallback – if a plugin has no specified author
-plugins/* @squaredup/community-moderators

plugins/Vercel/v1/configValidation.json

@@ -0,0 +1,11 @@
+{
+    "steps": [
+        {
+            "displayName": "Authenticate",
+            "dataStream": { "name": "currentUser" },
+            "required": true,
+            "error": "Could not authenticate with Vercel. Check that your API token is valid and has not expired.",
+            "success": "Connected to Vercel successfully."
+        }
+    ]
+}

plugins/Vercel/v1/custom_types.json

@@ -0,0 +1,23 @@
+[
+    {
+        "name": "Project",
+        "sourceType": "Project",
+        "icon": "rocket",
+        "singular": "Project",
+        "plural": "Projects"
+    },
+    {
+        "name": "Domain",
+        "sourceType": "Domain",
+        "icon": "globe",
+        "singular": "Domain",
+        "plural": "Domains"
+    },
+    {
+        "name": "Team",
+        "sourceType": "Team",
+        "icon": "people-group",
+        "singular": "Team",
+        "plural": "Teams"
+    }
+]

plugins/Vercel/v1/dataStreams/activity.json

@@ -0,0 +1,43 @@
+{
+    "name": "activity",
+    "displayName": "Activity",
+    "description": "Vercel account or team activity feed, one row per audit-style event",
+    "tags": ["Activity"],
+    "baseDataSourceName": "httpRequestUnscoped",
+    "config": {
+        "httpMethod": "get",
+        "endpointPath": "v3/events",
+        "pathToData": "events",
+        "expandInnerObjects": true,
+        "getArgs": [
+            { "key": "since", "value": "{{timeframe.start}}" },
+            { "key": "until", "value": "{{timeframe.end}}" },
+            { "key": "limit", "value": "5000" }
+        ],
+        "paging": {
+            "mode": "none"
+        }
+    },
+    "matches": "none",
+    "metadata": [
+        { "name": "id", "displayName": "ID", "role": "id", "visible": false },
+        { "name": "type", "displayName": "Type" },
+        { "name": "text", "displayName": "Summary", "role": "label" },
+        {
+            "name": "actor",
+            "displayName": "Actor",
+            "computed": true,
+            "valueExpression": "{{ $['user.username'] || $['user.email'] || $['userId'] }}"
+        },
+        { "name": "user.username", "displayName": "User", "visible": false },
+        { "name": "user.email", "displayName": "Email", "visible": false },
+        { "name": "userId", "displayName": "User ID", "visible": false },
+        {
+            "name": "createdAt",
+            "displayName": "Created",
+            "shape": "date",
+            "role": "timestamp"
+        }
+    ],
+    "timeframes": true
+}

plugins/Vercel/v1/dataStreams/currentUser.json

@@ -0,0 +1,21 @@
+{
+    "name": "currentUser",
+    "displayName": "Current User",
+    "description": "Returns the authenticated Vercel user. Used to validate the connection",
+    "tags": ["User"],
+    "baseDataSourceName": "httpRequestUnscoped",
+    "config": {
+        "httpMethod": "get",
+        "endpointPath": "v2/user",
+        "postRequestScript": "currentUser.js"
+    },
+    "matches": "none",
+    "metadata": [
+        { "name": "id", "displayName": "ID", "visible": false },
+        { "name": "username", "displayName": "Username", "role": "label" },
+        { "name": "name", "displayName": "Name" },
+        { "name": "email", "displayName": "Email" }
+    ],
+    "timeframes": false,
+    "visibility": { "type": "hidden" }
+}

plugins/Vercel/v1/dataStreams/deployments.json

@@ -0,0 +1,97 @@
+{
+    "name": "deployments",
+    "displayName": "Deployments",
+    "description": "Vercel deployments across the account or a selected project, one row per deployment",
+    "tags": ["Deployments"],
+    "baseDataSourceName": "httpRequestUnscoped",
+    "providesPluginDiagnostics": true,
+    "config": {
+        "httpMethod": "get",
+        "endpointPath": "v7/deployments",
+        "postRequestScript": "deployments.js",
+        "getArgs": [
+            { "key": "since", "value": "{{timeframe.unixStart * 1000}}" },
+            { "key": "projectIds", "value": "{{ project?.map(p => p.rawId) }}" }
+        ],
+        "paging": {
+            "mode": "token",
+            "pageSize": {
+                "realm": "queryArg",
+                "path": "limit",
+                "value": "100"
+            },
+            "in": { "realm": "payload", "path": "pagination.next" },
+            "out": { "realm": "queryArg", "path": "until" }
+        }
+    },
+    "matches": "none",
+    "ui": [
+        {
+            "type": "objects",
+            "name": "project",
+            "label": "Project (optional)",
+            "matches": {
+                "sourceType": { "type": "equals", "value": "Project" }
+            }
+        }
+    ],
+    "metadata": [
+        {
+            "name": "uid",
+            "displayName": "ID",
+            "role": "value",
+            "visible": false
+        },
+        { "name": "name", "displayName": "Name", "role": "label" },
+        {
+            "name": "state",
+            "displayName": "State",
+            "shape": [
+                "state",
+                {
+                    "map": {
+                        "success": ["READY"],
+                        "error": ["ERROR", "CANCELED"],
+                        "warning": ["BUILDING", "QUEUED", "INITIALIZING"],
+                        "unknown": ["DELETED"]
+                    }
+                }
+            ]
+        },
+        { "name": "target", "displayName": "Target" },
+        { "name": "projectId", "displayName": "Project ID", "visible": false },
+        {
+            "name": "created",
+            "displayName": "Created",
+            "shape": "date",
+            "role": "timestamp"
+        },
+        { "name": "url", "displayName": "URL", "shape": "url" },
+        {
+            "name": "inspectorUrl",
+            "displayName": "Inspector URL",
+            "shape": "url"
+        },
+        { "name": "creator", "displayName": "Creator" },
+        {
+            "name": "ready",
+            "displayName": "Ready",
+            "shape": "date",
+            "role": "timestamp"
+        },
+        {
+            "name": "buildingAt",
+            "displayName": "Building At",
+            "shape": "date",
+            "role": "timestamp"
+        },
+        {
+            "name": "createdAt",
+            "displayName": "Created At",
+            "shape": "date",
+            "role": "timestamp"
+        },
+        { "pattern": ".*" }
+    ],
+    "timeframes": true
+}

plugins/Vercel/v1/dataStreams/domainConfig.json

@@ -0,0 +1,30 @@
+{
+    "name": "domainConfig",
+    "displayName": "Domain Config",
+    "description": "Configuration health for a single Vercel domain",
+    "tags": ["Domain"],
+    "baseDataSourceName": "httpRequestScopedSingle",
+    "config": {
+        "httpMethod": "get",
+        "endpointPath": "v6/domains/{{object.name}}/config"
+    },
+    "matches": { "sourceType": { "type": "equals", "value": "Domain" } },
+    "metadata": [
+        {
+            "name": "misconfigured",
+            "displayName": "Misconfigured",
+            "shape": "boolean"
+        },
+        {
+            "name": "serviceType",
+            "displayName": "Service Type",
+            "shape": "string"
+        },
+        {
+            "name": "configuredBy",
+            "displayName": "Configured By",
+            "shape": "string"
+        }
+    ],
+    "timeframes": false
+}

plugins/Vercel/v1/dataStreams/domains.json

@@ -0,0 +1,34 @@
+{
+    "name": "domains",
+    "displayName": "Domains",
+    "description": "Lists Vercel custom domains in the configured account or team",
+    "tags": ["Domain"],
+    "baseDataSourceName": "httpRequestUnscoped",
+    "config": {
+        "httpMethod": "get",
+        "endpointPath": "v5/domains",
+        "pathToData": "domains",
+        "paging": {
+            "mode": "token",
+            "pageSize": {
+                "realm": "queryArg",
+                "path": "limit",
+                "value": "100"
+            },
+            "in": { "realm": "payload", "path": "pagination.next" },
+            "out": { "realm": "queryArg", "path": "until" }
+        }
+    },
+    "matches": "none",
+    "metadata": [
+        { "name": "id", "displayName": "ID", "visible": false },
+        { "name": "name", "displayName": "Domain", "role": "label" },
+        { "name": "verified", "displayName": "Verified" },
+        { "name": "serviceType", "displayName": "Service Type" },
+        { "name": "expiresAt", "displayName": "Expires", "shape": "date" },
+        { "name": "boughtAt", "displayName": "Bought", "shape": "date" },
+        { "name": "renew", "displayName": "Auto-renew" },
+        { "name": "createdAt", "displayName": "Created", "shape": "date" }
+    ],
+    "timeframes": false
+}

plugins/Vercel/v1/dataStreams/firewallEvents.json

@@ -0,0 +1,69 @@
+{
+    "name": "firewallEvents",
+    "displayName": "Firewall Events",
+    "description": "Per-action firewall event counts over the timeframe for a single Vercel project",
+    "tags": ["Security", "Firewall"],
+    "baseDataSourceName": "httpRequestScopedSingle",
+    "config": {
+        "httpMethod": "get",
+        "endpointPath": "v1/security/firewall/events",
+        "getArgs": [
+            { "key": "projectId", "value": "{{object.rawId}}" },
+            {
+                "key": "startTimestamp",
+                "value": "{{timeframe.unixStart * 1000}}"
+            },
+            { "key": "endTimestamp", "value": "{{timeframe.unixEnd * 1000}}" }
+        ],
+        "pathToData": "actions"
+    },
+    "matches": {
+        "sourceType": { "type": "equals", "value": "Project" }
+    },
+    "metadata": [
+        {
+            "name": "startTime",
+            "displayName": "Time",
+            "shape": "date",
+            "role": "timestamp"
+        },
+        {
+            "name": "action",
+            "displayName": "Action",
+            "shape": "string",
+            "role": "label"
+        },
+        {
+            "name": "count",
+            "displayName": "Count",
+            "shape": "number",
+            "role": "value"
+        },
+        {
+            "name": "host",
+            "displayName": "Host",
+            "shape": "string"
+        },
+        {
+            "name": "public_ip",
+            "displayName": "Public IP",
+            "shape": "string"
+        },
+        {
+            "name": "action_type",
+            "displayName": "Action Category",
+            "shape": "string",
+            "visible": false
+        },
+        {
+            "name": "isActive",
+            "displayName": "Active",
+            "shape": "boolean",
+            "visible": false
+        },
+        {
+            "pattern": ".*"
+        }
+    ],
+    "timeframes": true
+}

plugins/Vercel/v1/dataStreams/projectInfo.json

@@ -0,0 +1,36 @@
+{
+    "name": "projectInfo",
+    "displayName": "Project Info",
+    "description": "Per-project detail (framework, Node version, timestamps, git repo) for a single Vercel project",
+    "tags": ["Project"],
+    "baseDataSourceName": "httpRequestScopedSingle",
+    "config": {
+        "httpMethod": "get",
+        "endpointPath": "v9/projects/{{object.rawId}}",
+        "expandInnerObjects": true
+    },
+    "matches": { "sourceType": { "type": "equals", "value": "Project" } },
+    "metadata": [
+        {
+            "name": "name",
+            "displayName": "Name",
+            "shape": "string",
+            "role": "label"
+        },
+        { "name": "framework", "displayName": "Framework", "shape": "string" },
+        {
+            "name": "nodeVersion",
+            "displayName": "Node Version",
+            "shape": "string"
+        },
+        { "name": "createdAt", "displayName": "Created", "shape": "date" },
+        { "name": "updatedAt", "displayName": "Updated", "shape": "date" },
+        { "name": "link.repo", "displayName": "Git Repo", "shape": "string" },
+        {
+            "name": "link.type",
+            "displayName": "Git Provider",
+            "shape": "string"
+        }
+    ],
+    "timeframes": false
+}