@vercel/connect 2.0.0 → 2.0.2

package/README.md

@@ -30,19 +30,15 @@ const token = await getToken(process.env.CONNECTOR_LINEAR!, {
 });
 ```
 
-To create an operator installation request for an app-scoped connector, use the
-experimental install helper:
-
-This feature is gated while experimental. Contact Vercel to enable access
-before using it.
+To start an authorization request for a user, use `startAuthorization`:
 
 ```ts
-import { experimental_startInstallation } from '@vercel/connect';
+import { startAuthorization } from '@vercel/connect';
 
-const { url } = await experimental_startInstallation(
-  process.env.CONNECTOR_SLACK!,
-  {},
-  { returnUrl: 'https://example.com/settings/integrations' }
+const { url } = await startAuthorization(
+  process.env.CONNECTOR_LINEAR!,
+  { subject: { type: 'user', id: 'user_123' } },
+  { callbackUrl: 'https://example.com/settings/integrations' }
 );
 ```
 

package/dist/eve/github-credentials.d.ts

@@ -20,5 +20,9 @@ export type ConnectGitHubCredentialsParams = Omit<ConnectTokenParams, 'subject'>
  *
  * The webhook verifier accepts Connect-forwarded webhooks authenticated
  * with Vercel OIDC instead of GitHub's webhook secret.
+ *
+ * `appSlug` resolves the GitHub App slug from the connector's metadata,
+ * so `githubChannel` can derive its invocation token (`botName`) without
+ * extra configuration when `botName` is not set.
  */
 export declare function connectGitHubCredentials(connector: string, params?: ConnectGitHubCredentialsParams, options?: ConnectOptions): GitHubChannelCredentials;

package/dist/eve/github-credentials.js

@@ -1,5 +1,5 @@
 import { vercelOidc } from 'eve/channels/auth';
-import { getToken, } from '../index.js';
+import { getConnectorMetadata, getToken, } from '../index.js';
 /**
  * Build {@link GitHubChannelCredentials} backed by a Vercel Connect
  * connector that stores a GitHub installation access token.
@@ -11,10 +11,23 @@ import { getToken, } from '../index.js';
  *
  * The webhook verifier accepts Connect-forwarded webhooks authenticated
  * with Vercel OIDC instead of GitHub's webhook secret.
+ *
+ * `appSlug` resolves the GitHub App slug from the connector's metadata,
+ * so `githubChannel` can derive its invocation token (`botName`) without
+ * extra configuration when `botName` is not set.
  */
 export function connectGitHubCredentials(connector, params = {}, options) {
     return {
+        appSlug: () => getGitHubAppSlug(connector, options),
         installationToken: () => getToken(connector, { ...params, subject: { type: 'app' } }, options),
         webhookVerifier: vercelOidc(),
     };
 }
+async function getGitHubAppSlug(connector, options) {
+    const metadata = await getConnectorMetadata(connector, options);
+    const appSlug = metadata.vendor.appSlug;
+    if (typeof appSlug !== 'string' || appSlug.length === 0) {
+        throw new Error(`Vercel Connect connector ${connector} did not return a GitHub App slug.`);
+    }
+    return appSlug;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/connect",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "license": "Apache-2.0",
   "type": "module",
   "repository": {
@@ -78,7 +78,7 @@
     "@chat-adapter/slack": "4.31.0",
     "ai": "7.0.26",
     "better-auth": "1.5.5",
-    "eve": "0.24.3",
+    "eve": "0.39.1",
     "typescript": "^5"
   },
   "private": false,