@servicetitan/launchdarkly-service 28.2.0

package/dist/get-ld-client.d.ts

@@ -0,0 +1,4 @@
+import { LDClient } from 'launchdarkly-js-client-sdk';
+import { ProviderConfig } from 'launchdarkly-react-client-sdk';
+export declare function getLDClient({ clientSideID, context, options }: ProviderConfig): LDClient;
+//# sourceMappingURL=get-ld-client.d.ts.map

package/dist/get-ld-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-ld-client.d.ts","sourceRoot":"","sources":["../src/get-ld-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAc,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAI/D,wBAAgB,WAAW,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,cAAc,YAO7E"}

package/dist/get-ld-client.js

@@ -0,0 +1,11 @@
+import { initialize } from 'launchdarkly-js-client-sdk';
+const ldClients = new Map();
+export function getLDClient({ clientSideID, context, options }) {
+    let client = ldClients.get(clientSideID);
+    if (!client) {
+        client = initialize(clientSideID, context !== null && context !== void 0 ? context : { kind: 'user', anonymous: true }, options);
+        ldClients.set(clientSideID, client);
+    }
+    return client;
+}
+//# sourceMappingURL=get-ld-client.js.map

package/dist/get-ld-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-ld-client.js","sourceRoot":"","sources":["../src/get-ld-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAGlE,MAAM,SAAS,GAA0B,IAAI,GAAG,EAAE,CAAC;AAEnD,MAAM,UAAU,WAAW,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAkB;IAC1E,IAAI,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,MAAM,GAAG,UAAU,CAAC,YAAY,EAAE,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;QACzF,SAAS,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './get-ld-client';
+export * from './ld-provider';
+export * from './ld-service-provider';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from './get-ld-client';
+export * from './ld-provider';
+export * from './ld-service-provider';
+export * from './types';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC"}

package/dist/ld-provider.d.ts

@@ -0,0 +1,8 @@
+import { ProviderConfig as BaseProviderConfig } from 'launchdarkly-react-client-sdk';
+import { FC, PropsWithChildren } from 'react';
+export type ProviderConfig = Pick<BaseProviderConfig, 'clientSideID' | 'context'> & {
+    projectName: string;
+    waitForInitialization?: boolean;
+};
+export declare const LDProvider: FC<PropsWithChildren<ProviderConfig>>;
+//# sourceMappingURL=ld-provider.d.ts.map

package/dist/ld-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ld-provider.d.ts","sourceRoot":"","sources":["../src/ld-provider.tsx"],"names":[],"mappings":"AAGA,OAAO,EAEH,cAAc,IAAI,kBAAkB,EACvC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,EAAE,EAAE,iBAAiB,EAAuB,MAAM,OAAO,CAAC;AAKnE,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,kBAAkB,EAAE,cAAc,GAAG,SAAS,CAAC,GAAG;IAChF,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACnC,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,EAAE,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAmC5D,CAAC"}

package/dist/ld-provider.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Log } from '@servicetitan/log-service';
+import { useOptionalDependencies } from '@servicetitan/react-ioc';
+import { LDProvider as BaseLDProvider, } from 'launchdarkly-react-client-sdk';
+import { useEffect, useState } from 'react';
+import { getLDClient } from './get-ld-client';
+import { LD_SERVICE_TOKEN } from './types';
+export const LDProvider = props => {
+    const { children, clientSideID, context, projectName, waitForInitialization = true } = props;
+    const [ldClient, setLDClient] = useState();
+    const [ldService, log] = useOptionalDependencies(LD_SERVICE_TOKEN, Log);
+    useEffect(() => {
+        (async function initializeClient() {
+            var _a;
+            const config = { clientSideID, context };
+            const client = (_a = ldService === null || ldService === void 0 ? void 0 : ldService.getClient(config)) !== null && _a !== void 0 ? _a : getLDClient(config);
+            if (waitForInitialization) {
+                try {
+                    await client.waitForInitialization(5);
+                }
+                catch (error) {
+                    log === null || log === void 0 ? void 0 : log.error({
+                        category: 'LaunchDarkly',
+                        code: 'InitializationFailed',
+                        error,
+                        message: `"${projectName}" client failed to initialize`,
+                    });
+                }
+            }
+            setLDClient(client);
+        })();
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [clientSideID]); // only reload if clientSideID changes
+    if (!ldClient) {
+        return null;
+    }
+    return (_jsx(BaseLDProvider, { clientSideID: clientSideID, ldClient: ldClient, children: children }));
+};
+//# sourceMappingURL=ld-provider.js.map

package/dist/ld-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ld-provider.js","sourceRoot":"","sources":["../src/ld-provider.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,EACH,UAAU,IAAI,cAAc,GAE/B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAyB,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAO3C,MAAM,CAAC,MAAM,UAAU,GAA0C,KAAK,CAAC,EAAE;IACrE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,qBAAqB,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IAC7F,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,EAAY,CAAC;IACrD,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,uBAAuB,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAExE,SAAS,CAAC,GAAG,EAAE;QACX,CAAC,KAAK,UAAU,gBAAgB;;YAC5B,MAAM,MAAM,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;YACzC,MAAM,MAAM,GAAG,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,SAAS,CAAC,MAAM,CAAC,mCAAI,WAAW,CAAC,MAAM,CAAC,CAAC;YACnE,IAAI,qBAAqB,EAAE,CAAC;gBACxB,IAAI,CAAC;oBACD,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;gBAC1C,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACb,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,KAAK,CAAC;wBACP,QAAQ,EAAE,cAAc;wBACxB,IAAI,EAAE,sBAAsB;wBAC5B,KAAK;wBACL,OAAO,EAAE,IAAI,WAAW,+BAA+B;qBAC1D,CAAC,CAAC;gBACP,CAAC;YACL,CAAC;YACD,WAAW,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC,CAAC,EAAE,CAAC;QACL,uDAAuD;IAC3D,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,sCAAsC;IAE1D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,CACH,KAAC,cAAc,IAAC,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,YACzD,QAAQ,GACI,CACpB,CAAC;AACN,CAAC,CAAC"}

package/dist/ld-service-provider.d.ts

@@ -0,0 +1,3 @@
+import { FC, PropsWithChildren } from 'react';
+export declare const LDServiceProvider: FC<PropsWithChildren>;
+//# sourceMappingURL=ld-service-provider.d.ts.map

package/dist/ld-service-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ld-service-provider.d.ts","sourceRoot":"","sources":["../src/ld-service-provider.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAS9C,eAAO,MAAM,iBAAiB,EAAE,EAAE,CAAC,iBAAiB,CAUnD,CAAC"}

package/dist/ld-service-provider.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Provider, useOptionalDependencies } from '@servicetitan/react-ioc';
+import { getLDClient } from './get-ld-client';
+import { LD_SERVICE_TOKEN } from './types';
+const ldService = {
+    getClient: getLDClient,
+};
+export const LDServiceProvider = ({ children }) => {
+    if (useOptionalDependencies(LD_SERVICE_TOKEN)[0]) {
+        return children;
+    }
+    return (_jsx(Provider, { singletons: [{ provide: LD_SERVICE_TOKEN, useValue: ldService }], children: children }));
+};
+//# sourceMappingURL=ld-service-provider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ld-service-provider.js","sourceRoot":"","sources":["../src/ld-service-provider.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAG5E,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAa,MAAM,SAAS,CAAC;AAEtD,MAAM,SAAS,GAAc;IACzB,SAAS,EAAE,WAAW;CACzB,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAA0B,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;IACrE,IAAI,uBAAuB,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,OAAO,CACH,KAAC,QAAQ,IAAC,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,YACrE,QAAQ,GACF,CACd,CAAC;AACN,CAAC,CAAC"}

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

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

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

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

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

@@ -0,0 +1,51 @@
+import { initialize } from 'launchdarkly-js-client-sdk';
+import { getLDClient } from '../get-ld-client';
+jest.mock('launchdarkly-js-client-sdk', () => ({
+    initialize: jest.fn(),
+}));
+describe(`[launchdarkly-service] ${getLDClient.name}`, () => {
+    const mockClient = Symbol('mockClient');
+    let config;
+    const subject = () => getLDClient(config);
+    beforeEach(() => {
+        jest.clearAllMocks();
+        jest.mocked(initialize).mockImplementation(() => mockClient);
+        config = { clientSideID: makeId() };
+    });
+    function anonymousUserContext() {
+        return { kind: 'user', anonymous: true };
+    }
+    test('returns new LaunchDarkly client with anonymous user context', () => {
+        expect(subject()).toBe(mockClient);
+        expect(initialize).toHaveBeenCalledWith(config.clientSideID, anonymousUserContext(), undefined);
+    });
+    describe('when given a context', () => {
+        beforeEach(() => (config.context = { kind: 'multi' }));
+        test('initializes client with context', () => {
+            subject();
+            expect(initialize).toHaveBeenCalledWith(config.clientSideID, config.context, undefined);
+        });
+    });
+    describe('when given options', () => {
+        beforeEach(() => (config.options = { hash: 'foo' }));
+        test('initializes client with options', () => {
+            subject();
+            expect(initialize).toHaveBeenCalledWith(config.clientSideID, anonymousUserContext(), config.options);
+        });
+    });
+    describe('when client already exists', () => {
+        const existingClient = Symbol('existingClient');
+        beforeEach(() => {
+            jest.mocked(initialize).mockImplementationOnce(() => existingClient);
+            subject();
+        });
+        test('returns existing client', () => {
+            expect(subject()).toBe(existingClient);
+            expect(initialize).toHaveBeenCalledTimes(1);
+        });
+    });
+});
+function makeId() {
+    return Math.round(1e6 * Math.random()).toString(36);
+}
+//# sourceMappingURL=get-ld-client.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-ld-client.test.js","sourceRoot":"","sources":["../../src/tests/get-ld-client.test.ts"],"names":[],"mappings":"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"}

package/dist/tests/ld-provider.test.d.ts

@@ -0,0 +1,2 @@
+import '@testing-library/jest-dom';
+//# sourceMappingURL=ld-provider.test.d.ts.map

package/dist/tests/ld-provider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ld-provider.test.d.ts","sourceRoot":"","sources":["../../src/tests/ld-provider.test.tsx"],"names":[],"mappings":"AAAA,OAAO,2BAA2B,CAAC"}

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

@@ -0,0 +1,113 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import '@testing-library/jest-dom';
+import { Log } from '@servicetitan/log-service';
+import { Provider } from '@servicetitan/react-ioc';
+import { render, screen, waitFor } from '@testing-library/react';
+import { Fragment } from 'react';
+import { getLDClient } from '../get-ld-client';
+import { LDProvider } from '../ld-provider';
+import { LD_SERVICE_TOKEN } from '../types';
+function formatProps(props) {
+    return Object.entries(props).map(([key, value]) => {
+        return `${key}=${value.toString()}`;
+    });
+}
+function mockComponent(name) {
+    return {
+        [name]: ({ children, ...props }) => (_jsxs(Fragment, { children: [_jsx("div", { children: `<${name} ${formatProps(props)}>` }), children] })),
+    };
+}
+jest.mock('launchdarkly-react-client-sdk', () => ({
+    ...mockComponent('LDProvider'),
+}));
+jest.mock('../get-ld-client', () => ({
+    getLDClient: jest.fn(),
+}));
+describe(`[launchdarkly-service] ${LDProvider.name}`, () => {
+    const log = {
+        error: jest.fn(),
+    };
+    const ldClient = {
+        waitUntilReady: jest.fn().mockResolvedValue(undefined),
+        waitForInitialization: jest.fn().mockResolvedValue(undefined),
+        toString: () => 'ldClient',
+    };
+    let singletons;
+    let props;
+    const Component = () => {
+        return _jsx("div", { children: '<Component />' });
+    };
+    beforeEach(() => {
+        jest.clearAllMocks();
+        jest.mocked(getLDClient).mockReturnValue(ldClient);
+        singletons = [];
+        props = { clientSideID: 'foo', projectName: 'bar' };
+    });
+    const subject = () => {
+        return render(_jsx(Provider, { singletons: singletons, children: _jsx(LDProvider, { ...props, children: _jsx(Component, {}) }) }));
+    };
+    function expectLDProvider(props) {
+        if (props) {
+            expect(screen.getByText(`<LDProvider ${formatProps(props)}>`)).toBeInTheDocument();
+        }
+        else {
+            expect(screen.getByText(/<LDProvider .*>/)).toBeInTheDocument();
+        }
+    }
+    test('renders base LDProvider after client is ready and initialized', async () => {
+        subject();
+        await waitFor(() => expectLDProvider({ clientSideID: props.clientSideID, ldClient }));
+        expect(screen.getByText('<Component />')).toBeInTheDocument();
+        expect(ldClient.waitForInitialization).toHaveBeenCalled();
+    });
+    describe('when waitForInitialization is false', () => {
+        beforeEach(() => (props.waitForInitialization = false));
+        test('does not wait for client to initialize', async () => {
+            subject();
+            await waitFor(() => expectLDProvider());
+            expect(ldClient.waitForInitialization).not.toHaveBeenCalled();
+        });
+    });
+    describe('when initialization fails', () => {
+        beforeEach(() => {
+            var _a;
+            (_a = jest.mocked(ldClient.waitForInitialization)) === null || _a === void 0 ? void 0 : _a.mockRejectedValue('Oops!');
+        });
+        test('renders base LDProvider', async () => {
+            subject();
+            await waitFor(() => expectLDProvider());
+        });
+        describe('when log service is provided', () => {
+            beforeEach(() => singletons.push({ provide: Log, useValue: log }));
+            test('logs error', async () => {
+                subject();
+                await waitFor(() => expectLDProvider());
+                expect(log.error).toHaveBeenCalledWith({
+                    category: 'LaunchDarkly',
+                    code: 'InitializationFailed',
+                    error: 'Oops!',
+                    message: `"${props.projectName}" client failed to initialize`,
+                });
+            });
+        });
+    });
+    describe('when LDService is provided', () => {
+        const ldServiceClient = {
+            waitUntilReady: jest.fn().mockResolvedValue(undefined),
+            waitForInitialization: jest.fn().mockResolvedValue(undefined),
+            toString: () => 'ldServiceClient',
+        };
+        const ldService = {
+            getClient: jest.fn().mockReturnValue(ldServiceClient),
+        };
+        beforeEach(() => {
+            singletons === null || singletons === void 0 ? void 0 : singletons.push({ provide: LD_SERVICE_TOKEN, useValue: ldService });
+        });
+        test('uses LDService client', async () => {
+            subject();
+            await waitFor(() => expectLDProvider({ clientSideID: props.clientSideID, ldClient: ldServiceClient }));
+            expect(ldServiceClient.waitForInitialization).toHaveBeenCalled();
+        });
+    });
+});
+//# sourceMappingURL=ld-provider.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ld-provider.test.js","sourceRoot":"","sources":["../../src/tests/ld-provider.test.tsx"],"names":[],"mappings":"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"}

package/dist/tests/ld-service-provider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ld-service-provider.test.d.ts.map

package/dist/tests/ld-service-provider.test.d.ts.map

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

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

@@ -0,0 +1,33 @@
+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 { LDServiceProvider } from '../ld-service-provider';
+import { LD_SERVICE_TOKEN } from '../types';
+describe(`[launchdarkly-service] ${LDServiceProvider.name}`, () => {
+    let providedLDService;
+    let singletons;
+    const Component = () => {
+        [providedLDService] = useDependencies(LD_SERVICE_TOKEN);
+        return null;
+    };
+    beforeEach(() => (singletons = []));
+    const subject = () => {
+        return render(_jsx(Provider, { singletons: singletons, children: _jsx(LDServiceProvider, { children: _jsx(Component, {}) }) }));
+    };
+    test('provides LDService instance', () => {
+        subject();
+        expect(providedLDService).toEqual({
+            getClient: getLDClient,
+        });
+    });
+    describe('when LDService is already provided', () => {
+        const ldService = Symbol('ldService');
+        beforeEach(() => singletons === null || singletons === void 0 ? void 0 : singletons.push({ provide: LD_SERVICE_TOKEN, useValue: ldService }));
+        test('provides existing LDService', () => {
+            subject();
+            expect(providedLDService).toBe(ldService);
+        });
+    });
+});
+//# sourceMappingURL=ld-service-provider.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ld-service-provider.test.js","sourceRoot":"","sources":["../../src/tests/ld-service-provider.test.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAGhD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAa,MAAM,UAAU,CAAC;AAEvD,QAAQ,CAAC,0BAA0B,iBAAiB,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE;IAC9D,IAAI,iBAA4B,CAAC;IACjC,IAAI,UAAwD,CAAC;IAE7D,MAAM,SAAS,GAAO,GAAG,EAAE;QACvB,CAAC,iBAAiB,CAAC,GAAG,eAAe,CAAC,gBAAgB,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC;IAChB,CAAC,CAAC;IAEF,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC;IAEpC,MAAM,OAAO,GAAG,GAAG,EAAE;QACjB,OAAO,MAAM,CACT,KAAC,QAAQ,IAAC,UAAU,EAAE,UAAU,YAC5B,KAAC,iBAAiB,cACd,KAAC,SAAS,KAAG,GACG,GACb,CACd,CAAC;IACN,CAAC,CAAC;IAEF,IAAI,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,OAAO,EAAE,CAAC;QAEV,MAAM,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC;YAC9B,SAAS,EAAE,WAAW;SACzB,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAChD,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QAEtC,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,IAAI,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAEvF,IAAI,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,OAAO,EAAE,CAAC;YAEV,MAAM,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,11 @@
+import { type LDContext, type LDClient, type LDOptions } from 'launchdarkly-js-client-sdk';
+export declare const LD_SERVICE_TOKEN: import("@servicetitan/react-ioc").SymbolToken<LDService>;
+export interface ClientConfig {
+    clientSideID: string;
+    context?: LDContext;
+    options?: LDOptions;
+}
+export interface LDService {
+    getClient: (config: ClientConfig) => LDClient;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE3F,eAAO,MAAM,gBAAgB,0DAA6C,CAAC;AAE3E,MAAM,WAAW,YAAY;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,OAAO,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACtB,SAAS,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,QAAQ,CAAC;CACjD"}

package/dist/types.js

@@ -0,0 +1,3 @@
+import { symbolToken } from '@servicetitan/react-ioc';
+export const LD_SERVICE_TOKEN = symbolToken('LD_SERVICE_TOKEN');
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGtD,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAY,kBAAkB,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+    "name": "@servicetitan/launchdarkly-service",
+    "version": "28.2.0",
+    "description": "",
+    "homepage": "https://docs.st.dev/docs/frontend/launchdarkly-service",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/servicetitan/uikit.git",
+        "directory": "packages/launchdarkly-service"
+    },
+    "main": "./dist/index.js",
+    "typings": "./dist/index.d.ts",
+    "sideEffects": false,
+    "files": [
+        "dist",
+        "src"
+    ],
+    "devDependencies": {
+        "@servicetitan/log-service": "28.2.0",
+        "@servicetitan/react-ioc": "28.2.0",
+        "@testing-library/dom": "^10.4.0",
+        "@testing-library/react": "^16.0.1",
+        "launchdarkly-js-client-sdk": "3.5.0",
+        "launchdarkly-react-client-sdk": "^3.6.0",
+        "react": "~18.3.1"
+    },
+    "peerDependencies": {
+        "@servicetitan/log-service": "28.2.0",
+        "@servicetitan/react-ioc": "28.2.0",
+        "launchdarkly-js-client-sdk": "3.5.0",
+        "launchdarkly-react-client-sdk": "^3.6.0",
+        "react": ">=17.0.2"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "cli": {
+        "webpack": false
+    },
+    "gitHead": "df48bdf4994bce3971c7e4f099eeb11ebb4945e6"
+}

package/src/get-ld-client.ts

@@ -0,0 +1,13 @@
+import { LDClient, initialize } from 'launchdarkly-js-client-sdk';
+import { ProviderConfig } from 'launchdarkly-react-client-sdk';
+
+const ldClients: Map<string, LDClient> = new Map();
+
+export function getLDClient({ clientSideID, context, options }: ProviderConfig) {
+    let client = ldClients.get(clientSideID);
+    if (!client) {
+        client = initialize(clientSideID, context ?? { kind: 'user', anonymous: true }, options);
+        ldClients.set(clientSideID, client);
+    }
+    return client;
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export * from './get-ld-client';
+export * from './ld-provider';
+export * from './ld-service-provider';
+export * from './types';

package/src/ld-provider.tsx

@@ -0,0 +1,53 @@
+import { Log } from '@servicetitan/log-service';
+import { useOptionalDependencies } from '@servicetitan/react-ioc';
+import { LDClient } from 'launchdarkly-js-client-sdk';
+import {
+    LDProvider as BaseLDProvider,
+    ProviderConfig as BaseProviderConfig,
+} from 'launchdarkly-react-client-sdk';
+import { FC, PropsWithChildren, useEffect, useState } from 'react';
+
+import { getLDClient } from './get-ld-client';
+import { LD_SERVICE_TOKEN } from './types';
+
+export type ProviderConfig = Pick<BaseProviderConfig, 'clientSideID' | 'context'> & {
+    projectName: string;
+    waitForInitialization?: boolean;
+};
+
+export const LDProvider: FC<PropsWithChildren<ProviderConfig>> = props => {
+    const { children, clientSideID, context, projectName, waitForInitialization = true } = props;
+    const [ldClient, setLDClient] = useState<LDClient>();
+    const [ldService, log] = useOptionalDependencies(LD_SERVICE_TOKEN, Log);
+
+    useEffect(() => {
+        (async function initializeClient() {
+            const config = { clientSideID, context };
+            const client = ldService?.getClient(config) ?? getLDClient(config);
+            if (waitForInitialization) {
+                try {
+                    await client.waitForInitialization(5);
+                } catch (error) {
+                    log?.error({
+                        category: 'LaunchDarkly',
+                        code: 'InitializationFailed',
+                        error,
+                        message: `"${projectName}" client failed to initialize`,
+                    });
+                }
+            }
+            setLDClient(client);
+        })();
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [clientSideID]); // only reload if clientSideID changes
+
+    if (!ldClient) {
+        return null;
+    }
+
+    return (
+        <BaseLDProvider clientSideID={clientSideID} ldClient={ldClient}>
+            {children}
+        </BaseLDProvider>
+    );
+};

package/src/ld-service-provider.tsx

@@ -0,0 +1,21 @@
+import { Provider, useOptionalDependencies } from '@servicetitan/react-ioc';
+import { FC, PropsWithChildren } from 'react';
+
+import { getLDClient } from './get-ld-client';
+import { LD_SERVICE_TOKEN, LDService } from './types';
+
+const ldService: LDService = {
+    getClient: getLDClient,
+};
+
+export const LDServiceProvider: FC<PropsWithChildren> = ({ children }) => {
+    if (useOptionalDependencies(LD_SERVICE_TOKEN)[0]) {
+        return children;
+    }
+
+    return (
+        <Provider singletons={[{ provide: LD_SERVICE_TOKEN, useValue: ldService }]}>
+            {children}
+        </Provider>
+    );
+};

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

@@ -0,0 +1,75 @@
+import { initialize } from 'launchdarkly-js-client-sdk';
+
+import { getLDClient } from '../get-ld-client';
+
+jest.mock('launchdarkly-js-client-sdk', () => ({
+    initialize: jest.fn(),
+}));
+
+describe(`[launchdarkly-service] ${getLDClient.name}`, () => {
+    const mockClient: any = Symbol('mockClient');
+    let config: Parameters<typeof getLDClient>[0];
+
+    const subject = () => getLDClient(config);
+
+    beforeEach(() => {
+        jest.clearAllMocks();
+        jest.mocked(initialize).mockImplementation(() => mockClient);
+        config = { clientSideID: makeId() };
+    });
+
+    function anonymousUserContext() {
+        return { kind: 'user', anonymous: true };
+    }
+
+    test('returns new LaunchDarkly client with anonymous user context', () => {
+        expect(subject()).toBe(mockClient);
+        expect(initialize).toHaveBeenCalledWith(
+            config.clientSideID,
+            anonymousUserContext(),
+            undefined
+        );
+    });
+
+    describe('when given a context', () => {
+        beforeEach(() => (config.context = { kind: 'multi' }));
+
+        test('initializes client with context', () => {
+            subject();
+
+            expect(initialize).toHaveBeenCalledWith(config.clientSideID, config.context, undefined);
+        });
+    });
+
+    describe('when given options', () => {
+        beforeEach(() => (config.options = { hash: 'foo' }));
+
+        test('initializes client with options', () => {
+            subject();
+
+            expect(initialize).toHaveBeenCalledWith(
+                config.clientSideID,
+                anonymousUserContext(),
+                config.options
+            );
+        });
+    });
+
+    describe('when client already exists', () => {
+        const existingClient: any = Symbol('existingClient');
+
+        beforeEach(() => {
+            jest.mocked(initialize).mockImplementationOnce(() => existingClient);
+            subject();
+        });
+
+        test('returns existing client', () => {
+            expect(subject()).toBe(existingClient);
+            expect(initialize).toHaveBeenCalledTimes(1);
+        });
+    });
+});
+
+function makeId() {
+    return Math.round(1e6 * Math.random()).toString(36);
+}

package/src/tests/ld-provider.test.tsx

@@ -0,0 +1,150 @@
+import '@testing-library/jest-dom';
+import { Log } from '@servicetitan/log-service';
+import { Provider } from '@servicetitan/react-ioc';
+import { render, screen, waitFor } from '@testing-library/react';
+import { LDClient } from 'launchdarkly-js-client-sdk';
+import { FC, Fragment } from 'react';
+
+import { getLDClient } from '../get-ld-client';
+import { LDProvider } from '../ld-provider';
+import { LD_SERVICE_TOKEN, LDService } from '../types';
+
+function formatProps(props: Record<string, any>) {
+    return Object.entries(props).map(([key, value]) => {
+        return `${key}=${value.toString()}`;
+    });
+}
+
+function mockComponent(name: string) {
+    return {
+        [name]: ({ children, ...props }: any) => (
+            <Fragment>
+                <div>{`<${name} ${formatProps(props)}>`}</div>
+                {children}
+            </Fragment>
+        ),
+    };
+}
+jest.mock('launchdarkly-react-client-sdk', () => ({
+    ...mockComponent('LDProvider'),
+}));
+jest.mock('../get-ld-client', () => ({
+    getLDClient: jest.fn(),
+}));
+
+describe(`[launchdarkly-service] ${LDProvider.name}`, () => {
+    const log: Partial<Log> = {
+        error: jest.fn(),
+    };
+    const ldClient: Partial<LDClient> & { toString: () => string } = {
+        waitUntilReady: jest.fn().mockResolvedValue(undefined),
+        waitForInitialization: jest.fn().mockResolvedValue(undefined),
+        toString: () => 'ldClient',
+    };
+    let singletons: Required<Parameters<typeof Provider>[0]>['singletons'];
+    let props: Parameters<typeof LDProvider>[0];
+
+    const Component: FC = () => {
+        return <div>{'<Component />'}</div>;
+    };
+
+    beforeEach(() => {
+        jest.clearAllMocks();
+        jest.mocked(getLDClient).mockReturnValue(ldClient as LDClient);
+        singletons = [];
+        props = { clientSideID: 'foo', projectName: 'bar' };
+    });
+
+    const subject = () => {
+        return render(
+            <Provider singletons={singletons}>
+                <LDProvider {...props}>
+                    <Component />
+                </LDProvider>
+            </Provider>
+        );
+    };
+
+    function expectLDProvider(props?: Record<string, any>) {
+        if (props) {
+            expect(screen.getByText(`<LDProvider ${formatProps(props)}>`)).toBeInTheDocument();
+        } else {
+            expect(screen.getByText(/<LDProvider .*>/)).toBeInTheDocument();
+        }
+    }
+
+    test('renders base LDProvider after client is ready and initialized', async () => {
+        subject();
+
+        await waitFor(() => expectLDProvider({ clientSideID: props.clientSideID, ldClient }));
+
+        expect(screen.getByText('<Component />')).toBeInTheDocument();
+        expect(ldClient.waitForInitialization).toHaveBeenCalled();
+    });
+
+    describe('when waitForInitialization is false', () => {
+        beforeEach(() => (props.waitForInitialization = false));
+
+        test('does not wait for client to initialize', async () => {
+            subject();
+
+            await waitFor(() => expectLDProvider());
+
+            expect(ldClient.waitForInitialization).not.toHaveBeenCalled();
+        });
+    });
+
+    describe('when initialization fails', () => {
+        beforeEach(() => {
+            jest.mocked(ldClient.waitForInitialization)?.mockRejectedValue('Oops!');
+        });
+
+        test('renders base LDProvider', async () => {
+            subject();
+
+            await waitFor(() => expectLDProvider());
+        });
+
+        describe('when log service is provided', () => {
+            beforeEach(() => singletons.push({ provide: Log, useValue: log }));
+
+            test('logs error', async () => {
+                subject();
+
+                await waitFor(() => expectLDProvider());
+
+                expect(log.error).toHaveBeenCalledWith({
+                    category: 'LaunchDarkly',
+                    code: 'InitializationFailed',
+                    error: 'Oops!',
+                    message: `"${props.projectName}" client failed to initialize`,
+                });
+            });
+        });
+    });
+
+    describe('when LDService is provided', () => {
+        const ldServiceClient: Partial<LDClient> & { toString: () => string } = {
+            waitUntilReady: jest.fn().mockResolvedValue(undefined),
+            waitForInitialization: jest.fn().mockResolvedValue(undefined),
+            toString: () => 'ldServiceClient',
+        };
+        const ldService: LDService = {
+            getClient: jest.fn().mockReturnValue(ldServiceClient),
+        };
+
+        beforeEach(() => {
+            singletons?.push({ provide: LD_SERVICE_TOKEN, useValue: ldService });
+        });
+
+        test('uses LDService client', async () => {
+            subject();
+
+            await waitFor(() =>
+                expectLDProvider({ clientSideID: props.clientSideID, ldClient: ldServiceClient })
+            );
+
+            expect(ldServiceClient.waitForInitialization).toHaveBeenCalled();
+        });
+    });
+});

package/src/tests/ld-service-provider.test.tsx

@@ -0,0 +1,49 @@
+import { Provider, useDependencies } from '@servicetitan/react-ioc';
+import { render } from '@testing-library/react';
+import { FC } from 'react';
+
+import { getLDClient } from '../get-ld-client';
+import { LDServiceProvider } from '../ld-service-provider';
+import { LD_SERVICE_TOKEN, LDService } from '../types';
+
+describe(`[launchdarkly-service] ${LDServiceProvider.name}`, () => {
+    let providedLDService: LDService;
+    let singletons: Parameters<typeof Provider>[0]['singletons'];
+
+    const Component: FC = () => {
+        [providedLDService] = useDependencies(LD_SERVICE_TOKEN);
+        return null;
+    };
+
+    beforeEach(() => (singletons = []));
+
+    const subject = () => {
+        return render(
+            <Provider singletons={singletons}>
+                <LDServiceProvider>
+                    <Component />
+                </LDServiceProvider>
+            </Provider>
+        );
+    };
+
+    test('provides LDService instance', () => {
+        subject();
+
+        expect(providedLDService).toEqual({
+            getClient: getLDClient,
+        });
+    });
+
+    describe('when LDService is already provided', () => {
+        const ldService = Symbol('ldService');
+
+        beforeEach(() => singletons?.push({ provide: LD_SERVICE_TOKEN, useValue: ldService }));
+
+        test('provides existing LDService', () => {
+            subject();
+
+            expect(providedLDService).toBe(ldService);
+        });
+    });
+});

package/src/types.ts

@@ -0,0 +1,14 @@
+import { symbolToken } from '@servicetitan/react-ioc';
+import { type LDContext, type LDClient, type LDOptions } from 'launchdarkly-js-client-sdk';
+
+export const LD_SERVICE_TOKEN = symbolToken<LDService>('LD_SERVICE_TOKEN');
+
+export interface ClientConfig {
+    clientSideID: string;
+    context?: LDContext;
+    options?: LDOptions;
+}
+
+export interface LDService {
+    getClient: (config: ClientConfig) => LDClient;
+}