@rawdash/connector-vercel 0.15.0

package/README.md

@@ -0,0 +1,185 @@
+# @rawdash/connector-vercel
+
+Rawdash connector for [Vercel](https://vercel.com) — syncs projects, deployments, and deployment state-transition events into the six-shape storage model. Pairs with `@rawdash/connector-github` for "is this deploy healthy" widgets.
+
+## Auth setup
+
+The connector authenticates with a Vercel access token. Two flavours work:
+
+- **Personal access token** (recommended for single-user installs): Vercel → **Account Settings → Tokens → Create**. Scope it to the team you want to sync, or leave it user-scoped.
+- **Team access token**: Vercel → **Team Settings → Security → Tokens → Create**. You must set `teamId` in the config for the token to read team resources.
+
+The token only needs read permissions for projects and deployments. No webhook configuration is required.
+
+## Configuration
+
+```ts
+import { secret } from '@rawdash/core';
+
+const vercel = {
+  name: 'vercel',
+  connectorId: 'vercel',
+  config: {
+    apiToken: secret('VERCEL_API_TOKEN'),
+    // teamId: 'team_abc123',                       // optional — needed for team tokens
+    // projects: ['prj_one', 'prj_two'],            // optional — restrict deployments to specific projects
+    // resources: ['projects', 'deployments'],      // optional — defaults to all three
+    // deploymentsLookbackDays: 30,                 // optional — backfill window for full sync (default 30)
+  },
+};
+```
+
+Register the connector class when mounting the engine:
+
+```ts
+import { VercelConnector } from '@rawdash/connector-vercel';
+import { mountEngine } from '@rawdash/hono';
+
+mountEngine(config, { connectorRegistry: { vercel: VercelConnector } });
+```
+
+### Choosing resources
+
+The connector exposes three resources, written across two internal sync phases:
+
+| Resource            | Phase       | What gets written                                                                                        |
+| ------------------- | ----------- | -------------------------------------------------------------------------------------------------------- |
+| `projects`          | projects    | `vercel_project` entities, one per Vercel project                                                        |
+| `deployments`       | deployments | `vercel_deployment` entities, one per deployment, with build duration and git ref attributes             |
+| `deployment_events` | deployments | `vercel_deployment_event` events, one per deployment with `start_ts=createdAt`, `end_ts=ready` (or null) |
+
+`deployment_events` shares the `deployments` phase because each event is derived from the same payload as its parent deployment entity. Enabling `deployment_events` without `deployments` still runs the deployments query (so the events have data to emit) but skips writing the deployment entities themselves.
+
+### Example dashboard
+
+```ts
+import { defineConfig, defineDashboard, defineMetric } from '@rawdash/core';
+
+export default defineConfig({
+  connectors: [vercel],
+  dashboards: {
+    deploys: defineDashboard({
+      widgets: {
+        deploys_today: {
+          kind: 'stat',
+          title: 'Deploys today',
+          metric: defineMetric({
+            connector: vercel,
+            shape: 'event',
+            name: 'vercel_deployment_event',
+            field: 'start_ts',
+            fn: 'count',
+            window: '24h',
+          }),
+        },
+        deploy_failure_rate_7d: {
+          kind: 'stat',
+          title: 'Failure rate (7d)',
+          metric: defineMetric({
+            connector: vercel,
+            shape: 'event',
+            name: 'vercel_deployment_event',
+            field: 'start_ts',
+            fn: 'count',
+            window: '7d',
+            filter: [{ field: 'state', op: 'eq', value: 'ERROR' }],
+          }),
+        },
+        deploys_by_project: {
+          kind: 'distribution',
+          title: 'Deploys by project',
+          metric: defineMetric({
+            connector: vercel,
+            shape: 'event',
+            name: 'vercel_deployment_event',
+            fn: 'count',
+            window: '7d',
+            groupBy: { field: 'projectId' },
+          }),
+        },
+        deploys_per_day: {
+          kind: 'timeseries',
+          title: 'Daily deploys',
+          window: '14d',
+          metric: defineMetric({
+            connector: vercel,
+            shape: 'event',
+            name: 'vercel_deployment_event',
+            field: 'start_ts',
+            fn: 'count',
+            window: '14d',
+            groupBy: { field: 'start_ts', granularity: 'day' },
+          }),
+        },
+      },
+    }),
+  },
+});
+```
+
+## Data model
+
+| Storage shape | Entity/event type         | Key attributes                                                                                                                                          |
+| ------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| entity        | `vercel_project`          | name, framework, accountId, createdAt, updatedAt                                                                                                        |
+| entity        | `vercel_deployment`       | deploymentId, name, url, state, target, projectId, creatorUid, creatorUsername, source, gitRef, gitSha, createdAt, buildingAt, readyAt, buildDurationMs |
+| event         | `vercel_deployment_event` | same attribute set as `vercel_deployment`. `start_ts = createdAt`, `end_ts = ready` (or `null` for in-flight builds).                                   |
+
+Timestamps are stored as Unix epoch milliseconds. `buildDurationMs` is computed as `ready - buildingAt` when both are present, otherwise `null`. The `gitRef` attribute prefers `meta.githubCommitRef`, falling back to `gitlabCommitRef`, `bitbucketCommitRef`, then `meta.branch`.
+
+## Schemas
+
+`VercelConnector.schemas` declares the Zod schema for each resource's raw API response. Used by the cloud shape-drift pipeline to populate `connector_baselines`, and by the package's property tests.
+
+| Resource      | Represents                 |
+| ------------- | -------------------------- |
+| `projects`    | `GET /v9/projects` page    |
+| `deployments` | `GET /v6/deployments` page |
+
+## Sync behaviour
+
+- **Backfill** (`mode: 'full'`): paginates `/v9/projects` and `/v6/deployments` via Vercel's `pagination.next` cursor (page size 100), passing the returned millisecond timestamp back as the `until` query param. Project and deployment entity scopes (plus the `vercel_deployment_event` event scope) are cleared at the start of their phase so deletions in Vercel converge. Deployments are bounded by `deploymentsLookbackDays` (default 30) — the connector sets `since` on the first page to cap the backfill window.
+- **Incremental** (`mode: 'latest'`): applies `since={ms}` to the deployments endpoint so only deployments newer than the last sync are pulled. Projects are still refreshed on every sync since the list is small.
+- **Rate limits**: Vercel sends `X-RateLimit-Remaining` and `X-RateLimit-Reset` (Unix seconds) — the connector reports the parsed state back to the host so the engine can budget future requests. 429 responses are surfaced as `RateLimitError` by the shared HTTP client.
+- **Resumable**: every paginated phase yields a `{ phase, page }` cursor (`ChunkedSyncCursor<TPhase, TPage>`) where `page` is the sanitized pagination URL. Pagination URLs are validated on the way in — only `https://api.vercel.com/v9/projects` and `https://api.vercel.com/v6/deployments` are accepted — to prevent a malicious or corrupted cursor from steering a follow-up request elsewhere.
+
+## Errors
+
+`@rawdash/connector-shared` maps Vercel's HTTP responses to typed errors automatically:
+
+- `401` / `403` → `AuthError` — host stops syncing until the token is replaced.
+- `429` → `RateLimitError` — host backs off and reschedules.
+- `5xx` → `TransientError` — host retries on the next tick.
+
+## Out of scope (post-v0.1)
+
+- **Web Vitals / Speed Insights** — Vercel does not expose aggregated p75 metrics via the public REST API; the dashboard surface and Insights API require a different access pattern (per-page-view event ingest). Tracking as a follow-up.
+- **Edge function logs** — high volume, low signal for a dashboard widget. Use the Vercel log drain integration instead.
+- **DNS / Domain APIs** — not dashboard-shaped.
+
+## Registering in the MCP server
+
+```ts
+import { VercelConnector, configFields } from '@rawdash/connector-vercel';
+
+createMcpServer({
+  // ...
+  connectorFactories: [
+    {
+      id: 'vercel',
+      configFields,
+      create: VercelConnector.create,
+    },
+  ],
+});
+```
+
+## Property tests
+
+Resources in this connector have fast-check property tests under `src/property.test.ts` that:
+
+1. Generate synthetic API payloads from a Zod schema mirroring Vercel's response shape.
+2. Pipe them through `connector.sync()` against an `InMemoryStorage` instance.
+3. Assert universal invariants — non-empty entity ids, finite event timestamps, no `undefined` reaching storage, no thrown errors on any valid input — plus per-resource counts.
+
+The helper lives in `@rawdash/connector-test-utils`. When adding a new resource, add a Zod schema for its payload and a test wired up via `runPropertySyncTest`.

package/dist/index.d.ts

@@ -0,0 +1,109 @@
+import { BaseConnector, ConnectorContext, SyncOptions, StorageHandle, SyncResult } from '@rawdash/core';
+import { z } from 'zod';
+
+declare const configFields: z.ZodObject<{
+    apiToken: z.ZodObject<{
+        $secret: z.ZodString;
+    }, z.core.$strip>;
+    teamId: z.ZodOptional<z.ZodString>;
+    projects: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    resources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        projects: "projects";
+        deployments: "deployments";
+        deployment_events: "deployment_events";
+    }>>>;
+    deploymentsLookbackDays: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type VercelResource = 'projects' | 'deployments' | 'deployment_events';
+interface VercelSettings {
+    teamId?: string;
+    projects?: readonly string[];
+    resources?: readonly VercelResource[];
+    deploymentsLookbackDays?: number;
+}
+declare const vercelCredentials: {
+    apiToken: {
+        description: string;
+        auth: "required";
+    };
+};
+type VercelCredentials = typeof vercelCredentials;
+declare class VercelConnector extends BaseConnector<VercelSettings, VercelCredentials> {
+    static readonly id = "vercel";
+    static readonly schemas: {
+        readonly projects: z.ZodObject<{
+            projects: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                framework: z.ZodNullable<z.ZodString>;
+                createdAt: z.ZodNumber;
+                updatedAt: z.ZodNumber;
+            }, z.core.$strip>>;
+            pagination: z.ZodObject<{
+                count: z.ZodNumber;
+                next: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        readonly deployments: z.ZodObject<{
+            deployments: z.ZodArray<z.ZodObject<{
+                uid: z.ZodString;
+                name: z.ZodString;
+                url: z.ZodString;
+                created: z.ZodNumber;
+                state: z.ZodEnum<{
+                    BUILDING: "BUILDING";
+                    ERROR: "ERROR";
+                    INITIALIZING: "INITIALIZING";
+                    QUEUED: "QUEUED";
+                    READY: "READY";
+                    CANCELED: "CANCELED";
+                }>;
+                target: z.ZodNullable<z.ZodEnum<{
+                    production: "production";
+                    staging: "staging";
+                    preview: "preview";
+                }>>;
+                creator: z.ZodObject<{
+                    uid: z.ZodString;
+                    username: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>;
+                buildingAt: z.ZodNullable<z.ZodNumber>;
+                ready: z.ZodNullable<z.ZodNumber>;
+                source: z.ZodNullable<z.ZodString>;
+                meta: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>>>;
+                projectId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strip>>;
+            pagination: z.ZodObject<{
+                count: z.ZodNumber;
+                next: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    };
+    static create(input: unknown, ctx?: ConnectorContext): VercelConnector;
+    readonly id = "vercel";
+    readonly credentials: {
+        apiToken: {
+            description: string;
+            auth: "required";
+        };
+    };
+    private buildHeaders;
+    private fetch;
+    private isResourceEnabled;
+    private activePhases;
+    private allowedPagePath;
+    private sanitizePageUrl;
+    private resolveCursor;
+    private withTeamId;
+    private buildInitialProjectsUrl;
+    private buildInitialDeploymentsUrl;
+    private computeDeploymentsSinceMs;
+    private buildNextPageUrl;
+    private fetchProjectsPage;
+    private fetchDeploymentsPage;
+    private writeProjects;
+    private writeDeployments;
+    sync(options: SyncOptions, storage: StorageHandle, signal?: AbortSignal): Promise<SyncResult>;
+}
+
+export { VercelConnector, type VercelResource, type VercelSettings, configFields, VercelConnector as default };

package/dist/index.js

@@ -0,0 +1,427 @@
+// src/vercel.ts
+import {
+  BaseConnector,
+  defineConfigFields,
+  paginateChunked
+} from "@rawdash/core";
+import { z } from "zod";
+var configFields = defineConfigFields(
+  z.object({
+    apiToken: z.object({ $secret: z.string() }).meta({
+      label: "API Token",
+      description: "Vercel access token (Personal or Team). Create one at Vercel \u2192 Account Settings \u2192 Tokens.",
+      placeholder: "vercel_token",
+      secret: true
+    }),
+    teamId: z.string().min(1).optional().meta({
+      label: "Team ID (optional)",
+      description: "Vercel team ID (slug or `team_...`). Omit to use the token owner scope. Required if the token is a team token.",
+      placeholder: "team_abc123"
+    }),
+    projects: z.array(z.string().min(1)).nonempty().optional().meta({
+      label: "Projects (optional)",
+      description: "Restrict deployment sync to specific Vercel project IDs (e.g. `prj_...`). Omit to sync every project the token can see."
+    }),
+    resources: z.array(z.enum(["projects", "deployments", "deployment_events"])).nonempty().optional().meta({
+      label: "Resources",
+      description: "Which Vercel resources to sync. Omit to sync all of them. 'deployment_events' depends on 'deployments' being fetched \u2014 enabling it without 'deployments' still runs the deployments query, but skips writing deployment entities."
+    }),
+    deploymentsLookbackDays: z.number().int().positive().max(365).optional().meta({
+      label: "Deployments lookback (days)",
+      description: "How many days back to fetch deployments on a full sync. Defaults to 30. Vercel returns deployments newest-first; this caps the backfill window.",
+      placeholder: "30"
+    })
+  })
+);
+var vercelCredentials = {
+  apiToken: {
+    description: "Vercel access token",
+    auth: "required"
+  }
+};
+var vercelRateLimit = {
+  parse(h) {
+    const remainingRaw = h.get("x-ratelimit-remaining");
+    const resetRaw = h.get("x-ratelimit-reset");
+    if (remainingRaw === null || resetRaw === null) {
+      return null;
+    }
+    const remaining = Number(remainingRaw);
+    const reset = Number(resetRaw);
+    if (!Number.isFinite(remaining) || !Number.isFinite(reset) || reset < 0) {
+      return null;
+    }
+    return { remaining, resetAt: new Date(reset * 1e3) };
+  }
+};
+var PHASE_ORDER = ["projects", "deployments"];
+function isVercelSyncCursor(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  const v = value;
+  if (typeof v.phase !== "string") {
+    return false;
+  }
+  if (!PHASE_ORDER.includes(v.phase)) {
+    return false;
+  }
+  if (v.page !== null && typeof v.page !== "string") {
+    return false;
+  }
+  return true;
+}
+var idString = z.string().min(1);
+var nonNegInt = z.number().int().nonnegative();
+var paginationSchema = z.object({
+  count: nonNegInt,
+  next: nonNegInt.nullable()
+});
+var projectSchema = z.object({
+  id: idString,
+  name: z.string().min(1),
+  framework: z.string().nullable(),
+  createdAt: nonNegInt,
+  updatedAt: nonNegInt
+});
+var projectsResponseSchema = z.object({
+  projects: z.array(projectSchema),
+  pagination: paginationSchema
+});
+var deploymentStateSchema = z.enum([
+  "BUILDING",
+  "ERROR",
+  "INITIALIZING",
+  "QUEUED",
+  "READY",
+  "CANCELED"
+]);
+var deploymentTargetSchema = z.enum(["production", "staging", "preview"]).nullable();
+var deploymentSchema = z.object({
+  uid: idString,
+  name: z.string(),
+  url: z.string(),
+  created: nonNegInt,
+  state: deploymentStateSchema,
+  target: deploymentTargetSchema,
+  creator: z.object({
+    uid: idString,
+    username: z.string().nullable()
+  }),
+  buildingAt: nonNegInt.nullable(),
+  ready: nonNegInt.nullable(),
+  source: z.string().nullable(),
+  meta: z.record(z.string(), z.string().nullable()).nullable().optional(),
+  projectId: z.string().nullable().optional()
+});
+var deploymentsResponseSchema = z.object({
+  deployments: z.array(deploymentSchema),
+  pagination: paginationSchema
+});
+var VERCEL_API_HOST = "api.vercel.com";
+var VERCEL_API_BASE = `https://${VERCEL_API_HOST}`;
+var PROJECTS_PAGE_SIZE = 100;
+var DEPLOYMENTS_PAGE_SIZE = 100;
+var DEFAULT_LOOKBACK_DAYS = 30;
+var MS_PER_DAY = 24 * 60 * 60 * 1e3;
+var VercelConnector = class _VercelConnector extends BaseConnector {
+  static id = "vercel";
+  static schemas = {
+    projects: projectsResponseSchema,
+    deployments: deploymentsResponseSchema
+  };
+  static create(input, ctx) {
+    const parsed = configFields.parse(input);
+    return new _VercelConnector(
+      {
+        teamId: parsed.teamId,
+        projects: parsed.projects,
+        resources: parsed.resources,
+        deploymentsLookbackDays: parsed.deploymentsLookbackDays
+      },
+      { apiToken: parsed.apiToken },
+      ctx
+    );
+  }
+  id = "vercel";
+  credentials = vercelCredentials;
+  buildHeaders() {
+    return {
+      Authorization: `Bearer ${this.creds.apiToken}`,
+      "User-Agent": "rawdash/connector-vercel (+https://rawdash.dev)"
+    };
+  }
+  fetch(url, resource, signal) {
+    return this.get(url, {
+      resource,
+      headers: this.buildHeaders(),
+      signal,
+      rateLimit: vercelRateLimit
+    });
+  }
+  // -------------------------------------------------------------------------
+  // Resource enablement
+  // -------------------------------------------------------------------------
+  isResourceEnabled(resource) {
+    const enabled = this.settings.resources;
+    if (!enabled || enabled.length === 0) {
+      return true;
+    }
+    return enabled.includes(resource);
+  }
+  activePhases() {
+    const phases = [];
+    if (this.isResourceEnabled("projects")) {
+      phases.push("projects");
+    }
+    if (this.isResourceEnabled("deployments") || this.isResourceEnabled("deployment_events")) {
+      phases.push("deployments");
+    }
+    return phases;
+  }
+  // -------------------------------------------------------------------------
+  // URL building + sanitization
+  // -------------------------------------------------------------------------
+  allowedPagePath(phase) {
+    switch (phase) {
+      case "projects":
+        return "/v9/projects";
+      case "deployments":
+        return "/v6/deployments";
+    }
+  }
+  sanitizePageUrl(phase, pageUrl) {
+    if (pageUrl === null) {
+      return null;
+    }
+    const allowedPath = this.allowedPagePath(phase);
+    try {
+      const u = new URL(pageUrl);
+      if (u.protocol !== "https:" || u.host !== VERCEL_API_HOST || u.pathname !== allowedPath) {
+        return null;
+      }
+      return u.toString();
+    } catch {
+      return null;
+    }
+  }
+  resolveCursor(cursor) {
+    if (!isVercelSyncCursor(cursor)) {
+      return void 0;
+    }
+    return {
+      phase: cursor.phase,
+      page: this.sanitizePageUrl(cursor.phase, cursor.page)
+    };
+  }
+  withTeamId(u) {
+    if (this.settings.teamId !== void 0) {
+      u.searchParams.set("teamId", this.settings.teamId);
+    }
+    return u;
+  }
+  buildInitialProjectsUrl() {
+    const u = new URL(`${VERCEL_API_BASE}/v9/projects`);
+    u.searchParams.set("limit", String(PROJECTS_PAGE_SIZE));
+    this.withTeamId(u);
+    return u.toString();
+  }
+  buildInitialDeploymentsUrl(options) {
+    const u = new URL(`${VERCEL_API_BASE}/v6/deployments`);
+    u.searchParams.set("limit", String(DEPLOYMENTS_PAGE_SIZE));
+    for (const project of this.settings.projects ?? []) {
+      u.searchParams.append("projectId", project);
+    }
+    const sinceMs = this.computeDeploymentsSinceMs(options);
+    if (sinceMs !== null) {
+      u.searchParams.set("since", String(sinceMs));
+    }
+    this.withTeamId(u);
+    return u.toString();
+  }
+  computeDeploymentsSinceMs(options) {
+    if (options.mode === "latest" && options.since) {
+      const ms = new Date(options.since).getTime();
+      if (Number.isFinite(ms)) {
+        return ms;
+      }
+    }
+    const days = this.settings.deploymentsLookbackDays ?? DEFAULT_LOOKBACK_DAYS;
+    return Date.now() - days * MS_PER_DAY;
+  }
+  // -------------------------------------------------------------------------
+  // Fetchers
+  // -------------------------------------------------------------------------
+  buildNextPageUrl(phase, currentUrl, until) {
+    const u = new URL(currentUrl);
+    u.searchParams.set("until", String(until));
+    return u.toString();
+  }
+  async fetchProjectsPage(page, signal) {
+    const url = page ?? this.buildInitialProjectsUrl();
+    const res = await this.fetch(
+      url,
+      "projects",
+      signal
+    );
+    const next = res.body.pagination.next !== null && res.body.pagination.next !== void 0 ? this.sanitizePageUrl(
+      "projects",
+      this.buildNextPageUrl("projects", url, res.body.pagination.next)
+    ) : null;
+    return { items: res.body.projects, next };
+  }
+  async fetchDeploymentsPage(page, options, signal) {
+    const url = page ?? this.buildInitialDeploymentsUrl(options);
+    const res = await this.fetch(
+      url,
+      "deployments",
+      signal
+    );
+    const next = res.body.pagination.next !== null && res.body.pagination.next !== void 0 ? this.sanitizePageUrl(
+      "deployments",
+      this.buildNextPageUrl("deployments", url, res.body.pagination.next)
+    ) : null;
+    return { items: res.body.deployments, next };
+  }
+  // -------------------------------------------------------------------------
+  // Writers
+  // -------------------------------------------------------------------------
+  async writeProjects(storage, projects) {
+    for (const p of projects) {
+      const createdMs = Number.isFinite(p.createdAt) ? p.createdAt : null;
+      const updatedMs = Number.isFinite(p.updatedAt) ? p.updatedAt : null;
+      if (createdMs === null || updatedMs === null) {
+        console.warn(
+          `[connector-vercel] skipping project ${p.id} with unparseable timestamps`
+        );
+        continue;
+      }
+      await storage.entity({
+        type: "vercel_project",
+        id: p.id,
+        attributes: {
+          name: p.name,
+          framework: p.framework,
+          accountId: p.accountId ?? null,
+          createdAt: createdMs,
+          updatedAt: updatedMs
+        },
+        updated_at: updatedMs
+      });
+    }
+  }
+  async writeDeployments(storage, deployments) {
+    const writeEntities = this.isResourceEnabled("deployments");
+    const writeEvents = this.isResourceEnabled("deployment_events");
+    for (const d of deployments) {
+      const createdMs = Number.isFinite(d.created) ? d.created : null;
+      if (createdMs === null) {
+        console.warn(
+          `[connector-vercel] skipping deployment ${d.uid} with unparseable created timestamp`
+        );
+        continue;
+      }
+      const buildingMs = d.buildingAt !== null && d.buildingAt !== void 0 && Number.isFinite(d.buildingAt) ? d.buildingAt : null;
+      const readyMs = d.ready !== null && d.ready !== void 0 && Number.isFinite(d.ready) ? d.ready : null;
+      const buildDurationMs = readyMs !== null && buildingMs !== null && readyMs >= buildingMs ? readyMs - buildingMs : null;
+      const gitRef = d.meta?.githubCommitRef ?? d.meta?.gitlabCommitRef ?? d.meta?.bitbucketCommitRef ?? d.meta?.branch ?? null;
+      const gitSha = d.meta?.githubCommitSha ?? null;
+      const projectId = d.projectId ?? null;
+      const target = d.target ?? null;
+      const creatorUsername = d.creator.username ?? null;
+      const baseAttributes = {
+        deploymentId: d.uid,
+        name: d.name,
+        url: d.url,
+        state: d.state,
+        target,
+        projectId,
+        creatorUid: d.creator.uid,
+        creatorUsername,
+        source: d.source ?? null,
+        gitRef,
+        gitSha,
+        createdAt: createdMs,
+        buildingAt: buildingMs,
+        readyAt: readyMs,
+        buildDurationMs
+      };
+      if (writeEntities) {
+        await storage.entity({
+          type: "vercel_deployment",
+          id: d.uid,
+          attributes: baseAttributes,
+          updated_at: readyMs ?? buildingMs ?? createdMs
+        });
+      }
+      if (writeEvents) {
+        await storage.event({
+          name: "vercel_deployment_event",
+          start_ts: createdMs,
+          end_ts: readyMs,
+          attributes: baseAttributes
+        });
+      }
+    }
+  }
+  // -------------------------------------------------------------------------
+  // sync
+  // -------------------------------------------------------------------------
+  async sync(options, storage, signal) {
+    const cursor = this.resolveCursor(options.cursor);
+    const isFull = options.mode === "full";
+    const phases = this.activePhases();
+    return paginateChunked({
+      phases,
+      cursor,
+      signal,
+      fetchPage: async (phase, page, sig) => {
+        switch (phase) {
+          case "projects":
+            return this.fetchProjectsPage(page, sig);
+          case "deployments":
+            return this.fetchDeploymentsPage(page, options, sig);
+        }
+      },
+      writeBatch: async (phase, items, page) => {
+        if (isFull && page === null) {
+          switch (phase) {
+            case "projects":
+              if (this.isResourceEnabled("projects")) {
+                await storage.entities([], { types: ["vercel_project"] });
+              }
+              break;
+            case "deployments":
+              if (this.isResourceEnabled("deployments")) {
+                await storage.entities([], { types: ["vercel_deployment"] });
+              }
+              if (this.isResourceEnabled("deployment_events")) {
+                await storage.events([], {
+                  names: ["vercel_deployment_event"]
+                });
+              }
+              break;
+          }
+        }
+        switch (phase) {
+          case "projects":
+            if (!this.isResourceEnabled("projects")) {
+              return;
+            }
+            return this.writeProjects(storage, items);
+          case "deployments":
+            return this.writeDeployments(storage, items);
+        }
+      }
+    });
+  }
+};
+
+// src/index.ts
+var index_default = VercelConnector;
+export {
+  VercelConnector,
+  configFields,
+  index_default as default
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vercel.ts","../src/index.ts"],"sourcesContent":["import {\n  type HttpResponse,\n  type RateLimitPolicy,\n} from '@rawdash/connector-shared';\nimport {\n  BaseConnector,\n  type ChunkedSyncCursor,\n  type ConnectorContext,\n  type CredentialsSchema,\n  type JSONValue,\n  type StorageHandle,\n  type SyncOptions,\n  type SyncResult,\n  defineConfigFields,\n  paginateChunked,\n} from '@rawdash/core';\nimport { z } from 'zod';\n\n// ---------------------------------------------------------------------------\n// configFields\n// ---------------------------------------------------------------------------\n\nexport const configFields = defineConfigFields(\n  z.object({\n    apiToken: z.object({ $secret: z.string() }).meta({\n      label: 'API Token',\n      description:\n        'Vercel access token (Personal or Team). Create one at Vercel → Account Settings → Tokens.',\n      placeholder: 'vercel_token',\n      secret: true,\n    }),\n    teamId: z.string().min(1).optional().meta({\n      label: 'Team ID (optional)',\n      description:\n        'Vercel team ID (slug or `team_...`). Omit to use the token owner scope. Required if the token is a team token.',\n      placeholder: 'team_abc123',\n    }),\n    projects: z.array(z.string().min(1)).nonempty().optional().meta({\n      label: 'Projects (optional)',\n      description:\n        'Restrict deployment sync to specific Vercel project IDs (e.g. `prj_...`). Omit to sync every project the token can see.',\n    }),\n    resources: z\n      .array(z.enum(['projects', 'deployments', 'deployment_events']))\n      .nonempty()\n      .optional()\n      .meta({\n        label: 'Resources',\n        description:\n          \"Which Vercel resources to sync. Omit to sync all of them. 'deployment_events' depends on 'deployments' being fetched — enabling it without 'deployments' still runs the deployments query, but skips writing deployment entities.\",\n      }),\n    deploymentsLookbackDays: z\n      .number()\n      .int()\n      .positive()\n      .max(365)\n      .optional()\n      .meta({\n        label: 'Deployments lookback (days)',\n        description:\n          'How many days back to fetch deployments on a full sync. Defaults to 30. Vercel returns deployments newest-first; this caps the backfill window.',\n        placeholder: '30',\n      }),\n  }),\n);\n\nexport type VercelResource = 'projects' | 'deployments' | 'deployment_events';\n\nexport interface VercelSettings {\n  teamId?: string;\n  projects?: readonly string[];\n  resources?: readonly VercelResource[];\n  deploymentsLookbackDays?: number;\n}\n\nconst vercelCredentials = {\n  apiToken: {\n    description: 'Vercel access token',\n    auth: 'required' as const,\n  },\n} satisfies CredentialsSchema;\n\ntype VercelCredentials = typeof vercelCredentials;\n\n// ---------------------------------------------------------------------------\n// Rate-limit policy — Vercel sends standard `X-RateLimit-*` headers, reset is\n// a Unix timestamp in seconds.\n// ---------------------------------------------------------------------------\n\nconst vercelRateLimit: RateLimitPolicy = {\n  parse(h) {\n    const remainingRaw = h.get('x-ratelimit-remaining');\n    const resetRaw = h.get('x-ratelimit-reset');\n    if (remainingRaw === null || resetRaw === null) {\n      return null;\n    }\n    const remaining = Number(remainingRaw);\n    const reset = Number(resetRaw);\n    if (!Number.isFinite(remaining) || !Number.isFinite(reset) || reset < 0) {\n      return null;\n    }\n    return { remaining, resetAt: new Date(reset * 1000) };\n  },\n};\n\n// ---------------------------------------------------------------------------\n// Sync phases + cursor\n// ---------------------------------------------------------------------------\n\nconst PHASE_ORDER = ['projects', 'deployments'] as const;\n\ntype VercelPhase = (typeof PHASE_ORDER)[number];\n\ntype VercelSyncCursor = ChunkedSyncCursor<VercelPhase, string>;\n\nfunction isVercelSyncCursor(value: unknown): value is VercelSyncCursor {\n  if (typeof value !== 'object' || value === null) {\n    return false;\n  }\n  const v = value as { phase?: unknown; page?: unknown };\n  if (typeof v.phase !== 'string') {\n    return false;\n  }\n  if (!(PHASE_ORDER as readonly string[]).includes(v.phase)) {\n    return false;\n  }\n  if (v.page !== null && typeof v.page !== 'string') {\n    return false;\n  }\n  return true;\n}\n\n// ---------------------------------------------------------------------------\n// Vercel API types\n// ---------------------------------------------------------------------------\n\ninterface VercelProject {\n  id: string;\n  name: string;\n  accountId?: string;\n  framework: string | null;\n  createdAt: number;\n  updatedAt: number;\n}\n\ninterface VercelProjectsResponse {\n  projects: VercelProject[];\n  pagination: VercelPagination;\n}\n\ninterface VercelPagination {\n  count: number;\n  next: number | null;\n  prev?: number | null;\n}\n\ninterface VercelDeploymentCreator {\n  uid: string;\n  username?: string | null;\n  email?: string | null;\n}\n\ninterface VercelDeploymentMeta {\n  githubCommitRef?: string;\n  githubCommitSha?: string;\n  githubCommitMessage?: string;\n  gitlabCommitRef?: string;\n  bitbucketCommitRef?: string;\n  branch?: string;\n}\n\ninterface VercelDeployment {\n  uid: string;\n  name: string;\n  url: string;\n  created: number;\n  createdAt?: number;\n  state:\n    | 'BUILDING'\n    | 'ERROR'\n    | 'INITIALIZING'\n    | 'QUEUED'\n    | 'READY'\n    | 'CANCELED';\n  target: 'production' | 'staging' | 'preview' | null;\n  inspectorUrl?: string | null;\n  creator: VercelDeploymentCreator;\n  buildingAt?: number | null;\n  ready?: number | null;\n  source?: 'cli' | 'git' | 'import' | 'api-trigger-git-deploy' | string | null;\n  meta?: VercelDeploymentMeta | null;\n  projectId?: string;\n}\n\ninterface VercelDeploymentsResponse {\n  deployments: VercelDeployment[];\n  pagination: VercelPagination;\n}\n\n// ---------------------------------------------------------------------------\n// Schemas — describe the per-resource API response shape consumed by request()\n// ---------------------------------------------------------------------------\n\nconst idString = z.string().min(1);\nconst nonNegInt = z.number().int().nonnegative();\n\nconst paginationSchema = z.object({\n  count: nonNegInt,\n  next: nonNegInt.nullable(),\n});\n\nconst projectSchema = z.object({\n  id: idString,\n  name: z.string().min(1),\n  framework: z.string().nullable(),\n  createdAt: nonNegInt,\n  updatedAt: nonNegInt,\n});\n\nconst projectsResponseSchema = z.object({\n  projects: z.array(projectSchema),\n  pagination: paginationSchema,\n});\n\nconst deploymentStateSchema = z.enum([\n  'BUILDING',\n  'ERROR',\n  'INITIALIZING',\n  'QUEUED',\n  'READY',\n  'CANCELED',\n]);\n\nconst deploymentTargetSchema = z\n  .enum(['production', 'staging', 'preview'])\n  .nullable();\n\nconst deploymentSchema = z.object({\n  uid: idString,\n  name: z.string(),\n  url: z.string(),\n  created: nonNegInt,\n  state: deploymentStateSchema,\n  target: deploymentTargetSchema,\n  creator: z.object({\n    uid: idString,\n    username: z.string().nullable(),\n  }),\n  buildingAt: nonNegInt.nullable(),\n  ready: nonNegInt.nullable(),\n  source: z.string().nullable(),\n  meta: z.record(z.string(), z.string().nullable()).nullable().optional(),\n  projectId: z.string().nullable().optional(),\n});\n\nconst deploymentsResponseSchema = z.object({\n  deployments: z.array(deploymentSchema),\n  pagination: paginationSchema,\n});\n\n// ---------------------------------------------------------------------------\n// VercelConnector\n// ---------------------------------------------------------------------------\n\nconst VERCEL_API_HOST = 'api.vercel.com';\nconst VERCEL_API_BASE = `https://${VERCEL_API_HOST}`;\nconst PROJECTS_PAGE_SIZE = 100;\nconst DEPLOYMENTS_PAGE_SIZE = 100;\nconst DEFAULT_LOOKBACK_DAYS = 30;\nconst MS_PER_DAY = 24 * 60 * 60 * 1000;\n\nexport class VercelConnector extends BaseConnector<\n  VercelSettings,\n  VercelCredentials\n> {\n  static readonly id = 'vercel';\n\n  static readonly schemas = {\n    projects: projectsResponseSchema,\n    deployments: deploymentsResponseSchema,\n  } as const;\n\n  static create(input: unknown, ctx?: ConnectorContext): VercelConnector {\n    const parsed = configFields.parse(input);\n    return new VercelConnector(\n      {\n        teamId: parsed.teamId,\n        projects: parsed.projects,\n        resources: parsed.resources,\n        deploymentsLookbackDays: parsed.deploymentsLookbackDays,\n      },\n      { apiToken: parsed.apiToken },\n      ctx,\n    );\n  }\n\n  readonly id = 'vercel';\n  override readonly credentials = vercelCredentials;\n\n  private buildHeaders(): Record<string, string> {\n    return {\n      Authorization: `Bearer ${this.creds.apiToken}`,\n      'User-Agent': 'rawdash/connector-vercel (+https://rawdash.dev)',\n    };\n  }\n\n  private fetch<T>(\n    url: string,\n    resource: string,\n    signal?: AbortSignal,\n  ): Promise<HttpResponse<T>> {\n    return this.get<T>(url, {\n      resource,\n      headers: this.buildHeaders(),\n      signal,\n      rateLimit: vercelRateLimit,\n    });\n  }\n\n  // -------------------------------------------------------------------------\n  // Resource enablement\n  // -------------------------------------------------------------------------\n\n  private isResourceEnabled(resource: VercelResource): boolean {\n    const enabled = this.settings.resources;\n    if (!enabled || enabled.length === 0) {\n      return true;\n    }\n    return enabled.includes(resource);\n  }\n\n  private activePhases(): VercelPhase[] {\n    const phases: VercelPhase[] = [];\n    if (this.isResourceEnabled('projects')) {\n      phases.push('projects');\n    }\n    if (\n      this.isResourceEnabled('deployments') ||\n      this.isResourceEnabled('deployment_events')\n    ) {\n      phases.push('deployments');\n    }\n    return phases;\n  }\n\n  // -------------------------------------------------------------------------\n  // URL building + sanitization\n  // -------------------------------------------------------------------------\n\n  private allowedPagePath(phase: VercelPhase): string {\n    switch (phase) {\n      case 'projects':\n        return '/v9/projects';\n      case 'deployments':\n        return '/v6/deployments';\n    }\n  }\n\n  private sanitizePageUrl(\n    phase: VercelPhase,\n    pageUrl: string | null,\n  ): string | null {\n    if (pageUrl === null) {\n      return null;\n    }\n    const allowedPath = this.allowedPagePath(phase);\n    try {\n      const u = new URL(pageUrl);\n      if (\n        u.protocol !== 'https:' ||\n        u.host !== VERCEL_API_HOST ||\n        u.pathname !== allowedPath\n      ) {\n        return null;\n      }\n      return u.toString();\n    } catch {\n      return null;\n    }\n  }\n\n  private resolveCursor(cursor: unknown): VercelSyncCursor | undefined {\n    if (!isVercelSyncCursor(cursor)) {\n      return undefined;\n    }\n    return {\n      phase: cursor.phase,\n      page: this.sanitizePageUrl(cursor.phase, cursor.page),\n    };\n  }\n\n  private withTeamId(u: URL): URL {\n    if (this.settings.teamId !== undefined) {\n      u.searchParams.set('teamId', this.settings.teamId);\n    }\n    return u;\n  }\n\n  private buildInitialProjectsUrl(): string {\n    const u = new URL(`${VERCEL_API_BASE}/v9/projects`);\n    u.searchParams.set('limit', String(PROJECTS_PAGE_SIZE));\n    this.withTeamId(u);\n    return u.toString();\n  }\n\n  private buildInitialDeploymentsUrl(options: SyncOptions): string {\n    const u = new URL(`${VERCEL_API_BASE}/v6/deployments`);\n    u.searchParams.set('limit', String(DEPLOYMENTS_PAGE_SIZE));\n    for (const project of this.settings.projects ?? []) {\n      u.searchParams.append('projectId', project);\n    }\n    const sinceMs = this.computeDeploymentsSinceMs(options);\n    if (sinceMs !== null) {\n      u.searchParams.set('since', String(sinceMs));\n    }\n    this.withTeamId(u);\n    return u.toString();\n  }\n\n  private computeDeploymentsSinceMs(options: SyncOptions): number | null {\n    if (options.mode === 'latest' && options.since) {\n      const ms = new Date(options.since).getTime();\n      if (Number.isFinite(ms)) {\n        return ms;\n      }\n    }\n    const days = this.settings.deploymentsLookbackDays ?? DEFAULT_LOOKBACK_DAYS;\n    return Date.now() - days * MS_PER_DAY;\n  }\n\n  // -------------------------------------------------------------------------\n  // Fetchers\n  // -------------------------------------------------------------------------\n\n  private buildNextPageUrl(\n    phase: VercelPhase,\n    currentUrl: string,\n    until: number,\n  ): string {\n    const u = new URL(currentUrl);\n    u.searchParams.set('until', String(until));\n    return u.toString();\n  }\n\n  private async fetchProjectsPage(\n    page: string | null,\n    signal: AbortSignal | undefined,\n  ): Promise<{ items: VercelProject[]; next: string | null }> {\n    const url = page ?? this.buildInitialProjectsUrl();\n    const res = await this.fetch<VercelProjectsResponse>(\n      url,\n      'projects',\n      signal,\n    );\n    const next =\n      res.body.pagination.next !== null &&\n      res.body.pagination.next !== undefined\n        ? this.sanitizePageUrl(\n            'projects',\n            this.buildNextPageUrl('projects', url, res.body.pagination.next),\n          )\n        : null;\n    return { items: res.body.projects, next };\n  }\n\n  private async fetchDeploymentsPage(\n    page: string | null,\n    options: SyncOptions,\n    signal: AbortSignal | undefined,\n  ): Promise<{ items: VercelDeployment[]; next: string | null }> {\n    const url = page ?? this.buildInitialDeploymentsUrl(options);\n    const res = await this.fetch<VercelDeploymentsResponse>(\n      url,\n      'deployments',\n      signal,\n    );\n    const next =\n      res.body.pagination.next !== null &&\n      res.body.pagination.next !== undefined\n        ? this.sanitizePageUrl(\n            'deployments',\n            this.buildNextPageUrl('deployments', url, res.body.pagination.next),\n          )\n        : null;\n    return { items: res.body.deployments, next };\n  }\n\n  // -------------------------------------------------------------------------\n  // Writers\n  // -------------------------------------------------------------------------\n\n  private async writeProjects(\n    storage: StorageHandle,\n    projects: VercelProject[],\n  ): Promise<void> {\n    for (const p of projects) {\n      const createdMs = Number.isFinite(p.createdAt) ? p.createdAt : null;\n      const updatedMs = Number.isFinite(p.updatedAt) ? p.updatedAt : null;\n      if (createdMs === null || updatedMs === null) {\n        console.warn(\n          `[connector-vercel] skipping project ${p.id} with unparseable timestamps`,\n        );\n        continue;\n      }\n      await storage.entity({\n        type: 'vercel_project',\n        id: p.id,\n        attributes: {\n          name: p.name,\n          framework: p.framework,\n          accountId: p.accountId ?? null,\n          createdAt: createdMs,\n          updatedAt: updatedMs,\n        },\n        updated_at: updatedMs,\n      });\n    }\n  }\n\n  private async writeDeployments(\n    storage: StorageHandle,\n    deployments: VercelDeployment[],\n  ): Promise<void> {\n    const writeEntities = this.isResourceEnabled('deployments');\n    const writeEvents = this.isResourceEnabled('deployment_events');\n\n    for (const d of deployments) {\n      const createdMs = Number.isFinite(d.created) ? d.created : null;\n      if (createdMs === null) {\n        console.warn(\n          `[connector-vercel] skipping deployment ${d.uid} with unparseable created timestamp`,\n        );\n        continue;\n      }\n      const buildingMs =\n        d.buildingAt !== null &&\n        d.buildingAt !== undefined &&\n        Number.isFinite(d.buildingAt)\n          ? d.buildingAt\n          : null;\n      const readyMs =\n        d.ready !== null && d.ready !== undefined && Number.isFinite(d.ready)\n          ? d.ready\n          : null;\n      const buildDurationMs =\n        readyMs !== null && buildingMs !== null && readyMs >= buildingMs\n          ? readyMs - buildingMs\n          : null;\n      const gitRef =\n        d.meta?.githubCommitRef ??\n        d.meta?.gitlabCommitRef ??\n        d.meta?.bitbucketCommitRef ??\n        d.meta?.branch ??\n        null;\n      const gitSha = d.meta?.githubCommitSha ?? null;\n      const projectId = d.projectId ?? null;\n      const target = d.target ?? null;\n      const creatorUsername = d.creator.username ?? null;\n      const baseAttributes: Record<string, JSONValue> = {\n        deploymentId: d.uid,\n        name: d.name,\n        url: d.url,\n        state: d.state,\n        target,\n        projectId,\n        creatorUid: d.creator.uid,\n        creatorUsername,\n        source: d.source ?? null,\n        gitRef,\n        gitSha,\n        createdAt: createdMs,\n        buildingAt: buildingMs,\n        readyAt: readyMs,\n        buildDurationMs,\n      };\n\n      if (writeEntities) {\n        await storage.entity({\n          type: 'vercel_deployment',\n          id: d.uid,\n          attributes: baseAttributes,\n          updated_at: readyMs ?? buildingMs ?? createdMs,\n        });\n      }\n\n      if (writeEvents) {\n        await storage.event({\n          name: 'vercel_deployment_event',\n          start_ts: createdMs,\n          end_ts: readyMs,\n          attributes: baseAttributes,\n        });\n      }\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // sync\n  // -------------------------------------------------------------------------\n\n  async sync(\n    options: SyncOptions,\n    storage: StorageHandle,\n    signal?: AbortSignal,\n  ): Promise<SyncResult> {\n    const cursor = this.resolveCursor(options.cursor);\n    const isFull = options.mode === 'full';\n    const phases = this.activePhases();\n\n    return paginateChunked<VercelPhase, string>({\n      phases,\n      cursor,\n      signal,\n      fetchPage: async (phase, page, sig) => {\n        switch (phase) {\n          case 'projects':\n            return this.fetchProjectsPage(page, sig);\n          case 'deployments':\n            return this.fetchDeploymentsPage(page, options, sig);\n        }\n      },\n      writeBatch: async (phase, items, page) => {\n        if (isFull && page === null) {\n          switch (phase) {\n            case 'projects':\n              if (this.isResourceEnabled('projects')) {\n                await storage.entities([], { types: ['vercel_project'] });\n              }\n              break;\n            case 'deployments':\n              if (this.isResourceEnabled('deployments')) {\n                await storage.entities([], { types: ['vercel_deployment'] });\n              }\n              if (this.isResourceEnabled('deployment_events')) {\n                await storage.events([], {\n                  names: ['vercel_deployment_event'],\n                });\n              }\n              break;\n          }\n        }\n        switch (phase) {\n          case 'projects':\n            if (!this.isResourceEnabled('projects')) {\n              return;\n            }\n            return this.writeProjects(storage, items as VercelProject[]);\n          case 'deployments':\n            return this.writeDeployments(storage, items as VercelDeployment[]);\n        }\n      },\n    });\n  }\n}\n","import { VercelConnector } from './vercel';\n\nexport { configFields, VercelConnector } from './vercel';\nexport type { VercelResource, VercelSettings } from './vercel';\nexport default VercelConnector;\n"],"mappings":";AAIA;AAAA,EACE;AAAA,EAQA;AAAA,EACA;AAAA,OACK;AACP,SAAS,SAAS;AAMX,IAAM,eAAe;AAAA,EAC1B,EAAE,OAAO;AAAA,IACP,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK;AAAA,MAC/C,OAAO;AAAA,MACP,aACE;AAAA,MACF,aAAa;AAAA,MACb,QAAQ;AAAA,IACV,CAAC;AAAA,IACD,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,KAAK;AAAA,MACxC,OAAO;AAAA,MACP,aACE;AAAA,MACF,aAAa;AAAA,IACf,CAAC;AAAA,IACD,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK;AAAA,MAC9D,OAAO;AAAA,MACP,aACE;AAAA,IACJ,CAAC;AAAA,IACD,WAAW,EACR,MAAM,EAAE,KAAK,CAAC,YAAY,eAAe,mBAAmB,CAAC,CAAC,EAC9D,SAAS,EACT,SAAS,EACT,KAAK;AAAA,MACJ,OAAO;AAAA,MACP,aACE;AAAA,IACJ,CAAC;AAAA,IACH,yBAAyB,EACtB,OAAO,EACP,IAAI,EACJ,SAAS,EACT,IAAI,GAAG,EACP,SAAS,EACT,KAAK;AAAA,MACJ,OAAO;AAAA,MACP,aACE;AAAA,MACF,aAAa;AAAA,IACf,CAAC;AAAA,EACL,CAAC;AACH;AAWA,IAAM,oBAAoB;AAAA,EACxB,UAAU;AAAA,IACR,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AACF;AASA,IAAM,kBAAmC;AAAA,EACvC,MAAM,GAAG;AACP,UAAM,eAAe,EAAE,IAAI,uBAAuB;AAClD,UAAM,WAAW,EAAE,IAAI,mBAAmB;AAC1C,QAAI,iBAAiB,QAAQ,aAAa,MAAM;AAC9C,aAAO;AAAA,IACT;AACA,UAAM,YAAY,OAAO,YAAY;AACrC,UAAM,QAAQ,OAAO,QAAQ;AAC7B,QAAI,CAAC,OAAO,SAAS,SAAS,KAAK,CAAC,OAAO,SAAS,KAAK,KAAK,QAAQ,GAAG;AACvE,aAAO;AAAA,IACT;AACA,WAAO,EAAE,WAAW,SAAS,IAAI,KAAK,QAAQ,GAAI,EAAE;AAAA,EACtD;AACF;AAMA,IAAM,cAAc,CAAC,YAAY,aAAa;AAM9C,SAAS,mBAAmB,OAA2C;AACrE,MAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAC/C,WAAO;AAAA,EACT;AACA,QAAM,IAAI;AACV,MAAI,OAAO,EAAE,UAAU,UAAU;AAC/B,WAAO;AAAA,EACT;AACA,MAAI,CAAE,YAAkC,SAAS,EAAE,KAAK,GAAG;AACzD,WAAO;AAAA,EACT;AACA,MAAI,EAAE,SAAS,QAAQ,OAAO,EAAE,SAAS,UAAU;AACjD,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAyEA,IAAM,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC;AACjC,IAAM,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;AAE/C,IAAM,mBAAmB,EAAE,OAAO;AAAA,EAChC,OAAO;AAAA,EACP,MAAM,UAAU,SAAS;AAC3B,CAAC;AAED,IAAM,gBAAgB,EAAE,OAAO;AAAA,EAC7B,IAAI;AAAA,EACJ,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACtB,WAAW,EAAE,OAAO,EAAE,SAAS;AAAA,EAC/B,WAAW;AAAA,EACX,WAAW;AACb,CAAC;AAED,IAAM,yBAAyB,EAAE,OAAO;AAAA,EACtC,UAAU,EAAE,MAAM,aAAa;AAAA,EAC/B,YAAY;AACd,CAAC;AAED,IAAM,wBAAwB,EAAE,KAAK;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,IAAM,yBAAyB,EAC5B,KAAK,CAAC,cAAc,WAAW,SAAS,CAAC,EACzC,SAAS;AAEZ,IAAM,mBAAmB,EAAE,OAAO;AAAA,EAChC,KAAK;AAAA,EACL,MAAM,EAAE,OAAO;AAAA,EACf,KAAK,EAAE,OAAO;AAAA,EACd,SAAS;AAAA,EACT,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,SAAS,EAAE,OAAO;AAAA,IAChB,KAAK;AAAA,IACL,UAAU,EAAE,OAAO,EAAE,SAAS;AAAA,EAChC,CAAC;AAAA,EACD,YAAY,UAAU,SAAS;AAAA,EAC/B,OAAO,UAAU,SAAS;AAAA,EAC1B,QAAQ,EAAE,OAAO,EAAE,SAAS;AAAA,EAC5B,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,SAAS,EAAE,SAAS;AAAA,EACtE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS;AAC5C,CAAC;AAED,IAAM,4BAA4B,EAAE,OAAO;AAAA,EACzC,aAAa,EAAE,MAAM,gBAAgB;AAAA,EACrC,YAAY;AACd,CAAC;AAMD,IAAM,kBAAkB;AACxB,IAAM,kBAAkB,WAAW,eAAe;AAClD,IAAM,qBAAqB;AAC3B,IAAM,wBAAwB;AAC9B,IAAM,wBAAwB;AAC9B,IAAM,aAAa,KAAK,KAAK,KAAK;AAE3B,IAAM,kBAAN,MAAM,yBAAwB,cAGnC;AAAA,EACA,OAAgB,KAAK;AAAA,EAErB,OAAgB,UAAU;AAAA,IACxB,UAAU;AAAA,IACV,aAAa;AAAA,EACf;AAAA,EAEA,OAAO,OAAO,OAAgB,KAAyC;AACrE,UAAM,SAAS,aAAa,MAAM,KAAK;AACvC,WAAO,IAAI;AAAA,MACT;AAAA,QACE,QAAQ,OAAO;AAAA,QACf,UAAU,OAAO;AAAA,QACjB,WAAW,OAAO;AAAA,QAClB,yBAAyB,OAAO;AAAA,MAClC;AAAA,MACA,EAAE,UAAU,OAAO,SAAS;AAAA,MAC5B;AAAA,IACF;AAAA,EACF;AAAA,EAES,KAAK;AAAA,EACI,cAAc;AAAA,EAExB,eAAuC;AAC7C,WAAO;AAAA,MACL,eAAe,UAAU,KAAK,MAAM,QAAQ;AAAA,MAC5C,cAAc;AAAA,IAChB;AAAA,EACF;AAAA,EAEQ,MACN,KACA,UACA,QAC0B;AAC1B,WAAO,KAAK,IAAO,KAAK;AAAA,MACtB;AAAA,MACA,SAAS,KAAK,aAAa;AAAA,MAC3B;AAAA,MACA,WAAW;AAAA,IACb,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAMQ,kBAAkB,UAAmC;AAC3D,UAAM,UAAU,KAAK,SAAS;AAC9B,QAAI,CAAC,WAAW,QAAQ,WAAW,GAAG;AACpC,aAAO;AAAA,IACT;AACA,WAAO,QAAQ,SAAS,QAAQ;AAAA,EAClC;AAAA,EAEQ,eAA8B;AACpC,UAAM,SAAwB,CAAC;AAC/B,QAAI,KAAK,kBAAkB,UAAU,GAAG;AACtC,aAAO,KAAK,UAAU;AAAA,IACxB;AACA,QACE,KAAK,kBAAkB,aAAa,KACpC,KAAK,kBAAkB,mBAAmB,GAC1C;AACA,aAAO,KAAK,aAAa;AAAA,IAC3B;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAMQ,gBAAgB,OAA4B;AAClD,YAAQ,OAAO;AAAA,MACb,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,IACX;AAAA,EACF;AAAA,EAEQ,gBACN,OACA,SACe;AACf,QAAI,YAAY,MAAM;AACpB,aAAO;AAAA,IACT;AACA,UAAM,cAAc,KAAK,gBAAgB,KAAK;AAC9C,QAAI;AACF,YAAM,IAAI,IAAI,IAAI,OAAO;AACzB,UACE,EAAE,aAAa,YACf,EAAE,SAAS,mBACX,EAAE,aAAa,aACf;AACA,eAAO;AAAA,MACT;AACA,aAAO,EAAE,SAAS;AAAA,IACpB,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEQ,cAAc,QAA+C;AACnE,QAAI,CAAC,mBAAmB,MAAM,GAAG;AAC/B,aAAO;AAAA,IACT;AACA,WAAO;AAAA,MACL,OAAO,OAAO;AAAA,MACd,MAAM,KAAK,gBAAgB,OAAO,OAAO,OAAO,IAAI;AAAA,IACtD;AAAA,EACF;AAAA,EAEQ,WAAW,GAAa;AAC9B,QAAI,KAAK,SAAS,WAAW,QAAW;AACtC,QAAE,aAAa,IAAI,UAAU,KAAK,SAAS,MAAM;AAAA,IACnD;AACA,WAAO;AAAA,EACT;AAAA,EAEQ,0BAAkC;AACxC,UAAM,IAAI,IAAI,IAAI,GAAG,eAAe,cAAc;AAClD,MAAE,aAAa,IAAI,SAAS,OAAO,kBAAkB,CAAC;AACtD,SAAK,WAAW,CAAC;AACjB,WAAO,EAAE,SAAS;AAAA,EACpB;AAAA,EAEQ,2BAA2B,SAA8B;AAC/D,UAAM,IAAI,IAAI,IAAI,GAAG,eAAe,iBAAiB;AACrD,MAAE,aAAa,IAAI,SAAS,OAAO,qBAAqB,CAAC;AACzD,eAAW,WAAW,KAAK,SAAS,YAAY,CAAC,GAAG;AAClD,QAAE,aAAa,OAAO,aAAa,OAAO;AAAA,IAC5C;AACA,UAAM,UAAU,KAAK,0BAA0B,OAAO;AACtD,QAAI,YAAY,MAAM;AACpB,QAAE,aAAa,IAAI,SAAS,OAAO,OAAO,CAAC;AAAA,IAC7C;AACA,SAAK,WAAW,CAAC;AACjB,WAAO,EAAE,SAAS;AAAA,EACpB;AAAA,EAEQ,0BAA0B,SAAqC;AACrE,QAAI,QAAQ,SAAS,YAAY,QAAQ,OAAO;AAC9C,YAAM,KAAK,IAAI,KAAK,QAAQ,KAAK,EAAE,QAAQ;AAC3C,UAAI,OAAO,SAAS,EAAE,GAAG;AACvB,eAAO;AAAA,MACT;AAAA,IACF;AACA,UAAM,OAAO,KAAK,SAAS,2BAA2B;AACtD,WAAO,KAAK,IAAI,IAAI,OAAO;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA,EAMQ,iBACN,OACA,YACA,OACQ;AACR,UAAM,IAAI,IAAI,IAAI,UAAU;AAC5B,MAAE,aAAa,IAAI,SAAS,OAAO,KAAK,CAAC;AACzC,WAAO,EAAE,SAAS;AAAA,EACpB;AAAA,EAEA,MAAc,kBACZ,MACA,QAC0D;AAC1D,UAAM,MAAM,QAAQ,KAAK,wBAAwB;AACjD,UAAM,MAAM,MAAM,KAAK;AAAA,MACrB;AAAA,MACA;AAAA,MACA;AAAA,IACF;AACA,UAAM,OACJ,IAAI,KAAK,WAAW,SAAS,QAC7B,IAAI,KAAK,WAAW,SAAS,SACzB,KAAK;AAAA,MACH;AAAA,MACA,KAAK,iBAAiB,YAAY,KAAK,IAAI,KAAK,WAAW,IAAI;AAAA,IACjE,IACA;AACN,WAAO,EAAE,OAAO,IAAI,KAAK,UAAU,KAAK;AAAA,EAC1C;AAAA,EAEA,MAAc,qBACZ,MACA,SACA,QAC6D;AAC7D,UAAM,MAAM,QAAQ,KAAK,2BAA2B,OAAO;AAC3D,UAAM,MAAM,MAAM,KAAK;AAAA,MACrB;AAAA,MACA;AAAA,MACA;AAAA,IACF;AACA,UAAM,OACJ,IAAI,KAAK,WAAW,SAAS,QAC7B,IAAI,KAAK,WAAW,SAAS,SACzB,KAAK;AAAA,MACH;AAAA,MACA,KAAK,iBAAiB,eAAe,KAAK,IAAI,KAAK,WAAW,IAAI;AAAA,IACpE,IACA;AACN,WAAO,EAAE,OAAO,IAAI,KAAK,aAAa,KAAK;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA,EAMA,MAAc,cACZ,SACA,UACe;AACf,eAAW,KAAK,UAAU;AACxB,YAAM,YAAY,OAAO,SAAS,EAAE,SAAS,IAAI,EAAE,YAAY;AAC/D,YAAM,YAAY,OAAO,SAAS,EAAE,SAAS,IAAI,EAAE,YAAY;AAC/D,UAAI,cAAc,QAAQ,cAAc,MAAM;AAC5C,gBAAQ;AAAA,UACN,uCAAuC,EAAE,EAAE;AAAA,QAC7C;AACA;AAAA,MACF;AACA,YAAM,QAAQ,OAAO;AAAA,QACnB,MAAM;AAAA,QACN,IAAI,EAAE;AAAA,QACN,YAAY;AAAA,UACV,MAAM,EAAE;AAAA,UACR,WAAW,EAAE;AAAA,UACb,WAAW,EAAE,aAAa;AAAA,UAC1B,WAAW;AAAA,UACX,WAAW;AAAA,QACb;AAAA,QACA,YAAY;AAAA,MACd,CAAC;AAAA,IACH;AAAA,EACF;AAAA,EAEA,MAAc,iBACZ,SACA,aACe;AACf,UAAM,gBAAgB,KAAK,kBAAkB,aAAa;AAC1D,UAAM,cAAc,KAAK,kBAAkB,mBAAmB;AAE9D,eAAW,KAAK,aAAa;AAC3B,YAAM,YAAY,OAAO,SAAS,EAAE,OAAO,IAAI,EAAE,UAAU;AAC3D,UAAI,cAAc,MAAM;AACtB,gBAAQ;AAAA,UACN,0CAA0C,EAAE,GAAG;AAAA,QACjD;AACA;AAAA,MACF;AACA,YAAM,aACJ,EAAE,eAAe,QACjB,EAAE,eAAe,UACjB,OAAO,SAAS,EAAE,UAAU,IACxB,EAAE,aACF;AACN,YAAM,UACJ,EAAE,UAAU,QAAQ,EAAE,UAAU,UAAa,OAAO,SAAS,EAAE,KAAK,IAChE,EAAE,QACF;AACN,YAAM,kBACJ,YAAY,QAAQ,eAAe,QAAQ,WAAW,aAClD,UAAU,aACV;AACN,YAAM,SACJ,EAAE,MAAM,mBACR,EAAE,MAAM,mBACR,EAAE,MAAM,sBACR,EAAE,MAAM,UACR;AACF,YAAM,SAAS,EAAE,MAAM,mBAAmB;AAC1C,YAAM,YAAY,EAAE,aAAa;AACjC,YAAM,SAAS,EAAE,UAAU;AAC3B,YAAM,kBAAkB,EAAE,QAAQ,YAAY;AAC9C,YAAM,iBAA4C;AAAA,QAChD,cAAc,EAAE;AAAA,QAChB,MAAM,EAAE;AAAA,QACR,KAAK,EAAE;AAAA,QACP,OAAO,EAAE;AAAA,QACT;AAAA,QACA;AAAA,QACA,YAAY,EAAE,QAAQ;AAAA,QACtB;AAAA,QACA,QAAQ,EAAE,UAAU;AAAA,QACpB;AAAA,QACA;AAAA,QACA,WAAW;AAAA,QACX,YAAY;AAAA,QACZ,SAAS;AAAA,QACT;AAAA,MACF;AAEA,UAAI,eAAe;AACjB,cAAM,QAAQ,OAAO;AAAA,UACnB,MAAM;AAAA,UACN,IAAI,EAAE;AAAA,UACN,YAAY;AAAA,UACZ,YAAY,WAAW,cAAc;AAAA,QACvC,CAAC;AAAA,MACH;AAEA,UAAI,aAAa;AACf,cAAM,QAAQ,MAAM;AAAA,UAClB,MAAM;AAAA,UACN,UAAU;AAAA,UACV,QAAQ;AAAA,UACR,YAAY;AAAA,QACd,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,KACJ,SACA,SACA,QACqB;AACrB,UAAM,SAAS,KAAK,cAAc,QAAQ,MAAM;AAChD,UAAM,SAAS,QAAQ,SAAS;AAChC,UAAM,SAAS,KAAK,aAAa;AAEjC,WAAO,gBAAqC;AAAA,MAC1C;AAAA,MACA;AAAA,MACA;AAAA,MACA,WAAW,OAAO,OAAO,MAAM,QAAQ;AACrC,gBAAQ,OAAO;AAAA,UACb,KAAK;AACH,mBAAO,KAAK,kBAAkB,MAAM,GAAG;AAAA,UACzC,KAAK;AACH,mBAAO,KAAK,qBAAqB,MAAM,SAAS,GAAG;AAAA,QACvD;AAAA,MACF;AAAA,MACA,YAAY,OAAO,OAAO,OAAO,SAAS;AACxC,YAAI,UAAU,SAAS,MAAM;AAC3B,kBAAQ,OAAO;AAAA,YACb,KAAK;AACH,kBAAI,KAAK,kBAAkB,UAAU,GAAG;AACtC,sBAAM,QAAQ,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,gBAAgB,EAAE,CAAC;AAAA,cAC1D;AACA;AAAA,YACF,KAAK;AACH,kBAAI,KAAK,kBAAkB,aAAa,GAAG;AACzC,sBAAM,QAAQ,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,mBAAmB,EAAE,CAAC;AAAA,cAC7D;AACA,kBAAI,KAAK,kBAAkB,mBAAmB,GAAG;AAC/C,sBAAM,QAAQ,OAAO,CAAC,GAAG;AAAA,kBACvB,OAAO,CAAC,yBAAyB;AAAA,gBACnC,CAAC;AAAA,cACH;AACA;AAAA,UACJ;AAAA,QACF;AACA,gBAAQ,OAAO;AAAA,UACb,KAAK;AACH,gBAAI,CAAC,KAAK,kBAAkB,UAAU,GAAG;AACvC;AAAA,YACF;AACA,mBAAO,KAAK,cAAc,SAAS,KAAwB;AAAA,UAC7D,KAAK;AACH,mBAAO,KAAK,iBAAiB,SAAS,KAA2B;AAAA,QACrE;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH;AACF;;;ACzoBA,IAAO,gBAAQ;","names":[]}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@rawdash/connector-vercel",
+  "version": "0.15.0",
+  "description": "Rawdash connector for Vercel — projects, deployments, deploy state transitions",
+  "license": "Apache-2.0",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rawdash/rawdash.git",
+    "directory": "packages/connectors/vercel"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "@rawdash/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@rawdash/core": "workspace:*",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@rawdash/connector-shared": "workspace:*",
+    "@rawdash/connector-test-utils": "workspace:*",
+    "fast-check": "^4.8.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.2",
+    "vitest": "^4.1.4"
+  }
+}