@servicetitan/launchdarkly-service 39.3.0 → 40.1.0

package/dist/tests/get-sdk-version.test.js

@@ -0,0 +1,41 @@
+import { getSDKVersion } from '../get-sdk-version';
+let mockSdkVersion;
+let mockPackageJsonVersion;
+jest.mock('launchdarkly-js-client-sdk', ()=>({
+        get version () {
+            return mockSdkVersion;
+        }
+    }));
+jest.mock('launchdarkly-js-client-sdk/package.json', ()=>({
+        get version () {
+            return mockPackageJsonVersion;
+        }
+    }));
+describe(`[launchdarkly-service] ${getSDKVersion.name}`, ()=>{
+    beforeEach(()=>{
+        mockSdkVersion = '3.9.5';
+        mockPackageJsonVersion = '3.9.6';
+    });
+    const subject = ()=>getSDKVersion();
+    test('returns the version exported by the running SDK', ()=>{
+        expect(subject()).toBe(mockSdkVersion);
+    });
+    describe('when the running SDK does not export a version', ()=>{
+        beforeEach(()=>{
+            mockSdkVersion = undefined;
+        });
+        test('returns the version from package.json instead', ()=>{
+            expect(subject()).toBe(mockPackageJsonVersion);
+        });
+        describe('when package.json also has no version', ()=>{
+            beforeEach(()=>{
+                mockPackageJsonVersion = undefined;
+            });
+            test('returns undefined', ()=>{
+                expect(subject()).toBeUndefined();
+            });
+        });
+    });
+});
+
+//# sourceMappingURL=get-sdk-version.test.js.map

package/dist/tests/get-sdk-version.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tests/get-sdk-version.test.ts"],"sourcesContent":["import { getSDKVersion } from '../get-sdk-version';\n\nlet mockSdkVersion: string | undefined;\nlet mockPackageJsonVersion: string | undefined;\n\njest.mock('launchdarkly-js-client-sdk', () => ({\n    get version() {\n        return mockSdkVersion;\n    },\n}));\njest.mock('launchdarkly-js-client-sdk/package.json', () => ({\n    get version() {\n        return mockPackageJsonVersion;\n    },\n}));\n\ndescribe(`[launchdarkly-service] ${getSDKVersion.name}`, () => {\n    beforeEach(() => {\n        mockSdkVersion = '3.9.5';\n        mockPackageJsonVersion = '3.9.6';\n    });\n\n    const subject = () => getSDKVersion();\n\n    test('returns the version exported by the running SDK', () => {\n        expect(subject()).toBe(mockSdkVersion);\n    });\n\n    describe('when the running SDK does not export a version', () => {\n        beforeEach(() => {\n            mockSdkVersion = undefined;\n        });\n\n        test('returns the version from package.json instead', () => {\n            expect(subject()).toBe(mockPackageJsonVersion);\n        });\n\n        describe('when package.json also has no version', () => {\n            beforeEach(() => {\n                mockPackageJsonVersion = undefined;\n            });\n\n            test('returns undefined', () => {\n                expect(subject()).toBeUndefined();\n            });\n        });\n    });\n});\n"],"names":["getSDKVersion","mockSdkVersion","mockPackageJsonVersion","jest","mock","version","describe","name","beforeEach","subject","test","expect","toBe","undefined","toBeUndefined"],"mappings":"AAAA,SAASA,aAAa,QAAQ,qBAAqB;AAEnD,IAAIC;AACJ,IAAIC;AAEJC,KAAKC,IAAI,CAAC,8BAA8B,IAAO,CAAA;QAC3C,IAAIC;YACA,OAAOJ;QACX;IACJ,CAAA;AACAE,KAAKC,IAAI,CAAC,2CAA2C,IAAO,CAAA;QACxD,IAAIC;YACA,OAAOH;QACX;IACJ,CAAA;AAEAI,SAAS,CAAC,uBAAuB,EAAEN,cAAcO,IAAI,EAAE,EAAE;IACrDC,WAAW;QACPP,iBAAiB;QACjBC,yBAAyB;IAC7B;IAEA,MAAMO,UAAU,IAAMT;IAEtBU,KAAK,mDAAmD;QACpDC,OAAOF,WAAWG,IAAI,CAACX;IAC3B;IAEAK,SAAS,kDAAkD;QACvDE,WAAW;YACPP,iBAAiBY;QACrB;QAEAH,KAAK,iDAAiD;YAClDC,OAAOF,WAAWG,IAAI,CAACV;QAC3B;QAEAI,SAAS,yCAAyC;YAC9CE,WAAW;gBACPN,yBAAyBW;YAC7B;YAEAH,KAAK,qBAAqB;gBACtBC,OAAOF,WAAWK,aAAa;YACnC;QACJ;IACJ;AACJ"}

package/dist/tests/get-version-client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=get-version-client.test.d.ts.map

package/dist/tests/get-version-client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-version-client.test.d.ts","sourceRoot":"","sources":["../../src/tests/get-version-client.test.ts"],"names":[],"mappings":""}

package/dist/tests/get-version-client.test.js

@@ -0,0 +1,63 @@
+import { getVersionClient } from '../get-version-client';
+describe(`[launchdarkly-service] ${getVersionClient.name}`, ()=>{
+    let version;
+    let config;
+    let createClient;
+    let client;
+    const subject = ()=>getVersionClient(version, config, createClient);
+    beforeEach(()=>{
+        version = '3.9.5';
+        config = {
+            clientSideID: makeId(),
+            context: {
+                kind: 'multi'
+            }
+        };
+        client = Symbol('client');
+        createClient = jest.fn().mockReturnValue(client);
+    });
+    test('returns the client created by createClient', ()=>{
+        expect(subject()).toBe(client);
+    });
+    test('creates the client using the given config', ()=>{
+        subject();
+        expect(createClient).toHaveBeenCalledWith(config);
+    });
+    describe('when a client already exists', ()=>{
+        const newClient = Symbol('newClient');
+        beforeEach(()=>{
+            subject();
+            createClient.mockClear();
+            createClient.mockReturnValue(newClient);
+        });
+        test('returns the existing client', ()=>{
+            expect(subject()).toBe(client);
+            expect(createClient).not.toHaveBeenCalled();
+        });
+        function itCreatesNewClient() {
+            test('creates a new client', ()=>{
+                expect(subject()).toBe(newClient);
+            });
+        }
+        describe('when clientSideID differs', ()=>{
+            beforeEach(()=>{
+                config = {
+                    ...config,
+                    clientSideID: makeId()
+                };
+            });
+            itCreatesNewClient();
+        });
+        describe('when version differs', ()=>{
+            beforeEach(()=>{
+                version = '3.5.0';
+            });
+            itCreatesNewClient();
+        });
+    });
+});
+function makeId() {
+    return Math.round(1e6 * Math.random()).toString(36);
+}
+
+//# sourceMappingURL=get-version-client.test.js.map

package/dist/tests/get-version-client.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tests/get-version-client.test.ts"],"sourcesContent":["import { LDClient } from 'launchdarkly-js-client-sdk';\nimport { getVersionClient } from '../get-version-client';\nimport { ClientConfig } from '../types';\n\ndescribe(`[launchdarkly-service] ${getVersionClient.name}`, () => {\n    let version: string;\n    let config: ClientConfig;\n    let createClient: jest.Mock<LDClient, [ClientConfig]>;\n    let client: LDClient;\n\n    const subject = () => getVersionClient(version, config, createClient);\n\n    beforeEach(() => {\n        version = '3.9.5';\n        config = { clientSideID: makeId(), context: { kind: 'multi' } };\n        client = Symbol('client') as unknown as LDClient;\n        createClient = jest.fn().mockReturnValue(client);\n    });\n\n    test('returns the client created by createClient', () => {\n        expect(subject()).toBe(client);\n    });\n\n    test('creates the client using the given config', () => {\n        subject();\n\n        expect(createClient).toHaveBeenCalledWith(config);\n    });\n\n    describe('when a client already exists', () => {\n        const newClient = Symbol('newClient') as unknown as LDClient;\n\n        beforeEach(() => {\n            subject();\n            createClient.mockClear();\n            createClient.mockReturnValue(newClient);\n        });\n\n        test('returns the existing client', () => {\n            expect(subject()).toBe(client);\n            expect(createClient).not.toHaveBeenCalled();\n        });\n\n        function itCreatesNewClient() {\n            test('creates a new client', () => {\n                expect(subject()).toBe(newClient);\n            });\n        }\n\n        describe('when clientSideID differs', () => {\n            beforeEach(() => {\n                config = { ...config, clientSideID: makeId() };\n            });\n\n            itCreatesNewClient();\n        });\n\n        describe('when version differs', () => {\n            beforeEach(() => {\n                version = '3.5.0';\n            });\n\n            itCreatesNewClient();\n        });\n    });\n});\n\nfunction makeId() {\n    return Math.round(1e6 * Math.random()).toString(36);\n}\n"],"names":["getVersionClient","describe","name","version","config","createClient","client","subject","beforeEach","clientSideID","makeId","context","kind","Symbol","jest","fn","mockReturnValue","test","expect","toBe","toHaveBeenCalledWith","newClient","mockClear","not","toHaveBeenCalled","itCreatesNewClient","Math","round","random","toString"],"mappings":"AACA,SAASA,gBAAgB,QAAQ,wBAAwB;AAGzDC,SAAS,CAAC,uBAAuB,EAAED,iBAAiBE,IAAI,EAAE,EAAE;IACxD,IAAIC;IACJ,IAAIC;IACJ,IAAIC;IACJ,IAAIC;IAEJ,MAAMC,UAAU,IAAMP,iBAAiBG,SAASC,QAAQC;IAExDG,WAAW;QACPL,UAAU;QACVC,SAAS;YAAEK,cAAcC;YAAUC,SAAS;gBAAEC,MAAM;YAAQ;QAAE;QAC9DN,SAASO,OAAO;QAChBR,eAAeS,KAAKC,EAAE,GAAGC,eAAe,CAACV;IAC7C;IAEAW,KAAK,8CAA8C;QAC/CC,OAAOX,WAAWY,IAAI,CAACb;IAC3B;IAEAW,KAAK,6CAA6C;QAC9CV;QAEAW,OAAOb,cAAce,oBAAoB,CAAChB;IAC9C;IAEAH,SAAS,gCAAgC;QACrC,MAAMoB,YAAYR,OAAO;QAEzBL,WAAW;YACPD;YACAF,aAAaiB,SAAS;YACtBjB,aAAaW,eAAe,CAACK;QACjC;QAEAJ,KAAK,+BAA+B;YAChCC,OAAOX,WAAWY,IAAI,CAACb;YACvBY,OAAOb,cAAckB,GAAG,CAACC,gBAAgB;QAC7C;QAEA,SAASC;YACLR,KAAK,wBAAwB;gBACzBC,OAAOX,WAAWY,IAAI,CAACE;YAC3B;QACJ;QAEApB,SAAS,6BAA6B;YAClCO,WAAW;gBACPJ,SAAS;oBAAE,GAAGA,MAAM;oBAAEK,cAAcC;gBAAS;YACjD;YAEAe;QACJ;QAEAxB,SAAS,wBAAwB;YAC7BO,WAAW;gBACPL,UAAU;YACd;YAEAsB;QACJ;IACJ;AACJ;AAEA,SAASf;IACL,OAAOgB,KAAKC,KAAK,CAAC,MAAMD,KAAKE,MAAM,IAAIC,QAAQ,CAAC;AACpD"}

package/dist/tests/ld-service-provider.test.js

@@ -2,6 +2,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { Provider, useDependencies } from '@servicetitan/react-ioc';
 import { render } from '@testing-library/react';
 import { getLDClient } from '../get-ld-client';
+import { getVersionClient } from '../get-version-client';
 import { LDServiceProvider } from '../ld-service-provider';
 import { LD_SERVICE_TOKEN } from '../types';
 describe(`[launchdarkly-service] ${LDServiceProvider.name}`, ()=>{
@@ -32,7 +33,8 @@ describe(`[launchdarkly-service] ${LDServiceProvider.name}`, ()=>{
     test('provides LDService instance', ()=>{
         subject();
         expect(providedLDService).toEqual({
-            getClient: getLDClient
+            getClient: getLDClient,
+            getVersionClient
         });
     });
     test('provides no application', ()=>{

package/dist/tests/ld-service-provider.test.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tests/ld-service-provider.test.tsx"],"sourcesContent":["import { Provider, useDependencies } from '@servicetitan/react-ioc';\nimport { render } from '@testing-library/react';\nimport { LDOptions } from 'launchdarkly-js-client-sdk';\nimport { ComponentProps, FC } from 'react';\nimport { getLDClient } from '../get-ld-client';\nimport { LDServiceProvider } from '../ld-service-provider';\nimport { LD_SERVICE_TOKEN, LDApplication, LDService } from '../types';\n\ndescribe(`[launchdarkly-service] ${LDServiceProvider.name}`, () => {\n    let providedApplication: LDApplication | undefined;\n    let providedOptions: LDOptions | undefined;\n    let providedLDService: LDService;\n    let singletons: Parameters<typeof Provider>[0]['singletons'];\n    let props: ComponentProps<typeof LDServiceProvider>;\n\n    const Component: FC = () => {\n        [providedLDService] = useDependencies(LD_SERVICE_TOKEN);\n        providedApplication = providedLDService.application;\n        providedOptions = providedLDService.options;\n        return null;\n    };\n\n    beforeEach(() => {\n        singletons = [];\n        props = {};\n    });\n\n    const subject = () => {\n        return render(\n            <Provider singletons={singletons}>\n                <LDServiceProvider {...props}>\n                    <Component />\n                </LDServiceProvider>\n            </Provider>\n        );\n    };\n\n    test('provides LDService instance', () => {\n        subject();\n\n        expect(providedLDService).toEqual({ getClient: getLDClient });\n    });\n\n    test('provides no application', () => {\n        subject();\n\n        expect(providedApplication).toBeUndefined();\n    });\n\n    test('provides no options', () => {\n        subject();\n\n        expect(providedOptions).toBeUndefined();\n    });\n\n    describe('when LDService is already provided', () => {\n        const ldService: LDService = { getClient: jest.fn() };\n\n        beforeEach(() => singletons?.push({ provide: LD_SERVICE_TOKEN, useValue: ldService }));\n\n        test('provides existing LDService', () => {\n            subject();\n\n            expect(providedLDService).toBe(ldService);\n        });\n    });\n\n    describe('with \"application\" prop', () => {\n        const application = { id: 'some-application', version: '1.0.0' };\n\n        beforeEach(() => (props.application = application));\n\n        function itProvidesApplication() {\n            test('provides application', () => {\n                subject();\n\n                expect(providedApplication).toBe(application);\n            });\n        }\n\n        itProvidesApplication();\n\n        describe('when rerendered with new application', () => {\n            const newApplication = { id: 'foo' };\n\n            beforeEach(() => {\n                const { rerender } = subject();\n\n                rerender(\n                    <LDServiceProvider application={newApplication}>\n                        <Component />\n                    </LDServiceProvider>\n                );\n            });\n\n            test('provides new application', () => {\n                expect(providedApplication).toBe(newApplication);\n            });\n        });\n\n        describe('when rerendered without application', () => {\n            beforeEach(() => {\n                const { rerender } = subject();\n\n                rerender(\n                    <LDServiceProvider>\n                        <Component />\n                    </LDServiceProvider>\n                );\n            });\n\n            test('drops application', () => {\n                expect(providedApplication).toBeUndefined();\n            });\n        });\n\n        describe('when LDService is already provided', () => {\n            let providedLDService: LDService;\n\n            beforeEach(() => {\n                providedLDService = { getClient: jest.fn() };\n                singletons?.push({ provide: LD_SERVICE_TOKEN, useValue: providedLDService });\n            });\n\n            itProvidesApplication();\n\n            test('unmount resets LDService.application', () => {\n                const { unmount } = subject();\n                unmount();\n\n                expect(providedLDService.application).toBeUndefined();\n            });\n\n            describe('when provided LDService has application', () => {\n                const otherApplication = { id: 'other-application', version: '2.0.0' };\n\n                beforeEach(() => (providedLDService.application = otherApplication));\n\n                test('provides inherited application', () => {\n                    subject();\n\n                    expect(providedApplication).toBe(otherApplication);\n                });\n\n                test('unmount preserves LDService.application', () => {\n                    const { unmount } = subject();\n                    unmount();\n\n                    expect(providedLDService.application).toBe(otherApplication);\n                });\n            });\n        });\n    });\n\n    describe('with \"options\" prop', () => {\n        const options: LDOptions = { hash: 'abc123' };\n\n        beforeEach(() => (props.options = options));\n\n        function itProvidesOptions() {\n            test('provides options', () => {\n                subject();\n\n                expect(providedOptions).toBe(options);\n            });\n        }\n\n        itProvidesOptions();\n\n        describe('when rerendered with new options', () => {\n            const newOptions: LDOptions = { evaluationReasons: true };\n\n            beforeEach(() => {\n                const { rerender } = subject();\n\n                rerender(\n                    <LDServiceProvider options={newOptions}>\n                        <Component />\n                    </LDServiceProvider>\n                );\n            });\n\n            test('provides new options', () => {\n                expect(providedOptions).toBe(newOptions);\n            });\n        });\n\n        describe('when rerendered without options', () => {\n            beforeEach(() => {\n                const { rerender } = subject();\n\n                rerender(\n                    <LDServiceProvider>\n                        <Component />\n                    </LDServiceProvider>\n                );\n            });\n\n            test('drops options', () => {\n                expect(providedOptions).toBeUndefined();\n            });\n        });\n\n        describe('when LDService is already provided', () => {\n            let parentLDService: LDService;\n\n            beforeEach(() => {\n                parentLDService = { getClient: jest.fn() };\n                singletons?.push({ provide: LD_SERVICE_TOKEN, useValue: parentLDService });\n            });\n\n            itProvidesOptions();\n\n            test('unmount resets LDService.options', () => {\n                const { unmount } = subject();\n                unmount();\n\n                expect(parentLDService.options).toBeUndefined();\n            });\n\n            describe('when provided LDService has options', () => {\n                const otherOptions: LDOptions = { evaluationReasons: true };\n\n                beforeEach(() => (parentLDService.options = otherOptions));\n\n                test('provides inherited options', () => {\n                    subject();\n\n                    expect(providedOptions).toBe(otherOptions);\n                });\n\n                test('unmount preserves LDService.options', () => {\n                    const { unmount } = subject();\n                    unmount();\n\n                    expect(parentLDService.options).toBe(otherOptions);\n                });\n            });\n        });\n    });\n\n    describe('with both \"application\" and \"options\" props', () => {\n        const application = { id: 'some-application', version: '1.0.0' };\n        const options: LDOptions = { hash: 'abc123' };\n\n        beforeEach(() => {\n            props.application = application;\n            props.options = options;\n        });\n\n        test('provides both application and options', () => {\n            subject();\n\n            expect(providedApplication).toBe(application);\n            expect(providedOptions).toBe(options);\n        });\n    });\n});\n"],"names":["Provider","useDependencies","render","getLDClient","LDServiceProvider","LD_SERVICE_TOKEN","describe","name","providedApplication","providedOptions","providedLDService","singletons","props","Component","application","options","beforeEach","subject","test","expect","toEqual","getClient","toBeUndefined","ldService","jest","fn","push","provide","useValue","toBe","id","version","itProvidesApplication","newApplication","rerender","unmount","otherApplication","hash","itProvidesOptions","newOptions","evaluationReasons","parentLDService","otherOptions"],"mappings":"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"}
+{"version":3,"sources":["../../src/tests/ld-service-provider.test.tsx"],"sourcesContent":["import { Provider, useDependencies } from '@servicetitan/react-ioc';\nimport { render } from '@testing-library/react';\nimport { LDOptions } from 'launchdarkly-js-client-sdk';\nimport { ComponentProps, FC } from 'react';\nimport { getLDClient } from '../get-ld-client';\nimport { getVersionClient } from '../get-version-client';\nimport { LDServiceProvider } from '../ld-service-provider';\nimport { LD_SERVICE_TOKEN, LDApplication, LDService } from '../types';\n\ndescribe(`[launchdarkly-service] ${LDServiceProvider.name}`, () => {\n    let providedApplication: LDApplication | undefined;\n    let providedOptions: LDOptions | undefined;\n    let providedLDService: LDService;\n    let singletons: Parameters<typeof Provider>[0]['singletons'];\n    let props: ComponentProps<typeof LDServiceProvider>;\n\n    const Component: FC = () => {\n        [providedLDService] = useDependencies(LD_SERVICE_TOKEN);\n        providedApplication = providedLDService.application;\n        providedOptions = providedLDService.options;\n        return null;\n    };\n\n    beforeEach(() => {\n        singletons = [];\n        props = {};\n    });\n\n    const subject = () => {\n        return render(\n            <Provider singletons={singletons}>\n                <LDServiceProvider {...props}>\n                    <Component />\n                </LDServiceProvider>\n            </Provider>\n        );\n    };\n\n    test('provides LDService instance', () => {\n        subject();\n\n        expect(providedLDService).toEqual({ getClient: getLDClient, getVersionClient });\n    });\n\n    test('provides no application', () => {\n        subject();\n\n        expect(providedApplication).toBeUndefined();\n    });\n\n    test('provides no options', () => {\n        subject();\n\n        expect(providedOptions).toBeUndefined();\n    });\n\n    describe('when LDService is already provided', () => {\n        const ldService: LDService = { getClient: jest.fn() };\n\n        beforeEach(() => singletons?.push({ provide: LD_SERVICE_TOKEN, useValue: ldService }));\n\n        test('provides existing LDService', () => {\n            subject();\n\n            expect(providedLDService).toBe(ldService);\n        });\n    });\n\n    describe('with \"application\" prop', () => {\n        const application = { id: 'some-application', version: '1.0.0' };\n\n        beforeEach(() => (props.application = application));\n\n        function itProvidesApplication() {\n            test('provides application', () => {\n                subject();\n\n                expect(providedApplication).toBe(application);\n            });\n        }\n\n        itProvidesApplication();\n\n        describe('when rerendered with new application', () => {\n            const newApplication = { id: 'foo' };\n\n            beforeEach(() => {\n                const { rerender } = subject();\n\n                rerender(\n                    <LDServiceProvider application={newApplication}>\n                        <Component />\n                    </LDServiceProvider>\n                );\n            });\n\n            test('provides new application', () => {\n                expect(providedApplication).toBe(newApplication);\n            });\n        });\n\n        describe('when rerendered without application', () => {\n            beforeEach(() => {\n                const { rerender } = subject();\n\n                rerender(\n                    <LDServiceProvider>\n                        <Component />\n                    </LDServiceProvider>\n                );\n            });\n\n            test('drops application', () => {\n                expect(providedApplication).toBeUndefined();\n            });\n        });\n\n        describe('when LDService is already provided', () => {\n            let providedLDService: LDService;\n\n            beforeEach(() => {\n                providedLDService = { getClient: jest.fn() };\n                singletons?.push({ provide: LD_SERVICE_TOKEN, useValue: providedLDService });\n            });\n\n            itProvidesApplication();\n\n            test('unmount resets LDService.application', () => {\n                const { unmount } = subject();\n                unmount();\n\n                expect(providedLDService.application).toBeUndefined();\n            });\n\n            describe('when provided LDService has application', () => {\n                const otherApplication = { id: 'other-application', version: '2.0.0' };\n\n                beforeEach(() => (providedLDService.application = otherApplication));\n\n                test('provides inherited application', () => {\n                    subject();\n\n                    expect(providedApplication).toBe(otherApplication);\n                });\n\n                test('unmount preserves LDService.application', () => {\n                    const { unmount } = subject();\n                    unmount();\n\n                    expect(providedLDService.application).toBe(otherApplication);\n                });\n            });\n        });\n    });\n\n    describe('with \"options\" prop', () => {\n        const options: LDOptions = { hash: 'abc123' };\n\n        beforeEach(() => (props.options = options));\n\n        function itProvidesOptions() {\n            test('provides options', () => {\n                subject();\n\n                expect(providedOptions).toBe(options);\n            });\n        }\n\n        itProvidesOptions();\n\n        describe('when rerendered with new options', () => {\n            const newOptions: LDOptions = { evaluationReasons: true };\n\n            beforeEach(() => {\n                const { rerender } = subject();\n\n                rerender(\n                    <LDServiceProvider options={newOptions}>\n                        <Component />\n                    </LDServiceProvider>\n                );\n            });\n\n            test('provides new options', () => {\n                expect(providedOptions).toBe(newOptions);\n            });\n        });\n\n        describe('when rerendered without options', () => {\n            beforeEach(() => {\n                const { rerender } = subject();\n\n                rerender(\n                    <LDServiceProvider>\n                        <Component />\n                    </LDServiceProvider>\n                );\n            });\n\n            test('drops options', () => {\n                expect(providedOptions).toBeUndefined();\n            });\n        });\n\n        describe('when LDService is already provided', () => {\n            let parentLDService: LDService;\n\n            beforeEach(() => {\n                parentLDService = { getClient: jest.fn() };\n                singletons?.push({ provide: LD_SERVICE_TOKEN, useValue: parentLDService });\n            });\n\n            itProvidesOptions();\n\n            test('unmount resets LDService.options', () => {\n                const { unmount } = subject();\n                unmount();\n\n                expect(parentLDService.options).toBeUndefined();\n            });\n\n            describe('when provided LDService has options', () => {\n                const otherOptions: LDOptions = { evaluationReasons: true };\n\n                beforeEach(() => (parentLDService.options = otherOptions));\n\n                test('provides inherited options', () => {\n                    subject();\n\n                    expect(providedOptions).toBe(otherOptions);\n                });\n\n                test('unmount preserves LDService.options', () => {\n                    const { unmount } = subject();\n                    unmount();\n\n                    expect(parentLDService.options).toBe(otherOptions);\n                });\n            });\n        });\n    });\n\n    describe('with both \"application\" and \"options\" props', () => {\n        const application = { id: 'some-application', version: '1.0.0' };\n        const options: LDOptions = { hash: 'abc123' };\n\n        beforeEach(() => {\n            props.application = application;\n            props.options = options;\n        });\n\n        test('provides both application and options', () => {\n            subject();\n\n            expect(providedApplication).toBe(application);\n            expect(providedOptions).toBe(options);\n        });\n    });\n});\n"],"names":["Provider","useDependencies","render","getLDClient","getVersionClient","LDServiceProvider","LD_SERVICE_TOKEN","describe","name","providedApplication","providedOptions","providedLDService","singletons","props","Component","application","options","beforeEach","subject","test","expect","toEqual","getClient","toBeUndefined","ldService","jest","fn","push","provide","useValue","toBe","id","version","itProvidesApplication","newApplication","rerender","unmount","otherApplication","hash","itProvidesOptions","newOptions","evaluationReasons","parentLDService","otherOptions"],"mappings":"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"}

package/dist/types.d.ts

@@ -8,6 +8,13 @@ export interface ClientConfig {
 }
 export interface LDService {
     getClient: (config: ClientConfig) => LDClient;
+    /**
+     * Like `getClient`, but shares the client with any other caller using the same `version` and
+     * `clientSideID`, regardless of which side's SDK build constructed it. Callers supply
+     * `createClient` because the provider may not have the SDK version needed to build a client
+     * for a `version` it doesn't recognize.
+     */
+    getVersionClient?: (version: string, config: ClientConfig, createClient: (config: ClientConfig) => LDClient) => LDClient;
     application?: LDApplication;
     options?: Omit<LDOptions, 'application'>;
 }

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEjF,eAAO,MAAM,gBAAgB,0DAA6C,CAAC;AAE3E,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC,CAAC;AAErD,MAAM,WAAW,YAAY;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACtB,SAAS,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,QAAQ,CAAC;IAC9C,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;CAC5C;AAED,MAAM,MAAM,OAAO,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,GAAG;IAC5C,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;CAClB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEjF,eAAO,MAAM,gBAAgB,0DAA6C,CAAC;AAE3E,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC,CAAC;AAErD,MAAM,WAAW,YAAY;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACtB,SAAS,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,QAAQ,CAAC;IAC9C;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,CACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,QAAQ,KAC/C,QAAQ,CAAC;IACd,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;CAC5C;AAED,MAAM,MAAM,OAAO,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,GAAG;IAC5C,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;CAClB,CAAC"}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import { symbolToken } from '@servicetitan/react-ioc';\nimport type { LDClient, LDContext, LDOptions } from 'launchdarkly-js-client-sdk';\n\nexport const LD_SERVICE_TOKEN = symbolToken<LDService>('LD_SERVICE_TOKEN');\n\nexport type LDApplication = LDOptions['application'];\n\nexport interface ClientConfig {\n    clientSideID: string;\n    context: LDContext;\n    options?: LDOptions;\n}\n\nexport interface LDService {\n    getClient: (config: ClientConfig) => LDClient;\n    application?: LDApplication;\n    options?: Omit<LDOptions, 'application'>;\n}\n\nexport type FlagKey<S, K extends keyof S> = K & {\n    typeRef?: S[K];\n};\n"],"names":["symbolToken","LD_SERVICE_TOKEN"],"mappings":"AAAA,SAASA,WAAW,QAAQ,0BAA0B;AAGtD,OAAO,MAAMC,mBAAmBD,YAAuB,oBAAoB"}
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import { symbolToken } from '@servicetitan/react-ioc';\nimport type { LDClient, LDContext, LDOptions } from 'launchdarkly-js-client-sdk';\n\nexport const LD_SERVICE_TOKEN = symbolToken<LDService>('LD_SERVICE_TOKEN');\n\nexport type LDApplication = LDOptions['application'];\n\nexport interface ClientConfig {\n    clientSideID: string;\n    context: LDContext;\n    options?: LDOptions;\n}\n\nexport interface LDService {\n    getClient: (config: ClientConfig) => LDClient;\n    /**\n     * Like `getClient`, but shares the client with any other caller using the same `version` and\n     * `clientSideID`, regardless of which side's SDK build constructed it. Callers supply\n     * `createClient` because the provider may not have the SDK version needed to build a client\n     * for a `version` it doesn't recognize.\n     */\n    getVersionClient?: (\n        version: string,\n        config: ClientConfig,\n        createClient: (config: ClientConfig) => LDClient\n    ) => LDClient;\n    application?: LDApplication;\n    options?: Omit<LDOptions, 'application'>;\n}\n\nexport type FlagKey<S, K extends keyof S> = K & {\n    typeRef?: S[K];\n};\n"],"names":["symbolToken","LD_SERVICE_TOKEN"],"mappings":"AAAA,SAASA,WAAW,QAAQ,0BAA0B;AAGtD,OAAO,MAAMC,mBAAmBD,YAAuB,oBAAoB"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@servicetitan/launchdarkly-service",
-    "version": "39.3.0",
+    "version": "40.1.0",
     "description": "Service for creating and reusing client connections for LaunchDarkly",
     "homepage": "https://docs.st.dev/docs/frontend/uikit/launchdarkly-service",
     "repository": {
@@ -26,24 +26,24 @@
         "src"
     ],
     "devDependencies": {
-        "@datadog/browser-rum": "^7.9.0",
-        "@servicetitan/log-service": "39.3.0",
-        "@servicetitan/react-ioc": "39.3.0",
-        "@testing-library/dom": "^10.4.1",
+        "@datadog/browser-rum": "^7.13.0",
+        "@servicetitan/log-service": "40.1.0",
+        "@servicetitan/react-ioc": "40.1.0",
+        "@testing-library/dom": "^10.4.2",
         "@testing-library/jest-dom": "^7.0.1",
         "@testing-library/react": "^16.3.3",
-        "launchdarkly-js-client-sdk": "3.5.0",
-        "launchdarkly-react-client-sdk": "3.6.1",
+        "launchdarkly-js-client-sdk": "3.9.5",
+        "launchdarkly-react-client-sdk": "3.9.4",
         "mobx": "~6.16.1",
         "mobx-react": "~9.2.2",
         "react": "~18.3.1"
     },
     "peerDependencies": {
         "@datadog/browser-rum": ">=6.19.0",
-        "@servicetitan/log-service": "39.3.0",
-        "@servicetitan/react-ioc": "39.3.0",
-        "launchdarkly-js-client-sdk": "3.5.0",
-        "launchdarkly-react-client-sdk": "3.6.1",
+        "@servicetitan/log-service": "40.1.0",
+        "@servicetitan/react-ioc": "40.1.0",
+        "launchdarkly-js-client-sdk": "3.9.5",
+        "launchdarkly-react-client-sdk": "3.9.4",
         "mobx": ">= 6.13.5",
         "mobx-react": ">=9.2.0",
         "react": ">=17.0.2"

package/src/create-ld-client.ts

@@ -0,0 +1,8 @@
+import { LDClient, LDOptions, initialize } from 'launchdarkly-js-client-sdk';
+import { ClientConfig } from './types';
+
+const defaultOptions: LDOptions = { sendEventsOnlyForVariation: true };
+
+export function createLDClient({ clientSideID, context, options }: ClientConfig): LDClient {
+    return initialize(clientSideID, context, { ...defaultOptions, ...options });
+}

package/src/get-client.ts

@@ -0,0 +1,13 @@
+import { LDClient } from 'launchdarkly-js-client-sdk';
+import { createLDClient } from './create-ld-client';
+import { getLDClient } from './get-ld-client';
+import { getSDKVersion } from './get-sdk-version';
+import { ClientConfig, LDService } from './types';
+
+export function getClient(ldService: LDService | undefined, config: ClientConfig): LDClient {
+    const version = getSDKVersion();
+    if (version && ldService?.getVersionClient) {
+        return ldService.getVersionClient(version, config, createLDClient);
+    }
+    return ldService?.getClient(config) ?? getLDClient(config);
+}

package/src/get-ld-client.ts

@@ -1,15 +1,12 @@
-import { LDClient, LDOptions, initialize } from 'launchdarkly-js-client-sdk';
+import { LDClient } from 'launchdarkly-js-client-sdk';
+import { createLDClient } from './create-ld-client';
+import { getSDKVersion } from './get-sdk-version';
+import { getVersionClient } from './get-version-client';
 import { ClientConfig } from './types';
 
-const ldClients: Map<string, LDClient> = new Map();
+// Ensures different bundles that fail version detection won't share an incompatible client.
+const UNKNOWN_VERSION = `0.0.0-unknown.${Math.round(1e6 * Math.random()).toString(36)}`;
 
-const defaultOptions: LDOptions = { sendEventsOnlyForVariation: true };
-
-export function getLDClient({ clientSideID, context, options }: ClientConfig): LDClient {
-    let client = ldClients.get(clientSideID);
-    if (!client) {
-        client = initialize(clientSideID, context, { ...defaultOptions, ...options });
-        ldClients.set(clientSideID, client);
-    }
-    return client;
+export function getLDClient(config: ClientConfig): LDClient {
+    return getVersionClient(getSDKVersion() ?? UNKNOWN_VERSION, config, createLDClient);
 }

package/src/get-sdk-version.ts

@@ -0,0 +1,10 @@
+import * as LDClientSDK from 'launchdarkly-js-client-sdk';
+import ldClientPackageJson from 'launchdarkly-js-client-sdk/package.json';
+
+/*
+ * "version" isn't declared in the SDK's typings, but is present at runtime. Fall back to
+ * package.json's version in case a future SDK release removes the runtime export.
+ */
+export function getSDKVersion(): string | undefined {
+    return (LDClientSDK as unknown as { version?: string }).version ?? ldClientPackageJson.version;
+}

package/src/get-version-client.ts

@@ -0,0 +1,18 @@
+import { LDClient } from 'launchdarkly-js-client-sdk';
+import { ClientConfig } from './types';
+
+const clients: Map<string, LDClient> = new Map();
+
+export function getVersionClient(
+    version: string,
+    config: ClientConfig,
+    createClient: (config: ClientConfig) => LDClient
+): LDClient {
+    const key = `${version}:${config.clientSideID}`;
+    let client = clients.get(key);
+    if (!client) {
+        client = createClient(config);
+        clients.set(key, client);
+    }
+    return client;
+}

package/src/index.ts

@@ -1,5 +1,7 @@
 export * from './create-flag-keys';
+export * from './create-ld-client';
 export * from './feature-flag-store';
+export * from './get-client';
 export * from './get-ld-client';
 export * from './ld-provider';
 export * from './ld-service-provider';

package/src/ld-provider.tsx

@@ -8,7 +8,7 @@ import {
 import { FC, PropsWithChildren, useEffect, useReducer, useState } from 'react';
 import { FeatureFlagProvider } from './feature-flag-provider';
 import { FeatureFlagStore } from './feature-flag-store';
-import { getLDClient } from './get-ld-client';
+import { getClient } from './get-client';
 import { ClientConfig, LDService, LD_SERVICE_TOKEN } from './types';
 
 export type ProviderConfig = Pick<BaseProviderConfig, 'clientSideID' | 'flags'> & {
@@ -55,7 +55,7 @@ export const LDProvider: FC<PropsWithChildren<ProviderConfig>> = provide({
         (async function initializeClient() {
             const options = mergeOptions(ldService);
             const config: ClientConfig = { clientSideID, context, options };
-            const client = ldService?.getClient(config) ?? getLDClient(config);
+            const client = getClient(ldService, config);
             if (waitForInitialization) {
                 try {
                     await client.waitForInitialization(5);

package/src/ld-service-provider.tsx

@@ -2,10 +2,12 @@ import { provide, useDependencies } from '@servicetitan/react-ioc';
 import { LDOptions } from 'launchdarkly-js-client-sdk';
 import { FC, PropsWithChildren, useEffect, useRef } from 'react';
 import { getLDClient } from './get-ld-client';
+import { getVersionClient } from './get-version-client';
 import { LD_SERVICE_TOKEN, LDApplication, LDService } from './types';
 
 const ldService: LDService = {
     getClient: getLDClient,
+    getVersionClient,
 };
 
 interface LDServiceProviderProps {

package/src/tests/create-ld-client.test.ts

@@ -0,0 +1,64 @@
+import { initialize } from 'launchdarkly-js-client-sdk';
+import { createLDClient } from '../create-ld-client';
+import { ClientConfig } from '../types';
+
+jest.mock('launchdarkly-js-client-sdk', () => ({
+    initialize: jest.fn(),
+}));
+
+describe(`[launchdarkly-service] ${createLDClient.name}`, () => {
+    const mockClient: any = Symbol('mockClient');
+    const defaultOptions = { sendEventsOnlyForVariation: true };
+    let config: ClientConfig;
+
+    const subject = () => createLDClient(config);
+
+    beforeEach(() => {
+        jest.clearAllMocks();
+        jest.mocked(initialize).mockImplementation(() => mockClient);
+        config = { clientSideID: makeId(), context: { kind: 'multi' } };
+    });
+
+    test('initializes client with the given context and default options', () => {
+        subject();
+
+        expect(initialize).toHaveBeenCalledWith(
+            config.clientSideID,
+            config.context,
+            defaultOptions
+        );
+    });
+
+    test('returns the client', () => {
+        expect(subject()).toBe(mockClient);
+    });
+
+    describe('when given options', () => {
+        beforeEach(() => (config.options = { hash: 'foo' }));
+
+        test('passes options through alongside the defaults', () => {
+            subject();
+
+            expect(initialize).toHaveBeenCalledWith(config.clientSideID, config.context, {
+                ...defaultOptions,
+                ...config.options,
+            });
+        });
+    });
+
+    describe('when given sendEventsOnlyForVariation', () => {
+        beforeEach(() => (config.options = { sendEventsOnlyForVariation: false }));
+
+        test('lets the caller override the default', () => {
+            subject();
+
+            expect(initialize).toHaveBeenCalledWith(config.clientSideID, config.context, {
+                sendEventsOnlyForVariation: false,
+            });
+        });
+    });
+});
+
+function makeId() {
+    return Math.round(1e6 * Math.random()).toString(36);
+}

package/src/tests/get-client.test.ts

@@ -0,0 +1,98 @@
+import { createLDClient } from '../create-ld-client';
+import { getClient } from '../get-client';
+import { getLDClient } from '../get-ld-client';
+import { getSDKVersion } from '../get-sdk-version';
+import { ClientConfig, LDService } from '../types';
+
+jest.mock('../create-ld-client', () => ({
+    createLDClient: jest.fn(),
+}));
+jest.mock('../get-ld-client', () => ({
+    getLDClient: jest.fn(),
+}));
+jest.mock('../get-sdk-version', () => ({
+    getSDKVersion: jest.fn(),
+}));
+
+describe(`[launchdarkly-service] ${getClient.name}`, () => {
+    const client: any = Symbol('client');
+    const version = '3.9.5';
+    let ldService: LDService | undefined;
+    let config: ClientConfig;
+
+    const subject = () => getClient(ldService, config);
+
+    beforeEach(() => {
+        jest.clearAllMocks();
+        jest.mocked(getLDClient).mockReturnValue(client);
+        jest.mocked(getSDKVersion).mockReturnValue(version);
+        config = { clientSideID: makeId(), context: { kind: 'multi' } };
+        ldService = undefined;
+    });
+
+    test('returns the locally created client', () => {
+        expect(subject()).toBe(client);
+    });
+
+    describe('when ldService is provided', () => {
+        const ldServiceClient: any = Symbol('ldServiceClient');
+
+        beforeEach(() => {
+            ldService = { getClient: jest.fn().mockReturnValue(ldServiceClient) };
+        });
+
+        function itReturnsLDServiceClient() {
+            test('returns the LDService client', () => {
+                expect(subject()).toBe(ldServiceClient);
+            });
+        }
+
+        itReturnsLDServiceClient();
+
+        test('requests it using the config', () => {
+            subject();
+
+            expect(ldService?.getClient).toHaveBeenCalledWith(config);
+        });
+
+        describe('when LDService includes getVersionClient', () => {
+            const versionedClient: any = Symbol('versionedClient');
+
+            beforeEach(() => {
+                ldService!.getVersionClient = jest.fn().mockReturnValue(versionedClient);
+            });
+
+            test('returns the version-aware client', () => {
+                expect(subject()).toBe(versionedClient);
+            });
+
+            test('requests it using the running SDK version, the config, and the client factory', () => {
+                subject();
+
+                expect(ldService!.getVersionClient).toHaveBeenCalledWith(
+                    version,
+                    config,
+                    createLDClient
+                );
+            });
+
+            describe('when the running SDK version is unknown', () => {
+                beforeEach(() => {
+                    jest.mocked(getSDKVersion).mockReturnValue(undefined);
+                });
+
+                itReturnsLDServiceClient();
+
+                test('does not call getVersionClient', () => {
+                    subject();
+
+                    expect(ldService!.getVersionClient).not.toHaveBeenCalled();
+                });
+            });
+        });
+    });
+});
+
+function makeId() {
+    return Math.round(1e6 * Math.random()).toString(36);
+}