@launchdarkly/js-client-sdk 0.12.1 → 0.13.1

package/dist/index.d.cts

@@ -1,7 +1,256 @@
-import { LDContext } from '@launchdarkly/js-client-sdk-common';
-export { AutoEnvAttributes, BasicLogger, BasicLoggerOptions, EvaluationSeriesContext, EvaluationSeriesData, Hook, HookMetadata, IdentifySeriesContext, IdentifySeriesData, IdentifySeriesResult, IdentifySeriesStatus, LDContext, LDContextCommon, LDContextMeta, LDDebugOverride, LDEvaluationDetail, LDEvaluationDetailTyped, LDEvaluationReason, LDFlagSet, LDFlagValue, LDIdentifyError, LDIdentifyResult, LDIdentifyShed, LDIdentifySuccess, LDIdentifyTimeout, LDInspection, LDLogLevel, LDLogger, LDMultiKindContext, LDPluginApplicationMetadata, LDPluginBase, LDPluginEnvironmentMetadata, LDPluginMetadata, LDPluginSdkMetadata, LDSingleKindContext, LDTimeoutError, LDWaitForInitializationComplete, LDWaitForInitializationFailed, LDWaitForInitializationOptions, LDWaitForInitializationResult, LDWaitForInitializationTimeout, TrackSeriesContext } from '@launchdarkly/js-client-sdk-common';
-import { B as BrowserOptions, L as LDClient } from './common-B4wKbl6r.cjs';
-export { b as LDIdentifyOptions, a as LDPlugin, c as basicLogger } from './common-B4wKbl6r.cjs';
+import { LDIdentifyOptions, ItemDescriptor, LDClient as LDClient$1, LDContext, LDIdentifyResult, LDWaitForInitializationOptions, LDWaitForInitializationResult, LDPluginBase, Hook, LDOptions, BasicLoggerOptions, LDLogger } from '@launchdarkly/js-client-sdk-common';
+export { AutoEnvAttributes, BasicLogger, BasicLoggerOptions, EvaluationSeriesContext, EvaluationSeriesData, Hook, HookMetadata, IdentifySeriesContext, IdentifySeriesData, IdentifySeriesResult, IdentifySeriesStatus, LDContext, LDContextCommon, LDContextMeta, LDContextStrict, LDDebugOverride, LDEvaluationDetail, LDEvaluationDetailTyped, LDEvaluationReason, LDFlagSet, LDFlagValue, LDIdentifyError, LDIdentifyResult, LDIdentifyShed, LDIdentifySuccess, LDIdentifyTimeout, LDInspection, LDLogLevel, LDLogger, LDMultiKindContext, LDPluginApplicationMetadata, LDPluginBase, LDPluginEnvironmentMetadata, LDPluginMetadata, LDPluginSdkMetadata, LDSingleKindContext, LDTimeoutError, LDWaitForInitializationComplete, LDWaitForInitializationFailed, LDWaitForInitializationOptions, LDWaitForInitializationResult, LDWaitForInitializationTimeout, TrackSeriesContext } from '@launchdarkly/js-client-sdk-common';
+
+/**
+ * @property sheddable - If true, the identify operation will be sheddable. This means that if multiple identify operations are done, without
+ * waiting for the previous one to complete, then intermediate results will be discarded. When false, identify
+ * operations will be queued and completed sequentially.
+ *
+ * Defaults to true.
+ */
+interface BrowserIdentifyOptions extends Omit<LDIdentifyOptions, 'waitForNetworkResults'> {
+    /**
+     * The signed context key if you are using [Secure Mode]
+     * (https://docs.launchdarkly.com/sdk/features/secure-mode#configuring-secure-mode-in-the-javascript-client-side-sdk).
+     */
+    hash?: string;
+    /**
+     * The initial set of flags to use until the remote set is retrieved.
+     *
+     * Bootstrap data can be generated by server SDKs. When bootstrap data is provided the SDK the
+     * identification operation will complete without waiting for any values from LaunchDarkly and
+     * the variation calls can be used immediately.
+     *
+     * If streaming is activated, either it is configured to always be used, or is activated
+     * via setStreaming, or via the addition of change handlers, then a streaming connection will
+     * subsequently be established.
+     *
+     * For more information, see the [SDK Reference Guide](https://docs.launchdarkly.com/sdk/features/bootstrapping#javascript).
+     */
+    bootstrap?: unknown;
+    /**
+     * Parsed bootstrap data that could be stored to ensure that the bootstrap data is only parsed once during the intialization
+     * process.
+     *
+     * @hidden
+     */
+    bootstrapParsed?: {
+        [key: string]: ItemDescriptor;
+    };
+}
+
+interface LDStartOptions extends LDWaitForInitializationOptions {
+    /**
+     * Optional bootstrap data to use for the identify operation. If {@link LDIdentifyOptions.bootstrap} is provided, it will be ignored.
+     */
+    bootstrap?: unknown;
+    /**
+     * Optional identify options to use for the identify operation. See {@link LDIdentifyOptions} for more information.
+     *
+     * @remarks
+     * Since the first identify option should never be sheddable, we omit the sheddable option from the interface to avoid confusion.
+     */
+    identifyOptions?: Omit<BrowserIdentifyOptions, 'sheddable'>;
+}
+/**
+ *
+ * The LaunchDarkly SDK client object.
+ *
+ * Applications should configure the client at page load time and reuse the same instance.
+ *
+ * For more information, see the [SDK Reference Guide](https://docs.launchdarkly.com/sdk/client-side/javascript).
+ */
+type LDClient = Omit<LDClient$1, 'setConnectionMode' | 'getConnectionMode' | 'getOffline' | 'identify'> & {
+    /**
+     * @ignore
+     * Implementation Note: We are not supporting dynamically setting the connection mode on the LDClient.
+     * Implementation Note: The SDK does not support offline mode. Instead bootstrap data can be used.
+     * Implementation Note: The browser SDK has different identify options, so omits the base implementation
+     * from the interface.
+     */
+    /**
+     * Specifies whether or not to open a streaming connection to LaunchDarkly for live flag updates.
+     *
+     * If this is true, the client will always attempt to maintain a streaming connection; if false,
+     * it never will. If you leave the value undefined (the default), the client will open a streaming
+     * connection if you subscribe to `"change"` or `"change:flag-key"` events (see {@link LDClient.on}).
+     *
+     * This can also be set as the `streaming` property of {@link LDOptions}.
+     */
+    setStreaming(streaming?: boolean): void;
+    /**
+     * Identifies a context to LaunchDarkly and returns a promise which resolves to an object containing the result of
+     * the identify operation.
+     *
+     * Unlike the server-side SDKs, the client-side JavaScript SDKs maintain a current context state,
+     * which is set when you call `identify()`.
+     *
+     * Changing the current context also causes all feature flag values to be reloaded. Until that has
+     * finished, calls to {@link variation} will still return flag values for the previous context. You can
+     * await the Promise to determine when the new flag values are available.
+     *
+     * If used with the `sheddable` option set to true, then the identify operation will be sheddable. This means that if
+     * multiple identify operations are done, without waiting for the previous one to complete, then intermediate
+     * operations may be discarded.
+     *
+     * @param context
+     *    The LDContext object.
+     * @param identifyOptions
+     *    Optional configuration. Please see {@link LDIdentifyOptions}.
+     * @returns
+     *    A promise which resolves to an object containing the result of the identify operation.
+     *    The promise returned from this method will not be rejected.
+     *
+     * @ignore Implementation Note: Browser implementation has different options.
+     */
+    identify(pristineContext: LDContext, identifyOptions?: BrowserIdentifyOptions): Promise<LDIdentifyResult>;
+    /**
+     * Returns a Promise that tracks the client's initialization state.
+     *
+     * The Promise will be resolved to a {@link LDWaitForInitializationResult} object containing the
+     * status of the waitForInitialization operation.
+     *
+     * @example
+     * This example shows use of async/await syntax for specifying handlers:
+     * ```
+     *     const result = await client.waitForInitialization({ timeout: 5 });
+     *
+     *     if (result.status === 'complete') {
+     *       doSomethingWithSuccessfullyInitializedClient();
+     *     } else if (result.status === 'failed') {
+     *       doSomethingForFailedStartup(result.error);
+     *     } else if (result.status === 'timeout') {
+     *       doSomethingForTimedOutStartup();
+     *     }
+     * ```
+     *
+     * @remarks
+     * You can also use event listeners ({@link on}) for the same purpose: the event `"initialized"`
+     * indicates success, and `"error"` indicates an error.
+     *
+     * @param options
+     *  Optional configuration. Please see {@link LDWaitForInitializationOptions}.
+     *
+     * @returns
+     *   A Promise that will be resolved to a {@link LDWaitForInitializationResult} object containing the
+     *   status of the waitForInitialization operation.
+     */
+    waitForInitialization(options?: LDWaitForInitializationOptions): Promise<LDWaitForInitializationResult>;
+    /**
+     * Starts the client and returns a promise that resolves to the initialization result.
+     *
+     * The promise will resolve to a {@link LDWaitForInitializationResult} object containing the
+     * status of the waitForInitialization operation.
+     *
+     * @param options Optional configuration. Please see {@link LDStartOptions}.
+     */
+    start(options?: LDStartOptions): Promise<LDWaitForInitializationResult>;
+};
+
+/**
+ * Interface for plugins to the LaunchDarkly SDK.
+ */
+interface LDPlugin extends LDPluginBase<LDClient, Hook> {
+}
+
+/**
+ * Initialization options for the LaunchDarkly browser SDK.
+ */
+interface BrowserOptions extends Omit<LDOptions, 'initialConnectionMode'> {
+    /**
+     * Whether the client should make a request to LaunchDarkly for Experimentation metrics (goals).
+     *
+     * This is true by default, meaning that this request will be made on every page load.
+     * Set it to false if you are not using Experimentation and want to skip the request.
+     */
+    fetchGoals?: boolean;
+    /**
+     * A function which, if present, can change the URL in analytics events to something other
+     * than the actual browser URL. It will be called with the current browser URL as a parameter,
+     * and returns the value that should be stored in the event's `url` property.
+     *
+     * It may be useful to customize the `url` to provide specific meaning, incorporate
+     * client-side routing concerns, or redact tokens or other info.
+     */
+    eventUrlTransformer?: (url: string) => string;
+    /**
+     * Whether or not to open a streaming connection to LaunchDarkly for live flag updates.
+     *
+     * If this is true, the client will always attempt to maintain a streaming connection; if false,
+     * it never will. If you leave the value undefined (the default), the client will open a streaming
+     * connection if you subscribe to `"change"` or `"change:flag-key"` events.
+     *
+     * This is equivalent to calling `client.setStreaming()` with the same value.
+     */
+    streaming?: boolean;
+    /**
+     * Determines if the SDK responds to entering different visibility states, such as foreground and background.
+     * An example is flushing buffered events when going to the background.
+     *
+     * This is true by default. Generally speaking the SDK will be able to most reliably deliver
+     * events with this setting on.
+     *
+     * It may be useful to disable for environments where not all window/document objects are
+     * available, such as when running the SDK in a browser extension.
+     */
+    automaticBackgroundHandling?: boolean;
+    /**
+     * A list of plugins to be used with the SDK.
+     *
+     * Plugin support is currently experimental and subject to change.
+     */
+    plugins?: LDPlugin[];
+}
+
+/**
+ * Provides a basic {@link LDLogger} implementation.
+ *
+ * This logging implementation uses a basic format that includes only the log level
+ * and the message text. By default this uses log level 'info' and the output is
+ * written to `console.error`.
+ *
+ * To use the logger created by this function, put it into {@link LDOptions.logger}. If
+ * you do not set {@link LDOptions.logger} to anything, the SDK uses a default logger
+ * that will log "info" level and higher priorty messages and it will log messages to
+ * console.info, console.warn, and console.error.
+ *
+ * @param options Configuration for the logger. If no options are specified, the
+ *   logger uses `{ level: 'info' }`.
+ *
+ * @example
+ * This example shows how to use `basicLogger` in your SDK options to enable console
+ * logging only at `warn` and `error` levels.
+ * ```javascript
+ *   const ldOptions = {
+ *     logger: basicLogger({ level: 'warn' }),
+ *   };
+ * ```
+ *
+ * @example
+ * This example shows how to use `basicLogger` in your SDK options to cause all
+ * log output to go to `console.log`
+ * ```javascript
+ *   const ldOptions = {
+ *     logger: basicLogger({ destination: console.log }),
+ *   };
+ * ```
+ *
+ *  * @example
+ * The configuration also allows you to control the destination for each log level.
+ * ```javascript
+ *   const ldOptions = {
+ *     logger: basicLogger({
+ *       destination: {
+ *         debug: console.debug,
+ *         info: console.info,
+ *         warn: console.warn,
+ *         error:console.error
+ *       }
+ *     }),
+ *   };
+ * ```
+ */
+declare function basicLogger(options: BasicLoggerOptions): LDLogger;
 
 /**
  * This is the API reference for the LaunchDarkly Client-Side SDK for JavaScript.
@@ -46,4 +295,4 @@ export { b as LDIdentifyOptions, a as LDPlugin, c as basicLogger } from './commo
  */
 declare function createClient(clientSideId: string, pristineContext: LDContext, options?: BrowserOptions): LDClient;
 
-export { LDClient, BrowserOptions as LDOptions, createClient };
+export { type LDClient, type BrowserIdentifyOptions as LDIdentifyOptions, type BrowserOptions as LDOptions, type LDPlugin, type LDStartOptions, basicLogger, createClient };

package/dist/index.d.ts

@@ -1,7 +1,256 @@
-import { LDContext } from '@launchdarkly/js-client-sdk-common';
-export { AutoEnvAttributes, BasicLogger, BasicLoggerOptions, EvaluationSeriesContext, EvaluationSeriesData, Hook, HookMetadata, IdentifySeriesContext, IdentifySeriesData, IdentifySeriesResult, IdentifySeriesStatus, LDContext, LDContextCommon, LDContextMeta, LDDebugOverride, LDEvaluationDetail, LDEvaluationDetailTyped, LDEvaluationReason, LDFlagSet, LDFlagValue, LDIdentifyError, LDIdentifyResult, LDIdentifyShed, LDIdentifySuccess, LDIdentifyTimeout, LDInspection, LDLogLevel, LDLogger, LDMultiKindContext, LDPluginApplicationMetadata, LDPluginBase, LDPluginEnvironmentMetadata, LDPluginMetadata, LDPluginSdkMetadata, LDSingleKindContext, LDTimeoutError, LDWaitForInitializationComplete, LDWaitForInitializationFailed, LDWaitForInitializationOptions, LDWaitForInitializationResult, LDWaitForInitializationTimeout, TrackSeriesContext } from '@launchdarkly/js-client-sdk-common';
-import { B as BrowserOptions, L as LDClient } from './common-B4wKbl6r.js';
-export { b as LDIdentifyOptions, a as LDPlugin, c as basicLogger } from './common-B4wKbl6r.js';
+import { LDIdentifyOptions, ItemDescriptor, LDClient as LDClient$1, LDContext, LDIdentifyResult, LDWaitForInitializationOptions, LDWaitForInitializationResult, LDPluginBase, Hook, LDOptions, BasicLoggerOptions, LDLogger } from '@launchdarkly/js-client-sdk-common';
+export { AutoEnvAttributes, BasicLogger, BasicLoggerOptions, EvaluationSeriesContext, EvaluationSeriesData, Hook, HookMetadata, IdentifySeriesContext, IdentifySeriesData, IdentifySeriesResult, IdentifySeriesStatus, LDContext, LDContextCommon, LDContextMeta, LDContextStrict, LDDebugOverride, LDEvaluationDetail, LDEvaluationDetailTyped, LDEvaluationReason, LDFlagSet, LDFlagValue, LDIdentifyError, LDIdentifyResult, LDIdentifyShed, LDIdentifySuccess, LDIdentifyTimeout, LDInspection, LDLogLevel, LDLogger, LDMultiKindContext, LDPluginApplicationMetadata, LDPluginBase, LDPluginEnvironmentMetadata, LDPluginMetadata, LDPluginSdkMetadata, LDSingleKindContext, LDTimeoutError, LDWaitForInitializationComplete, LDWaitForInitializationFailed, LDWaitForInitializationOptions, LDWaitForInitializationResult, LDWaitForInitializationTimeout, TrackSeriesContext } from '@launchdarkly/js-client-sdk-common';
+
+/**
+ * @property sheddable - If true, the identify operation will be sheddable. This means that if multiple identify operations are done, without
+ * waiting for the previous one to complete, then intermediate results will be discarded. When false, identify
+ * operations will be queued and completed sequentially.
+ *
+ * Defaults to true.
+ */
+interface BrowserIdentifyOptions extends Omit<LDIdentifyOptions, 'waitForNetworkResults'> {
+    /**
+     * The signed context key if you are using [Secure Mode]
+     * (https://docs.launchdarkly.com/sdk/features/secure-mode#configuring-secure-mode-in-the-javascript-client-side-sdk).
+     */
+    hash?: string;
+    /**
+     * The initial set of flags to use until the remote set is retrieved.
+     *
+     * Bootstrap data can be generated by server SDKs. When bootstrap data is provided the SDK the
+     * identification operation will complete without waiting for any values from LaunchDarkly and
+     * the variation calls can be used immediately.
+     *
+     * If streaming is activated, either it is configured to always be used, or is activated
+     * via setStreaming, or via the addition of change handlers, then a streaming connection will
+     * subsequently be established.
+     *
+     * For more information, see the [SDK Reference Guide](https://docs.launchdarkly.com/sdk/features/bootstrapping#javascript).
+     */
+    bootstrap?: unknown;
+    /**
+     * Parsed bootstrap data that could be stored to ensure that the bootstrap data is only parsed once during the intialization
+     * process.
+     *
+     * @hidden
+     */
+    bootstrapParsed?: {
+        [key: string]: ItemDescriptor;
+    };
+}
+
+interface LDStartOptions extends LDWaitForInitializationOptions {
+    /**
+     * Optional bootstrap data to use for the identify operation. If {@link LDIdentifyOptions.bootstrap} is provided, it will be ignored.
+     */
+    bootstrap?: unknown;
+    /**
+     * Optional identify options to use for the identify operation. See {@link LDIdentifyOptions} for more information.
+     *
+     * @remarks
+     * Since the first identify option should never be sheddable, we omit the sheddable option from the interface to avoid confusion.
+     */
+    identifyOptions?: Omit<BrowserIdentifyOptions, 'sheddable'>;
+}
+/**
+ *
+ * The LaunchDarkly SDK client object.
+ *
+ * Applications should configure the client at page load time and reuse the same instance.
+ *
+ * For more information, see the [SDK Reference Guide](https://docs.launchdarkly.com/sdk/client-side/javascript).
+ */
+type LDClient = Omit<LDClient$1, 'setConnectionMode' | 'getConnectionMode' | 'getOffline' | 'identify'> & {
+    /**
+     * @ignore
+     * Implementation Note: We are not supporting dynamically setting the connection mode on the LDClient.
+     * Implementation Note: The SDK does not support offline mode. Instead bootstrap data can be used.
+     * Implementation Note: The browser SDK has different identify options, so omits the base implementation
+     * from the interface.
+     */
+    /**
+     * Specifies whether or not to open a streaming connection to LaunchDarkly for live flag updates.
+     *
+     * If this is true, the client will always attempt to maintain a streaming connection; if false,
+     * it never will. If you leave the value undefined (the default), the client will open a streaming
+     * connection if you subscribe to `"change"` or `"change:flag-key"` events (see {@link LDClient.on}).
+     *
+     * This can also be set as the `streaming` property of {@link LDOptions}.
+     */
+    setStreaming(streaming?: boolean): void;
+    /**
+     * Identifies a context to LaunchDarkly and returns a promise which resolves to an object containing the result of
+     * the identify operation.
+     *
+     * Unlike the server-side SDKs, the client-side JavaScript SDKs maintain a current context state,
+     * which is set when you call `identify()`.
+     *
+     * Changing the current context also causes all feature flag values to be reloaded. Until that has
+     * finished, calls to {@link variation} will still return flag values for the previous context. You can
+     * await the Promise to determine when the new flag values are available.
+     *
+     * If used with the `sheddable` option set to true, then the identify operation will be sheddable. This means that if
+     * multiple identify operations are done, without waiting for the previous one to complete, then intermediate
+     * operations may be discarded.
+     *
+     * @param context
+     *    The LDContext object.
+     * @param identifyOptions
+     *    Optional configuration. Please see {@link LDIdentifyOptions}.
+     * @returns
+     *    A promise which resolves to an object containing the result of the identify operation.
+     *    The promise returned from this method will not be rejected.
+     *
+     * @ignore Implementation Note: Browser implementation has different options.
+     */
+    identify(pristineContext: LDContext, identifyOptions?: BrowserIdentifyOptions): Promise<LDIdentifyResult>;
+    /**
+     * Returns a Promise that tracks the client's initialization state.
+     *
+     * The Promise will be resolved to a {@link LDWaitForInitializationResult} object containing the
+     * status of the waitForInitialization operation.
+     *
+     * @example
+     * This example shows use of async/await syntax for specifying handlers:
+     * ```
+     *     const result = await client.waitForInitialization({ timeout: 5 });
+     *
+     *     if (result.status === 'complete') {
+     *       doSomethingWithSuccessfullyInitializedClient();
+     *     } else if (result.status === 'failed') {
+     *       doSomethingForFailedStartup(result.error);
+     *     } else if (result.status === 'timeout') {
+     *       doSomethingForTimedOutStartup();
+     *     }
+     * ```
+     *
+     * @remarks
+     * You can also use event listeners ({@link on}) for the same purpose: the event `"initialized"`
+     * indicates success, and `"error"` indicates an error.
+     *
+     * @param options
+     *  Optional configuration. Please see {@link LDWaitForInitializationOptions}.
+     *
+     * @returns
+     *   A Promise that will be resolved to a {@link LDWaitForInitializationResult} object containing the
+     *   status of the waitForInitialization operation.
+     */
+    waitForInitialization(options?: LDWaitForInitializationOptions): Promise<LDWaitForInitializationResult>;
+    /**
+     * Starts the client and returns a promise that resolves to the initialization result.
+     *
+     * The promise will resolve to a {@link LDWaitForInitializationResult} object containing the
+     * status of the waitForInitialization operation.
+     *
+     * @param options Optional configuration. Please see {@link LDStartOptions}.
+     */
+    start(options?: LDStartOptions): Promise<LDWaitForInitializationResult>;
+};
+
+/**
+ * Interface for plugins to the LaunchDarkly SDK.
+ */
+interface LDPlugin extends LDPluginBase<LDClient, Hook> {
+}
+
+/**
+ * Initialization options for the LaunchDarkly browser SDK.
+ */
+interface BrowserOptions extends Omit<LDOptions, 'initialConnectionMode'> {
+    /**
+     * Whether the client should make a request to LaunchDarkly for Experimentation metrics (goals).
+     *
+     * This is true by default, meaning that this request will be made on every page load.
+     * Set it to false if you are not using Experimentation and want to skip the request.
+     */
+    fetchGoals?: boolean;
+    /**
+     * A function which, if present, can change the URL in analytics events to something other
+     * than the actual browser URL. It will be called with the current browser URL as a parameter,
+     * and returns the value that should be stored in the event's `url` property.
+     *
+     * It may be useful to customize the `url` to provide specific meaning, incorporate
+     * client-side routing concerns, or redact tokens or other info.
+     */
+    eventUrlTransformer?: (url: string) => string;
+    /**
+     * Whether or not to open a streaming connection to LaunchDarkly for live flag updates.
+     *
+     * If this is true, the client will always attempt to maintain a streaming connection; if false,
+     * it never will. If you leave the value undefined (the default), the client will open a streaming
+     * connection if you subscribe to `"change"` or `"change:flag-key"` events.
+     *
+     * This is equivalent to calling `client.setStreaming()` with the same value.
+     */
+    streaming?: boolean;
+    /**
+     * Determines if the SDK responds to entering different visibility states, such as foreground and background.
+     * An example is flushing buffered events when going to the background.
+     *
+     * This is true by default. Generally speaking the SDK will be able to most reliably deliver
+     * events with this setting on.
+     *
+     * It may be useful to disable for environments where not all window/document objects are
+     * available, such as when running the SDK in a browser extension.
+     */
+    automaticBackgroundHandling?: boolean;
+    /**
+     * A list of plugins to be used with the SDK.
+     *
+     * Plugin support is currently experimental and subject to change.
+     */
+    plugins?: LDPlugin[];
+}
+
+/**
+ * Provides a basic {@link LDLogger} implementation.
+ *
+ * This logging implementation uses a basic format that includes only the log level
+ * and the message text. By default this uses log level 'info' and the output is
+ * written to `console.error`.
+ *
+ * To use the logger created by this function, put it into {@link LDOptions.logger}. If
+ * you do not set {@link LDOptions.logger} to anything, the SDK uses a default logger
+ * that will log "info" level and higher priorty messages and it will log messages to
+ * console.info, console.warn, and console.error.
+ *
+ * @param options Configuration for the logger. If no options are specified, the
+ *   logger uses `{ level: 'info' }`.
+ *
+ * @example
+ * This example shows how to use `basicLogger` in your SDK options to enable console
+ * logging only at `warn` and `error` levels.
+ * ```javascript
+ *   const ldOptions = {
+ *     logger: basicLogger({ level: 'warn' }),
+ *   };
+ * ```
+ *
+ * @example
+ * This example shows how to use `basicLogger` in your SDK options to cause all
+ * log output to go to `console.log`
+ * ```javascript
+ *   const ldOptions = {
+ *     logger: basicLogger({ destination: console.log }),
+ *   };
+ * ```
+ *
+ *  * @example
+ * The configuration also allows you to control the destination for each log level.
+ * ```javascript
+ *   const ldOptions = {
+ *     logger: basicLogger({
+ *       destination: {
+ *         debug: console.debug,
+ *         info: console.info,
+ *         warn: console.warn,
+ *         error:console.error
+ *       }
+ *     }),
+ *   };
+ * ```
+ */
+declare function basicLogger(options: BasicLoggerOptions): LDLogger;
 
 /**
  * This is the API reference for the LaunchDarkly Client-Side SDK for JavaScript.
@@ -46,4 +295,4 @@ export { b as LDIdentifyOptions, a as LDPlugin, c as basicLogger } from './commo
  */
 declare function createClient(clientSideId: string, pristineContext: LDContext, options?: BrowserOptions): LDClient;
 
-export { LDClient, BrowserOptions as LDOptions, createClient };
+export { type LDClient, type BrowserIdentifyOptions as LDIdentifyOptions, type BrowserOptions as LDOptions, type LDPlugin, type LDStartOptions, basicLogger, createClient };