@plyaz/core 1.8.2 → 1.8.4

package/dist/index.mjs

@@ -4059,6 +4059,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";
@@ -4078,6 +4085,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);
@@ -4090,11 +4098,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
@@ -4557,9 +4570,12 @@ var BaseFrontendDomainService = class _BaseFrontendDomainService extends BaseDom
         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) {
@@ -4614,6 +4630,36 @@ var BaseFrontendDomainService = class _BaseFrontendDomainService extends BaseDom
     }
     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)
   // ─────────────────────────────────────────────────────────────────────────
@@ -5086,7 +5132,7 @@ var BaseFrontendDomainService = class _BaseFrontendDomainService extends BaseDom
    */
   // 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(
@@ -5171,7 +5217,7 @@ var BaseFrontendDomainService = class _BaseFrontendDomainService extends BaseDom
    */
   // 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(
@@ -5232,7 +5278,7 @@ var BaseFrontendDomainService = class _BaseFrontendDomainService extends BaseDom
    */
   // 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(
@@ -5325,7 +5371,7 @@ var BaseFrontendDomainService = class _BaseFrontendDomainService extends BaseDom
    */
   // 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(
@@ -5414,7 +5460,7 @@ var BaseFrontendDomainService = class _BaseFrontendDomainService extends BaseDom
    */
   // 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(
@@ -11580,7 +11626,10 @@ var FrontendFeatureFlagDomainService = class _FrontendFeatureFlagDomainService e
   }
   /** Build API client for feature flags */
   static async buildApiClient(config, options) {
-    const apiBasePath = config.apiBasePath ?? options?.apiClient?.options?.baseURL ?? "/feature-flags";
+    const apiBasePath = (
+      // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing
+      config.apiBasePath || options?.apiClient?.options?.baseURL || "/feature-flags"
+    );
     return createApiClient({ ...options?.apiClient?.options, baseURL: apiBasePath });
   }
   /** Build feature flag provider */
@@ -12784,9 +12833,8 @@ var FrontendExampleDomainService = class _FrontendExampleDomainService extends B
   // ─────────────────────────────────────────────────────────────────────────
   // Constructor
   // ─────────────────────────────────────────────────────────────────────────
-  // eslint-disable-next-line complexity
   constructor(config = {}, options) {
-    const apiBasePath = config.apiBasePath ?? "/api/examples";
+    const apiBasePath = config.apiBasePath || "/api/examples";
     super({
       serviceName: "ExampleFrontendService",
       supportedRuntimes: ["frontend"],
@@ -12890,7 +12938,11 @@ var FrontendExampleDomainService = class _FrontendExampleDomainService extends B
   static async create(config, options) {
     const mergedConfig = {
       ...config,
-      apiBasePath: config.apiBasePath ?? options?.apiClient?.options?.baseURL ?? "/api/examples"
+      // Use || instead of ?? because api.baseURL may be '' (empty string) for same-origin requests.
+      // The ?? operator only falls through on null/undefined, not empty strings.
+      // An empty string is not a valid API path, so we treat it as "not provided" and fall through to default.
+      // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing
+      apiBasePath: config.apiBasePath || options?.apiClient?.options?.baseURL || "/api/examples"
     };
     const service = new _FrontendExampleDomainService(mergedConfig, options);
     if (mergedConfig.autoFetch) {