@obelism/improve-sdk 1.1.0 → 2.0.0

package/dist/server.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"server.mjs","sources":["../src/config/audiences.ts","../src/utils/parseUserAgent.ts","../src/utils/getVisitorMatchesAudience.ts","../src/utils/getRandomTestValue.ts","../src/config/constants.ts","../src/utils/delay.ts","../src/utils/errors.ts","../src/utils/getRandomString.ts","../src/utils/normalizeConfig.ts","../src/utils/retry.ts","../src/utils/getTimeoutError.ts","../src/utils/timeoutFetch.ts","../src/base.ts","../src/config/urls.ts","../src/server.ts"],"sourcesContent":["/**\n * @constant AUDIENCE_PARAMS\n * @description All posibile audience tracking options\n */\nexport const AUDIENCE_PARAMS = {\n\t//? Technical\n\tpointer: ['coarse', 'fine'],\n\tdevice: [\n\t\t'wearable',\n\t\t'mobile',\n\t\t'tablet',\n\t\t'console',\n\t\t'smarttv',\n\t\t'embedded',\n\t\t'desktop',\n\t],\n\tbrowser: [\n\t\t'chrome',\n\t\t'safari',\n\t\t'firefox',\n\t\t'edge',\n\t\t'ie',\n\t\t'samsung internet',\n\t\t'social',\n\t\t'other',\n\t],\n\tos: ['mac os', 'ios', 'android', 'windows', 'unix'],\n} as const\n\n//? Generated types\nexport type AudienceParamKey = keyof typeof AUDIENCE_PARAMS\n\nexport type AudienceParamPointer = (typeof AUDIENCE_PARAMS.pointer)[number]\n\nexport type AudienceParamDevice = (typeof AUDIENCE_PARAMS.device)[number]\n\nexport type AudienceParamBrowser = (typeof AUDIENCE_PARAMS.browser)[number]\n\nexport type AudienceParamOs = (typeof AUDIENCE_PARAMS.os)[number]\n\nexport const AUDIENCE_PARAM_KEYS = Object.keys(\n\tAUDIENCE_PARAMS,\n) as ReadonlyArray<AudienceParamKey>\n","import { UAParser } from 'ua-parser-js'\n\nimport {\n\tAUDIENCE_PARAMS,\n\tAudienceParamBrowser,\n\tAudienceParamDevice,\n\tAudienceParamOs,\n\tAudienceParamPointer,\n} from '../config/audiences'\n\nexport type ParsedUserAgent = {\n\tpointer: AudienceParamPointer\n\tdevice: AudienceParamDevice\n\tbrowser: AudienceParamBrowser\n\tos: AudienceParamOs\n}\n\nconst formatDeviceType = (deviceType?: string): AudienceParamDevice => {\n\tif (\n\t\tdeviceType &&\n\t\tAUDIENCE_PARAMS.device.includes(deviceType as AudienceParamDevice)\n\t) {\n\t\treturn deviceType as AudienceParamDevice\n\t}\n\treturn 'desktop'\n}\n\nconst SOCIAL_BROWSERS: ReadonlyArray<string> = [\n\t'tiktok',\n\t'wechat',\n\t'weibo',\n\t'snapchat',\n\t'klarna',\n\t'Line',\n\t'instagram',\n\t'facebook',\n\t'alipay',\n\t'Baidu',\n]\n\nconst formatBrowser = (browserName: string = ''): AudienceParamBrowser => {\n\tif (!browserName) return 'other'\n\n\tconst name = browserName.toLowerCase()\n\n\tconst browserTypeMatch = AUDIENCE_PARAMS.browser.find((browserType) => {\n\t\treturn name.includes(browserType)\n\t})\n\n\tif (browserTypeMatch) return browserTypeMatch\n\n\tif (SOCIAL_BROWSERS.includes(name)) return 'social'\n\treturn 'other'\n}\n\nconst PRIMARY_TOUCH_DEVICES: ReadonlyArray<AudienceParamDevice> = [\n\t'wearable',\n\t'mobile',\n\t'tablet',\n]\n\nconst formatPointer = (device: AudienceParamDevice) => {\n\treturn PRIMARY_TOUCH_DEVICES.includes(device) ? 'coarse' : 'fine'\n}\n\nconst formatOs = (osName: string = ''): AudienceParamOs => {\n\tif (!osName) return 'unix'\n\n\tconst os = osName.toLowerCase()\n\n\tconst osTypeMatch = AUDIENCE_PARAMS.os.find((osType) => {\n\t\treturn os.includes(osType)\n\t})\n\n\tif (osTypeMatch) return osTypeMatch\n\treturn 'unix'\n}\n\nexport const parseUserAgent = (userAgent: string): ParsedUserAgent | null => {\n\tif (!userAgent || typeof userAgent !== 'string') return null\n\n\tconst parser = new UAParser(userAgent)\n\tconst results = parser.getResult()\n\n\tconst device = formatDeviceType(results.device.type)\n\n\treturn {\n\t\tpointer: formatPointer(device),\n\t\tdevice: device,\n\t\tbrowser: formatBrowser(results.browser.name),\n\t\tos: formatOs(results.os.name),\n\t}\n}\n","import { ImproveAudienceValue } from '../types'\nimport { AudienceParamKey } from '../config/audiences'\nimport { ParsedUserAgent } from './parseUserAgent'\n\nexport const getVisitorMatchesAudience = (\n\taudience: ImproveAudienceValue | undefined,\n\tvisitorParams: ParsedUserAgent,\n) => {\n\tif (!audience) return true\n\treturn Object.entries(audience).every(([paramKey, paramValue]) => {\n\t\treturn visitorParams[paramKey as AudienceParamKey] === paramValue\n\t})\n}\n","import { ImproveTestOption } from '../types'\n\n// function cryptoRandom() {\n// \treturn crypto.getRandomValues(new Uint32Array(1))[0] / (0xffffffff + 1)\n// }\n\nexport const getRandomTestValue = (options: ImproveTestOption[]) => {\n\tif (options.length === 0) return null\n\tif (options.length === 1) return options[0].slug\n\n\t// Get a random number between 0 and 1\n\tconst sum = options.reduce((acc, { split }) => acc + split, 0)\n\tlet value = Math.random() * sum\n\n\tconst match =\n\t\toptions.find(({ split }) => {\n\t\t\tvalue -= split\n\t\t\treturn value <= 0\n\t\t}) || options[0]\n\n\treturn match.slug\n}\n","export const COOKIE_NAME_VISITOR = 'visitorId'\n\nexport const VISITOR_ID_PREFIX = 'visi'\n\nexport const VISITOR_ID_LENGTH = 26\n\nexport const VISITOR_ID_SEPARATOR = '_'\n\n/** Default number of retries for a failed config fetch (network / 5xx / 429). */\nexport const CONFIG_RETRY_COUNT = 2\n\n/** Base delay for config-fetch backoff, in ms. */\nexport const CONFIG_RETRY_BASE_DELAY_MS = 300\n\n/** Upper bound for a single config-fetch backoff wait, in ms. */\nexport const CONFIG_RETRY_MAX_DELAY_MS = 3000\n\n/**\n * Max length of a single analytic string field. The backend rejects any\n * field longer than this (varchar(256)) with a 400, so the client caps\n * developer-controlled values (event, message) to avoid silently dropping\n * the event.\n */\nexport const MAX_ANALYTIC_FIELD_LENGTH = 256\n\n/**\n * How long to stop sending analytics after the backend returns 429 (usage\n * limit / rate limit) without a `Retry-After`. Avoids hammering an org that is\n * already over its quota.\n */\nexport const ANALYTIC_RATE_LIMIT_COOLDOWN_MS = 60_000\n","export const delay = (ms: number) =>\n\tnew Promise((resolve) => setTimeout(resolve, ms))\n","export type ImproveFetchErrorReason =\n\t| 'timeout'\n\t| 'network'\n\t| 'unauthorized'\n\t| 'rate-limited'\n\t| 'server'\n\t| 'client'\n\t| 'invalid-response'\n\nconst REASON_MESSAGES: Record<ImproveFetchErrorReason, string> = {\n\ttimeout: 'Configuration request timed out',\n\tnetwork: 'Configuration request could not reach the server',\n\tunauthorized:\n\t\t'Configuration request was rejected (403): verify the organizationId, the server token, and that the request origin is whitelisted for this environment',\n\t'rate-limited':\n\t\t'Configuration request was rate limited (429): too many requests, or the organization usage limit was reached',\n\tserver: 'Configuration request failed with a server error',\n\tclient: 'Configuration request was rejected by the server',\n\t'invalid-response': 'Configuration response could not be parsed as JSON',\n}\n\n/**\n * Error thrown by the config fetch layer. Carries the HTTP `status`, a coarse\n * `reason`, and (when the server sent one) the `Retry-After` delay in ms, so\n * callers can distinguish a misconfiguration (unauthorized) from a transient\n * failure (rate-limited/server/timeout) instead of guessing from a string.\n */\nexport class ImproveFetchError extends Error {\n\treason: ImproveFetchErrorReason\n\tstatus?: number\n\tretryAfterMs?: number\n\n\tconstructor(\n\t\treason: ImproveFetchErrorReason,\n\t\toptions?: { status?: number; retryAfterMs?: number; cause?: unknown },\n\t) {\n\t\tsuper(REASON_MESSAGES[reason])\n\t\tthis.name = 'ImproveFetchError'\n\t\tthis.reason = reason\n\t\tthis.status = options?.status\n\t\tthis.retryAfterMs = options?.retryAfterMs\n\t\tif (options && 'cause' in options) {\n\t\t\t;(this as { cause?: unknown }).cause = options.cause\n\t\t}\n\t}\n\n\t/** Whether retrying the request could plausibly succeed. */\n\tget isRetryable() {\n\t\treturn (\n\t\t\tthis.reason === 'rate-limited' ||\n\t\t\tthis.reason === 'server' ||\n\t\t\tthis.reason === 'timeout' ||\n\t\t\tthis.reason === 'network'\n\t\t)\n\t}\n}\n\n/** Map an HTTP status onto a coarse {@link ImproveFetchErrorReason}. */\nexport const getReasonFromStatus = (\n\tstatus: number,\n): ImproveFetchErrorReason => {\n\tif (status === 429) return 'rate-limited'\n\tif (status === 401 || status === 403) return 'unauthorized'\n\tif (status >= 500) return 'server'\n\treturn 'client'\n}\n","/**\n * @constant CHAR_SET\n * @description Key/value set of characters to be used for generation strings\n */\nconst CHAR_SET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789'\n\n/**\n * @function getRandomString\n * @description Generate a random string\n */\nexport function getRandomString(characters: number = 5): string {\n\tif (!characters || typeof characters !== 'number') return ''\n\treturn Array(characters)\n\t\t.fill('')\n\t\t.reduce((acc) => {\n\t\t\tacc += CHAR_SET.charAt(Math.floor(Math.random() * CHAR_SET.length))\n\t\t\treturn acc\n\t\t}, '')\n}\n","import { ImproveConfiguration } from '../types'\nimport { ImproveFetchError } from './errors'\n\n/**\n * @function normalizeConfig\n * @description Coerce a parsed config response into a well-formed\n * {@link ImproveConfiguration}. The backend returns `200 {}` for an unknown\n * org/environment (and on its own internal error). An empty object is truthy,\n * so it slips past `if (!this.config)` guards and then crashes downstream on\n * `config.tests[slug]` (`Cannot read properties of undefined`). Guaranteeing\n * `tests`/`flags`/`audience` are always objects lets the SDK fail open to\n * default values instead of throwing during render/middleware.\n *\n * Throws {@link ImproveFetchError} `invalid-response` when the body isn't an\n * object at all (e.g. an array, string, or null).\n */\nexport const normalizeConfig = (body: unknown): ImproveConfiguration => {\n\tif (typeof body !== 'object' || body === null || Array.isArray(body)) {\n\t\tthrow new ImproveFetchError('invalid-response')\n\t}\n\n\tconst raw = body as Partial<ImproveConfiguration>\n\n\treturn {\n\t\tname: typeof raw.name === 'string' ? raw.name : '',\n\t\tversion: typeof raw.version === 'number' ? raw.version : 0,\n\t\ttests: raw.tests ?? {},\n\t\tflags: raw.flags ?? {},\n\t\taudience: raw.audience ?? {},\n\t}\n}\n","/**\n * @function parseRetryAfterMs\n * @description Parse an HTTP `Retry-After` header into milliseconds. Supports\n * both the delta-seconds form (`\"120\"`) and the HTTP-date form\n * (`\"Wed, 21 Oct 2026 07:28:00 GMT\"`). Returns `undefined` when the header is\n * absent or unparseable so the caller can fall back to computed backoff.\n *\n * @param {string | null} [header] - the raw `Retry-After` header value\n * @param {number} [now] - current epoch ms (injectable for testing)\n */\nexport const parseRetryAfterMs = (\n\theader: string | null | undefined,\n\tnow: number = Date.now(),\n): number | undefined => {\n\tif (!header) return undefined\n\n\tconst seconds = Number(header)\n\tif (Number.isFinite(seconds)) return Math.max(0, Math.round(seconds * 1000))\n\n\tconst date = Date.parse(header)\n\tif (Number.isNaN(date)) return undefined\n\n\treturn Math.max(0, date - now)\n}\n\n/**\n * @function getBackoffDelayMs\n * @description Exponential backoff with full jitter, capped at `maxDelay`.\n * Jitter spreads retries so concurrent clients don't stampede the origin in\n * lockstep after a shared failure.\n *\n * @param {number} attempt - zero-based retry attempt index\n * @param {number} baseDelay - base delay in ms\n * @param {number} maxDelay - upper bound in ms\n */\nexport const getBackoffDelayMs = (\n\tattempt: number,\n\tbaseDelay: number,\n\tmaxDelay: number,\n): number => {\n\tconst exponential = Math.min(maxDelay, baseDelay * 2 ** attempt)\n\treturn Math.round(Math.random() * exponential)\n}\n","import { delay } from './delay'\n\n/**\n * @async @function getTimeoutError\n * @description Throw an error after a delay\n *\n * @param {number} [timeout] - time in ms after to reject default: 1000\n * @param {AbortController} [controller] - (optional) AbortController to abort the request\n */\nexport const getTimeoutError = async (\n\ttimeout: number = 1000,\n\tcontroller: AbortController,\n): Promise<null> => {\n\tawait delay(timeout)\n\tcontroller?.abort()\n\treturn null\n}\n","import { getTimeoutError } from './getTimeoutError'\n\n/**\n * @async @function timeoutFetch\n * @description Fetch with a timeout\n *\n * @param {number} timeout - time in ms after to reject default: 3000\n * @param {string} url - url to fetch\n * @param {Object} [options] - (optional) options to pass to fetch\n */\nexport const timeoutFetch = (\n\ttimeout: number = 3000,\n\turl: string,\n\toptions?: object,\n) => {\n\tconst controller = new AbortController()\n\treturn Promise.race([\n\t\tfetch(url, {\n\t\t\t...options,\n\t\t\tsignal: controller.signal,\n\t\t}),\n\t\tgetTimeoutError(timeout, controller),\n\t])\n}\n","import {\n\tCONFIG_RETRY_BASE_DELAY_MS,\n\tCONFIG_RETRY_COUNT,\n\tCONFIG_RETRY_MAX_DELAY_MS,\n\tCOOKIE_NAME_VISITOR,\n\tVISITOR_ID_LENGTH,\n\tVISITOR_ID_PREFIX,\n\tVISITOR_ID_SEPARATOR,\n} from './config/constants'\nimport { CONFIG_PATH, BASE_URL } from './config/urls'\nimport {\n\tImproveConfiguration,\n\tImproveEnvironmentOption,\n\tImproveSetupArgs,\n\tImproveTestState,\n} from './types'\nimport { delay } from './utils/delay'\nimport { getReasonFromStatus, ImproveFetchError } from './utils/errors'\nimport { getRandomString } from './utils/getRandomString'\nimport { normalizeConfig } from './utils/normalizeConfig'\nimport { getBackoffDelayMs, parseRetryAfterMs } from './utils/retry'\nimport { timeoutFetch } from './utils/timeoutFetch'\n\ntype ConfigFetch = {\n\turl: string\n\ttimeout: number\n\tretries: number\n\trevalidate?: number\n}\n\n// Next.js augments RequestInit with a `next` field for its fetch cache.\ntype RequestInitWithNext = RequestInit & {\n\tnext?: { revalidate?: number; tags?: string[] }\n}\n\nexport class BaseImproveSDK {\n\torganizationId: string\n\tenvironment: ImproveEnvironmentOption = 'develop'\n\tstate: ImproveTestState\n\n\t#configFetch: ConfigFetch | null = null\n\n\tconfig: ImproveConfiguration | null = null\n\n\t_baseUrl: undefined | string\n\n\tconstructor({\n\t\torganizationId,\n\t\tenvironment,\n\t\tstate,\n\t\tconfig,\n\t\tfetchTimeout,\n\t\tbaseUrl,\n\t\tconfigRetries,\n\t\tconfigRevalidate,\n\t}: ImproveSetupArgs) {\n\t\tthis.organizationId = organizationId\n\t\tthis.environment = environment\n\t\tthis.state = state\n\t\tthis._baseUrl = baseUrl || BASE_URL\n\n\t\tif (config) {\n\t\t\tthis.config = config\n\t\t} else {\n\t\t\tthis.#configFetch = {\n\t\t\t\turl: [\n\t\t\t\t\t`${this._baseUrl}${CONFIG_PATH}`,\n\t\t\t\t\tthis.organizationId,\n\t\t\t\t\tthis.environment,\n\t\t\t\t\tthis.state || 'active',\n\t\t\t\t].join('/'),\n\t\t\t\ttimeout: fetchTimeout || 3000,\n\t\t\t\tretries: configRetries ?? CONFIG_RETRY_COUNT,\n\t\t\t\trevalidate: configRevalidate,\n\t\t\t}\n\t\t}\n\t}\n\n\t_fetchConfig = async (config?: RequestInit) => {\n\t\tif (this.config) return\n\n\t\tif (!this.#configFetch) throw new Error('No config fetch setup provided')\n\n\t\tconst { url, timeout, retries, revalidate } = this.#configFetch\n\n\t\t// Opt into the Next.js fetch cache when a revalidate window is configured,\n\t\t// so the datafile is reused across requests instead of re-fetched.\n\t\tconst requestInit: RequestInitWithNext = { ...config }\n\t\tif (typeof revalidate === 'number') {\n\t\t\trequestInit.next = {\n\t\t\t\t...(config as RequestInitWithNext | undefined)?.next,\n\t\t\t\trevalidate,\n\t\t\t}\n\t\t}\n\n\t\t// Seed with a generic network error so an exhausted loop always has a\n\t\t// meaningful, typed error to throw.\n\t\tlet lastError = new ImproveFetchError('network')\n\n\t\tfor (let attempt = 0; attempt <= retries; attempt++) {\n\t\t\tif (attempt > 0) {\n\t\t\t\t// Prefer a server-provided Retry-After; otherwise back off with jitter.\n\t\t\t\tawait delay(\n\t\t\t\t\tlastError.retryAfterMs ??\n\t\t\t\t\t\tgetBackoffDelayMs(\n\t\t\t\t\t\t\tattempt - 1,\n\t\t\t\t\t\t\tCONFIG_RETRY_BASE_DELAY_MS,\n\t\t\t\t\t\t\tCONFIG_RETRY_MAX_DELAY_MS,\n\t\t\t\t\t\t),\n\t\t\t\t)\n\t\t\t}\n\n\t\t\tlet res: Response | null\n\t\t\ttry {\n\t\t\t\tres = await timeoutFetch(timeout, url, requestInit)\n\t\t\t} catch (cause) {\n\t\t\t\t// timeoutFetch aborts on timeout (AbortError) and rejects on\n\t\t\t\t// network-level failures — both are transient and retryable.\n\t\t\t\tconst aborted = cause instanceof Error && cause.name === 'AbortError'\n\t\t\t\tlastError = new ImproveFetchError(aborted ? 'timeout' : 'network', {\n\t\t\t\t\tcause,\n\t\t\t\t})\n\t\t\t\tcontinue\n\t\t\t}\n\n\t\t\t// timeoutFetch resolves null when the timeout wins the race.\n\t\t\tif (!res) {\n\t\t\t\tlastError = new ImproveFetchError('timeout')\n\t\t\t\tcontinue\n\t\t\t}\n\n\t\t\tif (res.ok) {\n\t\t\t\ttry {\n\t\t\t\t\tthis.config = normalizeConfig(await res.json())\n\t\t\t\t} catch (cause) {\n\t\t\t\t\tlastError =\n\t\t\t\t\t\tcause instanceof ImproveFetchError\n\t\t\t\t\t\t\t? cause\n\t\t\t\t\t\t\t: new ImproveFetchError('invalid-response', { cause })\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t\treturn this.config\n\t\t\t}\n\n\t\t\tlastError = new ImproveFetchError(getReasonFromStatus(res.status), {\n\t\t\t\tstatus: res.status,\n\t\t\t\tretryAfterMs: parseRetryAfterMs(res.headers.get('Retry-After')),\n\t\t\t})\n\n\t\t\t// Auth/validation rejections won't change on retry — fail fast.\n\t\t\tif (!lastError.isRetryable) break\n\t\t}\n\n\t\tthrow lastError\n\t}\n\n\tloadConfig = (config: ImproveConfiguration) => {\n\t\tthis.config = config\n\t}\n\n\tgenerateVisitorId = () => {\n\t\treturn [\n\t\t\tVISITOR_ID_PREFIX,\n\t\t\tgetRandomString(VISITOR_ID_LENGTH).toUpperCase(),\n\t\t].join(VISITOR_ID_SEPARATOR)\n\t}\n\n\tgetVisitorCookieName = () => COOKIE_NAME_VISITOR\n\n\tvalidateTestValue = (testName: string, testValue: string) => {\n\t\tif (!this.config)\n\t\t\tthrow new Error(\n\t\t\t\t'Config is required before validating, either use `.fetchConfig()`, .loadConfig(config) or provide it during setup',\n\t\t\t)\n\n\t\tconst testConfig = this.config.tests[testName]\n\n\t\tif (!testConfig) throw new Error(`No config found for ${testName}`)\n\n\t\treturn Boolean(\n\t\t\ttestConfig.options.find((option) => option.slug === testValue),\n\t\t)\n\t}\n\n\tvalidateVisitorId = (possibleVisitorId: string) => {\n\t\tconst visitorIdParts = possibleVisitorId.split(VISITOR_ID_SEPARATOR)\n\t\tif (visitorIdParts.length !== 2) return false\n\t\tconst [key, value] = visitorIdParts as [string, string]\n\t\treturn key === VISITOR_ID_PREFIX && value.length === VISITOR_ID_LENGTH\n\t}\n}\n","export const BASE_URL = 'https://improve.obelism.studio'\nexport const CONFIG_PATH = `/config`\nexport const ANALYTICS_PATH = `/api/log`\n","import { ParsedUserAgent, parseUserAgent } from './utils/parseUserAgent'\nimport { getVisitorMatchesAudience } from './utils/getVisitorMatchesAudience'\nimport { getRandomTestValue } from './utils/getRandomTestValue'\nimport { BaseImproveSDK } from './base'\nimport { ImproveConfiguration, ImproveSetupArgs } from './types'\n\nconst DEFAULT_MAX_VISITORS = 10_000\n\ntype VisitorData = {\n\t[userAgent: string]: ParsedUserAgent & {\n\t\t[testSlug: string]: string\n\t}\n}\n\ntype ImproveServerSetupArgs =\n\t| (Omit<ImproveSetupArgs, 'config' | 'baseUrl'> & {\n\t\t\tconfig: ImproveConfiguration\n\t\t\tmaxVisitors?: number\n\t  })\n\t| (Omit<ImproveSetupArgs, 'config'> & {\n\t\t\ttoken: string\n\t\t\tmaxVisitors?: number\n\t  })\n\nexport class ImproveServerSDK extends BaseImproveSDK {\n\t#visitors: Map<string, VisitorData> = new Map()\n\t#maxVisitors: number\n\t#token: string\n\n\t// @ts-ignore It could be there\n\tconstructor({ token, maxVisitors, ...args }: ImproveServerSetupArgs) {\n\t\tsuper(args)\n\t\tthis.#token = token\n\t\tthis.#maxVisitors = maxVisitors ?? DEFAULT_MAX_VISITORS\n\t}\n\n\tfetchConfig = async (config?: RequestInit) => {\n\t\treturn this._fetchConfig({\n\t\t\t...config,\n\t\t\theaders: {\n\t\t\t\t...config?.headers,\n\t\t\t\ttoken: this.#token,\n\t\t\t},\n\t\t})\n\t}\n\n\tgetFlagConfig = (flagSlug: string) => this.config?.flags?.[flagSlug]\n\n\tgetTestConfig = (testSlug: string) => this.config?.tests?.[testSlug]\n\n\t#getVisitor = (visitorId: string, userAgent: string) => {\n\t\tlet visitor = this.#visitors.get(visitorId)\n\t\tif (visitor) {\n\t\t\t// Move to end for LRU freshness\n\t\t\tthis.#visitors.delete(visitorId)\n\t\t\tthis.#visitors.set(visitorId, visitor)\n\t\t} else {\n\t\t\t// Evict oldest entries when at capacity\n\t\t\tif (this.#visitors.size >= this.#maxVisitors) {\n\t\t\t\tconst oldest = this.#visitors.keys().next().value\n\t\t\t\tif (oldest) this.#visitors.delete(oldest)\n\t\t\t}\n\t\t\tvisitor = {}\n\t\t\tthis.#visitors.set(visitorId, visitor)\n\t\t}\n\t\tvisitor[userAgent] = visitor[userAgent] || parseUserAgent(userAgent)\n\t\treturn visitor\n\t}\n\n\tgetFlagValue = (flagSlug: string, visitorId: string, userAgent: string) => {\n\t\tconst flagConfig = this.getFlagConfig(flagSlug)\n\n\t\tif (!flagConfig || !this.config) return null\n\t\tif (!visitorId) return flagConfig.options[0].slug\n\n\t\tconst visitor = this.#getVisitor(visitorId, userAgent)\n\n\t\tif (visitor[userAgent]?.[flagSlug]) {\n\t\t\treturn visitor[userAgent][flagSlug]\n\t\t}\n\n\t\tconst visitorMatchesAudience = getVisitorMatchesAudience(\n\t\t\tthis.config.audience[flagConfig.audience],\n\t\t\tvisitor[userAgent],\n\t\t)\n\n\t\tif (!visitorMatchesAudience) return flagConfig.options[0].slug\n\n\t\tconst flagValue = getRandomTestValue(flagConfig.options)\n\n\t\tif (!flagValue) return null\n\n\t\tvisitor[userAgent][flagSlug] = flagValue\n\t\treturn flagValue\n\t}\n\n\tgetTestValue = (testSlug: string, visitorId: string, userAgent: string) => {\n\t\tconst testConfig = this.getTestConfig(testSlug)\n\n\t\tif (!testConfig || !this.config) return null\n\n\t\tif (!visitorId || !userAgent) return testConfig.defaultValue\n\n\t\tconst visitor = this.#getVisitor(visitorId, userAgent)\n\n\t\tif (visitor[userAgent]?.[testSlug]) {\n\t\t\treturn visitor[userAgent][testSlug]\n\t\t}\n\n\t\tconst visitorMatchesAudience = getVisitorMatchesAudience(\n\t\t\tthis.config.audience[testConfig.audience],\n\t\t\tvisitor[userAgent],\n\t\t)\n\n\t\tif (!visitorMatchesAudience) return testConfig.defaultValue\n\n\t\tif (\n\t\t\ttestConfig.allocation < 100 &&\n\t\t\tMath.random() * 100 > testConfig.allocation\n\t\t) {\n\t\t\tvisitor[userAgent][testSlug] = testConfig.defaultValue\n\t\t\treturn visitor[userAgent][testSlug]\n\t\t}\n\n\t\tconst testValue = getRandomTestValue(testConfig.options)\n\n\t\tif (!testValue) return null\n\n\t\tvisitor[userAgent][testSlug] = testValue\n\t\treturn testValue\n\t}\n}\n"],"names":["SOCIAL_BROWSERS","PRIMARY_TOUCH_DEVICES","getVisitorMatchesAudience","audience","visitorParams","Object","entries","every","paramKey","paramValue","getRandomTestValue","options","length","slug","value","Math","random","reduce","acc","split","match","find","VISITOR_ID_PREFIX","delay","ms","Promise","resolve","setTimeout","REASON_MESSAGES","timeout","network","unauthorized","server","client","ImproveFetchError","Error","reason","name","status","retryAfterMs","cause","isRetryable","getReasonFromStatus","CHAR_SET","normalizeConfig","body","Array","isArray","raw","version","tests","flags","parseRetryAfterMs","header","now","Date","seconds","Number","isFinite","max","round","date","parse","isNaN","getBackoffDelayMs","attempt","baseDelay","maxDelay","min","getTimeoutError","controller","abort","timeoutFetch","url","AbortController","race","fetch","signal","BaseImproveSDK","organizationId","environment","state","config","fetchTimeout","baseUrl","configRetries","configRevalidate","_fetchConfig","retries","revalidate","requestInit","next","lastError","res","aborted","ok","json","headers","get","loadConfig","generateVisitorId","getRandomString","characters","fill","charAt","floor","toUpperCase","join","getVisitorCookieName","validateTestValue","testName","testValue","testConfig","Boolean","option","validateVisitorId","possibleVisitorId","visitorIdParts","key","_baseUrl","ImproveServerSDK","token","maxVisitors","args","Map","fetchConfig","getFlagConfig","flagSlug","getTestConfig","testSlug","visitorId","userAgent","visitor","delete","set","size","oldest","keys","parseUserAgent","deviceType","results","parser","UAParser","getResult","device","type","AUDIENCE_PARAMS","includes","pointer","browser","formatBrowser","browserName","toLowerCase","browserTypeMatch","browserType","os","formatOs","osName","osTypeMatch","osType","getFlagValue","flagConfig","flagValue","getTestValue","defaultValue","allocation"],"mappings":"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"}
+{"version":3,"file":"server.mjs","sources":["../src/config/audiences.ts","../src/utils/parseUserAgent.ts","../src/utils/getVisitorMatchesAudience.ts","../src/utils/getRandomTestValue.ts","../src/config/constants.ts","../src/utils/delay.ts","../src/utils/errors.ts","../src/utils/getRandomString.ts","../src/utils/normalizeConfig.ts","../src/utils/retry.ts","../src/utils/getTimeoutError.ts","../src/utils/timeoutFetch.ts","../src/base.ts","../src/config/urls.ts","../src/server.ts"],"sourcesContent":["/**\n * @constant AUDIENCE_PARAMS\n * @description All posibile audience tracking options\n */\nexport const AUDIENCE_PARAMS = {\n\t//? Technical\n\tpointer: ['coarse', 'fine'],\n\tdevice: [\n\t\t'wearable',\n\t\t'mobile',\n\t\t'tablet',\n\t\t'console',\n\t\t'smarttv',\n\t\t'embedded',\n\t\t'desktop',\n\t],\n\tbrowser: [\n\t\t'chrome',\n\t\t'safari',\n\t\t'firefox',\n\t\t'edge',\n\t\t'ie',\n\t\t'samsung internet',\n\t\t'social',\n\t\t'other',\n\t],\n\tos: ['mac os', 'ios', 'android', 'windows', 'unix'],\n} as const\n\n//? Generated types\nexport type AudienceParamKey = keyof typeof AUDIENCE_PARAMS\n\nexport type AudienceParamPointer = (typeof AUDIENCE_PARAMS.pointer)[number]\n\nexport type AudienceParamDevice = (typeof AUDIENCE_PARAMS.device)[number]\n\nexport type AudienceParamBrowser = (typeof AUDIENCE_PARAMS.browser)[number]\n\nexport type AudienceParamOs = (typeof AUDIENCE_PARAMS.os)[number]\n\nexport const AUDIENCE_PARAM_KEYS = Object.keys(\n\tAUDIENCE_PARAMS,\n) as ReadonlyArray<AudienceParamKey>\n","import { UAParser } from 'ua-parser-js'\n\nimport {\n\tAUDIENCE_PARAMS,\n\tAudienceParamBrowser,\n\tAudienceParamDevice,\n\tAudienceParamOs,\n\tAudienceParamPointer,\n} from '../config/audiences'\n\nexport type ParsedUserAgent = {\n\tpointer: AudienceParamPointer\n\tdevice: AudienceParamDevice\n\tbrowser: AudienceParamBrowser\n\tos: AudienceParamOs\n}\n\nconst formatDeviceType = (deviceType?: string): AudienceParamDevice => {\n\tif (\n\t\tdeviceType &&\n\t\tAUDIENCE_PARAMS.device.includes(deviceType as AudienceParamDevice)\n\t) {\n\t\treturn deviceType as AudienceParamDevice\n\t}\n\treturn 'desktop'\n}\n\nconst SOCIAL_BROWSERS: ReadonlyArray<string> = [\n\t'tiktok',\n\t'wechat',\n\t'weibo',\n\t'snapchat',\n\t'klarna',\n\t'Line',\n\t'instagram',\n\t'facebook',\n\t'alipay',\n\t'Baidu',\n]\n\nconst formatBrowser = (browserName: string = ''): AudienceParamBrowser => {\n\tif (!browserName) return 'other'\n\n\tconst name = browserName.toLowerCase()\n\n\tconst browserTypeMatch = AUDIENCE_PARAMS.browser.find((browserType) => {\n\t\treturn name.includes(browserType)\n\t})\n\n\tif (browserTypeMatch) return browserTypeMatch\n\n\tif (SOCIAL_BROWSERS.includes(name)) return 'social'\n\treturn 'other'\n}\n\nconst PRIMARY_TOUCH_DEVICES: ReadonlyArray<AudienceParamDevice> = [\n\t'wearable',\n\t'mobile',\n\t'tablet',\n]\n\nconst formatPointer = (device: AudienceParamDevice) => {\n\treturn PRIMARY_TOUCH_DEVICES.includes(device) ? 'coarse' : 'fine'\n}\n\nconst formatOs = (osName: string = ''): AudienceParamOs => {\n\tif (!osName) return 'unix'\n\n\tconst os = osName.toLowerCase()\n\n\tconst osTypeMatch = AUDIENCE_PARAMS.os.find((osType) => {\n\t\treturn os.includes(osType)\n\t})\n\n\tif (osTypeMatch) return osTypeMatch\n\treturn 'unix'\n}\n\nexport const parseUserAgent = (userAgent: string): ParsedUserAgent | null => {\n\tif (!userAgent || typeof userAgent !== 'string') return null\n\n\tconst parser = new UAParser(userAgent)\n\tconst results = parser.getResult()\n\n\tconst device = formatDeviceType(results.device.type)\n\n\treturn {\n\t\tpointer: formatPointer(device),\n\t\tdevice: device,\n\t\tbrowser: formatBrowser(results.browser.name),\n\t\tos: formatOs(results.os.name),\n\t}\n}\n","import { ImproveAudienceValue } from '../types'\nimport { AudienceParamKey } from '../config/audiences'\nimport { ParsedUserAgent } from './parseUserAgent'\n\nexport const getVisitorMatchesAudience = (\n\taudience: ImproveAudienceValue | undefined,\n\tvisitorParams: ParsedUserAgent,\n) => {\n\tif (!audience) return true\n\treturn Object.entries(audience).every(([paramKey, paramValue]) => {\n\t\treturn visitorParams[paramKey as AudienceParamKey] === paramValue\n\t})\n}\n","import { ImproveTestOption } from '../types'\n\n// function cryptoRandom() {\n// \treturn crypto.getRandomValues(new Uint32Array(1))[0] / (0xffffffff + 1)\n// }\n\nexport const getRandomTestValue = (options: ImproveTestOption[]) => {\n\tif (options.length === 0) return null\n\tif (options.length === 1) return options[0].slug\n\n\t// Get a random number between 0 and 1\n\tconst sum = options.reduce((acc, { split }) => acc + split, 0)\n\tlet value = Math.random() * sum\n\n\tconst match =\n\t\toptions.find(({ split }) => {\n\t\t\tvalue -= split\n\t\t\treturn value <= 0\n\t\t}) || options[0]\n\n\treturn match.slug\n}\n","export const COOKIE_NAME_VISITOR = 'visitorId'\n\nexport const VISITOR_ID_PREFIX = 'visi'\n\nexport const VISITOR_ID_LENGTH = 26\n\nexport const VISITOR_ID_SEPARATOR = '_'\n\n/** Default number of retries for a failed config fetch (network / 5xx / 429). */\nexport const CONFIG_RETRY_COUNT = 2\n\n/** Base delay for config-fetch backoff, in ms. */\nexport const CONFIG_RETRY_BASE_DELAY_MS = 300\n\n/** Upper bound for a single config-fetch backoff wait, in ms. */\nexport const CONFIG_RETRY_MAX_DELAY_MS = 3000\n\n/**\n * Max length of a single analytic string field. The backend rejects any\n * field longer than this (varchar(256)) with a 400, so the client caps\n * developer-controlled values (event, message) to avoid silently dropping\n * the event.\n */\nexport const MAX_ANALYTIC_FIELD_LENGTH = 256\n\n/**\n * Max length of the analytic `currency` field. The backend column is\n * `varchar(8)` (ISO 4217 is 3 chars), and a longer value throws at insert —\n * failing the *entire* event, not just the currency — so the client caps it\n * here rather than at the generic 256-char limit.\n */\nexport const MAX_CURRENCY_FIELD_LENGTH = 8\n\n/**\n * Max size of the analytic POST body. The backend rejects anything larger with\n * a 413 (`MAX_BODY_BYTES = 8 * 1024`), so an oversized `params` payload silently\n * loses the event. Kept in sync with the backend limit.\n */\nexport const MAX_ANALYTIC_BODY_BYTES = 8 * 1024\n\n/**\n * How long to stop sending analytics after the backend returns 429 (usage\n * limit / rate limit) without a `Retry-After`. Avoids hammering an org that is\n * already over its quota.\n */\nexport const ANALYTIC_RATE_LIMIT_COOLDOWN_MS = 60_000\n","export const delay = (ms: number) =>\n\tnew Promise((resolve) => setTimeout(resolve, ms))\n","export type ImproveFetchErrorReason =\n\t| 'timeout'\n\t| 'network'\n\t| 'unauthorized'\n\t| 'rate-limited'\n\t| 'server'\n\t| 'client'\n\t| 'invalid-response'\n\nconst REASON_MESSAGES: Record<ImproveFetchErrorReason, string> = {\n\ttimeout: 'Configuration request timed out',\n\tnetwork: 'Configuration request could not reach the server',\n\tunauthorized:\n\t\t'Configuration request was rejected (403): verify the organizationId, the server token, and that the request origin is whitelisted for this environment',\n\t'rate-limited':\n\t\t'Configuration request was rate limited (429): too many requests, or the organization usage limit was reached',\n\tserver: 'Configuration request failed with a server error',\n\tclient: 'Configuration request was rejected by the server',\n\t'invalid-response': 'Configuration response could not be parsed as JSON',\n}\n\n/**\n * Error thrown by the config fetch layer. Carries the HTTP `status`, a coarse\n * `reason`, and (when the server sent one) the `Retry-After` delay in ms, so\n * callers can distinguish a misconfiguration (unauthorized) from a transient\n * failure (rate-limited/server/timeout) instead of guessing from a string.\n */\nexport class ImproveFetchError extends Error {\n\treason: ImproveFetchErrorReason\n\tstatus?: number\n\tretryAfterMs?: number\n\n\tconstructor(\n\t\treason: ImproveFetchErrorReason,\n\t\toptions?: { status?: number; retryAfterMs?: number; cause?: unknown },\n\t) {\n\t\tsuper(REASON_MESSAGES[reason])\n\t\tthis.name = 'ImproveFetchError'\n\t\tthis.reason = reason\n\t\tthis.status = options?.status\n\t\tthis.retryAfterMs = options?.retryAfterMs\n\t\tif (options && 'cause' in options) {\n\t\t\t;(this as { cause?: unknown }).cause = options.cause\n\t\t}\n\t}\n\n\t/** Whether retrying the request could plausibly succeed. */\n\tget isRetryable() {\n\t\treturn (\n\t\t\tthis.reason === 'rate-limited' ||\n\t\t\tthis.reason === 'server' ||\n\t\t\tthis.reason === 'timeout' ||\n\t\t\tthis.reason === 'network'\n\t\t)\n\t}\n}\n\n/** Map an HTTP status onto a coarse {@link ImproveFetchErrorReason}. */\nexport const getReasonFromStatus = (\n\tstatus: number,\n): ImproveFetchErrorReason => {\n\tif (status === 429) return 'rate-limited'\n\tif (status === 401 || status === 403) return 'unauthorized'\n\tif (status >= 500) return 'server'\n\treturn 'client'\n}\n","/**\n * @constant CHAR_SET\n * @description Key/value set of characters to be used for generation strings\n */\nconst CHAR_SET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789'\n\n/**\n * @function getRandomString\n * @description Generate a random string\n */\nexport function getRandomString(characters: number = 5): string {\n\tif (!characters || typeof characters !== 'number') return ''\n\treturn Array(characters)\n\t\t.fill('')\n\t\t.reduce((acc) => {\n\t\t\tacc += CHAR_SET.charAt(Math.floor(Math.random() * CHAR_SET.length))\n\t\t\treturn acc\n\t\t}, '')\n}\n","import { ImproveConfiguration } from '../types'\nimport { ImproveFetchError } from './errors'\n\n/**\n * @function normalizeConfig\n * @description Coerce a parsed config response into a well-formed\n * {@link ImproveConfiguration}. The backend returns `200 {}` for an unknown\n * org/environment (and on its own internal error). An empty object is truthy,\n * so it slips past `if (!this.config)` guards and then crashes downstream on\n * `config.tests[slug]` (`Cannot read properties of undefined`). Guaranteeing\n * `tests`/`flags`/`audience` are always objects lets the SDK fail open to\n * default values instead of throwing during render/middleware.\n *\n * Throws {@link ImproveFetchError} `invalid-response` when the body isn't an\n * object at all (e.g. an array, string, or null).\n */\nexport const normalizeConfig = (body: unknown): ImproveConfiguration => {\n\tif (typeof body !== 'object' || body === null || Array.isArray(body)) {\n\t\tthrow new ImproveFetchError('invalid-response')\n\t}\n\n\tconst raw = body as Partial<ImproveConfiguration>\n\n\treturn {\n\t\tname: typeof raw.name === 'string' ? raw.name : '',\n\t\tversion: typeof raw.version === 'number' ? raw.version : 0,\n\t\ttests: raw.tests ?? {},\n\t\tflags: raw.flags ?? {},\n\t\taudience: raw.audience ?? {},\n\t}\n}\n","/**\n * @function parseRetryAfterMs\n * @description Parse an HTTP `Retry-After` header into milliseconds. Supports\n * both the delta-seconds form (`\"120\"`) and the HTTP-date form\n * (`\"Wed, 21 Oct 2026 07:28:00 GMT\"`). Returns `undefined` when the header is\n * absent or unparseable so the caller can fall back to computed backoff.\n *\n * @param {string | null} [header] - the raw `Retry-After` header value\n * @param {number} [now] - current epoch ms (injectable for testing)\n */\nexport const parseRetryAfterMs = (\n\theader: string | null | undefined,\n\tnow: number = Date.now(),\n): number | undefined => {\n\tif (!header) return undefined\n\n\tconst seconds = Number(header)\n\tif (Number.isFinite(seconds)) return Math.max(0, Math.round(seconds * 1000))\n\n\tconst date = Date.parse(header)\n\tif (Number.isNaN(date)) return undefined\n\n\treturn Math.max(0, date - now)\n}\n\n/**\n * @function getBackoffDelayMs\n * @description Exponential backoff with full jitter, capped at `maxDelay`.\n * Jitter spreads retries so concurrent clients don't stampede the origin in\n * lockstep after a shared failure.\n *\n * @param {number} attempt - zero-based retry attempt index\n * @param {number} baseDelay - base delay in ms\n * @param {number} maxDelay - upper bound in ms\n */\nexport const getBackoffDelayMs = (\n\tattempt: number,\n\tbaseDelay: number,\n\tmaxDelay: number,\n): number => {\n\tconst exponential = Math.min(maxDelay, baseDelay * 2 ** attempt)\n\treturn Math.round(Math.random() * exponential)\n}\n","import { delay } from './delay'\n\n/**\n * @async @function getTimeoutError\n * @description Throw an error after a delay\n *\n * @param {number} [timeout] - time in ms after to reject default: 1000\n * @param {AbortController} [controller] - (optional) AbortController to abort the request\n */\nexport const getTimeoutError = async (\n\ttimeout: number = 1000,\n\tcontroller: AbortController,\n): Promise<null> => {\n\tawait delay(timeout)\n\tcontroller?.abort()\n\treturn null\n}\n","import { getTimeoutError } from './getTimeoutError'\n\n/**\n * @async @function timeoutFetch\n * @description Fetch with a timeout\n *\n * @param {number} timeout - time in ms after to reject default: 3000\n * @param {string} url - url to fetch\n * @param {Object} [options] - (optional) options to pass to fetch\n */\nexport const timeoutFetch = (\n\ttimeout: number = 3000,\n\turl: string,\n\toptions?: object,\n) => {\n\tconst controller = new AbortController()\n\treturn Promise.race([\n\t\tfetch(url, {\n\t\t\t...options,\n\t\t\tsignal: controller.signal,\n\t\t}),\n\t\tgetTimeoutError(timeout, controller),\n\t])\n}\n","import {\n\tCONFIG_RETRY_BASE_DELAY_MS,\n\tCONFIG_RETRY_COUNT,\n\tCONFIG_RETRY_MAX_DELAY_MS,\n\tCOOKIE_NAME_VISITOR,\n\tVISITOR_ID_LENGTH,\n\tVISITOR_ID_PREFIX,\n\tVISITOR_ID_SEPARATOR,\n} from './config/constants'\nimport { CONFIG_PATH, BASE_URL } from './config/urls'\nimport {\n\tImproveConfiguration,\n\tImproveEnvironmentOption,\n\tImproveSetupArgs,\n\tImproveTestState,\n} from './types'\nimport { delay } from './utils/delay'\nimport { getReasonFromStatus, ImproveFetchError } from './utils/errors'\nimport { getRandomString } from './utils/getRandomString'\nimport { normalizeConfig } from './utils/normalizeConfig'\nimport { getBackoffDelayMs, parseRetryAfterMs } from './utils/retry'\nimport { timeoutFetch } from './utils/timeoutFetch'\n\ntype ConfigFetch = {\n\turl: string\n\ttimeout: number\n\tretries: number\n\trevalidate?: number\n}\n\n// Next.js augments RequestInit with a `next` field for its fetch cache.\ntype RequestInitWithNext = RequestInit & {\n\tnext?: { revalidate?: number; tags?: string[] }\n}\n\nexport class BaseImproveSDK {\n\torganizationId: string\n\tenvironment: ImproveEnvironmentOption = 'develop'\n\tstate: ImproveTestState\n\n\t#configFetch: ConfigFetch | null = null\n\n\t#warningsDisabled: boolean = false\n\n\tconfig: ImproveConfiguration | null = null\n\n\t_baseUrl: undefined | string\n\n\tconstructor({\n\t\torganizationId,\n\t\tenvironment,\n\t\tstate,\n\t\tconfig,\n\t\tfetchTimeout,\n\t\tbaseUrl,\n\t\tconfigRetries,\n\t\tconfigRevalidate,\n\t\tdisableWarnings,\n\t}: ImproveSetupArgs) {\n\t\tthis.organizationId = organizationId\n\t\tthis.environment = environment\n\t\tthis.state = state\n\t\tthis._baseUrl = baseUrl || BASE_URL\n\t\tthis.#warningsDisabled = disableWarnings ?? false\n\n\t\tif (config) {\n\t\t\tthis.config = config\n\t\t} else {\n\t\t\tthis.#configFetch = {\n\t\t\t\turl: [\n\t\t\t\t\t`${this._baseUrl}${CONFIG_PATH}`,\n\t\t\t\t\tthis.organizationId,\n\t\t\t\t\tthis.environment,\n\t\t\t\t\tthis.state || 'active',\n\t\t\t\t].join('/'),\n\t\t\t\ttimeout: fetchTimeout || 3000,\n\t\t\t\tretries: configRetries ?? CONFIG_RETRY_COUNT,\n\t\t\t\trevalidate: configRevalidate,\n\t\t\t}\n\t\t}\n\t}\n\n\t_fetchConfig = async (config?: RequestInit) => {\n\t\tif (this.config) return\n\n\t\tif (!this.#configFetch) throw new Error('No config fetch setup provided')\n\n\t\tconst { url, timeout, retries, revalidate } = this.#configFetch\n\n\t\t// Opt into the Next.js fetch cache when a revalidate window is configured,\n\t\t// so the datafile is reused across requests instead of re-fetched.\n\t\tconst requestInit: RequestInitWithNext = { ...config }\n\t\tif (typeof revalidate === 'number') {\n\t\t\trequestInit.next = {\n\t\t\t\t...(config as RequestInitWithNext | undefined)?.next,\n\t\t\t\trevalidate,\n\t\t\t}\n\t\t}\n\n\t\t// Seed with a generic network error so an exhausted loop always has a\n\t\t// meaningful, typed error to throw.\n\t\tlet lastError = new ImproveFetchError('network')\n\n\t\tfor (let attempt = 0; attempt <= retries; attempt++) {\n\t\t\tif (attempt > 0) {\n\t\t\t\t// Prefer a server-provided Retry-After; otherwise back off with jitter.\n\t\t\t\tawait delay(\n\t\t\t\t\tlastError.retryAfterMs ??\n\t\t\t\t\t\tgetBackoffDelayMs(\n\t\t\t\t\t\t\tattempt - 1,\n\t\t\t\t\t\t\tCONFIG_RETRY_BASE_DELAY_MS,\n\t\t\t\t\t\t\tCONFIG_RETRY_MAX_DELAY_MS,\n\t\t\t\t\t\t),\n\t\t\t\t)\n\t\t\t}\n\n\t\t\tlet res: Response | null\n\t\t\ttry {\n\t\t\t\tres = await timeoutFetch(timeout, url, requestInit)\n\t\t\t} catch (cause) {\n\t\t\t\t// timeoutFetch aborts on timeout (AbortError) and rejects on\n\t\t\t\t// network-level failures — both are transient and retryable.\n\t\t\t\tconst aborted = cause instanceof Error && cause.name === 'AbortError'\n\t\t\t\tlastError = new ImproveFetchError(aborted ? 'timeout' : 'network', {\n\t\t\t\t\tcause,\n\t\t\t\t})\n\t\t\t\tcontinue\n\t\t\t}\n\n\t\t\t// timeoutFetch resolves null when the timeout wins the race.\n\t\t\tif (!res) {\n\t\t\t\tlastError = new ImproveFetchError('timeout')\n\t\t\t\tcontinue\n\t\t\t}\n\n\t\t\tif (res.ok) {\n\t\t\t\ttry {\n\t\t\t\t\tthis.config = normalizeConfig(await res.json())\n\t\t\t\t} catch (cause) {\n\t\t\t\t\tlastError =\n\t\t\t\t\t\tcause instanceof ImproveFetchError\n\t\t\t\t\t\t\t? cause\n\t\t\t\t\t\t\t: new ImproveFetchError('invalid-response', { cause })\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t\treturn this.config\n\t\t\t}\n\n\t\t\tlastError = new ImproveFetchError(getReasonFromStatus(res.status), {\n\t\t\t\tstatus: res.status,\n\t\t\t\tretryAfterMs: parseRetryAfterMs(res.headers.get('Retry-After')),\n\t\t\t})\n\n\t\t\t// Auth/validation rejections won't change on retry — fail fast.\n\t\t\tif (!lastError.isRetryable) break\n\t\t}\n\n\t\tthrow lastError\n\t}\n\n\tloadConfig = (config: ImproveConfiguration) => {\n\t\tthis.config = config\n\t}\n\n\tgenerateVisitorId = () => {\n\t\treturn [\n\t\t\tVISITOR_ID_PREFIX,\n\t\t\tgetRandomString(VISITOR_ID_LENGTH).toUpperCase(),\n\t\t].join(VISITOR_ID_SEPARATOR)\n\t}\n\n\tgetVisitorCookieName = () => COOKIE_NAME_VISITOR\n\n\t/**\n\t * Emit a development warning, unless warnings were disabled via the\n\t * `disableWarnings` setup option. Centralized so every SDK warning honors the\n\t * same switch. No-op where `console` is unavailable.\n\t */\n\tprotected _warn = (message: string) => {\n\t\tif (this.#warningsDisabled) return\n\t\tif (typeof console === 'undefined') return\n\t\tconsole.warn(`[Improve] ${message}`)\n\t}\n\n\tvalidateTestValue = (testName: string, testValue: string) => {\n\t\tif (!this.config)\n\t\t\tthrow new Error(\n\t\t\t\t'Config is required before validating, either use `.fetchConfig()`, .loadConfig(config) or provide it during setup',\n\t\t\t)\n\n\t\tconst testConfig = this.config.tests[testName]\n\n\t\tif (!testConfig) throw new Error(`No config found for ${testName}`)\n\n\t\treturn Boolean(\n\t\t\ttestConfig.options.find((option) => option.slug === testValue),\n\t\t)\n\t}\n\n\tvalidateVisitorId = (possibleVisitorId: string) => {\n\t\tconst visitorIdParts = possibleVisitorId.split(VISITOR_ID_SEPARATOR)\n\t\tif (visitorIdParts.length !== 2) return false\n\t\tconst [key, value] = visitorIdParts as [string, string]\n\t\treturn key === VISITOR_ID_PREFIX && value.length === VISITOR_ID_LENGTH\n\t}\n}\n","export const BASE_URL = 'https://improve.obelism.studio'\nexport const CONFIG_PATH = `/config`\nexport const ANALYTICS_PATH = `/api/log`\n","import { ParsedUserAgent, parseUserAgent } from './utils/parseUserAgent'\nimport { getVisitorMatchesAudience } from './utils/getVisitorMatchesAudience'\nimport { getRandomTestValue } from './utils/getRandomTestValue'\nimport { BaseImproveSDK } from './base'\nimport { ImproveConfiguration, ImproveSetupArgs } from './types'\n\nconst DEFAULT_MAX_VISITORS = 10_000\n\ntype VisitorData = {\n\t[userAgent: string]: ParsedUserAgent & {\n\t\t[testSlug: string]: string\n\t}\n}\n\ntype ImproveServerSetupArgs =\n\t| (Omit<ImproveSetupArgs, 'config' | 'baseUrl'> & {\n\t\t\tconfig: ImproveConfiguration\n\t\t\tmaxVisitors?: number\n\t  })\n\t| (Omit<ImproveSetupArgs, 'config'> & {\n\t\t\ttoken: string\n\t\t\tmaxVisitors?: number\n\t  })\n\nexport class ImproveServerSDK extends BaseImproveSDK {\n\t#visitors: Map<string, VisitorData> = new Map()\n\t#maxVisitors: number\n\t#token: string\n\n\t// @ts-ignore It could be there\n\tconstructor({ token, maxVisitors, ...args }: ImproveServerSetupArgs) {\n\t\tsuper(args)\n\t\tthis.#token = token\n\t\tthis.#maxVisitors = maxVisitors ?? DEFAULT_MAX_VISITORS\n\t}\n\n\tfetchConfig = async (config?: RequestInit) => {\n\t\treturn this._fetchConfig({\n\t\t\t...config,\n\t\t\theaders: {\n\t\t\t\t...config?.headers,\n\t\t\t\ttoken: this.#token,\n\t\t\t},\n\t\t})\n\t}\n\n\tgetFlagConfig = (flagSlug: string) => this.config?.flags?.[flagSlug]\n\n\tgetTestConfig = (testSlug: string) => this.config?.tests?.[testSlug]\n\n\t#getVisitor = (visitorId: string, userAgent: string) => {\n\t\tlet visitor = this.#visitors.get(visitorId)\n\t\tif (visitor) {\n\t\t\t// Move to end for LRU freshness\n\t\t\tthis.#visitors.delete(visitorId)\n\t\t\tthis.#visitors.set(visitorId, visitor)\n\t\t} else {\n\t\t\t// Evict oldest entries when at capacity\n\t\t\tif (this.#visitors.size >= this.#maxVisitors) {\n\t\t\t\tconst oldest = this.#visitors.keys().next().value\n\t\t\t\tif (oldest) this.#visitors.delete(oldest)\n\t\t\t}\n\t\t\tvisitor = {}\n\t\t\tthis.#visitors.set(visitorId, visitor)\n\t\t}\n\t\tvisitor[userAgent] = visitor[userAgent] || parseUserAgent(userAgent)\n\t\treturn visitor\n\t}\n\n\tgetFlagValue = (flagSlug: string, visitorId: string, userAgent: string) => {\n\t\tconst flagConfig = this.getFlagConfig(flagSlug)\n\n\t\tif (!flagConfig || !this.config) return null\n\t\tif (!visitorId) return flagConfig.options[0].slug\n\n\t\tconst visitor = this.#getVisitor(visitorId, userAgent)\n\n\t\tif (visitor[userAgent]?.[flagSlug]) {\n\t\t\treturn visitor[userAgent][flagSlug]\n\t\t}\n\n\t\tconst visitorMatchesAudience = getVisitorMatchesAudience(\n\t\t\tthis.config.audience[flagConfig.audience],\n\t\t\tvisitor[userAgent],\n\t\t)\n\n\t\tif (!visitorMatchesAudience) return flagConfig.options[0].slug\n\n\t\tconst flagValue = getRandomTestValue(flagConfig.options)\n\n\t\tif (!flagValue) return null\n\n\t\tvisitor[userAgent][flagSlug] = flagValue\n\t\treturn flagValue\n\t}\n\n\tgetTestValue = (testSlug: string, visitorId: string, userAgent: string) => {\n\t\tconst testConfig = this.getTestConfig(testSlug)\n\n\t\tif (!testConfig || !this.config) return null\n\n\t\tif (!visitorId || !userAgent) return testConfig.defaultValue\n\n\t\tconst visitor = this.#getVisitor(visitorId, userAgent)\n\n\t\tif (visitor[userAgent]?.[testSlug]) {\n\t\t\treturn visitor[userAgent][testSlug]\n\t\t}\n\n\t\tconst visitorMatchesAudience = getVisitorMatchesAudience(\n\t\t\tthis.config.audience[testConfig.audience],\n\t\t\tvisitor[userAgent],\n\t\t)\n\n\t\tif (!visitorMatchesAudience) return testConfig.defaultValue\n\n\t\tif (\n\t\t\ttestConfig.allocation < 100 &&\n\t\t\tMath.random() * 100 > testConfig.allocation\n\t\t) {\n\t\t\tvisitor[userAgent][testSlug] = testConfig.defaultValue\n\t\t\treturn visitor[userAgent][testSlug]\n\t\t}\n\n\t\tconst testValue = getRandomTestValue(testConfig.options)\n\n\t\tif (!testValue) return null\n\n\t\tvisitor[userAgent][testSlug] = testValue\n\t\treturn testValue\n\t}\n}\n"],"names":["SOCIAL_BROWSERS","PRIMARY_TOUCH_DEVICES","getVisitorMatchesAudience","audience","visitorParams","Object","entries","every","paramKey","paramValue","getRandomTestValue","options","length","slug","value","Math","random","reduce","acc","split","match","find","VISITOR_ID_PREFIX","delay","ms","Promise","resolve","setTimeout","REASON_MESSAGES","timeout","network","unauthorized","server","client","ImproveFetchError","Error","reason","name","status","retryAfterMs","cause","isRetryable","getReasonFromStatus","CHAR_SET","normalizeConfig","body","Array","isArray","raw","version","tests","flags","parseRetryAfterMs","header","now","Date","seconds","Number","isFinite","max","round","date","parse","isNaN","getBackoffDelayMs","attempt","baseDelay","maxDelay","min","getTimeoutError","controller","abort","timeoutFetch","url","AbortController","race","fetch","signal","BaseImproveSDK","organizationId","environment","state","config","fetchTimeout","baseUrl","configRetries","configRevalidate","disableWarnings","_fetchConfig","retries","revalidate","requestInit","next","lastError","res","aborted","ok","json","headers","get","loadConfig","generateVisitorId","getRandomString","characters","fill","charAt","floor","toUpperCase","join","getVisitorCookieName","_warn","message","console","warn","validateTestValue","testName","testValue","testConfig","Boolean","option","validateVisitorId","possibleVisitorId","visitorIdParts","key","_baseUrl","ImproveServerSDK","token","maxVisitors","args","Map","fetchConfig","getFlagConfig","flagSlug","getTestConfig","testSlug","visitorId","userAgent","visitor","delete","set","size","oldest","keys","parseUserAgent","deviceType","results","parser","UAParser","getResult","device","type","AUDIENCE_PARAMS","includes","pointer","browser","formatBrowser","browserName","toLowerCase","browserTypeMatch","browserType","os","formatOs","osName","osTypeMatch","osType","getFlagValue","flagConfig","flagValue","getTestValue","defaultValue","allocation"],"mappings":"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"}

package/dist/types.d.ts

@@ -44,6 +44,12 @@ type ImproveSetupArgs = {
      * Enabled by default; set to `false` to opt out. No effect server-side.
      */
     dataLayer?: boolean;
+    /**
+     * Silence all Improve development warnings (e.g. the nudge when an event name
+     * isn't `snake_case`). Warnings are on by default to steer teams toward the
+     * naming convention; set to `true` in production or to opt out entirely.
+     */
+    disableWarnings?: boolean;
 };
 type ImproveFlagOption = {
     name: string;
@@ -66,10 +72,63 @@ type ImproveFlag = {
 type ImproveFlags = {
     [flagSlug in string]: ImproveFlag;
 };
+/**
+ * Recommended analytic event names, aligned with the Google Analytics 4 /
+ * Google Tag Manager recommended events. Reusing these means your Improve
+ * events line up with any GA4/GTM tagging you already have — especially when
+ * mirroring analytics onto the GTM dataLayer (`dataLayer` setup option).
+ *
+ * @see https://support.google.com/analytics/answer/9267735
+ */
+type ImproveRecommendedEventName = 'page_view' | 'view_item' | 'view_item_list' | 'select_item' | 'add_to_cart' | 'remove_from_cart' | 'view_cart' | 'begin_checkout' | 'add_payment_info' | 'add_shipping_info' | 'purchase' | 'refund' | 'sign_up' | 'login' | 'search' | 'select_content' | 'share' | 'generate_lead';
+/**
+ * The name of an analytic event, e.g. the `event` passed to `postAnalytic`.
+ *
+ * Prefer **`snake_case`** names (`add_to_cart`, `sign_up`, `purchase`) to match
+ * GA4 / GTM conventions, and reuse the same name everywhere the action happens.
+ * Common GA4 recommended names are offered as autocomplete suggestions, but any
+ * string is accepted so you can still use your own custom event names.
+ */
+type ImproveEventName = ImproveRecommendedEventName | (string & {});
 type ImproveEvents = {
-    start: string;
-    metrics: string[];
-    conversion: string;
+    start: ImproveEventName;
+    metrics: ImproveEventName[];
+    conversion: ImproveEventName;
+    /**
+     * Ordered funnel steps for the multi-step conversion view, when the test
+     * defines one. The last step is the conversion; when absent, the funnel is
+     * `[start, ...metrics, conversion]`.
+     */
+    funnel?: ImproveEventName[];
+};
+/**
+ * Structured payload for an analytic event, aligned with Google Analytics 4
+ * event parameters.
+ *
+ * - `value` (with `currency`) is the numeric measure Improve aggregates into
+ *   **revenue / average order value per variant** — pass an order total on your
+ *   conversion event to compare not just how often a variant converts, but at
+ *   what value.
+ * - `params` is passed through to the GTM dataLayer and stored as JSON, but is
+ *   not aggregated by Improve's own results. Use it for a GA4 `ecommerce`
+ *   object (`{ ecommerce: { items: [...] } }`) or any custom event parameters.
+ * - `message` is kept for the simple single-string case.
+ *
+ * `postAnalytic` also accepts a plain string as a shorthand for `{ message }`.
+ */
+type ImproveAnalyticPayload = {
+    /** Numeric value of the event, e.g. an order total. GA4 `value`. */
+    value?: number;
+    /** ISO 4217 currency code for `value`, e.g. `'USD'`. GA4 `currency`. */
+    currency?: string;
+    /** A short freeform label stored alongside the event. */
+    message?: string;
+    /**
+     * Extra event parameters, spread onto the GTM dataLayer entry and stored as
+     * JSON. Provide `{ ecommerce: {...} }` for GA4 ecommerce tags; the SDK clears
+     * the previous `ecommerce` object first to avoid data bleed between events.
+     */
+    params?: Record<string, unknown>;
 };
 type ImproveResult = {
     result: {
@@ -110,5 +169,5 @@ type ImproveConfiguration = {
     audience: ImproveAudience;
 };
 
-export type { ImproveAudience, ImproveAudienceValue, ImproveConfiguration, ImproveEnvironmentOption, ImproveEvents, ImproveFlag, ImproveFlagOption, ImproveFlags, ImproveResult, ImproveSetupArgs, ImproveTest, ImproveTestOption, ImproveTestState, ImproveTests };
+export type { ImproveAnalyticPayload, ImproveAudience, ImproveAudienceValue, ImproveConfiguration, ImproveEnvironmentOption, ImproveEventName, ImproveEvents, ImproveFlag, ImproveFlagOption, ImproveFlags, ImproveRecommendedEventName, ImproveResult, ImproveSetupArgs, ImproveTest, ImproveTestOption, ImproveTestState, ImproveTests };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sources":["../src/config/audiences.ts","../src/types.ts"],"mappings":"AAAA;AACA;AACA;AACA;AACA,cAAc,eAAe;AAC7B;AACA;AACA;AACA;AACA;AACA,KAAK,gBAAgB,gBAAgB,eAAe;;ACTpD,KAAK,wBAAwB;AAC7B,KAAK,gBAAgB;AACrB,KAAK,gBAAgB;AACrB;AACA,iBAAiB,wBAAwB;AACzC,YAAY,gBAAgB;AAC5B,aAAa,oBAAoB;AACjC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,KAAK,iBAAiB;AACtB;AACA;AACA;AACA;AACA;AACA,KAAK,iBAAiB;AACtB;AACA;AACA;AACA;AACA;AACA,KAAK,WAAW;AAChB;AACA;AACA;AACA,aAAa,iBAAiB;AAC9B;AACA,KAAK,YAAY;AACjB,0BAA0B,WAAW;AACrC;AACA,KAAK,aAAa;AAClB;AACA;AACA;AACA;AACA,KAAK,aAAa;AAClB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,KAAK,WAAW;AAChB;AACA;AACA;AACA;AACA;AACA,aAAa,iBAAiB;AAC9B,YAAY,aAAa;AACzB;AACA,KAAK,YAAY;AACjB,0BAA0B,WAAW;AACrC;AACA,KAAK,oBAAoB;AACzB,YAAY,gBAAgB;AAC5B;AACA,KAAK,eAAe;AACpB,8BAA8B,oBAAoB;AAClD;AACA,KAAK,oBAAoB;AACzB;AACA;AACA,WAAW,YAAY;AACvB,WAAW,YAAY;AACvB,cAAc,eAAe;AAC7B;;;;","names":[]}
+{"version":3,"file":"types.d.ts","sources":["../src/config/audiences.ts","../src/types.ts"],"mappings":"AAAA;AACA;AACA;AACA;AACA,cAAc,eAAe;AAC7B;AACA;AACA;AACA;AACA;AACA,KAAK,gBAAgB,gBAAgB,eAAe;;ACTpD,KAAK,wBAAwB;AAC7B,KAAK,gBAAgB;AACrB,KAAK,gBAAgB;AACrB;AACA,iBAAiB,wBAAwB;AACzC,YAAY,gBAAgB;AAC5B,aAAa,oBAAoB;AACjC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,KAAK,iBAAiB;AACtB;AACA;AACA;AACA;AACA;AACA,KAAK,iBAAiB;AACtB;AACA;AACA;AACA;AACA;AACA,KAAK,WAAW;AAChB;AACA;AACA;AACA,aAAa,iBAAiB;AAC9B;AACA,KAAK,YAAY;AACjB,0BAA0B,WAAW;AACrC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,KAAK,2BAA2B;AAChC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,KAAK,gBAAgB,GAAG,2BAA2B;AACnD,KAAK,aAAa;AAClB,WAAW,gBAAgB;AAC3B,aAAa,gBAAgB;AAC7B,gBAAgB,gBAAgB;AAChC;AACA;AACA;AACA;AACA;AACA,aAAa,gBAAgB;AAC7B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,KAAK,sBAAsB;AAC3B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,aAAa,MAAM;AACnB;AACA,KAAK,aAAa;AAClB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,KAAK,WAAW;AAChB;AACA;AACA;AACA;AACA;AACA,aAAa,iBAAiB;AAC9B,YAAY,aAAa;AACzB;AACA,KAAK,YAAY;AACjB,0BAA0B,WAAW;AACrC;AACA,KAAK,oBAAoB;AACzB,YAAY,gBAAgB;AAC5B;AACA,KAAK,eAAe;AACpB,8BAA8B,oBAAoB;AAClD;AACA,KAAK,oBAAoB;AACzB;AACA;AACA,WAAW,YAAY;AACvB,WAAW,YAAY;AACvB,cAAc,eAAe;AAC7B;;;;","names":[]}

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@obelism/improve-sdk",
 	"description": "Obelism Improve SDK",
-	"version": "1.1.0",
+	"version": "2.0.0",
 	"keywords": [
 		"ab-tests",
 		"feature-flags",