@envive-ai/react-hooks 0.3.63 → 0.3.65

package/src/services/hardcopyService/__tests__/hardcopyService.test.ts

@@ -92,6 +92,7 @@ describe('HardcopyService', () => {
           titleLabel: 'Hello World',
           promptButtonTexts: ['Prompt 1', 'Prompt 2'],
         },
+        servedFrom: 'api',
       });
     });
 
@@ -383,7 +384,11 @@ describe('HardcopyService', () => {
         userEvent: {} as any,
       });
 
-      expect(result).toBe(MOCK_HARDCOPY_RESPONSE[WidgetTypeV3.PromptCarouselV3]);
+      expect(result).toEqual({
+        ...MOCK_HARDCOPY_RESPONSE[WidgetTypeV3.PromptCarouselV3],
+        servedFrom: 'static',
+        fallbackReason: 'error',
+      });
     });
 
     it('returns the MOCK_HARDCOPY_RESPONSE entry when the API returns falsy', async () => {
@@ -394,7 +399,11 @@ describe('HardcopyService', () => {
         userEvent: {} as any,
       });
 
-      expect(result).toBe(MOCK_HARDCOPY_RESPONSE[WidgetTypeV3.SocialProofV3]);
+      expect(result).toEqual({
+        ...MOCK_HARDCOPY_RESPONSE[WidgetTypeV3.SocialProofV3],
+        servedFrom: 'static',
+        fallbackReason: 'error',
+      });
     });
 
     it('does not fire WidgetTextResponse when falling back to mock', async () => {
@@ -437,9 +446,11 @@ describe('HardcopyService', () => {
 
         await vi.advanceTimersByTimeAsync(HARDCOPY_TIMEOUT_MS);
 
-        await expect(resultPromise).resolves.toBe(
-          MOCK_HARDCOPY_RESPONSE[WidgetTypeV3.PromptCarouselV3],
-        );
+        await expect(resultPromise).resolves.toEqual({
+          ...MOCK_HARDCOPY_RESPONSE[WidgetTypeV3.PromptCarouselV3],
+          servedFrom: 'static',
+          fallbackReason: 'timeout',
+        });
       } finally {
         vi.useRealTimers();
       }

package/src/services/hardcopyService/hardcopyService.ts

@@ -49,6 +49,10 @@ export type HardcopyResponse = {
   language: string;
   rawValues?: Record<string, WidgetString | WidgetString[]>;
   values: Record<string, string | string[]>;
+  // How the copy was served, for widget-load diagnostics: 'api' = live backend response,
+  // 'static' = fell back to the bundled MOCK_HARDCOPY_RESPONSE after a backend error or timeout.
+  servedFrom?: 'api' | 'static';
+  fallbackReason?: 'timeout' | 'error';
 };
 
 export interface IHardcopyService {
@@ -265,6 +269,8 @@ export class HardcopyService implements IHardcopyService {
       },
     });
 
+    // Reason the API path failed, surfaced on the static fallback for widget-load diagnostics.
+    let fallbackReason: 'timeout' | 'error' | undefined;
     try {
       const response = await withTimeout(
         CommerceApiClient.getHardcopy(widgetTextRequest),
@@ -287,16 +293,18 @@ export class HardcopyService implements IHardcopyService {
               : {}),
           },
         });
-        return convertedResponse;
+        return { ...convertedResponse, servedFrom: 'api' };
       }
     } catch (error) {
       logger.logError('error getting hardcopy from backend', error);
+      fallbackReason =
+        error instanceof Error && error.message.includes('timed out') ? 'timeout' : 'error';
     }
 
     const mockResponse = MOCK_HARDCOPY_RESPONSE[request.widgetType];
     if (mockResponse) {
       logger.logDebug('no real response, using mock', mockResponse);
-      return mockResponse;
+      return { ...mockResponse, servedFrom: 'static', fallbackReason: fallbackReason ?? 'error' };
     }
     throw new Error(`No hardcopy response found for widget type: ${request.widgetType}`);
   }

package/dist/application/models/graphql/queries/getWidgetConfigQuery.cjs

@@ -1,42 +0,0 @@
-
-//#region src/application/models/graphql/queries/getWidgetConfigQuery.ts
-const getWidgetConfigQuery = () => `
-  query($userId: String!, $version: String, $gateNames: [String!], $source: String) {
-    me {
-      org {
-        id
-        shortName
-        displayName
-        domain
-        createdAt
-        updatedAt
-      }
-      getWidgetConfig(userId: $userId, version: $version, gateNames: $gateNames, source: $source) {
-        productsConfig {
-          frontend { values }
-          colors { values }
-          v_three_config { values }
-        }
-        gates {
-          name
-          value
-          groupName
-        }
-        experimentAssignments {
-          layerName
-          namespace
-          allocatedExperimentName
-          groupName
-        }
-        resolution {
-          baseVersion
-          baseVersionSource
-        }
-      }
-    }
-  }
-`;
-
-//#endregion
-exports.getWidgetConfigQuery = getWidgetConfigQuery;
-//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2V0V2lkZ2V0Q29uZmlnUXVlcnkuY2pzIiwibmFtZXMiOltdLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3NyYy9hcHBsaWNhdGlvbi9tb2RlbHMvZ3JhcGhxbC9xdWVyaWVzL2dldFdpZGdldENvbmZpZ1F1ZXJ5LnRzIl0sInNvdXJjZXNDb250ZW50IjpbIi8vIFN0YXRzaWctZXhwZXJpbWVudC1hd2FyZSB1bmlmaWVkIGNvbmZpZyBlbmRwb2ludCDigJQgdGhlIHNpbmdsZSBzb3VyY2Ugb2Zcbi8vIHNlc3Npb24gY29uZmlnLiBSZXR1cm5zIHByb2R1Y3RzQ29uZmlnLCB0aGUgcmVzb2x1dGlvbiBtZXRhZGF0YSBweW1vbm8gdXNlZFxuLy8gdG8gcGljayB0aGUgdmVyc2lvbiAodGhlIGNsaWVudCB0aHJlYWRzIGByZXNvbHV0aW9uLmJhc2VWZXJzaW9uYCBpbnRvXG4vLyBkb3duc3RyZWFtIGluZmVyZW5jZSByZXF1ZXN0cyBzbyB0aGV5J3JlIHNjb3BlZCB0byB0aGUgdmVyc2lvbiB0aGF0IHByb2R1Y2VkXG4vLyB0aGUgcmVuZGVyZWQgd2lkZ2V0cyksIEFORCB0aGUgb3JnIGlkZW50aXR5ICsgZmVhdHVyZSBnYXRlcyArIGV4cGVyaW1lbnRcbi8vIGFzc2lnbm1lbnRzIHRoYXQgdXNlZCB0byBjb21lIGZyb20gUkVTVCBgL3YxL29yZy9jb25maWdgLiBQdWxsaW5nIGFsbCBvZiBpdFxuLy8gaGVyZSBsZXRzIHRoZSBjbGllbnQgZHJvcCB0aGUgc2VwYXJhdGUgb3JnL2NvbmZpZyBjYWxsLlxuLy9cbi8vIHVzZXJJZCBpcyByZXF1aXJlZCBieSB0aGUgc2NoZW1hIChTdHJpbmchKSBhbmQgZmVlZHMgU3RhdHNpZyBsYXllclxuLy8gcmVzb2x1dGlvbiBzZXJ2ZXItc2lkZS4gc291cmNlIGZlZWRzIFN0YXRzaWcgdXNlciBwcm9wZXJ0aWVzLlxuLy9cbi8vIGdhdGVOYW1lcyBzZWxlY3RzIHdoaWNoIGZlYXR1cmUgZ2F0ZXMgdG8gZXZhbHVhdGUgYW5kIHJldHVybiDigJQgcGFzcyB0aGUgc2FtZVxuLy8gbGlzdCB0aGUgYXBwIGNoZWNrcyAodGhlIGBGZWF0dXJlR2F0ZXNgIGVudW0gdmFsdWVzKTsgdGhlIHJlc29sdmVyIHJldHVybnMgYW5cbi8vIGVtcHR5IGBnYXRlc2AgbGlzdCB3aGVuIG5vbmUgYXJlIHJlcXVlc3RlZC5cbi8vXG4vLyB2ZXJzaW9uIGlzIG9wdGlvbmFsOyB3aGVuIG9taXR0ZWQgKG5vIGBzcGlmZnlfY29uZmlnX3ZlcnNpb25gIC9cbi8vIGBlbnZpdmVfY29uZmlnX3ZlcnNpb25gIFVSTCBwYXJhbSkgdGhlIHJlc29sdmVyIHVzZXMgU3RhdHNpZyBidWNrZXRpbmcuXG4vLyBXaGVuIHNldCwgaXQgYnlwYXNzZXMgdGhlIG1lcmNoYW50IGV4cGVyaW1lbnQgYW5kIHBpbnMgdG8gdGhhdCBleGFjdCB2ZXJzaW9uXG4vLyAoZW1wdHkgZXhwZXJpbWVudEFzc2lnbm1lbnRzKSDigJQgdGhlIFFBIC8gcm9sbGJhY2sgYWZmb3JkYW5jZS5cbmV4cG9ydCBjb25zdCBnZXRXaWRnZXRDb25maWdRdWVyeSA9ICgpID0+IGBcbiAgcXVlcnkoJHVzZXJJZDogU3RyaW5nISwgJHZlcnNpb246IFN0cmluZywgJGdhdGVOYW1lczogW1N0cmluZyFdLCAkc291cmNlOiBTdHJpbmcpIHtcbiAgICBtZSB7XG4gICAgICBvcmcge1xuICAgICAgICBpZFxuICAgICAgICBzaG9ydE5hbWVcbiAgICAgICAgZGlzcGxheU5hbWVcbiAgICAgICAgZG9tYWluXG4gICAgICAgIGNyZWF0ZWRBdFxuICAgICAgICB1cGRhdGVkQXRcbiAgICAgIH1cbiAgICAgIGdldFdpZGdldENvbmZpZyh1c2VySWQ6ICR1c2VySWQsIHZlcnNpb246ICR2ZXJzaW9uLCBnYXRlTmFtZXM6ICRnYXRlTmFtZXMsIHNvdXJjZTogJHNvdXJjZSkge1xuICAgICAgICBwcm9kdWN0c0NvbmZpZyB7XG4gICAgICAgICAgZnJvbnRlbmQgeyB2YWx1ZXMgfVxuICAgICAgICAgIGNvbG9ycyB7IHZhbHVlcyB9XG4gICAgICAgICAgdl90aHJlZV9jb25maWcgeyB2YWx1ZXMgfVxuICAgICAgICB9XG4gICAgICAgIGdhdGVzIHtcbiAgICAgICAgICBuYW1lXG4gICAgICAgICAgdmFsdWVcbiAgICAgICAgICBncm91cE5hbWVcbiAgICAgICAgfVxuICAgICAgICBleHBlcmltZW50QXNzaWdubWVudHMge1xuICAgICAgICAgIGxheWVyTmFtZVxuICAgICAgICAgIG5hbWVzcGFjZVxuICAgICAgICAgIGFsbG9jYXRlZEV4cGVyaW1lbnROYW1lXG4gICAgICAgICAgZ3JvdXBOYW1lXG4gICAgICAgIH1cbiAgICAgICAgcmVzb2x1dGlvbiB7XG4gICAgICAgICAgYmFzZVZlcnNpb25cbiAgICAgICAgICBiYXNlVmVyc2lvblNvdXJjZVxuICAgICAgICB9XG4gICAgICB9XG4gICAgfVxuICB9XG5gO1xuIl0sIm1hcHBpbmdzIjoiOztBQW1CQSxNQUFhLDZCQUE2QiJ9

package/dist/application/models/graphql/queries/getWidgetConfigQuery.js

@@ -1,41 +0,0 @@
-//#region src/application/models/graphql/queries/getWidgetConfigQuery.ts
-const getWidgetConfigQuery = () => `
-  query($userId: String!, $version: String, $gateNames: [String!], $source: String) {
-    me {
-      org {
-        id
-        shortName
-        displayName
-        domain
-        createdAt
-        updatedAt
-      }
-      getWidgetConfig(userId: $userId, version: $version, gateNames: $gateNames, source: $source) {
-        productsConfig {
-          frontend { values }
-          colors { values }
-          v_three_config { values }
-        }
-        gates {
-          name
-          value
-          groupName
-        }
-        experimentAssignments {
-          layerName
-          namespace
-          allocatedExperimentName
-          groupName
-        }
-        resolution {
-          baseVersion
-          baseVersionSource
-        }
-      }
-    }
-  }
-`;
-
-//#endregion
-export { getWidgetConfigQuery };
-//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2V0V2lkZ2V0Q29uZmlnUXVlcnkuanMiLCJuYW1lcyI6W10sInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vc3JjL2FwcGxpY2F0aW9uL21vZGVscy9ncmFwaHFsL3F1ZXJpZXMvZ2V0V2lkZ2V0Q29uZmlnUXVlcnkudHMiXSwic291cmNlc0NvbnRlbnQiOlsiLy8gU3RhdHNpZy1leHBlcmltZW50LWF3YXJlIHVuaWZpZWQgY29uZmlnIGVuZHBvaW50IOKAlCB0aGUgc2luZ2xlIHNvdXJjZSBvZlxuLy8gc2Vzc2lvbiBjb25maWcuIFJldHVybnMgcHJvZHVjdHNDb25maWcsIHRoZSByZXNvbHV0aW9uIG1ldGFkYXRhIHB5bW9ubyB1c2VkXG4vLyB0byBwaWNrIHRoZSB2ZXJzaW9uICh0aGUgY2xpZW50IHRocmVhZHMgYHJlc29sdXRpb24uYmFzZVZlcnNpb25gIGludG9cbi8vIGRvd25zdHJlYW0gaW5mZXJlbmNlIHJlcXVlc3RzIHNvIHRoZXkncmUgc2NvcGVkIHRvIHRoZSB2ZXJzaW9uIHRoYXQgcHJvZHVjZWRcbi8vIHRoZSByZW5kZXJlZCB3aWRnZXRzKSwgQU5EIHRoZSBvcmcgaWRlbnRpdHkgKyBmZWF0dXJlIGdhdGVzICsgZXhwZXJpbWVudFxuLy8gYXNzaWdubWVudHMgdGhhdCB1c2VkIHRvIGNvbWUgZnJvbSBSRVNUIGAvdjEvb3JnL2NvbmZpZ2AuIFB1bGxpbmcgYWxsIG9mIGl0XG4vLyBoZXJlIGxldHMgdGhlIGNsaWVudCBkcm9wIHRoZSBzZXBhcmF0ZSBvcmcvY29uZmlnIGNhbGwuXG4vL1xuLy8gdXNlcklkIGlzIHJlcXVpcmVkIGJ5IHRoZSBzY2hlbWEgKFN0cmluZyEpIGFuZCBmZWVkcyBTdGF0c2lnIGxheWVyXG4vLyByZXNvbHV0aW9uIHNlcnZlci1zaWRlLiBzb3VyY2UgZmVlZHMgU3RhdHNpZyB1c2VyIHByb3BlcnRpZXMuXG4vL1xuLy8gZ2F0ZU5hbWVzIHNlbGVjdHMgd2hpY2ggZmVhdHVyZSBnYXRlcyB0byBldmFsdWF0ZSBhbmQgcmV0dXJuIOKAlCBwYXNzIHRoZSBzYW1lXG4vLyBsaXN0IHRoZSBhcHAgY2hlY2tzICh0aGUgYEZlYXR1cmVHYXRlc2AgZW51bSB2YWx1ZXMpOyB0aGUgcmVzb2x2ZXIgcmV0dXJucyBhblxuLy8gZW1wdHkgYGdhdGVzYCBsaXN0IHdoZW4gbm9uZSBhcmUgcmVxdWVzdGVkLlxuLy9cbi8vIHZlcnNpb24gaXMgb3B0aW9uYWw7IHdoZW4gb21pdHRlZCAobm8gYHNwaWZmeV9jb25maWdfdmVyc2lvbmAgL1xuLy8gYGVudml2ZV9jb25maWdfdmVyc2lvbmAgVVJMIHBhcmFtKSB0aGUgcmVzb2x2ZXIgdXNlcyBTdGF0c2lnIGJ1Y2tldGluZy5cbi8vIFdoZW4gc2V0LCBpdCBieXBhc3NlcyB0aGUgbWVyY2hhbnQgZXhwZXJpbWVudCBhbmQgcGlucyB0byB0aGF0IGV4YWN0IHZlcnNpb25cbi8vIChlbXB0eSBleHBlcmltZW50QXNzaWdubWVudHMpIOKAlCB0aGUgUUEgLyByb2xsYmFjayBhZmZvcmRhbmNlLlxuZXhwb3J0IGNvbnN0IGdldFdpZGdldENvbmZpZ1F1ZXJ5ID0gKCkgPT4gYFxuICBxdWVyeSgkdXNlcklkOiBTdHJpbmchLCAkdmVyc2lvbjogU3RyaW5nLCAkZ2F0ZU5hbWVzOiBbU3RyaW5nIV0sICRzb3VyY2U6IFN0cmluZykge1xuICAgIG1lIHtcbiAgICAgIG9yZyB7XG4gICAgICAgIGlkXG4gICAgICAgIHNob3J0TmFtZVxuICAgICAgICBkaXNwbGF5TmFtZVxuICAgICAgICBkb21haW5cbiAgICAgICAgY3JlYXRlZEF0XG4gICAgICAgIHVwZGF0ZWRBdFxuICAgICAgfVxuICAgICAgZ2V0V2lkZ2V0Q29uZmlnKHVzZXJJZDogJHVzZXJJZCwgdmVyc2lvbjogJHZlcnNpb24sIGdhdGVOYW1lczogJGdhdGVOYW1lcywgc291cmNlOiAkc291cmNlKSB7XG4gICAgICAgIHByb2R1Y3RzQ29uZmlnIHtcbiAgICAgICAgICBmcm9udGVuZCB7IHZhbHVlcyB9XG4gICAgICAgICAgY29sb3JzIHsgdmFsdWVzIH1cbiAgICAgICAgICB2X3RocmVlX2NvbmZpZyB7IHZhbHVlcyB9XG4gICAgICAgIH1cbiAgICAgICAgZ2F0ZXMge1xuICAgICAgICAgIG5hbWVcbiAgICAgICAgICB2YWx1ZVxuICAgICAgICAgIGdyb3VwTmFtZVxuICAgICAgICB9XG4gICAgICAgIGV4cGVyaW1lbnRBc3NpZ25tZW50cyB7XG4gICAgICAgICAgbGF5ZXJOYW1lXG4gICAgICAgICAgbmFtZXNwYWNlXG4gICAgICAgICAgYWxsb2NhdGVkRXhwZXJpbWVudE5hbWVcbiAgICAgICAgICBncm91cE5hbWVcbiAgICAgICAgfVxuICAgICAgICByZXNvbHV0aW9uIHtcbiAgICAgICAgICBiYXNlVmVyc2lvblxuICAgICAgICAgIGJhc2VWZXJzaW9uU291cmNlXG4gICAgICAgIH1cbiAgICAgIH1cbiAgICB9XG4gIH1cbmA7XG4iXSwibWFwcGluZ3MiOiI7QUFtQkEsTUFBYSw2QkFBNkIifQ==

package/src/application/models/graphql/queries/getWidgetConfigQuery.ts

@@ -1,55 +0,0 @@
-// Statsig-experiment-aware unified config endpoint — the single source of
-// session config. Returns productsConfig, the resolution metadata pymono used
-// to pick the version (the client threads `resolution.baseVersion` into
-// downstream inference requests so they're scoped to the version that produced
-// the rendered widgets), AND the org identity + feature gates + experiment
-// assignments that used to come from REST `/v1/org/config`. Pulling all of it
-// here lets the client drop the separate org/config call.
-//
-// userId is required by the schema (String!) and feeds Statsig layer
-// resolution server-side. source feeds Statsig user properties.
-//
-// gateNames selects which feature gates to evaluate and return — pass the same
-// list the app checks (the `FeatureGates` enum values); the resolver returns an
-// empty `gates` list when none are requested.
-//
-// version is optional; when omitted (no `spiffy_config_version` /
-// `envive_config_version` URL param) the resolver uses Statsig bucketing.
-// When set, it bypasses the merchant experiment and pins to that exact version
-// (empty experimentAssignments) — the QA / rollback affordance.
-export const getWidgetConfigQuery = () => `
-  query($userId: String!, $version: String, $gateNames: [String!], $source: String) {
-    me {
-      org {
-        id
-        shortName
-        displayName
-        domain
-        createdAt
-        updatedAt
-      }
-      getWidgetConfig(userId: $userId, version: $version, gateNames: $gateNames, source: $source) {
-        productsConfig {
-          frontend { values }
-          colors { values }
-          v_three_config { values }
-        }
-        gates {
-          name
-          value
-          groupName
-        }
-        experimentAssignments {
-          layerName
-          namespace
-          allocatedExperimentName
-          groupName
-        }
-        resolution {
-          baseVersion
-          baseVersionSource
-        }
-      }
-    }
-  }
-`;