meeglesdk 0.2.2 → 0.2.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.2.3 - 2026-07-11
+
+### Fixed
+
+- Universal Search now accepts both upstream response formats observed in real environments: documented `datas` arrays and alternate stringified `data` payloads.
+- Unknown Universal Search response shapes still fail explicitly instead of silently returning an empty result.
+
+### Tests
+
+- Added coverage for documented `datas`, alternate stringified `data`, and unknown response rejection.
+- Verified the documented flat request body remains `project_key + work_item_type_key + search_group`.
+
 ## 0.2.2 - 2026-07-11
 
 ### Added

package/RELEASE.md

@@ -5,8 +5,8 @@ This document is the npm release checklist for `meeglesdk`.
 ## Current Release
 
 - Package: `meeglesdk`
-- Version: `0.2.2`
-- Registry latest checked before release: `0.2.1`
+- Version: `0.2.3`
+- Registry latest checked before release: `0.2.2`
 - Runtime requirement: Node.js 18+
 - Development runtime: Bun 1.3+
 
@@ -37,7 +37,7 @@ This document is the npm release checklist for `meeglesdk`.
 
    ```bash
    npm view meeglesdk version dist-tags --json
-   npm view meeglesdk@0.2.2 dist.tarball
+   npm view meeglesdk@0.2.3 dist.tarball
    ```
 
 ## Notes

package/dist/core/base-service.d.ts

@@ -126,7 +126,7 @@ export declare abstract class BaseService {
      * POST 游标分页请求
      * 用于 datas + pagination（search_after） 的接口
      */
-    protected postCursorPaginated<T>(path: string, body?: unknown, options?: ServiceRequestOptions<T>, dataKey?: string): Promise<SearchAfterPaginatedResult<T>>;
+    protected postCursorPaginated<T>(path: string, body?: unknown, options?: ServiceRequestOptions<T>, dataKeys?: string | readonly string[]): Promise<SearchAfterPaginatedResult<T>>;
     /**
      * GET 分页请求（data 为对象）
      * 用于 pagination 与 data 同级，但 data 为对象的接口

package/dist/core/base-service.js

@@ -101,7 +101,7 @@ export class BaseService {
      * POST 游标分页请求
      * 用于 datas + pagination（search_after） 的接口
      */
-    postCursorPaginated(path, body, options, dataKey = 'datas') {
+    postCursorPaginated(path, body, options, dataKeys = 'datas') {
         return this.requestHandler.requestCursorPaginated({
             method: 'POST',
             path,
@@ -115,7 +115,7 @@ export class BaseService {
             skipRetry: options?.skipRetry,
             retry: options?.retry,
             responseValidator: options?.responseValidator,
-        }, dataKey);
+        }, dataKeys);
     }
     /**
      * GET 分页请求（data 为对象）

package/dist/core/request/handler.d.ts

@@ -31,7 +31,7 @@ export declare class RequestHandler {
      * 发送游标分页请求
      * 用于 datas + pagination（search_after） 的接口
      */
-    requestCursorPaginated<T>(config: RequestConfig<T>, dataKey?: string): Promise<SearchAfterPaginatedResult<T>>;
+    requestCursorPaginated<T>(config: RequestConfig<T>, dataKeys?: string | readonly string[]): Promise<SearchAfterPaginatedResult<T>>;
     /**
      * 发送请求（自定义响应字段）
      * 用于响应数据字段不是 data 的接口

package/dist/core/request/handler.js

@@ -56,8 +56,8 @@ export class RequestHandler {
      * 发送游标分页请求
      * 用于 datas + pagination（search_after） 的接口
      */
-    async requestCursorPaginated(config, dataKey = 'datas') {
-        return this.executeWithRetry(config, (context) => this.executeOnce(context, (response) => parseCursorPaginatedResponse(response, dataKey, config.responseValidator)));
+    async requestCursorPaginated(config, dataKeys = 'datas') {
+        return this.executeWithRetry(config, (context) => this.executeOnce(context, (response) => parseCursorPaginatedResponse(response, dataKeys, config.responseValidator)));
     }
     /**
      * 发送请求（自定义响应字段）

package/dist/core/request/response-parser.d.ts

@@ -47,4 +47,4 @@ export declare function parseMultiFieldResponse<T extends object>(response: Resp
  * 解析游标分页响应
  * 用于 datas + pagination（search_after） 的接口
  */
-export declare function parseCursorPaginatedResponse<T>(response: Response, dataKey: string, validator?: ResponseValidator<T>): Promise<SearchAfterPaginatedResult<T>>;
+export declare function parseCursorPaginatedResponse<T>(response: Response, dataKeys: string | readonly string[], validator?: ResponseValidator<T>): Promise<SearchAfterPaginatedResult<T>>;

package/dist/core/request/response-parser.js

@@ -154,10 +154,13 @@ export async function parseMultiFieldResponse(response, fields) {
  * 解析游标分页响应
  * 用于 datas + pagination（search_after） 的接口
  */
-export async function parseCursorPaginatedResponse(response, dataKey, validator) {
+export async function parseCursorPaginatedResponse(response, dataKeys, validator) {
     const result = await parseEnvelope(response);
-    if (!(dataKey in result)) {
-        throw new MeegoError(`[-1] Response missing ${dataKey}`, -1, `Response missing ${dataKey}`, result.err, response.status);
+    const acceptedDataKeys = typeof dataKeys === 'string' ? [dataKeys] : [...dataKeys];
+    const dataKey = acceptedDataKeys.find((key) => key in result);
+    if (!dataKey) {
+        const expected = acceptedDataKeys.join(', ');
+        throw new MeegoError(`[-1] Response missing one of: ${expected}`, -1, `Response missing one of: ${expected}`, result.err, response.status);
     }
     const rawData = result[dataKey];
     let parsedData = rawData;

package/dist/service/workitem/search.js

@@ -273,7 +273,7 @@ export class SearchService extends BaseService {
      * ```
      */
     async universalSearch(request, options) {
-        const result = await this.postCursorPaginated(API_PATHS.UNIVERSAL_SEARCH, request, options, 'data');
+        const result = await this.postCursorPaginated(API_PATHS.UNIVERSAL_SEARCH, request, options, ['datas', 'data']);
         return {
             datas: result.data,
             pagination: result.pagination,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "meeglesdk",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "飞书项目 Open API TypeScript SDK",
   "type": "module",
   "main": "./dist/index.js",