@launchdarkly/js-client-sdk-common 1.25.0 → 1.26.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [1.26.0](https://github.com/launchdarkly/js-core/compare/js-client-sdk-common-v1.25.0...js-client-sdk-common-v1.26.0) (2026-04-23)
+
+
+### Features
+
+* support waitForNetworkResults in FDv2 data manager ([#1280](https://github.com/launchdarkly/js-core/issues/1280)) ([df7fa9e](https://github.com/launchdarkly/js-core/commit/df7fa9e571703132ffa697e8a005f31d7ab866dd))
+
+
+### Bug Fixes
+
+* FDv2 Only -- Adjust the behavior of initialization when only cache initializers are available. ([#1304](https://github.com/launchdarkly/js-core/issues/1304)) ([9a2b25a](https://github.com/launchdarkly/js-core/commit/9a2b25afd1507b2b6e42b85a32edea7a40be8bb0))
+* migrate anonymous context namespace to general namespace ([#1312](https://github.com/launchdarkly/js-core/issues/1312)) ([afbed0f](https://github.com/launchdarkly/js-core/commit/afbed0f299808f21dd4a8aa5159fe8d31879e1b9))
+
 ## [1.25.0](https://github.com/launchdarkly/js-core/compare/js-client-sdk-common-v1.24.0...js-client-sdk-common-v1.25.0) (2026-04-17)
 
 

package/dist/cjs/context/ensureKey.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ensureKey.d.ts","sourceRoot":"","sources":["../../src/context/ensureKey.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,QAAQ,EACT,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAgDnE;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,YACX,SAAS,YACR,QAAQ,KACjB,QAAQ,eAAe,CAgBzB,CAAC"}
+{"version":3,"file":"ensureKey.d.ts","sourceRoot":"","sources":["../../src/context/ensureKey.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,QAAQ,EACT,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAoDnE;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,YACX,SAAS,YACR,QAAQ,KACjB,QAAQ,eAAe,CAgBzB,CAAC"}

package/dist/cjs/datasource/FDv2DataManagerBase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FDv2DataManagerBase.d.ts","sourceRoot":"","sources":["../../src/datasource/FDv2DataManagerBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,SAAS,EACT,QAAQ,EAET,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,kBAAkB,EAElB,mBAAmB,EAEpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,SAAS,MAAM,cAAc,CAAC;AAErC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,OAAO,EAAE,mBAAmB,EAAiB,MAAM,aAAa,CAAC;AAQjE,OAAO,EAAwB,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO,EAEL,cAAc,EACd,YAAY,EAGb,MAAM,wBAAwB,CAAC;AAIhC;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,EAAE,SAAS,CAAC;IACvB,OAAO,EAAE,SAAS,CAAC;IAEnB,+CAA+C;IAC/C,eAAe,EAAE,mBAAmB,CAAC;IACrC,8FAA8F;IAC9F,cAAc,EAAE,kBAAkB,CAAC;IACnC,8CAA8C;IAC9C,cAAc,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAC/C,+DAA+D;IAC/D,SAAS,EAAE,SAAS,CAAC;IACrB,gFAAgF;IAChF,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C;;;;OAIG;IACH,gBAAgB,EAAE,CAAC,eAAe,CAAC,EAAE,iBAAiB,KAAK;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAE5F;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,mBAAmB,CAAC;IAEpC,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACzD,+DAA+D;IAC/D,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3C,iEAAiE;IACjE,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/C;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnD,kDAAkD;IAClD,cAAc,IAAI,kBAAkB,CAAC;IACrC,+EAA+E;IAC/E,QAAQ,CAAC,wBAAwB,EAAE,kBAAkB,CAAC;IACtD;;;OAGG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CAC9C;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,yBAAyB,GACpC,sBAAsB,CA4fxB"}
+{"version":3,"file":"FDv2DataManagerBase.d.ts","sourceRoot":"","sources":["../../src/datasource/FDv2DataManagerBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,SAAS,EACT,QAAQ,EAET,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,kBAAkB,EAElB,mBAAmB,EAEpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,SAAS,MAAM,cAAc,CAAC;AAErC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,OAAO,EAAE,mBAAmB,EAAiB,MAAM,aAAa,CAAC;AAQjE,OAAO,EAAwB,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO,EAEL,cAAc,EACd,YAAY,EAGb,MAAM,wBAAwB,CAAC;AAIhC;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,WAAW,EAAE,SAAS,CAAC;IACvB,OAAO,EAAE,SAAS,CAAC;IAEnB,+CAA+C;IAC/C,eAAe,EAAE,mBAAmB,CAAC;IACrC,8FAA8F;IAC9F,cAAc,EAAE,kBAAkB,CAAC;IACnC,8CAA8C;IAC9C,cAAc,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAC/C,+DAA+D;IAC/D,SAAS,EAAE,SAAS,CAAC;IACrB,gFAAgF;IAChF,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C;;;;OAIG;IACH,gBAAgB,EAAE,CAAC,eAAe,CAAC,EAAE,iBAAiB,KAAK;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAE5F;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,mBAAmB,CAAC;IAEpC,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACzD,+DAA+D;IAC/D,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3C,iEAAiE;IACjE,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/C;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnD,kDAAkD;IAClD,cAAc,IAAI,kBAAkB,CAAC;IACrC,+EAA+E;IAC/E,QAAQ,CAAC,wBAAwB,EAAE,kBAAkB,CAAC;IACtD;;;OAGG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CAC9C;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,yBAAyB,GACpC,sBAAsB,CAkhBxB"}

package/dist/cjs/datasource/SourceFactoryProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SourceFactoryProvider.d.ts","sourceRoot":"","sources":["../../src/datasource/SourceFactoryProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,MAAM,EACN,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,OAAO,EACR,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAkB,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,aAAa,EAAqB,MAAM,sBAAsB,CAAC;AAIxE,OAAO,EAA0B,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAKpG;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,SAAS,EAAE,aAAa,CAAC;IACzB,oCAAoC;IACpC,QAAQ,EAAE,QAAQ,CAAC;IACnB,qCAAqC;IACrC,QAAQ,EAAE,QAAQ,CAAC;IACnB,sCAAsC;IACtC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,4BAA4B;IAC5B,WAAW,EAAE,SAAS,CAAC;IACvB,oEAAoE;IACpE,WAAW,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9C,0CAA0C;IAC1C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc;IACd,MAAM,EAAE,QAAQ,CAAC;IAEjB,sCAAsC;IACtC,OAAO,EAAE;QACP,kCAAkC;QAClC,KAAK,EAAE,eAAe,CAAC;QACvB,wCAAwC;QACxC,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IAEF,wCAAwC;IACxC,SAAS,EAAE;QACT,oCAAoC;QACpC,KAAK,EAAE,eAAe,CAAC;QACvB,kDAAkD;QAClD,4BAA4B,EAAE,MAAM,CAAC;KACtC,CAAC;IAGF,gDAAgD;IAChD,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,wBAAwB,CACtB,KAAK,EAAE,gBAAgB,EACvB,GAAG,EAAE,oBAAoB,GACxB,kBAAkB,GAAG,SAAS,CAAC;IAElC;;;OAGG;IACH,sBAAsB,CACpB,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,oBAAoB,GACxB,gBAAgB,GAAG,SAAS,CAAC;CACjC;AAkFD;;;GAGG;AACH,wBAAgB,kCAAkC,IAAI,qBAAqB,CAuD1E"}
+{"version":3,"file":"SourceFactoryProvider.d.ts","sourceRoot":"","sources":["../../src/datasource/SourceFactoryProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,MAAM,EACN,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,OAAO,EACR,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAkB,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,aAAa,EAAqB,MAAM,sBAAsB,CAAC;AAIxE,OAAO,EAA0B,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAKpG;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,SAAS,EAAE,aAAa,CAAC;IACzB,oCAAoC;IACpC,QAAQ,EAAE,QAAQ,CAAC;IACnB,qCAAqC;IACrC,QAAQ,EAAE,QAAQ,CAAC;IACnB,sCAAsC;IACtC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,4BAA4B;IAC5B,WAAW,EAAE,SAAS,CAAC;IACvB,oEAAoE;IACpE,WAAW,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9C,0CAA0C;IAC1C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc;IACd,MAAM,EAAE,QAAQ,CAAC;IAEjB,sCAAsC;IACtC,OAAO,EAAE;QACP,kCAAkC;QAClC,KAAK,EAAE,eAAe,CAAC;QACvB,wCAAwC;QACxC,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IAEF,wCAAwC;IACxC,SAAS,EAAE;QACT,oCAAoC;QACpC,KAAK,EAAE,eAAe,CAAC;QACvB,kDAAkD;QAClD,4BAA4B,EAAE,MAAM,CAAC;KACtC,CAAC;IAGF,gDAAgD;IAChD,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,wBAAwB,CACtB,KAAK,EAAE,gBAAgB,EACvB,GAAG,EAAE,oBAAoB,GACxB,kBAAkB,GAAG,SAAS,CAAC;IAElC;;;OAGG;IACH,sBAAsB,CACpB,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,oBAAoB,GACxB,gBAAgB,GAAG,SAAS,CAAC;CACjC;AAkFD;;;GAGG;AACH,wBAAgB,kCAAkC,IAAI,qBAAqB,CAwD1E"}

package/dist/cjs/datasource/fdv2/FDv2DataSource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FDv2DataSource.d.ts","sourceRoot":"","sources":["../../../src/datasource/fdv2/FDv2DataSource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AASrE,OAAO,EAAuB,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE5F;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,KAAK,IAAI,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,oBAAoB,EAAE,kBAAkB,EAAE,CAAC;IAE3C,qDAAqD;IACrD,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IAEtC,2DAA2D;IAC3D,YAAY,EAAE,YAAY,CAAC;IAE3B,kEAAkE;IAClE,aAAa,EAAE,uBAAuB,CAAC;IAEvC;;;;OAIG;IACH,cAAc,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAEzC,uBAAuB;IACvB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAElB,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,wDAAwD;IACxD,KAAK,IAAI,IAAI,CAAC;CACf;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CA8QjF"}
+{"version":3,"file":"FDv2DataSource.d.ts","sourceRoot":"","sources":["../../../src/datasource/fdv2/FDv2DataSource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AASrE,OAAO,EAAuB,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE5F;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,KAAK,IAAI,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,oBAAoB,EAAE,kBAAkB,EAAE,CAAC;IAE3C,qDAAqD;IACrD,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IAEtC,2DAA2D;IAC3D,YAAY,EAAE,YAAY,CAAC;IAE3B,kEAAkE;IAClE,aAAa,EAAE,uBAAuB,CAAC;IAEvC;;;;OAIG;IACH,cAAc,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAEzC,uBAAuB;IACvB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAElB,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,wDAAwD;IACxD,KAAK,IAAI,IAAI,CAAC;CACf;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CAqTjF"}

package/dist/cjs/datasource/fdv2/SourceManager.d.ts

@@ -1,19 +1,37 @@
 import { Initializer } from './Initializer';
 import { Synchronizer } from './Synchronizer';
 /**
- * Factory function that creates an {@link Initializer} instance.
- *
- * @param selectorGetter Returns the current selector (basis) string, or
- *   `undefined` if no selector is available.
+ * Factory that creates an {@link Initializer} instance and carries optional
+ * metadata about the kind of initializer it produces.
  */
-export type InitializerFactory = (selectorGetter: () => string | undefined) => Initializer;
+export interface InitializerFactory {
+    /**
+     * Create an {@link Initializer} instance.
+     *
+     * @param selectorGetter Returns the current selector (basis) string, or
+     *   `undefined` if no selector is available.
+     */
+    create(selectorGetter: () => string | undefined): Initializer;
+    /**
+     * True if this factory produces a cache initializer. Used by the data
+     * source orchestrator to distinguish cache-only data systems (where a
+     * cache miss should still complete initialization) from general
+     * initializer chains.
+     */
+    readonly isCache?: boolean;
+}
 /**
- * Factory function that creates a {@link Synchronizer} instance.
- *
- * @param selectorGetter Returns the current selector (basis) string, or
- *   `undefined` if no selector is available.
+ * Factory that creates a {@link Synchronizer} instance.
  */
-export type SynchronizerFactory = (selectorGetter: () => string | undefined) => Synchronizer;
+export interface SynchronizerFactory {
+    /**
+     * Create a {@link Synchronizer} instance.
+     *
+     * @param selectorGetter Returns the current selector (basis) string, or
+     *   `undefined` if no selector is available.
+     */
+    create(selectorGetter: () => string | undefined): Synchronizer;
+}
 /**
  * State of a synchronizer slot.
  * - `'available'`: can be selected for use.

package/dist/cjs/datasource/fdv2/SourceManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SourceManager.d.ts","sourceRoot":"","sources":["../../../src/datasource/fdv2/SourceManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,cAAc,EAAE,MAAM,MAAM,GAAG,SAAS,KAAK,WAAW,CAAC;AAE3F;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,cAAc,EAAE,MAAM,MAAM,GAAG,SAAS,KAAK,YAAY,CAAC;AAE7F;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG,SAAS,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,KAAK,EAAE,qBAAqB,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE;IACR,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,qBAAqB,CAAC;CACtC,GACA,gBAAgB,CAIlB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,8BAA8B,IAAI,WAAW,GAAG,SAAS,CAAC;IAE1D;;;;OAIG;IACH,wCAAwC,IAAI,YAAY,GAAG,SAAS,CAAC;IAErE,6EAA6E;IAC7E,wBAAwB,IAAI,IAAI,CAAC;IAEjC,qFAAqF;IACrF,gBAAgB,IAAI,IAAI,CAAC;IAEzB,uEAAuE;IACvE,YAAY,IAAI,IAAI,CAAC;IAErB,yEAAyE;IACzE,mBAAmB,IAAI,OAAO,CAAC;IAE/B,qDAAqD;IACrD,6BAA6B,IAAI,MAAM,CAAC;IAExC,mEAAmE;IACnE,eAAe,IAAI,OAAO,CAAC;IAE3B,iEAAiE;IACjE,KAAK,IAAI,IAAI,CAAC;IAEd,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,oBAAoB,EAAE,kBAAkB,EAAE,EAC1C,iBAAiB,EAAE,gBAAgB,EAAE,EACrC,cAAc,EAAE,MAAM,MAAM,GAAG,SAAS,GACvC,aAAa,CAsGf"}
+{"version":3,"file":"SourceManager.d.ts","sourceRoot":"","sources":["../../../src/datasource/fdv2/SourceManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,MAAM,CAAC,cAAc,EAAE,MAAM,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;IAE9D;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,MAAM,CAAC,cAAc,EAAE,MAAM,MAAM,GAAG,SAAS,GAAG,YAAY,CAAC;CAChE;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG,SAAS,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,KAAK,EAAE,qBAAqB,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE;IACR,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,qBAAqB,CAAC;CACtC,GACA,gBAAgB,CAIlB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,8BAA8B,IAAI,WAAW,GAAG,SAAS,CAAC;IAE1D;;;;OAIG;IACH,wCAAwC,IAAI,YAAY,GAAG,SAAS,CAAC;IAErE,6EAA6E;IAC7E,wBAAwB,IAAI,IAAI,CAAC;IAEjC,qFAAqF;IACrF,gBAAgB,IAAI,IAAI,CAAC;IAEzB,uEAAuE;IACvE,YAAY,IAAI,IAAI,CAAC;IAErB,yEAAyE;IACzE,mBAAmB,IAAI,OAAO,CAAC;IAE/B,qDAAqD;IACrD,6BAA6B,IAAI,MAAM,CAAC;IAExC,mEAAmE;IACnE,eAAe,IAAI,OAAO,CAAC;IAE3B,iEAAiE;IACjE,KAAK,IAAI,IAAI,CAAC;IAEd,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,oBAAoB,EAAE,kBAAkB,EAAE,EAC1C,iBAAiB,EAAE,gBAAgB,EAAE,EACrC,cAAc,EAAE,MAAM,MAAM,GAAG,SAAS,GACvC,aAAa,CAsGf"}

package/dist/cjs/index.cjs

@@ -698,13 +698,28 @@ async function digest(hasher, encoding) {
  * @param storageKey keyed storage location where the generated key should live.  See {@link namespaceForGeneratedContextKey}
  * for related exmaples of generating a storage key and usage.
  * @param platform crypto and storage implementations for necessary operations
+ * @param legacyStorageKey optional legacy storage key to migrate from. If the key is not found
+ * under {@link storageKey} but exists under this legacy key, it will be migrated to the new
+ * location and the legacy key will be cleared.
  * @returns the generated key
  */
-const getOrGenerateKey = async (storageKey, { crypto, storage }) => {
+const getOrGenerateKey = async (storageKey, { crypto, storage }, legacyStorageKey) => {
     let generatedKey = await storage?.get(storageKey);
-    if (!generatedKey) {
-        generatedKey = crypto.randomUUID();
-        await storage?.set(storageKey, generatedKey);
+    if (generatedKey == null) {
+        if (legacyStorageKey) {
+            generatedKey = await storage?.get(legacyStorageKey);
+            if (generatedKey != null) {
+                await storage?.set(storageKey, generatedKey);
+                const verified = await storage?.get(storageKey);
+                if (verified != null) {
+                    await storage?.clear(legacyStorageKey);
+                }
+            }
+        }
+        if (generatedKey == null) {
+            generatedKey = crypto.randomUUID();
+            await storage?.set(storageKey, generatedKey);
+        }
     }
     return generatedKey;
 };
@@ -727,12 +742,9 @@ async function namespaceForEnvironment(crypto, sdkKey) {
     ]);
 }
 /**
- * @deprecated prefer {@link namespaceForGeneratedContextKey}. At one time we only generated keys for
- * anonymous contexts and they were namespaced in LaunchDarkly_AnonymousKeys.  Eventually we started
- * generating context keys for non-anonymous contexts such as for the Auto Environment Attributes
- * feature and those were namespaced in LaunchDarkly_ContextKeys.  This function can be removed
- * when the data under the LaunchDarkly_AnonymousKeys namespace is merged with data under the
- * LaunchDarkly_ContextKeys namespace.
+ * @deprecated Used only for migration in ensureKey. Data stored under LaunchDarkly_AnonymousKeys
+ * is now migrated to LaunchDarkly_ContextKeys on first access. This function can be removed once
+ * all clients have had the chance to run the migration.
  */
 async function namespaceForAnonymousGeneratedContextKey(kind) {
     return concatNamespacesAndValues([
@@ -915,10 +927,11 @@ const { isLegacyUser, isMultiKind, isSingleKind } = jsSdkCommon.internal;
 const ensureKeyCommon = async (kind, c, platform) => {
     const { anonymous, key } = c;
     if (anonymous && !key) {
-        const storageKey = await namespaceForAnonymousGeneratedContextKey(kind);
+        const storageKey = await namespaceForGeneratedContextKey(kind);
+        const legacyStorageKey = await namespaceForAnonymousGeneratedContextKey(kind);
         // This mutates a cloned copy of the original context from ensureyKey so this is safe.
         // eslint-disable-next-line no-param-reassign
-        c.key = await getOrGenerateKey(storageKey, platform);
+        c.key = await getOrGenerateKey(storageKey, platform, legacyStorageKey);
     }
 };
 const ensureKeySingle = async (c, platform) => {
@@ -3305,21 +3318,24 @@ async function loadFromCache(config) {
  * @internal
  */
 function createCacheInitializerFactory(config) {
-    // The selectorGetter is ignored — cache data has no selector.
-    return (_selectorGetter) => {
-        let shutdownResolve;
-        const shutdownPromise = new Promise((resolve) => {
-            shutdownResolve = resolve;
-        });
-        return {
-            async run() {
-                return Promise.race([shutdownPromise, loadFromCache(config)]);
-            },
-            close() {
-                shutdownResolve?.(shutdown());
-                shutdownResolve = undefined;
-            },
-        };
+    return {
+        isCache: true,
+        // The selectorGetter is ignored -- cache data has no selector.
+        create(_selectorGetter) {
+            let shutdownResolve;
+            const shutdownPromise = new Promise((resolve) => {
+                shutdownResolve = resolve;
+            });
+            return {
+                async run() {
+                    return Promise.race([shutdownPromise, loadFromCache(config)]);
+                },
+                close() {
+                    shutdownResolve?.(shutdown());
+                    shutdownResolve = undefined;
+                },
+            };
+        },
     };
 }
 
@@ -3787,7 +3803,7 @@ function createSourceManager(initializerFactories, synchronizerSlots, selectorGe
                 return undefined;
             }
             closeActiveSource();
-            const initializer = initializerFactories[initializerIndex](selectorGetter);
+            const initializer = initializerFactories[initializerIndex].create(selectorGetter);
             activeSource = initializer;
             return initializer;
         },
@@ -3807,7 +3823,7 @@ function createSourceManager(initializerFactories, synchronizerSlots, selectorGe
                 const candidate = synchronizerSlots[synchronizerIndex];
                 if (candidate.state === 'available') {
                     closeActiveSource();
-                    const synchronizer = candidate.factory(selectorGetter);
+                    const synchronizer = candidate.factory.create(selectorGetter);
                     activeSource = synchronizer;
                     return synchronizer;
                 }
@@ -4197,10 +4213,14 @@ function createDefaultSourceFactoryProvider() {
             switch (entry.type) {
                 case 'polling': {
                     const requestor = resolvePollingRequestor(ctx, entry.endpoints);
-                    return (sg) => createPollingInitializer(requestor, ctx.logger, sg);
+                    return {
+                        create: (sg) => createPollingInitializer(requestor, ctx.logger, sg),
+                    };
                 }
                 case 'streaming':
-                    return (sg) => createStreamingInitializer(buildStreamingBase(entry, ctx, sg));
+                    return {
+                        create: (sg) => createStreamingInitializer(buildStreamingBase(entry, ctx, sg)),
+                    };
                 case 'cache':
                     return createCacheInitializerFactory({
                         storage: ctx.storage,
@@ -4218,13 +4238,14 @@ function createDefaultSourceFactoryProvider() {
                 case 'polling': {
                     const intervalMs = (entry.pollInterval ?? ctx.polling.intervalSeconds) * 1000;
                     const requestor = resolvePollingRequestor(ctx, entry.endpoints);
-                    const factory = (sg) => createPollingSynchronizer(requestor, ctx.logger, sg, intervalMs);
-                    return createSynchronizerSlot(factory);
-                }
-                case 'streaming': {
-                    const factory = (sg) => createStreamingSynchronizer(buildStreamingBase(entry, ctx, sg));
-                    return createSynchronizerSlot(factory);
+                    return createSynchronizerSlot({
+                        create: (sg) => createPollingSynchronizer(requestor, ctx.logger, sg, intervalMs),
+                    });
                 }
+                case 'streaming':
+                    return createSynchronizerSlot({
+                        create: (sg) => createStreamingSynchronizer(buildStreamingBase(entry, ctx, sg)),
+                    });
                 default:
                     return undefined;
             }
@@ -4495,6 +4516,15 @@ function createFDv2DataSource(config) {
     let dataReceived = false;
     let initResolve;
     let initReject;
+    // When every initializer is a cache initializer and there are no
+    // synchronizers, the cache is the only possible data source. A cache miss
+    // in that configuration must not fail initialization -- there is nowhere
+    // else for data to come from, and reporting an error would be meaningless.
+    // Mirrors the Android SDK's InitializerFromCache / hasAvailableSources
+    // behavior.
+    const cacheOnlyDataSystem = initializerFactories.length > 0 &&
+        initializerFactories.every((f) => f.isCache === true) &&
+        synchronizerSlots.length === 0;
     const sourceManager = createSourceManager(initializerFactories, synchronizerSlots, selectorGetter);
     function markInitialized() {
         if (!initialized) {
@@ -4524,6 +4554,10 @@ function createFDv2DataSource(config) {
     // The orchestration loops intentionally use await-in-loop for sequential
     // state machine processing — one result at a time.
     async function runInitializers() {
+        // Tracks whether any initializer reported interrupted/terminal_error.
+        // Used below so the cache-only exhaustion branch does not overwrite
+        // that error status with VALID.
+        let errorReportedDuringInit = false;
         while (!closed) {
             const initializer = sourceManager.getNextInitializerAndSetActive();
             if (initializer === undefined) {
@@ -4556,6 +4590,7 @@ function createFDv2DataSource(config) {
                     case 'terminal_error':
                         logger?.warn(`Initializer failed: ${result.errorInfo?.message ?? 'unknown error'}`);
                         reportStatusError(result);
+                        errorReportedDuringInit = true;
                         break;
                     case 'shutdown':
                         return;
@@ -4563,8 +4598,30 @@ function createFDv2DataSource(config) {
                 handleFdv1Fallback(result);
             }
         }
+        // close() between the last loop iteration and the exhaustion branch.
+        // Exit without marking initialized or emitting a spurious VALID; the
+        // start() promise will be rejected by the post-orchestration handler
+        // with "closed before initialization completed."
+        if (closed) {
+            return;
+        }
         // All initializers exhausted.
-        if (dataReceived) {
+        if (cacheOnlyDataSystem) {
+            // Cache-only data system with no synchronizer to produce a VALID
+            // status on its own. On a cache miss with no errors, nothing else
+            // has asserted VALID yet, so do it here. Skip the update if:
+            //   - dataReceived (cache hit): applyChangeSet already asserted VALID.
+            //   - errorReportedDuringInit: reportError set an error status that
+            //     must not be silently overwritten.
+            if (!dataReceived && !errorReportedDuringInit) {
+                statusManager.requestStateUpdate('VALID');
+            }
+            markInitialized();
+        }
+        else if (dataReceived) {
+            // At least one initializer delivered data. Do not overwrite any
+            // error status that a subsequent failed initializer may have
+            // reported -- the status will be driven by the synchronizers.
             markInitialized();
         }
     }
@@ -4795,6 +4852,13 @@ function createFDv2DataManagerBase(baseConfig) {
     let bootstrapped = false;
     let closed = false;
     let flushCallback;
+    /**
+     * The minimum data availability required before the identify promise
+     * resolves. Maps from the public `waitForNetworkResults` option:
+     * - `'cached'` -- resolve as soon as any data (e.g. from cache) is delivered
+     * - `'fresh'`  -- wait for network data with a selector (REFRESHED state)
+     */
+    let minimumDataAvailability = 'fresh';
     // Explicit connection mode override — bypasses transition table entirely.
     let connectionModeOverride;
     // Forced/automatic streaming state for browser listener-driven streaming.
@@ -4897,7 +4961,9 @@ function createFDv2DataManagerBase(baseConfig) {
                 ? new jsSdkCommon.ServiceEndpoints(fallbackConfig.endpoints.streamingBaseUri ?? ctx.serviceEndpoints.streaming, fallbackConfig.endpoints.pollingBaseUri ?? ctx.serviceEndpoints.polling, ctx.serviceEndpoints.events, ctx.serviceEndpoints.analyticsEventPath, ctx.serviceEndpoints.diagnosticEventPath, ctx.serviceEndpoints.includeAuthorizationHeader, ctx.serviceEndpoints.payloadFilterKey)
                 : ctx.serviceEndpoints;
             const fdv1RequestorFactory = () => makeRequestor(ctx.plainContextString, fallbackServiceEndpoints, fdv1Endpoints.polling(), ctx.requests, ctx.encoding, ctx.baseHeaders, ctx.queryParams, config.withReasons, config.useReport);
-            const fdv1SyncFactory = () => createFDv1PollingSynchronizer(fdv1RequestorFactory(), fallbackPollIntervalMs, logger);
+            const fdv1SyncFactory = {
+                create: () => createFDv1PollingSynchronizer(fdv1RequestorFactory(), fallbackPollIntervalMs, logger),
+            };
             synchronizerSlots.push(createSynchronizerSlot(fdv1SyncFactory, { isFDv1Fallback: true }));
         }
         return { initializerFactories, synchronizerSlots };
@@ -4916,11 +4982,21 @@ function createFDv2DataManagerBase(baseConfig) {
         }
         const descriptors = flagEvalPayloadToItemDescriptors(payload.updates ?? []);
         // Flag updates and change events happen synchronously inside applyChanges.
-        // The returned promise is only for async cache persistence — we intentionally
+        // The returned promise is only for async cache persistence -- we intentionally
         // do not await it so the data source pipeline is not blocked by storage I/O.
         flagManager.applyChanges(context, descriptors, payload.type).catch((e) => {
             logger.warn(`${logTag} Failed to persist flag cache: ${e}`);
         });
+        // When the minimum data availability is 'cached', resolve the identify
+        // promise as soon as any data (e.g. from cache) has been delivered. The
+        // data source continues its initialization pipeline normally --
+        // subsequent changesets update flags and fire change events.
+        if (minimumDataAvailability === 'cached' && !initialized && pendingIdentifyResolve) {
+            initialized = true;
+            pendingIdentifyResolve();
+            pendingIdentifyResolve = undefined;
+            pendingIdentifyReject = undefined;
+        }
     }
     /**
      * Create and start a new FDv2DataSource for the given mode.
@@ -5027,6 +5103,7 @@ function createFDv2DataManagerBase(baseConfig) {
             selector = undefined;
             initialized = false;
             bootstrapped = false;
+            minimumDataAvailability = identifyOptions?.waitForNetworkResults ? 'fresh' : 'cached';
             identifiedContext = context;
             pendingIdentifyResolve = identifyResolve;
             pendingIdentifyReject = identifyReject;