@tool-bridge/server 0.1.1 → 0.3.0

package/dist/telnyx-HHXD3CXL.js

@@ -0,0 +1,237 @@
+import {
+  createProviderPlugin,
+  guardedFetch,
+  requireApiKey,
+  upstreamError
+} from "./chunk-CSJEZHQO.js";
+import "./chunk-K7FVSFUX.js";
+import {
+  TBError,
+  external_exports
+} from "./chunk-JLTYA2B3.js";
+import "./chunk-MLKGABMK.js";
+
+// ../plugins/src/telnyx/api.ts
+var SERVICE = "telnyx";
+var API_BASE = "https://api.telnyx.com/v2";
+function toRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function text(value) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed === "" ? void 0 : trimmed;
+}
+function errorMessage(payload, response) {
+  if (typeof payload === "string" && payload.trim() !== "") return payload;
+  const record = toRecord(payload);
+  const errors = Array.isArray(record?.errors) ? record.errors : [];
+  const first = errors.map(toRecord).find(Boolean);
+  const message = first === void 0 ? text(record?.detail) ?? text(record?.message) ?? text(record?.error) ?? text(record?.title) : text(first.detail) ?? text(first.title) ?? text(first.code);
+  return message ?? (response.statusText || `Telnyx \u8FD4\u56DE HTTP ${response.status}`);
+}
+async function readPayload(response) {
+  const body = await response.text().catch(() => "");
+  if (body.trim() === "") return null;
+  try {
+    return JSON.parse(body);
+  } catch {
+    throw upstreamError(response.status === 429 ? 429 : 502, "Telnyx \u8FD4\u56DE\u4E86\u975E JSON \u54CD\u5E94");
+  }
+}
+async function send(url, init) {
+  try {
+    return await guardedFetch(url.toString(), init);
+  } catch (error) {
+    if (error instanceof TypeError) {
+      throw upstreamError(502, `telnyx request failed: ${error.message}`);
+    }
+    throw error;
+  }
+}
+async function request(ctx, path, input = {}) {
+  const url = new URL(`${API_BASE}${path}`);
+  for (const [name, value] of input.query ?? []) {
+    if (value === void 0 || value === null || value === "") continue;
+    url.searchParams.set(name, String(value));
+  }
+  const headers = {
+    accept: "application/json",
+    authorization: `Bearer ${requireApiKey(ctx, SERVICE)}`
+  };
+  if (input.body !== void 0) headers["content-type"] = "application/json";
+  const response = await send(url, {
+    method: input.method ?? "GET",
+    headers,
+    // JSON.stringify 自己会丢掉值为 undefined 的键,故不必复制上游的 removeUndefined;
+    // 但 null 必须留住 —— schema 允许 sendAt 显式传 null,那是要发给 Telnyx 的值。
+    ...input.body === void 0 ? {} : { body: JSON.stringify(input.body) }
+  });
+  const payload = await readPayload(response);
+  if (!response.ok) throw upstreamError(response.status, errorMessage(payload, response));
+  const record = toRecord(payload);
+  if (record === void 0) {
+    throw upstreamError(502, "Telnyx \u7684\u6210\u529F\u54CD\u5E94\u4E0D\u662F\u4E00\u4E2A\u5BF9\u8C61");
+  }
+  return record;
+}
+async function sendMessage(input, ctx) {
+  if (input.from === void 0 && input.messagingProfileId === void 0) {
+    throw new TBError("invalid_argument", "send_message \u9700\u8981 from \u6216 messagingProfileId");
+  }
+  if (input.type === "SMS" && input.text === void 0) {
+    throw new TBError("invalid_argument", "type \u4E3A SMS \u65F6\u9700\u8981 text");
+  }
+  if (input.type === "MMS" && input.mediaUrls === void 0) {
+    throw new TBError("invalid_argument", "type \u4E3A MMS \u65F6\u9700\u8981 mediaUrls");
+  }
+  if (input.type === void 0 && input.text === void 0 && input.mediaUrls === void 0) {
+    throw new TBError("invalid_argument", "send_message \u9700\u8981 text \u6216 mediaUrls");
+  }
+  return request(ctx, "/messages", {
+    method: "POST",
+    body: {
+      // 上游对每个字符串字段都过一遍 optionalString(即 trim)再发。这里只对自由文本
+      // 字段保留 trim —— 其余字段的 schema(uuid / url / datetime)要么本就不接受带空白的
+      // 值,要么 Zod 已经替我们 trim 过,再调一次是死代码。
+      // 这几个字段 schema 都要求 `\S`,故 trim 后不会变成空。
+      to: input.to.trim(),
+      from: input.from?.trim(),
+      messaging_profile_id: input.messagingProfileId,
+      text: input.text?.trim(),
+      subject: input.subject?.trim(),
+      media_urls: input.mediaUrls,
+      webhook_url: input.webhookUrl,
+      webhook_failover_url: input.webhookFailoverUrl,
+      use_profile_webhooks: input.useProfileWebhooks,
+      type: input.type,
+      auto_detect: input.autoDetect,
+      // null 与 undefined 在这里语义不同:null 是"清掉排期,立刻发",要原样发给 Telnyx;
+      // undefined 是没给,由 JSON.stringify 丢掉整个键。
+      send_at: input.sendAt,
+      encoding: input.encoding
+    }
+  });
+}
+async function retrieveMessage(input, ctx) {
+  return request(ctx, `/messages/${encodeURIComponent(input.id)}`);
+}
+async function listMessagingProfiles(input, ctx) {
+  return request(ctx, "/messaging_profiles", {
+    query: [
+      ["filter[name]", input.filterName],
+      ["filter[name][eq]", input.filterNameEq],
+      ["filter[name][contains]", input.filterNameContains],
+      ["page[number]", input.pageNumber],
+      ["page[size]", input.pageSize]
+    ]
+  });
+}
+async function retrieveMessagingProfile(input, ctx) {
+  return request(ctx, `/messaging_profiles/${encodeURIComponent(input.id)}`);
+}
+
+// ../plugins/src/telnyx/schema.ts
+var sendMessageInput = external_exports.strictObject({
+  to: external_exports.string().min(1).regex(new RegExp("\\S")).describe("The sending or receiving address, such as an E.164 phone number, alphanumeric sender ID, short code, or number pool."),
+  from: external_exports.string().min(1).regex(new RegExp("\\S")).describe("The sending or receiving address, such as an E.164 phone number, alphanumeric sender ID, short code, or number pool.").optional(),
+  messagingProfileId: external_exports.uuid().describe("The Telnyx messaging profile ID.").optional(),
+  text: external_exports.string().min(1).regex(new RegExp("\\S")).describe("The SMS message body.").optional(),
+  subject: external_exports.string().min(1).regex(new RegExp("\\S")).describe("The MMS message subject.").optional(),
+  mediaUrls: external_exports.array(external_exports.url().describe("One media URL for the MMS message.")).min(1).describe("The media URLs Telnyx should attach to an MMS message.").optional(),
+  webhookUrl: external_exports.url().describe("The URL where Telnyx should send message webhooks.").optional(),
+  webhookFailoverUrl: external_exports.url().describe("The failover URL Telnyx should use if the primary message webhook URL fails.").optional(),
+  useProfileWebhooks: external_exports.boolean().describe("Whether Telnyx should use webhooks configured on the messaging profile.").optional(),
+  type: external_exports.enum(["SMS", "MMS"]).describe("The protocol Telnyx should use for the message.").optional(),
+  autoDetect: external_exports.boolean().describe("Whether Telnyx should detect SMS messages that exceed a recommended part limit.").optional(),
+  sendAt: external_exports.iso.datetime({ offset: true }).describe("The ISO 8601 timestamp when Telnyx should send the message.").nullable().optional(),
+  encoding: external_exports.enum(["auto", "gsm7", "ucs2"]).describe("The encoding Telnyx should use for the message.").optional()
+}).describe("The input payload for sending a Telnyx message.");
+var sendMessageOutput = external_exports.strictObject({
+  data: external_exports.looseObject({
+    id: external_exports.uuid().describe("The Telnyx resource ID."),
+    record_type: external_exports.string().describe("The Telnyx resource type.")
+  }).describe("The Telnyx resource object returned by the API.")
+}).describe("The response returned when Telnyx sends a message.");
+var retrieveMessageInput = external_exports.strictObject({
+  id: external_exports.uuid().describe("The Telnyx message ID.")
+}).describe("The input payload for retrieving a Telnyx message.");
+var retrieveMessageOutput = external_exports.strictObject({
+  data: external_exports.looseObject({
+    id: external_exports.uuid().describe("The Telnyx resource ID."),
+    record_type: external_exports.string().describe("The Telnyx resource type.")
+  }).describe("The Telnyx resource object returned by the API.")
+}).describe("The response returned when retrieving a Telnyx message.");
+var listMessagingProfilesInput = external_exports.strictObject({
+  filterName: external_exports.string().min(1).regex(new RegExp("\\S")).describe("The profile name filter passed as filter[name].").optional(),
+  filterNameEq: external_exports.string().min(1).regex(new RegExp("\\S")).describe("The exact profile name filter.").optional(),
+  filterNameContains: external_exports.string().min(1).regex(new RegExp("\\S")).describe("The partial profile name filter.").optional(),
+  pageNumber: external_exports.int().min(1).describe("The Telnyx page number to load.").optional(),
+  pageSize: external_exports.int().min(1).max(250).describe("The number of Telnyx profiles to load per page.").optional()
+}).describe("The input payload for listing Telnyx messaging profiles.");
+var listMessagingProfilesOutput = external_exports.strictObject({
+  data: external_exports.array(external_exports.looseObject({
+    id: external_exports.uuid().describe("The Telnyx resource ID."),
+    record_type: external_exports.string().describe("The Telnyx resource type.")
+  }).describe("The Telnyx resource object returned by the API.")).describe("The Telnyx messaging profiles returned by the API."),
+  meta: external_exports.looseObject({
+    page_number: external_exports.int().describe("The current Telnyx page number.").optional(),
+    page_size: external_exports.int().describe("The current Telnyx page size.").optional(),
+    total_pages: external_exports.int().describe("The total number of pages available from Telnyx.").optional(),
+    total_results: external_exports.int().describe("The total number of matching Telnyx resources.").optional()
+  }).describe("The pagination metadata returned by Telnyx.")
+}).describe("The response returned when listing Telnyx messaging profiles.");
+var retrieveMessagingProfileInput = external_exports.strictObject({
+  id: external_exports.uuid().describe("The Telnyx messaging profile ID.")
+}).describe("The input payload for retrieving a Telnyx messaging profile.");
+var retrieveMessagingProfileOutput = external_exports.strictObject({
+  data: external_exports.looseObject({
+    id: external_exports.uuid().describe("The Telnyx resource ID."),
+    record_type: external_exports.string().describe("The Telnyx resource type.")
+  }).describe("The Telnyx resource object returned by the API.")
+}).describe("The response returned when retrieving a Telnyx messaging profile.");
+var telnyxActions = {
+  send_message: {
+    description: "Send an SMS or MMS message through Telnyx Messaging.",
+    effect: "write",
+    inputSchema: sendMessageInput,
+    outputSchema: external_exports.toJSONSchema(sendMessageOutput, { io: "output", unrepresentable: "any" })
+  },
+  retrieve_message: {
+    description: "Retrieve a Telnyx message by ID.",
+    effect: "read",
+    inputSchema: retrieveMessageInput,
+    outputSchema: external_exports.toJSONSchema(retrieveMessageOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_messaging_profiles: {
+    description: "List Telnyx messaging profiles with optional name filters and pagination.",
+    effect: "read",
+    inputSchema: listMessagingProfilesInput,
+    outputSchema: external_exports.toJSONSchema(listMessagingProfilesOutput, { io: "output", unrepresentable: "any" })
+  },
+  retrieve_messaging_profile: {
+    description: "Retrieve a Telnyx messaging profile by ID.",
+    effect: "read",
+    inputSchema: retrieveMessagingProfileInput,
+    outputSchema: external_exports.toJSONSchema(retrieveMessagingProfileOutput, { io: "output", unrepresentable: "any" })
+  }
+};
+
+// ../plugins/src/telnyx/index.ts
+function createTelnyxPlugin() {
+  return createProviderPlugin({
+    description: "Telnyx",
+    actions: telnyxActions,
+    handlers: {
+      send_message: sendMessage,
+      retrieve_message: retrieveMessage,
+      list_messaging_profiles: listMessagingProfiles,
+      retrieve_messaging_profile: retrieveMessagingProfile
+    }
+  });
+}
+var telnyx_default = createTelnyxPlugin();
+export {
+  createTelnyxPlugin,
+  telnyx_default as default
+};