@crvouga/mockingbird-service-slack (英语)

本地模拟器。 真正的API合同. 部分 嘲笑鸟。 。 。 .

状态模拟器 偷懒 测试套件: 接通的webhooks, Web API 使用我们的应用程序 和 Socket 模式控制平面 Bolt 需要启动,带有 发件箱 联 合 国 一切的应用"同意"。 一个套房声称,一个警报响起 (单位:千美元)GET /__admin/outbox?webhook=… 或者说 ?channel=…没有真正的工作空间,并驱动 重试路径( 429 为) retry-after, 5xx)和终端设备(no_text, (中文(简体) ), no_service, (中文(简体) ), channel_not_found) 有命名预设.

• 行动范围: 支助
• Slack没有为这些方法发布维护的OpenAPI:合同(openapi.yaml)为 手写自Slack记录的线形 和我们的消费者.

安装

npm install -D @crvouga/mockingbird-service-slack

仅限无害环境管理。 节点 22或 Bun 1.2. 无土生属地. 给它服务 npx mockingbird-slack serve, (中文(简体) ), createServer 从 ./server (节点),或 createRuntime 与 任何获取服务器.

使用量

点数每 SLACK_*_WEBHOOK_URL (单位:千美元)SLACK_PIPELINE_ALERT_WEBHOOK_URL, (中文(简体) ), SLACK_ERX_ALERTS_WEBHOOK_URL, (中文(简体) ), SLACK_BILLING_ALERT_WEBHOOK_URL, (中文(简体) ), SLACK_CRITICAL_ALERT_WEBHOOK_URL, (中文(简体) ), RECONCILER_SLACK_WEBHOOK_URL,(...)时 http://127.0.0.1:8808/services/T000/B000/<anything>。任何路径都被接受,直到您注册 钩子. 网络 API 调用硬码 https://slack.com/api/…; 指向它们 http://127.0.0.1:8808/api/… (计: @slack/web-api, (中文(简体) ), slackApiUrl: "http://127.0.0.1:8808/api/") (中文(简体) ). 套接字模式中的 Bolt 使用相同 clientOptions.slackApiUrl (复制到 SocketModeReceiver加上一个 xapp- 应用标志. apps.connections.open 返回 a ws:// 網址 有关这一进程.

npx mockingbird-slack serve --port 8808

import { IncomingWebhook } from "@slack/webhook"
import { WebClient } from "@slack/web-api"
import { createServer } from "@crvouga/mockingbird-service-slack/server"

const server = await createServer()

// The app's own Slack clients. Only the URLs they are given change.
const webhook = new IncomingWebhook(`${server.url}/services/T000/B000/XXXX`)
await webhook.send({ text: "reconcile failed", blocks: [{ type: "divider" }] }) // { text: "ok" }
const slack = new WebClient("xoxb-fixture", { slackApiUrl: `${server.url}/api/` })
await slack.chat.postMessage({ channel: "#alerts", text: "deploy finished" }) // { ok: true, ts, … }

// Test controls. Make the next post fail the way Slack does under load; our clients retry at 0/2/8 s.
server.runtime.applyPreset("rate_limited", "default", { count: 1 })

const outbox = await fetch(`${server.url}/__admin/outbox?webhook=/services/T000/B000/XXXX`)
// { messages: [{ text: "reconcile failed", blocks: [...], ts: "1700000000.000001", thread_ts: null, … }] }
await server.close()

路线

Web API 机构可以是 JSON 或形式编码(结构为 JSON- 以形式字段编码), 如 Slack 接受两者;读取方法也采用查询参数。 认证是 Authorization: Bearer xox… (或 a 个) token 表单字段: 缺少 {} not_authed除了一个 xoxb-编号 :xoxp-编号 :xoxa- 符号(或 一个在外面 settings.tokens页:1 invalid_auth。逻辑错误为 HTTP 200 {ok: false, error}· ; a JSON员额无 charset 成功与斯莱克 missing_charset 警告 警告他们.

管理员(超过标准合同)

错误预设( E)POST /__admin/faults {"preset": "<name>", "count"?: n, "params"?: {...}}:

命名空间

x-mockingbird-namespace页:1 /__admin/ns/<name> 在 Webhook URL 或 API 基础上,或由 证书 : PUT /__admin/credentials {"credentials": {"xoxb-worker-a": "a", "T000/B000/XXXX": "b"}} 绘制一个bot 令牌或 webhook 的 T/B/X 用于命名空间的路径.

故意不模拟

• 入境事件 API和交互提供. 套接字模式的连接寿命周期是 模拟(apps.connections.open, (中文(简体) ), hello乒乓球 乒乓球, disconnect所以博尔特可以启动和 关闭; 模拟器不会在连接上推动事件 。 A 类 disconnect 信封没有 重新连接 URL, 匹配 Slack 的文件形状和 @slack/[email protected],哪个 电话 apps.connections.open 再来一次.
• 文件上传和下载 : files.info 答案种子元数据 files.slack.com URL( URL) 未送达.
• 实际按方法计算的费率限制等级:429次只来自 rate_limited 预设.
• 公布的会员规则not_in_channel, (中文(简体) ), chat:write.public 范围,以及 触发编号过期 views.open。 。 。 .
• 信件格式化( mrkdwn 解析、 链接解析、 提及解析): 文本和块是 储存的逐字记录.
• 块 Kit 的限制是 a 最好猜,不是甲骨文验证 (从每个区块的页面) docs.slack.dev; 每项规则的确切状态和消息Slack返回从未被观察到 现场直播). blocks 和每个 attachments[].blocks 以 invalid_blocks (网页: 400 invalid_blocks· ; chat.postMessage, (中文(简体) ), chat.update, (中文(简体) ), chat.postEphemeral数字 : 200 {ok: false, error: "invalid_blocks", response_metadata: {messages}},消息是模拟者自己的措辞) 当: 有超过50个块( 在每个阵列中; Slack 是否应用了 50 个内部附件 ) 未经证实) type 不是块 Kit 类型; a section text 超过3000 字符或该字符 fields 每个超过10件或2000个字符;a header text 没有 plain_text 或超过150个字符; context 超过10个 elements 或者说 actions 25岁以上;a block_id 超过 255 个字符;文本对象为空。 完全限值被接受 并且已逐字存储,被否决的消息则不保存任何信息(更新后留下原件) 然无所动. 必要领域规则(a) section 没有 text 也没有 fields,一个 image 无 alt_text),内部元素级验证 actions 编号 : context 编号 : input 编号 : rich_text, (中文(简体) ), 其它附件字段没有建模.

API 密码

部分 嘲笑鸟。 。 。 .