@tool-bridge/server 0.1.0 → 0.3.0

package/dist/mattermost-C5SQ7PGD.js

@@ -0,0 +1,320 @@
+import {
+  assertPublicHttpUrl,
+  createProviderPlugin,
+  guardedFetch,
+  requireCredential,
+  upstreamError
+} from "./chunk-CSJEZHQO.js";
+import "./chunk-K7FVSFUX.js";
+import {
+  TBError,
+  external_exports
+} from "./chunk-JLTYA2B3.js";
+import "./chunk-MLKGABMK.js";
+
+// ../plugins/src/mattermost/api.ts
+var SERVICE = "mattermost";
+var API_PATH_PREFIX = "/api/v4";
+var REQUEST_TIMEOUT_MS = 3e4;
+var SINCE_CONFLICTING_FIELDS = ["page", "perPage", "beforePostId", "afterPostId"];
+function text(value) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed === "" ? void 0 : trimmed;
+}
+function record(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function invalidResponse(message) {
+  return new TBError("unavailable", message, { retryable: true });
+}
+function requireRecord(value, label) {
+  const result = record(value);
+  if (result === void 0) throw invalidResponse(`${label}\u4E0D\u662F\u5BF9\u8C61`);
+  return result;
+}
+function requireRecordArray(value, label) {
+  if (!Array.isArray(value)) throw invalidResponse(`${label}\u4E0D\u662F\u6570\u7EC4`);
+  return value.map((item, index) => requireRecord(item, `${label} \u7684\u7B2C ${index} \u9879`));
+}
+function requireText(value, field) {
+  const result = text(value);
+  if (result === void 0) throw new TBError("invalid_argument", `${field} \u662F\u5FC5\u586B\u7684`);
+  return result;
+}
+function pathSegment(value, field) {
+  const segment = requireText(value, field);
+  if (segment.includes("/") || segment.includes("?") || segment.includes("#")) {
+    throw new TBError("invalid_argument", `${field} \u5FC5\u987B\u662F\u5355\u4E2A Mattermost \u8DEF\u5F84\u6BB5`);
+  }
+  return encodeURIComponent(segment);
+}
+function apiBaseUrl(ctx) {
+  const raw = requireCredential(ctx, SERVICE, "instanceUrl");
+  const url = assertPublicHttpUrl(raw.includes("://") ? raw : `https://${raw}`);
+  if (url.protocol !== "https:") {
+    throw new TBError("invalid_argument", "instanceUrl \u5FC5\u987B\u7528 https");
+  }
+  if (url.username !== "" || url.password !== "") {
+    throw new TBError("invalid_argument", "instanceUrl \u4E0D\u80FD\u5185\u5D4C\u7528\u6237\u540D\u6216\u5BC6\u7801");
+  }
+  url.search = "";
+  url.hash = "";
+  const path = (url.pathname === "/" ? "" : url.pathname).replace(/\/+$/, "");
+  url.pathname = path.endsWith(API_PATH_PREFIX) ? path.slice(0, -API_PATH_PREFIX.length) : path;
+  return `${url.toString().replace(/\/$/, "")}${API_PATH_PREFIX}`;
+}
+async function readPayload(response) {
+  const body = await response.text();
+  if (body === "") return null;
+  try {
+    return JSON.parse(body);
+  } catch {
+    if (response.ok) throw invalidResponse("Mattermost \u8FD4\u56DE\u4E86\u975E JSON \u54CD\u5E94");
+    return { message: body };
+  }
+}
+function errorMessage(payload, status) {
+  const body = record(payload);
+  return text(body?.message) ?? text(body?.error) ?? text(body?.details) ?? text(body?.id) ?? `Mattermost \u8FD4\u56DE HTTP ${status}`;
+}
+async function request(ctx, input) {
+  const url = new URL(`${apiBaseUrl(ctx)}${input.path}`);
+  for (const [key, value] of Object.entries(input.query ?? {})) {
+    if (value !== void 0) url.searchParams.set(key, String(value));
+  }
+  const headers = {
+    accept: "application/json",
+    authorization: `Bearer ${requireCredential(ctx, SERVICE, "apiKey")}`
+  };
+  if (input.body !== void 0) headers["content-type"] = "application/json";
+  let response;
+  try {
+    response = await guardedFetch(url.toString(), {
+      method: input.method ?? "GET",
+      headers,
+      body: input.body === void 0 ? void 0 : JSON.stringify(input.body),
+      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
+    });
+  } catch (error) {
+    if (error instanceof TBError) throw error;
+    if (error instanceof Error && error.name === "TimeoutError") {
+      throw upstreamError(504, `Mattermost \u8BF7\u6C42\u8D85\u65F6(${REQUEST_TIMEOUT_MS / 1e3} \u79D2)`);
+    }
+    const message = error instanceof Error ? error.message : "unknown network error";
+    throw upstreamError(502, `Mattermost \u8BF7\u6C42\u5931\u8D25:${message}`);
+  }
+  const payload = await readPayload(response);
+  if (!response.ok) throw upstreamError(response.status, errorMessage(payload, response.status));
+  return payload;
+}
+async function getCurrentUser(_input, ctx) {
+  const payload = await request(ctx, { path: "/users/me" });
+  return { user: requireRecord(payload, "Mattermost \u7528\u6237"), raw: payload };
+}
+async function listUserTeams(_input, ctx) {
+  const payload = await request(ctx, { path: "/users/me/teams" });
+  return { teams: requireRecordArray(payload, "Mattermost \u56E2\u961F\u5217\u8868"), raw: payload };
+}
+async function getTeam(input, ctx) {
+  const payload = await request(ctx, { path: `/teams/${pathSegment(input.teamId, "teamId")}` });
+  return { team: requireRecord(payload, "Mattermost \u56E2\u961F"), raw: payload };
+}
+async function listTeamChannels(input, ctx) {
+  const payload = await request(ctx, {
+    path: `/teams/${pathSegment(input.teamId, "teamId")}/channels`,
+    query: { page: input.page, per_page: input.perPage }
+  });
+  return { channels: requireRecordArray(payload, "Mattermost \u9891\u9053\u5217\u8868"), raw: payload };
+}
+async function getChannel(input, ctx) {
+  const payload = await request(ctx, { path: `/channels/${pathSegment(input.channelId, "channelId")}` });
+  return { channel: requireRecord(payload, "Mattermost \u9891\u9053"), raw: payload };
+}
+function normalizePostList(payload) {
+  const raw = requireRecord(payload, "Mattermost \u5E16\u5B50\u5217\u8868");
+  const order = Array.isArray(raw.order) ? raw.order.filter((item) => typeof item === "string") : [];
+  const postsById = record(raw.posts);
+  const posts = postsById !== void 0 && order.length > 0 ? order.map((id) => record(postsById[id]) ?? { id }) : Object.values(postsById ?? {}).map((item) => record(item) ?? { value: item });
+  return { posts, order, raw };
+}
+async function listChannelPosts(input, ctx) {
+  if (input.since !== void 0) {
+    const conflicting = SINCE_CONFLICTING_FIELDS.filter((field) => input[field] !== void 0);
+    if (conflicting.length > 0) {
+      throw new TBError(
+        "invalid_argument",
+        `since \u4E0D\u80FD\u4E0E ${SINCE_CONFLICTING_FIELDS.join(" / ")} \u540C\u65F6\u4F7F\u7528(\u672C\u6B21\u7ED9\u4E86 ${conflicting.join(" / ")})`
+      );
+    }
+  }
+  const payload = await request(ctx, {
+    path: `/channels/${pathSegment(input.channelId, "channelId")}/posts`,
+    // 见文件头第 1 条:这四个参数在 wire 上是另一套名字。
+    query: {
+      page: input.page,
+      per_page: input.perPage,
+      since: input.since,
+      before: text(input.beforePostId),
+      after: text(input.afterPostId)
+    }
+  });
+  return normalizePostList(payload);
+}
+async function createPost(input, ctx) {
+  const rootId = text(input.rootId);
+  const props = record(input.props);
+  const payload = await request(ctx, {
+    path: "/posts",
+    method: "POST",
+    body: {
+      channel_id: requireText(input.channelId, "channelId"),
+      message: requireText(input.message, "message"),
+      // 缺省时整个键不发(上游 `compactObject`):发 `null` 会被 Mattermost 当成非法入参。
+      ...rootId === void 0 ? {} : { root_id: rootId },
+      ...props === void 0 ? {} : { props }
+    }
+  });
+  return { post: requireRecord(payload, "Mattermost \u5E16\u5B50"), raw: payload };
+}
+
+// ../plugins/src/mattermost/schema.ts
+var getCurrentUserInput = external_exports.strictObject({}).describe("No input parameters are required.");
+var getCurrentUserOutput = external_exports.strictObject({
+  user: external_exports.looseObject({}).describe("A Mattermost API entity object.").optional(),
+  raw: external_exports.unknown().describe("The raw Mattermost API JSON response.").optional()
+}).describe("Output payload for the current Mattermost user.");
+var listUserTeamsInput = external_exports.strictObject({}).describe("No input parameters are required.");
+var listUserTeamsOutput = external_exports.strictObject({
+  teams: external_exports.array(external_exports.looseObject({}).describe("A Mattermost API entity object.")).describe("Mattermost teams returned by the API.").optional(),
+  raw: external_exports.unknown().describe("The raw Mattermost API JSON response.").optional()
+}).describe("Output payload for Mattermost teams.");
+var getTeamInput = external_exports.strictObject({
+  teamId: external_exports.string().min(1).describe("A Mattermost object ID.").optional()
+}).describe("Input parameters for retrieving one Mattermost team.");
+var getTeamOutput = external_exports.strictObject({
+  team: external_exports.looseObject({}).describe("A Mattermost API entity object.").optional(),
+  raw: external_exports.unknown().describe("The raw Mattermost API JSON response.").optional()
+}).describe("Output payload for one Mattermost team.");
+var listTeamChannelsInput = external_exports.strictObject({
+  teamId: external_exports.string().min(1).describe("A Mattermost object ID."),
+  page: external_exports.int().min(0).describe("The zero-based page number to request.").optional(),
+  perPage: external_exports.int().min(1).describe("The number of records to request per page.").optional()
+}).describe("Query parameters for listing Mattermost channels in a team.");
+var listTeamChannelsOutput = external_exports.strictObject({
+  channels: external_exports.array(external_exports.looseObject({}).describe("A Mattermost API entity object.")).describe("Mattermost channels returned by the API.").optional(),
+  raw: external_exports.unknown().describe("The raw Mattermost API JSON response.").optional()
+}).describe("Output payload for Mattermost channels.");
+var getChannelInput = external_exports.strictObject({
+  channelId: external_exports.string().min(1).describe("A Mattermost object ID.").optional()
+}).describe("Input parameters for retrieving one Mattermost channel.");
+var getChannelOutput = external_exports.strictObject({
+  channel: external_exports.looseObject({}).describe("A Mattermost API entity object.").optional(),
+  raw: external_exports.unknown().describe("The raw Mattermost API JSON response.").optional()
+}).describe("Output payload for one Mattermost channel.");
+var listChannelPostsInput = external_exports.strictObject({
+  channelId: external_exports.string().min(1).describe("A Mattermost object ID."),
+  page: external_exports.int().min(0).describe("The zero-based page number to request.").optional(),
+  perPage: external_exports.int().min(1).describe("The number of records to request per page.").optional(),
+  since: external_exports.int().min(0).describe("Only return posts created after this Unix timestamp in milliseconds.").optional(),
+  beforePostId: external_exports.string().min(1).describe("Return posts before this Mattermost post ID.").optional(),
+  afterPostId: external_exports.string().min(1).describe("Return posts after this Mattermost post ID.").optional()
+}).describe("Query parameters for listing posts in a Mattermost channel. since cannot be used with page, perPage, beforePostId, or afterPostId.");
+var listChannelPostsOutput = external_exports.strictObject({
+  posts: external_exports.array(external_exports.looseObject({}).describe("A Mattermost post object.")).describe("Mattermost posts returned by the API in response order.").optional(),
+  order: external_exports.array(external_exports.string().min(1).describe("A Mattermost object ID.")).describe("Mattermost post IDs in response order.").optional(),
+  raw: external_exports.unknown().describe("The raw Mattermost API JSON response.").optional()
+}).describe("Output payload for Mattermost channel posts.");
+var createPostInput = external_exports.strictObject({
+  channelId: external_exports.string().min(1).describe("A Mattermost object ID."),
+  message: external_exports.string().min(1).describe("The Markdown message body to post."),
+  rootId: external_exports.string().min(1).describe("Optional root post ID for replying in a thread.").optional(),
+  props: external_exports.looseObject({}).describe("Optional Mattermost post props object.").optional()
+}).describe("Input parameters for creating a Mattermost channel post.");
+var createPostOutput = external_exports.strictObject({
+  post: external_exports.looseObject({}).describe("A Mattermost post object.").optional(),
+  raw: external_exports.unknown().describe("The raw Mattermost API JSON response.").optional()
+}).describe("Output payload for a created Mattermost post.");
+var mattermostActions = {
+  get_current_user: {
+    description: "Get the Mattermost user associated with the Personal Access Token.",
+    effect: "read",
+    inputSchema: getCurrentUserInput,
+    outputSchema: external_exports.toJSONSchema(getCurrentUserOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_user_teams: {
+    description: "List Mattermost teams visible to the current user.",
+    effect: "read",
+    inputSchema: listUserTeamsInput,
+    outputSchema: external_exports.toJSONSchema(listUserTeamsOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_team: {
+    description: "Retrieve one Mattermost team by ID.",
+    effect: "read",
+    inputSchema: getTeamInput,
+    outputSchema: external_exports.toJSONSchema(getTeamOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_team_channels: {
+    description: "List public Mattermost channels in a team.",
+    effect: "read",
+    inputSchema: listTeamChannelsInput,
+    outputSchema: external_exports.toJSONSchema(listTeamChannelsOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_channel: {
+    description: "Retrieve one Mattermost channel by ID.",
+    effect: "read",
+    inputSchema: getChannelInput,
+    outputSchema: external_exports.toJSONSchema(getChannelOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_channel_posts: {
+    description: "List Mattermost posts in a channel.",
+    effect: "read",
+    inputSchema: listChannelPostsInput,
+    outputSchema: external_exports.toJSONSchema(listChannelPostsOutput, { io: "output", unrepresentable: "any" })
+  },
+  create_post: {
+    description: "Create a Mattermost post in a channel.",
+    effect: "write",
+    inputSchema: createPostInput,
+    outputSchema: external_exports.toJSONSchema(createPostOutput, { io: "output", unrepresentable: "any" })
+  }
+};
+
+// ../plugins/src/mattermost/index.ts
+function createMattermostPlugin() {
+  return createProviderPlugin({
+    description: "Mattermost",
+    credentialFields: [
+      {
+        key: "apiKey",
+        label: "Personal access token",
+        required: true,
+        secret: true,
+        description: "Mattermost \u4E2A\u4EBA\u8BBF\u95EE\u4EE4\u724C,\u4EE5 Bearer \u53D1\u9001;\u5728\u8D26\u53F7\u8BBE\u7F6E\u7684 Security \u2192 Personal Access Tokens \u91CC\u521B\u5EFA"
+      },
+      {
+        key: "instanceUrl",
+        label: "Instance URL",
+        required: true,
+        secret: false,
+        description: "Mattermost \u5B9E\u4F8B\u7684\u6839\u5730\u5740(https://mattermost.example.com,\u5E26 /api/v4 \u540E\u7F00\u4E5F\u80FD\u8BC6\u522B);\u5FC5\u987B\u662F https \u7684\u516C\u7F51\u53EF\u8FBE\u5730\u5740,\u79C1\u6709\u7F51\u6BB5\u4F1A\u88AB\u51FA\u7AD9\u7B56\u7565\u62E6\u4E0B"
+      }
+    ],
+    credentialProbe: "get_current_user",
+    actions: mattermostActions,
+    handlers: {
+      get_current_user: getCurrentUser,
+      list_user_teams: listUserTeams,
+      get_team: getTeam,
+      list_team_channels: listTeamChannels,
+      get_channel: getChannel,
+      list_channel_posts: listChannelPosts,
+      create_post: createPost
+    }
+  });
+}
+var mattermost_default = createMattermostPlugin();
+export {
+  createMattermostPlugin,
+  mattermost_default as default
+};