@shipeasy/sdk 2.0.2 → 2.0.3

package/dist/client/index.d.mts

@@ -137,10 +137,10 @@ declare const flags: {
     identify(user: User): Promise<void>;
     /**
      * Read a feature gate.
-     * Priority: URL override → server bootstrap (window.__SE_BOOTSTRAP) → CDN-fetched (post-mount) → false.
-     * The _mountedAndReady gate still applies for the CDN path to prevent hydration
-     * mismatches on force-static pages; bootstrap data is safe to read immediately
-     * because the server rendered with the same values.
+     * Priority: bootstrap → CDN/URL-override (post-mount) → false.
+     * Bootstrap is safe before mount because the server rendered with the same values.
+     * Everything else gates on _mountedAndReady to prevent hydration mismatches on
+     * force-static pages where SSR has no flag data.
      */
     get(name: string): boolean;
     getConfig<T = unknown>(name: string, decode?: (raw: unknown) => T): T | undefined;
@@ -150,7 +150,11 @@ declare const flags: {
     /**
      * Called by FlagsBoundary after React hydration to unlock flag reads.
      * Dispatches se:override:change so subscribers (FlagsBoundary) re-render
-     * once with real values — URL overrides and server-evaluated flags.
+     * once with real values — URL overrides and CDN-loaded flags.
+     *
+     * Always dispatches even if already mounted: in React hydration-recovery
+     * renders the latch is already true so the early-return guard would swallow
+     * the event, leaving the re-mounted subtree stuck with stale (empty) values.
      */
     notifyMounted(): void;
     /** Subscribe for change notifications (identify/override). Used by framework adapters. */

package/dist/client/index.d.ts

@@ -137,10 +137,10 @@ declare const flags: {
     identify(user: User): Promise<void>;
     /**
      * Read a feature gate.
-     * Priority: URL override → server bootstrap (window.__SE_BOOTSTRAP) → CDN-fetched (post-mount) → false.
-     * The _mountedAndReady gate still applies for the CDN path to prevent hydration
-     * mismatches on force-static pages; bootstrap data is safe to read immediately
-     * because the server rendered with the same values.
+     * Priority: bootstrap → CDN/URL-override (post-mount) → false.
+     * Bootstrap is safe before mount because the server rendered with the same values.
+     * Everything else gates on _mountedAndReady to prevent hydration mismatches on
+     * force-static pages where SSR has no flag data.
      */
     get(name: string): boolean;
     getConfig<T = unknown>(name: string, decode?: (raw: unknown) => T): T | undefined;
@@ -150,7 +150,11 @@ declare const flags: {
     /**
      * Called by FlagsBoundary after React hydration to unlock flag reads.
      * Dispatches se:override:change so subscribers (FlagsBoundary) re-render
-     * once with real values — URL overrides and server-evaluated flags.
+     * once with real values — URL overrides and CDN-loaded flags.
+     *
+     * Always dispatches even if already mounted: in React hydration-recovery
+     * renders the latch is already true so the early-return guard would swallow
+     * the event, leaving the re-mounted subtree stuck with stale (empty) values.
      */
     notifyMounted(): void;
     /** Subscribe for change notifications (identify/override). Used by framework adapters. */

package/dist/client/index.js

@@ -686,30 +686,19 @@ var flags = {
   },
   /**
    * Read a feature gate.
-   * Priority: URL override → server bootstrap (window.__SE_BOOTSTRAP) → CDN-fetched (post-mount) → false.
-   * The _mountedAndReady gate still applies for the CDN path to prevent hydration
-   * mismatches on force-static pages; bootstrap data is safe to read immediately
-   * because the server rendered with the same values.
+   * Priority: bootstrap → CDN/URL-override (post-mount) → false.
+   * Bootstrap is safe before mount because the server rendered with the same values.
+   * Everything else gates on _mountedAndReady to prevent hydration mismatches on
+   * force-static pages where SSR has no flag data.
    */
   get(name) {
-    const ov = readGateOverride(name);
-    if (ov !== null) return ov;
     const bs = getBootstrap();
     if (bs !== null && name in bs.flags) return bs.flags[name];
     if (!_mountedAndReady) return false;
     if (_client) return _client.getFlag(name);
-    return false;
+    return readGateOverride(name) ?? false;
   },
   getConfig(name, decode) {
-    const ov = readConfigOverride(name);
-    if (ov !== void 0) {
-      if (!decode) return ov;
-      try {
-        return decode(ov);
-      } catch {
-        return void 0;
-      }
-    }
     const bs = getBootstrap();
     if (bs !== null && name in bs.configs) {
       const raw = bs.configs[name];
@@ -722,7 +711,14 @@ var flags = {
     }
     if (!_mountedAndReady) return void 0;
     if (_client) return _client.getConfig(name, decode);
-    return void 0;
+    const ov = readConfigOverride(name);
+    if (ov === void 0) return void 0;
+    if (!decode) return ov;
+    try {
+      return decode(ov);
+    } catch {
+      return void 0;
+    }
   },
   getExperiment(name, defaultParams, decode, variants) {
     return _client?.getExperiment(name, defaultParams, decode, variants) ?? {
@@ -740,10 +736,13 @@ var flags = {
   /**
    * Called by FlagsBoundary after React hydration to unlock flag reads.
    * Dispatches se:override:change so subscribers (FlagsBoundary) re-render
-   * once with real values — URL overrides and server-evaluated flags.
+   * once with real values — URL overrides and CDN-loaded flags.
+   *
+   * Always dispatches even if already mounted: in React hydration-recovery
+   * renders the latch is already true so the early-return guard would swallow
+   * the event, leaving the re-mounted subtree stuck with stale (empty) values.
    */
   notifyMounted() {
-    if (_mountedAndReady) return;
     _mountedAndReady = true;
     if (typeof window !== "undefined") {
       window.dispatchEvent(new CustomEvent("se:override:change"));

package/dist/client/index.mjs

@@ -644,30 +644,19 @@ var flags = {
   },
   /**
    * Read a feature gate.
-   * Priority: URL override → server bootstrap (window.__SE_BOOTSTRAP) → CDN-fetched (post-mount) → false.
-   * The _mountedAndReady gate still applies for the CDN path to prevent hydration
-   * mismatches on force-static pages; bootstrap data is safe to read immediately
-   * because the server rendered with the same values.
+   * Priority: bootstrap → CDN/URL-override (post-mount) → false.
+   * Bootstrap is safe before mount because the server rendered with the same values.
+   * Everything else gates on _mountedAndReady to prevent hydration mismatches on
+   * force-static pages where SSR has no flag data.
    */
   get(name) {
-    const ov = readGateOverride(name);
-    if (ov !== null) return ov;
     const bs = getBootstrap();
     if (bs !== null && name in bs.flags) return bs.flags[name];
     if (!_mountedAndReady) return false;
     if (_client) return _client.getFlag(name);
-    return false;
+    return readGateOverride(name) ?? false;
   },
   getConfig(name, decode) {
-    const ov = readConfigOverride(name);
-    if (ov !== void 0) {
-      if (!decode) return ov;
-      try {
-        return decode(ov);
-      } catch {
-        return void 0;
-      }
-    }
     const bs = getBootstrap();
     if (bs !== null && name in bs.configs) {
       const raw = bs.configs[name];
@@ -680,7 +669,14 @@ var flags = {
     }
     if (!_mountedAndReady) return void 0;
     if (_client) return _client.getConfig(name, decode);
-    return void 0;
+    const ov = readConfigOverride(name);
+    if (ov === void 0) return void 0;
+    if (!decode) return ov;
+    try {
+      return decode(ov);
+    } catch {
+      return void 0;
+    }
   },
   getExperiment(name, defaultParams, decode, variants) {
     return _client?.getExperiment(name, defaultParams, decode, variants) ?? {
@@ -698,10 +694,13 @@ var flags = {
   /**
    * Called by FlagsBoundary after React hydration to unlock flag reads.
    * Dispatches se:override:change so subscribers (FlagsBoundary) re-render
-   * once with real values — URL overrides and server-evaluated flags.
+   * once with real values — URL overrides and CDN-loaded flags.
+   *
+   * Always dispatches even if already mounted: in React hydration-recovery
+   * renders the latch is already true so the early-return guard would swallow
+   * the event, leaving the re-mounted subtree stuck with stale (empty) values.
    */
   notifyMounted() {
-    if (_mountedAndReady) return;
     _mountedAndReady = true;
     if (typeof window !== "undefined") {
       window.dispatchEvent(new CustomEvent("se:override:change"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shipeasy/sdk",
-  "version": "2.0.2",
+  "version": "2.0.3",
   "description": "Shipeasy SDK — feature gates, runtime configs, experiments, and metrics for the Shipeasy hosted service.",
   "license": "SEE LICENSE IN LICENSE",
   "homepage": "https://shipeasy.ai",