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

package/dist/index.cjs

@@ -78,20 +78,21 @@ var __async = (__this, __arguments, generator) => {
 };
 
 // src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  ApiClient: () => ApiClient,
+var src_exports = {};
+__export(src_exports, {
   ApiError: () => ApiError,
   BrowserClient: () => BrowserClient,
   COLLECTIONS: () => COLLECTIONS,
+  CollectionClient: () => CollectionClient,
   CollectionQueryBuilder: () => CollectionQueryBuilder,
-  CollectionsApi: () => CollectionsApi,
   ConfigError: () => ConfigError,
   NetworkError: () => NetworkError,
+  OrderApi: () => OrderApi,
+  QueryHooks: () => QueryHooks,
   RichTextContent: () => RichTextContent,
   ServerClient: () => ServerClient,
   TimeoutError: () => TimeoutError,
-  UnifiedQueryClient: () => UnifiedQueryClient,
+  UsageLimitError: () => UsageLimitError,
   ValidationError: () => ValidationError,
   collectionKeys: () => collectionKeys,
   createApiKey: () => createApiKey,
@@ -109,13 +110,15 @@ __export(index_exports, {
   isNetworkError: () => isNetworkError,
   isSDKError: () => isSDKError,
   isTimeoutError: () => isTimeoutError,
+  isUsageLimitError: () => isUsageLimitError,
   isValidWebhookEvent: () => isValidWebhookEvent,
   isValidationError: () => isValidationError,
   objectFor: () => objectFor,
   parseApiKey: () => parseApiKey,
+  resolveRelation: () => resolveRelation,
   verifyServerToken: () => verifyServerToken
 });
-module.exports = __toCommonJS(index_exports);
+module.exports = __toCommonJS(src_exports);
 
 // src/core/collection/query-builder.ts
 var CollectionQueryBuilder = class {
@@ -228,7 +231,7 @@ var CollectionQueryBuilder = class {
   }
 };
 
-// src/core/collection/base.ts
+// src/core/collection/http-client.ts
 var import_qs_esm = require("qs-esm");
 
 // src/core/internal/errors/index.ts
@@ -285,11 +288,23 @@ var ConfigError = class extends SDKError {
   }
 };
 var TimeoutError = class extends SDKError {
-  constructor(message = "\uC694\uCCAD\uC774 \uC2DC\uAC04 \uCD08\uACFC\uB418\uC5C8\uC2B5\uB2C8\uB2E4.", details, userMessage, suggestion) {
+  constructor(message = "Request timed out.", details, userMessage, suggestion) {
     super("TIMEOUT_ERROR", message, 408, details, userMessage, suggestion);
     this.name = "TimeoutError";
   }
 };
+var UsageLimitError = class extends SDKError {
+  constructor(message, usage, details, userMessage, suggestion) {
+    super("USAGE_LIMIT_ERROR", message, 429, details, userMessage, suggestion);
+    this.name = "UsageLimitError";
+    this.usage = usage;
+  }
+  toJSON() {
+    return __spreadProps(__spreadValues({}, super.toJSON()), {
+      usage: this.usage
+    });
+  }
+};
 function isSDKError(error) {
   return error instanceof SDKError;
 }
@@ -308,15 +323,20 @@ function isConfigError(error) {
 function isTimeoutError(error) {
   return error instanceof TimeoutError;
 }
+function isUsageLimitError(error) {
+  return error instanceof UsageLimitError;
+}
 var createNetworkError = (message, status, details, userMessage, suggestion) => new NetworkError(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);
+var createTimeoutError = (message, details, userMessage, suggestion) => new TimeoutError(message, details, userMessage, suggestion);
+var createUsageLimitError = (message, usage, details, userMessage, suggestion) => new UsageLimitError(message, usage, details, userMessage, suggestion);
 
-// src/core/collection/base.ts
-var BaseApiClient = class {
+// src/core/collection/http-client.ts
+var HttpClient = class {
   constructor(clientKey, secretKey, baseUrl) {
     if (!clientKey) {
-      throw createValidationError("clientKey\uB294 \uD544\uC218\uC785\uB2C8\uB2E4.");
+      throw createValidationError("clientKey is required.");
     }
     this.clientKey = clientKey;
     this.secretKey = secretKey;
@@ -328,6 +348,12 @@ var BaseApiClient = class {
     const queryString = (0, import_qs_esm.stringify)(options, { addQueryPrefix: true });
     return queryString ? `${endpoint}${queryString}` : endpoint;
   }
+  assertJsonResponse(response) {
+    const contentType = response.headers.get("content-type");
+    if (!(contentType == null ? void 0 : contentType.includes("application/json"))) {
+      throw createApiError("Response is not in JSON format.", response.status, { contentType });
+    }
+  }
   /**
    * Parse Payload CMS find response (list query)
    * Returns native Payload response structure
@@ -337,12 +363,10 @@ var BaseApiClient = class {
       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 });
-        }
+        this.assertJsonResponse(response);
         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 });
+          throw createApiError("Invalid find response.", response.status, { jsonData });
         }
         return {
           docs: jsonData.docs,
@@ -357,7 +381,7 @@ var BaseApiClient = class {
           nextPage: (_b = jsonData.nextPage) != null ? _b : null
         };
       } catch (error) {
-        throw createApiError("\uC751\uB2F5 \uD30C\uC2F1\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4.", response.status, {
+        throw createApiError("Failed to parse response.", response.status, {
           contentType,
           error: error instanceof Error ? error.message : error
         });
@@ -372,12 +396,10 @@ var BaseApiClient = class {
     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 });
-        }
+        this.assertJsonResponse(response);
         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 });
+          throw createApiError("Invalid mutation response.", response.status, { jsonData });
         }
         return {
           message: jsonData.message || "",
@@ -385,7 +407,7 @@ var BaseApiClient = class {
           errors: jsonData.errors
         };
       } catch (error) {
-        throw createApiError("\uC751\uB2F5 \uD30C\uC2F1\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4.", response.status, {
+        throw createApiError("Failed to parse response.", response.status, {
           contentType,
           error: error instanceof Error ? error.message : error
         });
@@ -400,13 +422,11 @@ var BaseApiClient = class {
     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 });
-        }
+        this.assertJsonResponse(response);
         const jsonData = yield response.json();
         return jsonData;
       } catch (error) {
-        throw createApiError("\uC751\uB2F5 \uD30C\uC2F1\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4.", response.status, {
+        throw createApiError("Failed to parse response.", response.status, {
           contentType,
           error: error instanceof Error ? error.message : error
         });
@@ -442,10 +462,11 @@ function resolveApiUrl(config) {
 // src/core/internal/utils/index.ts
 var DEFAULT_TIMEOUT = 3e4;
 var DEFAULT_RETRYABLE_STATUSES = [408, 429, 500, 502, 503, 504];
+var NON_RETRYABLE_STATUSES = [401, 403, 404, 422];
 function createServerToken(clientKey, secretKey, expiresIn = "1h") {
   return __async(this, null, function* () {
     if (!clientKey || !secretKey) {
-      throw new Error("clientKey\uC640 secretKey\uB294 \uD544\uC218\uC785\uB2C8\uB2E4.");
+      throw new Error("clientKey and secretKey are required.");
     }
     const secret = new TextEncoder().encode(secretKey);
     return new import_jose.SignJWT({ clientKey }).setProtectedHeader({ alg: "HS256" }).setIssuedAt().setExpirationTime(expiresIn).sign(secret);
@@ -454,7 +475,7 @@ function createServerToken(clientKey, secretKey, expiresIn = "1h") {
 function verifyServerToken(token, secretKey) {
   return __async(this, null, function* () {
     if (!token || !secretKey) {
-      throw new Error("token\uACFC secretKey\uB294 \uD544\uC218\uC785\uB2C8\uB2E4.");
+      throw new Error("token and secretKey are required.");
     }
     const secret = new TextEncoder().encode(secretKey);
     const { payload } = yield (0, import_jose.jwtVerify)(token, secret, {
@@ -472,7 +493,7 @@ function verifyServerToken(token, secretKey) {
 }
 function decodeServerToken(token) {
   if (!token) {
-    throw new Error("token\uC740 \uD544\uC218\uC785\uB2C8\uB2E4.");
+    throw new Error("token is required.");
   }
   const payload = (0, import_jose.decodeJwt)(token);
   if (!payload.clientKey || typeof payload.clientKey !== "string") {
@@ -486,7 +507,7 @@ function decodeServerToken(token) {
 }
 function createApiKey(clientKey, secretKey) {
   if (!clientKey || !secretKey) {
-    throw new Error("clientKey\uC640 secretKey\uB294 \uD544\uC218\uC785\uB2C8\uB2E4.");
+    throw new Error("clientKey and secretKey are required.");
   }
   if (typeof Buffer !== "undefined") {
     return Buffer.from(`${clientKey}:${secretKey}`).toString("base64");
@@ -495,7 +516,7 @@ function createApiKey(clientKey, secretKey) {
 }
 function parseApiKey(apiKey) {
   if (!apiKey) {
-    throw new Error("apiKey\uB294 \uD544\uC218\uC785\uB2C8\uB2E4.");
+    throw new Error("apiKey is required.");
   }
   try {
     let decoded;
@@ -506,12 +527,12 @@ function parseApiKey(apiKey) {
     }
     const colonIndex = decoded.indexOf(":");
     if (colonIndex === -1) {
-      throw new Error("Invalid format");
+      throw new Error("Invalid format: missing colon separator");
     }
     const clientKey = decoded.substring(0, colonIndex);
     const secretKey = decoded.substring(colonIndex + 1);
     if (!clientKey || !secretKey) {
-      throw new Error("Invalid format");
+      throw new Error("Invalid format: empty clientKey or secretKey");
     }
     return { clientKey, secretKey };
   } catch (e) {
@@ -528,10 +549,10 @@ function debugLog(debug, type, message, data) {
   }
 }
 function getErrorSuggestion(status) {
-  if (status === 401) return "\uC778\uC99D \uC815\uBCF4\uB97C \uD655\uC778\uD574\uC8FC\uC138\uC694.";
-  if (status === 404) return "\uC694\uCCAD\uD55C \uB9AC\uC18C\uC2A4\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.";
+  if (status === 401) return "Please check your authentication credentials.";
+  if (status === 404) return "The requested resource was not found.";
   if (status >= 500)
-    return "\uC11C\uBC84 \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4. \uC7A0\uC2DC \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574\uC8FC\uC138\uC694.";
+    return "A server error occurred. Please try again later.";
   return void 0;
 }
 function delay(ms) {
@@ -562,6 +583,10 @@ function _fetch(url, options) {
       retryableStatuses: (_c = retry == null ? void 0 : retry.retryableStatuses) != null ? _c : DEFAULT_RETRYABLE_STATUSES,
       retryDelay: (_d = retry == null ? void 0 : retry.retryDelay) != null ? _d : ((attempt) => Math.min(1e3 * __pow(2, attempt), 1e4))
     };
+    let authToken;
+    if (secretKey && clientKey) {
+      authToken = yield createServerToken(clientKey, secretKey);
+    }
     let lastError;
     for (let attempt = 0; attempt <= retryConfig.maxRetries; attempt++) {
       try {
@@ -569,9 +594,8 @@ function _fetch(url, options) {
         if (clientKey) {
           headers.set("X-Client-Key", clientKey);
         }
-        if (secretKey && clientKey) {
-          const token = yield createServerToken(clientKey, secretKey);
-          headers.set("Authorization", `Bearer ${token}`);
+        if (authToken) {
+          headers.set("Authorization", `Bearer ${authToken}`);
         }
         if (!headers.has("Content-Type") && requestInit.body) {
           headers.set("Content-Type", "application/json");
@@ -594,17 +618,38 @@ function _fetch(url, options) {
           headers: Object.fromEntries(response.headers.entries())
         });
         if (!response.ok) {
+          if (response.status === 429 && response.headers.get("X-Usage-Limit")) {
+            const limit = parseInt(response.headers.get("X-Usage-Limit") || "0", 10);
+            const current = parseInt(response.headers.get("X-Usage-Current") || "0", 10);
+            const remaining = parseInt(response.headers.get("X-Usage-Remaining") || "0", 10);
+            throw createUsageLimitError(
+              `Monthly API usage limit exceeded (${current.toLocaleString()}/${limit.toLocaleString()})`,
+              { limit, current, remaining },
+              { url, method: requestInit.method || "GET", attempt: attempt + 1 },
+              "Monthly API call limit exceeded. Please upgrade your plan.",
+              "Upgrade your tenant plan to increase the monthly API call limit."
+            );
+          }
+          if (NON_RETRYABLE_STATUSES.includes(response.status)) {
+            throw createNetworkError(
+              `HTTP ${response.status}: ${response.statusText}`,
+              response.status,
+              { url, method: requestInit.method || "GET", attempt: attempt + 1 },
+              `Request failed (status: ${response.status})`,
+              getErrorSuggestion(response.status)
+            );
+          }
           const error = createNetworkError(
             `HTTP ${response.status}: ${response.statusText}`,
             response.status,
             { url, method: requestInit.method || "GET", attempt: attempt + 1 },
-            `\uC694\uCCAD\uC774 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4 (\uC0C1\uD0DC \uCF54\uB4DC: ${response.status})`,
+            `Request failed (status: ${response.status})`,
             getErrorSuggestion(response.status)
           );
           if (attempt < retryConfig.maxRetries && retryConfig.retryableStatuses.includes(response.status)) {
             lastError = error;
             const retryDelay = retryConfig.retryDelay(attempt);
-            debugLog(debug, "error", `\uC7AC\uC2DC\uB3C4 \uB300\uAE30 \uC911... (${retryDelay}ms)`, error);
+            debugLog(debug, "error", `Retrying in ${retryDelay}ms...`, error);
             yield delay(retryDelay);
             continue;
           }
@@ -614,11 +659,11 @@ function _fetch(url, options) {
       } catch (error) {
         debugLog(debug, "error", url, error);
         if (error instanceof Error && error.name === "AbortError") {
-          const timeoutError = new TimeoutError(
-            `\uC694\uCCAD\uC774 ${timeout}ms \uD6C4 \uD0C0\uC784\uC544\uC6C3\uB418\uC5C8\uC2B5\uB2C8\uB2E4.`,
+          const timeoutError = createTimeoutError(
+            `Request timed out after ${timeout}ms.`,
             { url, timeout, attempt: attempt + 1 },
-            "\uC694\uCCAD \uC2DC\uAC04\uC774 \uCD08\uACFC\uB418\uC5C8\uC2B5\uB2C8\uB2E4.",
-            "\uB124\uD2B8\uC6CC\uD06C \uC5F0\uACB0\uC744 \uD655\uC778\uD558\uAC70\uB098 \uC7A0\uC2DC \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574\uC8FC\uC138\uC694."
+            "The request timed out.",
+            "Please check your network connection or try again later."
           );
           if (attempt < retryConfig.maxRetries) {
             lastError = timeoutError;
@@ -629,11 +674,11 @@ function _fetch(url, options) {
         }
         if (error instanceof TypeError) {
           const networkError = createNetworkError(
-            "\uB124\uD2B8\uC6CC\uD06C \uC5F0\uACB0\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4.",
+            "Network connection failed.",
             void 0,
             { url, originalError: error.message, attempt: attempt + 1 },
-            "\uB124\uD2B8\uC6CC\uD06C \uC5F0\uACB0\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4.",
-            "\uC778\uD130\uB137 \uC5F0\uACB0\uC744 \uD655\uC778\uD558\uACE0 \uB2E4\uC2DC \uC2DC\uB3C4\uD574\uC8FC\uC138\uC694."
+            "Network connection failed.",
+            "Please check your internet connection and try again."
           );
           if (attempt < retryConfig.maxRetries) {
             lastError = networkError;
@@ -643,7 +688,7 @@ function _fetch(url, options) {
           throw networkError;
         }
         if (error instanceof NetworkError || error instanceof TimeoutError) {
-          if (attempt < retryConfig.maxRetries && error.status && retryConfig.retryableStatuses.includes(error.status)) {
+          if (attempt < retryConfig.maxRetries && error.status && !NON_RETRYABLE_STATUSES.includes(error.status) && retryConfig.retryableStatuses.includes(error.status)) {
             lastError = error;
             yield delay(retryConfig.retryDelay(attempt));
             continue;
@@ -651,11 +696,11 @@ function _fetch(url, options) {
           throw error;
         }
         const unknownError = createNetworkError(
-          error instanceof Error ? error.message : "\uC54C \uC218 \uC5C6\uB294 \uB124\uD2B8\uC6CC\uD06C \uC5D0\uB7EC\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4.",
+          error instanceof Error ? error.message : "An unknown network error occurred.",
           void 0,
           { url, originalError: error, attempt: attempt + 1 },
-          "\uC54C \uC218 \uC5C6\uB294 \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4.",
-          "\uC7A0\uC2DC \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574\uC8FC\uC138\uC694."
+          "An unknown error occurred.",
+          "Please try again later."
         );
         if (attempt < retryConfig.maxRetries) {
           lastError = unknownError;
@@ -669,8 +714,8 @@ function _fetch(url, options) {
   });
 }
 
-// src/core/collection/collections-api.ts
-var CollectionsApi = class extends BaseApiClient {
+// src/core/collection/collection-client.ts
+var CollectionClient = class extends HttpClient {
   constructor(clientKey, secretKey, baseUrl) {
     super(clientKey, secretKey, baseUrl);
   }
@@ -678,7 +723,7 @@ var CollectionsApi = class extends BaseApiClient {
     return new CollectionQueryBuilder(this, collection);
   }
   // ============================================================================
-  // New Payload-native methods
+  // Payload-native methods
   // ============================================================================
   /**
    * Find documents (list query)
@@ -842,7 +887,7 @@ function getQueryClient() {
   return browserQueryClient;
 }
 
-// src/core/query/UnifiedQuery.ts
+// src/core/query/query-hooks.ts
 var import_react_query2 = require("@tanstack/react-query");
 function collectionKeys(collection) {
   return {
@@ -856,10 +901,10 @@ function collectionKeys(collection) {
   };
 }
 var DEFAULT_PAGE_SIZE = 20;
-var UnifiedQueryClient = class {
-  constructor(queryClient, options) {
+var QueryHooks = class {
+  constructor(queryClient, collectionClient) {
     this.queryClient = queryClient;
-    this.collectionsApi = new CollectionsApi((options == null ? void 0 : options.clientKey) || "", void 0, options == null ? void 0 : options.baseUrl);
+    this.collectionClient = collectionClient;
   }
   // ===== useQuery =====
   useQuery(params, options) {
@@ -868,7 +913,7 @@ var UnifiedQueryClient = class {
       queryKey: collectionKeys(collection).list(queryOptions),
       queryFn: () => __async(this, null, function* () {
         var _a;
-        const response = yield this.collectionsApi.from(collection).find(queryOptions);
+        const response = yield this.collectionClient.from(collection).find(queryOptions);
         return (_a = response.docs) != null ? _a : [];
       })
     }, options));
@@ -880,7 +925,7 @@ var UnifiedQueryClient = class {
       queryKey: collectionKeys(collection).list(queryOptions),
       queryFn: () => __async(this, null, function* () {
         var _a;
-        const response = yield this.collectionsApi.from(collection).find(queryOptions);
+        const response = yield this.collectionClient.from(collection).find(queryOptions);
         return (_a = response.docs) != null ? _a : [];
       })
     }, options));
@@ -891,7 +936,7 @@ var UnifiedQueryClient = class {
     return (0, import_react_query2.useQuery)(__spreadValues({
       queryKey: collectionKeys(collection).detail(id, queryOptions),
       queryFn: () => __async(this, null, function* () {
-        return yield this.collectionsApi.from(collection).findById(id, queryOptions);
+        return yield this.collectionClient.from(collection).findById(id, queryOptions);
       })
     }, options));
   }
@@ -901,7 +946,7 @@ var UnifiedQueryClient = class {
     return (0, import_react_query2.useSuspenseQuery)(__spreadValues({
       queryKey: collectionKeys(collection).detail(id, queryOptions),
       queryFn: () => __async(this, null, function* () {
-        return yield this.collectionsApi.from(collection).findById(id, queryOptions);
+        return yield this.collectionClient.from(collection).findById(id, queryOptions);
       })
     }, options));
   }
@@ -911,7 +956,7 @@ var UnifiedQueryClient = class {
     return (0, import_react_query2.useInfiniteQuery)(__spreadValues({
       queryKey: collectionKeys(collection).infinite(queryOptions),
       queryFn: (_0) => __async(this, [_0], function* ({ pageParam }) {
-        const response = yield this.collectionsApi.from(collection).find(__spreadProps(__spreadValues({}, queryOptions), { page: pageParam, limit: pageSize }));
+        const response = yield this.collectionClient.from(collection).find(__spreadProps(__spreadValues({}, queryOptions), { page: pageParam, limit: pageSize }));
         return response;
       }),
       initialPageParam: 1,
@@ -926,7 +971,7 @@ var UnifiedQueryClient = class {
     return (0, import_react_query2.useSuspenseInfiniteQuery)(__spreadValues({
       queryKey: collectionKeys(collection).infinite(queryOptions),
       queryFn: (_0) => __async(this, [_0], function* ({ pageParam }) {
-        const response = yield this.collectionsApi.from(collection).find(__spreadProps(__spreadValues({}, queryOptions), { page: pageParam, limit: pageSize }));
+        const response = yield this.collectionClient.from(collection).find(__spreadProps(__spreadValues({}, queryOptions), { page: pageParam, limit: pageSize }));
         return response;
       }),
       initialPageParam: 1,
@@ -943,7 +988,7 @@ var UnifiedQueryClient = class {
         queryKey: collectionKeys(collection).list(queryOptions),
         queryFn: () => __async(this, null, function* () {
           var _a;
-          const response = yield this.collectionsApi.from(collection).find(queryOptions);
+          const response = yield this.collectionClient.from(collection).find(queryOptions);
           return (_a = response.docs) != null ? _a : [];
         })
       }, options));
@@ -956,7 +1001,7 @@ var UnifiedQueryClient = class {
       return this.queryClient.prefetchQuery(__spreadValues({
         queryKey: collectionKeys(collection).detail(id, queryOptions),
         queryFn: () => __async(this, null, function* () {
-          return yield this.collectionsApi.from(collection).findById(id, queryOptions);
+          return yield this.collectionClient.from(collection).findById(id, queryOptions);
         })
       }, options));
     });
@@ -969,7 +1014,7 @@ var UnifiedQueryClient = class {
       return this.queryClient.prefetchInfiniteQuery({
         queryKey: collectionKeys(collection).infinite(queryOptions),
         queryFn: (_0) => __async(this, [_0], function* ({ pageParam }) {
-          const response = yield this.collectionsApi.from(collection).find(__spreadProps(__spreadValues({}, queryOptions), { page: pageParam, limit: pageSize }));
+          const response = yield this.collectionClient.from(collection).find(__spreadProps(__spreadValues({}, queryOptions), { page: pageParam, limit: pageSize }));
           return response;
         }),
         initialPageParam: 1,
@@ -981,6 +1026,52 @@ var UnifiedQueryClient = class {
       });
     });
   }
+  // ===== Mutation Hooks =====
+  useCreate(params, options) {
+    const { collection } = params;
+    return (0, import_react_query2.useMutation)({
+      mutationFn: (data) => __async(this, null, function* () {
+        return yield this.collectionClient.from(collection).create(data);
+      }),
+      onSuccess: (data) => {
+        var _a;
+        this.queryClient.invalidateQueries({ queryKey: collectionKeys(collection).lists() });
+        (_a = options == null ? void 0 : options.onSuccess) == null ? void 0 : _a.call(options, data);
+      },
+      onError: options == null ? void 0 : options.onError,
+      onSettled: options == null ? void 0 : options.onSettled
+    });
+  }
+  useUpdate(params, options) {
+    const { collection } = params;
+    return (0, import_react_query2.useMutation)({
+      mutationFn: (variables) => __async(this, null, function* () {
+        return yield this.collectionClient.from(collection).update(variables.id, variables.data);
+      }),
+      onSuccess: (data) => {
+        var _a;
+        this.queryClient.invalidateQueries({ queryKey: collectionKeys(collection).all });
+        (_a = options == null ? void 0 : options.onSuccess) == null ? void 0 : _a.call(options, data);
+      },
+      onError: options == null ? void 0 : options.onError,
+      onSettled: options == null ? void 0 : options.onSettled
+    });
+  }
+  useRemove(params, options) {
+    const { collection } = params;
+    return (0, import_react_query2.useMutation)({
+      mutationFn: (id) => __async(this, null, function* () {
+        return yield this.collectionClient.from(collection).remove(id);
+      }),
+      onSuccess: (data) => {
+        var _a;
+        this.queryClient.invalidateQueries({ queryKey: collectionKeys(collection).all });
+        (_a = options == null ? void 0 : options.onSuccess) == null ? void 0 : _a.call(options, data);
+      },
+      onError: options == null ? void 0 : options.onError,
+      onSettled: options == null ? void 0 : options.onSettled
+    });
+  }
   // ===== Cache Utilities =====
   invalidateQueries(collection, type) {
     const queryKey = type ? [collection, type] : [collection];
@@ -1022,11 +1113,8 @@ var BrowserClient = class {
     };
     this.state = { metadata };
     this.queryClient = getQueryClient();
-    this.query = new UnifiedQueryClient(this.queryClient, {
-      clientKey: this.config.clientKey,
-      baseUrl: this.baseUrl
-    });
-    this.collections = new CollectionsApi(this.config.clientKey, void 0, this.baseUrl);
+    this.collections = new CollectionClient(this.config.clientKey, void 0, this.baseUrl);
+    this.query = new QueryHooks(this.queryClient, this.collections);
   }
   from(collection) {
     return this.collections.from(collection);
@@ -1039,8 +1127,8 @@ function createBrowserClient(options) {
   return new BrowserClient(options);
 }
 
-// src/core/api/api-client.ts
-var ApiClient = class {
+// src/core/api/order-api.ts
+var OrderApi = class {
   constructor(options) {
     if (!options.clientKey) {
       throw new Error("clientKey is required.");
@@ -1068,7 +1156,7 @@ var ApiClient = class {
           response.status,
           data,
           data.error,
-          "\uC694\uCCAD \uCC98\uB9AC \uC911 \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4."
+          "An error occurred while processing the request."
         );
       }
       return data;
@@ -1102,16 +1190,18 @@ var ServerClient = class {
       userAgent: typeof window !== "undefined" ? (_a = window.navigator) == null ? void 0 : _a.userAgent : "Node.js"
     };
     this.state = { metadata };
-    this.api = new ApiClient({
+    this.api = new OrderApi({
       clientKey: this.config.clientKey,
       secretKey: this.config.secretKey,
       baseUrl: this.baseUrl
     });
-    this.collections = new CollectionsApi(
+    this.collections = new CollectionClient(
       this.config.clientKey,
       this.config.secretKey,
       this.baseUrl
     );
+    this.queryClient = getQueryClient();
+    this.query = new QueryHooks(this.queryClient, this.collections);
   }
   from(collection) {
     return this.collections.from(collection);
@@ -1134,10 +1224,36 @@ function isValidWebhookEvent(data) {
   const obj = data;
   return typeof obj.collection === "string" && (obj.operation === "create" || obj.operation === "update") && typeof obj.data === "object" && obj.data !== null;
 }
-function handleWebhook(request, handler) {
+function verifySignature(payload, secret, signature) {
+  return __async(this, null, function* () {
+    const encoder = new TextEncoder();
+    const key = yield crypto.subtle.importKey(
+      "raw",
+      encoder.encode(secret),
+      { name: "HMAC", hash: "SHA-256" },
+      false,
+      ["sign"]
+    );
+    const sig = yield crypto.subtle.sign("HMAC", key, encoder.encode(payload));
+    const expected = Array.from(new Uint8Array(sig)).map((b) => b.toString(16).padStart(2, "0")).join("");
+    return expected === signature;
+  });
+}
+function handleWebhook(request, handler, options) {
   return __async(this, null, function* () {
     try {
-      const body = yield request.json();
+      const rawBody = yield request.text();
+      if (options == null ? void 0 : options.secret) {
+        const signature = request.headers.get("x-webhook-signature") || "";
+        const valid = yield verifySignature(rawBody, options.secret, signature);
+        if (!valid) {
+          return new Response(
+            JSON.stringify({ error: "Invalid webhook signature" }),
+            { status: 401, headers: { "Content-Type": "application/json" } }
+          );
+        }
+      }
+      const body = JSON.parse(rawBody);
       if (!isValidWebhookEvent(body)) {
         return new Response(
           JSON.stringify({ error: "Invalid webhook event format" }),
@@ -1173,25 +1289,25 @@ function createTypedWebhookHandler(collection, handler) {
 // src/utils/order/generateOrderNumber.ts
 var generateOrderNumber = () => {
   const year = (/* @__PURE__ */ new Date()).getFullYear().toString().slice(-2);
-  const month = (/* @__PURE__ */ new Date()).getMonth().toString().padStart(2, "0");
+  const month = ((/* @__PURE__ */ new Date()).getMonth() + 1).toString().padStart(2, "0");
   const day = (/* @__PURE__ */ new Date()).getDate().toString().padStart(2, "0");
   const random = Math.floor(Math.random() * 1e6).toString().padStart(6, "0");
   return `${year}${month}${day}${random}`;
 };
 
 // src/utils/types.ts
-var objectFor = (data) => {
-  if (typeof data === "number") {
-    return null;
-  }
-  return data;
+var resolveRelation = (ref) => {
+  if (typeof ref === "number" || ref === null || ref === void 0) return null;
+  return ref;
 };
+var objectFor = resolveRelation;
 
 // src/utils/order/formatOrderName.ts
 var formatOrderName = (options) => {
-  var _a, _b, _c, _d;
-  const optionLength = options.length;
-  return optionLength === 1 ? ((_b = objectFor((_a = options == null ? void 0 : options[0]) == null ? void 0 : _a.product)) == null ? void 0 : _b.title) || "" : `${(_d = objectFor((_c = options.at(0)) == null ? void 0 : _c.product)) == null ? void 0 : _d.title} \uC678 ${optionLength - 1}\uAC74`;
+  var _a, _b;
+  if (options.length === 0) return "";
+  const firstTitle = ((_b = resolveRelation((_a = options[0]) == null ? void 0 : _a.product)) == null ? void 0 : _b.title) || "";
+  return options.length === 1 ? firstTitle : `${firstTitle} \uC678 ${options.length - 1}\uAC74`;
 };
 
 // src/components/RichTextContent/index.tsx