@aeolus-fleet/gateway 0.32.2 → 0.34.0

package/dist/adapters/slack/slack-call.d.ts

@@ -0,0 +1,15 @@
+/**
+ * One call of Slack's Web API: a form POSTed to a method, as a token if
+ * given. Slack answers JSON with ok and, when not, its own error code; a 429
+ * says when to ask again in Retry-After.
+ */
+import { z } from 'zod';
+import { type Result } from '../../core/shared/result.js';
+import type { SlackRefusal } from '../../core/slack/ports.js';
+export type SlackCall = <T>(asked: {
+    method: string;
+    form: Record<string, string>;
+    token?: string;
+}, answers: z.ZodType<T>) => Promise<Result<T, SlackRefusal>>;
+/** Calls a Web API method with a form, as the token given if any, and parses what it answers OK. */
+export declare function createSlackCall(apiUrl: string): SlackCall;

package/dist/adapters/slack/slack-call.js

@@ -0,0 +1,41 @@
+/**
+ * One call of Slack's Web API: a form POSTed to a method, as a token if
+ * given. Slack answers JSON with ok and, when not, its own error code; a 429
+ * says when to ask again in Retry-After.
+ */
+import { z } from 'zod';
+import { err, ok } from '../../core/shared/result.js';
+/** How long the gateway waits for Slack. */
+const SLACK_TIMEOUT_MS = 10_000;
+/** Waited when a 429 names no Retry-After. */
+const DEFAULT_RETRY_AFTER_SECONDS = 60;
+const refusedSchema = z.object({ ok: z.literal(false), error: z.string() });
+/** Calls a Web API method with a form, as the token given if any, and parses what it answers OK. */
+export function createSlackCall(apiUrl) {
+    return async ({ method, form, token }, answers) => {
+        let response;
+        try {
+            response = await fetch(`${apiUrl}/${method}`, {
+                method: 'POST',
+                headers: { 'content-type': 'application/x-www-form-urlencoded', ...(token === undefined ? {} : { authorization: `Bearer ${token}` }) },
+                body: new URLSearchParams(form),
+                signal: AbortSignal.timeout(SLACK_TIMEOUT_MS),
+            });
+        }
+        catch (error) {
+            return err({ kind: 'unavailable', message: error instanceof Error ? error.message : String(error) });
+        }
+        if (response.status === 429) {
+            const retryAfter = Number(response.headers.get('retry-after'));
+            return err({ kind: 'rateLimited', retryAfterSeconds: Number.isFinite(retryAfter) && retryAfter > 0 ? retryAfter : DEFAULT_RETRY_AFTER_SECONDS });
+        }
+        const body = await response.json().catch(() => undefined);
+        const answered = answers.safeParse(body);
+        if (answered.success) {
+            return ok(answered.data);
+        }
+        const refused = refusedSchema.safeParse(body);
+        return err(refused.success ? { kind: 'refused', error: refused.data.error } : { kind: 'unavailable', message: `Slack answered ${String(response.status)} with no answer the gateway reads` });
+    };
+}
+//# sourceMappingURL=slack-call.js.map

package/dist/adapters/slack/slack-call.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-call.js","sourceRoot":"","sources":["../../../src/adapters/slack/slack-call.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,GAAG,EAAE,EAAE,EAAe,MAAM,6BAA6B,CAAC;AAGnE,4CAA4C;AAC5C,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC,8CAA8C;AAC9C,MAAM,2BAA2B,GAAG,EAAE,CAAC;AAEvC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAI5E,oGAAoG;AACpG,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE;QAChD,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,IAAI,MAAM,EAAE,EAAE;gBAC5C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,mCAAmC,EAAE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE,CAAC,EAAE;gBACtI,IAAI,EAAE,IAAI,eAAe,CAAC,IAAI,CAAC;gBAC/B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,gBAAgB,CAAC;aAC9C,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACvG,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;YAC/D,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,2BAA2B,EAAE,CAAC,CAAC;QACnJ,CAAC;QACD,MAAM,IAAI,GAAY,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACnE,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrB,OAAO,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QACD,MAAM,OAAO,GAAG,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9C,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,kBAAkB,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,mCAAmC,EAAE,CAAC,CAAC;IAChM,CAAC,CAAC;AACJ,CAAC"}

package/dist/adapters/slack/slack-messages.d.ts

@@ -0,0 +1,4 @@
+import type { SlackMessages } from '../../core/slack/ports.js';
+export declare function createSlackMessages(options: {
+    apiUrl: string;
+}): SlackMessages;

package/dist/adapters/slack/slack-messages.js

@@ -0,0 +1,53 @@
+/**
+ * A bot's posts in Slack, with its bot token: a message only one person
+ * sees in a conversation (chat.postEphemeral), its text as a section and a
+ * button that opens an address, if any; a message in a conversation or a
+ * thread, with a button per option under a question (chat.postMessage);
+ * and a reaction (reactions.add).
+ */
+import { z } from 'zod';
+import { ok } from '../../core/shared/result.js';
+import { createSlackCall } from './slack-call.js';
+const postedSchema = z.object({ ok: z.literal(true) });
+const postedMessageSchema = z.object({ ok: z.literal(true), channel: z.string(), ts: z.string() });
+/** Slack's refusal of a reaction the message carries already: what was asked holds. */
+const ALREADY_REACTED = 'already_reacted';
+export function createSlackMessages(options) {
+    const call = createSlackCall(options.apiUrl);
+    return {
+        postOnlyTo: async (botToken, { channel, user, text, button }) => {
+            const form = { channel, user, text };
+            if (button !== undefined) {
+                form.blocks = JSON.stringify([
+                    { type: 'section', text: { type: 'mrkdwn', text } },
+                    { type: 'actions', elements: [{ type: 'button', text: { type: 'plain_text', text: button.text }, url: button.url, style: 'primary' }] },
+                ]);
+            }
+            const posted = await call({ method: 'chat.postEphemeral', form, token: botToken }, postedSchema);
+            return posted.isOk ? ok(undefined) : posted;
+        },
+        post: async (botToken, { messageId, channel, threadTs, text, buttons }) => {
+            const form = { channel, text };
+            if (threadTs !== null) {
+                form.thread_ts = threadTs;
+            }
+            if (buttons.length > 0) {
+                form.blocks = JSON.stringify([
+                    { type: 'section', text: { type: 'mrkdwn', text } },
+                    { type: 'actions', block_id: messageId, elements: buttons.map(({ text: label, option }) => ({ type: 'button', action_id: `answer-${String(option)}`, text: { type: 'plain_text', text: label }, value: String(option) })) },
+                ]);
+            }
+            const posted = await call({ method: 'chat.postMessage', form, token: botToken }, postedMessageSchema);
+            return posted.isOk ? ok({ channel: posted.value.channel, ts: posted.value.ts }) : posted;
+        },
+        postInThread: async (botToken, { channel, threadTs, text }) => {
+            const posted = await call({ method: 'chat.postMessage', form: { channel, thread_ts: threadTs, text }, token: botToken }, postedSchema);
+            return posted.isOk ? ok(undefined) : posted;
+        },
+        react: async (botToken, { channel, ts, name }) => {
+            const reacted = await call({ method: 'reactions.add', form: { channel, timestamp: ts, name }, token: botToken }, postedSchema);
+            return reacted.isOk || (reacted.error.kind === 'refused' && reacted.error.error === ALREADY_REACTED) ? ok(undefined) : reacted;
+        },
+    };
+}
+//# sourceMappingURL=slack-messages.js.map

package/dist/adapters/slack/slack-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-messages.js","sourceRoot":"","sources":["../../../src/adapters/slack/slack-messages.ts"],"names":[],"mappings":"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"}

package/dist/adapters/slack/slack-sign-in.d.ts

@@ -0,0 +1,4 @@
+import type { SlackSignIn } from '../../core/slack/ports.js';
+export declare function createSlackSignIn(options: {
+    apiUrl: string;
+}): SlackSignIn;

package/dist/adapters/slack/slack-sign-in.js

@@ -0,0 +1,33 @@
+/**
+ * Sign in with Slack (OpenID Connect), through an app's client credentials
+ * (gateway scopes 9.3): Slack's sign-in screen for the workspace, then the
+ * code it sends back turned into a user token (openid.connect.token) and
+ * that token into who signed in (openid.connect.userInfo).
+ */
+import { z } from 'zod';
+import { ok } from '../../core/shared/result.js';
+import { SIGN_IN_SCOPES } from '../../core/slack/slack-app.js';
+import { createSlackCall } from './slack-call.js';
+/** Slack's sign-in screen, beside its Web API on Slack's own host. */
+const AUTHORIZE_PATH = '/openid/connect/authorize';
+const tokenSchema = z.object({ ok: z.literal(true), access_token: z.string() });
+const userInfoSchema = z.object({ ok: z.literal(true), 'https://slack.com/user_id': z.string(), 'https://slack.com/team_id': z.string(), name: z.string() });
+export function createSlackSignIn(options) {
+    const call = createSlackCall(options.apiUrl);
+    return {
+        authorizeUrl: ({ clientId, redirectUrl, state, teamId }) => {
+            const url = new URL(AUTHORIZE_PATH, options.apiUrl);
+            url.search = new URLSearchParams({ response_type: 'code', scope: SIGN_IN_SCOPES.join(' '), client_id: clientId, redirect_uri: redirectUrl, state, team: teamId }).toString();
+            return url.toString();
+        },
+        complete: async ({ clientId, clientSecret, code, redirectUrl }) => {
+            const token = await call({ method: 'openid.connect.token', form: { client_id: clientId, client_secret: clientSecret, code, redirect_uri: redirectUrl } }, tokenSchema);
+            if (!token.isOk) {
+                return token;
+            }
+            const user = await call({ method: 'openid.connect.userInfo', form: {}, token: token.value.access_token }, userInfoSchema);
+            return user.isOk ? ok({ teamId: user.value['https://slack.com/team_id'], userId: user.value['https://slack.com/user_id'], name: user.value.name }) : user;
+        },
+    };
+}
+//# sourceMappingURL=slack-sign-in.js.map

package/dist/adapters/slack/slack-sign-in.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-sign-in.js","sourceRoot":"","sources":["../../../src/adapters/slack/slack-sign-in.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,EAAE,EAAE,MAAM,6BAA6B,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,sEAAsE;AACtE,MAAM,cAAc,GAAG,2BAA2B,CAAC;AAEnD,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAEhF,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,2BAA2B,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,2BAA2B,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAE7J,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IAC3D,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,OAAO;QACL,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;YACzD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YACpD,GAAG,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC7K,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;QACxB,CAAC;QACD,QAAQ,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE;YAChE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,EAAE,MAAM,EAAE,sBAAsB,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;YACvK,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBAChB,OAAO,KAAK,CAAC;YACf,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,EAAE,MAAM,EAAE,yBAAyB,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,cAAc,CAAC,CAAC;YAC1H,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,2BAA2B,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,2BAA2B,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5J,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/slack/slack-tooling.d.ts

@@ -0,0 +1,6 @@
+import type { SlackTooling } from '../../core/slack/ports.js';
+/** Slack's public Web API. */
+export declare const SLACK_API_URL = "https://slack.com/api";
+export declare function createSlackTooling(options: {
+    apiUrl: string;
+}): SlackTooling;

package/dist/adapters/slack/slack-tooling.js

@@ -0,0 +1,68 @@
+/**
+ * Slack's Web API for app management (gateway scopes 9.1, 9.2): rotating
+ * the app configuration token, making and removing an app from a manifest,
+ * and turning an install's code into its bot token.
+ */
+import { z } from 'zod';
+import { ok } from '../../core/shared/result.js';
+import { createSlackCall } from './slack-call.js';
+/** Slack's public Web API. */
+export const SLACK_API_URL = 'https://slack.com/api';
+const SECOND_MS = 1000;
+const rotatedSchema = z.object({ ok: z.literal(true), token: z.string(), refresh_token: z.string(), team_id: z.string(), exp: z.number() });
+const madeSchema = z.object({
+    ok: z.literal(true),
+    app_id: z.string(),
+    credentials: z.object({ client_id: z.string(), client_secret: z.string(), signing_secret: z.string() }),
+    oauth_authorize_url: z.string(),
+});
+const installedSchema = z.object({ ok: z.literal(true), access_token: z.string(), bot_user_id: z.string(), app_id: z.string(), team: z.object({ id: z.string(), name: z.string() }) });
+/** Slack's app manifest for what the gateway asks it to make: a bot with a direct messages tab, its scopes and any user scopes, the redirects, and the events Slack sends the gateway. */
+function manifestOf(description) {
+    return {
+        display_information: { name: description.name, description: description.description },
+        features: { bot_user: { display_name: description.name, always_online: true }, app_home: { home_tab_enabled: false, messages_tab_enabled: true, messages_tab_read_only_enabled: false } },
+        oauth_config: { redirect_urls: [...description.redirectUrls], scopes: { bot: [...description.botScopes], ...(description.userScopes.length === 0 ? {} : { user: [...description.userScopes] }) } },
+        settings: {
+            event_subscriptions: { request_url: description.events.url, bot_events: [...description.events.botEvents] },
+            interactivity: { is_enabled: true, request_url: description.actionsUrl },
+            org_deploy_enabled: false,
+            socket_mode_enabled: false,
+            token_rotation_enabled: false,
+        },
+    };
+}
+export function createSlackTooling(options) {
+    const call = createSlackCall(options.apiUrl);
+    return {
+        rotateConfigurationToken: async (refreshToken) => {
+            const rotated = await call({ method: 'tooling.tokens.rotate', form: { refresh_token: refreshToken } }, rotatedSchema);
+            return rotated.isOk ? ok({ token: { accessToken: rotated.value.token, refreshToken: rotated.value.refresh_token, expiresAt: new Date(rotated.value.exp * SECOND_MS) }, teamId: rotated.value.team_id }) : rotated;
+        },
+        makeApp: async (accessToken, description) => {
+            const made = await call({ method: 'apps.manifest.create', form: { manifest: JSON.stringify(manifestOf(description)) }, token: accessToken }, madeSchema);
+            if (!made.isOk) {
+                return made;
+            }
+            const { app_id: appId, credentials, oauth_authorize_url: installUrl } = made.value;
+            return ok({ appId, clientId: credentials.client_id, clientSecret: credentials.client_secret, signingSecret: credentials.signing_secret, installUrl });
+        },
+        renameApp: async (accessToken, { appId, description }) => {
+            const renamed = await call({ method: 'apps.manifest.update', form: { app_id: appId, manifest: JSON.stringify(manifestOf(description)) }, token: accessToken }, z.object({ ok: z.literal(true) }));
+            return renamed.isOk ? ok(undefined) : renamed;
+        },
+        removeApp: async (accessToken, appId) => {
+            const removed = await call({ method: 'apps.manifest.delete', form: { app_id: appId }, token: accessToken }, z.object({ ok: z.literal(true) }));
+            return removed.isOk ? ok(undefined) : removed;
+        },
+        completeInstall: async ({ clientId, clientSecret, code, redirectUrl }) => {
+            const installed = await call({ method: 'oauth.v2.access', form: { client_id: clientId, client_secret: clientSecret, code, redirect_uri: redirectUrl } }, installedSchema);
+            if (!installed.isOk) {
+                return installed;
+            }
+            const { app_id: appId, team, access_token: botToken, bot_user_id: botUserId } = installed.value;
+            return ok({ appId, teamId: team.id, teamName: team.name, botToken, botUserId });
+        },
+    };
+}
+//# sourceMappingURL=slack-tooling.js.map

package/dist/adapters/slack/slack-tooling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-tooling.js","sourceRoot":"","sources":["../../../src/adapters/slack/slack-tooling.ts"],"names":[],"mappings":"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"}