Handle legacy document list responses

Author: suguanYang

src/resources/__tests__/documents.test.ts

@@ -67,6 +67,28 @@ describe('Documents Resource', () => {
     expect(mockHttpClient.get).toHaveBeenCalledWith('/v1/documents', undefined);
   });
 
+  it('should synthesize document pagination for legacy API responses', async () => {
+    mockHttpClient.get.mockResolvedValue({
+      namespace: 'default',
+      documents: [
+        {
+          documentId: 'doc-123',
+          namespace: 'default',
+          status: 'active',
+        },
+      ],
+    });
+
+    const response = await documents.list();
+
+    expect(response.pagination).toEqual({
+      page: 1,
+      pageSize: 1,
+      total: 1,
+      totalPages: 1,
+    });
+  });
+
   it('should get one document by id', async () => {
     mockHttpClient.get.mockResolvedValue({
       documentId: 'doc-123',

src/resources/documents.ts

@@ -13,6 +13,9 @@ type RequestConfig = {
   params: Record<string, string | number | boolean>;
 };
 
+type MaybePaginatedDocumentListResponse = Omit<DocumentListResponse, 'pagination'> &
+  Partial<Pick<DocumentListResponse, 'pagination'>>;
+
 /**
  * Resource for canonical document lifecycle operations.
  */
@@ -21,10 +24,11 @@ export class Documents extends BaseResource {
    * List canonical documents in a namespace.
    */
   async list(params?: DocumentListParams): Promise<DocumentListResponse> {
-    return this.httpClient.get<DocumentListResponse>(
+    const response = await this.httpClient.get<DocumentListResponse>(
       '/v1/documents',
       this.createDocumentListRequestConfig(params),
     );
+    return this.normalizeDocumentListResponse(response);
   }
 
   /**
@@ -87,6 +91,24 @@ export class Documents extends BaseResource {
     return Object.keys(queryParams).length > 0 ? { params: queryParams } : undefined;
   }
 
+  private normalizeDocumentListResponse(response: DocumentListResponse): DocumentListResponse {
+    const maybePaginatedResponse = response as MaybePaginatedDocumentListResponse;
+    if (maybePaginatedResponse.pagination) {
+      return response;
+    }
+
+    const total = response.documents.length;
+    return {
+      ...response,
+      pagination: {
+        page: 1,
+        pageSize: total,
+        total,
+        totalPages: total > 0 ? 1 : 0,
+      },
+    };
+  }
+
   private createChunkListRequestConfig(
     params?: DocumentChunkListParams,
   ): RequestConfig | undefined {