@plyaz/core 1.5.21 → 1.7.0

package/dist/entry-frontend.mjs

@@ -2562,16 +2562,32 @@ var Core = class _Core {
      */
     this._logger = null;
   }
+  static {
+    /**
+     * Logger transport config (set during initialize)
+     */
+    this._loggerTransport = "pino";
+  }
   /**
    * Get or create the Core logger
    */
   static get logger() {
     _Core._logger ??= new PackageLogger({
       packageName: "core",
-      service: "Core"
+      service: "Core",
+      transport: _Core._loggerTransport
     });
     return _Core._logger;
   }
+  /**
+   * Configure logger transport (call before first log)
+   */
+  static configureLogger(transport) {
+    if (transport && transport !== _Core._loggerTransport) {
+      _Core._loggerTransport = transport;
+      _Core._logger = null;
+    }
+  }
   /**
    * Log a message during initialization.
    * Uses PackageLogger, respects verbose flag.
@@ -2863,6 +2879,7 @@ var Core = class _Core {
    * Initialize all core services
    */
   static async initialize(options = {}) {
+    _Core.configureLogger(options.logger?.transport);
     if (_Core.initialized) {
       _Core.log("Already initialized, returning existing services", options.verbose);
       return _Core._coreServices;
@@ -4627,6 +4644,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 +4745,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 +4798,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 +4881,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 +4975,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);
@@ -5945,14 +6003,15 @@ var FrontendExampleDomainService = class _FrontendExampleDomainService extends B
         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}`);
@@ -5962,10 +6021,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}`);