@shenhh/popo-native 0.1.0

package/src/team.ts

@@ -0,0 +1,460 @@
+import type { ClawdbotConfig } from "openclaw/plugin-sdk";
+import type { PopoNativeConfig } from "./types.js";
+import { popoNativeRequest } from "./client.js";
+
+// ==================== Team (Group) APIs ====================
+
+export type CreateTeamParams = {
+  cfg: ClawdbotConfig;
+  uid: string; // Group owner email
+  name?: string;
+  uidList: string[]; // Member emails
+  photoUrl?: string;
+};
+
+export type CreateTeamResult = {
+  success: boolean;
+  tid?: string;
+  passNum?: number;
+  failList?: Record<string, string>;
+  error?: string;
+};
+
+/**
+ * Create a new team (group) in POPO using Native API.
+ * POST /open-apis/team/v1/create-team?uid={uid}
+ */
+export async function createTeam(params: CreateTeamParams): Promise<CreateTeamResult> {
+  const { cfg, uid, name, uidList, photoUrl } = params;
+  const popoCfg = cfg.channels?.["popo-native"] as PopoNativeConfig | undefined;
+  if (!popoCfg) {
+    throw new Error("POPO Native channel not configured");
+  }
+
+  const body: Record<string, unknown> = { uidList };
+  if (name) body.name = name;
+  if (photoUrl) body.photoUrl = photoUrl;
+
+  const response = await popoNativeRequest<{
+    tid?: string;
+    passNum?: number;
+    failList?: Record<string, string>;
+  }>({
+    cfg: popoCfg,
+    method: "POST",
+    path: "/open-apis/team/v1/create-team",
+    query: { uid },
+    body,
+  });
+
+  if (response.errcode !== 0) {
+    return {
+      success: false,
+      error: response.errmsg || `errcode ${response.errcode}`,
+    };
+  }
+
+  return {
+    success: true,
+    tid: response.data?.tid,
+    passNum: response.data?.passNum,
+    failList: response.data?.failList,
+  };
+}
+
+export type InviteToTeamParams = {
+  cfg: ClawdbotConfig;
+  uid: string; // Operator email
+  tid: string;
+  inviteList: string[];
+  type?: "1" | "2"; // 1=normal user (default), 2=robot
+  text?: string; // Application reason
+};
+
+export type InviteToTeamResult = {
+  success: boolean;
+  type?: number; // 0=joined directly, 1=application
+  failList?: Record<string, string>;
+  error?: string;
+};
+
+/**
+ * Invite users or robots to join a team.
+ * POST /open-apis/team/v1/team-set/invite
+ */
+export async function inviteToTeam(params: InviteToTeamParams): Promise<InviteToTeamResult> {
+  const { cfg, uid, tid, inviteList, type = "1", text } = params;
+  const popoCfg = cfg.channels?.["popo-native"] as PopoNativeConfig | undefined;
+  if (!popoCfg) {
+    throw new Error("POPO Native channel not configured");
+  }
+
+  const body: Record<string, unknown> = { uid, tid, inviteList, type };
+  if (text) body.text = text;
+
+  const response = await popoNativeRequest<{
+    type?: number;
+    failList?: Record<string, string>;
+  }>({
+    cfg: popoCfg,
+    method: "POST",
+    path: "/open-apis/team/v1/team-set/invite",
+    body,
+  });
+
+  if (response.errcode !== 0) {
+    return {
+      success: false,
+      error: response.errmsg || `errcode ${response.errcode}`,
+    };
+  }
+
+  return {
+    success: true,
+    type: response.data?.type,
+    failList: response.data?.failList,
+  };
+}
+
+export type DropTeamParams = {
+  cfg: ClawdbotConfig;
+  uid: string; // Operator email
+  tid: string;
+};
+
+export type DropTeamResult = {
+  success: boolean;
+  error?: string;
+};
+
+/**
+ * Disband (delete) a team.
+ * POST /open-apis/team/v1/team-set/drop
+ */
+export async function dropTeam(params: DropTeamParams): Promise<DropTeamResult> {
+  const { cfg, uid, tid } = params;
+  const popoCfg = cfg.channels?.["popo-native"] as PopoNativeConfig | undefined;
+  if (!popoCfg) {
+    throw new Error("POPO Native channel not configured");
+  }
+
+  const response = await popoNativeRequest<unknown>({
+    cfg: popoCfg,
+    method: "POST",
+    path: "/open-apis/team/v1/team-set/drop",
+    body: { uid, tid },
+  });
+
+  if (response.errcode !== 0) {
+    return {
+      success: false,
+      error: response.errmsg || `errcode ${response.errcode}`,
+    };
+  }
+
+  return { success: true };
+}
+
+export type TeamMember = {
+  uid: string;
+  name: string;
+  nickName?: string;
+  teamNickName?: string;
+};
+
+export type GetTeamMembersParams = {
+  cfg: ClawdbotConfig;
+  uid: string; // Operator email
+  tid: string;
+  page?: number;
+  limit?: number;
+};
+
+export type GetTeamMembersResult = {
+  success: boolean;
+  records?: TeamMember[];
+  total?: number;
+  page?: number;
+  limit?: number;
+  error?: string;
+};
+
+/**
+ * Get member list of a team.
+ * GET /open-apis/team/v1/team-members?tid={tid}&uid={uid}
+ */
+export async function getTeamMembers(params: GetTeamMembersParams): Promise<GetTeamMembersResult> {
+  const { cfg, uid, tid, page = 1, limit = 20 } = params;
+  const popoCfg = cfg.channels?.["popo-native"] as PopoNativeConfig | undefined;
+  if (!popoCfg) {
+    throw new Error("POPO Native channel not configured");
+  }
+
+  const response = await popoNativeRequest<{
+    records?: TeamMember[];
+    total?: number;
+    page?: number;
+    limit?: number;
+  }>({
+    cfg: popoCfg,
+    method: "GET",
+    path: "/open-apis/team/v1/team-members",
+    query: { tid, uid, page: String(page), limit: String(limit) },
+  });
+
+  if (response.errcode !== 0) {
+    return {
+      success: false,
+      error: response.errmsg || `errcode ${response.errcode}`,
+    };
+  }
+
+  return {
+    success: true,
+    records: response.data?.records,
+    total: response.data?.total,
+    page: response.data?.page,
+    limit: response.data?.limit,
+  };
+}
+
+export type TeamInfo = {
+  name: string;
+  desc?: string;
+  board?: string;
+};
+
+export type GetTeamInfoParams = {
+  cfg: ClawdbotConfig;
+  uid: string; // Operator email
+  tid: string;
+  scopes?: string[]; // e.g., ["board"] to get announcement
+};
+
+export type GetTeamInfoResult = {
+  success: boolean;
+  info?: TeamInfo;
+  error?: string;
+};
+
+/**
+ * Get basic information of a team.
+ * GET /open-apis/team/v1/team-info?tid={tid}&uid={uid}&scopes={scopes}
+ */
+export async function getTeamInfo(params: GetTeamInfoParams): Promise<GetTeamInfoResult> {
+  const { cfg, uid, tid, scopes } = params;
+  const popoCfg = cfg.channels?.["popo-native"] as PopoNativeConfig | undefined;
+  if (!popoCfg) {
+    throw new Error("POPO Native channel not configured");
+  }
+
+  const query: Record<string, string> = { tid, uid };
+  if (scopes && scopes.length > 0) {
+    query.scopes = scopes.join(",");
+  }
+
+  const response = await popoNativeRequest<TeamInfo>({
+    cfg: popoCfg,
+    method: "GET",
+    path: "/open-apis/team/v1/team-info",
+    query,
+  });
+
+  if (response.errcode !== 0) {
+    return {
+      success: false,
+      error: response.errmsg || `errcode ${response.errcode}`,
+    };
+  }
+
+  return {
+    success: true,
+    info: response.data,
+  };
+}
+
+export type UpdateTeamInfoParams = {
+  cfg: ClawdbotConfig;
+  uid: string; // Operator email
+  tid: string;
+  name: string;
+  board: string;
+  type?: number; // 1=notification only, 2=card announcement
+};
+
+export type UpdateTeamInfoResult = {
+  success: boolean;
+  error?: string;
+};
+
+/**
+ * Update basic information of a team.
+ * Note: Native API may have different endpoint for this.
+ * This is a placeholder implementation.
+ */
+export async function updateTeamInfo(params: UpdateTeamInfoParams): Promise<UpdateTeamInfoResult> {
+  const { cfg, uid, tid, name, board, type } = params;
+  const popoCfg = cfg.channels?.["popo-native"] as PopoNativeConfig | undefined;
+  if (!popoCfg) {
+    throw new Error("POPO Native channel not configured");
+  }
+
+  // Native API team update endpoint may differ
+  // Using a generic approach
+  const body: Record<string, unknown> = { uid, tid, name, board };
+  if (type !== undefined) body.type = type;
+
+  const response = await popoNativeRequest<unknown>({
+    cfg: popoCfg,
+    method: "POST",
+    path: "/open-apis/team/v1/team-set/update",
+    body,
+  });
+
+  if (response.errcode !== 0) {
+    return {
+      success: false,
+      error: response.errmsg || `errcode ${response.errcode}`,
+    };
+  }
+
+  return { success: true };
+}
+
+export type UpdateTeamManagementParams = {
+  cfg: ClawdbotConfig;
+  uid: string; // Operator email
+  tid: string;
+  type: number; // Setting item type (1-8)
+  value: number; // Setting value
+};
+
+export type UpdateTeamManagementResult = {
+  success: boolean;
+  error?: string;
+};
+
+/**
+ * Update team management settings.
+ * Note: Native API may have different endpoint for this.
+ *
+ * Setting types:
+ * 1 - Only owner/admin can edit group info (1=on, 2=off)
+ * 2 - Only owner/admin can add members (1=on, 2=off)
+ * 3 - Allow apply to join (1=on, 2=off)
+ * 4 - Members can view chat history (1=on, 2=off)
+ * 5 - New member join notification (1=all, 2=owner/admin only, 3=none)
+ * 6 - Member leave notification (1=all, 2=owner/admin only, 3=none)
+ * 7 - Allow modify nickname in group (1=on, 2=off)
+ * 8 - Allow external accounts to join (1=on, 2=off)
+ */
+export async function updateTeamManagement(
+  params: UpdateTeamManagementParams
+): Promise<UpdateTeamManagementResult> {
+  const { cfg, uid, tid, type, value } = params;
+  const popoCfg = cfg.channels?.["popo-native"] as PopoNativeConfig | undefined;
+  if (!popoCfg) {
+    throw new Error("POPO Native channel not configured");
+  }
+
+  const response = await popoNativeRequest<unknown>({
+    cfg: popoCfg,
+    method: "POST",
+    path: "/open-apis/team/v1/team-set/management",
+    body: { uid, tid, type, value },
+  });
+
+  if (response.errcode !== 0) {
+    return {
+      success: false,
+      error: response.errmsg || `errcode ${response.errcode}`,
+    };
+  }
+
+  return { success: true };
+}
+
+// ==================== View Scope APIs ====================
+
+export type ViewScopeRecord = {
+  scopeType: string; // "PERSONAL" or "DEPARTMENT"
+  scopeValue: string;
+};
+
+export type GetViewScopeParams = {
+  cfg: ClawdbotConfig;
+  scopeType?: "PERSONAL" | "DEPARTMENT";
+  current?: number;
+  limit?: number;
+};
+
+export type GetViewScopeResult = {
+  success: boolean;
+  records?: ViewScopeRecord[];
+  viewScopeType?: number; // 1=all visible, 2=partial visible
+  total?: number;
+  size?: number;
+  current?: number;
+  error?: string;
+};
+
+/**
+ * Query robot's visible scope.
+ * Note: Native API may not have this endpoint.
+ */
+export async function getViewScope(params: GetViewScopeParams): Promise<GetViewScopeResult> {
+  // Native API may not support view scope
+  return {
+    success: false,
+    error: "View scope not supported in POPO Native API",
+  };
+}
+
+export type ModifyViewScopeParams = {
+  cfg: ClawdbotConfig;
+  operationType: 1 | 2; // 1=add, 2=delete
+  scopeType: "PERSONAL" | "DEPARTMENT";
+  scopeValues: string[];
+};
+
+export type ModifyViewScopeResult = {
+  success: boolean;
+  successNum?: number;
+  failNum?: number;
+  failMsg?: Record<string, string>;
+  error?: string;
+};
+
+/**
+ * Modify robot's visible scope.
+ * Note: Native API may not have this endpoint.
+ */
+export async function modifyViewScope(params: ModifyViewScopeParams): Promise<ModifyViewScopeResult> {
+  // Native API may not support view scope modification
+  return {
+    success: false,
+    error: "View scope modification not supported in POPO Native API",
+  };
+}
+
+export type PublishRobotParams = {
+  cfg: ClawdbotConfig;
+  uid: string; // Applicant email
+};
+
+export type PublishRobotResult = {
+  success: boolean;
+  error?: string;
+};
+
+/**
+ * Apply to publish robot.
+ * Note: Native API may not have this endpoint.
+ */
+export async function publishRobot(params: PublishRobotParams): Promise<PublishRobotResult> {
+  // Native API may not support robot publishing
+  return {
+    success: false,
+    error: "Robot publishing not supported in POPO Native API",
+  };
+}

package/src/types.ts

@@ -0,0 +1,104 @@
+import type { PopoNativeConfigSchema, z } from "./config-schema.js";
+
+export type PopoNativeConfig = z.infer<typeof PopoNativeConfigSchema>;
+
+export type ResolvedPopoNativeAccount = {
+  accountId: string;
+  enabled: boolean;
+  configured: boolean;
+  appId?: string;
+};
+
+export type PopoNativeReceiverType = "email" | "groupId";
+
+export type PopoNativeMessageContext = {
+  sessionId: string;
+  messageId: string;
+  senderId: string;
+  senderEmail: string;
+  senderName?: string;
+  chatType: "p2p" | "group";
+  content: string;
+  contentType: string;
+  fileId?: string;
+};
+
+export type PopoNativeSendResult = {
+  messageId?: string;
+  sessionId: string;
+};
+
+export type PopoNativeProbeResult = {
+  ok: boolean;
+  error?: string;
+  appId?: string;
+};
+
+export type PopoNativeMediaInfo = {
+  path: string;
+  contentType?: string;
+  placeholder: string;
+};
+
+// Native API token structure (different from robot API)
+export type PopoNativeToken = {
+  openAccessToken: string;
+  accessExpiredAt: number;
+  // No refresh token in native API
+};
+
+// Native API event types
+export type PopoNativeMsgSendEvent = {
+  eventType: "MSG_SEND";
+  eventData: {
+    sessionType: 1 | 3; // 1=P2P, 3=Group
+    sessionId: string; // User email or Team ID
+    msgType: number; // 1=text, 142=video, 171=file, 161=merge, 211=quote
+    from: string; // Sender email
+    to: string; // Recipient email or Team ID
+    uuid: string; // Message ID
+    notify: string; // Message content
+    addtime: string; // Timestamp
+    atType?: 0 | 1 | 2; // 0=none, 1=@users, 2=@all
+    atList?: string[]; // @mentioned users
+    fileInfo?: {
+      fileId: string;
+      fileName: string;
+      fileSize: number;
+      fileType: string;
+    };
+    videoInfo?: {
+      videoId: string;
+      duration: number;
+      width: number;
+      height: number;
+    };
+    quoteInfo?: {
+      uuid: string;
+      from: string;
+      notify: string;
+    };
+  };
+};
+
+export type PopoNativeMsgRecallEvent = {
+  eventType: "MSG_RECALL";
+  eventData: {
+    sessionType: 1 | 3;
+    sessionId: string;
+    uuid: string;
+    from: string;
+  };
+};
+
+export type PopoNativeActionEvent = {
+  eventType: "ACTION";
+  eventData: {
+    actionId: string;
+    userId: string;
+    cardId: string;
+    data?: Record<string, unknown>;
+  };
+};
+
+export type PopoNativeEvent = PopoNativeMsgSendEvent | PopoNativeMsgRecallEvent | PopoNativeActionEvent;