@plyaz/core 1.9.2 → 1.9.4

package/dist/entry-frontend-browser.mjs

@@ -8,6 +8,7 @@ import { ERROR_CODES as ERROR_CODES$1, ERROR_CATEGORY as ERROR_CATEGORY$1, API_E
 import { OBSERVABILITY_METRICS } from '@plyaz/types/observability';
 import { clearEventEmitter, setEventEmitter, initializeGlobalErrorHandler } from '@plyaz/errors/middleware';
 import { STORE_KEYS, useRootStore, createStandaloneFeatureFlagStore } from '@plyaz/store';
+export { useRootStore } from '@plyaz/store';
 import { CORE_EVENTS as CORE_EVENTS$1, SERVICE_KEYS } from '@plyaz/types/core';
 import { jsx, Fragment, jsxs } from 'react/jsx-runtime';
 import { createContext, useState, useEffect, useCallback, useMemo, useContext } from 'react';
@@ -4372,6 +4373,7 @@ var BaseDomainService = class {
     );
   }
 };
+var DEFAULT_POLLING_INTERVAL_MS = 3e4;
 var BaseFrontendDomainService = class _BaseFrontendDomainService extends BaseDomainService {
   // ─────────────────────────────────────────────────────────────────────────
   // Constructor
@@ -4397,6 +4399,11 @@ var BaseFrontendDomainService = class _BaseFrontendDomainService extends BaseDom
     this._rollbackStack = [];
     /** Maximum rollback stack size */
     this._maxRollbackStackSize = 10;
+    // ─────────────────────────────────────────────────────────────────────────
+    // Polling Properties
+    // ─────────────────────────────────────────────────────────────────────────
+    /** Polling timer reference */
+    this._pollingTimer = null;
     this.storeHandlers = config.serviceConfig.storeHandlers;
     this.optimisticConfig = config.serviceConfig.optimisticUpdates;
     if (config.mapperClass) {
@@ -5423,6 +5430,87 @@ var BaseFrontendDomainService = class _BaseFrontendDomainService extends BaseDom
     this.logDebug(`Event emitted: ${eventName}`, payload);
   }
   // ─────────────────────────────────────────────────────────────────────────
+  // Polling (Generic Feature)
+  // ─────────────────────────────────────────────────────────────────────────
+  /**
+   * Check if polling is currently active.
+   */
+  get isPolling() {
+    return this._pollingTimer !== null;
+  }
+  /**
+   * Start polling for updates.
+   * Uses `config.pollingInterval` if set, otherwise uses DEFAULT_POLLING_INTERVAL_MS (30s).
+   * Polling calls fetchAll() at the configured interval.
+   *
+   * Override in subclass for custom polling behavior.
+   *
+   * @example
+   * ```typescript
+   * // Start polling with config interval
+   * service.startPolling();
+   *
+   * // Or override in subclass for custom behavior
+   * startPolling(): void {
+   *   super.startPolling();
+   *   // Custom polling logic
+   * }
+   * ```
+   */
+  startPolling() {
+    if (this._pollingTimer) return;
+    const interval = this.config.pollingInterval || DEFAULT_POLLING_INTERVAL_MS;
+    this._pollingTimer = setInterval(() => {
+      this.fetchAll().catch((error) => {
+        this.logError("Polling fetch failed", { error });
+      });
+    }, interval);
+    this.logDebug("Polling started", { interval });
+  }
+  /**
+   * Stop polling.
+   * Safe to call even if polling is not active.
+   */
+  stopPolling() {
+    if (this._pollingTimer) {
+      clearInterval(this._pollingTimer);
+      this._pollingTimer = null;
+      this.logDebug("Polling stopped");
+    }
+  }
+  // ─────────────────────────────────────────────────────────────────────────
+  // Lifecycle Management
+  // ─────────────────────────────────────────────────────────────────────────
+  /**
+   * Dispose service and cleanup resources.
+   * Stops polling and performs base cleanup.
+   *
+   * Subclasses should override and call super.dispose() to ensure cleanup.
+   *
+   * @example
+   * ```typescript
+   * dispose(): void {
+   *   // Custom cleanup
+   *   this.customCleanup();
+   *   // Always call super
+   *   super.dispose();
+   * }
+   * ```
+   */
+  dispose() {
+    this.stopPolling();
+    this.logInfo("Service disposed");
+  }
+  /**
+   * Check if service is available.
+   * Override in subclass for custom availability checks.
+   *
+   * @returns true if service is enabled and in a browser environment
+   */
+  isAvailable() {
+    return this.isServiceEnabled && typeof window !== "undefined";
+  }
+  // ─────────────────────────────────────────────────────────────────────────
   // Error Handling Helpers
   // ─────────────────────────────────────────────────────────────────────────
   /**
@@ -6301,7 +6389,6 @@ var ExampleMapperClass = class extends BaseMapper {
 };
 
 // src/domain/example/FrontendExampleDomainService.ts
-var DEFAULT_POLLING_INTERVAL_MS = 3e4;
 var FrontendExampleDomainService = class _FrontendExampleDomainService extends BaseFrontendDomainService {
   // ─────────────────────────────────────────────────────────────────────────
   // Constructor
@@ -6376,15 +6463,6 @@ var FrontendExampleDomainService = class _FrontendExampleDomainService extends B
      * Required by BaseFrontendDomainService
      */
     this.eventPrefix = "example";
-    /**
-     * Read-only store keys - inherits error and featureFlags from base
-     * No need to redeclare them - they're always included by default
-     */
-    // protected readStoreKeys = [...super.readStoreKeys]; // Already includes ERROR, FEATURE_FLAGS
-    // ─────────────────────────────────────────────────────────────────────────
-    // Domain-Specific Properties
-    // ─────────────────────────────────────────────────────────────────────────
-    this.pollingTimer = null;
     if (this.config.pollingInterval && this.config.pollingInterval > 0) {
       this.startPolling();
     }
@@ -6393,6 +6471,11 @@ var FrontendExampleDomainService = class _FrontendExampleDomainService extends B
     __name(this, "FrontendExampleDomainService");
   }
   static {
+    /**
+     * Read-only store keys - inherits error and featureFlags from base
+     * No need to redeclare them - they're always included by default
+     */
+    // protected readStoreKeys = [...super.readStoreKeys]; // Already includes ERROR, FEATURE_FLAGS
     // ─────────────────────────────────────────────────────────────────────────
     // Static: Service Registry Interface
     // ─────────────────────────────────────────────────────────────────────────
@@ -6426,18 +6509,10 @@ var FrontendExampleDomainService = class _FrontendExampleDomainService extends B
     return service;
   }
   // ─────────────────────────────────────────────────────────────────────────
-  // Abstract Implementations (Required by BaseDomainService)
-  // ─────────────────────────────────────────────────────────────────────────
-  isAvailable() {
-    return this.isServiceEnabled && typeof window !== "undefined";
-  }
-  dispose() {
-    this.stopPolling();
-    this.logInfo("Service disposed");
-  }
-  // ─────────────────────────────────────────────────────────────────────────
   // Lifecycle Hooks (Optional Override Examples)
   // ─────────────────────────────────────────────────────────────────────────
+  // Note: isAvailable(), dispose(), startPolling(), stopPolling() are inherited
+  // from BaseFrontendDomainService. Override here only if custom behavior needed.
   /**
    * After fetchAll - emit event (store sync handled automatically)
    * Note: Base class automatically calls syncToStores() which uses storeHandlers
@@ -6485,35 +6560,9 @@ var FrontendExampleDomainService = class _FrontendExampleDomainService extends B
     return CoreEventManager.on(event, handler);
   }
   // ─────────────────────────────────────────────────────────────────────────
-  // Polling (Domain-Specific Feature)
-  // ─────────────────────────────────────────────────────────────────────────
-  /**
-   * Start polling for updates
-   * Domain-specific feature - not part of base class
-   */
-  startPolling() {
-    if (this.pollingTimer) return;
-    const interval = this.config.pollingInterval ?? DEFAULT_POLLING_INTERVAL_MS;
-    this.pollingTimer = setInterval(() => {
-      this.fetchAll().catch((error) => {
-        this.logError("Polling fetch failed", { error });
-      });
-    }, interval);
-    this.logDebug("Polling started", { interval });
-  }
-  /**
-   * Stop polling
-   */
-  stopPolling() {
-    if (this.pollingTimer) {
-      clearInterval(this.pollingTimer);
-      this.pollingTimer = null;
-      this.logDebug("Polling stopped");
-    }
-  }
-  // ─────────────────────────────────────────────────────────────────────────
   // Demo Methods - fetchAll() with Query Examples
   // ─────────────────────────────────────────────────────────────────────────
+  // Note: startPolling() and stopPolling() are inherited from BaseFrontendDomainService
   /**
    * Demo: Fetch all examples with optional filters
    * Demonstrates the fetchAll() method with typed query parameters