@configdirector/client-sdk 1.9.1 → 1.10.0

package/dist/configdirector-client-testing.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"configdirector-client-testing.mjs","names":["createTestClient"],"sources":["../../js-client-core/src/testing/InMemoryConnection.ts","../../js-client-core/src/testing/TestClient.ts","../src/testing.ts"],"sourcesContent":["import type {\n  ClientConnectAction,\n  ConfigDirectorContext,\n  ConfigDirectorLogger,\n  ConfigSet,\n  ConfigState,\n  Transport,\n  TransportEvents,\n} from \"../types\";\nimport { Emitter } from \"../Emitter\";\nimport { ConfigDirectorConnectionError } from \"../errors\";\nimport type { TestValue, TestValues } from \"./values\";\nimport { nativeValueConfigState } from \"../native-values\";\n\ntype ControlledAttempt = \"initialize\" | \"updateContext\";\n\ntype Armed = \"nothing\" | \"hold\" | \"failure\";\n\ntype PendingHold = {\n  attempt: ControlledAttempt;\n  end: () => void;\n  complete: () => void;\n  fail: () => void;\n};\n\nconst TEST_ENVIRONMENT = { environmentId: \"test-environment\", projectId: \"test-project\" };\n\nconst controlledAttemptFor = (reason: ClientConnectAction): ControlledAttempt | undefined => {\n  switch (reason) {\n    case \"initialization\":\n      return \"initialize\";\n    case \"context update\":\n      return \"updateContext\";\n    default:\n      return undefined;\n  }\n};\n\nexport class InMemoryConnection implements Transport {\n  private readonly emitter = new Emitter<TransportEvents>();\n  private readonly configs = new Map<string, ConfigState>();\n  private readonly recordedContexts: ConfigDirectorContext[] = [];\n  private readonly pendingDeliveries: ConfigSet[] = [];\n  private readonly armed: Record<ControlledAttempt, Armed> = { initialize: \"nothing\", updateContext: \"nothing\" };\n  private pendingHold: PendingHold | undefined;\n  private connected = false;\n  private delivering = false;\n  private revision = 0;\n  private attemptGeneration = 0;\n\n  constructor(\n    private readonly logger: ConfigDirectorLogger,\n    values: TestValues,\n  ) {\n    this.store(values);\n  }\n\n  public get contextUpdates(): ConfigDirectorContext[] {\n    return [...this.recordedContexts];\n  }\n\n  public setValue(key: string, value: TestValue) {\n    const configState = this.encode(key, value);\n    this.configs.set(key, configState);\n    this.deliverIfConnected({ ...TEST_ENVIRONMENT, kind: \"delta\", configs: { [key]: configState } });\n  }\n\n  public removeValue(key: string) {\n    this.configs.delete(key);\n    this.deliverIfConnected(this.fullUpdate());\n  }\n\n  public replaceValues(values: TestValues) {\n    const encoded = this.encodeAll(values);\n    this.configs.clear();\n    encoded.forEach((configState, key) => this.configs.set(key, configState));\n    this.armed.initialize = \"nothing\";\n    this.armed.updateContext = \"nothing\";\n    this.deliverIfConnected(this.fullUpdate());\n  }\n\n  public hold(attempt: ControlledAttempt) {\n    this.armed[attempt] = \"hold\";\n  }\n\n  public complete(attempt: ControlledAttempt) {\n    if (this.pendingHold?.attempt === attempt) {\n      this.pendingHold.complete();\n    } else if (this.armed[attempt] === \"hold\") {\n      this.armed[attempt] = \"nothing\";\n    }\n  }\n\n  public fail(attempt: ControlledAttempt) {\n    if (this.pendingHold?.attempt === attempt) {\n      this.pendingHold.fail();\n    } else {\n      this.armed[attempt] = \"failure\";\n    }\n  }\n\n  public connect(context: ConfigDirectorContext, timeout: number, reason: ClientConnectAction): Promise<this> {\n    this.endAttempt();\n    const attempt = controlledAttemptFor(reason);\n    if (!attempt) {\n      return this.connectNow();\n    }\n    this.recordedContexts.push(context);\n    const armed = this.armed[attempt];\n    this.armed[attempt] = \"nothing\";\n    switch (armed) {\n      case \"failure\":\n        return this.failNow(reason);\n      case \"hold\":\n        return this.holdNow(attempt, reason, timeout);\n      default:\n        return this.connectNow();\n    }\n  }\n\n  public on: Transport[\"on\"] = (name, handler) => this.emitter.on(name, handler);\n\n  public off: Transport[\"off\"] = (name, handler) => this.emitter.off(name, handler);\n\n  public clear() {\n    this.emitter.clear();\n  }\n\n  public close() {\n    this.endAttempt();\n  }\n\n  public dispose() {\n    this.close();\n    this.clear();\n  }\n\n  private endAttempt() {\n    this.attemptGeneration++;\n    this.connected = false;\n    this.pendingHold?.end();\n  }\n\n  private connectNow(): Promise<this> {\n    const connected = Promise.resolve(this);\n    this.scheduleFirstDelivery();\n    return connected;\n  }\n\n  private holdNow(attempt: ControlledAttempt, reason: ClientConnectAction, timeout: number): Promise<this> {\n    return new Promise<this>((resolve, reject) => {\n      const timer = setTimeout(() => this.pendingHold?.end(), timeout);\n      const release = () => {\n        clearTimeout(timer);\n        this.pendingHold = undefined;\n      };\n      this.pendingHold = {\n        attempt,\n        end: () => {\n          release();\n          resolve(this);\n        },\n        complete: () => {\n          release();\n          resolve(this);\n          this.scheduleFirstDelivery();\n        },\n        fail: () => {\n          release();\n          const error = this.fatalError(reason);\n          this.emitter.emit(\"connectionError\", error);\n          reject(error);\n        },\n      };\n    });\n  }\n\n  private failNow(reason: ClientConnectAction): Promise<this> {\n    const error = this.fatalError(reason);\n    this.emitter.emit(\"connectionError\", error);\n    return Promise.reject(error);\n  }\n\n  private fatalError(reason: ClientConnectAction) {\n    return new ConfigDirectorConnectionError(\n      `Connection failed with status: 401. Error: the test client failed this ${reason}. This is an unrecoverable error, will not attempt to reconnect.`,\n      401,\n    );\n  }\n\n  private scheduleFirstDelivery() {\n    const generation = this.attemptGeneration;\n    void Promise.resolve()\n      .then(() => {})\n      .then(() => {\n        if (generation !== this.attemptGeneration) {\n          return;\n        }\n        this.connected = true;\n        this.deliver(this.fullUpdate());\n      });\n  }\n\n  private deliverIfConnected(configSet: ConfigSet) {\n    if (this.connected) {\n      this.deliver(configSet);\n    }\n  }\n\n  private deliver(configSet: ConfigSet) {\n    this.pendingDeliveries.push(configSet);\n    if (this.delivering) {\n      return;\n    }\n    this.delivering = true;\n    try {\n      let next = this.pendingDeliveries.shift();\n      while (next) {\n        this.emitCaught(next);\n        next = this.pendingDeliveries.shift();\n      }\n    } finally {\n      this.delivering = false;\n    }\n  }\n\n  private emitCaught(configSet: ConfigSet) {\n    try {\n      this.emitter.emit(\"configSetReceived\", configSet);\n    } catch (error) {\n      this.logger.error(\"[InMemoryConnection] Error dispatching a config update from the test client: \", error);\n    }\n  }\n\n  private fullUpdate(): ConfigSet {\n    return { ...TEST_ENVIRONMENT, kind: \"full\", configs: Object.fromEntries(this.configs) };\n  }\n\n  private store(values: TestValues) {\n    this.encodeAll(values).forEach((configState, key) => this.configs.set(key, configState));\n  }\n\n  private encodeAll(values: TestValues): Map<string, ConfigState> {\n    const encoded = new Map<string, ConfigState>();\n    for (const [key, value] of Object.entries(values)) {\n      encoded.set(key, this.encode(key, value));\n    }\n    return encoded;\n  }\n\n  private encode(key: string, value: TestValue): ConfigState {\n    return nativeValueConfigState(`test-config:${key}`, key, value, `test-value:${key}:${++this.revision}`);\n  }\n}\n","import { DefaultConfigDirectorClient } from \"../DefaultConfigDirectorClient\";\nimport { createDefaultLogger } from \"../logger\";\nimport type { ConfigDirectorClient, ConfigDirectorContext, ConfigDirectorLogger, IdentifyingSdkOptions } from \"../types\";\nimport { discardingTelemetryClient } from \"../telemetry/discarding\";\nimport { InMemoryConnection } from \"./InMemoryConnection\";\nimport type { TestValue, TestValues } from \"./values\";\n\nconst TEST_CLIENT_SDK_KEY = \"test-client\";\n\n/**\n * Options for {@link createTestClient}. Every option is optional.\n */\nexport type TestClientOptions = {\n  /**\n   * The config values the test client serves once its client connects, keyed by config key. The\n   * config type follows from each value: a boolean, an integral number (`integer`), any other\n   * number (`float`), a string, or a plain object or array (`json`).\n   */\n  values?: TestValues;\n  /**\n   * The connection timeout of the SDK client, in milliseconds. It bounds how long a held\n   * `initialize` or `updateContext` waits. Defaults to the SDK's production timeout.\n   */\n  timeout?: number;\n  /**\n   * The logger the SDK client uses. Defaults to the SDK's console logger at `warn` level.\n   */\n  logger?: ConfigDirectorLogger;\n};\n\n/**\n * A real ConfigDirector client connected to an in-memory server that the test controls.\n *\n * The client under {@link TestClient.client} is the SDK's production client: value parsing, watchers,\n * events, and readiness behave as they do against ConfigDirector. Only the network connection and\n * telemetry are replaced, so no request is ever made and nothing is left running after the client is\n * disposed.\n */\nexport interface TestClient {\n  /**\n   * The SDK client to hand to the code under test. It starts uninitialized, like a production\n   * client; `initialize` completes at once with the seeded values unless initialization is held.\n   */\n  readonly client: ConfigDirectorClient;\n\n  /**\n   * Stores `value` under `key` and, when the client is connected, delivers it as an update, so\n   * reads, watchers, and `configsUpdated` handlers see it.\n   */\n  setValue(key: string, value: TestValue): void;\n\n  /**\n   * Removes `key` and, when the client is connected, delivers a full update without it, so reads\n   * fall back to the in-code default value and watchers of `key` receive that default.\n   */\n  removeValue(key: string): void;\n\n  /**\n   * Replaces every stored value with `values`, disarms any armed hold or failure, and, when the\n   * client is connected, delivers the new values as a full update.\n   */\n  replaceValues(values: TestValues): void;\n\n  /**\n   * Makes the next `initialize` wait until {@link completeInitialization} or\n   * {@link failInitialization} is called, or until the client's timeout elapses.\n   */\n  holdInitialization(): void;\n\n  /**\n   * Delivers the stored values to a held `initialize`, so it completes with the client ready. When\n   * a hold is armed but no `initialize` has started, it disarms the hold instead.\n   */\n  completeInitialization(): void;\n\n  /**\n   * Fails a held `initialize` with an unrecoverable connection error, or arms the next `initialize`\n   * to fail. `initialize` completes promptly with the client not ready and `connectionError` fires.\n   */\n  failInitialization(): void;\n\n  /**\n   * Makes the next `updateContext` wait until {@link completeContextUpdate} or\n   * {@link failContextUpdate} is called, or until the client's timeout elapses.\n   */\n  holdContextUpdate(): void;\n\n  /**\n   * Delivers the stored values to a held `updateContext`, or disarms an armed hold that no\n   * `updateContext` has picked up.\n   */\n  completeContextUpdate(): void;\n\n  /**\n   * Fails a held `updateContext` with an unrecoverable connection error, or arms the next\n   * `updateContext` to fail.\n   */\n  failContextUpdate(): void;\n\n  /**\n   * The context of every `initialize` and `updateContext` call, in call order. `initialize` without\n   * a context records an empty context, and so does a call whose context has an invalid kind, since\n   * the client connects without it. Resumes are not recorded.\n   */\n  readonly contextUpdates: ConfigDirectorContext[];\n}\n\nclass InMemoryTestClient implements TestClient {\n  constructor(\n    public readonly client: ConfigDirectorClient,\n    private readonly connection: InMemoryConnection,\n  ) {}\n\n  public setValue(key: string, value: TestValue) {\n    this.connection.setValue(key, value);\n  }\n\n  public removeValue(key: string) {\n    this.connection.removeValue(key);\n  }\n\n  public replaceValues(values: TestValues) {\n    this.connection.replaceValues(values);\n  }\n\n  public holdInitialization() {\n    this.connection.hold(\"initialize\");\n  }\n\n  public completeInitialization() {\n    this.connection.complete(\"initialize\");\n  }\n\n  public failInitialization() {\n    this.connection.fail(\"initialize\");\n  }\n\n  public holdContextUpdate() {\n    this.connection.hold(\"updateContext\");\n  }\n\n  public completeContextUpdate() {\n    this.connection.complete(\"updateContext\");\n  }\n\n  public failContextUpdate() {\n    this.connection.fail(\"updateContext\");\n  }\n\n  public get contextUpdates(): ConfigDirectorContext[] {\n    return this.connection.contextUpdates;\n  }\n}\n\nexport const createTestClient = (sdkOptions: IdentifyingSdkOptions, options?: TestClientOptions): TestClient => {\n  const logger = options?.logger ?? createDefaultLogger();\n  const connection = new InMemoryConnection(logger, options?.values ?? {});\n  const client = new DefaultConfigDirectorClient(\n    () => discardingTelemetryClient,\n    TEST_CLIENT_SDK_KEY,\n    sdkOptions,\n    { logger, connection: { timeout: options?.timeout } },\n    { transport: connection },\n  );\n  return new InMemoryTestClient(client, connection);\n};\n","import { createTestClient as createCoreTestClient } from \"@js-client-core/testing/index\";\nimport type { TestClient, TestClientOptions } from \"@js-client-core/testing/index\";\n\nexport type { TestClient, TestClientOptions, TestValue, TestValues, TestJsonValue } from \"@js-client-core/testing/index\";\nexport { ConfigDirectorConnectionError, ConfigDirectorValidationError } from \"@shared/errors\";\n\n/**\n * Creates a {@link TestClient}: a real `ConfigDirectorClient` connected to an in-memory server\n * that the test controls. No network connection is opened and no telemetry is sent.\n *\n * @param options {@link TestClientOptions}: the initial values, the client's timeout, and its logger\n * @returns A {@link TestClient} whose `client` is passed to the code under test\n *\n * @example\n * import { createTestClient } from \"@configdirector/client-sdk/testing\";\n *\n * const testClient = createTestClient({ values: { \"new-checkout\": true } });\n * await testClient.client.initialize();\n * expect(testClient.client.getValue(\"new-checkout\", false)).toBe(true);\n *\n * testClient.setValue(\"new-checkout\", false);\n */\nexport const createTestClient = (options?: TestClientOptions): TestClient => {\n  return createCoreTestClient({ sdkName: \"js-client-sdk\", sdkVersion: \"__VERSION__\" }, options);\n};\n"],"mappings":"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"}
+{"version":3,"file":"configdirector-client-testing.mjs","names":["createTestClient"],"sources":["../../js-client-core/src/testing/InMemoryConnection.ts","../../js-client-core/src/testing/TestClient.ts","../src/testing.ts"],"sourcesContent":["import type {\n  ClientConnectAction,\n  ConfigDirectorContext,\n  ConfigDirectorLogger,\n  ConfigSet,\n  ConfigState,\n  Transport,\n  TransportEvents,\n} from \"../types\";\nimport { Emitter } from \"../Emitter\";\nimport { ConfigDirectorConnectionError } from \"../errors\";\nimport type { TestValue, TestValues } from \"./values\";\nimport { nativeValueConfigState } from \"../native-values\";\n\ntype ControlledAttempt = \"initialize\" | \"updateContext\";\n\ntype Armed = \"nothing\" | \"hold\" | \"failure\";\n\ntype PendingHold = {\n  attempt: ControlledAttempt;\n  end: () => void;\n  complete: () => void;\n  fail: () => void;\n};\n\nconst TEST_ENVIRONMENT = { environmentId: \"test-environment\", projectId: \"test-project\" };\n\nconst controlledAttemptFor = (reason: ClientConnectAction): ControlledAttempt | undefined => {\n  switch (reason) {\n    case \"initialization\":\n      return \"initialize\";\n    case \"context update\":\n      return \"updateContext\";\n    default:\n      return undefined;\n  }\n};\n\nexport class InMemoryConnection implements Transport {\n  private readonly emitter = new Emitter<TransportEvents>();\n  private readonly configs = new Map<string, ConfigState>();\n  private readonly recordedContexts: ConfigDirectorContext[] = [];\n  private readonly pendingDeliveries: ConfigSet[] = [];\n  private readonly armed: Record<ControlledAttempt, Armed> = { initialize: \"nothing\", updateContext: \"nothing\" };\n  private pendingHold: PendingHold | undefined;\n  private connected = false;\n  private delivering = false;\n  private revision = 0;\n  private attemptGeneration = 0;\n\n  constructor(\n    private readonly logger: ConfigDirectorLogger,\n    values: TestValues,\n  ) {\n    this.store(values);\n  }\n\n  public get contextUpdates(): ConfigDirectorContext[] {\n    return [...this.recordedContexts];\n  }\n\n  public setValue(key: string, value: TestValue) {\n    const configState = this.encode(key, value);\n    this.configs.set(key, configState);\n    this.deliverIfConnected({ ...TEST_ENVIRONMENT, kind: \"delta\", configs: { [key]: configState } });\n  }\n\n  public removeValue(key: string) {\n    this.configs.delete(key);\n    this.deliverIfConnected(this.fullUpdate());\n  }\n\n  public replaceValues(values: TestValues) {\n    const encoded = this.encodeAll(values);\n    this.configs.clear();\n    encoded.forEach((configState, key) => this.configs.set(key, configState));\n    this.armed.initialize = \"nothing\";\n    this.armed.updateContext = \"nothing\";\n    this.deliverIfConnected(this.fullUpdate());\n  }\n\n  public hold(attempt: ControlledAttempt) {\n    this.armed[attempt] = \"hold\";\n  }\n\n  public complete(attempt: ControlledAttempt) {\n    if (this.pendingHold?.attempt === attempt) {\n      this.pendingHold.complete();\n    } else if (this.armed[attempt] === \"hold\") {\n      this.armed[attempt] = \"nothing\";\n    }\n  }\n\n  public fail(attempt: ControlledAttempt) {\n    if (this.pendingHold?.attempt === attempt) {\n      this.pendingHold.fail();\n    } else {\n      this.armed[attempt] = \"failure\";\n    }\n  }\n\n  public connect(context: ConfigDirectorContext, timeout: number, reason: ClientConnectAction): Promise<this> {\n    this.endAttempt();\n    const attempt = controlledAttemptFor(reason);\n    if (!attempt) {\n      return this.connectNow();\n    }\n    this.recordedContexts.push(context);\n    const armed = this.armed[attempt];\n    this.armed[attempt] = \"nothing\";\n    switch (armed) {\n      case \"failure\":\n        return this.failNow(reason);\n      case \"hold\":\n        return this.holdNow(attempt, reason, timeout);\n      default:\n        return this.connectNow();\n    }\n  }\n\n  public on: Transport[\"on\"] = (name, handler) => this.emitter.on(name, handler);\n\n  public off: Transport[\"off\"] = (name, handler) => this.emitter.off(name, handler);\n\n  public clear() {\n    this.emitter.clear();\n  }\n\n  public close() {\n    this.endAttempt();\n  }\n\n  public dispose() {\n    this.close();\n    this.clear();\n  }\n\n  private endAttempt() {\n    this.attemptGeneration++;\n    this.connected = false;\n    this.pendingHold?.end();\n  }\n\n  private connectNow(): Promise<this> {\n    const connected = Promise.resolve(this);\n    this.scheduleFirstDelivery();\n    return connected;\n  }\n\n  private holdNow(attempt: ControlledAttempt, reason: ClientConnectAction, timeout: number): Promise<this> {\n    return new Promise<this>((resolve, reject) => {\n      const timer = setTimeout(() => this.pendingHold?.end(), timeout);\n      const release = () => {\n        clearTimeout(timer);\n        this.pendingHold = undefined;\n      };\n      this.pendingHold = {\n        attempt,\n        end: () => {\n          release();\n          resolve(this);\n        },\n        complete: () => {\n          release();\n          resolve(this);\n          this.scheduleFirstDelivery();\n        },\n        fail: () => {\n          release();\n          const error = this.fatalError(reason);\n          this.emitter.emit(\"connectionError\", error);\n          reject(error);\n        },\n      };\n    });\n  }\n\n  private failNow(reason: ClientConnectAction): Promise<this> {\n    const error = this.fatalError(reason);\n    this.emitter.emit(\"connectionError\", error);\n    return Promise.reject(error);\n  }\n\n  private fatalError(reason: ClientConnectAction) {\n    return new ConfigDirectorConnectionError(\n      `Connection failed with status: 401. Error: the test client failed this ${reason}. This is an unrecoverable error, will not attempt to reconnect.`,\n      401,\n    );\n  }\n\n  private scheduleFirstDelivery() {\n    const generation = this.attemptGeneration;\n    void Promise.resolve()\n      .then(() => {})\n      .then(() => {\n        if (generation !== this.attemptGeneration) {\n          return;\n        }\n        this.connected = true;\n        this.deliver(this.fullUpdate());\n      });\n  }\n\n  private deliverIfConnected(configSet: ConfigSet) {\n    if (this.connected) {\n      this.deliver(configSet);\n    }\n  }\n\n  private deliver(configSet: ConfigSet) {\n    this.pendingDeliveries.push(configSet);\n    if (this.delivering) {\n      return;\n    }\n    this.delivering = true;\n    try {\n      let next = this.pendingDeliveries.shift();\n      while (next) {\n        this.emitCaught(next);\n        next = this.pendingDeliveries.shift();\n      }\n    } finally {\n      this.delivering = false;\n    }\n  }\n\n  private emitCaught(configSet: ConfigSet) {\n    try {\n      this.emitter.emit(\"configSetReceived\", configSet);\n    } catch (error) {\n      this.logger.error(\"[InMemoryConnection] Error dispatching a config update from the test client: \", error);\n    }\n  }\n\n  private fullUpdate(): ConfigSet {\n    return { ...TEST_ENVIRONMENT, kind: \"full\", configs: Object.fromEntries(this.configs) };\n  }\n\n  private store(values: TestValues) {\n    this.encodeAll(values).forEach((configState, key) => this.configs.set(key, configState));\n  }\n\n  private encodeAll(values: TestValues): Map<string, ConfigState> {\n    const encoded = new Map<string, ConfigState>();\n    for (const [key, value] of Object.entries(values)) {\n      encoded.set(key, this.encode(key, value));\n    }\n    return encoded;\n  }\n\n  private encode(key: string, value: TestValue): ConfigState {\n    return nativeValueConfigState(`test-config:${key}`, key, value, `test-value:${key}:${++this.revision}`);\n  }\n}\n","import { DefaultConfigDirectorClient } from \"../DefaultConfigDirectorClient\";\nimport { createDefaultLogger } from \"../logger\";\nimport type { ConfigDirectorClient, ConfigDirectorContext, ConfigDirectorLogger, IdentifyingSdkOptions } from \"../types\";\nimport { discardingTelemetryClient } from \"../telemetry/discarding\";\nimport { InMemoryConnection } from \"./InMemoryConnection\";\nimport type { TestValue, TestValues } from \"./values\";\n\nconst TEST_CLIENT_SDK_KEY = \"test-client\";\n\n/**\n * Options for {@link createTestClient}. Every option is optional.\n */\nexport type TestClientOptions = {\n  /**\n   * The config values the test client serves once its client connects, keyed by config key. The\n   * config type follows from each value: a boolean, an integral number (`integer`), any other\n   * number (`float`), a string, or a plain object or array (`json`).\n   */\n  values?: TestValues;\n  /**\n   * The connection timeout of the SDK client, in milliseconds. It bounds how long a held\n   * `initialize` or `updateContext` waits. Defaults to the SDK's production timeout.\n   */\n  timeout?: number;\n  /**\n   * The logger the SDK client uses. Defaults to the SDK's console logger at `warn` level.\n   */\n  logger?: ConfigDirectorLogger;\n};\n\n/**\n * A real ConfigDirector client connected to an in-memory server that the test controls.\n *\n * The client under {@link TestClient.client} is the SDK's production client: value parsing, watchers,\n * events, and readiness behave as they do against ConfigDirector. Only the network connection and\n * telemetry are replaced, so no request is ever made and nothing is left running after the client is\n * disposed.\n */\nexport interface TestClient {\n  /**\n   * The SDK client to hand to the code under test. It starts uninitialized, like a production\n   * client; `initialize` completes at once with the seeded values unless initialization is held.\n   */\n  readonly client: ConfigDirectorClient;\n\n  /**\n   * Stores `value` under `key` and, when the client is connected, delivers it as an update, so\n   * reads, watchers, and `configsUpdated` handlers see it.\n   */\n  setValue(key: string, value: TestValue): void;\n\n  /**\n   * Removes `key` and, when the client is connected, delivers a full update without it, so reads\n   * fall back to the in-code default value and watchers of `key` receive that default.\n   */\n  removeValue(key: string): void;\n\n  /**\n   * Replaces every stored value with `values`, disarms any armed hold or failure, and, when the\n   * client is connected, delivers the new values as a full update.\n   */\n  replaceValues(values: TestValues): void;\n\n  /**\n   * Makes the next `initialize` wait until {@link completeInitialization} or\n   * {@link failInitialization} is called, or until the client's timeout elapses.\n   */\n  holdInitialization(): void;\n\n  /**\n   * Delivers the stored values to a held `initialize`, so it completes with the client ready. When\n   * a hold is armed but no `initialize` has started, it disarms the hold instead.\n   */\n  completeInitialization(): void;\n\n  /**\n   * Fails a held `initialize` with an unrecoverable connection error, or arms the next `initialize`\n   * to fail. `initialize` completes promptly with the client not ready and `connectionError` fires.\n   */\n  failInitialization(): void;\n\n  /**\n   * Makes the next `updateContext` wait until {@link completeContextUpdate} or\n   * {@link failContextUpdate} is called, or until the client's timeout elapses.\n   */\n  holdContextUpdate(): void;\n\n  /**\n   * Delivers the stored values to a held `updateContext`, or disarms an armed hold that no\n   * `updateContext` has picked up.\n   */\n  completeContextUpdate(): void;\n\n  /**\n   * Fails a held `updateContext` with an unrecoverable connection error, or arms the next\n   * `updateContext` to fail.\n   */\n  failContextUpdate(): void;\n\n  /**\n   * The context of every `initialize` and `updateContext` call, in call order. `initialize` without\n   * a context records an empty context, and so does a call whose context has an invalid kind, since\n   * the client connects without it. Resumes are not recorded.\n   */\n  readonly contextUpdates: ConfigDirectorContext[];\n}\n\nclass InMemoryTestClient implements TestClient {\n  constructor(\n    public readonly client: ConfigDirectorClient,\n    private readonly connection: InMemoryConnection,\n  ) {}\n\n  public setValue(key: string, value: TestValue) {\n    this.connection.setValue(key, value);\n  }\n\n  public removeValue(key: string) {\n    this.connection.removeValue(key);\n  }\n\n  public replaceValues(values: TestValues) {\n    this.connection.replaceValues(values);\n  }\n\n  public holdInitialization() {\n    this.connection.hold(\"initialize\");\n  }\n\n  public completeInitialization() {\n    this.connection.complete(\"initialize\");\n  }\n\n  public failInitialization() {\n    this.connection.fail(\"initialize\");\n  }\n\n  public holdContextUpdate() {\n    this.connection.hold(\"updateContext\");\n  }\n\n  public completeContextUpdate() {\n    this.connection.complete(\"updateContext\");\n  }\n\n  public failContextUpdate() {\n    this.connection.fail(\"updateContext\");\n  }\n\n  public get contextUpdates(): ConfigDirectorContext[] {\n    return this.connection.contextUpdates;\n  }\n}\n\nexport const createTestClient = (sdkOptions: IdentifyingSdkOptions, options?: TestClientOptions): TestClient => {\n  const logger = options?.logger ?? createDefaultLogger();\n  const connection = new InMemoryConnection(logger, options?.values ?? {});\n  const client = new DefaultConfigDirectorClient(\n    () => discardingTelemetryClient,\n    TEST_CLIENT_SDK_KEY,\n    sdkOptions,\n    { logger, connection: { timeout: options?.timeout } },\n    { transport: connection },\n  );\n  return new InMemoryTestClient(client, connection);\n};\n","import { createTestClient as createCoreTestClient } from \"@js-client-core/testing/index\";\nimport type { TestClient, TestClientOptions } from \"@js-client-core/testing/index\";\n\nexport type { TestClient, TestClientOptions, TestValue, TestValues, TestJsonValue } from \"@js-client-core/testing/index\";\nexport { ConfigDirectorConnectionError, ConfigDirectorValidationError } from \"@shared/errors\";\n\n/**\n * Creates a {@link TestClient}: a real `ConfigDirectorClient` connected to an in-memory server\n * that the test controls. No network connection is opened and no telemetry is sent.\n *\n * @param options {@link TestClientOptions}: the initial values, the client's timeout, and its logger\n * @returns A {@link TestClient} whose `client` is passed to the code under test\n *\n * @example\n * import { createTestClient } from \"@configdirector/client-sdk/testing\";\n *\n * const testClient = createTestClient({ values: { \"new-checkout\": true } });\n * await testClient.client.initialize();\n * expect(testClient.client.getValue(\"new-checkout\", false)).toBe(true);\n *\n * testClient.setValue(\"new-checkout\", false);\n */\nexport const createTestClient = (options?: TestClientOptions): TestClient => {\n  return createCoreTestClient({ sdkName: \"js-client-sdk\", sdkVersion: \"__VERSION__\" }, options);\n};\n"],"mappings":"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"}

package/dist/configdirector-client.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./DefaultConfigDirectorClient-DFaPrMO4.cjs`),t=e=>{if(e.type===`json`||e.type==null&&typeof e.value==`object`){if(e.valueId)return{valueId:e.valueId,type:`json`};try{return{value:JSON.stringify(e.value),type:`json`}}catch{return{value:e.value.toString(),type:`json`}}}let t=e.value?.toString();return t&&t.length<=500?{value:t}:e.valueId?{valueId:e.valueId}:{value:t}};var n=class{constructor(){this.countsByKindSample=new Map,this.countBeyondSampleLimit=0}record(e){return this.startTime??=new Date,this.add(e,1)}absorb(e){for(let t of e)(this.startTime===void 0||t.startTime<this.startTime)&&(this.startTime=t.startTime),this.add(t.event.kindSample,t.count)}add(e,t){if(e!==void 0){let n=this.countsByKindSample.get(e);if(n!==void 0)return this.countsByKindSample.set(e,n+t),`known-kind-sample`;if(this.countsByKindSample.size<20)return this.countsByKindSample.set(e,t),`new-kind-sample`}let n=this.countBeyondSampleLimit===0;return this.countBeyondSampleLimit+=t,n?`first-beyond-sample-limit`:`beyond-sample-limit`}takeSnapshot(){let e=new Date,t=this.startTime??e,n=(n,r)=>({startTime:t,endTime:e,count:n,event:{reason:`invalid-context-kind`,kindSample:r}}),r=Array.from(this.countsByKindSample,([e,t])=>n(t,e)),i=this.countBeyondSampleLimit>0?[...r,n(this.countBeyondSampleLimit)]:r;return this.clear(),i}clear(){this.countsByKindSample.clear(),this.countBeyondSampleLimit=0,this.startTime=void 0}},r=class{constructor(e){this.turnedOff=!1,this.pendingEvaluations=[],this.pendingInvalidContextSubmissions=new n,this.logger=e.logger,this.workerCloseTimeout=e.workerCloseTimeout??6e3,this.pendingEvaluationLimit=e.evaluationQueueLimit??1e3,this.clientSession=e.clientSession,this.initializeMessage={type:`Initialize`,payload:{sdkKey:e.sdkKey,sdkIdentity:e.sdkIdentity,metaContext:e.metaContext,baseUrl:e.baseUrl.toString(),evaluationQueueLimit:this.pendingEvaluationLimit,initialFlushIntervalDelay:e.initialFlushIntervalDelay??5e3,flushIntervalDelay:e.flushIntervalDelay??3e4}},this.visibilityHandler=()=>{document.visibilityState===`hidden`&&this.flush()}}createWorkerOrTurnOff(){if(typeof Worker>`u`){this.turnOff(`[WebWorkerTelemetryClient] Telemetry is off because Web Workers are not available in this environment.`);return}try{return new Worker(URL.createObjectURL(new Blob(["(function(){let e=async(e,t)=>e.valueId?{valueId:e.valueId}:e.value?e.value.length<=500&&e.type!=`json`?{value:e.value}:{valueId:await t(e.value)}:e,t=e=>{let t=Object.keys(e);if(t.length==0)return!0;for(let n of t)if((e[n]?.length??0)>0)return!1;return!0},n=e=>{if(!e)return!0;let t=Object.keys(e);if(t.length==0)return!0;for(let n of t)if((e[n]??0)>0)return!1;return!0},r=async(e,t,n,r)=>{let i=new AbortController,a=setTimeout(()=>{r.debug(`[fetchWithTimeout] Reached timeout, aborting request`),i.abort()},e);try{let e=await fetch(typeof t==`string`||t instanceof Request?t:t.toString(),{...n,signal:i.signal});return clearTimeout(a),e}catch(e){throw r.warn(`[fetchWithTimeout] Fetch error: `,e),clearTimeout(a),e}},i=e=>e?.name===`NotAllowedError`?!0:e instanceof TypeError;var a=class{constructor(e){this.executeRequests=!0,this.sdkKey=e.sdkKey,this.logger=e.logger,this.sdkIdentity=e.sdkIdentity,this.metaContext=e.metaContext,this.url=e.urlFactory(`client/telemetry/v1`,e.baseUrl),this.clientSession=e.clientSession}async report({context:e,discreteEvents:t,aggregatedEvents:n,droppedEvents:r}){if(!this.executeRequests)return{success:!1,fatalError:!0};let{instanceId:i}=await this.clientSession,a={clientSdkKey:this.sdkKey,instanceId:i,metaContext:{sdkName:this.sdkIdentity.sdkName,sdkVersion:this.sdkIdentity.sdkVersion,appName:this.metaContext.appName,appVersion:this.metaContext.appVersion},context:e,discreteEvents:t,aggregatedEvents:n,droppedEvents:r};if(this.isReportEmpty(a))return{success:!0,fatalError:!1};let o=await this.sendReport(a);return o.fatalError&&(this.executeRequests=!1),o}isReportEmpty(e){return t(e.discreteEvents)&&t(e.aggregatedEvents)&&n(e.droppedEvents)}async sendReport(e){try{let t=await r(5e3,this.url,{method:`POST`,body:JSON.stringify(e),keepalive:!0},this.logger),n=this.isStatusFatal(t.status);return n&&this.logger.warn(`[EventReporter] Received a fatal status response (${t.status}) from the telemetry endpoint. No more telemetry data will be sent.`),{success:t.ok,fatalError:n}}catch(e){let t=i(e);return this.logger.warn(`[EventReporter] Error attempting to send telemetry data: ${e}`,{error:e}),{success:!1,fatalError:t}}}isStatusFatal(e){return!!e&&e>=400&&e<500&&e!=429}},o=class{aggregate(e){if(e.events.length==0)return[];let t=new Map;for(let n of e.events){let e=JSON.stringify(n),r=t.get(e)?.count||0;t.set(e,{event:n,count:r+1})}return Array.from(t).map(([,t])=>({startTime:e.startTime,endTime:e.endTime,count:t.count,event:t.event}))}},s=class{constructor(e){this._events=[],this._droppedEventCount=0,this.limit=e??1e3}get events(){return this._events}get reachedLimit(){return this._events.length>=this.limit}get droppedEventCount(){return this._droppedEventCount}push(...e){this.startTime||=new Date;let t=Math.max(0,e.length-this.limit),n=e.slice(t,e.length);if(this._droppedEventCount+=t,this._events.length+n.length>this.limit){let e=this._events.length+n.length-this.limit;this._events.splice(0,e),this._droppedEventCount+=e}return this._events.push(...n)}takeSnapshot(){let e=new Date,t=this.startTime??e,n=this._events.splice(0),r=this._droppedEventCount;return this.startTime=void 0,this._droppedEventCount=0,{startTime:t,endTime:e,events:n,droppedCount:r}}clear(){this._events=[],this.startTime=void 0,this._droppedEventCount=0}},c=class{constructor(e){this.aggregator=new o,this.collectEvents=!0,this.started=!1,this.logger=e.logger,this.evaluationEventQueue=new s(e.evaluationQueueLimit??1e3),this.flushIntervalDelay=e.flushIntervalDelay??3e4,this.initialFlushIntervalDelay=e.initialFlushIntervalDelay??5e3}start(){this.started||!this.collectEvents||(this.started=!0,this.flushTimeout=setTimeout(()=>this.flushAndScheduleNext(),this.initialFlushIntervalDelay))}async flushAndScheduleNext(){if(!this.collectEvents)return;let e;try{e=await this.flush()}catch(t){this.logger.warn(`[TelemetryEventCollector] Error flushing telemetry events: `,t),e={success:!1,fatalError:!1}}e.fatalError?(this.collectEvents=!1,this.close(),this.logger.warn(`[TelemetryEventCollector] Received a fatal error from telemetry collection. No longer collecting events.`)):this.collectEvents&&(this.cancelScheduledFlush(),this.flushTimeout=setTimeout(()=>this.flushAndScheduleNext(),this.flushIntervalDelay))}cancelScheduledFlush(){clearTimeout(this.flushTimeout)}async close(){this.collectEvents=!1,clearTimeout(this.flushTimeout);try{await this.flush()}catch(e){this.logger.warn(`[TelemetryEventCollector] Error flushing telemetry events during close: `,e)}this.evaluationEventQueue.clear()}dispose(){this.close()}},l=class{constructor(e){this.valueIdGenerator=e,this.valueIdGenerator=e}async process(t){let n=await Promise.all(t.events.map(async t=>({...t,defaultValue:await e(t.defaultValue,this.valueIdGenerator),evaluatedValue:await e(t.evaluatedValue,this.valueIdGenerator)})));return{...t,events:n}}},u=class{constructor(){this.countsByKindSample=new Map,this.countBeyondSampleLimit=0}record(e){return this.startTime??=new Date,this.add(e,1)}absorb(e){for(let t of e)(this.startTime===void 0||t.startTime<this.startTime)&&(this.startTime=t.startTime),this.add(t.event.kindSample,t.count)}add(e,t){if(e!==void 0){let n=this.countsByKindSample.get(e);if(n!==void 0)return this.countsByKindSample.set(e,n+t),`known-kind-sample`;if(this.countsByKindSample.size<20)return this.countsByKindSample.set(e,t),`new-kind-sample`}let n=this.countBeyondSampleLimit===0;return this.countBeyondSampleLimit+=t,n?`first-beyond-sample-limit`:`beyond-sample-limit`}takeSnapshot(){let e=new Date,t=this.startTime??e,n=(n,r)=>({startTime:t,endTime:e,count:n,event:{reason:`invalid-context-kind`,kindSample:r}}),r=Array.from(this.countsByKindSample,([e,t])=>n(t,e)),i=this.countBeyondSampleLimit>0?[...r,n(this.countBeyondSampleLimit)]:r;return this.clear(),i}clear(){this.countsByKindSample.clear(),this.countBeyondSampleLimit=0,this.startTime=void 0}},d=class extends c{constructor(e){super(e),this.invalidContextSubmissions=new u,this.reporter=new a(e),this.evaluationEventSnapshotPreprocessor=new l(e.valueIdGenerator)}async updateContext(e){this.cancelScheduledFlush(),await this.flush(),this._context=e,await this.flushAndScheduleNext()}evaluatedConfig(e){this.collectEvents&&this.evaluationEventQueue.push(e)}recordInvalidContext(e){this.invalidContextSubmissions.record(e)}absorbInvalidContextSubmissions(e){this.invalidContextSubmissions.absorb(e)}async forceFlush(){this.cancelScheduledFlush(),await this.flushAndScheduleNext()}async flush(){if(!this.reporter)return{success:!1,fatalError:!1};let e=await this.evaluationEventSnapshotPreprocessor.process(this.evaluationEventQueue.takeSnapshot());return await this.reporter?.report({context:this._context,discreteEvents:{},aggregatedEvents:{evaluatedConfig:this.aggregator.aggregate(e),invalidContext:this.invalidContextSubmissions.takeSnapshot()},droppedEvents:{evaluatedConfig:e.droppedCount}})}};let f=(e,t)=>new URL(e,t?.toString()),p=(e,t)=>{let n=BigInt(0),r=BigInt(62),i=Array.from(e).map(e=>e.toString(16).padStart(2,`0`)).join(``),a=BigInt(`0x`+i),o=``;for(;a>n;)o=`0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz`[Number(a%r)]+o,a/=r;return o.padStart(t,`0`)},m=Math.ceil(128/Math.log2(62)),h=new TextEncoder,g=async e=>{if(typeof crypto>`u`||crypto.subtle==null)return;let t=await crypto.subtle.digest(`SHA-256`,h.encode(e?.toString()??``));return p(new Uint8Array(t,0,16),m)},_,v,y=new Promise(e=>{v=e}),b=(e,t,...n)=>({type:`Log`,payload:{level:e,message:t,args:n}}),x=e=>{try{self.postMessage(e)}catch{self.postMessage(b(e.payload.level,e.payload.message))}},S={debug:function(e,...t){x(b(`debug`,e,t))},info:function(e,...t){x(b(`info`,e,t))},warn:function(e,...t){x(b(`warn`,e,t))},error:function(e,...t){x(b(`error`,e,t))}};addEventListener(`message`,e=>{let t=e.data;if(t.type!=`Initialize`&&!_){S.info(`[TelemetryWorker] Ignoring ${t.type} because no collector is configured`);return}switch(S.debug(`[TelemetryWorker] Received '${t.type}' event:`,t),t.type){case`Initialize`:if(_){S.warn(`[TelemetryWorker] Received a duplicate Initialize event, ignoring it`);break}_=new d({...t.payload,baseUrl:f(t.payload.baseUrl),urlFactory:f,valueIdGenerator:g,logger:S,clientSession:y}),_.start();break;case`ClientSession`:v(t.payload);break;case`EvaluatedConfigEvent`:_?.evaluatedConfig(t.payload);break;case`InvalidContextSubmissions`:_?.absorbInvalidContextSubmissions(t.payload.entries);break;case`UpdateContext`:_?.updateContext(t.payload.context);break;case`Flush`:_?.forceFlush();break;case`Close`:(_?.close()??Promise.resolve()).then(()=>{self.postMessage({type:`Closed`}),self.close()});break}})})();"],{type:`application/javascript`})))}catch(e){this.turnOff(`[WebWorkerTelemetryClient] Telemetry is off because the telemetry Web Worker could not be created: `,e);return}}turnOff(e,...t){this.turnedOff=!0,this.pendingEvaluations.length=0,this.logger.warn(e,...t)}startWorker(){if(this.worker||this.turnedOff)return this.worker;let e=this.createWorkerOrTurnOff();if(e){e.onmessage=e=>{this.handleWorkerEvent(e.data)},e.postMessage(this.initializeMessage),this.forwardClientSession(e),this.worker=e;try{document.addEventListener(`visibilitychange`,this.visibilityHandler)}catch(e){this.logger.warn(`[TelemetryEventCollector] Could not configure 'visibilitychange' listener: `,e)}for(let t of this.pendingEvaluations)e.postMessage(t);return this.pendingEvaluations.length=0,this.forwardInvalidContextSubmissions(e),e}}forwardClientSession(e){this.clientSession.then(t=>{let n={type:`ClientSession`,payload:t};e.postMessage(n)})}forwardInvalidContextSubmissions(e){if(!e)return;let t=this.pendingInvalidContextSubmissions.takeSnapshot();if(t.length===0)return;let n={type:`InvalidContextSubmissions`,payload:{entries:t}};e.postMessage(n)}async updateContext(e){if(this.closePromise)return;let t={type:`UpdateContext`,payload:{context:e}};this.startWorker()?.postMessage(t)}evaluatedConfig(e){if(this.turnedOff)return;let t={type:`EvaluatedConfigEvent`,payload:this.sanitizeEvaluatedConfigEvent(e)};if(this.worker){this.worker.postMessage(t);return}this.pendingEvaluations.length>=this.pendingEvaluationLimit&&this.pendingEvaluations.shift(),this.pendingEvaluations.push(t)}recordInvalidContext(e){this.pendingInvalidContextSubmissions.record(e),this.forwardInvalidContextSubmissions(this.worker)}sanitizeEvaluatedConfigEvent(e){return{...e,defaultValue:t({value:e.defaultValue,type:e.type}),evaluatedValue:t({value:e.evaluatedValue,valueId:e.evaluatedValueId,type:e.type})}}handleWorkerEvent(e){if(e.type===`Closed`){this.finishClose();return}if(!e.payload?.level||!e.payload?.message)return;let{level:t,message:n,args:r}=e.payload;switch(t){case`debug`:this.logger.debug(n,...r);break;case`info`:this.logger.info(n,...r);break;case`warn`:this.logger.warn(n,...r);break;case`error`:this.logger.error(n,...r);break}}flush(){this.worker?.postMessage({type:`Flush`})}close(){return this.closePromise?this.closePromise:this.performClose()}performClose(){let e=this.worker;if(!e)return this.pendingEvaluations.length=0,this.closePromise=Promise.resolve(),this.closePromise;try{document.removeEventListener(`visibilitychange`,this.visibilityHandler)}catch(e){this.logger.warn(`[WebWorkerTelemetryClient] Could not remove 'visibilitychange' listener: `,e)}return this.closePromise=new Promise(t=>{this.closeResolve=t,this.closeTimer=setTimeout(()=>{this.logger.warn(`[WebWorkerTelemetryClient] Timed out waiting for the telemetry worker to close. Terminating the worker.`),this.finishClose()},this.workerCloseTimeout),e.postMessage({type:`Close`})}),this.closePromise}finishClose(){clearTimeout(this.closeTimer),this.closeTimer=void 0,this.worker?.terminate(),this.closeResolve?.()}};const i=(e,t)=>{let n=BigInt(0),r=BigInt(62),i=Array.from(e).map(e=>e.toString(16).padStart(2,`0`)).join(``),a=BigInt(`0x`+i),o=``;for(;a>n;)o=`0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz`[Number(a%r)]+o,a/=r;return o.padStart(t,`0`)},a=Math.ceil(128/Math.log2(62)),o=new TextEncoder,s=async e=>{if(typeof crypto>`u`||crypto.subtle==null)return;let t=await crypto.subtle.digest(`SHA-256`,o.encode(e?.toString()??``));return i(new Uint8Array(t,0,16),a)},c=e=>Array.from(e,e=>e.toString(16).padStart(2,`0`)).join(``),l=async t=>{let n=await crypto.subtle.digest(`SHA-256`,new TextEncoder().encode(t));return e.n+c(new Uint8Array(n))},u=()=>typeof crypto<`u`&&crypto.subtle!=null,d=t=>{let n=e.i();if(!n||!u())return;let r=l(t);return{read:async()=>n.getItem(await r),write:async e=>n.setItem(await r,e),remove:async()=>n.removeItem(await r),sizeLimit:()=>e.r}},f=(t,n,i)=>e.t.from(({clientSdkKey:t,baseUrl:i,logger:a,metadata:o,clientSession:c})=>new r({sdkKey:t,sdkIdentity:{sdkName:n.sdkName,sdkVersion:n.sdkVersion},metaContext:{appName:o?.appName,appVersion:o?.appVersion},logger:a,baseUrl:i,urlFactory:e.a,valueIdGenerator:s,clientSession:c}),t,n,i,{platformCachingProvider:d}),p={sdkName:`js-client-sdk`,sdkVersion:`1.9.1`};function m(e,t){return f(e,p,t)}const h=(t,n)=>e.s(t,n);exports.ConfigDirectorInitializationError=e.d,exports.createClient=m,exports.createConsoleLogger=h;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./DefaultConfigDirectorClient-D0ElCtEO.cjs`),t=e=>{if(e.type===`json`||e.type==null&&typeof e.value==`object`){if(e.valueId)return{valueId:e.valueId,type:`json`};try{return{value:JSON.stringify(e.value),type:`json`}}catch{return{value:e.value.toString(),type:`json`}}}let t=e.value?.toString();return t&&t.length<=500?{value:t}:e.valueId?{valueId:e.valueId}:{value:t}};var n=class{constructor(){this.countsByKindSample=new Map,this.countBeyondSampleLimit=0}record(e){return this.startTime??=new Date,this.add(e,1)}absorb(e){for(let t of e)(this.startTime===void 0||t.startTime<this.startTime)&&(this.startTime=t.startTime),this.add(t.event.kindSample,t.count)}add(e,t){if(e!==void 0){let n=this.countsByKindSample.get(e);if(n!==void 0)return this.countsByKindSample.set(e,n+t),`known-kind-sample`;if(this.countsByKindSample.size<20)return this.countsByKindSample.set(e,t),`new-kind-sample`}let n=this.countBeyondSampleLimit===0;return this.countBeyondSampleLimit+=t,n?`first-beyond-sample-limit`:`beyond-sample-limit`}takeSnapshot(){let e=new Date,t=this.startTime??e,n=(n,r)=>({startTime:t,endTime:e,count:n,event:{reason:`invalid-context-kind`,kindSample:r}}),r=Array.from(this.countsByKindSample,([e,t])=>n(t,e)),i=this.countBeyondSampleLimit>0?[...r,n(this.countBeyondSampleLimit)]:r;return this.clear(),i}clear(){this.countsByKindSample.clear(),this.countBeyondSampleLimit=0,this.startTime=void 0}},r=class{constructor(e){this.turnedOff=!1,this.pendingEvaluations=[],this.pendingInvalidContextSubmissions=new n,this.logger=e.logger,this.workerCloseTimeout=e.workerCloseTimeout??6e3,this.pendingEvaluationLimit=e.evaluationQueueLimit??1e3,this.clientSession=e.clientSession,this.initializeMessage={type:`Initialize`,payload:{sdkKey:e.sdkKey,sdkIdentity:e.sdkIdentity,metaContext:e.metaContext,baseUrl:e.baseUrl.toString(),evaluationQueueLimit:this.pendingEvaluationLimit,initialFlushIntervalDelay:e.initialFlushIntervalDelay??5e3,flushIntervalDelay:e.flushIntervalDelay??3e4}},this.visibilityHandler=()=>{document.visibilityState===`hidden`&&this.flush()}}createWorkerOrTurnOff(){if(typeof Worker>`u`){this.turnOff(`[WebWorkerTelemetryClient] Telemetry is off because Web Workers are not available in this environment.`);return}try{return new Worker(URL.createObjectURL(new Blob(["(function(){let e=async(e,t)=>e.valueId?{valueId:e.valueId}:e.value?e.value.length<=500&&e.type!=`json`?{value:e.value}:{valueId:await t(e.value)}:e,t=e=>{let t=Object.keys(e);if(t.length==0)return!0;for(let n of t)if((e[n]?.length??0)>0)return!1;return!0},n=e=>{if(!e)return!0;let t=Object.keys(e);if(t.length==0)return!0;for(let n of t)if((e[n]??0)>0)return!1;return!0},r=async(e,t,n,r)=>{let i=new AbortController,a=setTimeout(()=>{r.debug(`[fetchWithTimeout] Reached timeout, aborting request`),i.abort()},e);try{let e=await fetch(typeof t==`string`||t instanceof Request?t:t.toString(),{...n,signal:i.signal});return clearTimeout(a),e}catch(e){throw r.warn(`[fetchWithTimeout] Fetch error: `,e),clearTimeout(a),e}},i=e=>e?.name===`NotAllowedError`?!0:e instanceof TypeError;var a=class{constructor(e){this.executeRequests=!0,this.sdkKey=e.sdkKey,this.logger=e.logger,this.sdkIdentity=e.sdkIdentity,this.metaContext=e.metaContext,this.url=e.urlFactory(`client/telemetry/v1`,e.baseUrl),this.clientSession=e.clientSession}async report({context:e,discreteEvents:t,aggregatedEvents:n,droppedEvents:r}){if(!this.executeRequests)return{success:!1,fatalError:!0};let{instanceId:i}=await this.clientSession,a={clientSdkKey:this.sdkKey,instanceId:i,metaContext:{sdkName:this.sdkIdentity.sdkName,sdkVersion:this.sdkIdentity.sdkVersion,appName:this.metaContext.appName,appVersion:this.metaContext.appVersion},context:e,discreteEvents:t,aggregatedEvents:n,droppedEvents:r};if(this.isReportEmpty(a))return{success:!0,fatalError:!1};let o=await this.sendReport(a);return o.fatalError&&(this.executeRequests=!1),o}isReportEmpty(e){return t(e.discreteEvents)&&t(e.aggregatedEvents)&&n(e.droppedEvents)}async sendReport(e){try{let t=await r(5e3,this.url,{method:`POST`,body:JSON.stringify(e),keepalive:!0},this.logger),n=this.isStatusFatal(t.status);return n&&this.logger.warn(`[EventReporter] Received a fatal status response (${t.status}) from the telemetry endpoint. No more telemetry data will be sent.`),{success:t.ok,fatalError:n}}catch(e){let t=i(e);return this.logger.warn(`[EventReporter] Error attempting to send telemetry data: ${e}`,{error:e}),{success:!1,fatalError:t}}}isStatusFatal(e){return!!e&&e>=400&&e<500&&e!=429}},o=class{aggregate(e){if(e.events.length==0)return[];let t=new Map;for(let n of e.events){let e=JSON.stringify(n),r=t.get(e)?.count||0;t.set(e,{event:n,count:r+1})}return Array.from(t).map(([,t])=>({startTime:e.startTime,endTime:e.endTime,count:t.count,event:t.event}))}},s=class{constructor(e){this._events=[],this._droppedEventCount=0,this.limit=e??1e3}get events(){return this._events}get reachedLimit(){return this._events.length>=this.limit}get droppedEventCount(){return this._droppedEventCount}push(...e){this.startTime||=new Date;let t=Math.max(0,e.length-this.limit),n=e.slice(t,e.length);if(this._droppedEventCount+=t,this._events.length+n.length>this.limit){let e=this._events.length+n.length-this.limit;this._events.splice(0,e),this._droppedEventCount+=e}return this._events.push(...n)}takeSnapshot(){let e=new Date,t=this.startTime??e,n=this._events.splice(0),r=this._droppedEventCount;return this.startTime=void 0,this._droppedEventCount=0,{startTime:t,endTime:e,events:n,droppedCount:r}}clear(){this._events=[],this.startTime=void 0,this._droppedEventCount=0}},c=class{constructor(e){this.aggregator=new o,this.collectEvents=!0,this.started=!1,this.logger=e.logger,this.evaluationEventQueue=new s(e.evaluationQueueLimit??1e3),this.flushIntervalDelay=e.flushIntervalDelay??3e4,this.initialFlushIntervalDelay=e.initialFlushIntervalDelay??5e3}start(){this.started||!this.collectEvents||(this.started=!0,this.flushTimeout=setTimeout(()=>this.flushAndScheduleNext(),this.initialFlushIntervalDelay))}async flushAndScheduleNext(){if(!this.collectEvents)return;let e;try{e=await this.flush()}catch(t){this.logger.warn(`[TelemetryEventCollector] Error flushing telemetry events: `,t),e={success:!1,fatalError:!1}}e.fatalError?(this.collectEvents=!1,this.close(),this.logger.warn(`[TelemetryEventCollector] Received a fatal error from telemetry collection. No longer collecting events.`)):this.collectEvents&&(this.cancelScheduledFlush(),this.flushTimeout=setTimeout(()=>this.flushAndScheduleNext(),this.flushIntervalDelay))}cancelScheduledFlush(){clearTimeout(this.flushTimeout)}async close(){this.collectEvents=!1,clearTimeout(this.flushTimeout);try{await this.flush()}catch(e){this.logger.warn(`[TelemetryEventCollector] Error flushing telemetry events during close: `,e)}this.evaluationEventQueue.clear()}dispose(){this.close()}},l=class{constructor(e){this.valueIdGenerator=e,this.valueIdGenerator=e}async process(t){let n=await Promise.all(t.events.map(async t=>({...t,defaultValue:await e(t.defaultValue,this.valueIdGenerator),evaluatedValue:await e(t.evaluatedValue,this.valueIdGenerator)})));return{...t,events:n}}},u=class{constructor(){this.countsByKindSample=new Map,this.countBeyondSampleLimit=0}record(e){return this.startTime??=new Date,this.add(e,1)}absorb(e){for(let t of e)(this.startTime===void 0||t.startTime<this.startTime)&&(this.startTime=t.startTime),this.add(t.event.kindSample,t.count)}add(e,t){if(e!==void 0){let n=this.countsByKindSample.get(e);if(n!==void 0)return this.countsByKindSample.set(e,n+t),`known-kind-sample`;if(this.countsByKindSample.size<20)return this.countsByKindSample.set(e,t),`new-kind-sample`}let n=this.countBeyondSampleLimit===0;return this.countBeyondSampleLimit+=t,n?`first-beyond-sample-limit`:`beyond-sample-limit`}takeSnapshot(){let e=new Date,t=this.startTime??e,n=(n,r)=>({startTime:t,endTime:e,count:n,event:{reason:`invalid-context-kind`,kindSample:r}}),r=Array.from(this.countsByKindSample,([e,t])=>n(t,e)),i=this.countBeyondSampleLimit>0?[...r,n(this.countBeyondSampleLimit)]:r;return this.clear(),i}clear(){this.countsByKindSample.clear(),this.countBeyondSampleLimit=0,this.startTime=void 0}},d=class extends c{constructor(e){super(e),this.invalidContextSubmissions=new u,this.reporter=new a(e),this.evaluationEventSnapshotPreprocessor=new l(e.valueIdGenerator)}async updateContext(e){this.cancelScheduledFlush(),await this.flush(),this._context=e,await this.flushAndScheduleNext()}evaluatedConfig(e){this.collectEvents&&this.evaluationEventQueue.push(e)}recordInvalidContext(e){this.invalidContextSubmissions.record(e)}absorbInvalidContextSubmissions(e){this.invalidContextSubmissions.absorb(e)}async forceFlush(){this.cancelScheduledFlush(),await this.flushAndScheduleNext()}async flush(){if(!this.reporter)return{success:!1,fatalError:!1};let e=await this.evaluationEventSnapshotPreprocessor.process(this.evaluationEventQueue.takeSnapshot());return await this.reporter?.report({context:this._context,discreteEvents:{},aggregatedEvents:{evaluatedConfig:this.aggregator.aggregate(e),invalidContext:this.invalidContextSubmissions.takeSnapshot()},droppedEvents:{evaluatedConfig:e.droppedCount}})}};let f=(e,t)=>new URL(e,t?.toString()),p=(e,t)=>{let n=BigInt(0),r=BigInt(62),i=Array.from(e).map(e=>e.toString(16).padStart(2,`0`)).join(``),a=BigInt(`0x`+i),o=``;for(;a>n;)o=`0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz`[Number(a%r)]+o,a/=r;return o.padStart(t,`0`)},m=Math.ceil(128/Math.log2(62)),h=new TextEncoder,g=async e=>{if(typeof crypto>`u`||crypto.subtle==null)return;let t=await crypto.subtle.digest(`SHA-256`,h.encode(e?.toString()??``));return p(new Uint8Array(t,0,16),m)},_,v,y=new Promise(e=>{v=e}),b=(e,t,...n)=>({type:`Log`,payload:{level:e,message:t,args:n}}),x=e=>{try{self.postMessage(e)}catch{self.postMessage(b(e.payload.level,e.payload.message))}},S={debug:function(e,...t){x(b(`debug`,e,t))},info:function(e,...t){x(b(`info`,e,t))},warn:function(e,...t){x(b(`warn`,e,t))},error:function(e,...t){x(b(`error`,e,t))}};addEventListener(`message`,e=>{let t=e.data;if(t.type!=`Initialize`&&!_){S.info(`[TelemetryWorker] Ignoring ${t.type} because no collector is configured`);return}switch(S.debug(`[TelemetryWorker] Received '${t.type}' event:`,t),t.type){case`Initialize`:if(_){S.warn(`[TelemetryWorker] Received a duplicate Initialize event, ignoring it`);break}_=new d({...t.payload,baseUrl:f(t.payload.baseUrl),urlFactory:f,valueIdGenerator:g,logger:S,clientSession:y}),_.start();break;case`ClientSession`:v(t.payload);break;case`EvaluatedConfigEvent`:_?.evaluatedConfig(t.payload);break;case`InvalidContextSubmissions`:_?.absorbInvalidContextSubmissions(t.payload.entries);break;case`UpdateContext`:_?.updateContext(t.payload.context);break;case`Flush`:_?.forceFlush();break;case`Close`:(_?.close()??Promise.resolve()).then(()=>{self.postMessage({type:`Closed`}),self.close()});break}})})();"],{type:`application/javascript`})))}catch(e){this.turnOff(`[WebWorkerTelemetryClient] Telemetry is off because the telemetry Web Worker could not be created: `,e);return}}turnOff(e,...t){this.turnedOff=!0,this.pendingEvaluations.length=0,this.logger.warn(e,...t)}startWorker(){if(this.worker||this.turnedOff)return this.worker;let e=this.createWorkerOrTurnOff();if(e){e.onmessage=e=>{this.handleWorkerEvent(e.data)},e.postMessage(this.initializeMessage),this.forwardClientSession(e),this.worker=e;try{document.addEventListener(`visibilitychange`,this.visibilityHandler)}catch(e){this.logger.warn(`[TelemetryEventCollector] Could not configure 'visibilitychange' listener: `,e)}for(let t of this.pendingEvaluations)e.postMessage(t);return this.pendingEvaluations.length=0,this.forwardInvalidContextSubmissions(e),e}}forwardClientSession(e){this.clientSession.then(t=>{let n={type:`ClientSession`,payload:t};e.postMessage(n)})}forwardInvalidContextSubmissions(e){if(!e)return;let t=this.pendingInvalidContextSubmissions.takeSnapshot();if(t.length===0)return;let n={type:`InvalidContextSubmissions`,payload:{entries:t}};e.postMessage(n)}async updateContext(e){if(this.closePromise)return;let t={type:`UpdateContext`,payload:{context:e}};this.startWorker()?.postMessage(t)}evaluatedConfig(e){if(this.turnedOff)return;let t={type:`EvaluatedConfigEvent`,payload:this.sanitizeEvaluatedConfigEvent(e)};if(this.worker){this.worker.postMessage(t);return}this.pendingEvaluations.length>=this.pendingEvaluationLimit&&this.pendingEvaluations.shift(),this.pendingEvaluations.push(t)}recordInvalidContext(e){this.pendingInvalidContextSubmissions.record(e),this.forwardInvalidContextSubmissions(this.worker)}sanitizeEvaluatedConfigEvent(e){return{...e,defaultValue:t({value:e.defaultValue,type:e.type}),evaluatedValue:t({value:e.evaluatedValue,valueId:e.evaluatedValueId,type:e.type})}}handleWorkerEvent(e){if(e.type===`Closed`){this.finishClose();return}if(!e.payload?.level||!e.payload?.message)return;let{level:t,message:n,args:r}=e.payload;switch(t){case`debug`:this.logger.debug(n,...r);break;case`info`:this.logger.info(n,...r);break;case`warn`:this.logger.warn(n,...r);break;case`error`:this.logger.error(n,...r);break}}flush(){this.worker?.postMessage({type:`Flush`})}close(){return this.closePromise?this.closePromise:this.performClose()}performClose(){let e=this.worker;if(!e)return this.pendingEvaluations.length=0,this.closePromise=Promise.resolve(),this.closePromise;try{document.removeEventListener(`visibilitychange`,this.visibilityHandler)}catch(e){this.logger.warn(`[WebWorkerTelemetryClient] Could not remove 'visibilitychange' listener: `,e)}return this.closePromise=new Promise(t=>{this.closeResolve=t,this.closeTimer=setTimeout(()=>{this.logger.warn(`[WebWorkerTelemetryClient] Timed out waiting for the telemetry worker to close. Terminating the worker.`),this.finishClose()},this.workerCloseTimeout),e.postMessage({type:`Close`})}),this.closePromise}finishClose(){clearTimeout(this.closeTimer),this.closeTimer=void 0,this.worker?.terminate(),this.closeResolve?.()}};const i=(e,t)=>{let n=BigInt(0),r=BigInt(62),i=Array.from(e).map(e=>e.toString(16).padStart(2,`0`)).join(``),a=BigInt(`0x`+i),o=``;for(;a>n;)o=`0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz`[Number(a%r)]+o,a/=r;return o.padStart(t,`0`)},a=Math.ceil(128/Math.log2(62)),o=new TextEncoder,s=async e=>{if(typeof crypto>`u`||crypto.subtle==null)return;let t=await crypto.subtle.digest(`SHA-256`,o.encode(e?.toString()??``));return i(new Uint8Array(t,0,16),a)},c=t=>{let n=e.i();if(!n)return;let r=t.then(t=>e.n+t);return{read:async()=>n.getItem(await r),write:async e=>n.setItem(await r,e),remove:async()=>n.removeItem(await r),sizeLimit:()=>e.r}},l=e=>Array.from(e,e=>e.toString(16).padStart(2,`0`)).join(``),u=()=>{if(!(typeof crypto>`u`||crypto.subtle==null))return async e=>{let t=await crypto.subtle.digest(`SHA-256`,new TextEncoder().encode(e));return l(new Uint8Array(t))}},d=(t,n,i)=>e.t.from(({clientSdkKey:t,baseUrl:i,logger:a,metadata:o,clientSession:c})=>new r({sdkKey:t,sdkIdentity:{sdkName:n.sdkName,sdkVersion:n.sdkVersion},metaContext:{appName:o?.appName,appVersion:o?.appVersion},logger:a,baseUrl:i,urlFactory:e.a,valueIdGenerator:s,clientSession:c}),t,n,i,{sha256HexDigest:u(),platformCachingProvider:c}),f={sdkName:`js-client-sdk`,sdkVersion:`1.10.0`};function p(e,t){return d(e,f,t)}const m=(t,n)=>e.s(t,n);exports.ConfigDirectorInitializationError=e.d,exports.createClient=p,exports.createConsoleLogger=m;

package/dist/configdirector-client.d.cts

@@ -1,4 +1,4 @@
-import { _ as ConfigDirectorLoggingLevel, a as CachingProvider, c as OfflineClientOptions, g as ConfigDirectorLogger, h as ConfigDirectorLogMessageDecorator, i as CachingOptions, l as OfflineValue, m as ConfigDirectorContext, n as ConfigDirectorInitializationError, o as ConfigDirectorClient, r as ConfigDirectorValidationError, s as ConfigDirectorClientOptions, t as ConfigDirectorConnectionError, u as OfflineValues, v as ConfigValueType } from "./errors-s1a-WKkm.cjs";
+import { _ as ConfigDirectorLoggingLevel, a as CachingProvider, b as EvaluationReason, c as OfflineClientOptions, g as ConfigDirectorLogger, h as ConfigDirectorLogMessageDecorator, i as CachingOptions, l as OfflineValue, m as ConfigDirectorContext, n as ConfigDirectorInitializationError, o as ConfigDirectorClient, r as ConfigDirectorValidationError, s as ConfigDirectorClientOptions, t as ConfigDirectorConnectionError, u as OfflineValues, v as ConfigEvaluation, y as ConfigValueType } from "./errors-BUWbQes2.cjs";
 
 //#region ../shared/src/logger.d.ts
 declare class DefaultConsoleLogger implements ConfigDirectorLogger {
@@ -47,5 +47,5 @@ declare function createClient(clientSdkKey: string, clientOptions?: ConfigDirect
 declare function createClient(clientOptions: OfflineClientOptions): ConfigDirectorClient;
 declare const createConsoleLogger: (level: ConfigDirectorLoggingLevel, messageDecorator?: ConfigDirectorLogMessageDecorator) => DefaultConsoleLogger;
 //#endregion
-export { type CachingOptions, type CachingProvider, type ConfigDirectorClient, type ConfigDirectorClientOptions, type ConfigDirectorConnectionError, type ConfigDirectorContext, ConfigDirectorInitializationError, type ConfigDirectorLogMessageDecorator, type ConfigDirectorLogger, type ConfigDirectorLoggingLevel, type ConfigDirectorValidationError, type ConfigValueType, type OfflineClientOptions, type OfflineValue, type OfflineValues, createClient, createConsoleLogger };
+export { type CachingOptions, type CachingProvider, type ConfigDirectorClient, type ConfigDirectorClientOptions, type ConfigDirectorConnectionError, type ConfigDirectorContext, ConfigDirectorInitializationError, type ConfigDirectorLogMessageDecorator, type ConfigDirectorLogger, type ConfigDirectorLoggingLevel, type ConfigDirectorValidationError, type ConfigEvaluation, type ConfigValueType, type EvaluationReason, type OfflineClientOptions, type OfflineValue, type OfflineValues, createClient, createConsoleLogger };
 //# sourceMappingURL=configdirector-client.d.cts.map

package/dist/configdirector-client.d.mts

@@ -1,4 +1,4 @@
-import { _ as ConfigDirectorLoggingLevel, a as CachingProvider, c as OfflineClientOptions, g as ConfigDirectorLogger, h as ConfigDirectorLogMessageDecorator, i as CachingOptions, l as OfflineValue, m as ConfigDirectorContext, n as ConfigDirectorInitializationError, o as ConfigDirectorClient, r as ConfigDirectorValidationError, s as ConfigDirectorClientOptions, t as ConfigDirectorConnectionError, u as OfflineValues, v as ConfigValueType } from "./errors-K27PrStP.mjs";
+import { _ as ConfigDirectorLoggingLevel, a as CachingProvider, b as EvaluationReason, c as OfflineClientOptions, g as ConfigDirectorLogger, h as ConfigDirectorLogMessageDecorator, i as CachingOptions, l as OfflineValue, m as ConfigDirectorContext, n as ConfigDirectorInitializationError, o as ConfigDirectorClient, r as ConfigDirectorValidationError, s as ConfigDirectorClientOptions, t as ConfigDirectorConnectionError, u as OfflineValues, v as ConfigEvaluation, y as ConfigValueType } from "./errors-CkIP6urQ.mjs";
 
 //#region ../shared/src/logger.d.ts
 declare class DefaultConsoleLogger implements ConfigDirectorLogger {
@@ -47,5 +47,5 @@ declare function createClient(clientSdkKey: string, clientOptions?: ConfigDirect
 declare function createClient(clientOptions: OfflineClientOptions): ConfigDirectorClient;
 declare const createConsoleLogger: (level: ConfigDirectorLoggingLevel, messageDecorator?: ConfigDirectorLogMessageDecorator) => DefaultConsoleLogger;
 //#endregion
-export { type CachingOptions, type CachingProvider, type ConfigDirectorClient, type ConfigDirectorClientOptions, type ConfigDirectorConnectionError, type ConfigDirectorContext, ConfigDirectorInitializationError, type ConfigDirectorLogMessageDecorator, type ConfigDirectorLogger, type ConfigDirectorLoggingLevel, type ConfigDirectorValidationError, type ConfigValueType, type OfflineClientOptions, type OfflineValue, type OfflineValues, createClient, createConsoleLogger };
+export { type CachingOptions, type CachingProvider, type ConfigDirectorClient, type ConfigDirectorClientOptions, type ConfigDirectorConnectionError, type ConfigDirectorContext, ConfigDirectorInitializationError, type ConfigDirectorLogMessageDecorator, type ConfigDirectorLogger, type ConfigDirectorLoggingLevel, type ConfigDirectorValidationError, type ConfigEvaluation, type ConfigValueType, type EvaluationReason, type OfflineClientOptions, type OfflineValue, type OfflineValues, createClient, createConsoleLogger };
 //# sourceMappingURL=configdirector-client.d.mts.map

package/dist/configdirector-client.mjs

@@ -1,2 +1,2 @@
-import{a as e,f as t,i as n,n as r,r as i,s as a,t as o,u as s}from"./DefaultConfigDirectorClient-D6d8ZpDr.mjs";const c=e=>{var t;if(e.type===`json`||e.type==null&&typeof e.value==`object`){if(e.valueId)return{valueId:e.valueId,type:`json`};try{return{value:JSON.stringify(e.value),type:`json`}}catch(t){return{value:e.value.toString(),type:`json`}}}let n=(t=e.value)==null?void 0:t.toString();return n&&n.length<=500?{value:n}:e.valueId?{valueId:e.valueId}:{value:n}};var l=class{constructor(){this.countsByKindSample=new Map,this.countBeyondSampleLimit=0}record(e){return this.startTime!=null||(this.startTime=new Date),this.add(e,1)}absorb(e){for(let t of e)(this.startTime===void 0||t.startTime<this.startTime)&&(this.startTime=t.startTime),this.add(t.event.kindSample,t.count)}add(e,t){if(e!==void 0){let n=this.countsByKindSample.get(e);if(n!==void 0)return this.countsByKindSample.set(e,n+t),`known-kind-sample`;if(this.countsByKindSample.size<20)return this.countsByKindSample.set(e,t),`new-kind-sample`}let n=this.countBeyondSampleLimit===0;return this.countBeyondSampleLimit+=t,n?`first-beyond-sample-limit`:`beyond-sample-limit`}takeSnapshot(){var e;let t=new Date,n=(e=this.startTime)==null?t:e,r=(e,r)=>({startTime:n,endTime:t,count:e,event:{reason:`invalid-context-kind`,kindSample:r}}),i=Array.from(this.countsByKindSample,([e,t])=>r(t,e)),a=this.countBeyondSampleLimit>0?[...i,r(this.countBeyondSampleLimit)]:i;return this.clear(),a}clear(){this.countsByKindSample.clear(),this.countBeyondSampleLimit=0,this.startTime=void 0}},u=class{constructor(e){var t,n,r,i;this.turnedOff=!1,this.pendingEvaluations=[],this.pendingInvalidContextSubmissions=new l,this.logger=e.logger,this.workerCloseTimeout=(t=e.workerCloseTimeout)==null?6e3:t,this.pendingEvaluationLimit=(n=e.evaluationQueueLimit)==null?1e3:n,this.clientSession=e.clientSession,this.initializeMessage={type:`Initialize`,payload:{sdkKey:e.sdkKey,sdkIdentity:e.sdkIdentity,metaContext:e.metaContext,baseUrl:e.baseUrl.toString(),evaluationQueueLimit:this.pendingEvaluationLimit,initialFlushIntervalDelay:(r=e.initialFlushIntervalDelay)==null?5e3:r,flushIntervalDelay:(i=e.flushIntervalDelay)==null?3e4:i}},this.visibilityHandler=()=>{document.visibilityState===`hidden`&&this.flush()}}createWorkerOrTurnOff(){if(typeof Worker>`u`){this.turnOff(`[WebWorkerTelemetryClient] Telemetry is off because Web Workers are not available in this environment.`);return}try{return new Worker(URL.createObjectURL(new Blob(["(function(){let e=async(e,t)=>e.valueId?{valueId:e.valueId}:e.value?e.value.length<=500&&e.type!=`json`?{value:e.value}:{valueId:await t(e.value)}:e,t=e=>{let t=Object.keys(e);if(t.length==0)return!0;for(let n of t)if((e[n]?.length??0)>0)return!1;return!0},n=e=>{if(!e)return!0;let t=Object.keys(e);if(t.length==0)return!0;for(let n of t)if((e[n]??0)>0)return!1;return!0},r=async(e,t,n,r)=>{let i=new AbortController,a=setTimeout(()=>{r.debug(`[fetchWithTimeout] Reached timeout, aborting request`),i.abort()},e);try{let e=await fetch(typeof t==`string`||t instanceof Request?t:t.toString(),{...n,signal:i.signal});return clearTimeout(a),e}catch(e){throw r.warn(`[fetchWithTimeout] Fetch error: `,e),clearTimeout(a),e}},i=e=>e?.name===`NotAllowedError`?!0:e instanceof TypeError;var a=class{constructor(e){this.executeRequests=!0,this.sdkKey=e.sdkKey,this.logger=e.logger,this.sdkIdentity=e.sdkIdentity,this.metaContext=e.metaContext,this.url=e.urlFactory(`client/telemetry/v1`,e.baseUrl),this.clientSession=e.clientSession}async report({context:e,discreteEvents:t,aggregatedEvents:n,droppedEvents:r}){if(!this.executeRequests)return{success:!1,fatalError:!0};let{instanceId:i}=await this.clientSession,a={clientSdkKey:this.sdkKey,instanceId:i,metaContext:{sdkName:this.sdkIdentity.sdkName,sdkVersion:this.sdkIdentity.sdkVersion,appName:this.metaContext.appName,appVersion:this.metaContext.appVersion},context:e,discreteEvents:t,aggregatedEvents:n,droppedEvents:r};if(this.isReportEmpty(a))return{success:!0,fatalError:!1};let o=await this.sendReport(a);return o.fatalError&&(this.executeRequests=!1),o}isReportEmpty(e){return t(e.discreteEvents)&&t(e.aggregatedEvents)&&n(e.droppedEvents)}async sendReport(e){try{let t=await r(5e3,this.url,{method:`POST`,body:JSON.stringify(e),keepalive:!0},this.logger),n=this.isStatusFatal(t.status);return n&&this.logger.warn(`[EventReporter] Received a fatal status response (${t.status}) from the telemetry endpoint. No more telemetry data will be sent.`),{success:t.ok,fatalError:n}}catch(e){let t=i(e);return this.logger.warn(`[EventReporter] Error attempting to send telemetry data: ${e}`,{error:e}),{success:!1,fatalError:t}}}isStatusFatal(e){return!!e&&e>=400&&e<500&&e!=429}},o=class{aggregate(e){if(e.events.length==0)return[];let t=new Map;for(let n of e.events){let e=JSON.stringify(n),r=t.get(e)?.count||0;t.set(e,{event:n,count:r+1})}return Array.from(t).map(([,t])=>({startTime:e.startTime,endTime:e.endTime,count:t.count,event:t.event}))}},s=class{constructor(e){this._events=[],this._droppedEventCount=0,this.limit=e??1e3}get events(){return this._events}get reachedLimit(){return this._events.length>=this.limit}get droppedEventCount(){return this._droppedEventCount}push(...e){this.startTime||=new Date;let t=Math.max(0,e.length-this.limit),n=e.slice(t,e.length);if(this._droppedEventCount+=t,this._events.length+n.length>this.limit){let e=this._events.length+n.length-this.limit;this._events.splice(0,e),this._droppedEventCount+=e}return this._events.push(...n)}takeSnapshot(){let e=new Date,t=this.startTime??e,n=this._events.splice(0),r=this._droppedEventCount;return this.startTime=void 0,this._droppedEventCount=0,{startTime:t,endTime:e,events:n,droppedCount:r}}clear(){this._events=[],this.startTime=void 0,this._droppedEventCount=0}},c=class{constructor(e){this.aggregator=new o,this.collectEvents=!0,this.started=!1,this.logger=e.logger,this.evaluationEventQueue=new s(e.evaluationQueueLimit??1e3),this.flushIntervalDelay=e.flushIntervalDelay??3e4,this.initialFlushIntervalDelay=e.initialFlushIntervalDelay??5e3}start(){this.started||!this.collectEvents||(this.started=!0,this.flushTimeout=setTimeout(()=>this.flushAndScheduleNext(),this.initialFlushIntervalDelay))}async flushAndScheduleNext(){if(!this.collectEvents)return;let e;try{e=await this.flush()}catch(t){this.logger.warn(`[TelemetryEventCollector] Error flushing telemetry events: `,t),e={success:!1,fatalError:!1}}e.fatalError?(this.collectEvents=!1,this.close(),this.logger.warn(`[TelemetryEventCollector] Received a fatal error from telemetry collection. No longer collecting events.`)):this.collectEvents&&(this.cancelScheduledFlush(),this.flushTimeout=setTimeout(()=>this.flushAndScheduleNext(),this.flushIntervalDelay))}cancelScheduledFlush(){clearTimeout(this.flushTimeout)}async close(){this.collectEvents=!1,clearTimeout(this.flushTimeout);try{await this.flush()}catch(e){this.logger.warn(`[TelemetryEventCollector] Error flushing telemetry events during close: `,e)}this.evaluationEventQueue.clear()}dispose(){this.close()}},l=class{constructor(e){this.valueIdGenerator=e,this.valueIdGenerator=e}async process(t){let n=await Promise.all(t.events.map(async t=>({...t,defaultValue:await e(t.defaultValue,this.valueIdGenerator),evaluatedValue:await e(t.evaluatedValue,this.valueIdGenerator)})));return{...t,events:n}}},u=class{constructor(){this.countsByKindSample=new Map,this.countBeyondSampleLimit=0}record(e){return this.startTime??=new Date,this.add(e,1)}absorb(e){for(let t of e)(this.startTime===void 0||t.startTime<this.startTime)&&(this.startTime=t.startTime),this.add(t.event.kindSample,t.count)}add(e,t){if(e!==void 0){let n=this.countsByKindSample.get(e);if(n!==void 0)return this.countsByKindSample.set(e,n+t),`known-kind-sample`;if(this.countsByKindSample.size<20)return this.countsByKindSample.set(e,t),`new-kind-sample`}let n=this.countBeyondSampleLimit===0;return this.countBeyondSampleLimit+=t,n?`first-beyond-sample-limit`:`beyond-sample-limit`}takeSnapshot(){let e=new Date,t=this.startTime??e,n=(n,r)=>({startTime:t,endTime:e,count:n,event:{reason:`invalid-context-kind`,kindSample:r}}),r=Array.from(this.countsByKindSample,([e,t])=>n(t,e)),i=this.countBeyondSampleLimit>0?[...r,n(this.countBeyondSampleLimit)]:r;return this.clear(),i}clear(){this.countsByKindSample.clear(),this.countBeyondSampleLimit=0,this.startTime=void 0}},d=class extends c{constructor(e){super(e),this.invalidContextSubmissions=new u,this.reporter=new a(e),this.evaluationEventSnapshotPreprocessor=new l(e.valueIdGenerator)}async updateContext(e){this.cancelScheduledFlush(),await this.flush(),this._context=e,await this.flushAndScheduleNext()}evaluatedConfig(e){this.collectEvents&&this.evaluationEventQueue.push(e)}recordInvalidContext(e){this.invalidContextSubmissions.record(e)}absorbInvalidContextSubmissions(e){this.invalidContextSubmissions.absorb(e)}async forceFlush(){this.cancelScheduledFlush(),await this.flushAndScheduleNext()}async flush(){if(!this.reporter)return{success:!1,fatalError:!1};let e=await this.evaluationEventSnapshotPreprocessor.process(this.evaluationEventQueue.takeSnapshot());return await this.reporter?.report({context:this._context,discreteEvents:{},aggregatedEvents:{evaluatedConfig:this.aggregator.aggregate(e),invalidContext:this.invalidContextSubmissions.takeSnapshot()},droppedEvents:{evaluatedConfig:e.droppedCount}})}};let f=(e,t)=>new URL(e,t?.toString()),p=(e,t)=>{let n=BigInt(0),r=BigInt(62),i=Array.from(e).map(e=>e.toString(16).padStart(2,`0`)).join(``),a=BigInt(`0x`+i),o=``;for(;a>n;)o=`0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz`[Number(a%r)]+o,a/=r;return o.padStart(t,`0`)},m=Math.ceil(128/Math.log2(62)),h=new TextEncoder,g=async e=>{if(typeof crypto>`u`||crypto.subtle==null)return;let t=await crypto.subtle.digest(`SHA-256`,h.encode(e?.toString()??``));return p(new Uint8Array(t,0,16),m)},_,v,y=new Promise(e=>{v=e}),b=(e,t,...n)=>({type:`Log`,payload:{level:e,message:t,args:n}}),x=e=>{try{self.postMessage(e)}catch{self.postMessage(b(e.payload.level,e.payload.message))}},S={debug:function(e,...t){x(b(`debug`,e,t))},info:function(e,...t){x(b(`info`,e,t))},warn:function(e,...t){x(b(`warn`,e,t))},error:function(e,...t){x(b(`error`,e,t))}};addEventListener(`message`,e=>{let t=e.data;if(t.type!=`Initialize`&&!_){S.info(`[TelemetryWorker] Ignoring ${t.type} because no collector is configured`);return}switch(S.debug(`[TelemetryWorker] Received '${t.type}' event:`,t),t.type){case`Initialize`:if(_){S.warn(`[TelemetryWorker] Received a duplicate Initialize event, ignoring it`);break}_=new d({...t.payload,baseUrl:f(t.payload.baseUrl),urlFactory:f,valueIdGenerator:g,logger:S,clientSession:y}),_.start();break;case`ClientSession`:v(t.payload);break;case`EvaluatedConfigEvent`:_?.evaluatedConfig(t.payload);break;case`InvalidContextSubmissions`:_?.absorbInvalidContextSubmissions(t.payload.entries);break;case`UpdateContext`:_?.updateContext(t.payload.context);break;case`Flush`:_?.forceFlush();break;case`Close`:(_?.close()??Promise.resolve()).then(()=>{self.postMessage({type:`Closed`}),self.close()});break}})})();"],{type:`application/javascript`})))}catch(e){this.turnOff(`[WebWorkerTelemetryClient] Telemetry is off because the telemetry Web Worker could not be created: `,e);return}}turnOff(e,...t){this.turnedOff=!0,this.pendingEvaluations.length=0,this.logger.warn(e,...t)}startWorker(){if(this.worker||this.turnedOff)return this.worker;let e=this.createWorkerOrTurnOff();if(e){e.onmessage=e=>{this.handleWorkerEvent(e.data)},e.postMessage(this.initializeMessage),this.forwardClientSession(e),this.worker=e;try{document.addEventListener(`visibilitychange`,this.visibilityHandler)}catch(e){this.logger.warn(`[TelemetryEventCollector] Could not configure 'visibilitychange' listener: `,e)}for(let t of this.pendingEvaluations)e.postMessage(t);return this.pendingEvaluations.length=0,this.forwardInvalidContextSubmissions(e),e}}forwardClientSession(e){this.clientSession.then(t=>{let n={type:`ClientSession`,payload:t};e.postMessage(n)})}forwardInvalidContextSubmissions(e){if(!e)return;let t=this.pendingInvalidContextSubmissions.takeSnapshot();if(t.length===0)return;let n={type:`InvalidContextSubmissions`,payload:{entries:t}};e.postMessage(n)}async updateContext(e){var t=this,n;if(t.closePromise)return;let r={type:`UpdateContext`,payload:{context:e}};(n=t.startWorker())==null||n.postMessage(r)}evaluatedConfig(e){if(this.turnedOff)return;let t={type:`EvaluatedConfigEvent`,payload:this.sanitizeEvaluatedConfigEvent(e)};if(this.worker){this.worker.postMessage(t);return}this.pendingEvaluations.length>=this.pendingEvaluationLimit&&this.pendingEvaluations.shift(),this.pendingEvaluations.push(t)}recordInvalidContext(e){this.pendingInvalidContextSubmissions.record(e),this.forwardInvalidContextSubmissions(this.worker)}sanitizeEvaluatedConfigEvent(e){return s(s({},e),{},{defaultValue:c({value:e.defaultValue,type:e.type}),evaluatedValue:c({value:e.evaluatedValue,valueId:e.evaluatedValueId,type:e.type})})}handleWorkerEvent(e){var t,n;if(e.type===`Closed`){this.finishClose();return}if(!((t=e.payload)!=null&&t.level)||!((n=e.payload)!=null&&n.message))return;let{level:r,message:i,args:a}=e.payload;switch(r){case`debug`:this.logger.debug(i,...a);break;case`info`:this.logger.info(i,...a);break;case`warn`:this.logger.warn(i,...a);break;case`error`:this.logger.error(i,...a);break}}flush(){var e;(e=this.worker)==null||e.postMessage({type:`Flush`})}close(){return this.closePromise?this.closePromise:this.performClose()}performClose(){let e=this.worker;if(!e)return this.pendingEvaluations.length=0,this.closePromise=Promise.resolve(),this.closePromise;try{document.removeEventListener(`visibilitychange`,this.visibilityHandler)}catch(e){this.logger.warn(`[WebWorkerTelemetryClient] Could not remove 'visibilitychange' listener: `,e)}return this.closePromise=new Promise(t=>{this.closeResolve=t,this.closeTimer=setTimeout(()=>{this.logger.warn(`[WebWorkerTelemetryClient] Timed out waiting for the telemetry worker to close. Terminating the worker.`),this.finishClose()},this.workerCloseTimeout),e.postMessage({type:`Close`})}),this.closePromise}finishClose(){var e,t;clearTimeout(this.closeTimer),this.closeTimer=void 0,(e=this.worker)==null||e.terminate(),(t=this.closeResolve)==null||t.call(this)}};const d=(e,t)=>{let n=BigInt(0),r=BigInt(62),i=Array.from(e).map(e=>e.toString(16).padStart(2,`0`)).join(``),a=BigInt(`0x`+i),o=``;for(;a>n;)o=`0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz`[Number(a%r)]+o,a/=r;return o.padStart(t,`0`)},f=Math.ceil(128/Math.log2(62)),p=new TextEncoder,m=async e=>{var t;if(typeof crypto>`u`||crypto.subtle==null)return;let n=await crypto.subtle.digest(`SHA-256`,p.encode((t=e==null?void 0:e.toString())==null?``:t));return d(new Uint8Array(n,0,16),f)},h=e=>Array.from(e,e=>e.toString(16).padStart(2,`0`)).join(``),g=async e=>{let t=await crypto.subtle.digest(`SHA-256`,new TextEncoder().encode(e));return r+h(new Uint8Array(t))},_=()=>typeof crypto<`u`&&crypto.subtle!=null,v=e=>{let t=n();if(!t||!_())return;let r=g(e);return{read:async()=>t.getItem(await r),write:async e=>t.setItem(await r,e),remove:async()=>t.removeItem(await r),sizeLimit:()=>i}},y=(t,n,r)=>o.from(({clientSdkKey:t,baseUrl:r,logger:i,metadata:a,clientSession:o})=>new u({sdkKey:t,sdkIdentity:{sdkName:n.sdkName,sdkVersion:n.sdkVersion},metaContext:{appName:a==null?void 0:a.appName,appVersion:a==null?void 0:a.appVersion},logger:i,baseUrl:r,urlFactory:e,valueIdGenerator:m,clientSession:o}),t,n,r,{platformCachingProvider:v}),b={sdkName:`js-client-sdk`,sdkVersion:`1.9.1`};function x(e,t){return y(e,b,t)}const S=(e,t)=>a(e,t);export{t as ConfigDirectorInitializationError,x as createClient,S as createConsoleLogger};
+import{a as e,f as t,i as n,n as r,r as i,s as a,t as o,u as s}from"./DefaultConfigDirectorClient--uR1wXjn.mjs";const c=e=>{var t;if(e.type===`json`||e.type==null&&typeof e.value==`object`){if(e.valueId)return{valueId:e.valueId,type:`json`};try{return{value:JSON.stringify(e.value),type:`json`}}catch(t){return{value:e.value.toString(),type:`json`}}}let n=(t=e.value)==null?void 0:t.toString();return n&&n.length<=500?{value:n}:e.valueId?{valueId:e.valueId}:{value:n}};var l=class{constructor(){this.countsByKindSample=new Map,this.countBeyondSampleLimit=0}record(e){return this.startTime!=null||(this.startTime=new Date),this.add(e,1)}absorb(e){for(let t of e)(this.startTime===void 0||t.startTime<this.startTime)&&(this.startTime=t.startTime),this.add(t.event.kindSample,t.count)}add(e,t){if(e!==void 0){let n=this.countsByKindSample.get(e);if(n!==void 0)return this.countsByKindSample.set(e,n+t),`known-kind-sample`;if(this.countsByKindSample.size<20)return this.countsByKindSample.set(e,t),`new-kind-sample`}let n=this.countBeyondSampleLimit===0;return this.countBeyondSampleLimit+=t,n?`first-beyond-sample-limit`:`beyond-sample-limit`}takeSnapshot(){var e;let t=new Date,n=(e=this.startTime)==null?t:e,r=(e,r)=>({startTime:n,endTime:t,count:e,event:{reason:`invalid-context-kind`,kindSample:r}}),i=Array.from(this.countsByKindSample,([e,t])=>r(t,e)),a=this.countBeyondSampleLimit>0?[...i,r(this.countBeyondSampleLimit)]:i;return this.clear(),a}clear(){this.countsByKindSample.clear(),this.countBeyondSampleLimit=0,this.startTime=void 0}},u=class{constructor(e){var t,n,r,i;this.turnedOff=!1,this.pendingEvaluations=[],this.pendingInvalidContextSubmissions=new l,this.logger=e.logger,this.workerCloseTimeout=(t=e.workerCloseTimeout)==null?6e3:t,this.pendingEvaluationLimit=(n=e.evaluationQueueLimit)==null?1e3:n,this.clientSession=e.clientSession,this.initializeMessage={type:`Initialize`,payload:{sdkKey:e.sdkKey,sdkIdentity:e.sdkIdentity,metaContext:e.metaContext,baseUrl:e.baseUrl.toString(),evaluationQueueLimit:this.pendingEvaluationLimit,initialFlushIntervalDelay:(r=e.initialFlushIntervalDelay)==null?5e3:r,flushIntervalDelay:(i=e.flushIntervalDelay)==null?3e4:i}},this.visibilityHandler=()=>{document.visibilityState===`hidden`&&this.flush()}}createWorkerOrTurnOff(){if(typeof Worker>`u`){this.turnOff(`[WebWorkerTelemetryClient] Telemetry is off because Web Workers are not available in this environment.`);return}try{return new Worker(URL.createObjectURL(new Blob(["(function(){let e=async(e,t)=>e.valueId?{valueId:e.valueId}:e.value?e.value.length<=500&&e.type!=`json`?{value:e.value}:{valueId:await t(e.value)}:e,t=e=>{let t=Object.keys(e);if(t.length==0)return!0;for(let n of t)if((e[n]?.length??0)>0)return!1;return!0},n=e=>{if(!e)return!0;let t=Object.keys(e);if(t.length==0)return!0;for(let n of t)if((e[n]??0)>0)return!1;return!0},r=async(e,t,n,r)=>{let i=new AbortController,a=setTimeout(()=>{r.debug(`[fetchWithTimeout] Reached timeout, aborting request`),i.abort()},e);try{let e=await fetch(typeof t==`string`||t instanceof Request?t:t.toString(),{...n,signal:i.signal});return clearTimeout(a),e}catch(e){throw r.warn(`[fetchWithTimeout] Fetch error: `,e),clearTimeout(a),e}},i=e=>e?.name===`NotAllowedError`?!0:e instanceof TypeError;var a=class{constructor(e){this.executeRequests=!0,this.sdkKey=e.sdkKey,this.logger=e.logger,this.sdkIdentity=e.sdkIdentity,this.metaContext=e.metaContext,this.url=e.urlFactory(`client/telemetry/v1`,e.baseUrl),this.clientSession=e.clientSession}async report({context:e,discreteEvents:t,aggregatedEvents:n,droppedEvents:r}){if(!this.executeRequests)return{success:!1,fatalError:!0};let{instanceId:i}=await this.clientSession,a={clientSdkKey:this.sdkKey,instanceId:i,metaContext:{sdkName:this.sdkIdentity.sdkName,sdkVersion:this.sdkIdentity.sdkVersion,appName:this.metaContext.appName,appVersion:this.metaContext.appVersion},context:e,discreteEvents:t,aggregatedEvents:n,droppedEvents:r};if(this.isReportEmpty(a))return{success:!0,fatalError:!1};let o=await this.sendReport(a);return o.fatalError&&(this.executeRequests=!1),o}isReportEmpty(e){return t(e.discreteEvents)&&t(e.aggregatedEvents)&&n(e.droppedEvents)}async sendReport(e){try{let t=await r(5e3,this.url,{method:`POST`,body:JSON.stringify(e),keepalive:!0},this.logger),n=this.isStatusFatal(t.status);return n&&this.logger.warn(`[EventReporter] Received a fatal status response (${t.status}) from the telemetry endpoint. No more telemetry data will be sent.`),{success:t.ok,fatalError:n}}catch(e){let t=i(e);return this.logger.warn(`[EventReporter] Error attempting to send telemetry data: ${e}`,{error:e}),{success:!1,fatalError:t}}}isStatusFatal(e){return!!e&&e>=400&&e<500&&e!=429}},o=class{aggregate(e){if(e.events.length==0)return[];let t=new Map;for(let n of e.events){let e=JSON.stringify(n),r=t.get(e)?.count||0;t.set(e,{event:n,count:r+1})}return Array.from(t).map(([,t])=>({startTime:e.startTime,endTime:e.endTime,count:t.count,event:t.event}))}},s=class{constructor(e){this._events=[],this._droppedEventCount=0,this.limit=e??1e3}get events(){return this._events}get reachedLimit(){return this._events.length>=this.limit}get droppedEventCount(){return this._droppedEventCount}push(...e){this.startTime||=new Date;let t=Math.max(0,e.length-this.limit),n=e.slice(t,e.length);if(this._droppedEventCount+=t,this._events.length+n.length>this.limit){let e=this._events.length+n.length-this.limit;this._events.splice(0,e),this._droppedEventCount+=e}return this._events.push(...n)}takeSnapshot(){let e=new Date,t=this.startTime??e,n=this._events.splice(0),r=this._droppedEventCount;return this.startTime=void 0,this._droppedEventCount=0,{startTime:t,endTime:e,events:n,droppedCount:r}}clear(){this._events=[],this.startTime=void 0,this._droppedEventCount=0}},c=class{constructor(e){this.aggregator=new o,this.collectEvents=!0,this.started=!1,this.logger=e.logger,this.evaluationEventQueue=new s(e.evaluationQueueLimit??1e3),this.flushIntervalDelay=e.flushIntervalDelay??3e4,this.initialFlushIntervalDelay=e.initialFlushIntervalDelay??5e3}start(){this.started||!this.collectEvents||(this.started=!0,this.flushTimeout=setTimeout(()=>this.flushAndScheduleNext(),this.initialFlushIntervalDelay))}async flushAndScheduleNext(){if(!this.collectEvents)return;let e;try{e=await this.flush()}catch(t){this.logger.warn(`[TelemetryEventCollector] Error flushing telemetry events: `,t),e={success:!1,fatalError:!1}}e.fatalError?(this.collectEvents=!1,this.close(),this.logger.warn(`[TelemetryEventCollector] Received a fatal error from telemetry collection. No longer collecting events.`)):this.collectEvents&&(this.cancelScheduledFlush(),this.flushTimeout=setTimeout(()=>this.flushAndScheduleNext(),this.flushIntervalDelay))}cancelScheduledFlush(){clearTimeout(this.flushTimeout)}async close(){this.collectEvents=!1,clearTimeout(this.flushTimeout);try{await this.flush()}catch(e){this.logger.warn(`[TelemetryEventCollector] Error flushing telemetry events during close: `,e)}this.evaluationEventQueue.clear()}dispose(){this.close()}},l=class{constructor(e){this.valueIdGenerator=e,this.valueIdGenerator=e}async process(t){let n=await Promise.all(t.events.map(async t=>({...t,defaultValue:await e(t.defaultValue,this.valueIdGenerator),evaluatedValue:await e(t.evaluatedValue,this.valueIdGenerator)})));return{...t,events:n}}},u=class{constructor(){this.countsByKindSample=new Map,this.countBeyondSampleLimit=0}record(e){return this.startTime??=new Date,this.add(e,1)}absorb(e){for(let t of e)(this.startTime===void 0||t.startTime<this.startTime)&&(this.startTime=t.startTime),this.add(t.event.kindSample,t.count)}add(e,t){if(e!==void 0){let n=this.countsByKindSample.get(e);if(n!==void 0)return this.countsByKindSample.set(e,n+t),`known-kind-sample`;if(this.countsByKindSample.size<20)return this.countsByKindSample.set(e,t),`new-kind-sample`}let n=this.countBeyondSampleLimit===0;return this.countBeyondSampleLimit+=t,n?`first-beyond-sample-limit`:`beyond-sample-limit`}takeSnapshot(){let e=new Date,t=this.startTime??e,n=(n,r)=>({startTime:t,endTime:e,count:n,event:{reason:`invalid-context-kind`,kindSample:r}}),r=Array.from(this.countsByKindSample,([e,t])=>n(t,e)),i=this.countBeyondSampleLimit>0?[...r,n(this.countBeyondSampleLimit)]:r;return this.clear(),i}clear(){this.countsByKindSample.clear(),this.countBeyondSampleLimit=0,this.startTime=void 0}},d=class extends c{constructor(e){super(e),this.invalidContextSubmissions=new u,this.reporter=new a(e),this.evaluationEventSnapshotPreprocessor=new l(e.valueIdGenerator)}async updateContext(e){this.cancelScheduledFlush(),await this.flush(),this._context=e,await this.flushAndScheduleNext()}evaluatedConfig(e){this.collectEvents&&this.evaluationEventQueue.push(e)}recordInvalidContext(e){this.invalidContextSubmissions.record(e)}absorbInvalidContextSubmissions(e){this.invalidContextSubmissions.absorb(e)}async forceFlush(){this.cancelScheduledFlush(),await this.flushAndScheduleNext()}async flush(){if(!this.reporter)return{success:!1,fatalError:!1};let e=await this.evaluationEventSnapshotPreprocessor.process(this.evaluationEventQueue.takeSnapshot());return await this.reporter?.report({context:this._context,discreteEvents:{},aggregatedEvents:{evaluatedConfig:this.aggregator.aggregate(e),invalidContext:this.invalidContextSubmissions.takeSnapshot()},droppedEvents:{evaluatedConfig:e.droppedCount}})}};let f=(e,t)=>new URL(e,t?.toString()),p=(e,t)=>{let n=BigInt(0),r=BigInt(62),i=Array.from(e).map(e=>e.toString(16).padStart(2,`0`)).join(``),a=BigInt(`0x`+i),o=``;for(;a>n;)o=`0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz`[Number(a%r)]+o,a/=r;return o.padStart(t,`0`)},m=Math.ceil(128/Math.log2(62)),h=new TextEncoder,g=async e=>{if(typeof crypto>`u`||crypto.subtle==null)return;let t=await crypto.subtle.digest(`SHA-256`,h.encode(e?.toString()??``));return p(new Uint8Array(t,0,16),m)},_,v,y=new Promise(e=>{v=e}),b=(e,t,...n)=>({type:`Log`,payload:{level:e,message:t,args:n}}),x=e=>{try{self.postMessage(e)}catch{self.postMessage(b(e.payload.level,e.payload.message))}},S={debug:function(e,...t){x(b(`debug`,e,t))},info:function(e,...t){x(b(`info`,e,t))},warn:function(e,...t){x(b(`warn`,e,t))},error:function(e,...t){x(b(`error`,e,t))}};addEventListener(`message`,e=>{let t=e.data;if(t.type!=`Initialize`&&!_){S.info(`[TelemetryWorker] Ignoring ${t.type} because no collector is configured`);return}switch(S.debug(`[TelemetryWorker] Received '${t.type}' event:`,t),t.type){case`Initialize`:if(_){S.warn(`[TelemetryWorker] Received a duplicate Initialize event, ignoring it`);break}_=new d({...t.payload,baseUrl:f(t.payload.baseUrl),urlFactory:f,valueIdGenerator:g,logger:S,clientSession:y}),_.start();break;case`ClientSession`:v(t.payload);break;case`EvaluatedConfigEvent`:_?.evaluatedConfig(t.payload);break;case`InvalidContextSubmissions`:_?.absorbInvalidContextSubmissions(t.payload.entries);break;case`UpdateContext`:_?.updateContext(t.payload.context);break;case`Flush`:_?.forceFlush();break;case`Close`:(_?.close()??Promise.resolve()).then(()=>{self.postMessage({type:`Closed`}),self.close()});break}})})();"],{type:`application/javascript`})))}catch(e){this.turnOff(`[WebWorkerTelemetryClient] Telemetry is off because the telemetry Web Worker could not be created: `,e);return}}turnOff(e,...t){this.turnedOff=!0,this.pendingEvaluations.length=0,this.logger.warn(e,...t)}startWorker(){if(this.worker||this.turnedOff)return this.worker;let e=this.createWorkerOrTurnOff();if(e){e.onmessage=e=>{this.handleWorkerEvent(e.data)},e.postMessage(this.initializeMessage),this.forwardClientSession(e),this.worker=e;try{document.addEventListener(`visibilitychange`,this.visibilityHandler)}catch(e){this.logger.warn(`[TelemetryEventCollector] Could not configure 'visibilitychange' listener: `,e)}for(let t of this.pendingEvaluations)e.postMessage(t);return this.pendingEvaluations.length=0,this.forwardInvalidContextSubmissions(e),e}}forwardClientSession(e){this.clientSession.then(t=>{let n={type:`ClientSession`,payload:t};e.postMessage(n)})}forwardInvalidContextSubmissions(e){if(!e)return;let t=this.pendingInvalidContextSubmissions.takeSnapshot();if(t.length===0)return;let n={type:`InvalidContextSubmissions`,payload:{entries:t}};e.postMessage(n)}async updateContext(e){var t=this,n;if(t.closePromise)return;let r={type:`UpdateContext`,payload:{context:e}};(n=t.startWorker())==null||n.postMessage(r)}evaluatedConfig(e){if(this.turnedOff)return;let t={type:`EvaluatedConfigEvent`,payload:this.sanitizeEvaluatedConfigEvent(e)};if(this.worker){this.worker.postMessage(t);return}this.pendingEvaluations.length>=this.pendingEvaluationLimit&&this.pendingEvaluations.shift(),this.pendingEvaluations.push(t)}recordInvalidContext(e){this.pendingInvalidContextSubmissions.record(e),this.forwardInvalidContextSubmissions(this.worker)}sanitizeEvaluatedConfigEvent(e){return s(s({},e),{},{defaultValue:c({value:e.defaultValue,type:e.type}),evaluatedValue:c({value:e.evaluatedValue,valueId:e.evaluatedValueId,type:e.type})})}handleWorkerEvent(e){var t,n;if(e.type===`Closed`){this.finishClose();return}if(!((t=e.payload)!=null&&t.level)||!((n=e.payload)!=null&&n.message))return;let{level:r,message:i,args:a}=e.payload;switch(r){case`debug`:this.logger.debug(i,...a);break;case`info`:this.logger.info(i,...a);break;case`warn`:this.logger.warn(i,...a);break;case`error`:this.logger.error(i,...a);break}}flush(){var e;(e=this.worker)==null||e.postMessage({type:`Flush`})}close(){return this.closePromise?this.closePromise:this.performClose()}performClose(){let e=this.worker;if(!e)return this.pendingEvaluations.length=0,this.closePromise=Promise.resolve(),this.closePromise;try{document.removeEventListener(`visibilitychange`,this.visibilityHandler)}catch(e){this.logger.warn(`[WebWorkerTelemetryClient] Could not remove 'visibilitychange' listener: `,e)}return this.closePromise=new Promise(t=>{this.closeResolve=t,this.closeTimer=setTimeout(()=>{this.logger.warn(`[WebWorkerTelemetryClient] Timed out waiting for the telemetry worker to close. Terminating the worker.`),this.finishClose()},this.workerCloseTimeout),e.postMessage({type:`Close`})}),this.closePromise}finishClose(){var e,t;clearTimeout(this.closeTimer),this.closeTimer=void 0,(e=this.worker)==null||e.terminate(),(t=this.closeResolve)==null||t.call(this)}};const d=(e,t)=>{let n=BigInt(0),r=BigInt(62),i=Array.from(e).map(e=>e.toString(16).padStart(2,`0`)).join(``),a=BigInt(`0x`+i),o=``;for(;a>n;)o=`0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz`[Number(a%r)]+o,a/=r;return o.padStart(t,`0`)},f=Math.ceil(128/Math.log2(62)),p=new TextEncoder,m=async e=>{var t;if(typeof crypto>`u`||crypto.subtle==null)return;let n=await crypto.subtle.digest(`SHA-256`,p.encode((t=e==null?void 0:e.toString())==null?``:t));return d(new Uint8Array(n,0,16),f)},h=e=>{let t=n();if(!t)return;let a=e.then(e=>r+e);return{read:async()=>t.getItem(await a),write:async e=>t.setItem(await a,e),remove:async()=>t.removeItem(await a),sizeLimit:()=>i}},g=e=>Array.from(e,e=>e.toString(16).padStart(2,`0`)).join(``),_=()=>{if(!(typeof crypto>`u`||crypto.subtle==null))return async e=>{let t=await crypto.subtle.digest(`SHA-256`,new TextEncoder().encode(e));return g(new Uint8Array(t))}},v=(t,n,r)=>o.from(({clientSdkKey:t,baseUrl:r,logger:i,metadata:a,clientSession:o})=>new u({sdkKey:t,sdkIdentity:{sdkName:n.sdkName,sdkVersion:n.sdkVersion},metaContext:{appName:a==null?void 0:a.appName,appVersion:a==null?void 0:a.appVersion},logger:i,baseUrl:r,urlFactory:e,valueIdGenerator:m,clientSession:o}),t,n,r,{sha256HexDigest:_(),platformCachingProvider:h}),y={sdkName:`js-client-sdk`,sdkVersion:`1.10.0`};function b(e,t){return v(e,y,t)}const x=(e,t)=>a(e,t);export{t as ConfigDirectorInitializationError,b as createClient,x as createConsoleLogger};
 //# sourceMappingURL=configdirector-client.mjs.map

package/dist/configdirector-client.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"configdirector-client.mjs","names":[],"sources":["../../shared/src/telemetry/utils.ts","../../shared/src/telemetry/InvalidContextSubmissions.ts","../../js-browser-client/src/telemetry/WebWorkerTelemetryClient.ts","../../shared/src/base62-encoder.ts","../../shared/src/value-id.ts","../../js-browser-client/src/telemetry/value-id-generator.ts","../../js-browser-client/src/local-storage-caching-provider.ts","../../js-browser-client/src/BrowserConfigDirectorClient.ts","../src/api.ts"],"sourcesContent":["import type { ConfigType, ConfigValueType } from \"../types\";\nimport type { ValueIdGenerator, DroppedEvents } from \"./types\";\n\nconst CONFIG_VALUE_MAX_LENGTH = 500;\n\nexport type TelemetryValue = {\n  value?: string;\n  valueId?: string;\n  type?: ConfigType;\n};\n\nexport type TelemetryEvaluationValue<TV extends ConfigValueType> = {\n  value: TV;\n  valueId?: string | null | undefined;\n  type?: ConfigType;\n};\n\nexport const compactTelemetryValue = async (\n  tv: TelemetryValue,\n  valueIdGenerator: ValueIdGenerator,\n): Promise<TelemetryValue> => {\n  if (tv.valueId) {\n    return { valueId: tv.valueId };\n  }\n  if (tv.value) {\n    if (tv.value.length <= CONFIG_VALUE_MAX_LENGTH && tv.type != \"json\") {\n      return { value: tv.value };\n    }\n\n    return { valueId: await valueIdGenerator(tv.value) };\n  }\n\n  return tv;\n};\n\nexport const mapToTelemetryValue = <TV extends ConfigValueType>(\n  ev: TelemetryEvaluationValue<TV>,\n): TelemetryValue => {\n  if (ev.type === \"json\" || (ev.type == null && typeof ev.value === \"object\")) {\n    if (ev.valueId) {\n      return { valueId: ev.valueId, type: \"json\" };\n    }\n    try {\n      const json = JSON.stringify(ev.value);\n      return { value: json, type: \"json\" };\n    } catch {\n      return { value: ev.value.toString(), type: \"json\" };\n    }\n  }\n\n  const stringValue = ev.value?.toString();\n  if (stringValue && stringValue.length <= CONFIG_VALUE_MAX_LENGTH) {\n    return { value: stringValue };\n  }\n\n  return ev.valueId ? { valueId: ev.valueId } : { value: stringValue };\n};\n\nexport const djb2Hash = (data: string): string => {\n  const hash = djb2(new TextEncoder().encode(data));\n  return hash.toString(16).padStart(8, \"0\");\n};\n\nconst djb2 = (bytes: Uint8Array): number => {\n  let hash = 5381;\n  for (let i = 0; i < bytes.length; i++) {\n    hash = (hash << 5) + hash + (bytes[i] ?? 0);\n    hash = hash >>> 0;\n  }\n  return hash;\n};\n\nexport const isEventListEmpty = <T extends Record<string | symbol, any[]>>(eventList: T): boolean => {\n  const keys = Object.keys(eventList);\n  if (keys.length == 0) {\n    return true;\n  }\n\n  for (const key of keys) {\n    if ((eventList[key]?.length ?? 0) > 0) {\n      return false;\n    }\n  }\n\n  return true;\n};\n\nexport const isDroppedEventsEmpty = (droppedEvents?: DroppedEvents): boolean => {\n  if (!droppedEvents) {\n    return true;\n  }\n  const keys = Object.keys(droppedEvents);\n  if (keys.length == 0) {\n    return true;\n  }\n\n  for (const key of keys) {\n    if ((droppedEvents[key] ?? 0) > 0) {\n      return false;\n    }\n  }\n\n  return true;\n};\n","import type { InvalidContextEvent } from \"./telemetry-events\";\nimport type { AggregatedEvent } from \"./types\";\n\nexport const DISTINCT_KIND_SAMPLE_LIMIT = 20;\n\nexport type InvalidContextRecording =\n  | \"new-kind-sample\"\n  | \"known-kind-sample\"\n  | \"first-beyond-sample-limit\"\n  | \"beyond-sample-limit\";\n\nexport class InvalidContextSubmissions {\n  private readonly countsByKindSample = new Map<string, number>();\n  private countBeyondSampleLimit = 0;\n  private startTime: Date | undefined;\n\n  public record(kindSample: string): InvalidContextRecording {\n    this.startTime ??= new Date();\n    return this.add(kindSample, 1);\n  }\n\n  public absorb(entries: AggregatedEvent<InvalidContextEvent>[]): void {\n    for (const entry of entries) {\n      if (this.startTime === undefined || entry.startTime < this.startTime) {\n        this.startTime = entry.startTime;\n      }\n      this.add(entry.event.kindSample, entry.count);\n    }\n  }\n\n  private add(kindSample: string | undefined, count: number): InvalidContextRecording {\n    if (kindSample !== undefined) {\n      const knownCount = this.countsByKindSample.get(kindSample);\n      if (knownCount !== undefined) {\n        this.countsByKindSample.set(kindSample, knownCount + count);\n        return \"known-kind-sample\";\n      }\n      if (this.countsByKindSample.size < DISTINCT_KIND_SAMPLE_LIMIT) {\n        this.countsByKindSample.set(kindSample, count);\n        return \"new-kind-sample\";\n      }\n    }\n    const firstBeyondSampleLimit = this.countBeyondSampleLimit === 0;\n    this.countBeyondSampleLimit += count;\n    return firstBeyondSampleLimit ? \"first-beyond-sample-limit\" : \"beyond-sample-limit\";\n  }\n\n  public takeSnapshot(): AggregatedEvent<InvalidContextEvent>[] {\n    const endTime = new Date();\n    const startTime = this.startTime ?? endTime;\n    const entryOf = (count: number, kindSample?: string): AggregatedEvent<InvalidContextEvent> => ({\n      startTime,\n      endTime,\n      count,\n      event: { reason: \"invalid-context-kind\", kindSample },\n    });\n    const sampledEntries = Array.from(this.countsByKindSample, ([kindSample, count]) =>\n      entryOf(count, kindSample),\n    );\n    const entries =\n      this.countBeyondSampleLimit > 0\n        ? [...sampledEntries, entryOf(this.countBeyondSampleLimit)]\n        : sampledEntries;\n    this.clear();\n    return entries;\n  }\n\n  private clear() {\n    this.countsByKindSample.clear();\n    this.countBeyondSampleLimit = 0;\n    this.startTime = undefined;\n  }\n}\n","import type {\n  ClientSession,\n  ConfigDirectorContext,\n  ConfigDirectorLogger,\n  ConfigValueType,\n} from \"@js-client-core/types\";\nimport type {\n  ClientTelemetryEventCollectorOptions,\n  TelemetryClient,\n  EvaluatedConfigEvent,\n} from \"@js-client-core/telemetry\";\nimport type {\n  TelemetryClientSessionEvent,\n  TelemetryCloseEvent,\n  TelemetryEvaluatedConfigEvent,\n  TelemetryFlushEvent,\n  TelemetryInitializeEvent,\n  TelemetryInvalidContextSubmissionsEvent,\n  TelemetryUpdateContextEvent,\n  TelemetryWorkerResponseEvent,\n} from \"./types\";\nimport type { TelemetryValue } from \"@shared/telemetry/utils\";\nimport { mapToTelemetryValue } from \"@shared/telemetry/utils\";\nimport { InvalidContextSubmissions } from \"@shared/telemetry/InvalidContextSubmissions\";\n\nconst DEFAULT_WORKER_CLOSE_TIMEOUT = 6_000;\n\nexport type WebWorkerTelemetryClientOptions = ClientTelemetryEventCollectorOptions & {\n  workerCloseTimeout?: number;\n};\n\nexport class WebWorkerTelemetryClient implements TelemetryClient {\n  private readonly logger: ConfigDirectorLogger;\n  private readonly initializeMessage: TelemetryInitializeEvent;\n  private readonly clientSession: Promise<ClientSession>;\n  private worker: Worker | undefined;\n  private turnedOff = false;\n  private readonly pendingEvaluations: TelemetryEvaluatedConfigEvent[] = [];\n  private readonly pendingEvaluationLimit: number;\n  private readonly pendingInvalidContextSubmissions = new InvalidContextSubmissions();\n  private closePromise: Promise<void> | undefined;\n  private closeResolve: (() => void) | undefined;\n  private closeTimer: ReturnType<typeof setTimeout> | undefined;\n  private readonly workerCloseTimeout: number;\n  private readonly visibilityHandler: () => void;\n\n  constructor(options: WebWorkerTelemetryClientOptions) {\n    this.logger = options.logger;\n    this.workerCloseTimeout = options.workerCloseTimeout ?? DEFAULT_WORKER_CLOSE_TIMEOUT;\n    this.pendingEvaluationLimit = options.evaluationQueueLimit ?? 1_000;\n    this.clientSession = options.clientSession;\n\n    this.initializeMessage = {\n      type: \"Initialize\",\n      payload: {\n        sdkKey: options.sdkKey,\n        sdkIdentity: options.sdkIdentity,\n        metaContext: options.metaContext,\n        baseUrl: options.baseUrl.toString(),\n        evaluationQueueLimit: this.pendingEvaluationLimit,\n        initialFlushIntervalDelay: options.initialFlushIntervalDelay ?? 5_000,\n        flushIntervalDelay: options.flushIntervalDelay ?? 30_000,\n      },\n    };\n\n    this.visibilityHandler = () => {\n      if (document.visibilityState === \"hidden\") {\n        this.flush();\n      }\n    };\n  }\n\n  private createWorkerOrTurnOff(): Worker | undefined {\n    if (typeof Worker === \"undefined\") {\n      this.turnOff(\n        \"[WebWorkerTelemetryClient] Telemetry is off because Web Workers are not available in this environment.\",\n      );\n      return undefined;\n    }\n    try {\n      return new Worker(new URL(\"./worker.ts\", import.meta.url), { type: \"module\" });\n    } catch (error) {\n      this.turnOff(\n        \"[WebWorkerTelemetryClient] Telemetry is off because the telemetry Web Worker could not be created: \",\n        error,\n      );\n      return undefined;\n    }\n  }\n\n  private turnOff(warning: string, ...details: unknown[]) {\n    this.turnedOff = true;\n    this.pendingEvaluations.length = 0;\n    this.logger.warn(warning, ...details);\n  }\n\n  private startWorker(): Worker | undefined {\n    if (this.worker || this.turnedOff) {\n      return this.worker;\n    }\n    const worker = this.createWorkerOrTurnOff();\n    if (!worker) {\n      return undefined;\n    }\n    worker.onmessage = (message: MessageEvent<TelemetryWorkerResponseEvent>) => {\n      this.handleWorkerEvent(message.data);\n    };\n    worker.postMessage(this.initializeMessage);\n    this.forwardClientSession(worker);\n    this.worker = worker;\n\n    try {\n      document.addEventListener(\"visibilitychange\", this.visibilityHandler);\n    } catch (error) {\n      this.logger.warn(\"[TelemetryEventCollector] Could not configure 'visibilitychange' listener: \", error);\n    }\n\n    for (const evaluation of this.pendingEvaluations) {\n      worker.postMessage(evaluation);\n    }\n    this.pendingEvaluations.length = 0;\n    this.forwardInvalidContextSubmissions(worker);\n    return worker;\n  }\n\n  private forwardClientSession(worker: Worker) {\n    void this.clientSession.then((clientSession) => {\n      const clientSessionMessage: TelemetryClientSessionEvent = {\n        type: \"ClientSession\",\n        payload: clientSession,\n      };\n      worker.postMessage(clientSessionMessage);\n    });\n  }\n\n  private forwardInvalidContextSubmissions(worker: Worker | undefined) {\n    if (!worker) {\n      return;\n    }\n    const entries = this.pendingInvalidContextSubmissions.takeSnapshot();\n    if (entries.length === 0) {\n      return;\n    }\n    const submissionsMessage: TelemetryInvalidContextSubmissionsEvent = {\n      type: \"InvalidContextSubmissions\",\n      payload: { entries },\n    };\n    worker.postMessage(submissionsMessage);\n  }\n\n  public async updateContext(value: ConfigDirectorContext | undefined) {\n    if (this.closePromise) {\n      return;\n    }\n    const updateContextMessage: TelemetryUpdateContextEvent = {\n      type: \"UpdateContext\",\n      payload: {\n        context: value,\n      },\n    };\n    this.startWorker()?.postMessage(updateContextMessage);\n  }\n\n  public evaluatedConfig<T extends ConfigValueType>(event: EvaluatedConfigEvent<T>): void {\n    if (this.turnedOff) {\n      return;\n    }\n    const evaluatedConfigMessage: TelemetryEvaluatedConfigEvent = {\n      type: \"EvaluatedConfigEvent\",\n      payload: this.sanitizeEvaluatedConfigEvent(event),\n    };\n    if (this.worker) {\n      this.worker.postMessage(evaluatedConfigMessage);\n      return;\n    }\n    if (this.pendingEvaluations.length >= this.pendingEvaluationLimit) {\n      this.pendingEvaluations.shift();\n    }\n    this.pendingEvaluations.push(evaluatedConfigMessage);\n  }\n\n  public recordInvalidContext(kindSample: string): void {\n    this.pendingInvalidContextSubmissions.record(kindSample);\n    this.forwardInvalidContextSubmissions(this.worker);\n  }\n\n  private sanitizeEvaluatedConfigEvent<T extends ConfigValueType>(\n    event: EvaluatedConfigEvent<T>,\n  ): EvaluatedConfigEvent<TelemetryValue> {\n    return {\n      ...event,\n      defaultValue: mapToTelemetryValue({ value: event.defaultValue, type: event.type }),\n      evaluatedValue: mapToTelemetryValue({\n        value: event.evaluatedValue,\n        valueId: event.evaluatedValueId,\n        type: event.type,\n      }),\n    };\n  }\n\n  private handleWorkerEvent(event: TelemetryWorkerResponseEvent) {\n    if (event.type === \"Closed\") {\n      this.finishClose();\n      return;\n    }\n    if (!event.payload?.level || !event.payload?.message) {\n      return;\n    }\n    const { level, message, args } = event.payload;\n\n    switch (level) {\n      case \"debug\":\n        this.logger.debug(message, ...args);\n        break;\n      case \"info\":\n        this.logger.info(message, ...args);\n        break;\n      case \"warn\":\n        this.logger.warn(message, ...args);\n        break;\n      case \"error\":\n        this.logger.error(message, ...args);\n        break;\n    }\n  }\n\n  private flush() {\n    const flushMessage: TelemetryFlushEvent = {\n      type: \"Flush\",\n    };\n    this.worker?.postMessage(flushMessage);\n  }\n\n  public close(): Promise<void> {\n    if (this.closePromise) {\n      return this.closePromise;\n    }\n\n    return this.performClose();\n  }\n\n  private performClose(): Promise<void> {\n    const worker = this.worker;\n    if (!worker) {\n      this.pendingEvaluations.length = 0;\n      this.closePromise = Promise.resolve();\n      return this.closePromise;\n    }\n    try {\n      document.removeEventListener(\"visibilitychange\", this.visibilityHandler);\n    } catch (error) {\n      this.logger.warn(\"[WebWorkerTelemetryClient] Could not remove 'visibilitychange' listener: \", error);\n    }\n    this.closePromise = new Promise<void>((resolve) => {\n      this.closeResolve = resolve;\n      this.closeTimer = setTimeout(() => {\n        this.logger.warn(\n          \"[WebWorkerTelemetryClient] Timed out waiting for the telemetry worker to close. Terminating the worker.\",\n        );\n        this.finishClose();\n      }, this.workerCloseTimeout);\n      const closeMessage: TelemetryCloseEvent = { type: \"Close\" };\n      worker.postMessage(closeMessage);\n    });\n    return this.closePromise;\n  }\n\n  private finishClose() {\n    clearTimeout(this.closeTimer);\n    this.closeTimer = undefined;\n    this.worker?.terminate();\n    this.closeResolve?.();\n  }\n}\n","const BASE62 = \"0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz\";\n\nexport const toBase62 = (buf: Uint8Array, length: number): string => {\n  const ZERO = BigInt(0);\n  const BASE = BigInt(62);\n  const hex = Array.from(buf)\n    .map((b) => b.toString(16).padStart(2, \"0\"))\n    .join(\"\");\n  let n = BigInt(\"0x\" + hex);\n  let result = \"\";\n  while (n > ZERO) {\n    result = BASE62[Number(n % BASE)] + result;\n    n /= BASE;\n  }\n  return result.padStart(length, \"0\");\n};\n","export const DIGEST_BYTES = 16;\nexport const BASE62_LENGTH = Math.ceil((DIGEST_BYTES * 8) / Math.log2(62));\n","import { toBase62 } from \"@shared/base62-encoder\";\nimport { DIGEST_BYTES, BASE62_LENGTH } from \"@shared/value-id\";\n\nconst encoder = new TextEncoder();\n\nexport const generateValueId = async (\n  v: string | number | boolean | null | undefined,\n): Promise<string | undefined> => {\n  if (typeof crypto === \"undefined\" || crypto.subtle == null) {\n    return undefined;\n  }\n  const hashBuffer = await crypto.subtle.digest(\"SHA-256\", encoder.encode(v?.toString() ?? \"\"));\n  return toBase62(new Uint8Array(hashBuffer, 0, DIGEST_BYTES), BASE62_LENGTH);\n};\n","import type { CachingProvider } from \"@js-client-core/index\";\nimport { CACHED_VALUES_STORAGE_KEY_PREFIX, DEFAULT_CACHING_SIZE_LIMIT_BYTES } from \"@js-client-core/cached-values\";\nimport { localStorageIfAvailable } from \"@js-client-core/browser-globals\";\n\nconst toHex = (bytes: Uint8Array): string =>\n  Array.from(bytes, (byte) => byte.toString(16).padStart(2, \"0\")).join(\"\");\n\nconst storageKeyFor = async (clientSdkKey: string): Promise<string> => {\n  const digest = await crypto.subtle.digest(\"SHA-256\", new TextEncoder().encode(clientSdkKey));\n  return CACHED_VALUES_STORAGE_KEY_PREFIX + toHex(new Uint8Array(digest));\n};\n\nconst subtleCryptoAvailable = (): boolean => typeof crypto !== \"undefined\" && crypto.subtle != null;\n\nexport const localStorageCachingProvider = (clientSdkKey: string): CachingProvider | undefined => {\n  const storage = localStorageIfAvailable();\n  if (!storage || !subtleCryptoAvailable()) {\n    return undefined;\n  }\n  const storageKey = storageKeyFor(clientSdkKey);\n  return {\n    read: async () => storage.getItem(await storageKey),\n    write: async (value) => storage.setItem(await storageKey, value),\n    remove: async () => storage.removeItem(await storageKey),\n    sizeLimit: () => DEFAULT_CACHING_SIZE_LIMIT_BYTES,\n  };\n};\n","import {\n  type ConfigDirectorClientOptions,\n  type ConfigDirectorClient,\n  type IdentifyingSdkOptions,\n  type OfflineClientOptions,\n} from \"@js-client-core/index\";\nimport { WebWorkerTelemetryClient } from \"./telemetry/WebWorkerTelemetryClient\";\nimport { DefaultConfigDirectorClient } from \"@js-client-core/DefaultConfigDirectorClient\";\nimport { defaultUrlFactory } from \"@shared/url\";\nimport { generateValueId } from \"./telemetry/value-id-generator\";\nimport { localStorageCachingProvider } from \"./local-storage-caching-provider\";\n\n/**\n * Creates a browser client. With a client SDK key it connects to ConfigDirector; with\n * {@link OfflineClientOptions} alone it runs in `offline` mode and serves `connection.values`. An\n * absent key with `clientOptions` is the same as the options alone when their mode is `offline`,\n * and fails like a missing key otherwise.\n */\nexport const createBrowserClient = (\n  clientSdkKeyOrOptions: string | OfflineClientOptions | undefined,\n  sdkOptions: IdentifyingSdkOptions,\n  clientOptions?: ConfigDirectorClientOptions,\n): ConfigDirectorClient => {\n  return DefaultConfigDirectorClient.from(\n    ({ clientSdkKey, baseUrl, logger, metadata, clientSession }) =>\n      new WebWorkerTelemetryClient({\n        sdkKey: clientSdkKey,\n        sdkIdentity: {\n          sdkName: sdkOptions.sdkName,\n          sdkVersion: sdkOptions.sdkVersion,\n        },\n        metaContext: {\n          appName: metadata?.appName,\n          appVersion: metadata?.appVersion,\n        },\n        logger,\n        baseUrl,\n        urlFactory: defaultUrlFactory,\n        valueIdGenerator: generateValueId,\n        clientSession,\n      }),\n    clientSdkKeyOrOptions,\n    sdkOptions,\n    clientOptions,\n    { platformCachingProvider: localStorageCachingProvider },\n  );\n};\n","import type {\n  ConfigDirectorClient,\n  ConfigDirectorClientOptions,\n  ConfigDirectorLoggingLevel,\n  ConfigDirectorLogMessageDecorator,\n  OfflineClientOptions,\n} from \"@js-browser-client/index\";\nimport { createBrowserClient, createDefaultLogger } from \"@js-browser-client/index\";\n\nconst SDK_IDENTITY = { sdkName: \"js-client-sdk\", sdkVersion: \"__VERSION__\" };\n\n/**\n * Creates a `ConfigDirectorClient` object with the given `clientSdkKey` and optional\n * `clientOptions`. The returned client needs to be initialized before it is ready to serve\n * config values.\n *\n * @param clientSdkKey The client SDK key obtained from the ConfigDirector dashboard\n * @param clientOptions {@link ConfigDirectorClientOptions} options for the client (optional)\n * @returns A {@link ConfigDirectorClient} object\n *\n * @example\n * import { createClient } from \"@configdirector/client-sdk\";\n * const client = createClient(\"YOUR-SDK-KEY\");\n * await client.initialize();\n */\nexport function createClient(clientSdkKey: string, clientOptions?: ConfigDirectorClientOptions): ConfigDirectorClient;\n/**\n * Creates a `ConfigDirectorClient` in `offline` mode, which needs no client SDK key. The client\n * never connects to ConfigDirector: it serves `connection.values` to every context, or the in-code\n * default values when none are given. `initialize` rejects with a `ConfigDirectorInitializationError`\n * when the values cannot be loaded.\n *\n * @param clientOptions {@link OfflineClientOptions} options for the client, with `connection.mode`\n * set to `offline`\n * @returns A {@link ConfigDirectorClient} object\n *\n * @example\n * import { createClient } from \"@configdirector/client-sdk\";\n * const client = createClient({ connection: { mode: \"offline\", values: { \"new-checkout\": true } } });\n * await client.initialize();\n */\nexport function createClient(clientOptions: OfflineClientOptions): ConfigDirectorClient;\nexport function createClient(\n  clientSdkKeyOrOptions: string | OfflineClientOptions,\n  clientOptions?: ConfigDirectorClientOptions,\n): ConfigDirectorClient {\n  return createBrowserClient(clientSdkKeyOrOptions, SDK_IDENTITY, clientOptions);\n}\n\nexport const createConsoleLogger = (\n  level: ConfigDirectorLoggingLevel,\n  messageDecorator?: ConfigDirectorLogMessageDecorator,\n) => {\n  return createDefaultLogger(level, messageDecorator);\n};\n"],"mappings":"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"}
+{"version":3,"file":"configdirector-client.mjs","names":[],"sources":["../../shared/src/telemetry/utils.ts","../../shared/src/telemetry/InvalidContextSubmissions.ts","../../js-browser-client/src/telemetry/WebWorkerTelemetryClient.ts","../../shared/src/base62-encoder.ts","../../shared/src/value-id.ts","../../js-browser-client/src/telemetry/value-id-generator.ts","../../js-browser-client/src/local-storage-caching-provider.ts","../../js-browser-client/src/sha256-hex-digest.ts","../../js-browser-client/src/BrowserConfigDirectorClient.ts","../src/api.ts"],"sourcesContent":["import type { ConfigType, ConfigValueType } from \"../types\";\nimport type { ValueIdGenerator, DroppedEvents } from \"./types\";\n\nconst CONFIG_VALUE_MAX_LENGTH = 500;\n\nexport type TelemetryValue = {\n  value?: string;\n  valueId?: string;\n  type?: ConfigType;\n};\n\nexport type TelemetryEvaluationValue<TV extends ConfigValueType> = {\n  value: TV;\n  valueId?: string | null | undefined;\n  type?: ConfigType;\n};\n\nexport const compactTelemetryValue = async (\n  tv: TelemetryValue,\n  valueIdGenerator: ValueIdGenerator,\n): Promise<TelemetryValue> => {\n  if (tv.valueId) {\n    return { valueId: tv.valueId };\n  }\n  if (tv.value) {\n    if (tv.value.length <= CONFIG_VALUE_MAX_LENGTH && tv.type != \"json\") {\n      return { value: tv.value };\n    }\n\n    return { valueId: await valueIdGenerator(tv.value) };\n  }\n\n  return tv;\n};\n\nexport const mapToTelemetryValue = <TV extends ConfigValueType>(\n  ev: TelemetryEvaluationValue<TV>,\n): TelemetryValue => {\n  if (ev.type === \"json\" || (ev.type == null && typeof ev.value === \"object\")) {\n    if (ev.valueId) {\n      return { valueId: ev.valueId, type: \"json\" };\n    }\n    try {\n      const json = JSON.stringify(ev.value);\n      return { value: json, type: \"json\" };\n    } catch {\n      return { value: ev.value.toString(), type: \"json\" };\n    }\n  }\n\n  const stringValue = ev.value?.toString();\n  if (stringValue && stringValue.length <= CONFIG_VALUE_MAX_LENGTH) {\n    return { value: stringValue };\n  }\n\n  return ev.valueId ? { valueId: ev.valueId } : { value: stringValue };\n};\n\nexport const djb2Hash = (data: string): string => {\n  const hash = djb2(new TextEncoder().encode(data));\n  return hash.toString(16).padStart(8, \"0\");\n};\n\nconst djb2 = (bytes: Uint8Array): number => {\n  let hash = 5381;\n  for (let i = 0; i < bytes.length; i++) {\n    hash = (hash << 5) + hash + (bytes[i] ?? 0);\n    hash = hash >>> 0;\n  }\n  return hash;\n};\n\nexport const isEventListEmpty = <T extends Record<string | symbol, any[]>>(eventList: T): boolean => {\n  const keys = Object.keys(eventList);\n  if (keys.length == 0) {\n    return true;\n  }\n\n  for (const key of keys) {\n    if ((eventList[key]?.length ?? 0) > 0) {\n      return false;\n    }\n  }\n\n  return true;\n};\n\nexport const isDroppedEventsEmpty = (droppedEvents?: DroppedEvents): boolean => {\n  if (!droppedEvents) {\n    return true;\n  }\n  const keys = Object.keys(droppedEvents);\n  if (keys.length == 0) {\n    return true;\n  }\n\n  for (const key of keys) {\n    if ((droppedEvents[key] ?? 0) > 0) {\n      return false;\n    }\n  }\n\n  return true;\n};\n","import type { InvalidContextEvent } from \"./telemetry-events\";\nimport type { AggregatedEvent } from \"./types\";\n\nexport const DISTINCT_KIND_SAMPLE_LIMIT = 20;\n\nexport type InvalidContextRecording =\n  | \"new-kind-sample\"\n  | \"known-kind-sample\"\n  | \"first-beyond-sample-limit\"\n  | \"beyond-sample-limit\";\n\nexport class InvalidContextSubmissions {\n  private readonly countsByKindSample = new Map<string, number>();\n  private countBeyondSampleLimit = 0;\n  private startTime: Date | undefined;\n\n  public record(kindSample: string): InvalidContextRecording {\n    this.startTime ??= new Date();\n    return this.add(kindSample, 1);\n  }\n\n  public absorb(entries: AggregatedEvent<InvalidContextEvent>[]): void {\n    for (const entry of entries) {\n      if (this.startTime === undefined || entry.startTime < this.startTime) {\n        this.startTime = entry.startTime;\n      }\n      this.add(entry.event.kindSample, entry.count);\n    }\n  }\n\n  private add(kindSample: string | undefined, count: number): InvalidContextRecording {\n    if (kindSample !== undefined) {\n      const knownCount = this.countsByKindSample.get(kindSample);\n      if (knownCount !== undefined) {\n        this.countsByKindSample.set(kindSample, knownCount + count);\n        return \"known-kind-sample\";\n      }\n      if (this.countsByKindSample.size < DISTINCT_KIND_SAMPLE_LIMIT) {\n        this.countsByKindSample.set(kindSample, count);\n        return \"new-kind-sample\";\n      }\n    }\n    const firstBeyondSampleLimit = this.countBeyondSampleLimit === 0;\n    this.countBeyondSampleLimit += count;\n    return firstBeyondSampleLimit ? \"first-beyond-sample-limit\" : \"beyond-sample-limit\";\n  }\n\n  public takeSnapshot(): AggregatedEvent<InvalidContextEvent>[] {\n    const endTime = new Date();\n    const startTime = this.startTime ?? endTime;\n    const entryOf = (count: number, kindSample?: string): AggregatedEvent<InvalidContextEvent> => ({\n      startTime,\n      endTime,\n      count,\n      event: { reason: \"invalid-context-kind\", kindSample },\n    });\n    const sampledEntries = Array.from(this.countsByKindSample, ([kindSample, count]) =>\n      entryOf(count, kindSample),\n    );\n    const entries =\n      this.countBeyondSampleLimit > 0\n        ? [...sampledEntries, entryOf(this.countBeyondSampleLimit)]\n        : sampledEntries;\n    this.clear();\n    return entries;\n  }\n\n  private clear() {\n    this.countsByKindSample.clear();\n    this.countBeyondSampleLimit = 0;\n    this.startTime = undefined;\n  }\n}\n","import type {\n  ClientSession,\n  ConfigDirectorContext,\n  ConfigDirectorLogger,\n  ConfigValueType,\n} from \"@js-client-core/types\";\nimport type {\n  ClientTelemetryEventCollectorOptions,\n  TelemetryClient,\n  EvaluatedConfigEvent,\n} from \"@js-client-core/telemetry\";\nimport type {\n  TelemetryClientSessionEvent,\n  TelemetryCloseEvent,\n  TelemetryEvaluatedConfigEvent,\n  TelemetryFlushEvent,\n  TelemetryInitializeEvent,\n  TelemetryInvalidContextSubmissionsEvent,\n  TelemetryUpdateContextEvent,\n  TelemetryWorkerResponseEvent,\n} from \"./types\";\nimport type { TelemetryValue } from \"@shared/telemetry/utils\";\nimport { mapToTelemetryValue } from \"@shared/telemetry/utils\";\nimport { InvalidContextSubmissions } from \"@shared/telemetry/InvalidContextSubmissions\";\n\nconst DEFAULT_WORKER_CLOSE_TIMEOUT = 6_000;\n\nexport type WebWorkerTelemetryClientOptions = ClientTelemetryEventCollectorOptions & {\n  workerCloseTimeout?: number;\n};\n\nexport class WebWorkerTelemetryClient implements TelemetryClient {\n  private readonly logger: ConfigDirectorLogger;\n  private readonly initializeMessage: TelemetryInitializeEvent;\n  private readonly clientSession: Promise<ClientSession>;\n  private worker: Worker | undefined;\n  private turnedOff = false;\n  private readonly pendingEvaluations: TelemetryEvaluatedConfigEvent[] = [];\n  private readonly pendingEvaluationLimit: number;\n  private readonly pendingInvalidContextSubmissions = new InvalidContextSubmissions();\n  private closePromise: Promise<void> | undefined;\n  private closeResolve: (() => void) | undefined;\n  private closeTimer: ReturnType<typeof setTimeout> | undefined;\n  private readonly workerCloseTimeout: number;\n  private readonly visibilityHandler: () => void;\n\n  constructor(options: WebWorkerTelemetryClientOptions) {\n    this.logger = options.logger;\n    this.workerCloseTimeout = options.workerCloseTimeout ?? DEFAULT_WORKER_CLOSE_TIMEOUT;\n    this.pendingEvaluationLimit = options.evaluationQueueLimit ?? 1_000;\n    this.clientSession = options.clientSession;\n\n    this.initializeMessage = {\n      type: \"Initialize\",\n      payload: {\n        sdkKey: options.sdkKey,\n        sdkIdentity: options.sdkIdentity,\n        metaContext: options.metaContext,\n        baseUrl: options.baseUrl.toString(),\n        evaluationQueueLimit: this.pendingEvaluationLimit,\n        initialFlushIntervalDelay: options.initialFlushIntervalDelay ?? 5_000,\n        flushIntervalDelay: options.flushIntervalDelay ?? 30_000,\n      },\n    };\n\n    this.visibilityHandler = () => {\n      if (document.visibilityState === \"hidden\") {\n        this.flush();\n      }\n    };\n  }\n\n  private createWorkerOrTurnOff(): Worker | undefined {\n    if (typeof Worker === \"undefined\") {\n      this.turnOff(\n        \"[WebWorkerTelemetryClient] Telemetry is off because Web Workers are not available in this environment.\",\n      );\n      return undefined;\n    }\n    try {\n      return new Worker(new URL(\"./worker.ts\", import.meta.url), { type: \"module\" });\n    } catch (error) {\n      this.turnOff(\n        \"[WebWorkerTelemetryClient] Telemetry is off because the telemetry Web Worker could not be created: \",\n        error,\n      );\n      return undefined;\n    }\n  }\n\n  private turnOff(warning: string, ...details: unknown[]) {\n    this.turnedOff = true;\n    this.pendingEvaluations.length = 0;\n    this.logger.warn(warning, ...details);\n  }\n\n  private startWorker(): Worker | undefined {\n    if (this.worker || this.turnedOff) {\n      return this.worker;\n    }\n    const worker = this.createWorkerOrTurnOff();\n    if (!worker) {\n      return undefined;\n    }\n    worker.onmessage = (message: MessageEvent<TelemetryWorkerResponseEvent>) => {\n      this.handleWorkerEvent(message.data);\n    };\n    worker.postMessage(this.initializeMessage);\n    this.forwardClientSession(worker);\n    this.worker = worker;\n\n    try {\n      document.addEventListener(\"visibilitychange\", this.visibilityHandler);\n    } catch (error) {\n      this.logger.warn(\"[TelemetryEventCollector] Could not configure 'visibilitychange' listener: \", error);\n    }\n\n    for (const evaluation of this.pendingEvaluations) {\n      worker.postMessage(evaluation);\n    }\n    this.pendingEvaluations.length = 0;\n    this.forwardInvalidContextSubmissions(worker);\n    return worker;\n  }\n\n  private forwardClientSession(worker: Worker) {\n    void this.clientSession.then((clientSession) => {\n      const clientSessionMessage: TelemetryClientSessionEvent = {\n        type: \"ClientSession\",\n        payload: clientSession,\n      };\n      worker.postMessage(clientSessionMessage);\n    });\n  }\n\n  private forwardInvalidContextSubmissions(worker: Worker | undefined) {\n    if (!worker) {\n      return;\n    }\n    const entries = this.pendingInvalidContextSubmissions.takeSnapshot();\n    if (entries.length === 0) {\n      return;\n    }\n    const submissionsMessage: TelemetryInvalidContextSubmissionsEvent = {\n      type: \"InvalidContextSubmissions\",\n      payload: { entries },\n    };\n    worker.postMessage(submissionsMessage);\n  }\n\n  public async updateContext(value: ConfigDirectorContext | undefined) {\n    if (this.closePromise) {\n      return;\n    }\n    const updateContextMessage: TelemetryUpdateContextEvent = {\n      type: \"UpdateContext\",\n      payload: {\n        context: value,\n      },\n    };\n    this.startWorker()?.postMessage(updateContextMessage);\n  }\n\n  public evaluatedConfig<T extends ConfigValueType>(event: EvaluatedConfigEvent<T>): void {\n    if (this.turnedOff) {\n      return;\n    }\n    const evaluatedConfigMessage: TelemetryEvaluatedConfigEvent = {\n      type: \"EvaluatedConfigEvent\",\n      payload: this.sanitizeEvaluatedConfigEvent(event),\n    };\n    if (this.worker) {\n      this.worker.postMessage(evaluatedConfigMessage);\n      return;\n    }\n    if (this.pendingEvaluations.length >= this.pendingEvaluationLimit) {\n      this.pendingEvaluations.shift();\n    }\n    this.pendingEvaluations.push(evaluatedConfigMessage);\n  }\n\n  public recordInvalidContext(kindSample: string): void {\n    this.pendingInvalidContextSubmissions.record(kindSample);\n    this.forwardInvalidContextSubmissions(this.worker);\n  }\n\n  private sanitizeEvaluatedConfigEvent<T extends ConfigValueType>(\n    event: EvaluatedConfigEvent<T>,\n  ): EvaluatedConfigEvent<TelemetryValue> {\n    return {\n      ...event,\n      defaultValue: mapToTelemetryValue({ value: event.defaultValue, type: event.type }),\n      evaluatedValue: mapToTelemetryValue({\n        value: event.evaluatedValue,\n        valueId: event.evaluatedValueId,\n        type: event.type,\n      }),\n    };\n  }\n\n  private handleWorkerEvent(event: TelemetryWorkerResponseEvent) {\n    if (event.type === \"Closed\") {\n      this.finishClose();\n      return;\n    }\n    if (!event.payload?.level || !event.payload?.message) {\n      return;\n    }\n    const { level, message, args } = event.payload;\n\n    switch (level) {\n      case \"debug\":\n        this.logger.debug(message, ...args);\n        break;\n      case \"info\":\n        this.logger.info(message, ...args);\n        break;\n      case \"warn\":\n        this.logger.warn(message, ...args);\n        break;\n      case \"error\":\n        this.logger.error(message, ...args);\n        break;\n    }\n  }\n\n  private flush() {\n    const flushMessage: TelemetryFlushEvent = {\n      type: \"Flush\",\n    };\n    this.worker?.postMessage(flushMessage);\n  }\n\n  public close(): Promise<void> {\n    if (this.closePromise) {\n      return this.closePromise;\n    }\n\n    return this.performClose();\n  }\n\n  private performClose(): Promise<void> {\n    const worker = this.worker;\n    if (!worker) {\n      this.pendingEvaluations.length = 0;\n      this.closePromise = Promise.resolve();\n      return this.closePromise;\n    }\n    try {\n      document.removeEventListener(\"visibilitychange\", this.visibilityHandler);\n    } catch (error) {\n      this.logger.warn(\"[WebWorkerTelemetryClient] Could not remove 'visibilitychange' listener: \", error);\n    }\n    this.closePromise = new Promise<void>((resolve) => {\n      this.closeResolve = resolve;\n      this.closeTimer = setTimeout(() => {\n        this.logger.warn(\n          \"[WebWorkerTelemetryClient] Timed out waiting for the telemetry worker to close. Terminating the worker.\",\n        );\n        this.finishClose();\n      }, this.workerCloseTimeout);\n      const closeMessage: TelemetryCloseEvent = { type: \"Close\" };\n      worker.postMessage(closeMessage);\n    });\n    return this.closePromise;\n  }\n\n  private finishClose() {\n    clearTimeout(this.closeTimer);\n    this.closeTimer = undefined;\n    this.worker?.terminate();\n    this.closeResolve?.();\n  }\n}\n","const BASE62 = \"0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz\";\n\nexport const toBase62 = (buf: Uint8Array, length: number): string => {\n  const ZERO = BigInt(0);\n  const BASE = BigInt(62);\n  const hex = Array.from(buf)\n    .map((b) => b.toString(16).padStart(2, \"0\"))\n    .join(\"\");\n  let n = BigInt(\"0x\" + hex);\n  let result = \"\";\n  while (n > ZERO) {\n    result = BASE62[Number(n % BASE)] + result;\n    n /= BASE;\n  }\n  return result.padStart(length, \"0\");\n};\n","export const DIGEST_BYTES = 16;\nexport const BASE62_LENGTH = Math.ceil((DIGEST_BYTES * 8) / Math.log2(62));\n","import { toBase62 } from \"@shared/base62-encoder\";\nimport { DIGEST_BYTES, BASE62_LENGTH } from \"@shared/value-id\";\n\nconst encoder = new TextEncoder();\n\nexport const generateValueId = async (\n  v: string | number | boolean | null | undefined,\n): Promise<string | undefined> => {\n  if (typeof crypto === \"undefined\" || crypto.subtle == null) {\n    return undefined;\n  }\n  const hashBuffer = await crypto.subtle.digest(\"SHA-256\", encoder.encode(v?.toString() ?? \"\"));\n  return toBase62(new Uint8Array(hashBuffer, 0, DIGEST_BYTES), BASE62_LENGTH);\n};\n","import type { CachingProvider } from \"@js-client-core/index\";\nimport { CACHED_VALUES_STORAGE_KEY_PREFIX, DEFAULT_CACHING_SIZE_LIMIT_BYTES } from \"@js-client-core/cached-values\";\nimport { localStorageIfAvailable } from \"@js-client-core/browser-globals\";\n\nexport const localStorageCachingProvider = (clientSdkKeyDigest: Promise<string>): CachingProvider | undefined => {\n  const storage = localStorageIfAvailable();\n  if (!storage) {\n    return undefined;\n  }\n  const storageKey = clientSdkKeyDigest.then((digest) => CACHED_VALUES_STORAGE_KEY_PREFIX + digest);\n  return {\n    read: async () => storage.getItem(await storageKey),\n    write: async (value) => storage.setItem(await storageKey, value),\n    remove: async () => storage.removeItem(await storageKey),\n    sizeLimit: () => DEFAULT_CACHING_SIZE_LIMIT_BYTES,\n  };\n};\n","import type { Sha256HexDigest } from \"@js-client-core/types\";\n\nconst toHex = (bytes: Uint8Array): string =>\n  Array.from(bytes, (byte) => byte.toString(16).padStart(2, \"0\")).join(\"\");\n\nexport const sha256HexDigestIfAvailable = (): Sha256HexDigest | undefined => {\n  if (typeof crypto === \"undefined\" || crypto.subtle == null) {\n    return undefined;\n  }\n  return async (text) => {\n    const digest = await crypto.subtle.digest(\"SHA-256\", new TextEncoder().encode(text));\n    return toHex(new Uint8Array(digest));\n  };\n};\n","import {\n  type ConfigDirectorClientOptions,\n  type ConfigDirectorClient,\n  type IdentifyingSdkOptions,\n  type OfflineClientOptions,\n} from \"@js-client-core/index\";\nimport { WebWorkerTelemetryClient } from \"./telemetry/WebWorkerTelemetryClient\";\nimport { DefaultConfigDirectorClient } from \"@js-client-core/DefaultConfigDirectorClient\";\nimport { defaultUrlFactory } from \"@shared/url\";\nimport { generateValueId } from \"./telemetry/value-id-generator\";\nimport { localStorageCachingProvider } from \"./local-storage-caching-provider\";\nimport { sha256HexDigestIfAvailable } from \"./sha256-hex-digest\";\n\n/**\n * Creates a browser client. With a client SDK key it connects to ConfigDirector; with\n * {@link OfflineClientOptions} alone it runs in `offline` mode and serves `connection.values`. An\n * absent key with `clientOptions` is the same as the options alone when their mode is `offline`,\n * and fails like a missing key otherwise.\n */\nexport const createBrowserClient = (\n  clientSdkKeyOrOptions: string | OfflineClientOptions | undefined,\n  sdkOptions: IdentifyingSdkOptions,\n  clientOptions?: ConfigDirectorClientOptions,\n): ConfigDirectorClient => {\n  return DefaultConfigDirectorClient.from(\n    ({ clientSdkKey, baseUrl, logger, metadata, clientSession }) =>\n      new WebWorkerTelemetryClient({\n        sdkKey: clientSdkKey,\n        sdkIdentity: {\n          sdkName: sdkOptions.sdkName,\n          sdkVersion: sdkOptions.sdkVersion,\n        },\n        metaContext: {\n          appName: metadata?.appName,\n          appVersion: metadata?.appVersion,\n        },\n        logger,\n        baseUrl,\n        urlFactory: defaultUrlFactory,\n        valueIdGenerator: generateValueId,\n        clientSession,\n      }),\n    clientSdkKeyOrOptions,\n    sdkOptions,\n    clientOptions,\n    { sha256HexDigest: sha256HexDigestIfAvailable(), platformCachingProvider: localStorageCachingProvider },\n  );\n};\n","import type {\n  ConfigDirectorClient,\n  ConfigDirectorClientOptions,\n  ConfigDirectorLoggingLevel,\n  ConfigDirectorLogMessageDecorator,\n  OfflineClientOptions,\n} from \"@js-browser-client/index\";\nimport { createBrowserClient, createDefaultLogger } from \"@js-browser-client/index\";\n\nconst SDK_IDENTITY = { sdkName: \"js-client-sdk\", sdkVersion: \"__VERSION__\" };\n\n/**\n * Creates a `ConfigDirectorClient` object with the given `clientSdkKey` and optional\n * `clientOptions`. The returned client needs to be initialized before it is ready to serve\n * config values.\n *\n * @param clientSdkKey The client SDK key obtained from the ConfigDirector dashboard\n * @param clientOptions {@link ConfigDirectorClientOptions} options for the client (optional)\n * @returns A {@link ConfigDirectorClient} object\n *\n * @example\n * import { createClient } from \"@configdirector/client-sdk\";\n * const client = createClient(\"YOUR-SDK-KEY\");\n * await client.initialize();\n */\nexport function createClient(clientSdkKey: string, clientOptions?: ConfigDirectorClientOptions): ConfigDirectorClient;\n/**\n * Creates a `ConfigDirectorClient` in `offline` mode, which needs no client SDK key. The client\n * never connects to ConfigDirector: it serves `connection.values` to every context, or the in-code\n * default values when none are given. `initialize` rejects with a `ConfigDirectorInitializationError`\n * when the values cannot be loaded.\n *\n * @param clientOptions {@link OfflineClientOptions} options for the client, with `connection.mode`\n * set to `offline`\n * @returns A {@link ConfigDirectorClient} object\n *\n * @example\n * import { createClient } from \"@configdirector/client-sdk\";\n * const client = createClient({ connection: { mode: \"offline\", values: { \"new-checkout\": true } } });\n * await client.initialize();\n */\nexport function createClient(clientOptions: OfflineClientOptions): ConfigDirectorClient;\nexport function createClient(\n  clientSdkKeyOrOptions: string | OfflineClientOptions,\n  clientOptions?: ConfigDirectorClientOptions,\n): ConfigDirectorClient {\n  return createBrowserClient(clientSdkKeyOrOptions, SDK_IDENTITY, clientOptions);\n}\n\nexport const createConsoleLogger = (\n  level: ConfigDirectorLoggingLevel,\n  messageDecorator?: ConfigDirectorLogMessageDecorator,\n) => {\n  return createDefaultLogger(level, messageDecorator);\n};\n"],"mappings":"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"}

package/dist/{errors-s1a-WKkm.d.cts → errors-BUWbQes2.d.cts}

@@ -23,13 +23,24 @@ interface ConfigDirectorLogger {
 interface ConfigDirectorLogMessageDecorator {
   decorateMessage(message: string): string;
 }
+/**
+ * Why an evaluation returned the value it did. `found-match` returns a value from ConfigDirector,
+ * and `cached` a value kept on the device while a client SDK waits for live values. `value-missing`
+ * returns the in-code default value because the config has no value. Every other reason returns the
+ * in-code default value because of an error: the config does not exist (`config-state-missing`), no
+ * values have arrived yet (`client-not-ready`), or the value cannot be read as the type of the in-code
+ * default value.
+ */
 type EvaluationReason = "found-match" | "config-state-missing" | "client-not-ready" | "type-mismatch" | "value-missing" | "invalid-number" | "invalid-json" | "invalid-boolean" | "cached";
-type ConfigEvaluation = {
-  key: string;
-  value: ConfigValueType;
-  valueId?: string;
-  isDefaultValue: boolean;
-  reason: EvaluationReason;
+/**
+ * One evaluation of a config: the value it returned, why, and the context it was evaluated for.
+ */
+type ConfigEvaluation<T extends ConfigValueType = ConfigValueType> = {
+  /** The config key that was evaluated. */key: string; /** The value returned, which is the in-code default value when {@link isDefaultValue} is `true`. */
+  value: T; /** The ID ConfigDirector assigned to the value returned, when ConfigDirector sent one with it. */
+  valueId?: string; /** Whether the evaluation returned the in-code default value. */
+  isDefaultValue: boolean; /** Why the evaluation returned this value. */
+  reason: EvaluationReason; /** The context the config was evaluated for, if any. */
   context?: ConfigDirectorContext;
 };
 /**
@@ -358,6 +369,16 @@ interface ConfigDirectorClient extends EventProvider<ClientEvents> {
    * is called before initialization is done.
    */
   getValue<T extends ConfigValueType>(configKey: string, defaultValue: T): T;
+  /**
+   * Evaluates a config as {@link getValue} does and returns the evaluation: the value, the reason it
+   * was served and its value ID. Like every read, it fires `configEvaluated` and is counted in
+   * telemetry.
+   *
+   * @returns The evaluation, whose `value` is what {@link getValue} returns
+   * @param configKey The config key to evaluate
+   * @param defaultValue The in-code default value, returned when no value from ConfigDirector can be served
+   */
+  evaluate<T extends ConfigValueType>(configKey: string, defaultValue: T): ConfigEvaluation<T>;
   /**
    * Watches for changes to a a config evaluation value. Whenever the config value changes, the
    * provided callback function will be called with the new value. Changes can happen due to updates
@@ -420,5 +441,5 @@ declare class ConfigDirectorInitializationError extends Error {
   constructor(message: string);
 }
 //#endregion
-export { ConfigDirectorLoggingLevel as _, CachingProvider as a, OfflineClientOptions as c, NativeJsonValue as d, NativeValue as f, ConfigDirectorLogger as g, ConfigDirectorLogMessageDecorator as h, CachingOptions as i, OfflineValue as l, ConfigDirectorContext as m, ConfigDirectorInitializationError as n, ConfigDirectorClient as o, NativeValues as p, ConfigDirectorValidationError as r, ConfigDirectorClientOptions as s, ConfigDirectorConnectionError as t, OfflineValues as u, ConfigValueType as v };
-//# sourceMappingURL=errors-s1a-WKkm.d.cts.map
+export { ConfigDirectorLoggingLevel as _, CachingProvider as a, EvaluationReason as b, OfflineClientOptions as c, NativeJsonValue as d, NativeValue as f, ConfigDirectorLogger as g, ConfigDirectorLogMessageDecorator as h, CachingOptions as i, OfflineValue as l, ConfigDirectorContext as m, ConfigDirectorInitializationError as n, ConfigDirectorClient as o, NativeValues as p, ConfigDirectorValidationError as r, ConfigDirectorClientOptions as s, ConfigDirectorConnectionError as t, OfflineValues as u, ConfigEvaluation as v, ConfigValueType as y };
+//# sourceMappingURL=errors-BUWbQes2.d.cts.map

package/dist/errors-BUWbQes2.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-BUWbQes2.d.cts","names":[],"sources":["../../js-client-core/src/Emitter.ts","../../shared/src/types.ts","../../shared/src/native-values.ts","../../js-client-core/src/types.ts","../../shared/src/errors.ts"],"mappings":";KAAK,SAAA;AAAA,KACA,YAAA,GAAe,MAAA,CAAO,SAAA;AAAA,KAEtB,OAAA,uBAA8B,YAAA,qBAAiC,aAAA,KAClE,OAAA,EAAS,aAAA,CAAc,IAAA;AAAA,UAGR,aAAA,uBAAoC,YAAA;EACnD,EAAA,qBAAuB,aAAA,EAAe,IAAA,EAAM,KAAA,EAAO,OAAA,EAAS,OAAA,CAAQ,aAAA,EAAe,KAAA;EACnF,GAAA,qBAAwB,aAAA,EAAe,IAAA,EAAM,KAAA,EAAO,OAAA,GAAU,OAAA,CAAQ,aAAA,EAAe,KAAA;EACrF,KAAA;AAAA;;;KCEU,kBAAA;EAAA,CAAwB,GAAA;AAAA;AAAA,KAExB,eAAA,wCAAuD,kBAAA;AAAA,KAevD,0BAAA;AAAA,UAEK,oBAAA;EACf,KAAA,CAAM,OAAA,aAAoB,IAAA;EAE1B,IAAA,CAAK,OAAA,aAAoB,IAAA;EAEzB,IAAA,CAAK,OAAA,aAAoB,IAAA;EAEzB,KAAA,CAAM,OAAA,aAAoB,IAAA;AAAA;AAAA,UAGX,iCAAA;EACf,eAAA,CAAgB,OAAA;AAAA;;;ADnClB;;;;;;KC8CY,gBAAA;;;;KAcA,gBAAA,WAA2B,eAAA,GAAkB,eAAA;ED1De,yCC4DtE,GAAA,UD5D8D;EC8D9D,KAAA,EAAO,CAAA,ED9D8D;ECgErE,OAAA,WDlEmD;ECoEnD,cAAA,WDnEG;ECqEH,MAAA,EAAQ,gBAAA,EDrEoC;ECuE5C,OAAA,GAAU,qBAAA;AAAA;;;;;;KAOA,qBAAA;ED7EmC;;;;;;;;;;ECwF7C,EAAA;;AArFF;;;;;AAEA;;;;;EAgGE,IAAA;EAjFoC;;;;EAuFpC,IAAA;EArFmC;;;;EA2FnC,MAAA;IAAA,CAAY,GAAA;EAAA;EAxFP;;;;;;;EAiGL,SAAA;AAAA;;AA1FF;;;KAiGY,yBAAA;EACV,UAAA;EACA,OAAA;AAAA;AAAA,KAGU,cAAA;;;KC5IA,eAAA,sCAAqD,eAAA;EAAA,CAAuB,GAAA,WAAc,eAAA;AAAA;AAAA,KAE1F,WAAA,+BAA0C,eAAA;EAAA,CAAuB,GAAA,WAAc,eAAA;AAAA;AAAA,KAE/E,YAAA,GAAe,MAAA,SAAe,WAAA;;;;;AFA1C;;;KGyCY,eAAA;EHxCa;;;EG4CvB,IAAA,gCAAoC,OAAA;EH5CwB;;;EGgD5D,KAAA,CAAM,KAAA,kBAAuB,OAAA;EH/CwD;;;EGmDrF,MAAA,WAAiB,OAAA;EHrDY;;;;EG0D7B,SAAA;AAAA;;;;;KAOU,cAAA;EH/DV;;;EGmEA,OAAA;EHnEuC;;;;EGwEvC,QAAA,GAAW,eAAA;AAAA;;;;;AFpDb;KE0EY,YAAA,GAAe,WAAA;;;;AFxE3B;KE8EY,aAAA,GAAgB,YAAA;;;;KAKhB,iBAAA;EFlFgB;;;;;;;;;;;;EE+F1B,IAAA,GAAO,cAAA;EFtFyC;;;;AAYlD;;EEiFE,MAAA,GAAS,aAAA;EFjFiB;;AAc5B;;;;;EE2EE,eAAA;EFjEQ;;;;;;;EEyER,OAAA;EF/EA;;;;;EEqFA,GAAA;AAAA;;;;KAMU,2BAAA;EF5EqB;;;EEgF/B,QAAA,GAAW,yBAAA;EFxDX;;;EE4DA,UAAA,GAAa,iBAAA;EFvCb;;;AAOF;;EEsCE,OAAA,GAAU,cAAA;EFrCV;;AAIF;;;;;;;;AC5IA;;;EC2LE,MAAA,GAAS,oBAAA;ED3LsD;;;;;AAEjE;;;;;;;;;AAEA;ECwME,KAAA,GAAQ,WAAA;AAAA;;;;KAME,oBAAA,GAAuB,2BAAA;EACjC,UAAA,EAAY,iBAAA;IAAsB,IAAA;EAAA;AAAA;AAAA,KAGxB,WAAA;EACV,WAAA,GAAc,WAAA,kBAA6B,WAAA;EAC3C,cAAA,GAAiB,WAAA,qBAAgC,WAAA;EACjD,cAAA,GAAiB,WAAA,qBAAgC,WAAA;EACjD,eAAA,GAAkB,WAAA,sBAAiC,WAAA;EACnD,eAAA,GAAkB,WAAA,sBAAiC,WAAA;EACnD,kBAAA,GAAqB,WAAA,yBAAoC,WAAA;AAAA;AAAA,KAG/C,mBAAA;AAAA,KAEA,WAAA,sBAAiC,YAAA,KAAiB,OAAA,EAAS,YAAA,CAAa,MAAA;AAAA,KAExE,YAAA;EACV,cAAA;IAAkB,IAAA;IAAgB,WAAA;EAAA;EAClC,WAAA;IAAe,MAAA,EAAQ,mBAAA;EAAA;EACvB,cAAA;IAAkB,OAAA,EAAS,qBAAA;EAAA;EAC3B,eAAA;IAAmB,UAAA,EAAY,gBAAA;EAAA;EAC/B,eAAA;IAAmB,KAAA,EAAO,KAAA;EAAA;EAC1B,kBAAA,EAAoB,MAAA;AAAA;AAAA,KAGV,YAAA,WAAuB,eAAA,KAAoB,OAAA,EAAS,CAAA;;;;;AA7HhE;;;;;UAwIiB,oBAAA,SAA6B,aAAA,CAAc,YAAA;EApH1D;;;;;;;AA4BF;;;;;;;;;EAyGE,UAAA,CAAW,OAAA,GAAU,qBAAA,GAAwB,OAAA;EArG7C;;;;;;;;;EAgHA,aAAA,CAAc,OAAA,EAAS,qBAAA,GAAwB,OAAA;EAvE5B;;AAMrB;;;;;;;EANqB,IAkFf,OAAA,IAAW,qBAAA;EA3EuB;;AAGxC;;;;EAHwC,IAmFlC,OAAA;EA9Ea;;;;;;;EAAA,IAuFb,cAAA;EAnFiB;;;;;;;;;EA8FrB,QAAA,WAAmB,eAAA,EAAiB,SAAA,UAAmB,YAAA,EAAc,CAAA,GAAI,CAAA;EAjGzE;;;;;;;;;EA4GA,QAAA,WAAmB,eAAA,EAAiB,SAAA,UAAmB,YAAA,EAAc,CAAA,GAAI,gBAAA,CAAiB,CAAA;EAzGrE;;;;AAGvB;;;;;AAEA;;EAiHE,KAAA,WAAgB,eAAA,EAAiB,SAAA,UAAmB,YAAA,EAAc,CAAA,EAAG,QAAA,EAAU,YAAA,CAAa,CAAA;EAjHjD;;;;;;;;EA2H3C,OAAA,WAAkB,eAAA,EAAiB,SAAA,UAAmB,QAAA,GAAW,YAAA,CAAa,CAAA;EA3HlB;;;EAgI5D,UAAA;EA9HsB;;;;;;;EAuItB,YAAA;EAjI0B;;;;EAuI1B,aAAA,IAAiB,OAAA;EA3IF;;;;;;EAmJf,OAAA;AAAA;;;cC3XW,6BAAA,SAAsC,KAAA;EAAA,SACxB,IAAA;EAAA,SACT,MAAA;cAEJ,OAAA,UAAiB,MAAA;AAAA;AAAA,cAQlB,6BAAA,SAAsC,KAAA;EAAA,SACxB,IAAA;cAEb,OAAA;AAAA;AAAA,cAOD,iCAAA,SAA0C,KAAA;EAAA,SAC5B,IAAA;cAEb,OAAA;AAAA"}

package/dist/{errors-K27PrStP.d.mts → errors-CkIP6urQ.d.mts}

@@ -23,13 +23,24 @@ interface ConfigDirectorLogger {
 interface ConfigDirectorLogMessageDecorator {
   decorateMessage(message: string): string;
 }
+/**
+ * Why an evaluation returned the value it did. `found-match` returns a value from ConfigDirector,
+ * and `cached` a value kept on the device while a client SDK waits for live values. `value-missing`
+ * returns the in-code default value because the config has no value. Every other reason returns the
+ * in-code default value because of an error: the config does not exist (`config-state-missing`), no
+ * values have arrived yet (`client-not-ready`), or the value cannot be read as the type of the in-code
+ * default value.
+ */
 type EvaluationReason = "found-match" | "config-state-missing" | "client-not-ready" | "type-mismatch" | "value-missing" | "invalid-number" | "invalid-json" | "invalid-boolean" | "cached";
-type ConfigEvaluation = {
-  key: string;
-  value: ConfigValueType;
-  valueId?: string;
-  isDefaultValue: boolean;
-  reason: EvaluationReason;
+/**
+ * One evaluation of a config: the value it returned, why, and the context it was evaluated for.
+ */
+type ConfigEvaluation<T extends ConfigValueType = ConfigValueType> = {
+  /** The config key that was evaluated. */key: string; /** The value returned, which is the in-code default value when {@link isDefaultValue} is `true`. */
+  value: T; /** The ID ConfigDirector assigned to the value returned, when ConfigDirector sent one with it. */
+  valueId?: string; /** Whether the evaluation returned the in-code default value. */
+  isDefaultValue: boolean; /** Why the evaluation returned this value. */
+  reason: EvaluationReason; /** The context the config was evaluated for, if any. */
   context?: ConfigDirectorContext;
 };
 /**
@@ -358,6 +369,16 @@ interface ConfigDirectorClient extends EventProvider<ClientEvents> {
    * is called before initialization is done.
    */
   getValue<T extends ConfigValueType>(configKey: string, defaultValue: T): T;
+  /**
+   * Evaluates a config as {@link getValue} does and returns the evaluation: the value, the reason it
+   * was served and its value ID. Like every read, it fires `configEvaluated` and is counted in
+   * telemetry.
+   *
+   * @returns The evaluation, whose `value` is what {@link getValue} returns
+   * @param configKey The config key to evaluate
+   * @param defaultValue The in-code default value, returned when no value from ConfigDirector can be served
+   */
+  evaluate<T extends ConfigValueType>(configKey: string, defaultValue: T): ConfigEvaluation<T>;
   /**
    * Watches for changes to a a config evaluation value. Whenever the config value changes, the
    * provided callback function will be called with the new value. Changes can happen due to updates
@@ -420,5 +441,5 @@ declare class ConfigDirectorInitializationError extends Error {
   constructor(message: string);
 }
 //#endregion
-export { ConfigDirectorLoggingLevel as _, CachingProvider as a, OfflineClientOptions as c, NativeJsonValue as d, NativeValue as f, ConfigDirectorLogger as g, ConfigDirectorLogMessageDecorator as h, CachingOptions as i, OfflineValue as l, ConfigDirectorContext as m, ConfigDirectorInitializationError as n, ConfigDirectorClient as o, NativeValues as p, ConfigDirectorValidationError as r, ConfigDirectorClientOptions as s, ConfigDirectorConnectionError as t, OfflineValues as u, ConfigValueType as v };
-//# sourceMappingURL=errors-K27PrStP.d.mts.map
+export { ConfigDirectorLoggingLevel as _, CachingProvider as a, EvaluationReason as b, OfflineClientOptions as c, NativeJsonValue as d, NativeValue as f, ConfigDirectorLogger as g, ConfigDirectorLogMessageDecorator as h, CachingOptions as i, OfflineValue as l, ConfigDirectorContext as m, ConfigDirectorInitializationError as n, ConfigDirectorClient as o, NativeValues as p, ConfigDirectorValidationError as r, ConfigDirectorClientOptions as s, ConfigDirectorConnectionError as t, OfflineValues as u, ConfigEvaluation as v, ConfigValueType as y };
+//# sourceMappingURL=errors-CkIP6urQ.d.mts.map

package/dist/errors-CkIP6urQ.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-CkIP6urQ.d.mts","names":[],"sources":["../../js-client-core/src/Emitter.ts","../../shared/src/types.ts","../../shared/src/native-values.ts","../../js-client-core/src/types.ts","../../shared/src/errors.ts"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@configdirector/client-sdk",
-  "version": "1.9.1",
+  "version": "1.10.0",
   "description": "Javascript client SDK for ConfigDirector. ConfigDirector is a remote configuration and feature flag service.",
   "license": "MIT",
   "author": "ConfigDirector",