meeglesdk 0.1.0

package/dist/service/view/query.js

@@ -0,0 +1,76 @@
+/**
+ * 视图查询服务
+ * 100% 参考 Meego API 文档
+ */
+import { BaseService } from '../../core/base-service.js';
+/** API 路径 */
+export const API_PATHS = {
+    /** 获取视图列表及配置信息 */
+    VIEW_CONF_LIST: '/open_api/:project_key/view_conf/list',
+    /** 获取固定视图下工作项列表 */
+    FIX_VIEW: '/open_api/:project_key/fix_view/:view_id',
+    /** 获取全景视图下工作项列表 */
+    VIEW_PANORAMIC: '/open_api/:project_key/view/:view_id',
+};
+/**
+ * 视图查询服务
+ */
+export class ViewQueryService extends BaseService {
+    /**
+     * 获取视图列表及配置信息
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param request 查询请求
+     * @param options 请求选项
+     * @returns 分页的视图配置列表
+     */
+    async listConfigs(projectKey, request, options) {
+        return this.postPaginated(API_PATHS.VIEW_CONF_LIST, request, {
+            ...options,
+            pathParams: {
+                project_key: projectKey,
+                ...options?.pathParams,
+            },
+        });
+    }
+    /**
+     * 获取固定视图下工作项列表
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param viewId 视图 ID
+     * @param query 查询参数
+     * @param options 请求选项
+     * @returns 固定视图信息及分页信息
+     */
+    async getFixViewItems(projectKey, viewId, query, options) {
+        return this.getWithPagination(API_PATHS.FIX_VIEW, {
+            ...options,
+            pathParams: {
+                project_key: projectKey,
+                view_id: viewId,
+                ...options?.pathParams,
+            },
+            query: query ? { ...query } : undefined,
+        });
+    }
+    /**
+     * 获取全景视图下工作项列表
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param viewId 全景视图 ID
+     * @param request 查询请求
+     * @param options 请求选项
+     * @returns 分页的工作项列表
+     */
+    async listPanoramicItems(projectKey, viewId, request, options) {
+        return this.postPaginated(API_PATHS.VIEW_PANORAMIC, request ?? {}, {
+            ...options,
+            pathParams: {
+                project_key: projectKey,
+                view_id: viewId,
+                ...options?.pathParams,
+            },
+        });
+    }
+}
+//# sourceMappingURL=query.js.map

package/dist/service/view/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/service/view/query.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAA8B,MAAM,4BAA4B,CAAC;AAWrF,aAAa;AACb,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,kBAAkB;IAClB,cAAc,EAAE,uCAAuC;IACvD,mBAAmB;IACnB,QAAQ,EAAE,0CAA0C;IACpD,mBAAmB;IACnB,cAAc,EAAE,sCAAsC;CACvD,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,WAAW;IAC/C;;;;;;;OAOG;IACH,KAAK,CAAC,WAAW,CACf,UAAkB,EAClB,OAA4B,EAC5B,OAA6C;QAE7C,OAAO,IAAI,CAAC,aAAa,CAAe,SAAS,CAAC,cAAc,EAAE,OAAO,EAAE;YACzE,GAAG,OAAO;YACV,UAAU,EAAE;gBACV,WAAW,EAAE,UAAU;gBACvB,GAAG,OAAO,EAAE,UAAU;aACvB;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,eAAe,CACnB,UAAkB,EAClB,MAAc,EACd,KAA0B,EAC1B,OAA4C;QAE5C,OAAO,IAAI,CAAC,iBAAiB,CAAc,SAAS,CAAC,QAAQ,EAAE;YAC7D,GAAG,OAAO;YACV,UAAU,EAAE;gBACV,WAAW,EAAE,UAAU;gBACvB,OAAO,EAAE,MAAM;gBACf,GAAG,OAAO,EAAE,UAAU;aACvB;YACD,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS;SACxC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,kBAAkB,CACtB,UAAkB,EAClB,MAAc,EACd,OAAkC,EAClC,OAAyC;QAEzC,OAAO,IAAI,CAAC,aAAa,CAAW,SAAS,CAAC,cAAc,EAAE,OAAO,IAAI,EAAE,EAAE;YAC3E,GAAG,OAAO;YACV,UAAU,EAAE;gBACV,WAAW,EAAE,UAAU;gBACvB,OAAO,EAAE,MAAM;gBACf,GAAG,OAAO,EAAE,UAAU;aACvB;SACF,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/service/view/view.d.ts

@@ -0,0 +1,76 @@
+/**
+ * 视图服务
+ * 100% 参考 Meego API 文档
+ *
+ * 提供固定视图、条件视图的创建、更新与删除能力
+ */
+import type { RequestHandler } from '../../core/request.js';
+import { BaseService, type ServiceRequestOptions } from '../../core/base-service.js';
+import type { PaginatedObjectResult } from '../../types/common.js';
+import type { CreateFixViewRequest, UpdateFixViewRequest, CreateConditionViewRequest, UpdateConditionViewRequest, CreateConditionViewResponse, FixViewInfo } from '../../types/view.js';
+import { ViewQueryService } from './query.js';
+/** API 路径 */
+export declare const API_PATHS: {
+    /** 创建固定视图 */
+    CREATE_FIX_VIEW: string;
+    /** 更新固定视图 */
+    UPDATE_FIX_VIEW: string;
+    /** 删除视图 */
+    DELETE_VIEW: string;
+    /** 创建条件视图 */
+    CREATE_CONDITION_VIEW: string;
+    /** 更新条件视图 */
+    UPDATE_CONDITION_VIEW: string;
+};
+/**
+ * 视图服务
+ */
+export declare class ViewService extends BaseService {
+    /** 查询服务 */
+    readonly query: ViewQueryService;
+    constructor(requestHandler: RequestHandler);
+    /**
+     * 创建固定视图
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型 key
+     * @param request 创建请求
+     * @param options 请求选项
+     * @returns 新创建的固定视图信息与分页信息
+     */
+    createFixView(projectKey: string, workItemTypeKey: string, request: CreateFixViewRequest, options?: ServiceRequestOptions<FixViewInfo>): Promise<PaginatedObjectResult<FixViewInfo>>;
+    /**
+     * 更新固定视图
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型 key
+     * @param viewId 视图 ID
+     * @param request 更新请求
+     * @param options 请求选项
+     */
+    updateFixView(projectKey: string, workItemTypeKey: string, viewId: string, request: UpdateFixViewRequest, options?: ServiceRequestOptions<void>): Promise<void>;
+    /**
+     * 删除视图
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param viewId 视图 ID
+     * @param options 请求选项
+     */
+    deleteView(projectKey: string, viewId: string, options?: ServiceRequestOptions<void>): Promise<void>;
+    /**
+     * 创建条件视图
+     *
+     * @param request 创建请求
+     * @param options 请求选项
+     * @returns 新创建视图 ID
+     */
+    createConditionView(request: CreateConditionViewRequest, options?: ServiceRequestOptions<CreateConditionViewResponse>): Promise<CreateConditionViewResponse>;
+    /**
+     * 更新条件视图
+     *
+     * @param request 更新请求
+     * @param options 请求选项
+     */
+    updateConditionView(request: UpdateConditionViewRequest, options?: ServiceRequestOptions<void>): Promise<void>;
+}
+//# sourceMappingURL=view.d.ts.map

package/dist/service/view/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../src/service/view/view.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,KAAK,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACrF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,0BAA0B,EAC1B,2BAA2B,EAC3B,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,aAAa;AACb,eAAO,MAAM,SAAS;IACpB,aAAa;;IAEb,aAAa;;IAEb,WAAW;;IAEX,aAAa;;IAEb,aAAa;;CAEd,CAAC;AAEF;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C,WAAW;IACX,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;gBAErB,cAAc,EAAE,cAAc;IAK1C;;;;;;;;OAQG;IACG,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE,qBAAqB,CAAC,WAAW,CAAC,GAC3C,OAAO,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC;IAW9C;;;;;;;;OAQG;IACG,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE,qBAAqB,CAAC,IAAI,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC;IAYhB;;;;;;OAMG;IACG,UAAU,CACd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,qBAAqB,CAAC,IAAI,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC;IAWhB;;;;;;OAMG;IACG,mBAAmB,CACvB,OAAO,EAAE,0BAA0B,EACnC,OAAO,CAAC,EAAE,qBAAqB,CAAC,2BAA2B,CAAC,GAC3D,OAAO,CAAC,2BAA2B,CAAC;IAIvC;;;;;OAKG;IACG,mBAAmB,CACvB,OAAO,EAAE,0BAA0B,EACnC,OAAO,CAAC,EAAE,qBAAqB,CAAC,IAAI,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC;CAGjB"}

package/dist/service/view/view.js

@@ -0,0 +1,108 @@
+/**
+ * 视图服务
+ * 100% 参考 Meego API 文档
+ *
+ * 提供固定视图、条件视图的创建、更新与删除能力
+ */
+import { BaseService } from '../../core/base-service.js';
+import { ViewQueryService } from './query.js';
+/** API 路径 */
+export const API_PATHS = {
+    /** 创建固定视图 */
+    CREATE_FIX_VIEW: '/open_api/:project_key/:work_item_type_key/fix_view',
+    /** 更新固定视图 */
+    UPDATE_FIX_VIEW: '/open_api/:project_key/:work_item_type_key/fix_view/:view_id',
+    /** 删除视图 */
+    DELETE_VIEW: '/open_api/:project_key/fix_view/:view_id',
+    /** 创建条件视图 */
+    CREATE_CONDITION_VIEW: '/open_api/view/v1/create_condition_view',
+    /** 更新条件视图 */
+    UPDATE_CONDITION_VIEW: '/open_api/view/v1/update_condition_view',
+};
+/**
+ * 视图服务
+ */
+export class ViewService extends BaseService {
+    /** 查询服务 */
+    query;
+    constructor(requestHandler) {
+        super(requestHandler);
+        this.query = new ViewQueryService(requestHandler);
+    }
+    /**
+     * 创建固定视图
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型 key
+     * @param request 创建请求
+     * @param options 请求选项
+     * @returns 新创建的固定视图信息与分页信息
+     */
+    async createFixView(projectKey, workItemTypeKey, request, options) {
+        return this.postWithPagination(API_PATHS.CREATE_FIX_VIEW, request, {
+            ...options,
+            pathParams: {
+                project_key: projectKey,
+                work_item_type_key: workItemTypeKey,
+                ...options?.pathParams,
+            },
+        });
+    }
+    /**
+     * 更新固定视图
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型 key
+     * @param viewId 视图 ID
+     * @param request 更新请求
+     * @param options 请求选项
+     */
+    async updateFixView(projectKey, workItemTypeKey, viewId, request, options) {
+        await this.post(API_PATHS.UPDATE_FIX_VIEW, request, {
+            ...options,
+            pathParams: {
+                project_key: projectKey,
+                work_item_type_key: workItemTypeKey,
+                view_id: viewId,
+                ...options?.pathParams,
+            },
+        });
+    }
+    /**
+     * 删除视图
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param viewId 视图 ID
+     * @param options 请求选项
+     */
+    async deleteView(projectKey, viewId, options) {
+        await this.delete(API_PATHS.DELETE_VIEW, {
+            ...options,
+            pathParams: {
+                project_key: projectKey,
+                view_id: viewId,
+                ...options?.pathParams,
+            },
+        });
+    }
+    /**
+     * 创建条件视图
+     *
+     * @param request 创建请求
+     * @param options 请求选项
+     * @returns 新创建视图 ID
+     */
+    async createConditionView(request, options) {
+        return this.post(API_PATHS.CREATE_CONDITION_VIEW, request, options);
+    }
+    /**
+     * 更新条件视图
+     *
+     * @param request 更新请求
+     * @param options 请求选项
+     */
+    async updateConditionView(request, options) {
+        await this.post(API_PATHS.UPDATE_CONDITION_VIEW, request, options);
+    }
+}
+//# sourceMappingURL=view.js.map

package/dist/service/view/view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../../src/service/view/view.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAA8B,MAAM,4BAA4B,CAAC;AAUrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,aAAa;AACb,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,aAAa;IACb,eAAe,EAAE,qDAAqD;IACtE,aAAa;IACb,eAAe,EAAE,8DAA8D;IAC/E,WAAW;IACX,WAAW,EAAE,0CAA0C;IACvD,aAAa;IACb,qBAAqB,EAAE,yCAAyC;IAChE,aAAa;IACb,qBAAqB,EAAE,yCAAyC;CACjE,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C,WAAW;IACF,KAAK,CAAmB;IAEjC,YAAY,cAA8B;QACxC,KAAK,CAAC,cAAc,CAAC,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,gBAAgB,CAAC,cAAc,CAAC,CAAC;IACpD,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,aAAa,CACjB,UAAkB,EAClB,eAAuB,EACvB,OAA6B,EAC7B,OAA4C;QAE5C,OAAO,IAAI,CAAC,kBAAkB,CAAc,SAAS,CAAC,eAAe,EAAE,OAAO,EAAE;YAC9E,GAAG,OAAO;YACV,UAAU,EAAE;gBACV,WAAW,EAAE,UAAU;gBACvB,kBAAkB,EAAE,eAAe;gBACnC,GAAG,OAAO,EAAE,UAAU;aACvB;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,aAAa,CACjB,UAAkB,EAClB,eAAuB,EACvB,MAAc,EACd,OAA6B,EAC7B,OAAqC;QAErC,MAAM,IAAI,CAAC,IAAI,CAAO,SAAS,CAAC,eAAe,EAAE,OAAO,EAAE;YACxD,GAAG,OAAO;YACV,UAAU,EAAE;gBACV,WAAW,EAAE,UAAU;gBACvB,kBAAkB,EAAE,eAAe;gBACnC,OAAO,EAAE,MAAM;gBACf,GAAG,OAAO,EAAE,UAAU;aACvB;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,CACd,UAAkB,EAClB,MAAc,EACd,OAAqC;QAErC,MAAM,IAAI,CAAC,MAAM,CAAO,SAAS,CAAC,WAAW,EAAE;YAC7C,GAAG,OAAO;YACV,UAAU,EAAE;gBACV,WAAW,EAAE,UAAU;gBACvB,OAAO,EAAE,MAAM;gBACf,GAAG,OAAO,EAAE,UAAU;aACvB;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,mBAAmB,CACvB,OAAmC,EACnC,OAA4D;QAE5D,OAAO,IAAI,CAAC,IAAI,CAA8B,SAAS,CAAC,qBAAqB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACnG,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,mBAAmB,CACvB,OAAmC,EACnC,OAAqC;QAErC,MAAM,IAAI,CAAC,IAAI,CAAO,SAAS,CAAC,qBAAqB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;CACF"}

package/dist/service/workitem/attachment.d.ts

@@ -0,0 +1,143 @@
+/**
+ * 附件服务
+ * 100% 参考 Meego API 文档
+ *
+ * 提供附件的上传、下载、删除功能
+ */
+import { BaseService, type ServiceRequestOptions, type UploadRequestOptions, type DownloadOptions } from '../../core/base-service.js';
+import type { UploadAttachmentRequest, UploadFileRequest, DownloadAttachmentRequest, DeleteAttachmentRequest } from '../../types/workitem.js';
+/** API 路径 */
+export declare const API_PATHS: {
+    /** 上传文件或富文本图片（通用） */
+    FILE_UPLOAD: string;
+    /** 添加附件到工作项 */
+    ATTACHMENT_UPLOAD: string;
+    /** 下载附件 */
+    FILE_DOWNLOAD: string;
+    /** 删除附件 */
+    FILE_DELETE: string;
+};
+/**
+ * 附件服务
+ *
+ * 提供附件的上传、下载、删除功能
+ */
+export declare class AttachmentService extends BaseService {
+    /**
+     * 上传文件（通用）
+     *
+     * 用于富文本中上传图片等场景，返回上传后的资源路径
+     * 最大支持 100M
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param request 上传请求
+     * @param options 请求选项
+     * @returns 附件链接 URL 数组
+     *
+     * @example
+     * ```typescript
+     * const urls = await client.workItem.attachment.uploadFile('my-project', {
+     *   file: new Blob([...]),
+     * });
+     * console.log(urls[0]); // https://project.feishu.cn/goapi/v1/tos/file/...
+     * ```
+     */
+    uploadFile(projectKey: string, request: UploadFileRequest, options?: UploadRequestOptions<string[]>): Promise<string[]>;
+    /**
+     * 添加附件到工作项
+     *
+     * 在指定工作项的附件类型字段中添加附件
+     * - 最大支持 100M
+     * - 附件字段数量限制为 50 个
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型 key
+     * @param workItemId 工作项 ID
+     * @param request 上传请求
+     * @param options 请求选项
+     *
+     * @example
+     * ```typescript
+     * // 普通附件上传
+     * await client.workItem.attachment.uploadAttachment('my-project', 'story', 123456, {
+     *   file: new Blob([...]),
+     *   field_key: 'field_xxx',
+     * });
+     *
+     * // 复合字段中上传附件
+     * await client.workItem.attachment.uploadAttachment('my-project', 'story', 123456, {
+     *   file: new Blob([...]),
+     *   field_key: 'compound_field_xxx',
+     *   index: '0',
+     * });
+     * ```
+     */
+    uploadAttachment(projectKey: string, workItemTypeKey: string, workItemId: number, request: UploadAttachmentRequest, options?: UploadRequestOptions<void>): Promise<void>;
+    /**
+     * 下载附件
+     *
+     * 下载工作项中的指定附件，返回二进制数据
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型 key
+     * @param workItemId 工作项 ID
+     * @param request 下载请求
+     * @param options 请求选项
+     * @returns 文件二进制数据
+     *
+     * @example
+     * ```typescript
+     * // 下载附件
+     * const data = await client.workItem.attachment.downloadAttachment('my-project', 'story', 123456, {
+     *   uuid: 'a0e0104f-94bc-4999-bf07-239fd2f7xxxx',
+     * });
+     *
+     * // 保存到文件 (Node.js)
+     * import { writeFileSync } from 'fs';
+     * writeFileSync('downloaded.pdf', Buffer.from(data));
+     *
+     * // 转换为 Blob (浏览器)
+     * const blob = new Blob([data]);
+     * ```
+     */
+    downloadAttachment(projectKey: string, workItemTypeKey: string, workItemId: number, request: DownloadAttachmentRequest, options?: DownloadOptions): Promise<ArrayBuffer>;
+    /**
+     * 下载附件（流式）
+     *
+     * 适用于大文件下载，避免一次性占用大量内存
+     *
+     * @example
+     * ```typescript
+     * const stream = await client.workItem.attachment.downloadAttachmentStream(
+     *   'my-project',
+     *   'story',
+     *   123456,
+     *   { uuid: 'a0e0104f-94bc-4999-bf07-239fd2f7xxxx' },
+     *   {
+     *     onProgress: (p) => console.log(p.progress),
+     *   }
+     * );
+     * ```
+     */
+    downloadAttachmentStream(projectKey: string, workItemTypeKey: string, workItemId: number, request: DownloadAttachmentRequest, options?: DownloadOptions): Promise<ReadableStream<Uint8Array>>;
+    /**
+     * 删除附件
+     *
+     * 删除指定工作项附件字段中的附件
+     *
+     * @param request 删除请求
+     * @param options 请求选项
+     *
+     * @example
+     * ```typescript
+     * await client.workItem.attachment.deleteAttachment({
+     *   project_key: 'my-project',
+     *   work_item_id: 123456,
+     *   field_key: 'field_xxx',
+     *   uuids: ['uuid1', 'uuid2'],
+     * });
+     * ```
+     */
+    deleteAttachment(request: DeleteAttachmentRequest, options?: ServiceRequestOptions<void>): Promise<void>;
+}
+//# sourceMappingURL=attachment.d.ts.map

package/dist/service/workitem/attachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment.d.ts","sourceRoot":"","sources":["../../../src/service/workitem/attachment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,WAAW,EACX,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACrB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,EACzB,uBAAuB,EACxB,MAAM,yBAAyB,CAAC;AAUjC,aAAa;AACb,eAAO,MAAM,SAAS;IACpB,qBAAqB;;IAErB,eAAe;;IAEf,WAAW;;IAEX,WAAW;;CAEZ,CAAC;AAEF;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;IAChD;;;;;;;;;;;;;;;;;;OAkBG;IACG,UAAU,CACd,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,oBAAoB,CAAC,MAAM,EAAE,CAAC,GACvC,OAAO,CAAC,MAAM,EAAE,CAAC;IAkBpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,uBAAuB,EAChC,OAAO,CAAC,EAAE,oBAAoB,CAAC,IAAI,CAAC,GACnC,OAAO,CAAC,IAAI,CAAC;IAiChB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,kBAAkB,CACtB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,yBAAyB,EAClC,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,WAAW,CAAC;IAmBvB;;;;;;;;;;;;;;;;;OAiBG;IACG,wBAAwB,CAC5B,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,yBAAyB,EAClC,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAmBtC;;;;;;;;;;;;;;;;;OAiBG;IACG,gBAAgB,CACpB,OAAO,EAAE,uBAAuB,EAChC,OAAO,CAAC,EAAE,qBAAqB,CAAC,IAAI,CAAC,GACpC,OAAO,CAAC,IAAI,CAAC;CAGjB"}

package/dist/service/workitem/attachment.js

@@ -0,0 +1,231 @@
+/**
+ * 附件服务
+ * 100% 参考 Meego API 文档
+ *
+ * 提供附件的上传、下载、删除功能
+ */
+import { BaseService, } from '../../core/base-service.js';
+const resolveFileName = (file, fileName) => {
+    if (typeof fileName === 'string' && fileName.trim().length > 0) {
+        return fileName;
+    }
+    const name = file.name;
+    return typeof name === 'string' && name.trim().length > 0 ? name : 'file';
+};
+/** API 路径 */
+export const API_PATHS = {
+    /** 上传文件或富文本图片（通用） */
+    FILE_UPLOAD: '/open_api/:project_key/file/upload',
+    /** 添加附件到工作项 */
+    ATTACHMENT_UPLOAD: '/open_api/:project_key/work_item/:work_item_type_key/:work_item_id/file/upload',
+    /** 下载附件 */
+    FILE_DOWNLOAD: '/open_api/:project_key/work_item/:work_item_type_key/:work_item_id/file/download',
+    /** 删除附件 */
+    FILE_DELETE: '/open_api/file/delete',
+};
+/**
+ * 附件服务
+ *
+ * 提供附件的上传、下载、删除功能
+ */
+export class AttachmentService extends BaseService {
+    /**
+     * 上传文件（通用）
+     *
+     * 用于富文本中上传图片等场景，返回上传后的资源路径
+     * 最大支持 100M
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param request 上传请求
+     * @param options 请求选项
+     * @returns 附件链接 URL 数组
+     *
+     * @example
+     * ```typescript
+     * const urls = await client.workItem.attachment.uploadFile('my-project', {
+     *   file: new Blob([...]),
+     * });
+     * console.log(urls[0]); // https://project.feishu.cn/goapi/v1/tos/file/...
+     * ```
+     */
+    async uploadFile(projectKey, request, options) {
+        return this.upload(API_PATHS.FILE_UPLOAD, {
+            pathParams: {
+                project_key: projectKey,
+                ...options?.pathParams,
+            },
+            file: request.file,
+            fileName: resolveFileName(request.file, request.fileName),
+            auth: options?.auth,
+            timeout: options?.timeout,
+            maxUploadSizeBytes: options?.maxUploadSizeBytes,
+            minUploadSizeBytes: options?.minUploadSizeBytes,
+            skipRetry: options?.skipRetry,
+            retry: options?.retry,
+            responseValidator: options?.responseValidator,
+        });
+    }
+    /**
+     * 添加附件到工作项
+     *
+     * 在指定工作项的附件类型字段中添加附件
+     * - 最大支持 100M
+     * - 附件字段数量限制为 50 个
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型 key
+     * @param workItemId 工作项 ID
+     * @param request 上传请求
+     * @param options 请求选项
+     *
+     * @example
+     * ```typescript
+     * // 普通附件上传
+     * await client.workItem.attachment.uploadAttachment('my-project', 'story', 123456, {
+     *   file: new Blob([...]),
+     *   field_key: 'field_xxx',
+     * });
+     *
+     * // 复合字段中上传附件
+     * await client.workItem.attachment.uploadAttachment('my-project', 'story', 123456, {
+     *   file: new Blob([...]),
+     *   field_key: 'compound_field_xxx',
+     *   index: '0',
+     * });
+     * ```
+     */
+    async uploadAttachment(projectKey, workItemTypeKey, workItemId, request, options) {
+        // 构建额外的表单字段
+        const formFields = {};
+        if (request.field_key) {
+            formFields['field_key'] = request.field_key;
+        }
+        if (request.field_alias) {
+            formFields['field_alias'] = request.field_alias;
+        }
+        if (request.index) {
+            formFields['index'] = request.index;
+        }
+        await this.upload(API_PATHS.ATTACHMENT_UPLOAD, {
+            pathParams: {
+                project_key: projectKey,
+                work_item_type_key: workItemTypeKey,
+                work_item_id: String(workItemId),
+                ...options?.pathParams,
+            },
+            file: request.file,
+            fileName: resolveFileName(request.file, request.fileName),
+            formFields: Object.keys(formFields).length > 0 ? formFields : undefined,
+            auth: options?.auth,
+            timeout: options?.timeout,
+            maxUploadSizeBytes: options?.maxUploadSizeBytes,
+            minUploadSizeBytes: options?.minUploadSizeBytes,
+            skipRetry: options?.skipRetry,
+            retry: options?.retry,
+            responseValidator: options?.responseValidator,
+        });
+    }
+    /**
+     * 下载附件
+     *
+     * 下载工作项中的指定附件，返回二进制数据
+     *
+     * @param projectKey 空间 ID 或域名
+     * @param workItemTypeKey 工作项类型 key
+     * @param workItemId 工作项 ID
+     * @param request 下载请求
+     * @param options 请求选项
+     * @returns 文件二进制数据
+     *
+     * @example
+     * ```typescript
+     * // 下载附件
+     * const data = await client.workItem.attachment.downloadAttachment('my-project', 'story', 123456, {
+     *   uuid: 'a0e0104f-94bc-4999-bf07-239fd2f7xxxx',
+     * });
+     *
+     * // 保存到文件 (Node.js)
+     * import { writeFileSync } from 'fs';
+     * writeFileSync('downloaded.pdf', Buffer.from(data));
+     *
+     * // 转换为 Blob (浏览器)
+     * const blob = new Blob([data]);
+     * ```
+     */
+    async downloadAttachment(projectKey, workItemTypeKey, workItemId, request, options) {
+        return this.download(API_PATHS.FILE_DOWNLOAD, {
+            pathParams: {
+                project_key: projectKey,
+                work_item_type_key: workItemTypeKey,
+                work_item_id: String(workItemId),
+                ...options?.pathParams,
+            },
+            body: { uuid: request.uuid },
+            auth: options?.auth,
+            timeout: options?.timeout,
+            signal: options?.signal,
+            onProgress: options?.onProgress,
+            onChunk: options?.onChunk,
+            skipRetry: options?.skipRetry,
+            retry: options?.retry,
+        });
+    }
+    /**
+     * 下载附件（流式）
+     *
+     * 适用于大文件下载，避免一次性占用大量内存
+     *
+     * @example
+     * ```typescript
+     * const stream = await client.workItem.attachment.downloadAttachmentStream(
+     *   'my-project',
+     *   'story',
+     *   123456,
+     *   { uuid: 'a0e0104f-94bc-4999-bf07-239fd2f7xxxx' },
+     *   {
+     *     onProgress: (p) => console.log(p.progress),
+     *   }
+     * );
+     * ```
+     */
+    async downloadAttachmentStream(projectKey, workItemTypeKey, workItemId, request, options) {
+        return this.downloadStream(API_PATHS.FILE_DOWNLOAD, {
+            pathParams: {
+                project_key: projectKey,
+                work_item_type_key: workItemTypeKey,
+                work_item_id: String(workItemId),
+                ...options?.pathParams,
+            },
+            body: { uuid: request.uuid },
+            auth: options?.auth,
+            timeout: options?.timeout,
+            signal: options?.signal,
+            onProgress: options?.onProgress,
+            onChunk: options?.onChunk,
+            skipRetry: options?.skipRetry,
+            retry: options?.retry,
+        });
+    }
+    /**
+     * 删除附件
+     *
+     * 删除指定工作项附件字段中的附件
+     *
+     * @param request 删除请求
+     * @param options 请求选项
+     *
+     * @example
+     * ```typescript
+     * await client.workItem.attachment.deleteAttachment({
+     *   project_key: 'my-project',
+     *   work_item_id: 123456,
+     *   field_key: 'field_xxx',
+     *   uuids: ['uuid1', 'uuid2'],
+     * });
+     * ```
+     */
+    async deleteAttachment(request, options) {
+        await this.post(API_PATHS.FILE_DELETE, request, options);
+    }
+}
+//# sourceMappingURL=attachment.js.map

package/dist/service/workitem/attachment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment.js","sourceRoot":"","sources":["../../../src/service/workitem/attachment.ts"],"names":[],"mappings":"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"}