@mastra/connect 0.4.0 → 0.5.0-alpha.1

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export { connect } from './connect.js';
 export type { ConnectOptions, ConnectIntegrationOptions, ConnectTools } from './connect.js';
 export { channels } from './channels.js';
 export type { ChannelsOptions, ChannelsIntegrationOptions, ChannelsResolver, ChannelsResolverContext, ResolvedChannels, } from './channels.js';
-export type { ChannelProviderRegistration, ChannelBuildContext } from './providers/channel-provider.js';
+export type { ChannelProviderRegistration, ChannelInstance, ChannelRuntime } from './providers/channel-provider.js';
 export { credential } from './credential.js';
 export { environment } from './environment.js';
 export type { ConnectEnvironment, EnvironmentIntegrationOptions, EnvironmentOptions } from './environment.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,YAAY,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EACV,eAAe,EACf,0BAA0B,EAC1B,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACxG,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,kBAAkB,EAAE,6BAA6B,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC9G,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACjG,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACtG,YAAY,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,YAAY,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EACV,eAAe,EACf,0BAA0B,EAC1B,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,2BAA2B,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACpH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,kBAAkB,EAAE,6BAA6B,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC9G,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACjG,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACtG,YAAY,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -346,14 +346,12 @@ async function proxyRequestWithResponse(client, connectionId, options) {
 function credentialToken$1(credential) {
 	return credential.type === "oauth2" ? credential.accessToken : credential.apiKey;
 }
-function missingPeerError(integrationId, packageName, error) {
-	return new MastraConnectError("invalid_options", `channels() cannot build '${integrationId}' provider: install '${packageName}' as a dependency of your app (${error instanceof Error ? error.message : String(error)}).`);
-}
 const RESERVED_OPTION_KEYS = {
 	slack: [
 		"baseUrl",
 		"refreshToken",
 		"token",
+		"tokenResolver",
 		"encryptionKey"
 	],
 	telegram: [
@@ -383,61 +381,54 @@ function stripReservedOptions(integrationId, options) {
 const CHANNELS$1 = [
 	{
 		integrationId: "slack",
-		async build(credential, options) {
-			const refreshToken = credentialToken$1(credential);
-			let mod;
-			try {
-				mod = await import("@mastra/slack");
-			} catch (error) {
-				throw missingPeerError("slack", "@mastra/slack", error);
-			}
+		async create(options, runtime) {
+			const mod = await import("@mastra/slack");
 			const safeOptions = stripReservedOptions("slack", options);
-			return new mod.SlackProvider({
-				refreshToken,
+			const tokenResolver = async () => {
+				return credentialToken$1(await runtime.getCredential());
+			};
+			return { provider: new mod.SlackProvider({
+				tokenResolver,
 				...safeOptions ?? {}
-			});
+			}) };
 		}
 	},
 	{
 		integrationId: "telegram",
-		async build(credential, options) {
-			const botToken = credentialToken$1(credential);
-			let mod;
-			try {
-				mod = await import("@mastra/telegram");
-			} catch (error) {
-				throw missingPeerError("telegram", "@mastra/telegram", error);
-			}
+		async create(options, runtime) {
+			const mod = await import("@mastra/telegram");
 			const safeOptions = stripReservedOptions("telegram", options);
-			return new mod.TelegramProvider({
-				botToken,
-				...safeOptions ?? {}
-			});
+			const provider = new mod.TelegramProvider({ ...safeOptions ?? {} });
+			return {
+				provider,
+				async sync() {
+					const botToken = credentialToken$1(await runtime.getCredential());
+					await provider.configure?.({ botToken });
+				}
+			};
 		}
 	},
 	{
 		integrationId: "discord",
-		async build(credential, options, context) {
-			const botToken = credentialToken$1(credential);
-			const metadata = context?.context?.metadata ?? {};
-			const applicationId = options?.applicationId ?? (typeof metadata.applicationId === "string" ? metadata.applicationId : void 0) ?? (typeof metadata.application_id === "string" ? metadata.application_id : void 0);
-			const publicKey = options?.publicKey ?? (typeof metadata.publicKey === "string" ? metadata.publicKey : void 0) ?? (typeof metadata.public_key === "string" ? metadata.public_key : void 0);
-			let mod;
-			try {
-				mod = await import("@mastra/discord");
-			} catch (error) {
-				throw missingPeerError("discord", "@mastra/discord", error);
-			}
-			if (!applicationId || !publicKey) console.warn(`[@mastra/connect] discord channel: missing ${[!applicationId && "applicationId", !publicKey && "publicKey"].filter(Boolean).join(" + ")} on the connection. Store them on the connection's metadata or pass them via integrations.discord.providerOptions.`);
-			const { applicationId: _optAppId, publicKey: _optPubKey, ...rest } = options ?? {};
-			return new mod.DiscordProvider({
-				app: {
-					botToken,
-					applicationId,
-					publicKey
-				},
-				...rest
-			});
+		async create(options, runtime) {
+			const mod = await import("@mastra/discord");
+			const { applicationId: optionsAppId, publicKey: optionsPublicKey, ...rest } = options ?? {};
+			const safeOptions = stripReservedOptions("discord", rest);
+			const provider = new mod.DiscordProvider({ ...safeOptions ?? {} });
+			return {
+				provider,
+				async sync() {
+					const metadata = (await runtime.getConnectionContext())?.metadata ?? {};
+					const botToken = typeof metadata.botToken === "string" && metadata.botToken || typeof metadata.bot_token === "string" && metadata.bot_token || void 0;
+					if (!botToken) throw new MastraConnectError("no_active_connection", `Discord connection ${runtime.getConnectionId()} has no botToken in its metadata. Store the bot token on the connection (Nango setMetadata) to activate the Discord channel.`);
+					const applicationId = optionsAppId ?? (typeof metadata.applicationId === "string" ? metadata.applicationId : void 0) ?? (typeof metadata.application_id === "string" ? metadata.application_id : void 0);
+					const publicKey = optionsPublicKey ?? (typeof metadata.publicKey === "string" ? metadata.publicKey : void 0) ?? (typeof metadata.public_key === "string" ? metadata.public_key : void 0);
+					const credentials = { botToken };
+					if (applicationId) credentials.applicationId = applicationId;
+					if (publicKey) credentials.publicKey = publicKey;
+					await provider.configure?.(credentials);
+				}
+			};
 		}
 	}
 ];
@@ -66153,16 +66144,22 @@ const DEFAULT_TTL_MS = 3e4;
 /** Minimum wait after a failed platform fetch before another background revalidation. */
 const FAILURE_COOLDOWN_MS = 3e4;
 /**
-* Returns a live channels resolver over the project's Platform connections.
-* Channel-capable integrations (Slack, Telegram, Discord) with an active
-* project connection are materialized into `ChannelProvider` instances ready
-* to hand to `new Mastra({ channels: await channels({...}) })`.
+* Returns a live channels resolver over the project's Platform connections,
+* ready to hand to `new Mastra({ channels: await channels({...}) })`.
+*
+* Provider instances for every channel-capable integration (Slack, Telegram,
+* Discord) are constructed once, up front and credential-less, so their
+* webhook/OAuth routes can mount at Mastra construction. Each resolution
+* fetches the project's connections and late-binds credentials into the live
+* instances: integrations with an active connection appear in the resolved
+* map, others don't — so connecting a new channel on the platform takes
+* effect without redeploying the app.
 *
 * Configuration errors (missing project id, bad ttlMs, malformed integration
-* id) throw at call time so they surface at startup. Actionable per-integration
-* problems during resolution (needs re-auth, ambiguity, missing peer package)
-* are downgraded to warn-and-skip so one bad integration never takes down the
-* whole map.
+* id) reject at call time so they surface at startup. Actionable
+* per-integration problems (provider construction failure, needs re-auth,
+* ambiguity, credential sync failure) are downgraded to warn-and-skip so one
+* bad integration never takes down the whole map.
 *
 * @example
 * ```ts
@@ -66175,13 +66172,48 @@ const FAILURE_COOLDOWN_MS = 3e4;
 * });
 * ```
 */
-function channels(options = {}) {
+async function channels(options = {}) {
 	const projectId = options.projectId?.trim() || process.env.MASTRA_PROJECT_ID?.trim();
 	if (!projectId) throw new MastraConnectError("missing_project_id", "Missing project id: set MASTRA_PROJECT_ID or pass projectId.");
 	if (options.ttlMs !== void 0 && (!Number.isFinite(options.ttlMs) || options.ttlMs < 0)) throw new MastraConnectError("invalid_options", `Invalid ttlMs (${options.ttlMs}): expected a finite number of milliseconds >= 0.`);
 	validateIntegrationOverrides(options.integrations);
 	const ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
 	const client = resolveClient(options.client);
+	const states = [];
+	for (const registration of CHANNELS) {
+		const overrides = options.integrations?.[registration.integrationId] ?? {};
+		if (overrides.disabled) continue;
+		const state = {
+			registration,
+			instance: void 0,
+			connectionId: void 0
+		};
+		const runtime = {
+			client,
+			getConnectionId: () => state.connectionId,
+			getCredential: async () => {
+				const connectionId = state.connectionId;
+				if (!connectionId) throw new MastraConnectError("no_active_connection", `No active ${registration.integrationId} connection for project ${projectId}. Connect one on the platform, then retry.`);
+				return getCredential(client, connectionId);
+			},
+			getConnectionContext: async () => {
+				const connectionId = state.connectionId;
+				if (!connectionId) return void 0;
+				try {
+					return await getConnectionContext(client, connectionId);
+				} catch {
+					return;
+				}
+			}
+		};
+		try {
+			state.instance = await registration.create(overrides.providerOptions ?? {}, runtime);
+		} catch (error) {
+			console.warn(`[@mastra/connect] Skipping ${registration.integrationId} channel: ${error instanceof Error ? error.message : String(error)}`);
+			continue;
+		}
+		states.push(state);
+	}
 	let cache;
 	let inflight;
 	let lastFailureAt;
@@ -66195,17 +66227,20 @@ function channels(options = {}) {
 		}
 		const byIntegrationId = groupByIntegrationId(connections);
 		const providers = {};
-		for (const registration of CHANNELS) {
-			const integrationId = registration.integrationId;
+		for (const state of states) {
+			const integrationId = state.registration.integrationId;
 			const overrides = options.integrations?.[integrationId] ?? {};
-			if (overrides.disabled) continue;
 			const candidates = byIntegrationId.get(integrationId) ?? [];
-			if (candidates.length === 0) continue;
-			const connectionId = selectChannelConnection(integrationId, overrides.connectionId, candidates);
+			const connectionId = candidates.length === 0 ? void 0 : selectChannelConnection(integrationId, overrides.connectionId, candidates);
+			state.connectionId = connectionId;
 			if (!connectionId) continue;
-			const provider = await buildProvider(registration, connectionId, overrides, client);
-			if (!provider) continue;
-			providers[integrationId] = provider;
+			if (state.instance.sync) try {
+				await state.instance.sync();
+			} catch (error) {
+				console.warn(`[@mastra/connect] Skipping ${integrationId} channel: ${error instanceof Error ? error.message : String(error)}`);
+				continue;
+			}
+			providers[integrationId] = state.instance.provider;
 		}
 		lastFailureAt = void 0;
 		return providers;
@@ -66240,6 +66275,7 @@ function channels(options = {}) {
 		return refresh();
 	};
 	const invocable = ((_context) => resolve());
+	invocable.getRoutes = () => states.flatMap((state) => state.instance.provider.getRoutes());
 	invocable.invalidate = () => {
 		cache = void 0;
 	};
@@ -66247,35 +66283,8 @@ function channels(options = {}) {
 	invocable.disconnect = async () => {
 		cache = void 0;
 	};
-	invocable.then = ((onfulfilled, onrejected) => resolve().then(onfulfilled, onrejected));
 	return invocable;
 }
-async function buildProvider(registration, connectionId, overrides, client) {
-	let credential;
-	try {
-		credential = await getCredential(client, connectionId);
-	} catch (error) {
-		console.warn(`[@mastra/connect] Skipping ${registration.integrationId} channel: ${error instanceof Error ? error.message : String(error)}`);
-		return;
-	}
-	let context = {
-		connectionId,
-		client
-	};
-	try {
-		context = {
-			connectionId,
-			client,
-			context: await getConnectionContext(client, connectionId)
-		};
-	} catch {}
-	try {
-		return await registration.build(credential, overrides.providerOptions ?? {}, context);
-	} catch (error) {
-		console.warn(`[@mastra/connect] Skipping ${registration.integrationId} channel: ${error instanceof Error ? error.message : String(error)}`);
-		return;
-	}
-}
 /**
 * Selects the connection `channels()` should use for one provider.
 *