@ascegu/teamily 1.0.4 → 1.0.6

package/src/send.ts

@@ -0,0 +1,273 @@
+import type { ResolvedTeamilyAccount, TeamilyMessageTarget } from "./types.js";
+import { CONTENT_TYPES, SESSION_TYPES } from "./types.js";
+import { generateOperationID } from "./probe.js";
+
+export interface SendTeamilyMessageParams {
+  account: ResolvedTeamilyAccount;
+  target: TeamilyMessageTarget;
+  text: string;
+  replyToId?: string;
+  fetchImpl?: typeof fetch;
+}
+
+export interface SendTeamilyMediaParams {
+  account: ResolvedTeamilyAccount;
+  target: TeamilyMessageTarget;
+  mediaUrl: string;
+  mediaType: "image" | "video" | "audio" | "file";
+  caption?: string;
+  fetchImpl?: typeof fetch;
+}
+
+export interface TeamilySendResult {
+  success: boolean;
+  messageId?: string;
+  serverMsgID?: string;
+  clientMsgID?: string;
+  error?: string;
+}
+
+/**
+ * Send a text message via Teamily REST API.
+ *
+ * @param params - Send parameters
+ * @returns Send result with message ID or error
+ */
+export async function sendMessageTeamily(
+  params: SendTeamilyMessageParams
+): Promise<TeamilySendResult> {
+  const { account, target, text, replyToId, fetchImpl = fetch } = params;
+
+  const url = `${account.apiURL}/msg/send_msg`;
+
+  const payload = buildSendMessagePayload({
+    sendID: account.userID,
+    target,
+    content: { content: text },
+    contentType: CONTENT_TYPES.TEXT,
+    replyToId,
+  });
+
+  try {
+    const response = await fetchImpl(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "operationID": generateOperationID(),
+        "token": account.token,
+      },
+      body: JSON.stringify(payload),
+    });
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      return {
+        success: false,
+        error: `HTTP ${response.status}: ${errorText}`,
+      };
+    }
+
+    const data = await response.json() as {
+      errCode: number;
+      errMsg: string;
+      data?: {
+        serverMsgID: string;
+        clientMsgID: string;
+        sendTime: number;
+      };
+    };
+
+    if (data.errCode !== 0) {
+      return {
+        success: false,
+        error: data.errMsg || "Send failed",
+      };
+    }
+
+    return {
+      success: true,
+      messageId: data.data?.serverMsgID,
+      serverMsgID: data.data?.serverMsgID,
+      clientMsgID: data.data?.clientMsgID,
+    };
+  } catch (error) {
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : String(error),
+    };
+  }
+}
+
+/**
+ * Send a media message via Teamily REST API.
+ *
+ * @param params - Send parameters
+ * @returns Send result with message ID or error
+ */
+export async function sendMediaTeamily(
+  params: SendTeamilyMediaParams
+): Promise<TeamilySendResult> {
+  const { account, target, mediaUrl, mediaType, caption, fetchImpl = fetch } = params;
+
+  const url = `${account.apiURL}/msg/send_msg`;
+
+  let content: Record<string, unknown>;
+  let contentType: number;
+
+  switch (mediaType) {
+    case "image":
+      contentType = CONTENT_TYPES.PICTURE;
+      content = {
+        sourcePicture: {
+          uuid: generateOperationID(),
+          type: "public",
+          width: 0,
+          height: 0,
+          url: mediaUrl,
+        },
+      };
+      break;
+
+    case "video":
+      contentType = CONTENT_TYPES.VIDEO;
+      content = {
+        videoPath: mediaUrl,
+        videoUUID: generateOperationID(),
+        videoUrl: mediaUrl,
+        videoType: "mp4",
+        videoSize: 0,
+        duration: 0,
+        snapshotUUID: `${generateOperationID()}_snap`,
+        snapshotUrl: "",
+        snapshotSize: 0,
+        snapshotWidth: 0,
+        snapshotHeight: 0,
+      };
+      break;
+
+    case "audio":
+      contentType = CONTENT_TYPES.VOICE;
+      content = {
+        uuid: generateOperationID(),
+        soundPath: mediaUrl,
+        sourceUrl: mediaUrl,
+        dataSize: 0,
+        duration: 0,
+        soundType: "mp3",
+      };
+      break;
+
+    case "file":
+      contentType = CONTENT_TYPES.FILE;
+      content = {
+        uuid: generateOperationID(),
+        fileName: mediaUrl.split("/").pop() || "file",
+        fileSize: 0,
+        sourceUrl: mediaUrl,
+        fileType: "application/octet-stream",
+      };
+      break;
+
+    default:
+      return {
+        success: false,
+        error: `Unsupported media type: ${mediaType}`,
+      };
+  }
+
+  // Add caption to text content for media messages
+  if (caption) {
+    content.text = caption;
+  }
+
+  const payload = buildSendMessagePayload({
+    sendID: account.userID,
+    target,
+    content,
+    contentType,
+  });
+
+  try {
+    const response = await fetchImpl(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "operationID": generateOperationID(),
+        "token": account.token,
+      },
+      body: JSON.stringify(payload),
+    });
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      return {
+        success: false,
+        error: `HTTP ${response.status}: ${errorText}`,
+      };
+    }
+
+    const data = await response.json() as {
+      errCode: number;
+      errMsg: string;
+      data?: {
+        serverMsgID: string;
+        clientMsgID: string;
+        sendTime: number;
+      };
+    };
+
+    if (data.errCode !== 0) {
+      return {
+        success: false,
+        error: data.errMsg || "Send failed",
+      };
+    }
+
+    return {
+      success: true,
+      messageId: data.data?.serverMsgID,
+      serverMsgID: data.data?.serverMsgID,
+      clientMsgID: data.data?.clientMsgID,
+    };
+  } catch (error) {
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : String(error),
+    };
+  }
+}
+
+/**
+ * Build the send message payload for Teamily API.
+ */
+function buildSendMessagePayload(params: {
+  sendID: string;
+  target: TeamilyMessageTarget;
+  content: Record<string, unknown>;
+  contentType: number;
+  replyToId?: string;
+}): Record<string, unknown> {
+  const { sendID, target, content, contentType, replyToId } = params;
+
+  const payload: Record<string, unknown> = {
+    sendID,
+    recvID: target.type === "user" ? target.id : "",
+    groupID: target.type === "group" ? target.id : "",
+    content,
+    contentType,
+    sessionType: target.type === "group" ? SESSION_TYPES.GROUP : SESSION_TYPES.SINGLE,
+    isOnlineOnly: false,
+  };
+
+  if (replyToId) {
+    payload.quote = {
+      text: "",
+      content: {},
+      isReact: false,
+      userID: "",
+      msgID: replyToId,
+    };
+  }
+
+  return payload;
+}

package/src/types.ts

@@ -0,0 +1,116 @@
+// Core configuration types for Teamily channel
+
+export interface TeamilyServerConfig {
+  platformUrl: string;
+  apiURL: string;
+  wsURL: string;
+}
+
+export interface TeamilyUserAccount {
+  userID: string;
+  token: string;
+  nickname?: string;
+  faceURL?: string;
+}
+
+export interface TeamilyConfig {
+  enabled: boolean;
+  server: TeamilyServerConfig;
+  accounts: Record<string, TeamilyUserAccount>;
+}
+
+export interface ResolvedTeamilyAccount {
+  accountId: string;
+  enabled: boolean;
+  platformUrl: string;
+  apiURL: string;
+  wsURL: string;
+  userID: string;
+  token: string;
+  nickname?: string;
+  faceURL?: string;
+}
+
+export interface TeamilyMessageTarget {
+  type: "user" | "group";
+  id: string;
+}
+
+export interface TeamilyMessage {
+  serverMsgID: string;
+  sendID: string;
+  recvID: string;
+  content: {
+    text?: string;
+    picture?: TeamilyPictureContent;
+    video?: TeamilyVideoContent;
+    audio?: TeamilyAudioContent;
+  };
+  contentType: number;
+  sessionType: number;
+  sendTime: number;
+}
+
+export interface TeamilyPictureContent {
+  sourcePicture: {
+    uuid: string;
+    type: string;
+    width: number;
+    height: number;
+    url: string;
+  };
+}
+
+export interface TeamilyVideoContent {
+  videoPath: string;
+  videoUUID: string;
+  videoUrl: string;
+  videoType: string;
+  videoSize: number;
+  duration: number;
+  snapshotUUID: string;
+  snapshotUrl: string;
+  snapshotSize: number;
+  snapshotWidth: number;
+  snapshotHeight: number;
+}
+
+export interface TeamilyAudioContent {
+  uuid: string;
+  soundPath: string;
+  sourceUrl: string;
+  dataSize: number;
+  duration: number;
+  soundType: string;
+}
+
+export type TeamilyProbeResult = {
+  connected: boolean;
+  error?: string;
+  userExists?: boolean;
+};
+
+// Content type constants
+export const CONTENT_TYPES = {
+  TEXT: 101,
+  PICTURE: 102,
+  VOICE: 103,
+  VIDEO: 104,
+  FILE: 105,
+  AT_TEXT: 106,
+  MERGER: 107,
+  CARD: 108,
+  LOCATION: 109,
+  CUSTOM: 110,
+  TYPING: 113,
+  QUOTE: 114,
+  FACE: 115,
+  ADVANCED_TEXT: 117,
+} as const;
+
+// Session type constants
+export const SESSION_TYPES = {
+  SINGLE: 1,
+  GROUP: 3,
+  NOTIFICATION: 4,
+} as const;