@plyaz/core 1.8.1 → 1.8.3

package/dist/entry-frontend-browser.mjs

@@ -2255,10 +2255,16 @@ var ServiceRegistry = class _ServiceRegistry {
     return initPromise;
   }
   /** Build stores for service injection */
-  static buildStoresForService(config) {
+  // eslint-disable-next-line complexity
+  static buildStoresForService(config, entry) {
     const allKeys = /* @__PURE__ */ new Set();
     if (config.store) {
       allKeys.add(config.store);
+    } else if ("primaryStoreKey" in entry.service && typeof entry.service.primaryStoreKey === "string") {
+      allKeys.add(entry.service.primaryStoreKey);
+      _ServiceRegistry.logger.debug(
+        `Auto-resolved store key '${entry.service.primaryStoreKey}' from service class`
+      );
     }
     if (config.readStores) {
       config.readStores.forEach((key) => allKeys.add(key));
@@ -2296,7 +2302,7 @@ var ServiceRegistry = class _ServiceRegistry {
       const observability = _ServiceRegistry.buildObservabilityConfig(config, entry);
       const storage = await _ServiceRegistry.buildStorageConfig(config, entry);
       const notifications = await _ServiceRegistry.buildNotificationsConfig(config, entry);
-      const stores = _ServiceRegistry.buildStoresForService(config);
+      const stores = _ServiceRegistry.buildStoresForService(config, entry);
       let observabilityInstance = observability?.instance;
       if (observability?.dedicated && observability.config) {
         observabilityInstance = await _ServiceRegistry.createDedicatedObservability(
@@ -3825,6 +3831,13 @@ var Core = class _Core {
   /** Create fetch flags function */
   static createFetchFlagsFn(config, verbose) {
     return async () => {
+      if (config?.provider !== "api") {
+        _Core.log(
+          `Feature flags using ${config?.provider ?? "default"} provider (no API fetch)`,
+          verbose
+        );
+        return config?.defaults ?? {};
+      }
       try {
         const client = ApiClientService.getClient();
         const endpoint = config?.apiEndpoint ?? "/feature-flags";
@@ -3844,6 +3857,7 @@ var Core = class _Core {
   /**
    * Initialize feature flags slice within root store
    */
+  // eslint-disable-next-line complexity
   static async initializeFeatureFlags(config, verbose) {
     if (config?.enabled === false) {
       _Core.log("Feature flags disabled by configuration", verbose);
@@ -3856,11 +3870,16 @@ var Core = class _Core {
       );
     }
     _Core._flagConfig = config ?? {};
-    _Core.log("Initializing feature flags from root store...", verbose);
+    const isApiProvider = config?.provider === "api";
+    _Core.log(
+      `Initializing feature flags from root store (provider: ${config?.provider ?? "default"})...`,
+      verbose
+    );
     const state = _Core._rootStore.getState();
     await state.featureFlags.initialize({
       defaults: _Core._flagConfig.defaults,
-      polling: _Core._flagConfig.polling,
+      // Only enable polling for API provider
+      polling: isApiProvider ? _Core._flagConfig.polling : void 0,
       fetchFn: _Core.createFetchFlagsFn(_Core._flagConfig, verbose),
       onFlagChange: _Core._flagConfig.onFlagChange,
       onError: _Core._flagConfig.onError
@@ -4267,13 +4286,14 @@ var BaseDomainService = class {
     );
   }
 };
-var BaseFrontendDomainService = class extends BaseDomainService {
+var BaseFrontendDomainService = class _BaseFrontendDomainService extends BaseDomainService {
   // ─────────────────────────────────────────────────────────────────────────
   // Constructor
   // ─────────────────────────────────────────────────────────────────────────
   // eslint-disable-next-line complexity
   constructor(config) {
-    super(config);
+    const resolvedConfig = _BaseFrontendDomainService.resolveApiClientConfig(config);
+    super(resolvedConfig);
     // ─────────────────────────────────────────────────────────────────────────
     // Store Properties
     // ─────────────────────────────────────────────────────────────────────────
@@ -4299,6 +4319,11 @@ var BaseFrontendDomainService = class extends BaseDomainService {
     const serviceConfig = config.serviceConfig;
     if (serviceConfig.store !== void 0) {
       this.primaryStoreKey = serviceConfig.store;
+    } else {
+      const staticKey = this.constructor.primaryStoreKey;
+      if (staticKey) {
+        this.primaryStoreKey = staticKey;
+      }
     }
     if (serviceConfig.readStores !== void 0) {
       this.readStoreKeys = Array.from(
@@ -4317,9 +4342,12 @@ var BaseFrontendDomainService = class extends BaseDomainService {
         this._primaryStore = primaryStore;
         this.logDebug(`Connected primary store: '${this.primaryStoreKey}'`);
       } else {
-        this.logWarn(
-          `Primary store '${this.primaryStoreKey}' not found. Store mutations (setData/updateData/setLoading) will be disabled. Configure stores in PlyazProvider to enable store integration.`
-        );
+        const isServer = typeof globalThis.window === "undefined";
+        if (!isServer) {
+          this.logWarn(
+            `Primary store '${this.primaryStoreKey}' not found. Store mutations (setData/updateData/setLoading) will be disabled. Configure stores in PlyazProvider to enable store integration.`
+          );
+        }
       }
     }
     for (const key of this.readStoreKeys) {
@@ -4344,6 +4372,66 @@ var BaseFrontendDomainService = class extends BaseDomainService {
   static {
     __name(this, "BaseFrontendDomainService");
   }
+  /**
+   * Auto-resolve apiClientConfig from serviceConfig.apiBasePath if not explicitly provided.
+   * This reduces boilerplate in child services - they only need to set apiBasePath in config.
+   *
+   * Priority:
+   * 1. Explicit apiClientConfig.baseURL (full control)
+   * 2. serviceConfig.apiBasePath (auto-constructed, merged with injected options)
+   * 3. undefined (no API client)
+   *
+   * When auto-constructing, merges injected API options (headers, timeout, etc.)
+   * with the service's apiBasePath as baseURL.
+   */
+  static resolveApiClientConfig(config) {
+    if (config.apiClientConfig?.baseURL) {
+      return config;
+    }
+    const apiBasePath = config.serviceConfig.apiBasePath;
+    if (apiBasePath) {
+      const injectedOptions = config.injected?.api ? {} : config.apiClientConfig ?? {};
+      return {
+        ...config,
+        apiClientConfig: {
+          ...injectedOptions,
+          baseURL: apiBasePath
+          // Service's apiBasePath always takes precedence
+        }
+      };
+    }
+    return config;
+  }
+  /**
+   * Initialize service and wait for API client to be ready.
+   * Call this in child service's static create() method after constructing the instance.
+   *
+   * @param service - The service instance to initialize
+   * @returns The initialized service (same instance, for chaining)
+   *
+   * @example
+   * ```typescript
+   * static async create(config, options): Promise<MyService> {
+   *   const service = new MyService(config, options);
+   *   return this.initializeService(service);
+   * }
+   * ```
+   */
+  static async initializeService(service) {
+    await service.ensureApiClientInitialized();
+    return service;
+  }
+  /**
+   * Ensure service is ready for operations.
+   * Checks enabled/available status AND waits for API client initialization.
+   * Call this at the start of all CRUD methods.
+   *
+   * @throws CorePackageError if service is not enabled or available
+   */
+  async ensureReady() {
+    this.assertReady();
+    await this.ensureApiClientInitialized();
+  }
   // ─────────────────────────────────────────────────────────────────────────
   // Store Management (Public API)
   // ─────────────────────────────────────────────────────────────────────────
@@ -4816,7 +4904,7 @@ var BaseFrontendDomainService = class extends BaseDomainService {
    */
   // eslint-disable-next-line complexity
   async fetchAll(query, options) {
-    this.assertReady();
+    await this.ensureReady();
     const startTime = Date.now();
     if (!this.config.fetchers?.fetchAll) {
       throw new CorePackageError(
@@ -4901,7 +4989,7 @@ var BaseFrontendDomainService = class extends BaseDomainService {
    */
   // eslint-disable-next-line complexity
   async fetchById(id, options) {
-    this.assertReady();
+    await this.ensureReady();
     const startTime = Date.now();
     if (!this.config.fetchers?.fetchById) {
       throw new CorePackageError(
@@ -4962,7 +5050,7 @@ var BaseFrontendDomainService = class extends BaseDomainService {
    */
   // eslint-disable-next-line complexity, max-lines-per-function
   async create(data, options) {
-    this.assertReady();
+    await this.ensureReady();
     const startTime = Date.now();
     if (!this.config.fetchers?.create) {
       throw new CorePackageError(
@@ -5055,7 +5143,7 @@ var BaseFrontendDomainService = class extends BaseDomainService {
    */
   // eslint-disable-next-line complexity, max-lines-per-function
   async update(id, data, options) {
-    this.assertReady();
+    await this.ensureReady();
     const startTime = Date.now();
     if (!this.config.fetchers?.update) {
       throw new CorePackageError(
@@ -5144,7 +5232,7 @@ var BaseFrontendDomainService = class extends BaseDomainService {
    */
   // eslint-disable-next-line complexity
   async delete(id, options) {
-    this.assertReady();
+    await this.ensureReady();
     const startTime = Date.now();
     if (!this.config.fetchers?.delete) {
       throw new CorePackageError(
@@ -6115,14 +6203,11 @@ var FrontendExampleDomainService = class _FrontendExampleDomainService extends B
   // ─────────────────────────────────────────────────────────────────────────
   // Constructor
   // ─────────────────────────────────────────────────────────────────────────
-  // eslint-disable-next-line complexity
   constructor(config = {}, options) {
     const apiBasePath = config.apiBasePath ?? "/api/examples";
     super({
       serviceName: "ExampleFrontendService",
       supportedRuntimes: ["frontend"],
-      // API client config - uses injected options or creates from apiBasePath
-      apiClientConfig: options?.apiClient?.options ?? { baseURL: apiBasePath },
       serviceConfig: {
         enabled: true,
         apiBasePath,
@@ -6186,10 +6271,6 @@ var FrontendExampleDomainService = class _FrontendExampleDomainService extends B
      * Required by BaseFrontendDomainService
      */
     this.eventPrefix = "example";
-    /**
-     * Primary store key - the store this service can mutate
-     */
-    this.primaryStoreKey = STORE_KEYS.EXAMPLE;
     /**
      * Read-only store keys - inherits error and featureFlags from base
      * No need to redeclare them - they're always included by default
@@ -6212,6 +6293,14 @@ var FrontendExampleDomainService = class _FrontendExampleDomainService extends B
     // ─────────────────────────────────────────────────────────────────────────
     this.serviceKey = SERVICE_KEYS.EXAMPLE_FRONTEND;
   }
+  static {
+    /**
+     * Primary store key for this service.
+     * Used by ServiceRegistry to auto-inject the store if not specified in config.
+     * Also used by base class constructor to set instance primaryStoreKey.
+     */
+    this.primaryStoreKey = STORE_KEYS.EXAMPLE;
+  }
   /**
    * Factory method for ServiceRegistry auto-initialization.
    * Creates and initializes the service instance.