@plyaz/core 1.9.3 → 1.9.4

package/dist/index.mjs

@@ -4593,6 +4593,7 @@ var BaseDomainService = class {
     );
   }
 };
+var DEFAULT_POLLING_INTERVAL_MS = 3e4;
 var BaseFrontendDomainService = class _BaseFrontendDomainService extends BaseDomainService {
   // ─────────────────────────────────────────────────────────────────────────
   // Constructor
@@ -4618,6 +4619,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) {
@@ -5644,6 +5650,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
   // ─────────────────────────────────────────────────────────────────────────
   /**
@@ -12924,7 +13011,6 @@ var BackendExampleDomainService = class _BackendExampleDomainService extends Bas
   // ─────────────────────────────────────────────────────────────────────────
 };
 var backendExampleDomainService = new BackendExampleDomainService();
-var DEFAULT_POLLING_INTERVAL_MS = 3e4;
 var FrontendExampleDomainService = class _FrontendExampleDomainService extends BaseFrontendDomainService {
   // ─────────────────────────────────────────────────────────────────────────
   // Constructor
@@ -12999,15 +13085,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();
     }
@@ -13016,6 +13093,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
     // ─────────────────────────────────────────────────────────────────────────
@@ -13049,18 +13131,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
@@ -13108,35 +13182,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