@launchdarkly/js-sdk-common 2.18.0 → 2.20.0

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to `@launchdarkly/js-sdk-common` will be documented in this file. This project adheres to [Semantic Versioning](http://semver.org).
 
+## [2.20.0](https://github.com/launchdarkly/js-core/compare/js-sdk-common-v2.19.0...js-sdk-common-v2.20.0) (2025-12-05)
+
+
+### Features
+
+* add FDv2 FileDataSource initializer ([#1010](https://github.com/launchdarkly/js-core/issues/1010)) ([99931f0](https://github.com/launchdarkly/js-core/commit/99931f0706c0202390e3b68e3701ba0fb8aba124))
+
+## [2.19.0](https://github.com/launchdarkly/js-core/compare/js-sdk-common-v2.18.0...js-sdk-common-v2.19.0) (2025-07-23)
+
+
+### Features
+
+* additional FDv2 functionality ([#898](https://github.com/launchdarkly/js-core/issues/898)) ([9ede15c](https://github.com/launchdarkly/js-core/commit/9ede15c757ed1b8c57b090716d44cf60a03da409))
+
 ## [2.18.0](https://github.com/launchdarkly/js-core/compare/js-sdk-common-v2.17.0...js-sdk-common-v2.18.0) (2025-05-21)
 
 

package/dist/cjs/api/platform/Requests.d.ts

@@ -108,5 +108,6 @@ export interface Requests {
 export interface HttpErrorResponse {
     message: string;
     status?: number;
+    headers?: Record<string, string>;
 }
 //# sourceMappingURL=Requests.d.ts.map

package/dist/cjs/api/platform/Requests.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Requests.d.ts","sourceRoot":"","sources":["../../../src/api/platform/Requests.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAOtE;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB;;;;;;OAMG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAEjC;;;;;;OAMG;IACH,IAAI,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEzB;;;;;OAKG;IACH,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE3B;;;;;OAKG;IACH,OAAO,IAAI,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAEtC;;;OAGG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAExB;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;CACtB;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;;OASG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,YAAY,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEzD,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,mBAAmB,EAAE,mBAAmB,GAAG,WAAW,CAAC;IAEtF,0BAA0B,IAAI,uBAAuB,CAAC;IAEtD;;OAEG;IACH,UAAU,CAAC,IAAI,OAAO,CAAC;IAEvB;;OAEG;IACH,cAAc,CAAC,IAAI,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"Requests.d.ts","sourceRoot":"","sources":["../../../src/api/platform/Requests.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAOtE;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB;;;;;;OAMG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAEjC;;;;;;OAMG;IACH,IAAI,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEzB;;;;;OAKG;IACH,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE3B;;;;;OAKG;IACH,OAAO,IAAI,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAEtC;;;OAGG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAExB;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;CACtB;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;;OASG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,YAAY,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEzD,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,mBAAmB,EAAE,mBAAmB,GAAG,WAAW,CAAC;IAEtF,0BAA0B,IAAI,uBAAuB,CAAC;IAEtD;;OAEG;IACH,UAAU,CAAC,IAAI,OAAO,CAAC;IAEvB;;OAEG;IACH,cAAc,CAAC,IAAI,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC"}

package/dist/cjs/api/subsystem/DataSystem/CallbackHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CallbackHandler.d.ts","sourceRoot":"","sources":["../../../../src/api/subsystem/DataSystem/CallbackHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;GAIG;AACH,qBAAa,eAAe;IAIxB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAJlC,OAAO,CAAC,SAAS,CAAkB;gBAGhB,aAAa,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,IAAI,EAClD,eAAe,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,EAAE,GAAG,KAAK,IAAI;IAGhF,OAAO;IAID,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG;IAUrC,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,EAAE,GAAG;CAOvD"}
+{"version":3,"file":"CallbackHandler.d.ts","sourceRoot":"","sources":["../../../../src/api/subsystem/DataSystem/CallbackHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;GAIG;AACH,qBAAa,eAAe;IAIxB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAJlC,OAAO,CAAC,SAAS,CAAkB;gBAGhB,aAAa,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,IAAI,EAClD,eAAe,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,EAAE,GAAG,KAAK,IAAI;IAGhF,OAAO;IAID,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG;IAQrC,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,EAAE,GAAG;CAOvD"}

package/dist/cjs/api/subsystem/DataSystem/DataSource.d.ts

@@ -1,21 +1,37 @@
+/**
+ * @experimental
+ * This feature is not stable and not subject to any backwards compatibility guarantees or semantic
+ * versioning.  It is not suitable for production usage.
+ */
 export declare enum DataSourceState {
     Valid = 0,
     Initializing = 1,
     Interrupted = 2,
     Closed = 3
 }
+/**
+ * @experimental
+ * This feature is not stable and not subject to any backwards compatibility guarantees or semantic
+ * versioning.  It is not suitable for production usage.
+ */
 export interface DataSource {
     /**
      * May be called any number of times, if already started, has no effect
      * @param dataCallback that will be called when data arrives, may be called multiple times.
      * @param statusCallback that will be called when data source state changes or an unrecoverable error
      * has been encountered.
+     * @param selectorGetter that can be invoked to provide the FDv2 selector/basis if one exists
      */
-    start(dataCallback: (basis: boolean, data: any) => void, statusCallback: (status: DataSourceState, err?: any) => void): void;
+    start(dataCallback: (basis: boolean, data: any) => void, statusCallback: (status: DataSourceState, err?: any) => void, selectorGetter?: () => string | undefined): void;
     /**
      * May be called any number of times, if already stopped, has no effect. Datasource will not make any additional callbacks after stop returns.
      */
     stop(): void;
 }
+/**
+ * @experimental
+ * This feature is not stable and not subject to any backwards compatibility guarantees or semantic
+ * versioning.  It is not suitable for production usage.
+ */
 export type LDDataSourceFactory = () => DataSource;
 //# sourceMappingURL=DataSource.d.ts.map

package/dist/cjs/api/subsystem/DataSystem/DataSource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DataSource.d.ts","sourceRoot":"","sources":["../../../../src/api/subsystem/DataSystem/DataSource.ts"],"names":[],"mappings":"AACA,oBAAY,eAAe;IAEzB,KAAK,IAAA;IAEL,YAAY,IAAA;IAEZ,WAAW,IAAA;IAEX,MAAM,IAAA;CACP;AAED,MAAM,WAAW,UAAU;IACzB;;;;;OAKG;IACH,KAAK,CACH,YAAY,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,IAAI,EACjD,cAAc,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,EAAE,GAAG,KAAK,IAAI,GAC3D,IAAI,CAAC;IAER;;OAEG;IACH,IAAI,IAAI,IAAI,CAAC;CACd;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,UAAU,CAAC"}
+{"version":3,"file":"DataSource.d.ts","sourceRoot":"","sources":["../../../../src/api/subsystem/DataSystem/DataSource.ts"],"names":[],"mappings":"AACA;;;;GAIG;AACH,oBAAY,eAAe;IAEzB,KAAK,IAAA;IAEL,YAAY,IAAA;IAEZ,WAAW,IAAA;IAEX,MAAM,IAAA;CACP;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;;OAMG;IACH,KAAK,CACH,YAAY,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,IAAI,EACjD,cAAc,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,EAAE,GAAG,KAAK,IAAI,EAC5D,cAAc,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,GACxC,IAAI,CAAC;IAER;;OAEG;IACH,IAAI,IAAI,IAAI,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,UAAU,CAAC"}

package/dist/cjs/datasource/CompositeDataSource.d.ts

@@ -25,6 +25,7 @@ export declare class CompositeDataSource implements DataSource {
     private _initPhaseActive;
     private _initFactories;
     private _syncFactories;
+    private _fdv1Synchronizers;
     private _stopped;
     private _externalTransitionPromise;
     private _externalTransitionResolve?;
@@ -32,9 +33,13 @@ export declare class CompositeDataSource implements DataSource {
     /**
      * @param initializers factories to create {@link DataSystemInitializer}s, in priority order.
      * @param synchronizers factories to create  {@link DataSystemSynchronizer}s, in priority order.
+     * @param fdv1Synchronizers factories to fallback to if we need to fallback to FDv1.
+     * @param _logger for logging
+     * @param _transitionConditions to control automated transition between datasources. Typically only used for testing.
+     * @param _backoff to control delay between transitions. Typically only used for testing.
      */
-    constructor(initializers: LDDataSourceFactory[], synchronizers: LDDataSourceFactory[], _logger?: LDLogger | undefined, _transitionConditions?: TransitionConditions, _backoff?: Backoff);
-    start(dataCallback: (basis: boolean, data: any) => void, statusCallback: (status: DataSourceState, err?: any) => void): Promise<void>;
+    constructor(initializers: LDDataSourceFactory[], synchronizers: LDDataSourceFactory[], fdv1Synchronizers: LDDataSourceFactory[], _logger?: LDLogger | undefined, _transitionConditions?: TransitionConditions, _backoff?: Backoff);
+    start(dataCallback: (basis: boolean, data: any) => void, statusCallback: (status: DataSourceState, err?: any) => void, selectorGetter?: () => string | undefined): Promise<void>;
     stop(): Promise<void>;
     private _reset;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"CompositeDataSource.d.ts","sourceRoot":"","sources":["../../src/datasource/CompositeDataSource.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EACL,UAAU,EACV,eAAe,EACf,mBAAmB,EACpB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,OAAO,EAAkB,MAAM,WAAW,CAAC;AAMpD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAE1E;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;KAChC,CAAC,IAAI,eAAe,CAAC,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,UAAU,CAAA;KAAE;CACxE,CAAC;AAOF;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,UAAU;IAoBlD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IAUtC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IA3B3B,OAAO,CAAC,gBAAgB,CAAU;IAClC,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,cAAc,CAAsC;IAE5D,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,0BAA0B,CAA6B;IAC/D,OAAO,CAAC,0BAA0B,CAAC,CAAqC;IACxE,OAAO,CAAC,aAAa,CAAsB;IAE3C;;;OAGG;gBAED,YAAY,EAAE,mBAAmB,EAAE,EACnC,aAAa,EAAE,mBAAmB,EAAE,EACnB,OAAO,CAAC,sBAAU,EAClB,qBAAqB,GAAE,oBASvC,EACgB,QAAQ,GAAE,OAAyC;IAUhE,KAAK,CACT,YAAY,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,IAAI,EACjD,cAAc,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,EAAE,GAAG,KAAK,IAAI,GAC3D,OAAO,CAAC,IAAI,CAAC;IAgJV,IAAI;IAMV,OAAO,CAAC,MAAM;IAWd;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAoDvB;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IAclC,OAAO,CAAC,iBAAiB,CAcvB;IAEF,OAAO,CAAC,mBAAmB;IAQ3B;;;;;;OAMG;IACH,OAAO,CAAC,gCAAgC;CAgCzC"}
+{"version":3,"file":"CompositeDataSource.d.ts","sourceRoot":"","sources":["../../src/datasource/CompositeDataSource.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EACL,UAAU,EACV,eAAe,EACf,mBAAmB,EACpB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,OAAO,EAAkB,MAAM,WAAW,CAAC;AAOpD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAE1E;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;KAChC,CAAC,IAAI,eAAe,CAAC,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,UAAU,CAAA;KAAE;CACxE,CAAC;AAOF;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,UAAU;IAyBlD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IAUtC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAjC3B,OAAO,CAAC,gBAAgB,CAAU;IAClC,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,kBAAkB,CAAsC;IAEhE,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,0BAA0B,CAA6B;IAC/D,OAAO,CAAC,0BAA0B,CAAC,CAAqC;IACxE,OAAO,CAAC,aAAa,CAAsB;IAE3C;;;;;;;OAOG;gBAED,YAAY,EAAE,mBAAmB,EAAE,EACnC,aAAa,EAAE,mBAAmB,EAAE,EACpC,iBAAiB,EAAE,mBAAmB,EAAE,EACvB,OAAO,CAAC,sBAAU,EAClB,qBAAqB,GAAE,oBASvC,EACgB,QAAQ,GAAE,OAAyC;IAWhE,KAAK,CACT,YAAY,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,IAAI,EACjD,cAAc,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,EAAE,GAAG,KAAK,IAAI,EAC5D,cAAc,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,GACxC,OAAO,CAAC,IAAI,CAAC;IAwJV,IAAI;IAMV,OAAO,CAAC,MAAM;IAYd;;;;OAIG;IACH,OAAO,CAAC,eAAe;IA0DvB;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IAclC,OAAO,CAAC,iBAAiB,CAcvB;IAEF,OAAO,CAAC,mBAAmB;IAQ3B;;;;;;OAMG;IACH,OAAO,CAAC,gCAAgC;CAgCzC"}

package/dist/cjs/datasource/errors.d.ts

@@ -14,5 +14,14 @@ export declare class LDStreamingError extends Error {
     readonly recoverable: boolean;
     constructor(kind: DataSourceErrorKind, message: string, code?: number, recoverable?: boolean);
 }
+/**
+ * This is a short term error and will be removed once FDv2 adoption is sufficient.
+ */
+export declare class LDFlagDeliveryFallbackError extends Error {
+    readonly kind: DataSourceErrorKind;
+    readonly code?: number;
+    readonly recoverable: boolean;
+    constructor(kind: DataSourceErrorKind, message: string, code?: number);
+}
 export type StreamingErrorHandler = (err: LDStreamingError) => void;
 //# sourceMappingURL=errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/datasource/errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAgB,IAAI,EAAE,mBAAmB,CAAC;IAC1C,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChC,SAAgB,WAAW,EAAE,OAAO,CAAC;gBAEzB,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,UAAO;CAO5F;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAgB,IAAI,EAAE,mBAAmB,CAAC;IAC1C,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,WAAW,EAAE,OAAO,CAAC;gBAEzB,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,UAAO;CAO1F;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI,CAAC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/datasource/errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAgB,IAAI,EAAE,mBAAmB,CAAC;IAC1C,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChC,SAAgB,WAAW,EAAE,OAAO,CAAC;gBAEzB,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,UAAO;CAO5F;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAgB,IAAI,EAAE,mBAAmB,CAAC;IAC1C,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,WAAW,EAAE,OAAO,CAAC;gBAEzB,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,UAAO;CAO1F;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,SAAgB,IAAI,EAAE,mBAAmB,CAAC;IAC1C,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,WAAW,EAAE,OAAO,CAAC;gBAEzB,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAOtE;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI,CAAC"}

package/dist/cjs/datasource/index.d.ts

@@ -1,6 +1,6 @@
 import { Backoff, DefaultBackoff } from './Backoff';
 import { CompositeDataSource } from './CompositeDataSource';
 import { DataSourceErrorKind } from './DataSourceErrorKinds';
-import { LDFileDataSourceError, LDPollingError, LDStreamingError, StreamingErrorHandler } from './errors';
-export { Backoff, CompositeDataSource, DefaultBackoff, DataSourceErrorKind, LDFileDataSourceError, LDPollingError, LDStreamingError, StreamingErrorHandler, };
+import { LDFileDataSourceError, LDFlagDeliveryFallbackError, LDPollingError, LDStreamingError, StreamingErrorHandler } from './errors';
+export { Backoff, CompositeDataSource, DefaultBackoff, DataSourceErrorKind, LDFileDataSourceError, LDFlagDeliveryFallbackError, LDPollingError, LDStreamingError, StreamingErrorHandler, };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/datasource/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,OAAO,EACP,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,qBAAqB,GACtB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/datasource/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,OAAO,EACP,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,2BAA2B,EAC3B,cAAc,EACd,gBAAgB,EAChB,qBAAqB,GACtB,CAAC"}

package/dist/cjs/index.cjs

@@ -951,8 +951,6 @@ class CallbackHandler {
         if (this._disabled) {
             return;
         }
-        // TODO: SDK-1044 track selector for future synchronizer to use
-        // report data up
         this._dataCallback(basis, data);
     }
     async statusHandler(status, err) {
@@ -964,6 +962,11 @@ class CallbackHandler {
 }
 
 // TODO: refactor client-sdk to use this enum
+/**
+ * @experimental
+ * This feature is not stable and not subject to any backwards compatibility guarantees or semantic
+ * versioning.  It is not suitable for production usage.
+ */
 var DataSourceState;
 (function (DataSourceState) {
     // Positive confirmation of connection/data receipt
@@ -1064,6 +1067,43 @@ class DataSourceList {
     }
 }
 
+class LDFileDataSourceError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'LaunchDarklyFileDataSourceError';
+    }
+}
+class LDPollingError extends Error {
+    constructor(kind, message, status, recoverable = true) {
+        super(message);
+        this.kind = kind;
+        this.status = status;
+        this.name = 'LaunchDarklyPollingError';
+        this.recoverable = recoverable;
+    }
+}
+class LDStreamingError extends Error {
+    constructor(kind, message, code, recoverable = true) {
+        super(message);
+        this.kind = kind;
+        this.code = code;
+        this.name = 'LaunchDarklyStreamingError';
+        this.recoverable = recoverable;
+    }
+}
+/**
+ * This is a short term error and will be removed once FDv2 adoption is sufficient.
+ */
+class LDFlagDeliveryFallbackError extends Error {
+    constructor(kind, message, code) {
+        super(message);
+        this.kind = kind;
+        this.code = code;
+        this.name = 'LDFlagDeliveryFallbackError';
+        this.recoverable = false;
+    }
+}
+
 const DEFAULT_FALLBACK_TIME_MS = 2 * 60 * 1000;
 const DEFAULT_RECOVERY_TIME_MS = 5 * 60 * 1000;
 /**
@@ -1074,8 +1114,12 @@ class CompositeDataSource {
     /**
      * @param initializers factories to create {@link DataSystemInitializer}s, in priority order.
      * @param synchronizers factories to create  {@link DataSystemSynchronizer}s, in priority order.
+     * @param fdv1Synchronizers factories to fallback to if we need to fallback to FDv1.
+     * @param _logger for logging
+     * @param _transitionConditions to control automated transition between datasources. Typically only used for testing.
+     * @param _backoff to control delay between transitions. Typically only used for testing.
      */
-    constructor(initializers, synchronizers, _logger, _transitionConditions = {
+    constructor(initializers, synchronizers, fdv1Synchronizers, _logger, _transitionConditions = {
         [DataSourceState.Valid]: {
             durationMS: DEFAULT_RECOVERY_TIME_MS,
             transition: 'recover',
@@ -1111,8 +1155,9 @@ class CompositeDataSource {
         this._initPhaseActive = initializers.length > 0; // init phase if we have initializers
         this._initFactories = new DataSourceList(false, initializers);
         this._syncFactories = new DataSourceList(true, synchronizers);
+        this._fdv1Synchronizers = new DataSourceList(true, fdv1Synchronizers);
     }
-    async start(dataCallback, statusCallback) {
+    async start(dataCallback, statusCallback, selectorGetter) {
         if (!this._stopped) {
             // don't allow multiple simultaneous runs
             this._logger?.info('CompositeDataSource already running. Ignoring call to start.');
@@ -1149,12 +1194,18 @@ class CompositeDataSource {
                         // When we get a status update, we want to fallback if it is an error.  We also want to schedule a transition for some
                         // time in the future if this status remains for some duration (ex: Recover to primary synchronizer after the secondary
                         // synchronizer has been Valid for some time).  These scheduled transitions are configurable in the constructor.
-                        this._logger?.debug(`CompositeDataSource received state ${state} from underlying data source.`);
+                        this._logger?.debug(`CompositeDataSource received state ${state} from underlying data source.  Err is ${err}`);
                         if (err || state === DataSourceState.Closed) {
                             callbackHandler.disable();
-                            if (err.recoverable === false) {
+                            if (err?.recoverable === false) {
                                 // don't use this datasource's factory again
+                                this._logger?.debug(`Culling data source due to err ${err}`);
                                 cullDSFactory?.();
+                                // this error indicates we should fallback to only using FDv1 synchronizers
+                                if (err instanceof LDFlagDeliveryFallbackError) {
+                                    this._logger?.debug(`Falling back to FDv1`);
+                                    this._syncFactories = this._fdv1Synchronizers;
+                                }
                             }
                             sanitizedStatusCallback(state, err);
                             this._consumeCancelToken(cancelScheduledTransition);
@@ -1181,7 +1232,7 @@ class CompositeDataSource {
                             }
                         }
                     });
-                    currentDS.start((basis, data) => callbackHandler.dataHandler(basis, data), (status, err) => callbackHandler.statusHandler(status, err));
+                    currentDS.start((basis, data) => callbackHandler.dataHandler(basis, data), (status, err) => callbackHandler.statusHandler(status, err), selectorGetter);
                 }
                 else {
                     // we don't have a data source to use!
@@ -1202,8 +1253,8 @@ class CompositeDataSource {
             // stop the underlying datasource before transitioning to next state
             currentDS?.stop();
             if (transitionRequest.err && transitionRequest.transition !== 'stop') {
-                // if the transition was due to an error, throttle the transition
-                const delay = this._backoff.fail();
+                // if the transition was due to an error we're not in the initializer phase, throttle the transition. Fallback between initializers is not throttled.
+                const delay = this._initPhaseActive ? 0 : this._backoff.fail();
                 const { promise, cancel: cancelDelay } = this._cancellableDelay(delay);
                 this._cancelTokens.push(cancelDelay);
                 const delayedTransition = promise.then(() => {
@@ -1238,6 +1289,7 @@ class CompositeDataSource {
         this._initPhaseActive = this._initFactories.length() > 0; // init phase if we have initializers;
         this._initFactories.reset();
         this._syncFactories.reset();
+        this._fdv1Synchronizers.reset();
         this._externalTransitionPromise = new Promise((tr) => {
             this._externalTransitionResolve = tr;
         });
@@ -1272,6 +1324,11 @@ class CompositeDataSource {
                 break;
             case 'fallback':
             default:
+                // if asked to fallback after using all init factories, switch to sync factories
+                if (this._initPhaseActive && this._initFactories.pos() >= this._initFactories.length()) {
+                    this._initPhaseActive = false;
+                    this._syncFactories.reset();
+                }
                 if (this._initPhaseActive) {
                     isPrimary = this._initFactories.pos() === 0;
                     factory = this._initFactories.next();
@@ -1363,31 +1420,6 @@ exports.DataSourceErrorKind = void 0;
     DataSourceErrorKind["InvalidData"] = "INVALID_DATA";
 })(exports.DataSourceErrorKind || (exports.DataSourceErrorKind = {}));
 
-class LDFileDataSourceError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'LaunchDarklyFileDataSourceError';
-    }
-}
-class LDPollingError extends Error {
-    constructor(kind, message, status, recoverable = true) {
-        super(message);
-        this.kind = kind;
-        this.status = status;
-        this.name = 'LaunchDarklyPollingError';
-        this.recoverable = recoverable;
-    }
-}
-class LDStreamingError extends Error {
-    constructor(kind, message, code, recoverable = true) {
-        super(message);
-        this.kind = kind;
-        this.code = code;
-        this.name = 'LaunchDarklyStreamingError';
-        this.recoverable = recoverable;
-    }
-}
-
 /* eslint-disable import/prefer-default-export */
 /**
  * Enable / disable Auto environment attributes. When enabled, the SDK will automatically
@@ -1870,7 +1902,7 @@ class ServiceEndpoints {
 }
 // eslint-disable-next-line @typescript-eslint/naming-convention
 ServiceEndpoints.DEFAULT_EVENTS = 'https://events.launchdarkly.com';
-function getWithParams(uri, parameters) {
+function getWithParams(uri, parameters = []) {
     if (parameters.length === 0) {
         return uri;
     }
@@ -1899,7 +1931,7 @@ function getStreamingUri(endpoints, path, parameters) {
  * @param path The path to the resource, devoid of any query parameters or hrefs.
  * @param parameters The query parameters. These query parameters must already have the appropriate encoding applied. This function WILL NOT apply it for you.
  */
-function getPollingUri(endpoints, path, parameters) {
+function getPollingUri(endpoints, path, parameters = []) {
     const canonicalizedPath = canonicalizePath(path);
     const combinedParameters = [...parameters];
     if (endpoints.payloadFilterKey) {
@@ -1914,7 +1946,7 @@ function getPollingUri(endpoints, path, parameters) {
  * @param path The path to the resource, devoid of any query parameters or hrefs.
  * @param parameters The query parameters. These query parameters must already have the appropriate encoding applied. This function WILL NOT apply it for you.
  */
-function getEventsUri(endpoints, path, parameters) {
+function getEventsUri(endpoints, path, parameters = []) {
     const canonicalizedPath = canonicalizePath(path);
     return getWithParams(`${endpoints.events}/${canonicalizedPath}`, parameters);
 }
@@ -2924,6 +2956,68 @@ class EventFactoryBase {
     }
 }
 
+const PAYLOAD_ID = 'FDv1Fallback';
+function fdv1PayloadAdaptor(processor) {
+    return {
+        _processor: processor,
+        _selector: '',
+        useSelector(selector) {
+            this._selector = selector;
+            return this;
+        },
+        processFullTransfer(data) {
+            const events = [
+                {
+                    event: 'server-intent',
+                    data: {
+                        payloads: [
+                            {
+                                id: PAYLOAD_ID,
+                                target: 1,
+                                intentCode: 'xfer-full',
+                                reason: 'payload-missing',
+                            },
+                        ],
+                    },
+                },
+            ];
+            Object.entries(data?.flags || []).forEach(([key, flag]) => {
+                events.push({
+                    event: 'put-object',
+                    data: {
+                        kind: 'flag',
+                        key,
+                        version: flag.version || 1,
+                        object: flag,
+                    },
+                });
+            });
+            Object.entries(data?.segments || []).forEach(([key, segment]) => {
+                events.push({
+                    event: 'put-object',
+                    data: {
+                        kind: 'segment',
+                        key,
+                        version: segment.version || 1,
+                        object: segment,
+                    },
+                });
+            });
+            events.push({
+                event: 'payload-transferred',
+                data: {
+                    // IMPORTANT: the selector MUST be empty or "live" data synchronizers
+                    // will not work as it would try to resume from a bogus state.
+                    state: this._selector,
+                    version: 1,
+                    id: PAYLOAD_ID,
+                },
+            });
+            this._processor.processEvents(events);
+        },
+    };
+}
+
 /**
  * A FDv2 PayloadProcessor can be used to parse payloads from a stream of FDv2 events. It will send payloads
  * to the PayloadListeners as the payloads are received. Invalid series of events may be dropped silently,
@@ -2954,7 +3048,7 @@ class PayloadProcessor {
             }
             // at the time of writing this, it was agreed upon that SDKs could assume exactly 1 element in this list.  In the future, a negotiation of protocol version will be required to remove this assumption.
             const payload = data.payloads[0];
-            switch (payload?.code) {
+            switch (payload?.intentCode) {
                 case 'xfer-full':
                     this._tempBasis = true;
                     break;
@@ -2967,6 +3061,7 @@ class PayloadProcessor {
                     break;
                 default:
                     // unrecognized intent code, return
+                    this._logger?.warn(`Unable to process intent code '${payload?.intentCode}'.`);
                     return;
             }
             this._tempId = payload?.id;
@@ -3024,8 +3119,12 @@ class PayloadProcessor {
         };
         this._processPayloadTransferred = (data) => {
             // if the following properties haven't been provided by now, we should reset
-            if (!this._tempId || // server intent hasn't been received yet.
-                !data.state ||
+            if (
+            // server intent hasn't been received yet.
+            !this._tempId ||
+                // selector can be an empty string if we are using a file data initilizer
+                data.state === null ||
+                data.state === undefined ||
                 !data.version) {
                 this._resetAll(); // a reset is best defensive action since payload transferred terminates a payload
                 return;
@@ -3228,6 +3327,7 @@ var index = /*#__PURE__*/Object.freeze({
     ErrorKinds: ErrorKinds$1,
     EventFactoryBase: EventFactoryBase,
     EventProcessor: EventProcessor,
+    FDv1PayloadAdaptor: fdv1PayloadAdaptor,
     InputCustomEvent: InputCustomEvent,
     InputEvalEvent: InputEvalEvent,
     InputIdentifyEvent: InputIdentifyEvent,
@@ -3259,6 +3359,7 @@ exports.Function = Function;
 exports.KindValidator = KindValidator;
 exports.LDClientError = LDClientError;
 exports.LDFileDataSourceError = LDFileDataSourceError;
+exports.LDFlagDeliveryFallbackError = LDFlagDeliveryFallbackError;
 exports.LDPollingError = LDPollingError;
 exports.LDStreamingError = LDStreamingError;
 exports.LDTimeoutError = LDTimeoutError;