@plyaz/core 1.9.3 → 1.9.4

package/dist/entry-backend.mjs

@@ -4533,12 +4533,13 @@ var init_BaseDomainService = __esm({
     };
   }
 });
-var BaseFrontendDomainService;
+var DEFAULT_POLLING_INTERVAL_MS, BaseFrontendDomainService;
 var init_BaseFrontendDomainService = __esm({
   "src/domain/base/BaseFrontendDomainService.ts"() {
     init_BaseDomainService();
     init_CoreEventManager();
     init_CoreInitializer();
+    DEFAULT_POLLING_INTERVAL_MS = 3e4;
     BaseFrontendDomainService = class _BaseFrontendDomainService extends BaseDomainService {
       // ─────────────────────────────────────────────────────────────────────────
       // Constructor
@@ -4564,6 +4565,11 @@ var init_BaseFrontendDomainService = __esm({
         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) {
@@ -5590,6 +5596,87 @@ var init_BaseFrontendDomainService = __esm({
         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
       // ─────────────────────────────────────────────────────────────────────────
       /**
@@ -7916,13 +8003,12 @@ var FrontendExampleDomainService_exports = {};
 __export(FrontendExampleDomainService_exports, {
   FrontendExampleDomainService: () => FrontendExampleDomainService
 });
-var DEFAULT_POLLING_INTERVAL_MS, FrontendExampleDomainService;
+var FrontendExampleDomainService;
 var init_FrontendExampleDomainService = __esm({
   "src/domain/example/FrontendExampleDomainService.ts"() {
     init_BaseFrontendDomainService();
     init_CoreEventManager();
     init_ExampleMapper();
-    DEFAULT_POLLING_INTERVAL_MS = 3e4;
     FrontendExampleDomainService = class _FrontendExampleDomainService extends BaseFrontendDomainService {
       // ─────────────────────────────────────────────────────────────────────────
       // Constructor
@@ -7997,15 +8083,6 @@ var init_FrontendExampleDomainService = __esm({
          * 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();
         }
@@ -8014,6 +8091,11 @@ var init_FrontendExampleDomainService = __esm({
         __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
         // ─────────────────────────────────────────────────────────────────────────
@@ -8047,18 +8129,10 @@ var init_FrontendExampleDomainService = __esm({
         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
@@ -8106,35 +8180,9 @@ var init_FrontendExampleDomainService = __esm({
         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