SDK reference

npm install @versoai/core

import { signLink } from "@versoai/core";

const { url, token } = await signLink(
  {
    appId: "app_yourapp",
    userRef: "user_123",
    scopes: ["conversations:read"],
    purpose: "connect",          // or "manage"
    expiresInSeconds: 900,       // optional, max 900
  },
  process.env.VERSO_APP_SECRET!,
);

import { verifyWebhook } from "@versoai/core";

const ok = verifyWebhook(
  process.env.VERSO_WEBHOOK_SECRET!,
  req.get("x-verso-signature") ?? "",
  rawBody,       // the request body exactly as received
  300,           // optional tolerance in seconds, default 300
);

import type {
  WebhookEvent,             // { event, payload, deliveryId }, discriminated by event
  WebhookEventName,         // "connect.started" | "connection.created" | "data.imported" | "reauth.needed" | "data.deleted" | "connection.deleted"
  ConnectStartedPayload,
  ConnectionCreatedPayload,
  DataImportedPayload,
  ReauthNeededPayload,
  DataDeletedPayload,
  ConnectionDeletedPayload,
  SignLinkOptions,
  SignedLink,
  LinkPurpose,
} from "@versoai/core";