@vercel/connect 0.0.4-alpha.4 → 0.0.4-alpha.7

package/dist/ash/connection-authorization.d.ts

@@ -109,6 +109,36 @@ export interface AshAuthorizationOptions {
 }
 /** Input accepted by {@link connect}. */
 export type AshAuthorizationInput = string | AshAuthorizationOptions;
+/**
+ * Structurally-readable marker exposed on every {@link connect} return
+ * value so downstream tooling can detect Vercel Connect-backed
+ * connections at compile time and surface deep links to the matching
+ * connector settings page.
+ *
+ * The `connector` field carries the raw value the author passed to
+ * {@link connect} — either the human-readable UID
+ * (`"oauth/mcp-linear-app"`) or the opaque service-connector key
+ * (`"scl_..."`). Consumers that need the canonical `scl_...` form
+ * (eg. the Vercel dashboard, when building a `/connect/<clientId>`
+ * URL) can resolve UID → `scl_...` against the Vercel Connect API;
+ * both forms address the same connector.
+ *
+ * The marker is purely metadata — it does not influence the runtime
+ * token-fetching behaviour, which continues to be driven by the
+ * `getToken` / `startAuthorization` / `completeAuthorization`
+ * callbacks.
+ */
+export interface VercelConnectMetadata {
+    readonly connector: string;
+}
+/**
+ * Augments the standard Ash authorization shape with the
+ * {@link VercelConnectMetadata} marker, narrowed to whichever flavour
+ * `connect()` produces.
+ */
+export type AshConnectAuthorizationDefinition<TAuthorization extends InteractiveAuthorizationDefinition<ConnectAuthorizationState> | NonInteractiveAuthorizationDefinition> = TAuthorization & {
+    readonly vercelConnect: VercelConnectMetadata;
+};
 /**
  * Builds an Ash {@link AuthorizationDefinition} backed by Vercel
  * Connect. The return type narrows based on
@@ -120,12 +150,17 @@ export type AshAuthorizationInput = string | AshAuthorizationOptions;
  * - `principalType: "app"` returns a
  *   {@link NonInteractiveAuthorizationDefinition}; Ash never runs a
  *   consent flow for app-scoped connectors.
+ *
+ * Every returned definition also carries a {@link VercelConnectMetadata}
+ * marker on its `vercelConnect` field so downstream tooling (Ash
+ * compiler, dashboards) can detect Vercel Connect-backed connections
+ * without inspecting closure state.
  */
-export declare function connect(connector: string): InteractiveAuthorizationDefinition<ConnectAuthorizationState>;
+export declare function connect(connector: string): AshConnectAuthorizationDefinition<InteractiveAuthorizationDefinition<ConnectAuthorizationState>>;
 export declare function connect(options: AshAuthorizationOptions & {
     readonly principalType?: "user";
-}): InteractiveAuthorizationDefinition<ConnectAuthorizationState>;
+}): AshConnectAuthorizationDefinition<InteractiveAuthorizationDefinition<ConnectAuthorizationState>>;
 export declare function connect(options: AshAuthorizationOptions & {
     readonly principalType: "app";
-}): NonInteractiveAuthorizationDefinition;
-export declare function connect(options: AshAuthorizationInput): InteractiveAuthorizationDefinition<ConnectAuthorizationState> | NonInteractiveAuthorizationDefinition;
+}): AshConnectAuthorizationDefinition<NonInteractiveAuthorizationDefinition>;
+export declare function connect(options: AshAuthorizationInput): AshConnectAuthorizationDefinition<InteractiveAuthorizationDefinition<ConnectAuthorizationState> | NonInteractiveAuthorizationDefinition>;

package/dist/ash/connection-authorization.js

@@ -33,10 +33,11 @@ import { startAuthorization } from "../authorization.js";
 import { ConnectorInstallationRequiredError, getTokenResponse, NoValidTokenError, UserAuthorizationRequiredError, } from "../token.js";
 export function connect(input) {
     const options = normalizeAuthorizationOptions(input);
+    const vercelConnect = { connector: options.connector };
     if (options.principalType === "app") {
-        return buildNonInteractiveDefinition(options);
+        return { ...buildNonInteractiveDefinition(options), vercelConnect };
     }
-    return buildInteractiveDefinition(options);
+    return { ...buildInteractiveDefinition(options), vercelConnect };
 }
 function normalizeAuthorizationOptions(input) {
     if (typeof input === "string") {

package/dist/ash/index.d.ts

@@ -6,6 +6,6 @@
  * this barrel re-exports the public API so consumers import
  * everything from `@vercel/connect/ash`.
  */
-export { connect, type AshAuthorizationInput, type AshAuthorizationOptions, type ConnectAuthorizationPhase, type ConnectAuthorizationState, } from "./connection-authorization.js";
+export { connect, type AshAuthorizationInput, type AshAuthorizationOptions, type AshConnectAuthorizationDefinition, type ConnectAuthorizationPhase, type ConnectAuthorizationState, type VercelConnectMetadata, } from "./connection-authorization.js";
 export { CONNECT_OAUTH_ISSUER, connectOAuth, type ConnectOAuthAudienceEnvironment, type ConnectOAuthEnvironment, type ConnectOAuthOptions, } from "./connect-oauth.js";
 export { connectSlackCredentials } from "./slack-credentials.js";

package/dist/authjs/connect-provider.js

@@ -26,9 +26,9 @@
 import { customFetch } from "@auth/core";
 import { getVercelOidcToken } from "@vercel/oidc";
 import { tryGetVercelTeamId, withTeamId } from "../internal/team-id.js";
-const CONNECT_AUTHORIZATION_URL = "https://vercel.com/api/connex/oauth/authorize";
-const CONNECT_TOKEN_URL = "https://vercel.com/api/connex/oauth/token";
-const CONNECT_USERINFO_URL = "https://vercel.com/api/connex/oauth/userinfo";
+const CONNECT_AUTHORIZATION_URL = "https://connect.vercel.com/oauth/authorize";
+const CONNECT_TOKEN_URL = "https://connect.vercel.com/oauth/token";
+const CONNECT_USERINFO_URL = "https://connect.vercel.com/oauth/userinfo";
 /**
  * Builds an Auth.js `OAuth2Config` for Vercel Connect. Push the
  * result into `AuthConfig.providers`.

package/dist/authorization.js

@@ -10,7 +10,7 @@ export async function startAuthorization(connector, params, options) {
         validateWebhookUrl(options.webhook);
     }
     const vercelToken = options?.vercelToken ?? (await getVercelOidcToken());
-    const endpoint = `https://api.vercel.com/v1/connex/authorize/${encodeURIComponent(connector)}`;
+    const endpoint = `https://api.vercel.com/v1/connect/authorize/${encodeURIComponent(connector)}`;
     const body = {
         ...params,
         ...(options?.callbackUrl !== undefined && {

package/dist/betterauth/connect-provider.js

@@ -30,9 +30,9 @@
 import { getVercelOidcToken } from "@vercel/oidc";
 import { getOAuth2Tokens } from "better-auth/oauth2";
 import { tryGetVercelTeamId, withTeamId } from "../internal/team-id.js";
-const CONNECT_AUTHORIZATION_URL = "https://vercel.com/api/connex/oauth/authorize";
-const CONNECT_TOKEN_URL = "https://vercel.com/api/connex/oauth/token";
-const CONNECT_USERINFO_URL = "https://vercel.com/api/connex/oauth/userinfo";
+const CONNECT_AUTHORIZATION_URL = "https://connect.vercel.com/oauth/authorize";
+const CONNECT_TOKEN_URL = "https://connect.vercel.com/oauth/token";
+const CONNECT_USERINFO_URL = "https://connect.vercel.com/oauth/userinfo";
 /**
  * Builds a `GenericOAuthConfig` entry for Vercel Connect. Pass the
  * result into `genericOAuth({ config: [...] })`.

package/dist/internal/team-id.js

@@ -1,7 +1,7 @@
 /**
  * Best-effort Vercel team-id extraction for the OAuth adapters.
  *
- * Vercel Connect's `/api/connex/oauth/authorize` endpoint accepts an
+ * Vercel Connect's `/oauth/authorize` endpoint accepts an
  * optional `?teamId=...` query parameter that scopes the consent UI
  * to a specific team. The team id lives inside the Vercel OIDC
  * token's `owner_id` claim, so we decode the JWT payload (no

package/dist/token.js

@@ -34,7 +34,7 @@ export async function getTokenResponse(connector, params, options) {
         cache.delete(cacheKey);
     }
     const vercelToken = options?.vercelToken ?? (await getVercelOidcToken());
-    const endpoint = `https://api.vercel.com/v1/connex/token/${encodeURIComponent(connector)}`;
+    const endpoint = `https://api.vercel.com/v1/connect/token/${encodeURIComponent(connector)}`;
     const response = await fetch(endpoint, {
         method: "POST",
         headers: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/connect",
-  "version": "0.0.4-alpha.4",
+  "version": "0.0.4-alpha.7",
   "type": "module",
   "exports": {
     ".": {
@@ -29,7 +29,7 @@
   "peerDependencies": {
     "@auth/core": ">=0.37.0",
     "better-auth": ">=1.5.0",
-    "experimental-ash": ">=0.3.0-alpha.29"
+    "experimental-ash": ">=0.8.2"
   },
   "peerDependenciesMeta": {
     "@auth/core": {