@plyaz/core 1.5.20 → 1.6.0

package/dist/entry-frontend.mjs

@@ -4627,6 +4627,43 @@ var BaseFrontendDomainService = class extends BaseDomainService {
     }
   }
   // ─────────────────────────────────────────────────────────────────────────
+  // Response Unwrapping
+  // ─────────────────────────────────────────────────────────────────────────
+  /**
+   * Unwrap response data if responseDataKey is configured.
+   *
+   * Handles wrapped API responses (e.g., SuccessResponseStandard) by extracting
+   * the actual data from a nested property. Supports nested keys with dot notation.
+   *
+   * @param data - Raw response data from fetcher
+   * @returns Unwrapped data or original data if no key configured
+   *
+   * @example
+   * ```typescript
+   * // Simple key: responseDataKey: 'data'
+   * // Input: { success: true, message: '...', data: [...], codeStatus: 200 }
+   * // Output: [...]
+   *
+   * // Nested key: responseDataKey: 'data.items'
+   * // Input: { data: { items: [...], total: 100 } }
+   * // Output: [...]
+   * ```
+   */
+  unwrapResponseData(data) {
+    const key = this.config.responseDataKey;
+    if (!key) return data;
+    const keys = key.split(".");
+    let result = data;
+    for (const k of keys) {
+      if (result && typeof result === "object" && k in result) {
+        result = result[k];
+      } else {
+        return data;
+      }
+    }
+    return result;
+  }
+  // ─────────────────────────────────────────────────────────────────────────
   // Generic CRUD Operations
   // ─────────────────────────────────────────────────────────────────────────
   /**
@@ -4691,7 +4728,8 @@ var BaseFrontendDomainService = class extends BaseDomainService {
           }
         );
       }
-      const entities = (response.data ?? []).map((dto) => this.mapper.toDomain(dto));
+      const rawData = this.unwrapResponseData(response.data);
+      const entities = (rawData ?? []).map((dto) => this.mapper.toDomain(dto));
       this.syncEntitiesToStore(entities);
       await this.afterFetchAll?.(entities, query);
       this.emitEvent("fetched", {
@@ -4743,7 +4781,8 @@ var BaseFrontendDomainService = class extends BaseDomainService {
           cause: response.error ?? void 0
         });
       }
-      const entity = response.data ? this.mapper.toDomain(response.data) : null;
+      const rawData = this.unwrapResponseData(response.data);
+      const entity = rawData ? this.mapper.toDomain(rawData) : null;
       if (entity) {
         await this.afterFetchById?.(entity);
       }
@@ -4825,7 +4864,8 @@ var BaseFrontendDomainService = class extends BaseDomainService {
           }
         );
       }
-      const entity = this.mapper.toDomain(response.data);
+      const rawData = this.unwrapResponseData(response.data);
+      const entity = this.mapper.toDomain(rawData);
       let storeState;
       if (isOptimistic && optimisticEntity) {
         const tempId = optimisticEntity.id;
@@ -4918,7 +4958,8 @@ var BaseFrontendDomainService = class extends BaseDomainService {
           }
         );
       }
-      const serverEntity = this.mapper.toDomain(response.data);
+      const rawData = this.unwrapResponseData(response.data);
+      const serverEntity = this.mapper.toDomain(rawData);
       let finalEntity = serverEntity;
       if (isOptimistic && optimisticStoreState) {
         finalEntity = this.resolveConflict({ id, ...data }, serverEntity);
@@ -5937,20 +5978,23 @@ var FrontendExampleDomainService = class _FrontendExampleDomainService extends B
     super({
       serviceName: "ExampleFrontendService",
       supportedRuntimes: ["frontend"],
+      // API client config - uses injected options or creates from apiBasePath
+      apiClientConfig: options?.apiClient?.options ?? { baseURL: apiBasePath },
       serviceConfig: {
         enabled: true,
         apiBasePath,
         autoFetch: false,
         pollingInterval: 0,
         ...config,
+        // Unwrap SuccessResponseStandard: { success, message, data, codeStatus }
+        // Base class will extract 'data' property automatically
+        responseDataKey: "data",
         // Fetchers - using apiClient directly for testing/example purposes
         // In production, these would be imported from @plyaz/api services
         // Note: Validation is handled by validator class, mapping by mapper class
         fetchers: {
           fetchAll: /* @__PURE__ */ __name(async (query) => {
-            return this.apiClient.get(apiBasePath, {
-              params: query
-            });
+            return this.apiClient.get(apiBasePath, { params: query });
           }, "fetchAll"),
           fetchById: /* @__PURE__ */ __name(async (id) => {
             return this.apiClient.get(`${apiBasePath}/${id}`);
@@ -5960,10 +6004,7 @@ var FrontendExampleDomainService = class _FrontendExampleDomainService extends B
           }, "create"),
           update: /* @__PURE__ */ __name(async (payload) => {
             const { id, data } = payload;
-            return this.apiClient.patch(
-              `${apiBasePath}/${id}`,
-              data
-            );
+            return this.apiClient.patch(`${apiBasePath}/${id}`, data);
           }, "update"),
           delete: /* @__PURE__ */ __name(async (id) => {
             return this.apiClient.delete(`${apiBasePath}/${id}`);