@plyaz/core 1.7.0 → 1.7.1

package/dist/index.js

@@ -7,10 +7,10 @@ require('@plyaz/types/globals');
 var logger$1 = require('@plyaz/logger');
 var errors$1 = require('@plyaz/types/errors');
 var frontend = require('@plyaz/api/frontend');
-var store = require('@plyaz/store');
 var events = require('events');
 var observability = require('@plyaz/types/observability');
 var middleware = require('@plyaz/errors/middleware');
+var store = require('@plyaz/store');
 var core = require('@plyaz/types/core');
 var fs = require('fs');
 var path = require('path');
@@ -32735,404 +32735,6 @@ var require_cjs = __commonJS({
     }, "get") });
   }
 });
-var BaseDomainService = class {
-  // ─────────────────────────────────────────────────────────────────────────
-  // Constructor
-  // ─────────────────────────────────────────────────────────────────────────
-  /**
-   * Create a new domain service instance
-   *
-   * @param config - Base service configuration (passed via super({...}))
-   */
-  // eslint-disable-next-line complexity
-  constructor(config) {
-    /** Initialization state */
-    this._initialized = false;
-    // API Client (optional)
-    this._apiClient = null;
-    this._clientInitPromise = null;
-    /**
-     * Cache prefix for namespacing cache keys (e.g., 'example', 'user', 'product').
-     * Subclasses can override by defining as a property.
-     * If not overridden, defaults to serviceName.toLowerCase().
-     *
-     * @example
-     * ```typescript
-     * protected cachePrefix = 'my-service'; // Override default
-     * ```
-     */
-    this.cachePrefix = "";
-    // Mapper and Validator instances (lazy)
-    this._mapperInstance = null;
-    this._validatorInstance = null;
-    this.serviceName = config.serviceName;
-    this.supportedRuntimes = config.supportedRuntimes;
-    this.config = config.serviceConfig;
-    this._setAsDefaultClient = config.setAsDefaultClient ?? false;
-    this.logger = new logger$1.PackageLogger({
-      packageName: "core",
-      service: this.serviceName
-    });
-    this._apiClientConfig = config.apiClientConfig;
-    this.cacheManager = config.injected?.cache;
-    this.dbService = config.injected?.db;
-    this.apiService = config.injected?.api;
-    this.observabilityService = config.serviceConfig.observabilityOverride ?? config.injected?.observability;
-    if (!this.cachePrefix) {
-      this.cachePrefix = this.serviceName.toLowerCase();
-    }
-    this._MapperClass = config.mapperClass;
-    this._ValidatorClass = config.validatorClass;
-    if (this._apiClientConfig) {
-      this.initializeApiClient();
-    }
-    this.logger.debug(`${this.serviceName} created`, {
-      supportedRuntimes: this.supportedRuntimes,
-      hasApiClient: !!this._apiClientConfig,
-      injected: {
-        cache: !!this.cacheManager,
-        db: !!this.dbService,
-        api: !!this.apiService,
-        observability: !!this.observabilityService
-      },
-      cachePrefix: this.cachePrefix,
-      hasMapper: !!this._MapperClass,
-      hasValidator: !!this._ValidatorClass
-    });
-  }
-  static {
-    __name(this, "BaseDomainService");
-  }
-  // ─────────────────────────────────────────────────────────────────────────
-  // Getters
-  // ─────────────────────────────────────────────────────────────────────────
-  /**
-   * Check if the service is enabled
-   * Service is enabled by default unless explicitly disabled
-   */
-  get isServiceEnabled() {
-    return this.config?.enabled !== false;
-  }
-  /**
-   * Check if the service is initialized (API client ready)
-   */
-  get isInitialized() {
-    return this._initialized;
-  }
-  /**
-   * Check if mapper is available
-   */
-  get hasMapper() {
-    return !!this._MapperClass;
-  }
-  /**
-   * Check if validator is available
-   */
-  get hasValidator() {
-    return !!this._ValidatorClass;
-  }
-  /**
-   * Get the mapper instance (lazy initialization)
-   * @throws CorePackageError if MapperClass was not provided
-   */
-  get mapper() {
-    if (!this._mapperInstance && this._MapperClass) {
-      this._mapperInstance = new this._MapperClass();
-    }
-    if (!this._mapperInstance) {
-      throw new errors.CorePackageError(
-        `${this.serviceName} does not have a Mapper configured`,
-        errors$1.ERROR_CODES.FEATURE_NOT_SUPPORTED
-      );
-    }
-    return this._mapperInstance;
-  }
-  /**
-   * Set the mapper instance
-   * Allows subclasses to override mapper initialization
-   */
-  set mapper(value) {
-    this._mapperInstance = value;
-  }
-  /**
-   * Get the validator instance (lazy initialization)
-   * @throws CorePackageError if ValidatorClass was not provided
-   */
-  get validator() {
-    if (!this._validatorInstance && this._ValidatorClass) {
-      this._validatorInstance = new this._ValidatorClass();
-    }
-    if (!this._validatorInstance) {
-      throw new errors.CorePackageError(
-        `${this.serviceName} does not have a Validator configured`,
-        errors$1.ERROR_CODES.FEATURE_NOT_SUPPORTED
-      );
-    }
-    return this._validatorInstance;
-  }
-  /**
-   * Set the validator instance
-   * Allows subclasses to override validator initialization
-   */
-  set validator(value) {
-    this._validatorInstance = value;
-  }
-  /**
-   * Get the API client (after initialization)
-   * @throws CorePackageError if API client was not configured or not initialized
-   */
-  get apiClient() {
-    if (!this._apiClient) {
-      throw new errors.CorePackageError(
-        `${this.serviceName} API client not initialized. Call ensureApiClientInitialized() first.`,
-        errors$1.ERROR_CODES.CLIENT_INITIALIZATION_FAILED
-      );
-    }
-    return this._apiClient;
-  }
-  /**
-   * Get the observability adapter (if injected)
-   * Returns undefined if observability is not enabled
-   */
-  get observability() {
-    return this.observabilityService;
-  }
-  /**
-   * Check if observability is available
-   */
-  get hasObservability() {
-    return !!this.observabilityService;
-  }
-  // ─────────────────────────────────────────────────────────────────────────
-  // API Client Initialization
-  // ─────────────────────────────────────────────────────────────────────────
-  /**
-   * Initialize API client asynchronously
-   * Called from constructor if apiClientConfig is provided
-   */
-  initializeApiClient() {
-    if (this._clientInitPromise || !this._apiClientConfig) {
-      return;
-    }
-    this._clientInitPromise = (async () => {
-      try {
-        this._apiClient = await frontend.createApiClient(this._apiClientConfig);
-        if (this._setAsDefaultClient) {
-          frontend.setDefaultApiClient(this._apiClient);
-        }
-        this._initialized = true;
-        this.logger.debug("API client initialized", {
-          service: this.serviceName,
-          baseURL: this._apiClientConfig.baseURL
-        });
-      } catch (error) {
-        this.logger.error("Failed to initialize API client", {
-          service: this.serviceName,
-          error: error instanceof Error ? error.message : String(error)
-        });
-        throw error;
-      }
-    })();
-  }
-  /**
-   * Ensure API client is initialized before use.
-   * Call this from methods that need the API client.
-   * Also called by ServiceRegistry.create() for services with async initialization.
-   */
-  async ensureApiClientInitialized() {
-    if (this._clientInitPromise) {
-      await this._clientInitPromise;
-    }
-    if (this._apiClientConfig && !this._apiClient) {
-      throw new errors.CorePackageError(
-        `${this.serviceName} API client not initialized`,
-        errors$1.ERROR_CODES.CLIENT_INITIALIZATION_FAILED
-      );
-    }
-  }
-  // ─────────────────────────────────────────────────────────────────────────
-  // Configuration Management
-  // ─────────────────────────────────────────────────────────────────────────
-  /**
-   * Get current configuration (immutable copy)
-   */
-  getConfig() {
-    return { ...this.config };
-  }
-  /**
-   * Get a default value
-   * @param key - The key to get the default for
-   */
-  getDefault(key) {
-    return this.config?.defaults?.[key];
-  }
-  /**
-   * Set a default value (mutates config.defaults)
-   * @param key - The key to set the default for
-   * @param value - The default value
-   */
-  setDefault(key, value) {
-    if (!this.config.defaults) {
-      this.config.defaults = {};
-    }
-    this.config.defaults[key] = value;
-  }
-  /**
-   * Set multiple default values
-   * @param defaults - Record of default values
-   */
-  setDefaults(defaults) {
-    if (!this.config.defaults) {
-      this.config.defaults = {};
-    }
-    Object.assign(this.config.defaults, defaults);
-  }
-  // ─────────────────────────────────────────────────────────────────────────
-  // Assertions
-  // ─────────────────────────────────────────────────────────────────────────
-  /**
-   * Assert that the service is available (configured and ready)
-   * @throws CorePackageError if not available
-   */
-  assertAvailable() {
-    if (!this.isAvailable()) {
-      throw new errors.CorePackageError(
-        `${this.serviceName} is not available. Check configuration.`,
-        errors$1.ERROR_CODES.CLIENT_INITIALIZATION_FAILED
-      );
-    }
-  }
-  /**
-   * Assert that the service is enabled
-   * @throws CorePackageError if disabled
-   */
-  assertEnabled() {
-    if (!this.isServiceEnabled) {
-      throw new errors.CorePackageError(
-        `${this.serviceName} is disabled. Set enabled: true in configuration.`,
-        errors$1.ERROR_CODES.FEATURE_NOT_SUPPORTED
-      );
-    }
-  }
-  /**
-   * Assert that the service is ready (enabled AND available)
-   * @throws CorePackageError if not ready
-   */
-  assertReady() {
-    this.assertEnabled();
-    this.assertAvailable();
-  }
-  // ─────────────────────────────────────────────────────────────────────────
-  // Helper Methods
-  // ─────────────────────────────────────────────────────────────────────────
-  /**
-   * Log debug message with service context
-   */
-  logDebug(message, data) {
-    this.logger.debug(message, {
-      service: this.serviceName,
-      ...data
-    });
-  }
-  /**
-   * Log info message with service context
-   */
-  logInfo(message, data) {
-    this.logger.info(message, {
-      service: this.serviceName,
-      ...data
-    });
-  }
-  /**
-   * Log warning message with service context
-   */
-  logWarn(message, data) {
-    this.logger.warn(message, {
-      service: this.serviceName,
-      ...data
-    });
-  }
-  /**
-   * Log error message with service context
-   */
-  logError(message, data) {
-    this.logger.error(message, {
-      service: this.serviceName,
-      ...data
-    });
-  }
-  // ─────────────────────────────────────────────────────────────────────────
-  // Observability Helpers
-  // ─────────────────────────────────────────────────────────────────────────
-  /**
-   * Record a metric (no-op if observability not available)
-   */
-  async recordMetric(name, value, tags) {
-    if (!this.observabilityService) return;
-    await this.observabilityService.recordHistogram(name, value, {
-      service: this.serviceName,
-      ...tags
-    });
-  }
-  /**
-   * Increment a counter (no-op if observability not available)
-   */
-  async incrementCounter(name, value = 1, tags) {
-    if (!this.observabilityService) return;
-    await this.observabilityService.incrementCounter(name, value, {
-      service: this.serviceName,
-      ...tags
-    });
-  }
-  /**
-   * Start a span for tracing (returns noop span if observability not available)
-   */
-  startSpan(name, attributes) {
-    if (!this.observabilityService) {
-      return {
-        context: { traceId: "", spanId: "" },
-        setAttribute: /* @__PURE__ */ __name(() => {
-        }, "setAttribute"),
-        setAttributes: /* @__PURE__ */ __name(() => {
-        }, "setAttributes"),
-        addEvent: /* @__PURE__ */ __name(() => {
-        }, "addEvent"),
-        setStatus: /* @__PURE__ */ __name(() => {
-        }, "setStatus"),
-        end: /* @__PURE__ */ __name(() => {
-        }, "end"),
-        recordException: /* @__PURE__ */ __name(() => {
-        }, "recordException")
-      };
-    }
-    return this.observabilityService.startSpan({
-      name,
-      attributes: {
-        "service.name": this.serviceName,
-        ...attributes
-      }
-    });
-  }
-  /**
-   * Execute a function within a traced span
-   */
-  async withSpan(name, fn, attributes) {
-    if (!this.observabilityService) {
-      const noopSpan = this.startSpan(name);
-      return fn(noopSpan);
-    }
-    return this.observabilityService.withSpan(
-      {
-        name,
-        attributes: {
-          "service.name": this.serviceName,
-          ...attributes
-        }
-      },
-      fn
-    );
-  }
-};
 function hashString(str) {
   if (str.length === 0) return 0;
   let hash = config.FNV_CONSTANTS.FNV_32_OFFSET;
@@ -35710,6 +35312,13 @@ var Core = class _Core {
       _Core._logger = null;
     }
   }
+  /**
+   * Get the configured logger transport.
+   * Used by services to create loggers with the same transport setting.
+   */
+  static get loggerTransport() {
+    return _Core._loggerTransport;
+  }
   /**
    * Log a message during initialization.
    * Uses PackageLogger, respects verbose flag.
@@ -36985,8 +36594,405 @@ var Core = class _Core {
     _Core.log("Feature flags initialized", verbose);
   }
 };
-
-// src/domain/base/BaseFrontendDomainService.ts
+var BaseDomainService = class {
+  // ─────────────────────────────────────────────────────────────────────────
+  // Constructor
+  // ─────────────────────────────────────────────────────────────────────────
+  /**
+   * Create a new domain service instance
+   *
+   * @param config - Base service configuration (passed via super({...}))
+   */
+  // eslint-disable-next-line complexity
+  constructor(config) {
+    /** Initialization state */
+    this._initialized = false;
+    // API Client (optional)
+    this._apiClient = null;
+    this._clientInitPromise = null;
+    /**
+     * Cache prefix for namespacing cache keys (e.g., 'example', 'user', 'product').
+     * Subclasses can override by defining as a property.
+     * If not overridden, defaults to serviceName.toLowerCase().
+     *
+     * @example
+     * ```typescript
+     * protected cachePrefix = 'my-service'; // Override default
+     * ```
+     */
+    this.cachePrefix = "";
+    // Mapper and Validator instances (lazy)
+    this._mapperInstance = null;
+    this._validatorInstance = null;
+    this.serviceName = config.serviceName;
+    this.supportedRuntimes = config.supportedRuntimes;
+    this.config = config.serviceConfig;
+    this._setAsDefaultClient = config.setAsDefaultClient ?? false;
+    this.logger = new logger$1.PackageLogger({
+      packageName: "core",
+      service: this.serviceName,
+      transport: Core.loggerTransport
+    });
+    this._apiClientConfig = config.apiClientConfig;
+    this.cacheManager = config.injected?.cache;
+    this.dbService = config.injected?.db;
+    this.apiService = config.injected?.api;
+    this.observabilityService = config.serviceConfig.observabilityOverride ?? config.injected?.observability;
+    if (!this.cachePrefix) {
+      this.cachePrefix = this.serviceName.toLowerCase();
+    }
+    this._MapperClass = config.mapperClass;
+    this._ValidatorClass = config.validatorClass;
+    if (this._apiClientConfig) {
+      this.initializeApiClient();
+    }
+    this.logger.debug(`${this.serviceName} created`, {
+      supportedRuntimes: this.supportedRuntimes,
+      hasApiClient: !!this._apiClientConfig,
+      injected: {
+        cache: !!this.cacheManager,
+        db: !!this.dbService,
+        api: !!this.apiService,
+        observability: !!this.observabilityService
+      },
+      cachePrefix: this.cachePrefix,
+      hasMapper: !!this._MapperClass,
+      hasValidator: !!this._ValidatorClass
+    });
+  }
+  static {
+    __name(this, "BaseDomainService");
+  }
+  // ─────────────────────────────────────────────────────────────────────────
+  // Getters
+  // ─────────────────────────────────────────────────────────────────────────
+  /**
+   * Check if the service is enabled
+   * Service is enabled by default unless explicitly disabled
+   */
+  get isServiceEnabled() {
+    return this.config?.enabled !== false;
+  }
+  /**
+   * Check if the service is initialized (API client ready)
+   */
+  get isInitialized() {
+    return this._initialized;
+  }
+  /**
+   * Check if mapper is available
+   */
+  get hasMapper() {
+    return !!this._MapperClass;
+  }
+  /**
+   * Check if validator is available
+   */
+  get hasValidator() {
+    return !!this._ValidatorClass;
+  }
+  /**
+   * Get the mapper instance (lazy initialization)
+   * @throws CorePackageError if MapperClass was not provided
+   */
+  get mapper() {
+    if (!this._mapperInstance && this._MapperClass) {
+      this._mapperInstance = new this._MapperClass();
+    }
+    if (!this._mapperInstance) {
+      throw new errors.CorePackageError(
+        `${this.serviceName} does not have a Mapper configured`,
+        errors$1.ERROR_CODES.FEATURE_NOT_SUPPORTED
+      );
+    }
+    return this._mapperInstance;
+  }
+  /**
+   * Set the mapper instance
+   * Allows subclasses to override mapper initialization
+   */
+  set mapper(value) {
+    this._mapperInstance = value;
+  }
+  /**
+   * Get the validator instance (lazy initialization)
+   * @throws CorePackageError if ValidatorClass was not provided
+   */
+  get validator() {
+    if (!this._validatorInstance && this._ValidatorClass) {
+      this._validatorInstance = new this._ValidatorClass();
+    }
+    if (!this._validatorInstance) {
+      throw new errors.CorePackageError(
+        `${this.serviceName} does not have a Validator configured`,
+        errors$1.ERROR_CODES.FEATURE_NOT_SUPPORTED
+      );
+    }
+    return this._validatorInstance;
+  }
+  /**
+   * Set the validator instance
+   * Allows subclasses to override validator initialization
+   */
+  set validator(value) {
+    this._validatorInstance = value;
+  }
+  /**
+   * Get the API client (after initialization)
+   * @throws CorePackageError if API client was not configured or not initialized
+   */
+  get apiClient() {
+    if (!this._apiClient) {
+      throw new errors.CorePackageError(
+        `${this.serviceName} API client not initialized. Call ensureApiClientInitialized() first.`,
+        errors$1.ERROR_CODES.CLIENT_INITIALIZATION_FAILED
+      );
+    }
+    return this._apiClient;
+  }
+  /**
+   * Get the observability adapter (if injected)
+   * Returns undefined if observability is not enabled
+   */
+  get observability() {
+    return this.observabilityService;
+  }
+  /**
+   * Check if observability is available
+   */
+  get hasObservability() {
+    return !!this.observabilityService;
+  }
+  // ─────────────────────────────────────────────────────────────────────────
+  // API Client Initialization
+  // ─────────────────────────────────────────────────────────────────────────
+  /**
+   * Initialize API client asynchronously
+   * Called from constructor if apiClientConfig is provided
+   */
+  initializeApiClient() {
+    if (this._clientInitPromise || !this._apiClientConfig) {
+      return;
+    }
+    this._clientInitPromise = (async () => {
+      try {
+        this._apiClient = await frontend.createApiClient(this._apiClientConfig);
+        if (this._setAsDefaultClient) {
+          frontend.setDefaultApiClient(this._apiClient);
+        }
+        this._initialized = true;
+        this.logger.debug("API client initialized", {
+          service: this.serviceName,
+          baseURL: this._apiClientConfig.baseURL
+        });
+      } catch (error) {
+        this.logger.error("Failed to initialize API client", {
+          service: this.serviceName,
+          error: error instanceof Error ? error.message : String(error)
+        });
+        throw error;
+      }
+    })();
+  }
+  /**
+   * Ensure API client is initialized before use.
+   * Call this from methods that need the API client.
+   * Also called by ServiceRegistry.create() for services with async initialization.
+   */
+  async ensureApiClientInitialized() {
+    if (this._clientInitPromise) {
+      await this._clientInitPromise;
+    }
+    if (this._apiClientConfig && !this._apiClient) {
+      throw new errors.CorePackageError(
+        `${this.serviceName} API client not initialized`,
+        errors$1.ERROR_CODES.CLIENT_INITIALIZATION_FAILED
+      );
+    }
+  }
+  // ─────────────────────────────────────────────────────────────────────────
+  // Configuration Management
+  // ─────────────────────────────────────────────────────────────────────────
+  /**
+   * Get current configuration (immutable copy)
+   */
+  getConfig() {
+    return { ...this.config };
+  }
+  /**
+   * Get a default value
+   * @param key - The key to get the default for
+   */
+  getDefault(key) {
+    return this.config?.defaults?.[key];
+  }
+  /**
+   * Set a default value (mutates config.defaults)
+   * @param key - The key to set the default for
+   * @param value - The default value
+   */
+  setDefault(key, value) {
+    if (!this.config.defaults) {
+      this.config.defaults = {};
+    }
+    this.config.defaults[key] = value;
+  }
+  /**
+   * Set multiple default values
+   * @param defaults - Record of default values
+   */
+  setDefaults(defaults) {
+    if (!this.config.defaults) {
+      this.config.defaults = {};
+    }
+    Object.assign(this.config.defaults, defaults);
+  }
+  // ─────────────────────────────────────────────────────────────────────────
+  // Assertions
+  // ─────────────────────────────────────────────────────────────────────────
+  /**
+   * Assert that the service is available (configured and ready)
+   * @throws CorePackageError if not available
+   */
+  assertAvailable() {
+    if (!this.isAvailable()) {
+      throw new errors.CorePackageError(
+        `${this.serviceName} is not available. Check configuration.`,
+        errors$1.ERROR_CODES.CLIENT_INITIALIZATION_FAILED
+      );
+    }
+  }
+  /**
+   * Assert that the service is enabled
+   * @throws CorePackageError if disabled
+   */
+  assertEnabled() {
+    if (!this.isServiceEnabled) {
+      throw new errors.CorePackageError(
+        `${this.serviceName} is disabled. Set enabled: true in configuration.`,
+        errors$1.ERROR_CODES.FEATURE_NOT_SUPPORTED
+      );
+    }
+  }
+  /**
+   * Assert that the service is ready (enabled AND available)
+   * @throws CorePackageError if not ready
+   */
+  assertReady() {
+    this.assertEnabled();
+    this.assertAvailable();
+  }
+  // ─────────────────────────────────────────────────────────────────────────
+  // Helper Methods
+  // ─────────────────────────────────────────────────────────────────────────
+  /**
+   * Log debug message with service context
+   */
+  logDebug(message, data) {
+    this.logger.debug(message, {
+      service: this.serviceName,
+      ...data
+    });
+  }
+  /**
+   * Log info message with service context
+   */
+  logInfo(message, data) {
+    this.logger.info(message, {
+      service: this.serviceName,
+      ...data
+    });
+  }
+  /**
+   * Log warning message with service context
+   */
+  logWarn(message, data) {
+    this.logger.warn(message, {
+      service: this.serviceName,
+      ...data
+    });
+  }
+  /**
+   * Log error message with service context
+   */
+  logError(message, data) {
+    this.logger.error(message, {
+      service: this.serviceName,
+      ...data
+    });
+  }
+  // ─────────────────────────────────────────────────────────────────────────
+  // Observability Helpers
+  // ─────────────────────────────────────────────────────────────────────────
+  /**
+   * Record a metric (no-op if observability not available)
+   */
+  async recordMetric(name, value, tags) {
+    if (!this.observabilityService) return;
+    await this.observabilityService.recordHistogram(name, value, {
+      service: this.serviceName,
+      ...tags
+    });
+  }
+  /**
+   * Increment a counter (no-op if observability not available)
+   */
+  async incrementCounter(name, value = 1, tags) {
+    if (!this.observabilityService) return;
+    await this.observabilityService.incrementCounter(name, value, {
+      service: this.serviceName,
+      ...tags
+    });
+  }
+  /**
+   * Start a span for tracing (returns noop span if observability not available)
+   */
+  startSpan(name, attributes) {
+    if (!this.observabilityService) {
+      return {
+        context: { traceId: "", spanId: "" },
+        setAttribute: /* @__PURE__ */ __name(() => {
+        }, "setAttribute"),
+        setAttributes: /* @__PURE__ */ __name(() => {
+        }, "setAttributes"),
+        addEvent: /* @__PURE__ */ __name(() => {
+        }, "addEvent"),
+        setStatus: /* @__PURE__ */ __name(() => {
+        }, "setStatus"),
+        end: /* @__PURE__ */ __name(() => {
+        }, "end"),
+        recordException: /* @__PURE__ */ __name(() => {
+        }, "recordException")
+      };
+    }
+    return this.observabilityService.startSpan({
+      name,
+      attributes: {
+        "service.name": this.serviceName,
+        ...attributes
+      }
+    });
+  }
+  /**
+   * Execute a function within a traced span
+   */
+  async withSpan(name, fn, attributes) {
+    if (!this.observabilityService) {
+      const noopSpan = this.startSpan(name);
+      return fn(noopSpan);
+    }
+    return this.observabilityService.withSpan(
+      {
+        name,
+        attributes: {
+          "service.name": this.serviceName,
+          ...attributes
+        }
+      },
+      fn
+    );
+  }
+};
 var BaseFrontendDomainService = class extends BaseDomainService {
   // ─────────────────────────────────────────────────────────────────────────
   // Constructor
@@ -37406,6 +37412,94 @@ var BaseFrontendDomainService = class extends BaseDomainService {
     }
     return result2;
   }
+  /**
+   * Check if a response indicates success.
+   *
+   * Uses `responseSuccessKey` config if set, otherwise auto-detects from:
+   * - `isSuccess` (internal format)
+   * - `success` (alternative internal format)
+   * - `ok` (fetchff/fetch standard)
+   * - HTTP status code 200-299
+   *
+   * Supports nested keys via dot notation (e.g., `'meta.success'`).
+   *
+   * @param response - Response object from fetcher
+   * @returns true if response indicates success
+   */
+  // eslint-disable-next-line complexity
+  isResponseSuccess(response) {
+    if (!response || typeof response !== "object") {
+      return false;
+    }
+    const resp = response;
+    const successKey = this.config.responseSuccessKey;
+    if (successKey) {
+      const keys = successKey.split(".");
+      let result2 = resp;
+      for (const k of keys) {
+        if (result2 && typeof result2 === "object" && k in result2) {
+          result2 = result2[k];
+        } else {
+          break;
+        }
+      }
+      if (typeof result2 === "boolean") {
+        return result2;
+      }
+    }
+    if ("isSuccess" in resp && typeof resp.isSuccess === "boolean") {
+      return resp.isSuccess;
+    }
+    if ("success" in resp && typeof resp.success === "boolean") {
+      return resp.success;
+    }
+    if ("ok" in resp && typeof resp.ok === "boolean") {
+      return resp.ok;
+    }
+    if ("status" in resp && typeof resp.status === "number") {
+      return resp.status >= types.HTTP_STATUS.OK && resp.status < types.HTTP_STATUS.MULTIPLE_CHOICES;
+    }
+    return "data" in resp && !("error" in resp && resp.error);
+  }
+  /**
+   * Extract error from API response.
+   *
+   * Uses `responseErrorKey` config if set, otherwise auto-detects from:
+   * - `error` (common format)
+   * - `errors` (array format, e.g., GraphQL)
+   *
+   * Supports nested keys via dot notation (e.g., `'meta.error'`).
+   *
+   * @param response - Response object from fetcher
+   * @returns Extracted error or undefined if not found
+   */
+  // eslint-disable-next-line complexity
+  extractResponseError(response) {
+    if (!response || typeof response !== "object") {
+      return void 0;
+    }
+    const resp = response;
+    const errorKey = this.config.responseErrorKey;
+    if (errorKey) {
+      const keys = errorKey.split(".");
+      let result2 = resp;
+      for (const k of keys) {
+        if (result2 && typeof result2 === "object" && k in result2) {
+          result2 = result2[k];
+        } else {
+          return void 0;
+        }
+      }
+      return result2;
+    }
+    if ("error" in resp && resp.error) {
+      return resp.error;
+    }
+    if ("errors" in resp && resp.errors) {
+      return resp.errors;
+    }
+    return void 0;
+  }
   // ─────────────────────────────────────────────────────────────────────────
   // Generic CRUD Operations
   // ─────────────────────────────────────────────────────────────────────────
@@ -37461,13 +37555,15 @@ var BaseFrontendDomainService = class extends BaseDomainService {
     try {
       await this.beforeFetchAll?.(query);
       const response = await this.config.fetchers.fetchAll(query, options);
-      if (!response.isSuccess) {
+      if (!this.isResponseSuccess(response)) {
+        const extractedError = this.extractResponseError(response);
         throw new errors.CorePackageError(
           "Failed to fetch entities",
           errors$1.ERROR_CODES.CONTEXT_OPERATION_FAILED,
           {
             context: { operation: "fetchAll", query },
-            cause: response.error ?? void 0
+            cause: extractedError instanceof Error ? extractedError : void 0,
+            details: extractedError
           }
         );
       }
@@ -37515,13 +37611,16 @@ var BaseFrontendDomainService = class extends BaseDomainService {
     try {
       await this.beforeFetchById?.(id);
       const response = await this.config.fetchers.fetchById(String(id), options);
-      if (!response.isSuccess) {
-        if (response.error?.message?.includes("404")) {
+      if (!this.isResponseSuccess(response)) {
+        const extractedError = this.extractResponseError(response);
+        const errorMessage = extractedError instanceof Error ? extractedError.message : String(extractedError ?? "");
+        if (errorMessage.includes("404") || response.status === types.HTTP_STATUS.NOT_FOUND) {
           return null;
         }
         throw new errors.CorePackageError("Failed to fetch entity", errors$1.ERROR_CODES.CONTEXT_OPERATION_FAILED, {
           context: { operation: "fetchById", entityId: String(id) },
-          cause: response.error ?? void 0
+          cause: extractedError instanceof Error ? extractedError : void 0,
+          details: extractedError
         });
       }
       const rawData = this.unwrapResponseData(response.data);
@@ -37597,15 +37696,14 @@ var BaseFrontendDomainService = class extends BaseDomainService {
         });
       }
       const response = await this.config.fetchers.create(createDTO, options);
-      if (!response.isSuccess) {
-        throw new errors.CorePackageError(
-          response.error?.message ?? "Failed to create entity",
-          errors$1.ERROR_CODES.CONTEXT_OPERATION_FAILED,
-          {
-            context: { operation: "create" },
-            cause: response.error ?? void 0
-          }
-        );
+      if (!this.isResponseSuccess(response)) {
+        const extractedError = this.extractResponseError(response);
+        const errorMessage = extractedError instanceof Error ? extractedError.message : typeof extractedError === "string" ? extractedError : "Failed to create entity";
+        throw new errors.CorePackageError(errorMessage, errors$1.ERROR_CODES.CONTEXT_OPERATION_FAILED, {
+          context: { operation: "create" },
+          cause: extractedError instanceof Error ? extractedError : void 0,
+          details: extractedError
+        });
       }
       const rawData = this.unwrapResponseData(response.data);
       const entity = this.mapper.toDomain(rawData);
@@ -37691,15 +37789,14 @@ var BaseFrontendDomainService = class extends BaseDomainService {
         });
       }
       const response = await this.config.fetchers.update({ id, data: patchDTO }, options);
-      if (!response.isSuccess) {
-        throw new errors.CorePackageError(
-          response.error?.message ?? "Failed to update entity",
-          errors$1.ERROR_CODES.CONTEXT_OPERATION_FAILED,
-          {
-            context: { operation: "update", entityId: id },
-            cause: response.error ?? void 0
-          }
-        );
+      if (!this.isResponseSuccess(response)) {
+        const extractedError = this.extractResponseError(response);
+        const errorMessage = extractedError instanceof Error ? extractedError.message : typeof extractedError === "string" ? extractedError : "Failed to update entity";
+        throw new errors.CorePackageError(errorMessage, errors$1.ERROR_CODES.CONTEXT_OPERATION_FAILED, {
+          context: { operation: "update", entityId: id },
+          cause: extractedError instanceof Error ? extractedError : void 0,
+          details: extractedError
+        });
       }
       const rawData = this.unwrapResponseData(response.data);
       const serverEntity = this.mapper.toDomain(rawData);
@@ -37771,15 +37868,14 @@ var BaseFrontendDomainService = class extends BaseDomainService {
         });
       }
       const response = await this.config.fetchers.delete(String(id), options);
-      if (!response.isSuccess) {
-        throw new errors.CorePackageError(
-          response.error?.message ?? "Failed to delete entity",
-          errors$1.ERROR_CODES.CONTEXT_OPERATION_FAILED,
-          {
-            context: { operation: "delete", entityId: String(id) },
-            cause: response.error ?? void 0
-          }
-        );
+      if (!this.isResponseSuccess(response)) {
+        const extractedError = this.extractResponseError(response);
+        const errorMessage = extractedError instanceof Error ? extractedError.message : typeof extractedError === "string" ? extractedError : "Failed to delete entity";
+        throw new errors.CorePackageError(errorMessage, errors$1.ERROR_CODES.CONTEXT_OPERATION_FAILED, {
+          context: { operation: "delete", entityId: String(id) },
+          cause: extractedError instanceof Error ? extractedError : void 0,
+          details: extractedError
+        });
       }
       if (!isOptimistic) {
         this.removeEntityFromStore(String(id));
@@ -44672,6 +44768,8 @@ var ExampleMapperClass = class extends BaseMapper {
    * API DTO → Domain Model
    */
   toDomain(dto) {
+    const createdAt = dto.created_at ? new Date(dto.created_at) : /* @__PURE__ */ new Date();
+    const updatedAt = dto.updated_at ? new Date(dto.updated_at) : /* @__PURE__ */ new Date();
     return {
       id: dto.id,
       name: dto.name,
@@ -44680,8 +44778,8 @@ var ExampleMapperClass = class extends BaseMapper {
       status: dto.status,
       amount: dto.amount,
       isVisible: dto.is_visible,
-      createdAt: new Date(dto.created_at),
-      updatedAt: new Date(dto.updated_at),
+      createdAt: isNaN(createdAt.getTime()) ? /* @__PURE__ */ new Date() : createdAt,
+      updatedAt: isNaN(updatedAt.getTime()) ? /* @__PURE__ */ new Date() : updatedAt,
       // Computed properties
       isActive: dto.status === "active",
       hasDescription: /* @__PURE__ */ __name(() => Boolean(dto.description), "hasDescription")
@@ -45115,6 +45213,7 @@ var FrontendExampleDomainService = class _FrontendExampleDomainService extends B
   // ─────────────────────────────────────────────────────────────────────────
   // Constructor
   // ─────────────────────────────────────────────────────────────────────────
+  // eslint-disable-next-line complexity
   constructor(config = {}, options) {
     const apiBasePath = config.apiBasePath ?? "/api/examples";
     super({
@@ -45128,8 +45227,12 @@ var FrontendExampleDomainService = class _FrontendExampleDomainService extends B
         autoFetch: false,
         pollingInterval: 0,
         ...config,
-        // Unwrap SuccessResponseStandard: { success, message, data, codeStatus }
-        // Base class will extract 'data' property automatically
+        // Fetchff response format: { ok, status, data: { success, message, data, codeStatus }, error }
+        // Use 'ok' for success check (HTTP level)
+        responseSuccessKey: "ok",
+        // Extract error from fetchff response
+        responseErrorKey: "error",
+        // Unwrap SuccessResponseStandard: extract 'data' from response.data
         responseDataKey: "data",
         // Fetchers - using apiClient directly for testing/example purposes
         // In production, these would be imported from @plyaz/api services