@cosmoops/connect-sdk 0.3.0 → 0.7.0

package/dist/cjs/server/handler.js

@@ -94,9 +94,9 @@ function redirect(location, cookies = []) {
  * export { handler as GET, handler as POST };
  * ```
  *
- * Every route resolves the organization from the caller's *own* session, never
+ * Every route resolves the workspace from the caller's *own* session, never
  * from a query parameter. A browser must not be able to ask about an
- * organization it is not signed into, and a client-supplied `organizationId`
+ * workspace it is not signed into, and a client-supplied `workspaceId`
  * is exactly that hole.
  */
 function createConnectHandler(options) {
@@ -104,6 +104,7 @@ function createConnectHandler(options) {
     const { client, session } = options;
     const defaultRedirect = options.defaultRedirect ?? "/";
     const stateCookieName = options.stateCookieName ?? "connect_oauth_state";
+    const silentCookieName = `${stateCookieName}_silent`;
     const callbackPath = `${basePath}/callback`;
     /**
      * Short-lived, httpOnly, and `SameSite=Lax` - `Strict` would not be sent on
@@ -124,6 +125,32 @@ function createConnectHandler(options) {
             .filter(Boolean)
             .join("; ");
     }
+    /**
+     * Marks the in-flight round trip as a silent (`prompt=none`) one, so the
+     * callback can tell a *probe that found nobody* from a *sign-in that
+     * failed*. The two arrive as the identical `error=login_required`, and they
+     * need opposite handling - see the callback.
+     *
+     * A cookie of its own rather than a flag folded into the state cookie:
+     * that one is parsed by splitting on `:` with the destination URL rejoined
+     * from the remainder, so smuggling a third field through it is exactly the
+     * kind of encoding trick that breaks the first time a `next` URL contains
+     * something unexpected. Same attributes and lifetime as the state cookie
+     * it travels beside.
+     */
+    function silentCookie(value, secure) {
+        const cleared = value === "";
+        return [
+            `${silentCookieName}=${encodeURIComponent(value)}`,
+            `Path=${basePath}`,
+            "HttpOnly",
+            "SameSite=Lax",
+            secure ? "Secure" : "",
+            cleared ? "Max-Age=0" : "Max-Age=900",
+        ]
+            .filter(Boolean)
+            .join("; ");
+    }
     async function requireToken(request) {
         const token = await session.read(request);
         if (!token) {
@@ -136,7 +163,7 @@ function createConnectHandler(options) {
         }
         return token;
     }
-    /** Signed-in identity plus the organization it belongs to - the first read every other route needs. */
+    /** Signed-in identity plus the workspace it belongs to - the first read every other route needs. */
     async function whoami(request) {
         return client.identity.getUser(await requireToken(request));
     }
@@ -146,30 +173,61 @@ function createConnectHandler(options) {
             // Signed out is a normal state for a page rendering a Login button, not
             // an error - `user: null` rather than a 401 the client must catch.
             if (!token)
-                return json({ user: null, subscription: null, serviceRole: null });
+                return json({ user: null, subscription: null, applicationRole: null });
             return json(await client.identity.getUser(token));
         },
         "GET /entitlements": async (request) => {
             const { user } = await whoami(request);
             const [readiness, subscription] = await Promise.all([
-                client.entitlements.getReadiness(user.organizationId),
-                client.entitlements.getSubscription(user.organizationId),
+                client.entitlements.getReadiness(user.workspaceId),
+                client.entitlements.getSubscription(user.workspaceId),
             ]);
             return json({ readiness, subscription });
         },
         "GET /plans": async () => json(await client.billing.listPlans()),
-        // Organization comes from the caller's own session, same as every other
+        // Workspace comes from the caller's own session, same as every other
         // route here - a browser must not be able to ask what another workspace
         // has left.
         "GET /addons": async (request) => {
             const { user } = await whoami(request);
-            return json(await client.billing.getAddonUsage(user.organizationId));
+            return json(await client.billing.getAddonUsage(user.workspaceId));
         },
         "GET /apps": async (request) => {
             const { user } = await whoami(request);
-            return json({ apps: await client.apps.list(user.organizationId) });
+            return json({ apps: await client.apps.list(user.workspaceId) });
         },
-        // Account-wide, not scoped to this service - see `SessionsResource`'s
+        "GET /integrations": async (request) => {
+            const { user } = await whoami(request);
+            return json({ toolkits: await client.integrations.list(user.workspaceId) });
+        },
+        "POST /integrations/connect": async (request) => {
+            const { user } = await whoami(request);
+            const body = (await request.json().catch(() => null));
+            if (!body?.toolkitSlug || !body?.returnUrl) {
+                throw new errors_js_1.ConnectError({
+                    status: 400,
+                    code: "validation_error",
+                    message: "toolkitSlug and returnUrl are required",
+                    endpoint: "POST /integrations/connect",
+                });
+            }
+            return json(await client.integrations.initiateConnect(user.workspaceId, body.toolkitSlug, body.returnUrl));
+        },
+        "POST /integrations/disconnect": async (request) => {
+            const { user } = await whoami(request);
+            const body = (await request.json().catch(() => null));
+            if (!body?.toolkitSlug) {
+                throw new errors_js_1.ConnectError({
+                    status: 400,
+                    code: "validation_error",
+                    message: "toolkitSlug is required",
+                    endpoint: "POST /integrations/disconnect",
+                });
+            }
+            await client.integrations.disconnect(user.workspaceId, body.toolkitSlug);
+            return json({ ok: true });
+        },
+        // Account-wide, not scoped to this application - see `SessionsResource`'s
         // doc comment. `requireToken` alone identifies the caller; the target
         // `sessionId` on the revoke routes travels in the JSON body, not the
         // URL, so the exact-match routes table above never needs a dynamic
@@ -208,14 +266,19 @@ function createConnectHandler(options) {
             const secure = url.protocol === "https:";
             const state = (0, identity_js_1.createState)();
             const next = safeRedirect(url.searchParams.get("next"), defaultRedirect);
+            const requestedPrompt = url.searchParams.get("prompt");
+            const prompt = requestedPrompt === "create" || requestedPrompt === "none" ? requestedPrompt : undefined;
             const authorizeUrl = client.identity.authorizeUrl({
                 redirectUri: `${url.origin}${callbackPath}`,
                 state,
-                ...(url.searchParams.get("prompt") === "create" ? { prompt: "create" } : {}),
+                ...(prompt ? { prompt } : {}),
             });
             // State and destination travel together in one cookie so the callback
             // cannot end up with one and not the other.
-            return redirect(authorizeUrl, [stateCookie(`${state}:${next}`, secure)]);
+            const cookies = [stateCookie(`${state}:${next}`, secure)];
+            if (prompt === "none")
+                cookies.push(silentCookie("1", secure));
+            return redirect(authorizeUrl, cookies);
         },
         /**
          * The other end of the round trip. Verifies `state`, exchanges the code,
@@ -232,10 +295,29 @@ function createConnectHandler(options) {
             if (!cookieState || !sameState(cookieState, returnedState)) {
                 // Either a forged callback or a genuinely stale tab. Neither should
                 // mint a session, and neither is worth an error page.
-                return redirect(`${next}${next.includes("?") ? "&" : "?"}connect_error=state_mismatch`, [clearState]);
+                return redirect(`${next}${next.includes("?") ? "&" : "?"}connect_error=state_mismatch`, [
+                    clearState,
+                    silentCookie("", secure),
+                ]);
             }
+            const wasSilent = readCookie(request, silentCookieName) === "1";
+            const clearSilent = silentCookie("", secure);
             const error = url.searchParams.get("error");
             if (error) {
+                // A silent (`prompt=none`) probe that came back empty-handed. All
+                // three of its outcomes mean the same thing to the app - "carry on
+                // signed out" - so it returns to `next` quietly: no retry, and no
+                // `connect_error`, because nothing went wrong.
+                //
+                // Getting this wrong is not subtle. The retry below fires on exactly
+                // the `login_required` a silent probe returns, so without this branch
+                // every silent attempt for a signed-out visitor would escalate itself
+                // into a full interactive sign-in redirect - turning "quietly check
+                // if they're already here" into "force everyone to log in", which is
+                // the precise opposite of the feature.
+                if (wasSilent) {
+                    return redirect(next, [clearState, clearSilent]);
+                }
                 // `login_required` is normal traffic, not a fault: a new account gets
                 // pulled out to their inbox to verify, and the ~15 minute request
                 // expires before they return. Connect has already signed them in, so
@@ -245,15 +327,16 @@ function createConnectHandler(options) {
                     const retry = new URL(`${url.origin}${basePath}/signin`);
                     retry.searchParams.set("next", next);
                     retry.searchParams.set("connect_retry", "1");
-                    return redirect(retry.toString(), [clearState]);
+                    return redirect(retry.toString(), [clearState, clearSilent]);
                 }
                 return redirect(`${next}${next.includes("?") ? "&" : "?"}connect_error=${encodeURIComponent(error)}`, [
                     clearState,
+                    clearSilent,
                 ]);
             }
             const code = url.searchParams.get("code");
             if (!code) {
-                return redirect(`${next}${next.includes("?") ? "&" : "?"}connect_error=missing_code`, [clearState]);
+                return redirect(`${next}${next.includes("?") ? "&" : "?"}connect_error=missing_code`, [clearState, clearSilent]);
             }
             const result = await client.identity.exchangeCode({
                 code,
@@ -262,7 +345,7 @@ function createConnectHandler(options) {
             // Verified before the session is stored, not after - an unverifiable
             // token must never become a signed-in user.
             await client.identity.verifyIdToken(result.idToken);
-            const response = redirect(next, [clearState]);
+            const response = redirect(next, [clearState, clearSilent]);
             await session.write(request, response, result.sessionToken);
             return response;
         },

package/dist/cjs/server/http.js

@@ -44,7 +44,7 @@ function parseRetryAfterMs(response) {
     return Number.isFinite(seconds) ? Math.max(0, seconds) * 1000 : null;
 }
 /**
- * Both error dialects, one shape. `/api/v1/service/*` answers
+ * Both error dialects, one shape. `/api/v1/application/*` answers
  * `{ error: { code, message } }`; the `/sso/*` endpoints answer OAuth2's
  * `{ error, error_description }`.
  */

package/dist/cjs/server/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createState = exports.createConnectHandler = exports.SDK_VERSION = exports.DEFAULT_BASE_URL = exports.ConnectClient = void 0;
+exports.verifyConnectWebhook = exports.createConnectWebhookHandler = exports.createState = exports.createConnectHandler = exports.SDK_VERSION = exports.DEFAULT_BASE_URL = exports.ConnectClient = void 0;
 /**
  * Server-only half of `@cosmoops/connect-sdk`.
  *
@@ -16,3 +16,10 @@ var handler_js_1 = require("./handler.js");
 Object.defineProperty(exports, "createConnectHandler", { enumerable: true, get: function () { return handler_js_1.createConnectHandler; } });
 var identity_js_1 = require("./resources/identity.js");
 Object.defineProperty(exports, "createState", { enumerable: true, get: function () { return identity_js_1.createState; } });
+/**
+ * Webhook verification and a ready-made POST route. Server-only for the
+ * obvious reason: the signing secret must never reach a browser bundle.
+ */
+var webhooks_js_1 = require("./webhooks.js");
+Object.defineProperty(exports, "createConnectWebhookHandler", { enumerable: true, get: function () { return webhooks_js_1.createConnectWebhookHandler; } });
+Object.defineProperty(exports, "verifyConnectWebhook", { enumerable: true, get: function () { return webhooks_js_1.verifyConnectWebhook; } });

package/dist/cjs/server/resources/access.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AccessResource = void 0;
 const http_js_1 = require("../http.js");
-/** What a signed-in member may do on your service, and the role catalog behind it. */
+/** What a signed-in member may do on your application, and the role catalog behind it. */
 class AccessResource {
     transport;
     constructor(transport) {
@@ -17,10 +17,10 @@ class AccessResource {
         return (0, http_js_1.request)(this.transport, {
             method: "GET",
             path: `/rbac/users/${(0, http_js_1.pathSegment)(userId, "userId")}/roles`,
-            query: { organizationId: input.organizationId },
+            query: { workspaceId: input.workspaceId },
         });
     }
-    /** Your service's own permission catalog and role definitions - the definitions `getUserRoles` resolves against. */
+    /** Your application's own permission catalog and role definitions - the definitions `getUserRoles` resolves against. */
     listRoles() {
         return (0, http_js_1.request)(this.transport, { method: "GET", path: "/roles" });
     }

package/dist/cjs/server/resources/ai.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AiResource = void 0;
 const http_js_1 = require("../http.js");
-/** RAG chat and structured extraction against an organization's data. */
+/** RAG chat and structured extraction against a workspace's data. */
 class AiResource {
     transport;
     constructor(transport) {

package/dist/cjs/server/resources/analytics.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnalyticsResource = void 0;
+const http_js_1 = require("../http.js");
+/**
+ * Your application's own analytics: emit product events, and read back the daily
+ * numbers Connect aggregates from them.
+ *
+ * There is no way to name an application in either call. The scope is always the one
+ * your API key belongs to - that is the endpoint's security model, not an
+ * omission.
+ */
+class AnalyticsResource {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    /**
+     * Daily series for the requested metrics, up to 90 days.
+     *
+     * **Throws on failure**, unlike `emit` below. A read whose result you are
+     * about to render has to be able to say "I could not load"; silently
+     * returning an empty series would draw a chart of zeroes.
+     */
+    async series(query) {
+        const params = new URLSearchParams({
+            metrics: query.metrics.join(","),
+            from: query.from,
+            to: query.to,
+        });
+        return (0, http_js_1.request)(this.transport, {
+            method: "GET",
+            path: `/analytics?${params.toString()}`,
+        });
+    }
+    /**
+     * Never throws - the same judgement `LogsResource.write` makes, for the same
+     * reason: telemetry that takes down the code path it was observing is worse
+     * than a lost event. A failure is reported through `delivered`.
+     *
+     * Up to 50 events per call. Pass `sessionToken` on an event to attribute it
+     * to the signed-in user; without one it still lands, just unattributed.
+     */
+    async emit(events) {
+        const normalized = events.map((event) => ({
+            ...event,
+            occurredAt: event.occurredAt instanceof Date ? event.occurredAt.toISOString() : event.occurredAt,
+        }));
+        try {
+            const result = await (0, http_js_1.request)(this.transport, {
+                method: "POST",
+                path: "/events",
+                json: { events: normalized },
+            });
+            return {
+                delivered: true,
+                accepted: result?.accepted ?? events.length,
+                attributed: result?.attributed ?? 0,
+            };
+        }
+        catch {
+            return { delivered: false, accepted: 0, attributed: 0 };
+        }
+    }
+}
+exports.AnalyticsResource = AnalyticsResource;

package/dist/cjs/server/resources/apps.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AppsResource = void 0;
 const http_js_1 = require("../http.js");
-/** The services an organization can open - the data behind a launcher grid. */
+/** The applications a workspace can open - the data behind a launcher grid. */
 class AppsResource {
     transport;
     constructor(transport) {
@@ -10,13 +10,13 @@ class AppsResource {
     }
     /**
      * Launchable apps only, so a grid tile is never a dead end. The calling
-     * service is included and flagged `isCurrent` rather than filtered out.
+     * application is included and flagged `isCurrent` rather than filtered out.
      */
-    async list(organizationId) {
+    async list(workspaceId) {
         const result = await (0, http_js_1.request)(this.transport, {
             method: "GET",
             path: "/apps",
-            query: { organizationId },
+            query: { workspaceId },
         });
         // `?? []` for the same reason `billing.listPlans` has it: this is a
         // collection every caller immediately maps or measures, and a body without

package/dist/cjs/server/resources/billing.js

@@ -10,7 +10,7 @@ class BillingResource {
         this.transport = transport;
     }
     /**
-     * Your service's active plans - render live pricing instead of hardcoding it.
+     * Your application's active plans - render live pricing instead of hardcoding it.
      *
      * `features` is normalised on the way out: Connect used to send bare keys
      * and now sends `{ key, name, description }`, and this SDK is versioned
@@ -28,7 +28,7 @@ class BillingResource {
         };
     }
     /**
-     * What is left of every consumable add-on on an organization's
+     * What is left of every consumable add-on on a workspace's
      * subscription - the read half of `consumeAddon`.
      *
      * Needs a key scoped to `addons:read`, which is separate from
@@ -38,10 +38,10 @@ class BillingResource {
      * Returns an empty `addons` array rather than throwing when there is
      * nothing to meter, so a caller can render it unconditionally.
      */
-    async getAddonUsage(organizationId) {
+    async getAddonUsage(workspaceId) {
         const response = await (0, http_js_1.request)(this.transport, {
             method: "GET",
-            path: `/addons/organizations/${(0, http_js_1.pathSegment)(organizationId, "organizationId")}`,
+            path: `/addons/workspaces/${(0, http_js_1.pathSegment)(workspaceId, "workspaceId")}`,
         });
         // Normalised, not passed through: the promise above resolves for any 2xx,
         // and `ConnectUsageMeter` reads `addons` straight off it. A body without
@@ -52,7 +52,7 @@ class BillingResource {
     }
     /**
      * Debit a consumable add-on's per-cycle balance on behalf of an
-     * organization's users. Call it at whatever cadence your usage happens.
+     * workspace's users. Call it at whatever cadence your usage happens.
      *
      * An `Idempotency-Key` is always sent, generated per call when you do not
      * supply one: a balance cannot be un-spent, so a retried consume without a

package/dist/cjs/server/resources/drive.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DriveResource = void 0;
 const http_js_1 = require("../http.js");
-/** Files in an organization's Drive - upload, and signed URLs to read back. */
+/** Files in a workspace's Drive - upload, and signed URLs to read back. */
 class DriveResource {
     transport;
     constructor(transport) {
@@ -12,7 +12,7 @@ class DriveResource {
         const form = new FormData();
         const fileName = input.fileName ?? input.file.name ?? "upload";
         form.set("file", input.file, fileName);
-        form.set("organizationId", input.organizationId);
+        form.set("workspaceId", input.workspaceId);
         if (input.parentId)
             form.set("parentId", input.parentId);
         return (0, http_js_1.request)(this.transport, { method: "POST", path: "/drive/files", multipart: form });
@@ -22,7 +22,7 @@ class DriveResource {
         const result = await (0, http_js_1.request)(this.transport, {
             method: "GET",
             path: `/drive/files/${(0, http_js_1.pathSegment)(fileId, "fileId")}/url`,
-            query: { organizationId: input.organizationId },
+            query: { workspaceId: input.workspaceId },
         });
         return result.url;
     }
@@ -31,7 +31,7 @@ class DriveResource {
         const result = await (0, http_js_1.request)(this.transport, {
             method: "GET",
             path: `/drive/files/${(0, http_js_1.pathSegment)(fileId, "fileId")}/preview-url`,
-            query: { organizationId: input.organizationId, size: input.size },
+            query: { workspaceId: input.workspaceId, size: input.size },
         });
         return result.url;
     }

package/dist/cjs/server/resources/entitlements.js

@@ -12,7 +12,7 @@ class EntitlementsResource {
         this.transport = transport;
     }
     /**
-     * Every gate Connect owns between an organization and your service -
+     * Every gate Connect owns between a workspace and your application -
      * subscription, KYC/KYB, a chargeable payment method, seat headroom -
      * resolved in one call.
      *
@@ -20,17 +20,17 @@ class EntitlementsResource {
      * Connect screen that fixes it, so you can route them somewhere useful
      * instead of refusing them with nowhere to go.
      */
-    getReadiness(organizationId) {
+    getReadiness(workspaceId) {
         return (0, http_js_1.request)(this.transport, {
             method: "GET",
-            path: `/onboarding/organizations/${(0, http_js_1.pathSegment)(organizationId, "organizationId")}`,
+            path: `/onboarding/workspaces/${(0, http_js_1.pathSegment)(workspaceId, "workspaceId")}`,
         });
     }
     /** The live plan and subscription, including `plan.features`. */
-    getSubscription(organizationId) {
+    getSubscription(workspaceId) {
         return (0, http_js_1.request)(this.transport, {
             method: "GET",
-            path: `/subscriptions/organizations/${(0, http_js_1.pathSegment)(organizationId, "organizationId")}`,
+            path: `/subscriptions/workspaces/${(0, http_js_1.pathSegment)(workspaceId, "workspaceId")}`,
         });
     }
     /**
@@ -41,8 +41,8 @@ class EntitlementsResource {
      * all: "not entitled" is the same answer either way, and a feature gate
      * should not need a try/catch around it.
      */
-    async hasFeature(organizationId, feature) {
-        const result = await this.getSubscription(organizationId);
+    async hasFeature(workspaceId, feature) {
+        const result = await this.getSubscription(workspaceId);
         return result.hasActiveSubscription && (result.plan?.features.includes(feature) ?? false);
     }
 }

package/dist/cjs/server/resources/identity.js

@@ -70,7 +70,7 @@ class IdentityResource {
             sessionTokenExpiresIn: wire.session_token_expires_in,
             user: wire.user,
             subscription: wire.subscription,
-            serviceRole: wire.serviceRole,
+            applicationRole: wire.applicationRole,
         };
     }
     /**
@@ -140,7 +140,7 @@ class IdentityResource {
         return {
             user: wire.user,
             subscription: wire.subscription,
-            serviceRole: wire.serviceRole,
+            applicationRole: wire.applicationRole,
             sessionExpiresAt: wire.session_expires_at,
         };
     }
@@ -149,7 +149,7 @@ class IdentityResource {
      * rest of its ~15-day life. Discard your own copy of `sessionToken` too;
      * this does not do that for you.
      *
-     * `scope` defaults to `"device"`: this sign-in, every other service signed
+     * `scope` defaults to `"device"`: this sign-in, every other application signed
      * into from the same browser, and Connect's own session on that one device.
      * `"all"` ends every session on every device - an explicit "sign out
      * everywhere" action only.
@@ -181,7 +181,7 @@ class IdentityResource {
             throw new errors_js_1.ConnectError({
                 status: 0,
                 code: "missing_client_id",
-                message: "identity.* needs `clientId`. Pass it to `new ConnectClient({ clientId, apiKey })` - it is shown in this service's Setup tab once SSO is enabled.",
+                message: "identity.* needs `clientId`. Pass it to `new ConnectClient({ clientId, apiKey })` - it is shown in this application's Integration tab, under Connect client.",
                 endpoint: "identity",
             });
         }

package/dist/cjs/server/resources/integrations.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntegrationsResource = void 0;
+const http_js_1 = require("../http.js");
+/**
+ * Composio-hosted third-party connections (Google Calendar, Slack,
+ * Twitter/X, ...) a workspace has connected. Connect proxies every call
+ * here - your application never sees or holds the underlying OAuth token, which
+ * stays with Composio.
+ */
+class IntegrationsResource {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    /** Enabled toolkits and this workspace's connection status for each. */
+    async list(workspaceId) {
+        const result = await (0, http_js_1.request)(this.transport, {
+            method: "GET",
+            path: "/integrations",
+            query: { workspaceId },
+        });
+        // `?? []` for the same reason `AppsResource.list` has it - a collection
+        // every caller immediately maps or measures.
+        return result.toolkits ?? [];
+    }
+    /**
+     * Starts a Composio-hosted connection for one toolkit. The returned
+     * `redirectUrl` is where the browser completes the provider's OAuth
+     * screen, then Composio bounces it back to `returnUrl`.
+     *
+     * **The connection is not active when this returns.** Treat the toolkit
+     * as `pending` until a later `list()` call reports `active` - only
+     * Connect's own webhook from Composio confirms that, never the redirect
+     * itself. Reconnecting a disconnected/failed toolkit calls this same
+     * method - there is no separate reconnect.
+     *
+     * Meant to be called on behalf of a signed-in workspace admin (this is what the
+     * bridge's fixed `POST /integrations/connect` route does), not as a bare
+     * background action with no admin present to complete the OAuth screen.
+     */
+    async initiateConnect(workspaceId, toolkitSlug, returnUrl) {
+        return (0, http_js_1.request)(this.transport, {
+            method: "POST",
+            path: "/integrations/connect",
+            json: { workspaceId, toolkitSlug, returnUrl },
+        });
+    }
+    /** Idempotent - disconnecting a toolkit that was never connected, or is already disconnected, is a success. */
+    async disconnect(workspaceId, toolkitSlug) {
+        return (0, http_js_1.request)(this.transport, {
+            method: "POST",
+            path: "/integrations/disconnect",
+            json: { workspaceId, toolkitSlug },
+        });
+    }
+    /** Calls a Composio action against this workspace's connected account for the named toolkit. */
+    async execute(workspaceId, input) {
+        return (0, http_js_1.request)(this.transport, {
+            method: "POST",
+            path: "/integrations/actions/execute",
+            json: { workspaceId, ...input },
+        });
+    }
+}
+exports.IntegrationsResource = IntegrationsResource;

package/dist/cjs/server/resources/logs.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LogsResource = void 0;
 const http_js_1 = require("../http.js");
-/** Push feature events into the Console's audit log, filterable to your service. */
+/** Push feature events into the Console's audit log, filterable to your application. */
 class LogsResource {
     transport;
     constructor(transport) {
@@ -14,9 +14,9 @@ class LogsResource {
      * reported through the return value.
      *
      * Pass `sessionToken` to attribute the event to the end user it belongs to.
-     * Both scopes on the stored entry come from something verified - the service
+     * Both scopes on the stored entry come from something verified - the application
      * from your API key, the user from that token, which Connect checks was
-     * minted for your service before attributing anything. `attributed` in the
+     * minted for your application before attributing anything. `attributed` in the
      * result says whether it resolved; a `false` there still means the line was
      * stored, just without a user on it.
      */

package/dist/cjs/server/resources/sessions.js

@@ -8,11 +8,11 @@ const http_js_1 = require("../http.js");
  * timestamps - the same list Connect's own account settings page shows the
  * user themselves.
  *
- * **Account-wide, not scoped to this service.** A Connect session is one
- * browser's login to Connect, and it fans out to every partner service's own
- * `sessionToken` - Connect has no per-service session concept to filter by.
+ * **Account-wide, not scoped to this application.** A Connect session is one
+ * browser's login to Connect, and it fans out to every partner application's own
+ * `sessionToken` - Connect has no per-application session concept to filter by.
  * `list()` returns every session on the account, including ones that
- * originated from a completely different, unrelated service. Requires the
+ * originated from a completely different, unrelated application. Requires the
  * `sessions:manage` scope on your API key - unlike `identity`'s base `sso`
  * capability, this is never granted to a zero-scope legacy key by default.
  *
@@ -38,7 +38,7 @@ class SessionsResource {
     }
     /**
      * Ends one specific session by id - not necessarily the one `sessionToken`
-     * itself was minted from. Cascades to every partner-service sign-in that
+     * itself was minted from. Cascades to every partner-application sign-in that
      * originated from that same browser, same as Connect's own "sign out this
      * device".
      */
@@ -72,7 +72,7 @@ class SessionsResource {
             throw new errors_js_1.ConnectError({
                 status: 0,
                 code: "missing_client_id",
-                message: "sessions.* needs `clientId`. Pass it to `new ConnectClient({ clientId, apiKey })` - it is shown in this service's Setup tab once SSO is enabled.",
+                message: "sessions.* needs `clientId`. Pass it to `new ConnectClient({ clientId, apiKey })` - it is shown in this application's Integration tab, under Connect client.",
                 endpoint: "sessions",
             });
         }