@01.software/sdk 0.1.0-dev.260206.8918543 → 0.1.0-dev.260210.4ecca43

package/README.md

@@ -104,6 +104,41 @@ const { data } = await client.from('products').update('id', { name: 'Updated' })
 await client.from('products').remove('id')
 ```
 
+### API Response Structure
+
+All SDK methods return a standardized response format:
+
+```typescript
+// Success Response
+interface ApiSuccessResponse<T> {
+  data: T                    // Actual data
+  success: true
+  message?: string           // Optional message from server
+  pagination?: PaginationMeta // For list queries
+}
+
+// Error Response
+interface ApiErrorResponse {
+  data: null
+  success: false
+  error: {
+    code: string
+    message: string
+    details?: unknown
+  }
+}
+```
+
+**Payload CMS API Mapping:**
+
+| Operation | Payload Response | SDK Response |
+|-----------|-----------------|--------------|
+| `find()` | `{docs: [], totalDocs, ...}` | `{data: [], success: true, pagination: {...}}` |
+| `findById()` | `{...document}` | `{data: {...}, success: true}` |
+| `create()` | `{doc: {...}, message}` | `{data: {...}, success: true, message}` |
+| `update()` | `{doc: {...}, message}` | `{data: {...}, success: true, message}` |
+| `remove()` | `{doc: {...}, message}` | `{data: {...}, success: true, message}` |
+
 ### React Query Hooks
 
 ```typescript

package/dist/index.cjs

@@ -106,10 +106,8 @@ __export(index_exports, {
   handleWebhook: () => handleWebhook,
   isApiError: () => isApiError,
   isConfigError: () => isConfigError,
-  isErrorResponse: () => isErrorResponse,
   isNetworkError: () => isNetworkError,
   isSDKError: () => isSDKError,
-  isSuccessResponse: () => isSuccessResponse,
   isTimeoutError: () => isTimeoutError,
   isValidWebhookEvent: () => isValidWebhookEvent,
   isValidationError: () => isValidationError,
@@ -125,38 +123,89 @@ var CollectionQueryBuilder = class {
     this.api = api;
     this.collection = collection;
   }
+  /**
+   * Find documents (list query)
+   * GET /api/{collection}
+   * @returns Payload CMS find response with docs array and pagination
+   */
   find(options) {
     return __async(this, null, function* () {
-      return this.api.requestGet(
+      return this.api.requestFind(
         `/api/${String(this.collection)}`,
         options
       );
     });
   }
+  /**
+   * Find document by ID
+   * GET /api/{collection}/{id}
+   * @returns Document object directly (no wrapper)
+   */
   findById(id, options) {
     return __async(this, null, function* () {
-      return this.api.requestGet(
+      return this.api.requestFindById(
         `/api/${String(this.collection)}/${String(id)}`,
         options
       );
     });
   }
+  /**
+   * Create a new document
+   * POST /api/{collection}
+   * @returns Payload CMS mutation response with doc and message
+   */
   create(data) {
     return __async(this, null, function* () {
-      return this.api.requestPost(
+      return this.api.requestCreate(
         `/api/${String(this.collection)}`,
         data
       );
     });
   }
+  /**
+   * Update a document by ID
+   * PATCH /api/{collection}/{id}
+   * @returns Payload CMS mutation response with doc and message
+   */
   update(id, data) {
     return __async(this, null, function* () {
-      return this.api.requestPatch(
+      return this.api.requestUpdate(
         `/api/${String(this.collection)}/${String(id)}`,
         data
       );
     });
   }
+  /**
+   * Count documents
+   * GET /api/{collection}/count
+   * @returns Count response with totalDocs
+   */
+  count(options) {
+    return __async(this, null, function* () {
+      return this.api.requestCount(
+        `/api/${String(this.collection)}/count`,
+        options
+      );
+    });
+  }
+  /**
+   * Update multiple documents (bulk update)
+   * PATCH /api/{collection}
+   * @returns Payload CMS find response with updated docs
+   */
+  updateMany(where, data) {
+    return __async(this, null, function* () {
+      return this.api.requestUpdateMany(
+        `/api/${String(this.collection)}`,
+        { where, data }
+      );
+    });
+  }
+  /**
+   * Delete a document by ID
+   * DELETE /api/{collection}/{id}
+   * @returns Deleted document object directly (no wrapper)
+   */
   remove(id) {
     return __async(this, null, function* () {
       return this.api.requestDelete(
@@ -164,14 +213,24 @@ var CollectionQueryBuilder = class {
       );
     });
   }
+  /**
+   * Delete multiple documents (bulk delete)
+   * DELETE /api/{collection}
+   * @returns Payload CMS find response with deleted docs
+   */
+  removeMany(where) {
+    return __async(this, null, function* () {
+      return this.api.requestDeleteMany(
+        `/api/${String(this.collection)}`,
+        { where }
+      );
+    });
+  }
 };
 
 // src/core/collection/base.ts
 var import_qs_esm = require("qs-esm");
 
-// src/core/internal/utils/index.ts
-var import_jose = require("jose");
-
 // src/core/internal/errors/index.ts
 var SDKError = class _SDKError extends Error {
   constructor(code, message, status, details, userMessage, suggestion) {
@@ -253,6 +312,112 @@ var createNetworkError = (message, status, details, userMessage, suggestion) =>
 var createValidationError = (message, details, userMessage, suggestion) => new ValidationError(message, details, userMessage, suggestion);
 var createApiError = (message, status, details, userMessage, suggestion) => new ApiError(message, status, details, userMessage, suggestion);
 
+// src/core/collection/base.ts
+var BaseApiClient = class {
+  constructor(clientKey, secretKey, baseUrl) {
+    if (!clientKey) {
+      throw createValidationError("clientKey\uB294 \uD544\uC218\uC785\uB2C8\uB2E4.");
+    }
+    this.clientKey = clientKey;
+    this.secretKey = secretKey;
+    this.baseUrl = baseUrl;
+    this.defaultOptions = { clientKey, secretKey, baseUrl };
+  }
+  buildUrl(endpoint, options) {
+    if (!options) return endpoint;
+    const queryString = (0, import_qs_esm.stringify)(options, { addQueryPrefix: true });
+    return queryString ? `${endpoint}${queryString}` : endpoint;
+  }
+  /**
+   * Parse Payload CMS find response (list query)
+   * Returns native Payload response structure
+   */
+  parseFindResponse(response) {
+    return __async(this, null, function* () {
+      var _a, _b;
+      const contentType = response.headers.get("content-type");
+      try {
+        if (!(contentType == null ? void 0 : contentType.includes("application/json"))) {
+          throw createApiError("\uC751\uB2F5\uC774 JSON \uD615\uC2DD\uC774 \uC544\uB2D9\uB2C8\uB2E4.", response.status, { contentType });
+        }
+        const jsonData = yield response.json();
+        if (jsonData.docs === void 0) {
+          throw createApiError("\uC720\uD6A8\uD558\uC9C0 \uC54A\uC740 find \uC751\uB2F5\uC785\uB2C8\uB2E4.", response.status, { jsonData });
+        }
+        return {
+          docs: jsonData.docs,
+          totalDocs: jsonData.totalDocs || 0,
+          limit: jsonData.limit || 20,
+          totalPages: jsonData.totalPages || 0,
+          page: jsonData.page || 1,
+          pagingCounter: jsonData.pagingCounter || 1,
+          hasPrevPage: jsonData.hasPrevPage || false,
+          hasNextPage: jsonData.hasNextPage || false,
+          prevPage: (_a = jsonData.prevPage) != null ? _a : null,
+          nextPage: (_b = jsonData.nextPage) != null ? _b : null
+        };
+      } catch (error) {
+        throw createApiError("\uC751\uB2F5 \uD30C\uC2F1\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4.", response.status, {
+          contentType,
+          error: error instanceof Error ? error.message : error
+        });
+      }
+    });
+  }
+  /**
+   * Parse Payload CMS mutation response (create/update)
+   * Returns native Payload response structure
+   */
+  parseMutationResponse(response) {
+    return __async(this, null, function* () {
+      const contentType = response.headers.get("content-type");
+      try {
+        if (!(contentType == null ? void 0 : contentType.includes("application/json"))) {
+          throw createApiError("\uC751\uB2F5\uC774 JSON \uD615\uC2DD\uC774 \uC544\uB2D9\uB2C8\uB2E4.", response.status, { contentType });
+        }
+        const jsonData = yield response.json();
+        if (jsonData.doc === void 0) {
+          throw createApiError("\uC720\uD6A8\uD558\uC9C0 \uC54A\uC740 mutation \uC751\uB2F5\uC785\uB2C8\uB2E4.", response.status, { jsonData });
+        }
+        return {
+          message: jsonData.message || "",
+          doc: jsonData.doc,
+          errors: jsonData.errors
+        };
+      } catch (error) {
+        throw createApiError("\uC751\uB2F5 \uD30C\uC2F1\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4.", response.status, {
+          contentType,
+          error: error instanceof Error ? error.message : error
+        });
+      }
+    });
+  }
+  /**
+   * Parse Payload CMS document response (findById/delete)
+   * Returns document directly without wrapper
+   */
+  parseDocumentResponse(response) {
+    return __async(this, null, function* () {
+      const contentType = response.headers.get("content-type");
+      try {
+        if (!(contentType == null ? void 0 : contentType.includes("application/json"))) {
+          throw createApiError("\uC751\uB2F5\uC774 JSON \uD615\uC2DD\uC774 \uC544\uB2D9\uB2C8\uB2E4.", response.status, { contentType });
+        }
+        const jsonData = yield response.json();
+        return jsonData;
+      } catch (error) {
+        throw createApiError("\uC751\uB2F5 \uD30C\uC2F1\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4.", response.status, {
+          contentType,
+          error: error instanceof Error ? error.message : error
+        });
+      }
+    });
+  }
+};
+
+// src/core/internal/utils/index.ts
+var import_jose = require("jose");
+
 // src/core/client/types.ts
 var API_URLS = {
   local: "http://localhost:3000",
@@ -273,12 +438,6 @@ function resolveApiUrl(config) {
   }
   return API_URLS.production;
 }
-function isSuccessResponse(response) {
-  return response.success === true;
-}
-function isErrorResponse(response) {
-  return response.success === false;
-}
 
 // src/core/internal/utils/index.ts
 var DEFAULT_TIMEOUT = 3e4;
@@ -510,105 +669,113 @@ function _fetch(url, options) {
   });
 }
 
-// src/core/collection/base.ts
-var BaseApiClient = class {
+// src/core/collection/collections-api.ts
+var CollectionsApi = class extends BaseApiClient {
   constructor(clientKey, secretKey, baseUrl) {
-    if (!clientKey) {
-      throw createValidationError("clientKey\uB294 \uD544\uC218\uC785\uB2C8\uB2E4.");
-    }
-    this.clientKey = clientKey;
-    this.secretKey = secretKey;
-    this.baseUrl = baseUrl;
-    this.defaultOptions = { clientKey, secretKey, baseUrl };
+    super(clientKey, secretKey, baseUrl);
   }
-  get(endpoint, options) {
+  from(collection) {
+    return new CollectionQueryBuilder(this, collection);
+  }
+  // ============================================================================
+  // New Payload-native methods
+  // ============================================================================
+  /**
+   * Find documents (list query)
+   * GET /api/{collection}
+   */
+  requestFind(endpoint, options) {
     return __async(this, null, function* () {
       const url = this.buildUrl(endpoint, options);
       const response = yield _fetch(url, __spreadProps(__spreadValues({}, this.defaultOptions), { method: "GET" }));
-      return this.parseResponse(response);
+      return this.parseFindResponse(response);
     });
   }
-  post(endpoint, data, options) {
+  /**
+   * Find document by ID
+   * GET /api/{collection}/{id}
+   */
+  requestFindById(endpoint, options) {
     return __async(this, null, function* () {
-      const response = yield _fetch(endpoint, __spreadProps(__spreadValues(__spreadValues({}, this.defaultOptions), options), {
+      const url = this.buildUrl(endpoint, options);
+      const response = yield _fetch(url, __spreadProps(__spreadValues({}, this.defaultOptions), { method: "GET" }));
+      return this.parseDocumentResponse(response);
+    });
+  }
+  /**
+   * Create document
+   * POST /api/{collection}
+   */
+  requestCreate(endpoint, data) {
+    return __async(this, null, function* () {
+      const response = yield _fetch(endpoint, __spreadProps(__spreadValues({}, this.defaultOptions), {
         method: "POST",
         body: data ? JSON.stringify(data) : void 0
       }));
-      return this.parseResponse(response);
+      return this.parseMutationResponse(response);
     });
   }
-  patch(endpoint, data, options) {
+  /**
+   * Update document
+   * PATCH /api/{collection}/{id}
+   */
+  requestUpdate(endpoint, data) {
     return __async(this, null, function* () {
-      const response = yield _fetch(endpoint, __spreadProps(__spreadValues(__spreadValues({}, this.defaultOptions), options), {
+      const response = yield _fetch(endpoint, __spreadProps(__spreadValues({}, this.defaultOptions), {
         method: "PATCH",
         body: data ? JSON.stringify(data) : void 0
       }));
-      return this.parseResponse(response);
+      return this.parseMutationResponse(response);
     });
   }
-  delete(endpoint, options) {
+  /**
+   * Count documents
+   * GET /api/{collection}/count
+   */
+  requestCount(endpoint, options) {
     return __async(this, null, function* () {
-      const response = yield _fetch(endpoint, __spreadProps(__spreadValues(__spreadValues({}, this.defaultOptions), options), {
-        method: "DELETE"
-      }));
-      return this.parseResponse(response);
+      const url = this.buildUrl(endpoint, options);
+      const response = yield _fetch(url, __spreadProps(__spreadValues({}, this.defaultOptions), { method: "GET" }));
+      return this.parseDocumentResponse(response);
     });
   }
-  buildUrl(endpoint, options) {
-    if (!options) return endpoint;
-    const queryString = (0, import_qs_esm.stringify)(options, { addQueryPrefix: true });
-    return queryString ? `${endpoint}${queryString}` : endpoint;
-  }
-  parseResponse(response) {
+  /**
+   * Update multiple documents (bulk update)
+   * PATCH /api/{collection}
+   */
+  requestUpdateMany(endpoint, data) {
     return __async(this, null, function* () {
-      const contentType = response.headers.get("content-type");
-      try {
-        if (contentType == null ? void 0 : contentType.includes("application/json")) {
-          const jsonData = yield response.json();
-          if (jsonData.docs !== void 0) {
-            const pagination = {
-              page: jsonData.page || 1,
-              limit: jsonData.limit || 20,
-              totalDocs: jsonData.totalDocs || 0,
-              totalPages: jsonData.totalPages || 0,
-              hasNextPage: jsonData.hasNextPage || false,
-              hasPrevPage: jsonData.hasPrevPage || false
-            };
-            return { data: jsonData.docs, success: true, pagination };
-          }
-          return { data: jsonData, success: true };
-        }
-        const textData = yield response.text();
-        return { data: textData, success: true };
-      } catch (error) {
-        throw createApiError("\uC751\uB2F5 \uD30C\uC2F1\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4.", response.status, {
-          contentType,
-          error: error instanceof Error ? error.message : error
-        });
-      }
+      const response = yield _fetch(endpoint, __spreadProps(__spreadValues({}, this.defaultOptions), {
+        method: "PATCH",
+        body: JSON.stringify(data)
+      }));
+      return this.parseFindResponse(response);
     });
   }
-};
-
-// src/core/collection/collections-api.ts
-var CollectionsApi = class extends BaseApiClient {
-  constructor(clientKey, secretKey, baseUrl) {
-    super(clientKey, secretKey, baseUrl);
-  }
-  from(collection) {
-    return new CollectionQueryBuilder(this, collection);
-  }
-  requestGet(endpoint, options) {
-    return this.get(endpoint, options);
-  }
-  requestPost(endpoint, data) {
-    return this.post(endpoint, data);
-  }
-  requestPatch(endpoint, data) {
-    return this.patch(endpoint, data);
-  }
+  /**
+   * Delete document
+   * DELETE /api/{collection}/{id}
+   */
   requestDelete(endpoint) {
-    return this.delete(endpoint);
+    return __async(this, null, function* () {
+      const response = yield _fetch(endpoint, __spreadProps(__spreadValues({}, this.defaultOptions), {
+        method: "DELETE"
+      }));
+      return this.parseDocumentResponse(response);
+    });
+  }
+  /**
+   * Delete multiple documents (bulk delete)
+   * DELETE /api/{collection}
+   */
+  requestDeleteMany(endpoint, data) {
+    return __async(this, null, function* () {
+      const response = yield _fetch(endpoint, __spreadProps(__spreadValues({}, this.defaultOptions), {
+        method: "DELETE",
+        body: JSON.stringify(data)
+      }));
+      return this.parseFindResponse(response);
+    });
   }
 };
 
@@ -702,7 +869,7 @@ var UnifiedQueryClient = class {
       queryFn: () => __async(this, null, function* () {
         var _a;
         const response = yield this.collectionsApi.from(collection).find(queryOptions);
-        return (_a = response.data) != null ? _a : [];
+        return (_a = response.docs) != null ? _a : [];
       })
     }, options));
   }
@@ -714,7 +881,7 @@ var UnifiedQueryClient = class {
       queryFn: () => __async(this, null, function* () {
         var _a;
         const response = yield this.collectionsApi.from(collection).find(queryOptions);
-        return (_a = response.data) != null ? _a : [];
+        return (_a = response.docs) != null ? _a : [];
       })
     }, options));
   }
@@ -724,9 +891,7 @@ var UnifiedQueryClient = class {
     return (0, import_react_query2.useQuery)(__spreadValues({
       queryKey: collectionKeys(collection).detail(id, queryOptions),
       queryFn: () => __async(this, null, function* () {
-        var _a;
-        const response = yield this.collectionsApi.from(collection).findById(id, queryOptions);
-        return (_a = response.data) != null ? _a : null;
+        return yield this.collectionsApi.from(collection).findById(id, queryOptions);
       })
     }, options));
   }
@@ -736,9 +901,7 @@ var UnifiedQueryClient = class {
     return (0, import_react_query2.useSuspenseQuery)(__spreadValues({
       queryKey: collectionKeys(collection).detail(id, queryOptions),
       queryFn: () => __async(this, null, function* () {
-        var _a;
-        const response = yield this.collectionsApi.from(collection).findById(id, queryOptions);
-        return (_a = response.data) != null ? _a : null;
+        return yield this.collectionsApi.from(collection).findById(id, queryOptions);
       })
     }, options));
   }
@@ -748,14 +911,12 @@ var UnifiedQueryClient = class {
     return (0, import_react_query2.useInfiniteQuery)(__spreadValues({
       queryKey: collectionKeys(collection).infinite(queryOptions),
       queryFn: (_0) => __async(this, [_0], function* ({ pageParam }) {
-        var _a;
         const response = yield this.collectionsApi.from(collection).find(__spreadProps(__spreadValues({}, queryOptions), { page: pageParam, limit: pageSize }));
-        return (_a = response.data) != null ? _a : [];
+        return response;
       }),
       initialPageParam: 1,
-      getNextPageParam: (lastPage, _allPages, lastPageParam) => {
-        if (!Array.isArray(lastPage) || lastPage.length < pageSize) return void 0;
-        return lastPageParam + 1;
+      getNextPageParam: (lastPage) => {
+        return lastPage.hasNextPage ? lastPage.nextPage : void 0;
       }
     }, options));
   }
@@ -765,14 +926,12 @@ var UnifiedQueryClient = class {
     return (0, import_react_query2.useSuspenseInfiniteQuery)(__spreadValues({
       queryKey: collectionKeys(collection).infinite(queryOptions),
       queryFn: (_0) => __async(this, [_0], function* ({ pageParam }) {
-        var _a;
         const response = yield this.collectionsApi.from(collection).find(__spreadProps(__spreadValues({}, queryOptions), { page: pageParam, limit: pageSize }));
-        return (_a = response.data) != null ? _a : [];
+        return response;
       }),
       initialPageParam: 1,
-      getNextPageParam: (lastPage, _allPages, lastPageParam) => {
-        if (!Array.isArray(lastPage) || lastPage.length < pageSize) return void 0;
-        return lastPageParam + 1;
+      getNextPageParam: (lastPage) => {
+        return lastPage.hasNextPage ? lastPage.nextPage : void 0;
       }
     }, options));
   }
@@ -785,7 +944,7 @@ var UnifiedQueryClient = class {
         queryFn: () => __async(this, null, function* () {
           var _a;
           const response = yield this.collectionsApi.from(collection).find(queryOptions);
-          return (_a = response.data) != null ? _a : [];
+          return (_a = response.docs) != null ? _a : [];
         })
       }, options));
     });
@@ -797,9 +956,7 @@ var UnifiedQueryClient = class {
       return this.queryClient.prefetchQuery(__spreadValues({
         queryKey: collectionKeys(collection).detail(id, queryOptions),
         queryFn: () => __async(this, null, function* () {
-          var _a;
-          const response = yield this.collectionsApi.from(collection).findById(id, queryOptions);
-          return (_a = response.data) != null ? _a : null;
+          return yield this.collectionsApi.from(collection).findById(id, queryOptions);
         })
       }, options));
     });
@@ -812,14 +969,12 @@ var UnifiedQueryClient = class {
       return this.queryClient.prefetchInfiniteQuery({
         queryKey: collectionKeys(collection).infinite(queryOptions),
         queryFn: (_0) => __async(this, [_0], function* ({ pageParam }) {
-          var _a2;
           const response = yield this.collectionsApi.from(collection).find(__spreadProps(__spreadValues({}, queryOptions), { page: pageParam, limit: pageSize }));
-          return (_a2 = response.data) != null ? _a2 : [];
+          return response;
         }),
         initialPageParam: 1,
-        getNextPageParam: (lastPage, _allPages, lastPageParam) => {
-          if (!Array.isArray(lastPage) || lastPage.length < pageSize) return void 0;
-          return lastPageParam + 1;
+        getNextPageParam: (lastPage) => {
+          return lastPage.hasNextPage ? lastPage.nextPage : void 0;
         },
         pages: (_a = options == null ? void 0 : options.pages) != null ? _a : 1,
         staleTime: options == null ? void 0 : options.staleTime