@perk-net/perk-pushplus-sdk 1.1.1 → 1.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@perk-net/perk-pushplus-sdk",
-  "version": "1.1.1",
+  "version": "1.2.1",
   "description": "pushplus(推送加) 官方接口 JavaScript/TypeScript SDK，可在 Node.js 与浏览器中使用",
   "keywords": [
     "pushplus",

package/src/api/base.ts

@@ -1,6 +1,6 @@
 import { ResolvedPushPlusConfig } from '../config';
 import { PushPlusError } from '../exception';
-import { HttpRequester, HttpResponse, isSuccessfulHttpStatus } from '../http';
+import { HttpRequester, HttpResponse, callExecuteRaw, isSuccessfulHttpStatus } from '../http';
 import { ApiResponse } from '../models';
 
 /**
@@ -62,6 +62,32 @@ export abstract class AbstractApi {
     return parseApiResponse<T>(resp);
   }
 
+  /**
+   * 执行带二进制请求体的请求并返回原始 ApiResponse（不进行 code 校验）。
+   * 用于 multipart 上传等场景。
+   */
+  protected async executeRaw<T>(
+    method: string,
+    path: string,
+    headers: Record<string, string> | undefined | null,
+    body: Uint8Array,
+  ): Promise<ApiResponse<T>> {
+    const url = this.resolveUrl(path);
+    const resp = await callExecuteRaw(this.http, {
+      method,
+      url,
+      headers: headers ?? undefined,
+      body,
+    });
+    if (!isSuccessfulHttpStatus(resp.statusCode)) {
+      throw new PushPlusError(
+        `PushPlus 接口 HTTP 调用失败: status=${resp.statusCode}, body=${resp.body}`,
+        resp.statusCode,
+      );
+    }
+    return parseApiResponse<T>(resp);
+  }
+
   /** 执行请求并直接返回 data；非 200 抛出异常。 */
   protected async executeForData<T>(
     method: string,

package/src/api/doc-api.ts

@@ -0,0 +1,101 @@
+import { AccessKeyManager } from '../access-key-manager';
+import { ResolvedPushPlusConfig } from '../config';
+import { HttpRequester } from '../http';
+import { FileInput, buildFileMultipart, toFileBytes } from '../multipart';
+import { DocContent, DocListItem, DocListQuery, DocVo, PageResult } from '../models';
+import { OpenAbstractApi } from './open-base';
+
+/**
+ * 开放接口 - push 文档。
+ *
+ * 文档：https://www.pushplus.plus/doc/ecosystem/doc/
+ * 基础路径：`/push/api/open/doc`
+ *
+ * 文档开放接口不单独提供推送接口。发布后请通过 `client.send` 推送分享页：
+ * `template=doc`，`pushId=docCode`。
+ */
+export class DocApi extends OpenAbstractApi {
+  constructor(config: ResolvedPushPlusConfig, http: HttpRequester, mgr: AccessKeyManager) {
+    super(config, http, mgr);
+  }
+
+  /** 我的文档分页。 */
+  list(query?: DocListQuery): Promise<PageResult<DocListItem>> {
+    return this.executeOpen<PageResult<DocListItem>>(
+      'POST',
+      '/push/api/open/doc/list',
+      query ?? {},
+    );
+  }
+
+  /** 创建空白文档。 */
+  create(title: string): Promise<DocVo> {
+    return this.executeOpen<DocVo>('POST', '/push/api/open/doc/create', { title });
+  }
+
+  /**
+   * 导入 Word（.docx）创建文档。
+   *
+   * 标题默认取文件名；创建后默认关闭分享，需再调用 publish 才会同步到分享页。
+   */
+  async importWord(file: FileInput, fileName = 'document.docx'): Promise<DocVo> {
+    const bytes = await toFileBytes(file);
+    const name = fileName && fileName.trim() ? fileName : 'document.docx';
+    return this.executeOpenMultipart<DocVo>(
+      '/push/api/open/doc/import',
+      buildFileMultipart(name, guessDocxContentType(name), bytes),
+    );
+  }
+
+  /** 获取文档元信息与 HTML 草稿正文。 */
+  content(docCode: string): Promise<DocContent> {
+    return this.executeOpen<DocContent>(
+      'GET',
+      this.appendQuery('/push/api/open/doc/content', { docCode }),
+    );
+  }
+
+  /** 保存 HTML 草稿（不影响分享页，需再 publish）。 */
+  saveContent(docCode: string, content: string): Promise<DocVo> {
+    return this.executeOpen<DocVo>('POST', '/push/api/open/doc/saveContent', { docCode, content });
+  }
+
+  /** 将草稿同步为分享页快照。 */
+  publish(docCode: string): Promise<DocVo> {
+    return this.executeOpen<DocVo>(
+      'POST',
+      this.appendQuery('/push/api/open/doc/publish', { docCode }),
+    );
+  }
+
+  /** 重命名。 */
+  async rename(docCode: string, title: string): Promise<void> {
+    await this.executeOpen<unknown>('POST', '/push/api/open/doc/rename', { docCode, title });
+  }
+
+  /** 删除文档。 */
+  async delete(docCode: string): Promise<void> {
+    await this.executeOpen<unknown>(
+      'POST',
+      this.appendQuery('/push/api/open/doc/delete', { docCode }),
+    );
+  }
+
+  /**
+   * 更新分享设置。
+   *
+   * @param sharePerm 0 关闭 / 1 开启（仅可查看）
+   * @param shareLogin 0 免登录 / 1 需登录；不传则沿用原值
+   */
+  updateShare(docCode: string, sharePerm: number, shareLogin?: number): Promise<DocVo> {
+    const body: Record<string, unknown> = { docCode, sharePerm };
+    if (shareLogin != null) body.shareLogin = shareLogin;
+    return this.executeOpen<DocVo>('POST', '/push/api/open/doc/updateShare', body);
+  }
+}
+
+function guessDocxContentType(name: string): string {
+  return name.toLowerCase().endsWith('.docx')
+    ? 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'
+    : 'application/octet-stream';
+}

package/src/api/excel-api.ts

@@ -0,0 +1,143 @@
+import { AccessKeyManager } from '../access-key-manager';
+import { ResolvedPushPlusConfig } from '../config';
+import { PushPlusError } from '../exception';
+import { HttpRequester } from '../http';
+import { FileInput, buildFileMultipart, toFileBytes } from '../multipart';
+import { DocListItem, DocListQuery, ExcelContent, ExcelVo, PageResult } from '../models';
+import { OpenAbstractApi } from './open-base';
+
+/**
+ * 开放接口 - push 表格。
+ *
+ * 文档：https://www.pushplus.plus/doc/ecosystem/sheet/
+ * 基础路径：`/push/api/open/excel`
+ *
+ * 表格开放接口不单独提供推送接口。发布后请通过 `client.send` 推送分享页：
+ * `template=excel`，`pushId=docCode`。
+ */
+export class ExcelApi extends OpenAbstractApi {
+  constructor(config: ResolvedPushPlusConfig, http: HttpRequester, mgr: AccessKeyManager) {
+    super(config, http, mgr);
+  }
+
+  /** 我的表格分页。 */
+  list(query?: DocListQuery): Promise<PageResult<DocListItem>> {
+    return this.executeOpen<PageResult<DocListItem>>(
+      'POST',
+      '/push/api/open/excel/list',
+      query ?? {},
+    );
+  }
+
+  /** 创建空白表格。 */
+  create(title: string): Promise<ExcelVo> {
+    return this.executeOpen<ExcelVo>('POST', '/push/api/open/excel/create', { title });
+  }
+
+  /**
+   * 导入 Excel（.xlsx / .xls）创建表格。
+   *
+   * 标题默认取文件名；创建后默认关闭分享，需再调用 publish 才会同步到分享页。
+   */
+  async importExcel(file: FileInput, fileName = 'workbook.xlsx'): Promise<ExcelVo> {
+    const bytes = await toFileBytes(file);
+    const name = fileName && fileName.trim() ? fileName : 'workbook.xlsx';
+    return this.executeOpenMultipart<ExcelVo>(
+      '/push/api/open/excel/import',
+      buildFileMultipart(name, guessExcelContentType(name), bytes),
+    );
+  }
+
+  /** 获取表格元信息与整表 JSON 草稿。 */
+  content(docCode: string): Promise<ExcelContent> {
+    return this.executeOpen<ExcelContent>(
+      'GET',
+      this.appendQuery('/push/api/open/excel/content', { docCode }),
+    );
+  }
+
+  /**
+   * 整表覆盖保存草稿。
+   *
+   * `content` 可为 JSON 字符串，或工作簿对象（SDK 会序列化）。
+   */
+  saveContent(docCode: string, content: string | object): Promise<ExcelVo> {
+    return this.executeOpen<ExcelVo>('POST', '/push/api/open/excel/saveContent', {
+      docCode,
+      content: stringifyJsonContent(content),
+    });
+  }
+
+  /**
+   * 从指定起始单元格起，按二维数组向右向下写入（草稿）。
+   *
+   * @param range 起始单元格，如 A1
+   * @param values 外层为行、内层为列
+   * @param sheetName 工作表名称；不传则写入活动表 / 第一张表
+   */
+  writeCells(
+    docCode: string,
+    range: string,
+    values: unknown[][],
+    sheetName?: string,
+  ): Promise<ExcelVo> {
+    const body: Record<string, unknown> = { docCode, range, values };
+    if (sheetName != null) body.sheetName = sheetName;
+    return this.executeOpen<ExcelVo>('POST', '/push/api/open/excel/writeCells', body);
+  }
+
+  /** 将草稿同步为分享页快照。 */
+  publish(docCode: string): Promise<ExcelVo> {
+    return this.executeOpen<ExcelVo>(
+      'POST',
+      this.appendQuery('/push/api/open/excel/publish', { docCode }),
+    );
+  }
+
+  /** 重命名。 */
+  async rename(docCode: string, title: string): Promise<void> {
+    await this.executeOpen<unknown>('POST', '/push/api/open/excel/rename', { docCode, title });
+  }
+
+  /** 删除表格。 */
+  async delete(docCode: string): Promise<void> {
+    await this.executeOpen<unknown>(
+      'POST',
+      this.appendQuery('/push/api/open/excel/delete', { docCode }),
+    );
+  }
+
+  /**
+   * 更新分享设置。
+   *
+   * @param sharePerm 0 关闭 / 1 开启（仅可查看）
+   * @param shareLogin 0 免登录 / 1 需登录；不传则沿用原值
+   */
+  updateShare(docCode: string, sharePerm: number, shareLogin?: number): Promise<ExcelVo> {
+    const body: Record<string, unknown> = { docCode, sharePerm };
+    if (shareLogin != null) body.shareLogin = shareLogin;
+    return this.executeOpen<ExcelVo>('POST', '/push/api/open/excel/updateShare', body);
+  }
+}
+
+function stringifyJsonContent(content: string | object): string {
+  if (typeof content === 'string') {
+    return content;
+  }
+  try {
+    return JSON.stringify(content);
+  } catch (e) {
+    throw new PushPlusError(`序列化表格内容失败: ${(e as Error).message}`, -1, { cause: e });
+  }
+}
+
+function guessExcelContentType(name: string): string {
+  const lower = name.toLowerCase();
+  if (lower.endsWith('.xlsx')) {
+    return 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet';
+  }
+  if (lower.endsWith('.xls')) {
+    return 'application/vnd.ms-excel';
+  }
+  return 'application/octet-stream';
+}

package/src/api/form-api.ts

@@ -0,0 +1,95 @@
+import { AccessKeyManager } from '../access-key-manager';
+import { ResolvedPushPlusConfig } from '../config';
+import { HttpRequester } from '../http';
+import {
+  FormDetail,
+  FormListItem,
+  FormListQuery,
+  FormPublishDiff,
+  FormPublishResult,
+  FormSaveRequest,
+  PageResult,
+} from '../models';
+import { OpenAbstractApi } from './open-base';
+
+/**
+ * 开放接口 - push 表单。
+ *
+ * 文档：https://www.pushplus.plus/doc/ecosystem/form/
+ * 基础路径：`/push/api/open/form`
+ *
+ * 表单开放接口不单独提供推送接口。发布后请通过 `client.send` 推送填写页：
+ * `template=form`，`pushId=formCode`。
+ */
+export class FormApi extends OpenAbstractApi {
+  constructor(config: ResolvedPushPlusConfig, http: HttpRequester, mgr: AccessKeyManager) {
+    super(config, http, mgr);
+  }
+
+  /** 我的表单分页。 */
+  list(query?: FormListQuery): Promise<PageResult<FormListItem>> {
+    return this.executeOpen<PageResult<FormListItem>>(
+      'POST',
+      '/push/api/open/form/list',
+      query ?? {},
+    );
+  }
+
+  /** 创建空白表单（草稿）。 */
+  create(title: string): Promise<FormListItem> {
+    return this.executeOpen<FormListItem>('POST', '/push/api/open/form/create', { title });
+  }
+
+  /** 基于已有表单复制一份新草稿。 */
+  copy(id: number): Promise<FormListItem> {
+    return this.executeOpen<FormListItem>(
+      'POST',
+      this.appendQuery('/push/api/open/form/copy', { id }),
+    );
+  }
+
+  /** 保存表单设计（仅更新草稿；已发布需再调用 publish）。 */
+  async save(req: FormSaveRequest): Promise<void> {
+    await this.executeOpen<unknown>('POST', '/push/api/open/form/save', req);
+  }
+
+  /** 表单详情（含草稿题目、主题、设置）。 */
+  detail(id: number): Promise<FormDetail> {
+    return this.executeOpen<FormDetail>(
+      'GET',
+      this.appendQuery('/push/api/open/form/detail', { id }),
+    );
+  }
+
+  /** 草稿与发布快照的题目差异。 */
+  publishDiff(id: number): Promise<FormPublishDiff> {
+    return this.executeOpen<FormPublishDiff>(
+      'GET',
+      this.appendQuery('/push/api/open/form/publishDiff', { id }),
+    );
+  }
+
+  /** 发布表单，开始收集。 */
+  publish(id: number): Promise<FormPublishResult> {
+    return this.executeOpen<FormPublishResult>(
+      'POST',
+      this.appendQuery('/push/api/open/form/publish', { id }),
+    );
+  }
+
+  /** 停止收集。 */
+  async stop(id: number): Promise<void> {
+    await this.executeOpen<unknown>(
+      'POST',
+      this.appendQuery('/push/api/open/form/stop', { id }),
+    );
+  }
+
+  /** 删除表单（不可恢复）。 */
+  async delete(id: number): Promise<void> {
+    await this.executeOpen<unknown>(
+      'POST',
+      this.appendQuery('/push/api/open/form/delete', { id }),
+    );
+  }
+}

package/src/api/friend-api.ts

@@ -1,7 +1,7 @@
 import { AccessKeyManager } from '../access-key-manager';
 import { ResolvedPushPlusConfig } from '../config';
 import { HttpRequester } from '../http';
-import { FriendItem, FriendQrCode, PageQuery, PageResult } from '../models';
+import { FriendBlacklistItem, FriendItem, FriendQrCode, PageQuery, PageResult } from '../models';
 import { OpenAbstractApi } from './open-base';
 
 /**
@@ -44,4 +44,41 @@ export class FriendApi extends OpenAbstractApi {
   async editRemark(id: number, remark: string): Promise<void> {
     await this.executeOpen<unknown>('POST', '/api/open/friend/editRemark', { id, remark });
   }
+
+  /**
+   * 5. 将好友加入黑名单。
+   *
+   * 加入后将解除双方好友关系，对方无法再添加你。不能将自己加入黑名单，仅可将已有好友加入黑名单。
+   *
+   * @param friendId 好友 id（好友列表中的 friendId 字段）
+   */
+  async addBlacklist(friendId: number): Promise<void> {
+    await this.executeOpen<unknown>(
+      'POST',
+      this.appendQuery('/api/open/friend/addBlacklist', { friendId }),
+    );
+  }
+
+  /** 6. 好友黑名单列表。 */
+  blacklistList(query?: PageQuery): Promise<PageResult<FriendBlacklistItem>> {
+    return this.executeOpen<PageResult<FriendBlacklistItem>>(
+      'POST',
+      '/api/open/friend/blacklistList',
+      query ?? {},
+    );
+  }
+
+  /**
+   * 7. 解除好友黑名单。
+   *
+   * 解除后不会自动恢复好友关系，需重新扫码添加。
+   *
+   * @param id 黑名单记录 ID（黑名单列表中的 id 字段）
+   */
+  async removeBlacklist(id: number): Promise<void> {
+    await this.executeOpen<unknown>(
+      'POST',
+      this.appendQuery('/api/open/friend/removeBlacklist', { id }),
+    );
+  }
 }

package/src/api/open-base.ts

@@ -2,6 +2,7 @@ import { AccessKeyManager } from '../access-key-manager';
 import { ResolvedPushPlusConfig } from '../config';
 import { PushPlusError } from '../exception';
 import { HttpRequester } from '../http';
+import { FileMultipart } from '../multipart';
 import { AbstractApi, isApiSuccess } from './base';
 
 /**
@@ -51,4 +52,43 @@ export abstract class OpenAbstractApi extends AbstractApi {
       resp.code ?? -1,
     );
   }
+
+  /** 以 multipart 上传文件（自动携带 access-key；code=401 时刷新后重试一次）。 */
+  protected executeOpenMultipart<T>(path: string, multipart: FileMultipart): Promise<T> {
+    return this.executeOpenRaw<T>('POST', path, multipart.body, {
+      'Content-Type': multipart.contentType,
+    });
+  }
+
+  /**
+   * 执行带二进制 body 的开放接口请求；当返回 code=401 时自动刷新 key 并重试一次。
+   */
+  protected async executeOpenRaw<T>(
+    method: string,
+    path: string,
+    body: Uint8Array,
+    extraHeaders?: Record<string, string>,
+  ): Promise<T> {
+    const headers = { ...(await this.headersWithAccessKey()), ...(extraHeaders ?? {}) };
+    const resp = await this.executeRaw<T>(method, path, headers, body);
+    if (isApiSuccess(resp)) {
+      return resp.data as T;
+    }
+    if (resp.code === OpenAbstractApi.CODE_ACCESS_KEY_INVALID) {
+      this.accessKeyManager.invalidate();
+      const retryHeaders = { ...(await this.headersWithAccessKey()), ...(extraHeaders ?? {}) };
+      const retry = await this.executeRaw<T>(method, path, retryHeaders, body);
+      if (isApiSuccess(retry)) {
+        return retry.data as T;
+      }
+      throw new PushPlusError(
+        `PushPlus 开放接口业务失败(重试后): code=${retry.code}, msg=${retry.msg}`,
+        retry.code ?? -1,
+      );
+    }
+    throw new PushPlusError(
+      `PushPlus 开放接口业务失败: code=${resp.code}, msg=${resp.msg}`,
+      resp.code ?? -1,
+    );
+  }
 }

package/src/api/topic-user-api.ts

@@ -1,7 +1,7 @@
 import { AccessKeyManager } from '../access-key-manager';
 import { ResolvedPushPlusConfig } from '../config';
 import { HttpRequester } from '../http';
-import { PageResult, TopicUserItem, TopicUserListQuery } from '../models';
+import { PageResult, TopicUserBlacklistItem, TopicUserItem, TopicUserListQuery } from '../models';
 import { OpenAbstractApi } from './open-base';
 
 /**
@@ -27,4 +27,43 @@ export class TopicUserApi extends OpenAbstractApi {
   async editRemark(id: number, remark: string): Promise<void> {
     await this.executeOpen<unknown>('POST', '/api/open/topicUser/editRemark', { id, remark });
   }
+
+  /**
+   * 4. 将订阅人加入黑名单。
+   *
+   * 加入后将移出群组，对方无法再加入该群组。积分群组不支持黑名单。不能将自己加入黑名单。
+   *
+   * @param topicRelationId 用户编号（订阅人列表中的 id 字段）
+   */
+  async addBlacklist(topicRelationId: number): Promise<void> {
+    const path = this.appendQuery('/api/open/topicUser/addBlacklist', { topicRelationId });
+    await this.executeOpen<unknown>('POST', path);
+  }
+
+  /**
+   * 5. 订阅人黑名单列表。
+   *
+   * `query.params.topicId` 必填。
+   */
+  blacklistList(query: TopicUserListQuery): Promise<PageResult<TopicUserBlacklistItem>> {
+    return this.executeOpen<PageResult<TopicUserBlacklistItem>>(
+      'POST',
+      '/api/open/topicUser/blacklistList',
+      query,
+    );
+  }
+
+  /**
+   * 6. 解除订阅人黑名单。
+   *
+   * 解除后不会自动恢复群组订阅，对方可重新加入该群组。
+   *
+   * @param id 黑名单记录 ID（黑名单列表中的 id 字段）
+   */
+  async removeBlacklist(id: number): Promise<void> {
+    await this.executeOpen<unknown>(
+      'POST',
+      this.appendQuery('/api/open/topicUser/removeBlacklist', { id }),
+    );
+  }
 }

package/src/client.ts

@@ -2,6 +2,9 @@ import { AccessKeyManager } from './access-key-manager';
 import { AccessKeyApi } from './api/access-key-api';
 import { ChannelApi } from './api/channel-api';
 import { ClawBotApi } from './api/clawbot-api';
+import { DocApi } from './api/doc-api';
+import { ExcelApi } from './api/excel-api';
+import { FormApi } from './api/form-api';
 import { FriendApi } from './api/friend-api';
 import { ImageApi } from './api/image-api';
 import { MessageApi } from './api/message-api';
@@ -67,6 +70,9 @@ export class PushPlusClient {
   readonly setting: SettingApi;
   readonly pre: PreApi;
   readonly image: ImageApi;
+  readonly form: FormApi;
+  readonly doc: DocApi;
+  readonly excel: ExcelApi;
 
   constructor(options: PushPlusClientOptions = {}) {
     this.config = resolveConfig(options);
@@ -89,6 +95,9 @@ export class PushPlusClient {
     this.setting = new SettingApi(this.config, this.httpRequester, this.accessKeyManager);
     this.pre = new PreApi(this.config, this.httpRequester, this.accessKeyManager);
     this.image = new ImageApi(this.config, this.httpRequester, this.accessKeyManager);
+    this.form = new FormApi(this.config, this.httpRequester, this.accessKeyManager);
+    this.doc = new DocApi(this.config, this.httpRequester, this.accessKeyManager);
+    this.excel = new ExcelApi(this.config, this.httpRequester, this.accessKeyManager);
   }
 
   /** 与 Java SDK 风格一致的 Builder 入口。 */

package/src/config.ts

@@ -87,6 +87,6 @@ export function resolveConfig(input: PushPlusConfig | undefined | null): Resolve
     logRequest: cfg.logRequest ?? false,
     rateLimitGuardEnabled: cfg.rateLimitGuardEnabled ?? true,
     rateLimitCooldownMs: cfg.rateLimitCooldownMs ?? 0,
-    userAgent: cfg.userAgent ?? `@perk-net/perk-pushplus-sdk/1.1.1`,
+    userAgent: cfg.userAgent ?? `@perk-net/perk-pushplus-sdk/1.2.1`,
   };
 }

package/src/enums.ts

@@ -118,6 +118,43 @@ export const WebhookTypeDescription: Record<number, string> = {
   [WebhookType.CUSTOM]: '自定义',
 };
 
+/**
+ * push 表单状态。
+ *
+ * 0-草稿，1-收集中，2-已停止。
+ */
+export enum FormStatus {
+  DRAFT = 0,
+  COLLECTING = 1,
+  STOPPED = 2,
+}
+
+export const FormStatusDescription: Record<FormStatus, string> = {
+  [FormStatus.DRAFT]: '草稿',
+  [FormStatus.COLLECTING]: '收集中',
+  [FormStatus.STOPPED]: '已停止',
+};
+
+/**
+ * push 文档 / 表格分享权限。
+ *
+ * 0-关闭分享，1-开启分享（仅可查看）。
+ */
+export enum SharePerm {
+  CLOSED = 0,
+  VIEW = 1,
+}
+
+/**
+ * push 文档 / 表格打开分享页是否需要登录。
+ *
+ * 0-免登录，1-需登录。
+ */
+export enum ShareLogin {
+  ANONYMOUS = 0,
+  REQUIRED = 1,
+};
+
 /**
  * PushPlus 接口业务返回码语义。
  *

package/src/index.ts

@@ -25,6 +25,10 @@ export {
   CallbackEvent,
   WebhookType,
   WebhookTypeDescription,
+  FormStatus,
+  FormStatusDescription,
+  SharePerm,
+  ShareLogin,
   ErrorCode,
   errorCodeFromValue,
   isRateLimitedCode,
@@ -75,10 +79,12 @@ export type {
   TopicItem,
   TopicUserItem,
   TopicUserListQuery,
+  TopicUserBlacklistItem,
   WebhookItem,
   WebhookSaveRequest,
   FriendItem,
   FriendQrCode,
+  FriendBlacklistItem,
   ClawBotInfo,
   ClawBotMessage,
   ClawBotQrCode,
@@ -96,6 +102,23 @@ export type {
   ImageUploadToken,
   ImageUploadResult,
   ImageItem,
+  FormListQuery,
+  FormCover,
+  FormTheme,
+  FormSettings,
+  FormItem,
+  FormListItem,
+  FormSaveRequest,
+  FormDetail,
+  FormPublishDiff,
+  FormPublishResult,
+  DocListQuery,
+  DocListItem,
+  DocVo,
+  DocContent,
+  ExcelVo,
+  ExcelContent,
+  ExcelWriteCellsRequest,
 } from './models';
 
 export {
@@ -126,3 +149,7 @@ export {
   type ImageFileInput,
   type ImageUploadOptions,
 } from './api/image-api';
+export { FormApi } from './api/form-api';
+export { DocApi } from './api/doc-api';
+export { ExcelApi } from './api/excel-api';
+export { type FileInput } from './multipart';