@plyaz/core 1.8.1 → 1.8.3

package/dist/entry-backend.mjs

@@ -2391,10 +2391,16 @@ var init_ServiceRegistry = __esm({
         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));
@@ -2432,7 +2438,7 @@ var init_ServiceRegistry = __esm({
           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(
@@ -3983,6 +3989,13 @@ var init_CoreInitializer = __esm({
       /** 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";
@@ -4002,6 +4015,7 @@ var init_CoreInitializer = __esm({
       /**
        * 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);
@@ -4014,11 +4028,16 @@ var init_CoreInitializer = __esm({
           );
         }
         _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
@@ -4439,13 +4458,14 @@ var init_BaseFrontendDomainService = __esm({
     init_BaseDomainService();
     init_CoreEventManager();
     init_CoreInitializer();
-    BaseFrontendDomainService = class extends BaseDomainService {
+    BaseFrontendDomainService = class _BaseFrontendDomainService extends BaseDomainService {
       // ─────────────────────────────────────────────────────────────────────────
       // Constructor
       // ─────────────────────────────────────────────────────────────────────────
       // eslint-disable-next-line complexity
       constructor(config) {
-        super(config);
+        const resolvedConfig = _BaseFrontendDomainService.resolveApiClientConfig(config);
+        super(resolvedConfig);
         // ─────────────────────────────────────────────────────────────────────────
         // Store Properties
         // ─────────────────────────────────────────────────────────────────────────
@@ -4471,6 +4491,11 @@ var init_BaseFrontendDomainService = __esm({
         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(
@@ -4489,9 +4514,12 @@ var init_BaseFrontendDomainService = __esm({
             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) {
@@ -4516,6 +4544,66 @@ var init_BaseFrontendDomainService = __esm({
       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)
       // ─────────────────────────────────────────────────────────────────────────
@@ -4988,7 +5076,7 @@ var init_BaseFrontendDomainService = __esm({
        */
       // 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(
@@ -5073,7 +5161,7 @@ var init_BaseFrontendDomainService = __esm({
        */
       // 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(
@@ -5134,7 +5222,7 @@ var init_BaseFrontendDomainService = __esm({
        */
       // 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(
@@ -5227,7 +5315,7 @@ var init_BaseFrontendDomainService = __esm({
        */
       // 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(
@@ -5316,7 +5404,7 @@ var init_BaseFrontendDomainService = __esm({
        */
       // 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(
@@ -7741,14 +7829,11 @@ var init_FrontendExampleDomainService = __esm({
       // ─────────────────────────────────────────────────────────────────────────
       // 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,
@@ -7812,10 +7897,6 @@ var init_FrontendExampleDomainService = __esm({
          * 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
@@ -7838,6 +7919,14 @@ var init_FrontendExampleDomainService = __esm({
         // ─────────────────────────────────────────────────────────────────────────
         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.