@configdirector/client-sdk 1.5.1 → 1.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +28 -0
- package/dist/DefaultConfigDirectorClient-D-Dl3XYG.cjs +5 -0
- package/dist/DefaultConfigDirectorClient-a018lfK_.mjs +6 -0
- package/dist/DefaultConfigDirectorClient-a018lfK_.mjs.map +1 -0
- package/dist/configdirector-client-testing.cjs +1 -0
- package/dist/configdirector-client-testing.d.cts +119 -0
- package/dist/configdirector-client-testing.d.cts.map +1 -0
- package/dist/configdirector-client-testing.d.mts +119 -0
- package/dist/configdirector-client-testing.d.mts.map +1 -0
- package/dist/configdirector-client-testing.mjs +2 -0
- package/dist/configdirector-client-testing.mjs.map +1 -0
- package/dist/configdirector-client.cjs +1 -5
- package/dist/configdirector-client.d.cts +2 -301
- package/dist/configdirector-client.d.cts.map +1 -1
- package/dist/configdirector-client.d.mts +2 -301
- package/dist/configdirector-client.d.mts.map +1 -1
- package/dist/configdirector-client.mjs +1 -5
- package/dist/configdirector-client.mjs.map +1 -1
- package/dist/errors-BOgYEeJ6.d.cts +307 -0
- package/dist/errors-BOgYEeJ6.d.cts.map +1 -0
- package/dist/errors-zagImFi0.d.mts +307 -0
- package/dist/errors-zagImFi0.d.mts.map +1 -0
- package/package.json +19 -2
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"configdirector-client.mjs","names":["this","this","this","this","this"],"sources":["../../js-client-core/src/Emitter.ts","../../shared/src/errors.ts","../../eventsource/src/errors.ts","../../eventsource/src/EventSourceParser.ts","../../eventsource/src/types.ts","../../eventsource/src/EventSourceClient.ts","../../eventsource/src/index.ts","../../js-client-core/src/StreamingTransport.ts","../../shared/src/value-parser.ts","../../shared/src/logger.ts","../../js-client-core/src/logger.ts","../../shared/src/url.ts","../../shared/src/constants.ts","../../shared/src/instance-id.ts","../../js-client-core/src/instance-id.ts","../../shared/src/transport/AbstractPollingTransport.ts","../../shared/src/fetchWithTimeout.ts","../../js-client-core/src/PollingTransport.ts","../../js-client-core/src/browser-globals.ts","../../js-client-core/src/DefaultConfigDirectorClient.ts","../../shared/src/telemetry/utils.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/BrowserConfigDirectorClient.ts","../src/api.ts"],"sourcesContent":["type EventType = string | symbol;\ntype EventsRecord = Record<EventType, any>;\n\ntype Handler<TEventsRecord extends EventsRecord, TKey extends keyof TEventsRecord> = (\n payload: TEventsRecord[TKey],\n) => void;\n\nexport interface EventProvider<TEventsRecord extends EventsRecord> {\n on<TName extends keyof TEventsRecord>(name: TName, handler: Handler<TEventsRecord, TName>): void;\n off<TName extends keyof TEventsRecord>(name: TName, handler?: Handler<TEventsRecord, TName>): void;\n clear(): void;\n}\n\nexport class Emitter<TEventsRecord extends EventsRecord> implements EventProvider<TEventsRecord> {\n private handlerMap: Map<keyof TEventsRecord, Array<(payload: any) => void>> = new Map();\n\n on<TName extends keyof TEventsRecord>(name: TName, handler: Handler<TEventsRecord, TName>) {\n const handlers = this.handlerMap.get(name);\n if (handlers) {\n handlers.push(handler);\n } else {\n this.handlerMap.set(name, [handler]);\n }\n }\n\n once<TName extends keyof TEventsRecord>(name: TName, handler: Handler<TEventsRecord, TName>) {\n // eslint-disable-next-line @typescript-eslint/no-this-alias\n const self = this;\n function onceHandler(payload: TEventsRecord[keyof TEventsRecord]) {\n self.off(name, onceHandler);\n handler.apply(self, payload);\n }\n this.on(name, onceHandler);\n }\n\n off<TName extends keyof TEventsRecord>(name: TName, handler?: Handler<TEventsRecord, TName>) {\n const handlers = this.handlerMap.get(name);\n if (!handlers) {\n return;\n }\n\n if (handler) {\n const listenerIndex = handlers.indexOf(handler);\n if (listenerIndex >= 0) {\n handlers.splice(listenerIndex, 1);\n }\n } else {\n this.handlerMap.set(name, []);\n }\n }\n\n clear() {\n this.handlerMap.clear();\n }\n\n emit<TName extends keyof TEventsRecord>(name: TName, payload: TEventsRecord[TName]) {\n const handlers = this.handlerMap.get(name);\n if (!handlers) {\n return;\n }\n\n handlers.slice().map((h) => h(payload));\n }\n}\n","export class ConfigDirectorConnectionError extends Error {\n public override readonly name: string = \"ConfigDirectorConnectionError\";\n public readonly status?: number;\n\n constructor(message: string, status?: number) {\n super(message);\n this.status = status;\n\n Object.setPrototypeOf(this, ConfigDirectorConnectionError.prototype);\n }\n}\n\nexport class ConfigDirectorValidationError extends Error {\n public override readonly name: string = \"ConfigDirectorValidationError\";\n\n constructor(message: string) {\n super(message);\n\n Object.setPrototypeOf(this, ConfigDirectorValidationError.prototype);\n }\n}\n\nexport class ConfigDirectorInitializationError extends Error {\n public override readonly name: string = \"ConfigDirectorInitializationError\";\n\n constructor(message: string) {\n super(message);\n\n Object.setPrototypeOf(this, ConfigDirectorInitializationError.prototype);\n }\n}\n","export class StreamClosedError extends Error {\n public override readonly name: string = \"StreamClosedError\";\n\n constructor(message: string) {\n super(message);\n\n Object.setPrototypeOf(this, StreamClosedError.prototype);\n }\n}\n\nexport class MissingResponseBodyError extends Error {\n public override readonly name: string = \"MissingResponseBodyError\";\n\n constructor(message: string) {\n super(message);\n\n Object.setPrototypeOf(this, MissingResponseBodyError.prototype);\n }\n}\n\nexport class InvalidOptionError extends Error {\n public override readonly name: string = \"InvalidOptionError\";\n\n constructor(message: string) {\n super(message);\n\n Object.setPrototypeOf(this, InvalidOptionError.prototype);\n }\n}\n\nexport class ValueOutOfRangeError extends Error {\n public override readonly name: string = \"ValueOutOfRangeError\";\n\n constructor(message: string) {\n super(message);\n\n Object.setPrototypeOf(this, ValueOutOfRangeError.prototype);\n }\n}\n","import {\n type EventSourceParserOptions,\n type EventSourceMessageHandler,\n type EventSourceCommentHandler,\n type EventParserRetryCallback,\n} from \"./types\";\n\ntype ParsedField = {\n field: string;\n value: string;\n};\n\nexport class EventSourceParser {\n private isFirstChunk = true;\n private bufferedInput = \"\";\n private currentEvent: { type?: string; data: string } = { data: \"\" };\n private lastEventId: string | undefined;\n private onEvent: EventSourceMessageHandler;\n private onRetry: EventParserRetryCallback | undefined;\n private onComment: EventSourceCommentHandler | undefined;\n\n constructor(options: EventSourceParserOptions) {\n this.currentEvent = { data: \"\" };\n this.onEvent = options.onEvent ?? (() => {});\n this.onRetry = options.onRetry;\n this.onComment = options.onComment;\n }\n\n public parse(chunk: string): void {\n let input = chunk;\n\n if (this.isFirstChunk) {\n this.isFirstChunk = false;\n if (input.startsWith(\"\\uFEFF\")) {\n input = input.slice(1);\n } else if (input.startsWith(\"\\xEF\\xBB\\xBF\")) {\n input = input.slice(3);\n }\n }\n\n const lines = this.scanLines(this.bufferedInput + input);\n for (const line of lines) {\n this.dispatchLine(line);\n }\n }\n\n // Per the SSE spec, any data still buffered when the stream ends is discarded —\n // an event requires a terminating empty line to be dispatched.\n public finish(): void {\n this.bufferedInput = \"\";\n }\n\n /**\n * Scans `text` character by character to extract complete lines, recognizing\n * CR, LF, and CRLF as line terminators per the SSE spec. Any unterminated\n * trailing text is buffered and prepended to the next chunk.\n */\n private scanLines(text: string): string[] {\n const lines: string[] = [];\n let lineStart = 0;\n let i = 0;\n\n while (i < text.length) {\n const ch = text[i];\n if (ch === \"\\r\" || ch === \"\\n\") {\n lines.push(text.slice(lineStart, i));\n // Consume CRLF as a single terminator rather than two separate lines.\n if (ch === \"\\r\" && text[i + 1] === \"\\n\") {\n i++;\n }\n i++;\n lineStart = i;\n } else {\n i++;\n }\n }\n\n this.bufferedInput = text.slice(lineStart);\n return lines;\n }\n\n private dispatchLine(line: string): void {\n if (line.startsWith(\":\")) {\n this.onComment?.(this.extractValue(line, 1));\n return;\n }\n\n if (line === \"\") {\n this.emitEvent();\n return;\n }\n\n this.applyField(this.parseField(line));\n }\n\n private emitEvent(): void {\n const data = this.currentEvent.data.endsWith(\"\\n\")\n ? this.currentEvent.data.slice(0, -1)\n : this.currentEvent.data;\n\n if (data !== \"\") {\n this.onEvent({ ...this.currentEvent, id: this.lastEventId, data });\n }\n\n this.currentEvent = { data: \"\" };\n }\n\n private applyField(parsed: ParsedField): void {\n switch (parsed.field) {\n case \"event\":\n this.currentEvent.type = parsed.value;\n break;\n case \"data\":\n this.currentEvent.data += parsed.value + \"\\n\";\n break;\n case \"id\":\n // Spec: ignore id values that contain a null character.\n if (!parsed.value.includes(\"\\0\")) {\n this.lastEventId = parsed.value;\n }\n break;\n case \"retry\":\n if (/^\\d+$/.test(parsed.value)) {\n this.onRetry?.(Number.parseInt(parsed.value, 10));\n }\n break;\n default:\n break;\n }\n }\n\n private parseField(line: string): ParsedField {\n const colon = line.indexOf(\":\");\n if (colon === -1) {\n return { field: line, value: \"\" };\n }\n return { field: line.slice(0, colon), value: this.extractValue(line, colon + 1) };\n }\n\n /** Returns the value portion of a line, stripping a single leading space per spec. */\n private extractValue(line: string, from: number): string {\n return line[from] === \" \" ? line.slice(from + 1) : line.slice(from);\n }\n}\n","export type ReconnectionState = {\n attempt: number;\n serverReconnectionTime: number;\n status?: number | undefined;\n error?: Error | undefined;\n};\n\nexport enum ReadyState {\n OPEN = \"open\",\n CLOSED = \"closed\",\n CONNECTING = \"connecting\",\n}\n\nexport type EventSourceClientOptions = {\n url: { toString(): string } | string;\n method?: string;\n headers?: Record<string, string>;\n body?: string | (() => string);\n mode?: \"cors\" | \"no-cors\" | \"same-origin\";\n credentials?: \"include\" | \"omit\" | \"same-origin\";\n redirect?: \"error\" | \"follow\";\n referrer?: string;\n referrerPolicy?: ReferrerPolicy;\n lastEventId?: string;\n fetch?: (url: string, init: RequestInit) => Promise<Response>;\n onError?: (error: Error) => void;\n onConnect?: () => void;\n onDisconnect?: () => void;\n onMessage?: EventSourceMessageHandler;\n onComment?: EventSourceCommentHandler;\n shouldReconnect?: (state: ReconnectionState) => boolean;\n calculateReconnectDelay?: (state: ReconnectionState) => number;\n};\n\nexport type EventSourceMessage = {\n id?: string | undefined;\n type?: string;\n data: string;\n};\n\nexport type EventSourceMessageHandler = (message: EventSourceMessage) => void;\nexport type EventSourceCommentHandler = (comment: string) => void;\n\nexport type EventParserRetryCallback = (retry: number) => void;\n\nexport type EventSourceParserOptions = {\n onEvent?: EventSourceMessageHandler;\n onRetry?: EventParserRetryCallback;\n onComment?: EventSourceCommentHandler;\n};\n","import {\n InvalidOptionError,\n MissingResponseBodyError,\n StreamClosedError,\n ValueOutOfRangeError,\n} from \"./errors\";\nimport { EventSourceParser } from \"./EventSourceParser\";\nimport {\n type EventSourceClientOptions,\n type EventSourceCommentHandler,\n type EventSourceMessageHandler,\n type ReconnectionState,\n ReadyState,\n} from \"./types\";\n\nexport class EventSourceClient {\n private readonly DEFAULT_SHOULD_RECONNECT = () => true;\n private readonly DEFAULT_CALCULATE_RECONNECT_DELAY = () => this.serverReconnectionTime;\n private readonly url: string;\n private readonly headers?: Record<string, string>;\n private readonly body: () => string | undefined;\n private readonly requestOptions;\n private lastEventId?: string;\n private reconnectAttempt: number = 0;\n private abortController: AbortController = new AbortController();\n private reconnectTimeout: ReturnType<typeof setTimeout> | undefined;\n private _readyState: ReadyState = ReadyState.CLOSED;\n private serverReconnectionTime: number = 2_000;\n private _fetch: (url: string, init: RequestInit) => Promise<Response>;\n private _onError: (error: Error) => void;\n private _onMessage: EventSourceMessageHandler;\n private _onComment: EventSourceCommentHandler;\n private _onConnect: () => void;\n private _onDisconnect: () => void;\n private _shouldReconnect: (state: ReconnectionState) => boolean;\n private _calculateReconnectDelay: (state: ReconnectionState) => number;\n\n constructor(options: EventSourceClientOptions) {\n this.url = options.url.toString();\n this.lastEventId = options.lastEventId;\n this.headers = {\n Accept: \"text/event-stream\",\n ...options.headers,\n };\n const body = options.body;\n this.body = typeof body === \"function\" ? body : () => body;\n this.requestOptions = {\n method: options.method ?? \"GET\",\n mode: options.mode,\n credentials: options.credentials,\n redirect: options.redirect,\n referrer: options.referrer,\n referrerPolicy: options.referrerPolicy,\n };\n this._fetch = options.fetch ?? ((url, init) => fetch(url, init));\n this._onError = this.resolveCallback(options.onError, () => {}, \"onError\");\n this._onConnect = this.resolveCallback(options.onConnect, () => {}, \"onConnect\");\n this._onDisconnect = this.resolveCallback(options.onDisconnect, () => {}, \"onDisconnect\");\n this._onMessage = this.resolveCallback(options.onMessage, () => {}, \"onMessage\");\n this._onComment = this.resolveCallback(options.onComment, () => {}, \"onComment\");\n this._shouldReconnect = this.resolveCallback(\n options.shouldReconnect,\n this.DEFAULT_SHOULD_RECONNECT,\n \"shouldReconnect\",\n );\n this._calculateReconnectDelay = this.resolveCallback(\n options.calculateReconnectDelay,\n this.DEFAULT_CALCULATE_RECONNECT_DELAY,\n \"calculateReconnectDelay\",\n );\n }\n\n public set onError(value: (error: Error) => void) {\n this._onError = this.resolveCallback(value, () => {}, \"onError\");\n }\n\n public set onMessage(value: EventSourceMessageHandler) {\n this._onMessage = this.resolveCallback(value, () => {}, \"onMessage\");\n }\n\n public set onComment(value: EventSourceCommentHandler) {\n this._onComment = this.resolveCallback(value, () => {}, \"onComment\");\n }\n\n public set onConnect(value: () => void) {\n this._onConnect = this.resolveCallback(value, () => {}, \"onConnect\");\n }\n\n public set onDisconnect(value: () => void) {\n this._onDisconnect = this.resolveCallback(value, () => {}, \"onDisconnect\");\n }\n\n public set shouldReconnect(value: (state: ReconnectionState) => boolean) {\n this._shouldReconnect = this.resolveCallback(value, this.DEFAULT_SHOULD_RECONNECT, \"shouldReconnect\");\n }\n\n public set calculateReconnectDelay(value: (state: ReconnectionState) => number) {\n this._calculateReconnectDelay = this.resolveCallback(\n value,\n this.DEFAULT_CALCULATE_RECONNECT_DELAY,\n \"shouldReconnect\",\n );\n }\n\n public get readyState(): ReadyState {\n return this._readyState;\n }\n\n public connect() {\n if (this._readyState !== ReadyState.CLOSED) {\n return;\n }\n\n this.reconnectAttempt = 0;\n this.initiateConnection();\n }\n\n public close() {\n clearTimeout(this.reconnectTimeout);\n this._readyState = ReadyState.CLOSED;\n this.abortController.abort();\n }\n\n private initiateConnection() {\n this.abortController = new AbortController();\n this._readyState = ReadyState.CONNECTING;\n\n this._fetch(this.url, {\n ...this.requestOptions,\n body: this.body(),\n headers: this.buildRequestHeaders(),\n signal: this.abortController.signal,\n cache: \"no-store\",\n })\n .then((response) => this.handleFetchResponse(response))\n .catch((error: Error) => {\n if (error.name === \"AbortError\" || this.abortController.signal.aborted) {\n this.close();\n return;\n }\n\n this._onError(error);\n this.scheduleReconnect({ error });\n });\n }\n\n private async handleFetchResponse(response: Response) {\n const { body, status } = response;\n\n if (status === 204) {\n this.disconnected();\n return;\n }\n\n if (status >= 400) {\n this.scheduleReconnect({ status });\n return;\n }\n\n if (!body) {\n throw new MissingResponseBodyError(\"The server response did not have a body\");\n }\n\n this._readyState = ReadyState.OPEN;\n this._onConnect();\n this.reconnectAttempt = 0;\n\n const parser = new EventSourceParser({\n onEvent: (event) => {\n if (typeof event.id === \"string\") {\n this.lastEventId = event.id;\n }\n this._onMessage(event);\n },\n onComment: (comment) => this._onComment(comment),\n onRetry: (retryDelay) => (this.serverReconnectionTime = retryDelay),\n });\n\n await this.readResponseStream(body, parser);\n\n this.scheduleReconnect({\n status,\n error: new StreamClosedError(\"The server response stream was closed\"),\n });\n }\n\n private async readResponseStream(body: ReadableStream<Uint8Array>, parser: EventSourceParser) {\n const reader = body.getReader();\n const decoder = new TextDecoder();\n\n let done = false;\n while (!done) {\n const result = await reader.read();\n if (result.value) {\n parser.parse(decoder.decode(result.value, { stream: true }));\n }\n done = result.done;\n }\n\n parser.finish();\n }\n\n private disconnected() {\n clearTimeout(this.reconnectTimeout);\n this._readyState = ReadyState.CLOSED;\n this._onDisconnect();\n }\n\n private buildRequestHeaders(): Record<string, string> {\n const lastEventIdHeader = this.lastEventId ? { \"Last-Event-ID\": this.lastEventId } : undefined;\n return {\n ...this.headers,\n ...lastEventIdHeader,\n };\n }\n\n private scheduleReconnect(state: { status?: number; error?: Error }) {\n if (this.abortController.signal.aborted) {\n return;\n }\n\n clearTimeout(this.reconnectTimeout);\n this.reconnectAttempt += 1;\n\n const reconnectionState: ReconnectionState = {\n attempt: this.reconnectAttempt,\n status: state.status,\n error: state.error,\n serverReconnectionTime: this.serverReconnectionTime,\n };\n\n if (!this._shouldReconnect(reconnectionState)) {\n this.disconnected();\n return;\n }\n\n this._readyState = ReadyState.CONNECTING;\n let delay = this._calculateReconnectDelay(reconnectionState);\n\n if (!Number.isFinite(delay) || delay < 1 || delay > 1_000 * 60 * 60) {\n this._onError(\n new ValueOutOfRangeError(\n `The calculated reconnect delay is out of range: ${delay}. Defaulting to ${this.serverReconnectionTime}`,\n ),\n );\n delay = this.serverReconnectionTime;\n }\n\n this.reconnectTimeout = setTimeout(() => this.initiateConnection(), delay);\n }\n\n private resolveCallback<T extends (...args: any[]) => any>(\n provided: unknown,\n fallback: T,\n optionName: string,\n ): T {\n if (provided == null) return fallback;\n if (typeof provided !== \"function\") {\n throw new InvalidOptionError(`${optionName} must be a function`);\n }\n return provided as T;\n }\n}\n","import { EventSourceClient } from \"./EventSourceClient\";\nimport { type EventSourceClientOptions } from \"./types\";\n\nexport const createEventSourceClient = (options: EventSourceClientOptions) => {\n return new EventSourceClient(options);\n};\n","import type {\n ConfigDirectorContext,\n ConfigDirectorLogger,\n Transport,\n TransportEvents,\n TransportOptions,\n} from \"./types\";\nimport { Emitter } from \"./Emitter\";\nimport { ConfigDirectorConnectionError } from \"./errors\";\nimport { createEventSourceClient } from \"@eventsource/index\";\nimport type { EventSourceClient } from \"@eventsource/EventSourceClient\";\nimport type { UrlLike } from \"@shared/url\";\n\nexport class StreamingTransport implements Transport {\n private logger: ConfigDirectorLogger;\n private eventSource: EventSourceClient | undefined;\n private eventEmitter = new Emitter<TransportEvents>();\n private url: UrlLike;\n private timeoutTimer: ReturnType<typeof setTimeout> | undefined;\n\n constructor(private readonly options: TransportOptions) {\n this.options = options;\n this.logger = options.logger;\n this.url = options.resolveUrl(\"client/sse/v1\", options.baseUrl);\n }\n\n public async connect(context: ConfigDirectorContext, timeout: number): Promise<this> {\n if (this.eventSource) {\n this.close();\n }\n\n const eventSourcePromise = new Promise<this>((resolve, reject) => {\n this.eventSource = createEventSourceClient({\n url: this.url,\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n fetch: this.options.fetch,\n body: JSON.stringify({\n givenContext: context,\n metaContext: this.options.metaContext,\n clientSdkKey: this.options.clientSdkKey,\n instanceId: this.options.instanceId,\n }),\n\n onMessage: ({ data }) => {\n this.dispatchMessage(data);\n },\n onConnect: () => {\n this.logger.debug(\"[StreamingTransport] Connected\");\n resolve(this);\n },\n shouldReconnect: (state) => {\n const reconnect = !this.isStatusFatal(state.status);\n if (!reconnect) {\n const error = this.prepareFatalError(state.status, state.error);\n this.eventEmitter.emit(\"connectionError\", error);\n reject(error);\n }\n return reconnect;\n },\n calculateReconnectDelay: (state) => {\n const delay = this.options.connectionRetryDelay(state.attempt);\n const logMessage = `[StreamingTransport] Scheduling reconnect attempt #${state.attempt} in ${delay}ms.`;\n if (state.attempt <= 5) {\n this.logger.info(logMessage);\n } else {\n this.logger.warn(logMessage);\n }\n return delay;\n },\n onError: (error) => {\n this.logger.debug(\"[StreamingTransport] Error: \", error);\n },\n onDisconnect: () => {\n this.logger.debug(\"[StreamingTransport] Disconnected\");\n },\n });\n this.eventSource.connect();\n });\n\n clearTimeout(this.timeoutTimer);\n this.timeoutTimer = undefined;\n return Promise.race([\n eventSourcePromise,\n new Promise<this>((resolve) => {\n this.timeoutTimer = setTimeout(() => resolve(this), timeout);\n }),\n ]).finally(() => clearTimeout(this.timeoutTimer));\n }\n\n private dispatchMessage(data: string) {\n try {\n const json = JSON.parse(data);\n this.eventEmitter.emit(\"configSetReceived\", json);\n } catch (error) {\n this.logger.error(\"[StreamingTransport] Error parsing and dispatching config data update: \", error);\n }\n }\n\n private prepareFatalError(\n responseStatus: number | undefined,\n error: Error | undefined,\n ): ConfigDirectorConnectionError {\n const status = responseStatus ?? 0;\n const headline = `Connection failed with status: ${responseStatus ?? \"unknown\"}.`;\n const errorLine = error ? ` Error: ${error}` : \"\";\n const message = `${headline}${errorLine}. This is an unrecoverable error, will not attempt to reconnect.`;\n return new ConfigDirectorConnectionError(message, status);\n }\n\n private isStatusFatal(status: number | undefined): boolean {\n return !!status && status >= 400 && status < 500 && status != 429;\n }\n\n public on<TName extends keyof TransportEvents>(\n name: TName,\n handler: (payload: TransportEvents[TName]) => void,\n ): void {\n this.eventEmitter.on(name, handler);\n }\n\n public off<TName extends keyof TransportEvents>(\n name: TName,\n handler?: ((payload: TransportEvents[TName]) => void) | undefined,\n ): void {\n this.eventEmitter.off(name, handler);\n }\n\n public clear(): void {\n this.eventEmitter.clear();\n }\n\n public close() {\n this.eventSource?.close();\n clearTimeout(this.timeoutTimer);\n }\n\n public dispose(): void {\n this.close();\n this.clear();\n }\n}\n","import type { ConfigState, ConfigType, ConfigValueType, EvaluationReason } from \"./types\";\n\ntype NativeType = \"string\" | \"number\" | \"bigint\" | \"boolean\" | \"symbol\" | \"undefined\" | \"object\" | \"function\";\n\ntype ParseResult<T extends ConfigValueType> = {\n parsedValue: T;\n parsedValueId: string | null | undefined;\n requestedType: NativeType | string;\n usedDefault: boolean;\n reason: EvaluationReason;\n};\n\nexport const getRequestedType = <T extends ConfigValueType>(defaultValue: T): string => {\n const baseType = typeof defaultValue;\n if (baseType === \"object\") {\n try {\n return (defaultValue as object).constructor?.name ?? baseType;\n } catch {\n return baseType;\n }\n } else if (baseType === \"function\") {\n try {\n const functionName = (defaultValue as any).name;\n return functionName ? `function: ${functionName}` : baseType;\n } catch {\n return baseType;\n }\n }\n return baseType;\n};\n\nconst isNumericNativeType = (requestedType: NativeType): boolean => {\n return requestedType === \"number\" || requestedType === \"bigint\";\n};\n\nconst configTypesNotReadableAsString: ReadonlySet<ConfigType> = new Set<ConfigType>([\"boolean\", \"integer\", \"float\"]);\n\nexport const parseConfigValue = <T extends ConfigValueType>(\n configState: ConfigState,\n defaultValue: T,\n): ParseResult<T> => {\n const value = configState.value;\n const requestedType = getRequestedType(defaultValue);\n\n if (value == null) {\n return {\n parsedValue: defaultValue as T,\n parsedValueId: undefined,\n requestedType,\n usedDefault: true,\n reason: \"value-missing\",\n };\n }\n\n if (configState.type === \"json\") {\n return parseJson(value, defaultValue, requestedType, configState.valueId);\n }\n\n if (typeof defaultValue === \"string\") {\n if (configTypesNotReadableAsString.has(configState.type)) {\n return {\n parsedValue: defaultValue,\n parsedValueId: undefined,\n requestedType,\n usedDefault: true,\n reason: \"type-mismatch\",\n };\n }\n return {\n parsedValue: value as T,\n parsedValueId: configState.valueId,\n requestedType,\n usedDefault: false,\n reason: \"found-match\",\n };\n }\n\n if (\n typeof defaultValue === \"boolean\" &&\n (configState.type === \"boolean\" || configState.type === \"string\" || configState.type === \"enum\")\n ) {\n const boolValue = parseConfigBoolean(value);\n const hasBoolean = typeof boolValue === \"boolean\";\n return {\n parsedValue: (hasBoolean ? boolValue : defaultValue) as T,\n parsedValueId: hasBoolean ? configState.valueId : undefined,\n requestedType,\n usedDefault: !hasBoolean,\n reason: hasBoolean ? \"found-match\" : \"invalid-boolean\",\n };\n }\n\n if (isNumericNativeType(typeof defaultValue) && configState.type === \"integer\") {\n const numValue = parseConfigInteger(value);\n const hasNumber = typeof numValue === \"number\";\n return {\n parsedValue: (hasNumber ? numValue : defaultValue) as T,\n parsedValueId: hasNumber ? configState.valueId : undefined,\n requestedType,\n usedDefault: !hasNumber,\n reason: hasNumber ? \"found-match\" : \"invalid-number\",\n };\n }\n if (\n isNumericNativeType(typeof defaultValue) &&\n (configState.type === \"float\" || configState.type === \"enum\" || configState.type === \"string\")\n ) {\n const numValue = parseConfigFloat(value);\n const hasNumber = typeof numValue === \"number\";\n return {\n parsedValue: (hasNumber ? numValue : defaultValue) as T,\n parsedValueId: hasNumber ? configState.valueId : undefined,\n requestedType,\n usedDefault: !hasNumber,\n reason: hasNumber ? \"found-match\" : \"invalid-number\",\n };\n }\n\n return {\n parsedValue: defaultValue,\n parsedValueId: undefined,\n requestedType,\n usedDefault: true,\n reason: \"type-mismatch\",\n };\n};\n\nconst parseConfigBoolean = (value: string): boolean | undefined => {\n if (!value) {\n return;\n }\n const lowerValue = value.toLowerCase();\n if (lowerValue != \"true\" && lowerValue != \"false\") {\n return;\n }\n return lowerValue === \"true\";\n};\n\nconst parseConfigInteger = (value: string): number | undefined => {\n const num = parseStrictNumber(value);\n return num == null ? undefined : Math.trunc(num);\n};\n\nconst parseConfigFloat = (value: string): number | undefined => {\n return parseStrictNumber(value);\n};\n\nconst parseStrictNumber = (value: string): number | undefined => {\n if (!value || !isDecimalCharacters(value)) {\n return;\n }\n const num = Number(value);\n if (isNaN(num) || !isFinite(num)) {\n return;\n }\n return num;\n};\n\nconst isDecimalCharacters = (value: string): boolean => {\n for (const character of value) {\n const isDigit = character >= \"0\" && character <= \"9\";\n if (!isDigit && !\"+-.eE\".includes(character)) {\n return false;\n }\n }\n return true;\n};\n\nconst parseJson = <T extends ConfigValueType>(\n jsonString: string,\n defaultValue: T,\n requestedType: string,\n valueId: string | null | undefined,\n): ParseResult<T> => {\n if (typeof defaultValue === \"string\") {\n return {\n parsedValue: jsonString as T,\n parsedValueId: valueId,\n requestedType,\n usedDefault: false,\n reason: \"found-match\",\n };\n }\n\n try {\n const parsed = JSON.parse(jsonString);\n if (!isJsonTypeCompatible(parsed, defaultValue)) {\n return {\n parsedValue: defaultValue,\n parsedValueId: undefined,\n requestedType,\n usedDefault: true,\n reason: \"type-mismatch\",\n };\n }\n return {\n parsedValue: parsed,\n parsedValueId: valueId,\n requestedType,\n usedDefault: false,\n reason: \"found-match\",\n };\n } catch {\n return {\n parsedValue: defaultValue,\n parsedValueId: undefined,\n requestedType,\n usedDefault: true,\n reason: \"invalid-json\",\n };\n }\n};\n\nconst isJsonTypeCompatible = (parsed: unknown, defaultValue: ConfigValueType): boolean => {\n if (parsed === null) {\n return false;\n }\n const defaultType = typeof defaultValue;\n if (defaultType === \"bigint\") {\n return typeof parsed === \"number\";\n }\n return typeof parsed === defaultType;\n};\n","import type { ConfigDirectorLogger, ConfigDirectorLogMessageDecorator, ConfigDirectorLoggingLevel } from \"./types\";\n\nconst LEVELS: Record<ConfigDirectorLoggingLevel, number> = {\n off: -1,\n error: 0,\n warn: 1,\n info: 2,\n debug: 3,\n};\n\nconst buildDateFormatter = () => {\n const baseOptions: Intl.DateTimeFormatOptions = {\n year: \"numeric\",\n month: \"2-digit\",\n day: \"2-digit\",\n hour: \"2-digit\",\n minute: \"2-digit\",\n second: \"2-digit\",\n timeZoneName: \"short\",\n };\n\n try {\n return new Intl.DateTimeFormat(\n undefined,\n { ...baseOptions, fractionalSecondDigits: 3 } as Intl.DateTimeFormatOptions,\n );\n } catch {\n return new Intl.DateTimeFormat(undefined, baseOptions);\n }\n};\n\nexport class DefaultConsoleLogger implements ConfigDirectorLogger {\n private readonly dateFormatter;\n\n constructor(private readonly level: ConfigDirectorLoggingLevel, private readonly decorator: ConfigDirectorLogMessageDecorator) {\n this.level = level;\n this.decorator = decorator;\n this.dateFormatter = buildDateFormatter();\n }\n\n debug(message: string, ...args: any): void {\n this.log(console.debug, \"debug\", message, ...args);\n }\n\n info(message: string, ...args: any): void {\n this.log(console.info, \"info\", message, ...args);\n }\n\n warn(message: string, ...args: any): void {\n this.log(console.warn, \"warn\", message, ...args);\n }\n\n error(message: string, ...args: any): void {\n this.log(console.error, \"error\", message, ...args);\n }\n\n protected log(loggerFunction: (...args: any) => void, level: ConfigDirectorLoggingLevel, message: string, ...args: any) {\n if (LEVELS[this.level] >= LEVELS[level]) {\n loggerFunction(`[${this.dateFormatter.format(new Date())}] ${this.decorator?.decorateMessage(message)}`, ...args);\n }\n }\n}\n","import { type ConfigDirectorLogMessageDecorator, type ConfigDirectorLoggingLevel } from \"./types\";\nimport { DefaultConsoleLogger } from \"../../shared/src/logger\";\nexport { DefaultConsoleLogger } from \"../../shared/src/logger\";\n\nclass LogMessageDecorator implements ConfigDirectorLogMessageDecorator {\n decorateMessage(message: string): string {\n return `[ConfigDirector:js-client-sdk] ${message}`;\n }\n}\n\nexport const createDefaultLogger = (\n level?: ConfigDirectorLoggingLevel,\n messageDecorator?: ConfigDirectorLogMessageDecorator,\n) => {\n return new DefaultConsoleLogger(level ?? \"warn\", messageDecorator ?? new LogMessageDecorator());\n};\n","import { ConfigDirectorValidationError } from \"./errors\";\n\nexport interface UrlLike {\n toString(): string;\n}\n\nexport type UrlFactory = (input: string, base?: UrlLike) => UrlLike;\n\nexport const defaultUrlFactory: UrlFactory = (input, base) => new URL(input, base?.toString());\n\nexport const parseUrl = (url: string | undefined): URL | undefined => {\n if (!url) {\n return;\n }\n\n try {\n return new URL(url);\n } catch (error) {\n throw new ConfigDirectorValidationError(`Invalid URL '${url}'. Parsing failed: ${error}`);\n }\n};\n","export const CLIENT_BASE_URL = \"https://client-sdk-api.configdirector.com\";\n","// React Native's Hermes engine does not expose a global `crypto`, unlike browsers and Node 19+.\nexport const generateInstanceId = (): string => {\n if (typeof crypto !== \"undefined\" && typeof crypto.randomUUID === \"function\") {\n return crypto.randomUUID();\n }\n\n return \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, (placeholder) => {\n const random = (Math.random() * 16) | 0;\n const value = placeholder === \"x\" ? random : (random & 0x3) | 0x8;\n return value.toString(16);\n });\n};\n","import { generateInstanceId } from \"@shared/instance-id\";\nimport type { ConfigDirectorLogger } from \"./types\";\n\nconst STORAGE_KEY = \"configdirector-sdk:instance-id\";\nconst RECORD_VERSION = 1;\nconst MAX_AGE_MS = 6 * 60 * 60 * 1_000;\nconst CHECKSUM_SALT = \"configdirector.instanceId.v1\";\nconst UUID_V4_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;\n\ntype StoredInstanceId = {\n v: number;\n id: string;\n createdAt: number;\n checksum: string;\n};\n\nconst fnv1a = (input: string, offsetBasis: number): number => {\n let hash = offsetBasis;\n for (let i = 0; i < input.length; i++) {\n hash ^= input.charCodeAt(i);\n hash = Math.imul(hash, 0x01000193);\n }\n return hash >>> 0;\n};\n\nconst checksumFor = (id: string, createdAt: number): string => {\n const payload = `${CHECKSUM_SALT}|${id}|${createdAt}`;\n const low = fnv1a(payload, 0x811c9dc5);\n const high = fnv1a(`${low}|${payload}`, 0x01000193);\n return high.toString(16).padStart(8, \"0\") + low.toString(16).padStart(8, \"0\");\n};\n\nconst getLocalStorage = (): Storage | undefined => {\n try {\n return (globalThis as { localStorage?: Storage }).localStorage ?? undefined;\n } catch {\n return undefined;\n }\n};\n\nconst isUsableRecord = (record: unknown): record is StoredInstanceId => {\n if (!record || typeof record !== \"object\") {\n return false;\n }\n\n const { v, id, createdAt, checksum } = record as Partial<StoredInstanceId>;\n if (v !== RECORD_VERSION || typeof id !== \"string\" || typeof checksum !== \"string\") {\n return false;\n }\n\n if (typeof createdAt !== \"number\" || !Number.isInteger(createdAt) || createdAt <= 0) {\n return false;\n }\n\n if (!UUID_V4_PATTERN.test(id)) {\n return false;\n }\n\n return checksum === checksumFor(id, createdAt);\n};\n\nconst readStoredInstanceId = (storage: Storage, logger?: ConfigDirectorLogger): string | undefined => {\n let raw: string | null;\n try {\n raw = storage.getItem(STORAGE_KEY);\n } catch (error) {\n logger?.debug(\"[ConfigDirectorClient] Could not read the stored instance id, generating a new one\", error);\n return undefined;\n }\n\n if (!raw) {\n return undefined;\n }\n\n let record: unknown;\n try {\n record = JSON.parse(raw);\n } catch {\n logger?.debug(\"[ConfigDirectorClient] The stored instance id is not valid JSON, generating a new one\");\n return undefined;\n }\n\n if (!isUsableRecord(record)) {\n logger?.debug(\"[ConfigDirectorClient] The stored instance id failed validation, generating a new one\");\n return undefined;\n }\n\n const age = Date.now() - record.createdAt;\n if (age < 0 || age >= MAX_AGE_MS) {\n logger?.debug(\"[ConfigDirectorClient] The stored instance id has expired, generating a new one\");\n return undefined;\n }\n\n return record.id;\n};\n\nconst storeInstanceId = (storage: Storage, id: string, logger?: ConfigDirectorLogger) => {\n const createdAt = Date.now();\n const record: StoredInstanceId = { v: RECORD_VERSION, id, createdAt, checksum: checksumFor(id, createdAt) };\n try {\n storage.setItem(STORAGE_KEY, JSON.stringify(record));\n } catch (error) {\n logger?.debug(\"[ConfigDirectorClient] Could not persist the instance id\", error);\n }\n};\n\nexport const resolveInstanceId = (logger?: ConfigDirectorLogger): string => {\n const storage = getLocalStorage();\n if (!storage) {\n return generateInstanceId();\n }\n\n const storedInstanceId = readStoredInstanceId(storage, logger);\n if (storedInstanceId) {\n return storedInstanceId;\n }\n\n const instanceId = generateInstanceId();\n storeInstanceId(storage, instanceId, logger);\n return instanceId;\n};\n","import { ConfigDirectorConnectionError } from \"../errors\";\n\nexport abstract class AbstractPollingTransport {\n protected fatalError = false;\n protected pollingInterval: ReturnType<typeof setInterval> | undefined;\n protected pollingIntervalSeconds: number = 60;\n\n protected clearPollingInterval() {\n clearInterval(this.pollingInterval);\n }\n\n protected schedulePollingInterval(callback: () => void) {\n clearInterval(this.pollingInterval);\n if (this.pollingIntervalSeconds <= 0) {\n return;\n }\n this.pollingInterval = setInterval(callback, this.pollingIntervalSeconds * 1_000);\n }\n\n protected async handleNonOkResponse(response: Response) {\n if (!response.ok) {\n if (this.isStatusFatal(response.status)) {\n this.fatalError = true;\n this.close();\n throw this.prepareFatalResponseStatusError(response.status, await response.text());\n } else {\n throw new ConfigDirectorConnectionError(\n `Connection failed with status: ${response.status}`,\n response.status,\n );\n }\n }\n }\n\n protected handleFetchError(fetchError: unknown) {\n if (this.isFetchErrorFatal(fetchError)) {\n this.fatalError = true;\n this.close();\n throw new ConfigDirectorConnectionError(\n `Connection failed with fatal error: ${fetchError}. This is an unrecoverable error, retry attempts will be ignored.`,\n );\n } else if (fetchError instanceof SyntaxError) {\n throw new ConfigDirectorConnectionError(`Failed to parse the response from the server: ${fetchError}`);\n } else {\n throw new ConfigDirectorConnectionError(`Connection failed with error: ${fetchError}.`);\n }\n }\n\n protected prepareFatalResponseStatusError(\n responseStatus: number,\n errorBody: string | undefined,\n ): ConfigDirectorConnectionError {\n const status = responseStatus ?? 0;\n const headline = `Connection failed with status: ${responseStatus ?? \"unknown\"}`;\n const serverBody = (errorBody?.trim()?.length ?? 0) > 0 ? ` (${errorBody})` : \"\";\n const message = `${headline}${serverBody}. This is an unrecoverable error, retry attempts will be ignored.`;\n return new ConfigDirectorConnectionError(message, status);\n }\n\n protected isStatusFatal(status: number | undefined): boolean {\n return !!status && status >= 400 && status < 500 && status != 429;\n }\n\n protected isFetchErrorFatal(fetchError: unknown): boolean {\n return (fetchError as any)?.name === \"NotAllowedError\";\n }\n\n public get isConnected(): boolean {\n return this.pollingInterval !== undefined;\n }\n\n public close() {\n clearInterval(this.pollingInterval);\n this.pollingInterval = undefined;\n }\n\n public abstract clear(): void;\n\n public dispose(): void {\n this.close();\n this.clear();\n }\n}\n","import { type ConfigDirectorLogger } from \"./types\";\nimport type { UrlLike } from \"./url\";\n\nexport const fetchWithTimeout = async (\n timeout: number,\n resource: string | UrlLike | Request,\n options: RequestInit | undefined,\n logger: ConfigDirectorLogger,\n) => {\n const abortController = new AbortController();\n const abortTimeoutId = setTimeout(() => {\n logger.debug(\"[fetchWithTimeout] Reached timeout, aborting request\");\n abortController.abort();\n }, timeout);\n\n try {\n const response = await fetch(typeof resource === \"string\" || resource instanceof Request ? resource : resource.toString(), {\n ...options,\n signal: abortController.signal,\n });\n clearTimeout(abortTimeoutId);\n return response;\n } catch (error) {\n logger.warn(\"[fetchWithTimeout] Fetch error: \", error);\n clearTimeout(abortTimeoutId);\n throw error;\n }\n};\n","import type {\n ConfigDirectorContext,\n ConfigDirectorLogger,\n Transport,\n TransportEvents,\n TransportOptions,\n} from \"./types\";\nimport { Emitter } from \"./Emitter\";\nimport { AbstractPollingTransport } from \"@shared/transport/AbstractPollingTransport\";\nimport { fetchWithTimeout } from \"@shared/fetchWithTimeout\";\nimport type { UrlLike } from \"@shared/url\";\n\nexport class PollingTransport extends AbstractPollingTransport implements Transport {\n private logger: ConfigDirectorLogger;\n private eventEmitter = new Emitter<TransportEvents>();\n private url: UrlLike;\n private lastUpdateTimestamp: string | undefined;\n\n constructor(private readonly options: TransportOptions) {\n super();\n this.options = options;\n this.logger = options.logger;\n this.url = options.resolveUrl(\"client/polling/v1\", options.baseUrl);\n const requestedInterval = options.pollingInterval ?? 300;\n if (requestedInterval < 60) {\n this.logger.warn(\n `[PollingTransport] pollingInterval of ${requestedInterval} seconds is below the minimum of 60 seconds. Using 60 seconds.`,\n );\n }\n this.pollingIntervalSeconds = Math.max(requestedInterval, 60);\n }\n\n public async connect(context: ConfigDirectorContext, timeout: number): Promise<this> {\n this.clearPollingInterval();\n\n try {\n await this.fetchConfigs(context, timeout);\n } finally {\n // A transient failure on the first fetch must not leave the client without a\n // connection, so polling is scheduled either way. An unrecoverable failure has\n // already closed the transport and must not be retried.\n if (!this.fatalError) {\n this.schedulePollingInterval(() => {\n void this.fetchConfigs(context, timeout).catch((error) => {\n this.logger.error(\"[PollingTransport] Error during polling:\", error);\n });\n });\n }\n }\n\n return this;\n }\n\n private async fetchConfigs(context: ConfigDirectorContext, timeout: number) {\n if (this.fatalError) {\n this.logger.warn(\n \"[PollingTransport] There was a prior unrecoverable error. Ignoring attempt to reconnect.\",\n );\n return;\n }\n\n try {\n const response = await fetchWithTimeout(\n timeout,\n this.url,\n {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify({\n givenContext: context,\n metaContext: this.options.metaContext,\n clientSdkKey: this.options.clientSdkKey,\n instanceId: this.options.instanceId,\n lastUpdateTimestamp: this.lastUpdateTimestamp,\n }),\n },\n this.logger,\n );\n\n await this.handleNonOkResponse(response);\n\n if (response.status == 200) {\n const json = JSON.parse(await response.text());\n this.lastUpdateTimestamp = json.timestamp;\n this.eventEmitter.emit(\"configSetReceived\", json);\n }\n } catch (fetchError) {\n try {\n this.handleFetchError(fetchError);\n } catch (handledError) {\n if (this.fatalError) {\n this.eventEmitter.emit(\"connectionError\", handledError as Error);\n }\n throw handledError;\n }\n }\n }\n\n public on<TName extends keyof TransportEvents>(\n name: TName,\n handler: (payload: TransportEvents[TName]) => void,\n ): void {\n this.eventEmitter.on(name, handler);\n }\n\n public off<TName extends keyof TransportEvents>(\n name: TName,\n handler?: ((payload: TransportEvents[TName]) => void) | undefined,\n ): void {\n this.eventEmitter.off(name, handler);\n }\n\n public clear(): void {\n this.eventEmitter.clear();\n }\n}\n","type BrowserGlobals = {\n navigator?: { userAgent?: string };\n location?: { host?: string };\n};\n\nconst read = (readValue: (globals: BrowserGlobals) => string | undefined): string | undefined => {\n try {\n return readValue(globalThis as BrowserGlobals);\n } catch {\n return undefined;\n }\n};\n\nexport const readUserAgent = (): string | undefined => read((globals) => globals.navigator?.userAgent);\n\nexport const readHost = (): string | undefined => read((globals) => globals.location?.host);\n","import { Emitter } from \"./Emitter\";\nimport { StreamingTransport } from \"./StreamingTransport\";\nimport { getRequestedType, parseConfigValue } from \"../../shared/src/value-parser\";\nimport type {\n ConfigSet,\n ConfigState,\n ConfigStateMap,\n ConfigDirectorContext,\n ConfigDirectorClientOptions,\n ConfigDirectorClient,\n ClientEvents,\n WatchHandler,\n ConfigValueType,\n ConfigDirectorLogger,\n Transport,\n ClientConnectAction,\n IdentifyingSdkOptions,\n InternalClientOptions,\n ConnectionMode,\n ConfigEvaluation,\n HookHandler,\n} from \"./types\";\nimport { createDefaultLogger } from \"./logger\";\nimport { ConfigDirectorValidationError } from \"./errors\";\nimport type { TelemetryClient } from \"./telemetry\";\nimport { defaultUrlFactory } from \"@shared/url\";\nimport type { UrlFactory, UrlLike } from \"@shared/url\";\nimport { CLIENT_BASE_URL } from \"@shared/constants\";\nimport { resolveInstanceId } from \"./instance-id\";\nimport { PollingTransport } from \"./PollingTransport\";\nimport { readHost, readUserAgent } from \"./browser-globals\";\nconst MAX_EXPONENTIAL_DELAY = 9; // 2^9 = 512 seconds, to cap it to under 10min\n\ntype WatchHandlerWithOptions<T extends ConfigValueType> = {\n handler: WatchHandler<T>;\n defaultValue: T;\n requestedType: string;\n};\n\nexport class DefaultConfigDirectorClient implements ConfigDirectorClient {\n private logger: ConfigDirectorLogger;\n private telemetryClient: TelemetryClient;\n private configSet: ConfigSet | undefined;\n private handlersMap: Map<string, WatchHandlerWithOptions<any>[]> = new Map();\n private transport: Transport;\n private eventEmitter = new Emitter<ClientEvents>();\n private timeout: number;\n private timeoutTimer: ReturnType<typeof setTimeout> | undefined;\n private ready = false;\n private initializing = false;\n private readyPromise: Promise<void> | undefined;\n private readyResolve: ((cancelled?: boolean) => void) | undefined;\n private currentContext?: ConfigDirectorContext;\n private connectionMode: ConnectionMode;\n private instanceId: string;\n\n constructor(\n telemetryClient: TelemetryClient,\n clientSdkKey: string,\n sdkOptions: IdentifyingSdkOptions,\n clientOptions?: ConfigDirectorClientOptions,\n internalClientOptions?: InternalClientOptions,\n ) {\n this.logger = clientOptions?.logger ?? createDefaultLogger();\n this.instanceId = resolveInstanceId(this.logger);\n this.timeout = clientOptions?.connection?.timeout ?? 3_000;\n this.validateSdkKeyPresence(clientSdkKey);\n const urlFactory: UrlFactory = internalClientOptions?.urlFactory ?? defaultUrlFactory;\n const baseUrl = this.parseUrl(clientOptions?.connection?.url, urlFactory) ?? CLIENT_BASE_URL;\n this.connectionMode = clientOptions?.connection?.mode ?? \"streaming\";\n const transportConstructor = this.getTransportConstructor(this.connectionMode);\n this.telemetryClient = telemetryClient;\n this.transport = new transportConstructor({\n instanceId: this.instanceId,\n clientSdkKey,\n baseUrl,\n resolveUrl: urlFactory,\n metaContext: {\n ...clientOptions?.metadata,\n sdkName: sdkOptions.sdkName,\n sdkVersion: sdkOptions.sdkVersion,\n userAgent: readUserAgent(),\n host: readHost(),\n },\n logger: this.logger,\n fetch: internalClientOptions?.fetch,\n connectionRetryDelay:\n internalClientOptions?.connectionRetryDelay ??\n ((attempt: number) => {\n const seconds = Math.pow(2, Math.min(attempt, MAX_EXPONENTIAL_DELAY));\n return seconds * 1_000;\n }),\n pollingInterval: clientOptions?.connection?.pollingInterval,\n });\n\n this.transport.on(\"configSetReceived\", (configSet: ConfigSet) => {\n this.readyResolve?.();\n const configKeys = Object.keys(configSet.configs);\n if (!this.configSet || configSet.kind == \"full\") {\n this.configSet = configSet;\n this.emit(\"configsUpdated\", { keys: configKeys });\n this.updateWatchers(configSet.configs);\n } else {\n this.configSet.configs = {\n ...this.configSet.configs,\n ...configSet.configs,\n };\n this.emit(\"configsUpdated\", { keys: configKeys });\n this.updateWatchers(configSet.configs);\n }\n this.logger.debug(\"[ConfigDirectorClient] ConfigSet updated from server:\", { keys: configKeys });\n });\n\n this.transport.on(\"connectionError\", (error: Error) => {\n this.logger.error(\n \"[ConfigDirectorClient] The connection encountered an unrecoverable error and will not be retried. Configs will no longer receive updates.\",\n error,\n );\n this.emit(\"connectionError\", { error });\n });\n\n this.registerHandler(\"clientReady\", clientOptions?.hooks?.clientReady);\n this.registerHandler(\"configEvaluated\", clientOptions?.hooks?.configEvaluated);\n this.registerHandler(\"configsUpdated\", clientOptions?.hooks?.configsUpdated);\n this.registerHandler(\"contextUpdated\", clientOptions?.hooks?.contextUpdated);\n this.registerHandler(\"connectionError\", clientOptions?.hooks?.connectionError);\n }\n\n private registerHandler<T extends keyof ClientEvents>(\n event: T,\n handler: HookHandler<T> | HookHandler<T>[] | undefined,\n ) {\n if (!handler) {\n return;\n }\n\n const handlers = Array.isArray(handler) ? handler : [handler];\n for (const h of handlers) {\n if (typeof h === \"function\") {\n this.on(event, h);\n }\n }\n }\n\n private getTransportConstructor(connectionMode?: ConnectionMode) {\n switch (connectionMode) {\n case \"polling\":\n return PollingTransport;\n default:\n return StreamingTransport;\n }\n }\n\n public async initialize(context?: ConfigDirectorContext) {\n this.initializing = true;\n await this.connectToTransport(context, \"initialization\");\n }\n\n public async updateContext(context: ConfigDirectorContext) {\n await this.connectToTransport(context, \"context update\");\n }\n\n public get context(): ConfigDirectorContext | undefined {\n return this.currentContext;\n }\n\n private async connectToTransport(context: ConfigDirectorContext | undefined, caller: ClientConnectAction) {\n try {\n this.ready = false;\n this.readyPromise = new Promise<boolean | undefined>((resolve) => {\n this.readyResolve = resolve;\n }).then((cancelled) => {\n if (cancelled) {\n return;\n }\n this.ready = true;\n this.initializing = false;\n this.emit(\"clientReady\", { action: caller });\n this.logger.debug(\"[ConfigDirectorClient] Received initial payload from the server, client is ready\");\n });\n const startTime = new Date().getTime();\n await this.transport.connect(context ?? {}, this.timeout);\n this.currentContext = context;\n this.telemetryClient.updateContext(context);\n this.emit(\"contextUpdated\", { context });\n\n const elapsedTime = new Date().getTime() - startTime;\n const remainingTimeout = this.timeout - elapsedTime;\n clearTimeout(this.timeoutTimer);\n this.timeoutTimer = undefined;\n if (remainingTimeout > 0) {\n await Promise.race([\n this.readyPromise,\n new Promise<void>((resolve) => {\n this.timeoutTimer = setTimeout(() => resolve(), remainingTimeout);\n }),\n ]).finally(() => clearTimeout(this.timeoutTimer));\n }\n\n if (!this.ready) {\n const warningDetails =\n \"The client will continue to retry since there were no fatal errors detected. Configs will return the default value until the connection succeeds.\";\n this.logger.warn(\n `[ConfigDirectorClient] Timed out waiting for ${caller} after ${this.timeout}ms. ${warningDetails}`,\n );\n }\n } catch (error) {\n this.logger.error(`[ConfigDirectorClient] An error occurred during ${caller}: `, error);\n }\n }\n\n private updateWatchers(configsMap: ConfigStateMap) {\n Object.values(configsMap).forEach((v) => this.updateWatchersForConfig(v));\n }\n\n private updateWatchersForConfig(configState: ConfigState) {\n this.handlersMap.get(configState.key)?.forEach((h) => {\n const value = this.getValueFromConfigState(configState.key, configState, h.defaultValue);\n h.handler(value);\n });\n }\n\n public watch<T extends ConfigValueType>(configKey: string, defaultValue: T, callback: WatchHandler<T>) {\n this.validateDefaultValue(defaultValue);\n\n const handlers = this.handlersMap.get(configKey);\n const handlerWithOptions = { handler: callback, defaultValue, requestedType: typeof defaultValue };\n if (handlers) {\n handlers.push(handlerWithOptions);\n } else {\n this.handlersMap.set(configKey, [handlerWithOptions]);\n }\n\n return () => this.unwatch(configKey, callback);\n }\n\n public unwatch<T extends ConfigValueType>(configKey: string, callback?: WatchHandler<T>) {\n const handlers = this.handlersMap.get(configKey);\n if (!handlers) {\n return;\n }\n\n if (callback) {\n const index = handlers.findIndex((h) => h.handler == callback);\n if (index >= 0) {\n handlers?.splice(index, 1);\n }\n } else {\n handlers.splice(0);\n }\n }\n\n public getValue<T extends ConfigValueType>(configKey: string, defaultValue: T): T {\n this.validateDefaultValue(defaultValue);\n\n const configState = this.configSet?.configs[configKey];\n return this.getValueFromConfigState(configKey, configState, defaultValue);\n }\n\n private getValueFromConfigState<T extends ConfigValueType>(\n configKey: string,\n configState: ConfigState | undefined,\n defaultValue: T,\n ): T {\n if (!configState) {\n this.logger.debug(\n `[ConfigDirectorClient] No config state found for '${configKey}', returning default value '${defaultValue}'`,\n );\n const reason = this.isReady ? \"config-state-missing\" : \"client-not-ready\";\n this.telemetryClient.evaluatedConfig({\n contextId: this.currentContext?.id,\n key: configKey,\n defaultValue: defaultValue,\n requestedType: getRequestedType(defaultValue),\n evaluatedValue: defaultValue,\n usedDefault: true,\n evaluationReason: reason,\n });\n this.dispatchEvaluationEvent({\n key: configKey,\n value: defaultValue,\n isDefaultValue: true,\n reason,\n context: this.context,\n });\n return defaultValue;\n }\n\n const parseResult = parseConfigValue<T>(configState, defaultValue);\n this.telemetryClient.evaluatedConfig({\n contextId: this.currentContext?.id,\n type: configState.type,\n key: configKey,\n defaultValue: defaultValue,\n requestedType: parseResult.requestedType,\n evaluatedValue: parseResult.parsedValue,\n evaluatedValueId: parseResult.parsedValueId,\n usedDefault: parseResult.usedDefault,\n evaluationReason: parseResult.reason,\n });\n this.dispatchEvaluationEvent({\n key: configKey,\n value: parseResult.parsedValue,\n valueId: parseResult.parsedValueId ?? undefined,\n isDefaultValue: parseResult.usedDefault,\n reason: parseResult.reason,\n context: this.context,\n });\n this.logger.debug(`[ConfigDirectorClient] Evaluated '${configKey}' to '${parseResult.parsedValue}'`);\n return parseResult.parsedValue;\n }\n\n private dispatchEvaluationEvent(event: ConfigEvaluation) {\n setTimeout(() => this.emit(\"configEvaluated\", { evaluation: event }), 0);\n }\n\n private emit<TName extends keyof ClientEvents>(name: TName, payload: ClientEvents[TName]) {\n try {\n this.eventEmitter.emit(name, payload);\n } catch (error) {\n this.logger.error(`[ConfigDirectorClient] Error executing event handlers for '${name}'`, error);\n }\n }\n\n private parseUrl(url: string | undefined, urlFactory: UrlFactory): UrlLike | undefined {\n if (!url) {\n return;\n }\n\n try {\n return urlFactory(url);\n } catch (error) {\n throw new ConfigDirectorValidationError(`Invalid base URL '${url}'. Parsing failed: ${error}`);\n }\n }\n\n private validateSdkKeyPresence(sdkKey: string | null | undefined) {\n if (!sdkKey || sdkKey.trim().length == 0) {\n throw new ConfigDirectorValidationError(\n \"No client SDK key was provided, the client cannot be instantiated without a valid client SDK key\",\n );\n }\n }\n\n private validateDefaultValue<T extends ConfigValueType>(defaultValue: T) {\n if (defaultValue === undefined || defaultValue === null) {\n throw new ConfigDirectorValidationError(\n \"Invalid default value. The default value for a config must be defined and non-null.\",\n );\n }\n\n if (typeof defaultValue === \"function\") {\n throw new ConfigDirectorValidationError(\n \"Invalid default value. The default value for a config cannot be a function.\",\n );\n }\n }\n\n public get isReady(): boolean {\n return this.ready;\n }\n\n public get isInitializing(): boolean {\n return this.initializing;\n }\n\n public on<T extends keyof ClientEvents>(eventName: T, handler: (event: ClientEvents[T]) => void): void {\n this.eventEmitter.on(eventName, handler);\n }\n\n public off<T extends keyof ClientEvents>(eventName: T, handler?: (payload: ClientEvents[T]) => void) {\n this.eventEmitter.off(eventName, handler);\n }\n\n public clear() {\n this.logger.debug(\"[ConfigDirectorClient] clear() has been called, removing all observers\");\n this.eventEmitter.clear();\n this.handlersMap.clear();\n }\n\n public unwatchAll() {\n this.handlersMap.clear();\n }\n\n public pauseNetwork(): void {\n this.logger.debug(\"[ConfigDirectorClient] pauseNetwork() called, pausing transport connection\");\n clearTimeout(this.timeoutTimer);\n this.timeoutTimer = undefined;\n this.transport.close();\n this.ready = false;\n }\n\n public async resumeNetwork(): Promise<void> {\n await this.connectToTransport(this.currentContext, \"network resume\");\n }\n\n public async close() {\n this.logger.debug(\"[ConfigDirectorClient] close() has been called, closing connection to server\");\n clearTimeout(this.timeoutTimer);\n this.readyResolve?.(true);\n this.telemetryClient.close();\n this.transport.close();\n this.ready = false;\n this.initializing = false;\n }\n\n public dispose() {\n this.clear();\n this.close();\n }\n}\n","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 TelemetryEventCollectorOptions } from \"@shared/telemetry/TelemetryEventCollector\";\nimport type { ConfigDirectorContext, ConfigDirectorLogger, ConfigValueType } from \"@js-client-core/types\";\nimport type { TelemetryClient, EvaluatedConfigEvent } from \"@js-client-core/telemetry\";\nimport type {\n TelemetryCloseEvent,\n TelemetryEvaluatedConfigEvent,\n TelemetryFlushEvent,\n TelemetryInitializeEvent,\n TelemetryUpdateContextEvent,\n TelemetryWorkerResponseEvent,\n} from \"./types\";\nimport type { TelemetryValue } from \"@shared/telemetry/utils\";\nimport { mapToTelemetryValue } from \"@shared/telemetry/utils\";\n\nconst DEFAULT_WORKER_CLOSE_TIMEOUT = 6_000;\n\nexport type WebWorkerTelemetryClientOptions = TelemetryEventCollectorOptions & {\n workerCloseTimeout?: number;\n};\n\nexport class WebWorkerTelemetryClient implements TelemetryClient {\n private readonly logger: ConfigDirectorLogger;\n private worker: Worker;\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\n const initializeMessage: TelemetryInitializeEvent = {\n type: \"Initialize\",\n payload: {\n sdkKey: options.sdkKey,\n sdkIdentity: options.sdkIdentity,\n metaContext: options.metaContext,\n baseUrl: options.baseUrl.toString(),\n evaluationQueueLimit: options.evaluationQueueLimit ?? 1_000,\n initialFlushIntervalDelay: options.initialFlushIntervalDelay ?? 5_000,\n flushIntervalDelay: options.flushIntervalDelay ?? 30_000,\n },\n };\n this.worker = new Worker(new URL(\"./worker.ts\", import.meta.url), { type: \"module\" });\n this.worker.onmessage = (message: MessageEvent<TelemetryWorkerResponseEvent>) => {\n this.handleWorkerEvent(message.data);\n };\n this.worker.postMessage(initializeMessage);\n\n this.visibilityHandler = () => {\n if (document.visibilityState === \"hidden\") {\n this.flush();\n }\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\n public async updateContext(value: ConfigDirectorContext | undefined) {\n const updateContextMessage: TelemetryUpdateContextEvent = {\n type: \"UpdateContext\",\n payload: {\n context: value,\n },\n };\n this.worker.postMessage(updateContextMessage);\n }\n\n public evaluatedConfig<T extends ConfigValueType>(event: EvaluatedConfigEvent<T>): void {\n const evaluatedConfigMessage: TelemetryEvaluatedConfigEvent = {\n type: \"EvaluatedConfigEvent\",\n payload: this.sanitizeEvaluatedConfigEvent(event),\n };\n this.worker.postMessage(evaluatedConfigMessage);\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 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 this.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 {\n type ConfigDirectorClientOptions,\n type ConfigDirectorClient,\n type IdentifyingSdkOptions,\n createDefaultLogger,\n} from \"@js-client-core/index\";\nimport { WebWorkerTelemetryClient } from \"./telemetry/WebWorkerTelemetryClient\";\nimport { DefaultConfigDirectorClient } from \"@js-client-core/DefaultConfigDirectorClient\";\nimport { defaultUrlFactory, parseUrl } from \"@shared/url\";\nimport { CLIENT_BASE_URL } from \"@shared/constants\";\nimport { generateValueId } from \"./telemetry/value-id-generator\";\n\nexport const createBrowserClient = (\n clientSdkKey: string,\n sdkOptions: IdentifyingSdkOptions,\n clientOptions?: ConfigDirectorClientOptions,\n): ConfigDirectorClient => {\n const logger = clientOptions?.logger ?? createDefaultLogger();\n const baseUrl = parseUrl(clientOptions?.connection?.url) ?? CLIENT_BASE_URL;\n const telemetryClient = new WebWorkerTelemetryClient({\n sdkKey: clientSdkKey,\n sdkIdentity: {\n sdkName: sdkOptions.sdkName,\n sdkVersion: sdkOptions.sdkVersion,\n },\n metaContext: {\n appName: clientOptions?.metadata?.appName,\n appVersion: clientOptions?.metadata?.appVersion,\n },\n logger: logger,\n baseUrl,\n urlFactory: defaultUrlFactory,\n valueIdGenerator: generateValueId,\n });\n\n return new DefaultConfigDirectorClient(telemetryClient, clientSdkKey, sdkOptions, {\n ...clientOptions,\n logger,\n });\n};\n","import type {\n ConfigDirectorClient,\n ConfigDirectorClientOptions,\n ConfigDirectorLoggingLevel,\n ConfigDirectorLogMessageDecorator,\n} from \"@js-browser-client/index\";\nimport { createBrowserClient, createDefaultLogger } from \"@js-browser-client/index\";\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 const createClient = (\n clientSdkKey: string,\n clientOptions?: ConfigDirectorClientOptions,\n): ConfigDirectorClient => {\n return createBrowserClient(\n clientSdkKey,\n { sdkName: \"js-client-sdk\", sdkVersion: \"__VERSION__\" },\n clientOptions,\n );\n};\n\nexport const createConsoleLogger = (\n level: ConfigDirectorLoggingLevel,\n messageDecorator?: ConfigDirectorLogMessageDecorator,\n) => {\n return createDefaultLogger(level, messageDecorator);\n};\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"configdirector-client.mjs","names":[],"sources":["../../shared/src/telemetry/utils.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/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 TelemetryEventCollectorOptions } from \"@shared/telemetry/TelemetryEventCollector\";\nimport type { ConfigDirectorContext, ConfigDirectorLogger, ConfigValueType } from \"@js-client-core/types\";\nimport type { TelemetryClient, EvaluatedConfigEvent } from \"@js-client-core/telemetry\";\nimport type {\n TelemetryCloseEvent,\n TelemetryEvaluatedConfigEvent,\n TelemetryFlushEvent,\n TelemetryInitializeEvent,\n TelemetryUpdateContextEvent,\n TelemetryWorkerResponseEvent,\n} from \"./types\";\nimport type { TelemetryValue } from \"@shared/telemetry/utils\";\nimport { mapToTelemetryValue } from \"@shared/telemetry/utils\";\n\nconst DEFAULT_WORKER_CLOSE_TIMEOUT = 6_000;\n\nexport type WebWorkerTelemetryClientOptions = TelemetryEventCollectorOptions & {\n workerCloseTimeout?: number;\n};\n\nexport class WebWorkerTelemetryClient implements TelemetryClient {\n private readonly logger: ConfigDirectorLogger;\n private readonly initializeMessage: TelemetryInitializeEvent;\n private worker: Worker | undefined;\n private readonly pendingEvaluations: TelemetryEvaluatedConfigEvent[] = [];\n private readonly pendingEvaluationLimit: number;\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\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 startWorker(): Worker {\n if (this.worker) {\n return this.worker;\n }\n const worker = new Worker(new URL(\"./worker.ts\", import.meta.url), { type: \"module\" });\n worker.onmessage = (message: MessageEvent<TelemetryWorkerResponseEvent>) => {\n this.handleWorkerEvent(message.data);\n };\n worker.postMessage(this.initializeMessage);\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 return worker;\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 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 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 {\n type ConfigDirectorClientOptions,\n type ConfigDirectorClient,\n type IdentifyingSdkOptions,\n createDefaultLogger,\n} from \"@js-client-core/index\";\nimport { WebWorkerTelemetryClient } from \"./telemetry/WebWorkerTelemetryClient\";\nimport { DefaultConfigDirectorClient } from \"@js-client-core/DefaultConfigDirectorClient\";\nimport { defaultUrlFactory, parseUrl } from \"@shared/url\";\nimport { CLIENT_BASE_URL } from \"@shared/constants\";\nimport { generateValueId } from \"./telemetry/value-id-generator\";\n\nexport const createBrowserClient = (\n clientSdkKey: string,\n sdkOptions: IdentifyingSdkOptions,\n clientOptions?: ConfigDirectorClientOptions,\n): ConfigDirectorClient => {\n const logger = clientOptions?.logger ?? createDefaultLogger();\n const baseUrl = parseUrl(clientOptions?.connection?.url) ?? CLIENT_BASE_URL;\n const telemetryClient = new WebWorkerTelemetryClient({\n sdkKey: clientSdkKey,\n sdkIdentity: {\n sdkName: sdkOptions.sdkName,\n sdkVersion: sdkOptions.sdkVersion,\n },\n metaContext: {\n appName: clientOptions?.metadata?.appName,\n appVersion: clientOptions?.metadata?.appVersion,\n },\n logger: logger,\n baseUrl,\n urlFactory: defaultUrlFactory,\n valueIdGenerator: generateValueId,\n });\n\n return new DefaultConfigDirectorClient(telemetryClient, clientSdkKey, sdkOptions, {\n ...clientOptions,\n logger,\n });\n};\n","import type {\n ConfigDirectorClient,\n ConfigDirectorClientOptions,\n ConfigDirectorLoggingLevel,\n ConfigDirectorLogMessageDecorator,\n} from \"@js-browser-client/index\";\nimport { createBrowserClient, createDefaultLogger } from \"@js-browser-client/index\";\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 const createClient = (\n clientSdkKey: string,\n clientOptions?: ConfigDirectorClientOptions,\n): ConfigDirectorClient => {\n return createBrowserClient(\n clientSdkKey,\n { sdkName: \"js-client-sdk\", sdkVersion: \"__VERSION__\" },\n clientOptions,\n );\n};\n\nexport const createConsoleLogger = (\n level: ConfigDirectorLoggingLevel,\n messageDecorator?: ConfigDirectorLogMessageDecorator,\n) => {\n return createDefaultLogger(level, messageDecorator);\n};\n"],"mappings":"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"}
|
|
@@ -0,0 +1,307 @@
|
|
|
1
|
+
//#region ../js-client-core/src/Emitter.d.ts
|
|
2
|
+
type EventType = string | symbol;
|
|
3
|
+
type EventsRecord = Record<EventType, any>;
|
|
4
|
+
type Handler<TEventsRecord extends EventsRecord, TKey extends keyof TEventsRecord> = (payload: TEventsRecord[TKey]) => void;
|
|
5
|
+
interface EventProvider<TEventsRecord extends EventsRecord> {
|
|
6
|
+
on<TName extends keyof TEventsRecord>(name: TName, handler: Handler<TEventsRecord, TName>): void;
|
|
7
|
+
off<TName extends keyof TEventsRecord>(name: TName, handler?: Handler<TEventsRecord, TName>): void;
|
|
8
|
+
clear(): void;
|
|
9
|
+
}
|
|
10
|
+
//#endregion
|
|
11
|
+
//#region ../shared/src/types.d.ts
|
|
12
|
+
type ConfigEnumLikeType = {
|
|
13
|
+
[key: string]: string | number;
|
|
14
|
+
};
|
|
15
|
+
type ConfigValueType = string | number | boolean | object | ConfigEnumLikeType;
|
|
16
|
+
type ConfigDirectorLoggingLevel = "debug" | "info" | "warn" | "error" | "off";
|
|
17
|
+
interface ConfigDirectorLogger {
|
|
18
|
+
debug(message: string, ...args: any): void;
|
|
19
|
+
info(message: string, ...args: any): void;
|
|
20
|
+
warn(message: string, ...args: any): void;
|
|
21
|
+
error(message: string, ...args: any): void;
|
|
22
|
+
}
|
|
23
|
+
interface ConfigDirectorLogMessageDecorator {
|
|
24
|
+
decorateMessage(message: string): string;
|
|
25
|
+
}
|
|
26
|
+
type EvaluationReason = "found-match" | "config-state-missing" | "client-not-ready" | "type-mismatch" | "value-missing" | "invalid-number" | "invalid-json" | "invalid-boolean";
|
|
27
|
+
type ConfigEvaluation = {
|
|
28
|
+
key: string;
|
|
29
|
+
value: ConfigValueType;
|
|
30
|
+
valueId?: string;
|
|
31
|
+
isDefaultValue: boolean;
|
|
32
|
+
reason: EvaluationReason;
|
|
33
|
+
context?: ConfigDirectorContext;
|
|
34
|
+
};
|
|
35
|
+
/**
|
|
36
|
+
* The user's context to be sent to ConfigDirector. This context will be used for targeting
|
|
37
|
+
* rules evaluation.
|
|
38
|
+
*/
|
|
39
|
+
type ConfigDirectorContext = {
|
|
40
|
+
/**
|
|
41
|
+
* The user's identifier. This should be a value that uniquely identifies an application
|
|
42
|
+
* user.
|
|
43
|
+
* In the case of anonymous users, you could generate a UUID or alternatively not provide
|
|
44
|
+
* the {@link id} and the SDK will generate a random UUID. However, keep in mind that this
|
|
45
|
+
* value is used for segmenting users in percentage rollouts, and changes to the {@link id}
|
|
46
|
+
* could result in the user being assigned to a different percentile.
|
|
47
|
+
*/
|
|
48
|
+
id?: string;
|
|
49
|
+
/**
|
|
50
|
+
* The user's display name. This will be shown in the ConfigDirector dashboard and may be
|
|
51
|
+
* used for targeting rules.
|
|
52
|
+
*/
|
|
53
|
+
name?: string;
|
|
54
|
+
/**
|
|
55
|
+
* Any arbitrary traits for the current user. They will be shown in the ConfigDirector
|
|
56
|
+
* dashboard and may be used for targeting rules.
|
|
57
|
+
*/
|
|
58
|
+
traits?: {
|
|
59
|
+
[key: string]: unknown;
|
|
60
|
+
};
|
|
61
|
+
/**
|
|
62
|
+
* Whether or not to treat the context as anonymous during evaluation. When `true`, the
|
|
63
|
+
* context values will be used for targeting rules evaluation but the context will not be
|
|
64
|
+
* persisted and will not appear in the dashboard.
|
|
65
|
+
*
|
|
66
|
+
* @default false
|
|
67
|
+
*/
|
|
68
|
+
anonymous?: boolean;
|
|
69
|
+
};
|
|
70
|
+
/**
|
|
71
|
+
* Metadata about your application. It is recommended you include these values when configuring
|
|
72
|
+
* a ConfigDirector client so that you can use them in targeting rules.
|
|
73
|
+
*/
|
|
74
|
+
type ConfigDirectorMetaContext = {
|
|
75
|
+
appVersion?: string;
|
|
76
|
+
appName?: string;
|
|
77
|
+
};
|
|
78
|
+
type ConnectionMode = "streaming" | "polling";
|
|
79
|
+
//#endregion
|
|
80
|
+
//#region ../js-client-core/src/types.d.ts
|
|
81
|
+
/**
|
|
82
|
+
* Configuration options for the {@link ConfigDirectorClient}
|
|
83
|
+
*/
|
|
84
|
+
type ConfigDirectorClientOptions = {
|
|
85
|
+
/**
|
|
86
|
+
* Application metadata that remains constant through the lifetime of the connection
|
|
87
|
+
*/
|
|
88
|
+
metadata?: ConfigDirectorMetaContext;
|
|
89
|
+
/**
|
|
90
|
+
* Connection options
|
|
91
|
+
*/
|
|
92
|
+
connection?: {
|
|
93
|
+
/**
|
|
94
|
+
* The connection mode to be used, one of `streaming` (default) or `polling`.
|
|
95
|
+
* If set to `streaming`, the connection will remain open and receive updates whenever
|
|
96
|
+
* config state is updated on the ConfigDirector dashboard.
|
|
97
|
+
* When set to `polling`, there will be an initial request to retrieve config state during
|
|
98
|
+
* initialization, and additional requests on a `pollingInterval`.
|
|
99
|
+
*
|
|
100
|
+
* Defaults to `streaming`
|
|
101
|
+
*/
|
|
102
|
+
mode?: ConnectionMode;
|
|
103
|
+
/**
|
|
104
|
+
* The polling interval in _seconds_ when the `mode` is set to `polling`. This option has no
|
|
105
|
+
* effect when the `mode` is set to `streaming`.
|
|
106
|
+
*
|
|
107
|
+
* Defaults to 60 seconds. The minimum is 30 seconds. A value below the minimum is raised to the
|
|
108
|
+
* minimum and a warning is logged.
|
|
109
|
+
*/
|
|
110
|
+
pollingInterval?: number;
|
|
111
|
+
/**
|
|
112
|
+
* The timeout, in _milliseconds_, to be used in initialization and when updating the context.
|
|
113
|
+
* If streaming is enabled, the operation (initialization or context update) may still succeed
|
|
114
|
+
* after it times out if no unrecoverable errors are encountered (like an invalid SDK key).
|
|
115
|
+
* If streaming is disabled, if the operation times out, it will not be retried.
|
|
116
|
+
*/
|
|
117
|
+
timeout?: number;
|
|
118
|
+
/**
|
|
119
|
+
* The base URL to the ConfigDirector SDK server. To be used only when needing to route through a
|
|
120
|
+
* proxy to connect to the ConfigDirector SDK server. Please refer to the docs on how to configure
|
|
121
|
+
* a proxy for the client SDK.
|
|
122
|
+
*/
|
|
123
|
+
url?: string;
|
|
124
|
+
};
|
|
125
|
+
/**
|
|
126
|
+
* A logger that implements {@link ConfigDirectorLogger}. It defaults to the ConfigDirector console
|
|
127
|
+
* logger set to 'warn' level.
|
|
128
|
+
*
|
|
129
|
+
* The log level of the default logger can be adjusted by creating a default logger with the desired
|
|
130
|
+
* level and providing it in this property:
|
|
131
|
+
* @example
|
|
132
|
+
* import { createClient, createConsoleLogger } from "@configdirector/client-sdk";
|
|
133
|
+
* const client = createClient(
|
|
134
|
+
* "YOUR-SDK-KEY",
|
|
135
|
+
* { logger: createConsoleLogger("debug") },
|
|
136
|
+
* );
|
|
137
|
+
*/
|
|
138
|
+
logger?: ConfigDirectorLogger;
|
|
139
|
+
/**
|
|
140
|
+
* Handlers for hooks/events emitted by the client. Each hook accepts either a single event handler or
|
|
141
|
+
* an array of event handlers.
|
|
142
|
+
*
|
|
143
|
+
* @example
|
|
144
|
+
* import { createClient, createConsoleLogger } from "@configdirector/client-sdk";
|
|
145
|
+
* const client = createClient(
|
|
146
|
+
* "YOUR-SDK-KEY",
|
|
147
|
+
* {
|
|
148
|
+
* hooks: {
|
|
149
|
+
* configEvaluated: (event) => { console.log(event.evaluation); }
|
|
150
|
+
* },
|
|
151
|
+
* },
|
|
152
|
+
* );
|
|
153
|
+
*/
|
|
154
|
+
hooks?: ClientHooks;
|
|
155
|
+
};
|
|
156
|
+
type ClientHooks = {
|
|
157
|
+
clientReady?: HookHandler<"clientReady"> | HookHandler<"clientReady">[];
|
|
158
|
+
configsUpdated?: HookHandler<"configsUpdated"> | HookHandler<"configsUpdated">[];
|
|
159
|
+
contextUpdated?: HookHandler<"contextUpdated"> | HookHandler<"contextUpdated">[];
|
|
160
|
+
configEvaluated?: HookHandler<"configEvaluated"> | HookHandler<"configEvaluated">[];
|
|
161
|
+
connectionError?: HookHandler<"connectionError"> | HookHandler<"connectionError">[];
|
|
162
|
+
};
|
|
163
|
+
type ClientConnectAction = "initialization" | "context update" | "network resume";
|
|
164
|
+
type HookHandler<TEvent extends keyof ClientEvents> = (payload: ClientEvents[TEvent]) => void;
|
|
165
|
+
type ClientEvents = {
|
|
166
|
+
configsUpdated: {
|
|
167
|
+
keys: string[];
|
|
168
|
+
removedKeys: string[];
|
|
169
|
+
};
|
|
170
|
+
clientReady: {
|
|
171
|
+
action: ClientConnectAction;
|
|
172
|
+
};
|
|
173
|
+
contextUpdated: {
|
|
174
|
+
context: ConfigDirectorContext | undefined;
|
|
175
|
+
};
|
|
176
|
+
configEvaluated: {
|
|
177
|
+
evaluation: ConfigEvaluation;
|
|
178
|
+
};
|
|
179
|
+
connectionError: {
|
|
180
|
+
error: Error;
|
|
181
|
+
};
|
|
182
|
+
};
|
|
183
|
+
type WatchHandler<T extends ConfigValueType> = (message: T) => void;
|
|
184
|
+
/**
|
|
185
|
+
* The ConfigDirector SDK client object.
|
|
186
|
+
*
|
|
187
|
+
* Applications should create a single instance of `ConfigDirectorClient`, and call
|
|
188
|
+
* {@link initialize} during application initialization.
|
|
189
|
+
*
|
|
190
|
+
* After initialization, to update the user's context, so that targeting rules are evaluated
|
|
191
|
+
* with the updated context, call {@link updateContext}.
|
|
192
|
+
*/
|
|
193
|
+
interface ConfigDirectorClient extends EventProvider<ClientEvents> {
|
|
194
|
+
/**
|
|
195
|
+
* Initializes the connection to ConfigDirector to retrieve config evaluations. Until
|
|
196
|
+
* initialization is successful, all flags will return their default value provided to
|
|
197
|
+
* {@link watch} or {@link getValue}.
|
|
198
|
+
*
|
|
199
|
+
* If the connection fails or is interrupted with a transient error (network error,
|
|
200
|
+
* internal server error, etc) the client will continue to attempt to connect. However,
|
|
201
|
+
* if the connection fails with a persistent error, like an invalid SDK key, the client will
|
|
202
|
+
* not attempt to re-connect and an error will be logged to the console or the provided
|
|
203
|
+
* logger.
|
|
204
|
+
*
|
|
205
|
+
* @param context The current user's context to be used for evaluating targeting rules (optional).
|
|
206
|
+
*/
|
|
207
|
+
initialize(context?: ConfigDirectorContext): Promise<void>;
|
|
208
|
+
/**
|
|
209
|
+
* Updates the user's context and re-evaluates all config and flag values based on the new context.
|
|
210
|
+
*
|
|
211
|
+
* @param context The current user's context to be used for evaluating targeting rules (required).
|
|
212
|
+
*/
|
|
213
|
+
updateContext(context: ConfigDirectorContext): Promise<void>;
|
|
214
|
+
/**
|
|
215
|
+
* Returns the current context the client is configured with, or undefined if there is no context.
|
|
216
|
+
*
|
|
217
|
+
* Note that the value returned does not updated immediately after calling {@link updateContext}. Only
|
|
218
|
+
* once the underlying connection was successful or timed out, the current context is updated. This is
|
|
219
|
+
* because while the context update is in progress, configs are still evaluated on the previous context.
|
|
220
|
+
*
|
|
221
|
+
*/
|
|
222
|
+
get context(): ConfigDirectorContext | undefined;
|
|
223
|
+
/**
|
|
224
|
+
* Returns whether or not the client is ready after calling {@link initialize} or {@link updateContext}
|
|
225
|
+
*
|
|
226
|
+
* The definition of ready is that the connection to the server was successful, and config state
|
|
227
|
+
* was received.
|
|
228
|
+
*/
|
|
229
|
+
get isReady(): boolean;
|
|
230
|
+
/**
|
|
231
|
+
* Whether the client is trying to get its very first payload from the server. Upon client creation,
|
|
232
|
+
* it is `false`. It becomes `true` when `initialize` is called on a client that has never received a
|
|
233
|
+
* payload, stays `true` through timeouts and retries, and becomes `false` when the first payload
|
|
234
|
+
* arrives, when a fatal connection error stops the retries, or on `close`. `updateContext` and
|
|
235
|
+
* `resumeNetwork` never set it, and once a payload has been received it is never `true` again.
|
|
236
|
+
*/
|
|
237
|
+
get isInitializing(): boolean;
|
|
238
|
+
/**
|
|
239
|
+
* Evaluates a config and returns its value based on the current context and targeting rules
|
|
240
|
+
*
|
|
241
|
+
* @returns The evaluated config value, or the `defaultValue` if the config state was unavailable
|
|
242
|
+
* @param configKey The config key to evaluate
|
|
243
|
+
* @param defaultValue The default value to be returned if the config state is unavailable. For
|
|
244
|
+
* example, if the client cannot connect to the server due to network conditions, or if getValue
|
|
245
|
+
* is called before initialization is done.
|
|
246
|
+
*/
|
|
247
|
+
getValue<T extends ConfigValueType>(configKey: string, defaultValue: T): T;
|
|
248
|
+
/**
|
|
249
|
+
* Watches for changes to a a config evaluation value. Whenever the config value changes, the
|
|
250
|
+
* provided callback function will be called with the new value. Changes can happen due to updates
|
|
251
|
+
* to the config in the ConfigDirector dashboard, or if the context is updated via {@link updateContext}.
|
|
252
|
+
*
|
|
253
|
+
* @returns An 'unwatch' function that can be called to remove the subscriber
|
|
254
|
+
*
|
|
255
|
+
* @param configKey The config key to watch
|
|
256
|
+
* @param defaultValue The default value to be referenced if the config state is unavailable
|
|
257
|
+
* @param callback The callback function to be called whenever the config value is updated
|
|
258
|
+
*/
|
|
259
|
+
watch<T extends ConfigValueType>(configKey: string, defaultValue: T, callback: WatchHandler<T>): () => void;
|
|
260
|
+
/**
|
|
261
|
+
* Removes a particular subscriber to the given `configKey`, or all subscribers if no callback
|
|
262
|
+
* is provided.
|
|
263
|
+
*
|
|
264
|
+
* @param configKey The config key to remove subscribers from
|
|
265
|
+
* @param callback The subscriber to be removed. If not provided, all subscribers are removed for
|
|
266
|
+
* the given `configKey`.
|
|
267
|
+
*/
|
|
268
|
+
unwatch<T extends ConfigValueType>(configKey: string, callback?: WatchHandler<T>): void;
|
|
269
|
+
/**
|
|
270
|
+
* Removes all subscribers from all config keys
|
|
271
|
+
*/
|
|
272
|
+
unwatchAll(): void;
|
|
273
|
+
/**
|
|
274
|
+
* Pauses the network connection without clearing event handlers, watch handlers, or config
|
|
275
|
+
* state. Intended for mobile environments where the OS may kill background connections (e.g.
|
|
276
|
+
* when the app is backgrounded on iOS/Android).
|
|
277
|
+
*
|
|
278
|
+
* Call {@link resumeNetwork} to re-establish the connection.
|
|
279
|
+
*/
|
|
280
|
+
pauseNetwork(): void;
|
|
281
|
+
/**
|
|
282
|
+
* Resumes a connection that was paused via {@link pauseNetwork}, using the last context that
|
|
283
|
+
* was provided to {@link initialize} or {@link updateContext}.
|
|
284
|
+
*/
|
|
285
|
+
resumeNetwork(): Promise<void>;
|
|
286
|
+
/**
|
|
287
|
+
* Disposes of the client. All connections are closed, and all event and config key subscribers
|
|
288
|
+
* are removed.
|
|
289
|
+
*
|
|
290
|
+
* Intended to be called when your application shuts down
|
|
291
|
+
*/
|
|
292
|
+
dispose(): void;
|
|
293
|
+
}
|
|
294
|
+
//#endregion
|
|
295
|
+
//#region ../shared/src/errors.d.ts
|
|
296
|
+
declare class ConfigDirectorConnectionError extends Error {
|
|
297
|
+
readonly name: string;
|
|
298
|
+
readonly status?: number;
|
|
299
|
+
constructor(message: string, status?: number);
|
|
300
|
+
}
|
|
301
|
+
declare class ConfigDirectorValidationError extends Error {
|
|
302
|
+
readonly name: string;
|
|
303
|
+
constructor(message: string);
|
|
304
|
+
}
|
|
305
|
+
//#endregion
|
|
306
|
+
export { ConfigDirectorContext as a, ConfigDirectorLoggingLevel as c, ConfigDirectorClientOptions as i, ConfigValueType as l, ConfigDirectorValidationError as n, ConfigDirectorLogMessageDecorator as o, ConfigDirectorClient as r, ConfigDirectorLogger as s, ConfigDirectorConnectionError as t };
|
|
307
|
+
//# sourceMappingURL=errors-BOgYEeJ6.d.cts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"errors-BOgYEeJ6.d.cts","names":[],"sources":["../../js-client-core/src/Emitter.ts","../../shared/src/types.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;AAAA,KAGN,gBAAA;AAAA,KAUA,gBAAA;EACV,GAAA;EACA,KAAA,EAAO,eAAA;EACP,OAAA;EACA,cAAA;EACA,MAAA,EAAQ,gBAAA;EACR,OAAA,GAAU,qBAAA;AAAA;;;;;KAMA,qBAAA;ED1D2E;;;;;;;;ECmErF,EAAA;EDpE4C;;;;EC0E5C,IAAA;ED1EmD;;;;ECgFnD,MAAA;IAAA,CAAY,GAAA;EAAA;ED/E0D;;;;;;;ECwFtE,SAAA;AAAA;AArFF;;;;AAAA,KA4FY,yBAAA;EACV,UAAA;EACA,OAAA;AAAA;AAAA,KAGU,cAAA;;;;;;KCnEA,2BAAA;EFtCkB;AAG9B;;EEuCE,QAAA,GAAW,yBAAA;EFvCwC;;;EE2CnD,UAAA;IF1CmF;;;;;;;;;IEoDjF,IAAA,GAAO,cAAA;IFrD0C;;;;;;;IE6DjD,eAAA;IF5DiF;;;;;;IEmEjF,OAAA;IFlE4D;;;;;IEwE5D,GAAA;EAAA;;;;ADrEJ;;;;;AAEA;;;;;ECkFE,MAAA,GAAS,oBAAA;EDnE2B;;;;AAEtC;;;;;;;;;;;ECkFE,KAAA,GAAQ,WAAA;AAAA;AAAA,KAGE,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;AAAA;AAAA,KAGzC,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;AAAA;AAAA,KAGhB,YAAA,WAAuB,eAAA,KAAoB,OAAA,EAAS,CAAA;;;;;;;ADrEhE;;;UCgFiB,oBAAA,SAA6B,aAAA,CAAc,YAAA;EDvE1D;;;;;;;AA4BF;;;;;AAKA;ECoDE,UAAA,CAAW,OAAA,GAAU,qBAAA,GAAwB,OAAA;;;;;;EAO7C,aAAA,CAAc,OAAA,EAAS,qBAAA,GAAwB,OAAA;EA9HrC;;;;;;;;EAAA,IAwIN,OAAA,IAAW,qBAAA;EApIf;;;;;;EAAA,IA4II,OAAA;EAzGF;;;;;;;EAAA,IAkHE,cAAA;EA/EiB;;;;;;;;;EA0FrB,QAAA,WAAmB,eAAA,EAAiB,SAAA,UAAmB,YAAA,EAAc,CAAA,GAAI,CAAA;EArFvD;;;;;;;;;;;EAkGlB,KAAA,WAAgB,eAAA,EAAiB,SAAA,UAAmB,YAAA,EAAc,CAAA,EAAG,QAAA,EAAU,YAAA,CAAa,CAAA;EApG3C;;;;;;;;EA8GjD,OAAA,WAAkB,eAAA,EAAiB,SAAA,UAAmB,QAAA,GAAW,YAAA,CAAa,CAAA;EAzGpE;;;EA8GV,UAAA;EA9G6B;AAE/B;;;;;;EAqHE,YAAA;EArHwF;;;;EA2HxF,aAAA,IAAiB,OAAA;EA3H2C;;;AAE9D;;;EAiIE,OAAA;AAAA;;;cCjQW,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"}
|