@envflags/js-sdk 0.1.0

package/README.md

@@ -0,0 +1,83 @@
+# `@envflags/js-sdk`
+
+The reference envflags SDK for browsers, Node.js, and Workers. It downloads an
+immutable flag payload, keeps it in memory, and evaluates flags synchronously.
+
+```ts
+import { createClient } from '@envflags/js-sdk'
+
+const flags = await createClient('client_…').initialize()
+flags.setContext({ key: 'user-123', country: 'BE' })
+
+const enabled = flags.boolVariation('new-checkout', false)
+
+flags.close()
+```
+
+In a browser session, call `setContext` once and omit context on later reads. On
+the server, skip `setContext` and pass context as the last argument so one
+client can evaluate many users. Context is optional: flags that do not depend on
+who is asking still evaluate off/fallthrough without it.
+
+```ts
+flags.boolVariation('new-checkout', false, { key: 'user-123', country: 'BE' })
+```
+
+By default the client polls every 30 seconds and fetches a new payload only when
+its version changes. Set `pollIntervalMs: false` to refresh manually. Supply a
+previously persisted payload as `bootstrap` to remain available when the first
+network request fails. Once initialized, refresh failures keep the last-known
+payload active. Typed variation methods always fall back to the caller's default
+when a flag is missing or has the wrong value type.
+
+## React
+
+Define the application's flags once with any
+[Standard Schema](https://standardschema.dev/) validator. The resulting API
+knows every flag key, return type, and fallback value. Remote values are
+validated before they reach application code, including structured JSON flags.
+
+```tsx
+import { flag } from '@envflags/js-sdk'
+import { defineFlags } from '@envflags/js-sdk/react'
+import { z } from 'zod'
+
+const envflags = defineFlags({
+  'new-checkout': flag(z.boolean(), false),
+  'checkout-config': flag(
+    z.object({
+      layout: z.enum(['compact', 'comfortable']),
+      maximumItems: z.number().int().positive(),
+    }),
+    { layout: 'comfortable', maximumItems: 20 },
+  ),
+})
+
+const client = envflags.createClient('client_…')
+
+function App() {
+  return (
+    <envflags.EnvflagsProvider client={client} context={{ key: 'user-123' }}>
+      <Checkout />
+    </envflags.EnvflagsProvider>
+  )
+}
+
+function Checkout() {
+  const enabled = envflags.useFlag('new-checkout') // boolean
+  const config = envflags.useFlag('checkout-config') // fully typed object
+  return enabled ? <NewCheckout /> : <OldCheckout />
+}
+```
+
+Schemas must validate synchronously. Flags can contain booleans, numbers,
+strings, `null`, arrays, or objects. Defaults are validated immediately. An
+invalid remote variation reports through the client's `onError` callback and
+resolves to its registered default. `useFlag` accepts an optional second
+argument to override the provider context for one evaluation.
+
+The provider initializes its client and re-renders consumers when a new payload
+arrives. It does not close the client when it unmounts because the client may be
+shared; call `client.close()` when the application is finished with it. The
+low-level `variation` and typed variation methods remain available for dynamic
+flag keys and gradual migration.

package/dist/client.d.ts

@@ -0,0 +1,31 @@
+import type { EvaluationContext, EvaluationPayload, JsonValue } from './types';
+type Fetch = typeof globalThis.fetch;
+export type EnvflagsClientOptions = {
+    baseUrl?: string;
+    bootstrap?: EvaluationPayload;
+    fetch?: Fetch;
+    onError?: (error: Error) => void;
+    pollIntervalMs?: number | false;
+};
+export declare class EnvflagsClient {
+    #private;
+    constructor(sdkKey: string, options?: EnvflagsClientOptions);
+    get initialized(): boolean;
+    get version(): number | undefined;
+    /** Subscribe to payload changes. Intended for UI framework bindings. */
+    subscribe: (listener: () => void) => () => void;
+    /** Return a stable value suitable for React's useSyncExternalStore. */
+    getSnapshot: () => number;
+    protected reportError(error: Error): void;
+    initialize(): Promise<this>;
+    refresh(): Promise<boolean>;
+    close(): void;
+    setContext(context: EvaluationContext): this;
+    variation<T extends JsonValue>(flagKey: string, defaultValue: T, context?: EvaluationContext): T;
+    boolVariation(flagKey: string, defaultValue: boolean, context?: EvaluationContext): boolean;
+    stringVariation(flagKey: string, defaultValue: string, context?: EvaluationContext): string;
+    numberVariation(flagKey: string, defaultValue: number, context?: EvaluationContext): number;
+    jsonVariation<T extends JsonValue>(flagKey: string, defaultValue: T, context?: EvaluationContext): T;
+}
+export declare function createClient(sdkKey: string, options?: EnvflagsClientOptions): EnvflagsClient;
+export {};

package/dist/evaluate.d.ts

@@ -0,0 +1,3 @@
+import type { EvaluationContext, EvaluationPayload, JsonValue } from './types';
+export declare function bucket(flagKey: string, salt: string, bucketBy: string): number;
+export declare function evaluate<T extends JsonValue>(payload: EvaluationPayload, flagKey: string, context: EvaluationContext | undefined, defaultValue: T): JsonValue;

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { createClient, EnvflagsClient, type EnvflagsClientOptions, } from './client';
+export { bucket, evaluate } from './evaluate';
+export { flag, type FlagDefinition, type FlagDefinitions, type FlagValue, type StandardSchemaIssue, type StandardSchemaOptions, type StandardSchemaOutput, type StandardSchemaPathSegment, type StandardSchemaProps, type StandardSchemaResult, type StandardSchemaTypes, type StandardSchemaV1, } from './schema';
+export { sha1 } from './sha1';
+export type { Clause, ClauseOperator, EvaluationContext, EvaluationPayload, Flag, FlagKind, JsonPrimitive, JsonValue, RolloutEntry, Rule, Segment, Target, VariationSelector, } from './types';

package/dist/index.js

@@ -0,0 +1,2 @@
+import { a as createClient, c as sha1, i as EnvflagsClient, n as flag, o as bucket, s as evaluate } from "./shared.js";
+export { EnvflagsClient, bucket, createClient, evaluate, flag, sha1 };

package/dist/react.d.ts

@@ -0,0 +1,38 @@
+import { type ReactNode } from 'react';
+import type { EnvflagsClient, EnvflagsClientOptions } from './client';
+import { type DefinedEnvflagsClient, type FlagDefinitions, type FlagValue } from './schema';
+import type { EvaluationContext, JsonValue } from './types';
+type EnvflagsReactContext = {
+    client: EnvflagsClient;
+    evaluationContext: EvaluationContext;
+};
+export type EnvflagsProviderProps = {
+    children?: ReactNode;
+    client: EnvflagsClient;
+    context: EvaluationContext;
+};
+/** @deprecated Prefer the typed provider returned by defineFlags(). */
+export declare function EnvflagsProvider({ children, client, context, }: EnvflagsProviderProps): import("react").FunctionComponentElement<import("react").ProviderProps<EnvflagsReactContext | undefined>>;
+/** @deprecated Prefer the schema-validated useFlag() returned by defineFlags(). */
+export declare function useVariation<T extends JsonValue>(flagKey: string, defaultValue: T, context?: EvaluationContext): T;
+/** @deprecated Prefer the schema-validated useFlag() returned by defineFlags(). */
+export declare function useBooleanFlag(flagKey: string, defaultValue: boolean, context?: EvaluationContext): boolean;
+type DefinedReactContext<Definitions extends FlagDefinitions> = {
+    client: DefinedEnvflagsClient<Definitions>;
+    evaluationContext: EvaluationContext;
+};
+export type DefinedEnvflagsProviderProps<Definitions extends FlagDefinitions> = {
+    children?: ReactNode;
+    client: DefinedEnvflagsClient<Definitions>;
+    context: EvaluationContext;
+};
+/**
+ * Bind Standard Schema flag definitions to a typed client, provider, and hook.
+ * Call this once at module scope and export the returned API.
+ */
+export declare function defineFlags<const Definitions extends FlagDefinitions>(definitions: Definitions): {
+    createClient: (sdkKey: string, options?: EnvflagsClientOptions) => DefinedEnvflagsClient<Definitions>;
+    EnvflagsProvider: ({ children, client, context, }: DefinedEnvflagsProviderProps<Definitions>) => import("react").FunctionComponentElement<import("react").ProviderProps<DefinedReactContext<Definitions> | undefined>>;
+    useFlag: <Key extends Extract<keyof Definitions, string>>(flagKey: Key, context?: EvaluationContext) => FlagValue<Definitions, Key>;
+};
+export {};

package/dist/react.js

@@ -0,0 +1,67 @@
+import { r as prepareFlagDefinitions, t as createDefinedClient } from "./shared.js";
+import { createContext, createElement, useContext, useEffect, useMemo, useSyncExternalStore } from "react";
+//#region src/react.ts
+var Context = createContext(void 0);
+/** @deprecated Prefer the typed provider returned by defineFlags(). */
+function EnvflagsProvider({ children, client, context }) {
+	useEffect(() => {
+		client.initialize().catch(() => void 0);
+	}, [client]);
+	const value = useMemo(() => ({
+		client,
+		evaluationContext: context
+	}), [client, context]);
+	return createElement(Context.Provider, { value }, children);
+}
+function useEnvflags() {
+	const value = useContext(Context);
+	if (!value) throw new Error("envflags hooks must be used inside an EnvflagsProvider");
+	useSyncExternalStore(value.client.subscribe, value.client.getSnapshot, value.client.getSnapshot);
+	return value;
+}
+/** @deprecated Prefer the schema-validated useFlag() returned by defineFlags(). */
+function useVariation(flagKey, defaultValue, context) {
+	const envflags = useEnvflags();
+	return envflags.client.variation(flagKey, defaultValue, context ?? envflags.evaluationContext);
+}
+/** @deprecated Prefer the schema-validated useFlag() returned by defineFlags(). */
+function useBooleanFlag(flagKey, defaultValue, context) {
+	const envflags = useEnvflags();
+	return envflags.client.boolVariation(flagKey, defaultValue, context ?? envflags.evaluationContext);
+}
+/**
+* Bind Standard Schema flag definitions to a typed client, provider, and hook.
+* Call this once at module scope and export the returned API.
+*/
+function defineFlags(definitions) {
+	const prepared = prepareFlagDefinitions(definitions);
+	const DefinedContext = createContext(void 0);
+	function createClient(sdkKey, options = {}) {
+		return createDefinedClient(prepared, sdkKey, options);
+	}
+	function DefinedProvider({ children, client, context }) {
+		useEffect(() => {
+			client.initialize().catch(() => void 0);
+		}, [client]);
+		const value = useMemo(() => ({
+			client,
+			evaluationContext: context
+		}), [client, context]);
+		return createElement(DefinedContext.Provider, { value }, children);
+	}
+	function useFlag(flagKey, context) {
+		const value = useContext(DefinedContext);
+		if (!value) throw new Error("useFlag must be used inside its EnvflagsProvider");
+		useSyncExternalStore(value.client.subscribe, value.client.getSnapshot, value.client.getSnapshot);
+		return value.client.flag(flagKey, context ?? value.evaluationContext);
+	}
+	return {
+		createClient,
+		EnvflagsProvider: DefinedProvider,
+		useFlag
+	};
+}
+//#endregion
+export { EnvflagsProvider, defineFlags, useBooleanFlag, useVariation };
+
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","names":[],"sources":["../src/react.ts"],"sourcesContent":["import {\n  type ReactNode,\n  createContext,\n  createElement,\n  useContext,\n  useEffect,\n  useMemo,\n  useSyncExternalStore,\n} from 'react'\n\nimport type { EnvflagsClient, EnvflagsClientOptions } from './client'\nimport {\n  type DefinedEnvflagsClient,\n  type FlagDefinitions,\n  type FlagValue,\n  createDefinedClient,\n  prepareFlagDefinitions,\n} from './schema'\nimport type { EvaluationContext, JsonValue } from './types'\n\ntype EnvflagsReactContext = {\n  client: EnvflagsClient\n  evaluationContext: EvaluationContext\n}\n\nconst Context = createContext<EnvflagsReactContext | undefined>(undefined)\n\nexport type EnvflagsProviderProps = {\n  children?: ReactNode\n  client: EnvflagsClient\n  context: EvaluationContext\n}\n\n/** @deprecated Prefer the typed provider returned by defineFlags(). */\nexport function EnvflagsProvider({\n  children,\n  client,\n  context,\n}: EnvflagsProviderProps) {\n  useEffect(() => {\n    // Failed initialization leaves hooks on their caller-supplied defaults.\n    // The client's onError callback remains the reporting mechanism.\n    void client.initialize().catch(() => undefined)\n  }, [client])\n\n  const value = useMemo(\n    () => ({ client, evaluationContext: context }),\n    [client, context],\n  )\n\n  return createElement(Context.Provider, { value }, children)\n}\n\nfunction useEnvflags() {\n  const value = useContext(Context)\n  if (!value) {\n    throw new Error('envflags hooks must be used inside an EnvflagsProvider')\n  }\n\n  useSyncExternalStore(\n    value.client.subscribe,\n    value.client.getSnapshot,\n    value.client.getSnapshot,\n  )\n  return value\n}\n\n/** @deprecated Prefer the schema-validated useFlag() returned by defineFlags(). */\nexport function useVariation<T extends JsonValue>(\n  flagKey: string,\n  defaultValue: T,\n  context?: EvaluationContext,\n) {\n  const envflags = useEnvflags()\n  return envflags.client.variation(\n    flagKey,\n    defaultValue,\n    context ?? envflags.evaluationContext,\n  )\n}\n\n/** @deprecated Prefer the schema-validated useFlag() returned by defineFlags(). */\nexport function useBooleanFlag(\n  flagKey: string,\n  defaultValue: boolean,\n  context?: EvaluationContext,\n) {\n  const envflags = useEnvflags()\n  return envflags.client.boolVariation(\n    flagKey,\n    defaultValue,\n    context ?? envflags.evaluationContext,\n  )\n}\n\ntype DefinedReactContext<Definitions extends FlagDefinitions> = {\n  client: DefinedEnvflagsClient<Definitions>\n  evaluationContext: EvaluationContext\n}\n\nexport type DefinedEnvflagsProviderProps<Definitions extends FlagDefinitions> =\n  {\n    children?: ReactNode\n    client: DefinedEnvflagsClient<Definitions>\n    context: EvaluationContext\n  }\n\n/**\n * Bind Standard Schema flag definitions to a typed client, provider, and hook.\n * Call this once at module scope and export the returned API.\n */\nexport function defineFlags<const Definitions extends FlagDefinitions>(\n  definitions: Definitions,\n) {\n  const prepared = prepareFlagDefinitions(definitions)\n  const DefinedContext = createContext<\n    DefinedReactContext<Definitions> | undefined\n  >(undefined)\n\n  function createClient(sdkKey: string, options: EnvflagsClientOptions = {}) {\n    return createDefinedClient(prepared, sdkKey, options)\n  }\n\n  function DefinedProvider({\n    children,\n    client,\n    context,\n  }: DefinedEnvflagsProviderProps<Definitions>) {\n    useEffect(() => {\n      void client.initialize().catch(() => undefined)\n    }, [client])\n\n    const value = useMemo(\n      () => ({ client, evaluationContext: context }),\n      [client, context],\n    )\n\n    return createElement(DefinedContext.Provider, { value }, children)\n  }\n\n  function useFlag<Key extends Extract<keyof Definitions, string>>(\n    flagKey: Key,\n    context?: EvaluationContext,\n  ): FlagValue<Definitions, Key> {\n    const value = useContext(DefinedContext)\n    if (!value) {\n      throw new Error('useFlag must be used inside its EnvflagsProvider')\n    }\n\n    useSyncExternalStore(\n      value.client.subscribe,\n      value.client.getSnapshot,\n      value.client.getSnapshot,\n    )\n    return value.client.flag(flagKey, context ?? value.evaluationContext)\n  }\n\n  return {\n    createClient,\n    EnvflagsProvider: DefinedProvider,\n    useFlag,\n  }\n}\n"],"mappings":";;;AAyBA,IAAM,UAAU,cAAgD,KAAA,CAAS;;AASzE,SAAgB,iBAAiB,EAC/B,UACA,QACA,WACwB;CACxB,gBAAgB;EAGd,OAAY,WAAW,CAAC,CAAC,YAAY,KAAA,CAAS;CAChD,GAAG,CAAC,MAAM,CAAC;CAEX,MAAM,QAAQ,eACL;EAAE;EAAQ,mBAAmB;CAAQ,IAC5C,CAAC,QAAQ,OAAO,CAClB;CAEA,OAAO,cAAc,QAAQ,UAAU,EAAE,MAAM,GAAG,QAAQ;AAC5D;AAEA,SAAS,cAAc;CACrB,MAAM,QAAQ,WAAW,OAAO;CAChC,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,wDAAwD;CAG1E,qBACE,MAAM,OAAO,WACb,MAAM,OAAO,aACb,MAAM,OAAO,WACf;CACA,OAAO;AACT;;AAGA,SAAgB,aACd,SACA,cACA,SACA;CACA,MAAM,WAAW,YAAY;CAC7B,OAAO,SAAS,OAAO,UACrB,SACA,cACA,WAAW,SAAS,iBACtB;AACF;;AAGA,SAAgB,eACd,SACA,cACA,SACA;CACA,MAAM,WAAW,YAAY;CAC7B,OAAO,SAAS,OAAO,cACrB,SACA,cACA,WAAW,SAAS,iBACtB;AACF;;;;;AAkBA,SAAgB,YACd,aACA;CACA,MAAM,WAAW,uBAAuB,WAAW;CACnD,MAAM,iBAAiB,cAErB,KAAA,CAAS;CAEX,SAAS,aAAa,QAAgB,UAAiC,CAAC,GAAG;EACzE,OAAO,oBAAoB,UAAU,QAAQ,OAAO;CACtD;CAEA,SAAS,gBAAgB,EACvB,UACA,QACA,WAC4C;EAC5C,gBAAgB;GACd,OAAY,WAAW,CAAC,CAAC,YAAY,KAAA,CAAS;EAChD,GAAG,CAAC,MAAM,CAAC;EAEX,MAAM,QAAQ,eACL;GAAE;GAAQ,mBAAmB;EAAQ,IAC5C,CAAC,QAAQ,OAAO,CAClB;EAEA,OAAO,cAAc,eAAe,UAAU,EAAE,MAAM,GAAG,QAAQ;CACnE;CAEA,SAAS,QACP,SACA,SAC6B;EAC7B,MAAM,QAAQ,WAAW,cAAc;EACvC,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,kDAAkD;EAGpE,qBACE,MAAM,OAAO,WACb,MAAM,OAAO,aACb,MAAM,OAAO,WACf;EACA,OAAO,MAAM,OAAO,KAAK,SAAS,WAAW,MAAM,iBAAiB;CACtE;CAEA,OAAO;EACL;EACA,kBAAkB;EAClB;CACF;AACF"}

package/dist/schema.d.ts

@@ -0,0 +1,57 @@
+import { EnvflagsClient, type EnvflagsClientOptions } from './client';
+import type { EvaluationContext, JsonValue } from './types';
+/** The library-neutral Standard Schema v1 validation contract. */
+export interface StandardSchemaV1<Input = unknown, Output = Input> {
+    readonly '~standard': StandardSchemaProps<Input, Output>;
+}
+export interface StandardSchemaProps<Input = unknown, Output = Input> {
+    readonly version: 1;
+    readonly vendor: string;
+    readonly validate: (value: unknown, options?: StandardSchemaOptions) => StandardSchemaResult<Output> | Promise<StandardSchemaResult<Output>>;
+    readonly types?: StandardSchemaTypes<Input, Output>;
+}
+export interface StandardSchemaOptions {
+    readonly libraryOptions?: Record<string, unknown>;
+}
+export interface StandardSchemaTypes<Input = unknown, Output = Input> {
+    readonly input: Input;
+    readonly output: Output;
+}
+export type StandardSchemaIssue = {
+    readonly message: string;
+    readonly path?: ReadonlyArray<PropertyKey | StandardSchemaPathSegment>;
+};
+export type StandardSchemaPathSegment = {
+    readonly key: PropertyKey;
+};
+export type StandardSchemaResult<Output> = {
+    readonly value: Output;
+    readonly issues?: undefined;
+} | {
+    readonly issues: ReadonlyArray<StandardSchemaIssue>;
+};
+export type StandardSchemaOutput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['output'];
+export type FlagDefinition<Schema extends StandardSchemaV1 = StandardSchemaV1> = {
+    readonly schema: Schema;
+    readonly defaultValue: StandardSchemaOutput<Schema>;
+};
+export type FlagDefinitions = Record<string, FlagDefinition>;
+type FlagKey<Definitions extends FlagDefinitions> = Extract<keyof Definitions, string>;
+export type FlagValue<Definitions extends FlagDefinitions, Key extends FlagKey<Definitions>> = StandardSchemaOutput<Definitions[Key]['schema']>;
+type PreparedDefinition = {
+    schema: StandardSchemaV1<unknown, JsonValue>;
+    defaultValue: JsonValue;
+};
+export type PreparedFlagDefinitions<Definitions extends FlagDefinitions> = {
+    readonly definitions: Readonly<Record<FlagKey<Definitions>, PreparedDefinition>>;
+};
+/** Define one flag's runtime schema and offline/invalid-value fallback. */
+export declare function flag<Schema extends StandardSchemaV1>(schema: Schema, defaultValue: StandardSchemaOutput<Schema>): FlagDefinition<Schema>;
+export declare function prepareFlagDefinitions<Definitions extends FlagDefinitions>(definitions: Definitions): PreparedFlagDefinitions<Definitions>;
+export declare class DefinedEnvflagsClient<Definitions extends FlagDefinitions> extends EnvflagsClient {
+    #private;
+    constructor(sdkKey: string, options: EnvflagsClientOptions, prepared: PreparedFlagDefinitions<Definitions>);
+    flag<Key extends FlagKey<Definitions>>(flagKey: Key, context?: EvaluationContext): FlagValue<Definitions, Key>;
+}
+export declare function createDefinedClient<Definitions extends FlagDefinitions>(prepared: PreparedFlagDefinitions<Definitions>, sdkKey: string, options?: EnvflagsClientOptions): DefinedEnvflagsClient<Definitions>;
+export {};

package/dist/sha1.d.ts

@@ -0,0 +1,2 @@
+/** A small synchronous SHA-1 implementation so flag evaluation stays sync. */
+export declare function sha1(value: string): string;

package/dist/shared.js

@@ -0,0 +1,444 @@
+//#region src/sha1.ts
+function rotateLeft(value, bits) {
+	return (value << bits | value >>> 32 - bits) >>> 0;
+}
+function add(...values) {
+	return values.reduce((sum, value) => sum + value >>> 0, 0);
+}
+/** A small synchronous SHA-1 implementation so flag evaluation stays sync. */
+function sha1(value) {
+	const input = new TextEncoder().encode(value);
+	const paddedLength = Math.ceil((input.length + 9) / 64) * 64;
+	const bytes = new Uint8Array(paddedLength);
+	bytes.set(input);
+	bytes[input.length] = 128;
+	const bitLength = BigInt(input.length) * 8n;
+	const view = new DataView(bytes.buffer);
+	view.setUint32(paddedLength - 8, Number(bitLength >> 32n), false);
+	view.setUint32(paddedLength - 4, Number(bitLength & 4294967295n), false);
+	let h0 = 1732584193;
+	let h1 = 4023233417;
+	let h2 = 2562383102;
+	let h3 = 271733878;
+	let h4 = 3285377520;
+	const words = /* @__PURE__ */ new Uint32Array(80);
+	for (let offset = 0; offset < paddedLength; offset += 64) {
+		for (let index = 0; index < 16; index += 1) words[index] = view.getUint32(offset + index * 4, false);
+		for (let index = 16; index < 80; index += 1) words[index] = rotateLeft(words[index - 3] ^ words[index - 8] ^ words[index - 14] ^ words[index - 16], 1);
+		let a = h0;
+		let b = h1;
+		let c = h2;
+		let d = h3;
+		let e = h4;
+		for (let index = 0; index < 80; index += 1) {
+			let f;
+			let k;
+			if (index < 20) {
+				f = b & c | ~b & d;
+				k = 1518500249;
+			} else if (index < 40) {
+				f = b ^ c ^ d;
+				k = 1859775393;
+			} else if (index < 60) {
+				f = b & c | b & d | c & d;
+				k = 2400959708;
+			} else {
+				f = b ^ c ^ d;
+				k = 3395469782;
+			}
+			const temporary = add(rotateLeft(a, 5), f, e, k, words[index]);
+			e = d;
+			d = c;
+			c = rotateLeft(b, 30);
+			b = a;
+			a = temporary;
+		}
+		h0 = add(h0, a);
+		h1 = add(h1, b);
+		h2 = add(h2, c);
+		h3 = add(h3, d);
+		h4 = add(h4, e);
+	}
+	return [
+		h0,
+		h1,
+		h2,
+		h3,
+		h4
+	].map((word) => word.toString(16).padStart(8, "0")).join("");
+}
+//#endregion
+//#region src/evaluate.ts
+var BUCKET_DENOMINATOR = Number(1152921504606846975n);
+function hasAttribute(context, attribute) {
+	return Object.prototype.hasOwnProperty.call(context, attribute);
+}
+function scalarEquals(left, right) {
+	return (left === null || typeof left === "boolean" || typeof left === "number" || typeof left === "string") && left === right;
+}
+function matchesIn(attribute, values) {
+	return (Array.isArray(attribute) ? attribute : [attribute]).some((item) => values.some((value) => scalarEquals(item, value)));
+}
+function matchesStrings(attribute, values, predicate) {
+	if (typeof attribute !== "string") return false;
+	return values.some((value) => typeof value === "string" && predicate(attribute, value));
+}
+function matchesNumbers(attribute, values, predicate) {
+	if (typeof attribute !== "number" || !Number.isFinite(attribute)) return false;
+	return values.some((value) => typeof value === "number" && Number.isFinite(value) && predicate(attribute, value));
+}
+function instant(value) {
+	if (typeof value === "number") return Number.isFinite(value) ? value : void 0;
+	if (typeof value !== "string" || !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/.test(value)) return;
+	const parsed = Date.parse(value);
+	return Number.isFinite(parsed) ? parsed : void 0;
+}
+function matchesDates(attribute, values, predicate) {
+	const attributeInstant = instant(attribute);
+	if (attributeInstant === void 0) return false;
+	return values.some((value) => {
+		const valueInstant = instant(value);
+		return valueInstant !== void 0 && predicate(attributeInstant, valueInstant);
+	});
+}
+function matchesSegment(segment, context, payload, visiting) {
+	const key = context.key;
+	if (typeof key === "string" && key.length > 0) {
+		if (segment.excluded?.includes(key)) return false;
+		if (segment.included?.includes(key)) return true;
+	}
+	return (segment.rules ?? []).some((rule) => rule.clauses.every((clause) => matchesClause(clause, context, payload, visiting)));
+}
+function matchesSegments(values, context, payload, visiting) {
+	return values.some((value) => {
+		if (typeof value !== "string" || visiting.has(value)) return false;
+		const segment = payload.segments[value];
+		if (!segment) return false;
+		const nestedVisiting = new Set(visiting);
+		nestedVisiting.add(value);
+		return matchesSegment(segment, context, payload, nestedVisiting);
+	});
+}
+function matchesClause(clause, context, payload, visiting) {
+	if (!hasAttribute(context, clause.attribute)) return false;
+	const attribute = context[clause.attribute];
+	switch (clause.op) {
+		case "in": return matchesIn(attribute, clause.values);
+		case "notIn": return !matchesIn(attribute, clause.values);
+		case "startsWith": return matchesStrings(attribute, clause.values, (left, right) => left.startsWith(right));
+		case "endsWith": return matchesStrings(attribute, clause.values, (left, right) => left.endsWith(right));
+		case "contains": return matchesStrings(attribute, clause.values, (left, right) => left.includes(right));
+		case "matches": return matchesStrings(attribute, clause.values, (left, right) => {
+			try {
+				return new RegExp(right).test(left);
+			} catch {
+				return false;
+			}
+		});
+		case "lessThan": return matchesNumbers(attribute, clause.values, (left, right) => left < right);
+		case "greaterThan": return matchesNumbers(attribute, clause.values, (left, right) => left > right);
+		case "before": return matchesDates(attribute, clause.values, (left, right) => left < right);
+		case "after": return matchesDates(attribute, clause.values, (left, right) => left > right);
+		case "segmentMatch": return matchesSegments(clause.values, context, payload, visiting);
+	}
+}
+function bucket(flagKey, salt, bucketBy) {
+	const digest = sha1(`${flagKey}.${salt}.${bucketBy}`);
+	const integer = BigInt(`0x${digest.slice(0, 15)}`);
+	return Number(integer) / BUCKET_DENOMINATOR;
+}
+function selectVariation(selector, flagKey, context, payload) {
+	if ("variation" in selector && selector.variation !== void 0) return selector.variation;
+	const rollout = selector.rollout;
+	if (!rollout?.length) return void 0;
+	const bucketAttribute = selector.bucketBy ?? "key";
+	if (!hasAttribute(context, bucketAttribute)) return rollout.at(-1)?.variation;
+	const bucketBy = String(context[bucketAttribute]);
+	const contextBucket = bucket(flagKey, payload.salt, bucketBy);
+	let accumulatedWeight = 0;
+	for (const entry of rollout) {
+		accumulatedWeight += entry.weight / 1e5;
+		if (contextBucket < accumulatedWeight) return entry.variation;
+	}
+	return rollout.at(-1)?.variation;
+}
+function evaluate(payload, flagKey, context, defaultValue) {
+	const flag = payload.flags[flagKey];
+	if (!flag) return defaultValue;
+	const resolved = context ?? {};
+	const key = resolved.key;
+	let variation;
+	if (!flag.on) variation = flag.offVariation;
+	else {
+		variation = flag.targets.find((target) => typeof key === "string" && key.length > 0 && target.values.includes(key))?.variation;
+		if (variation === void 0) {
+			const rule = flag.rules.find((candidate) => candidate.clauses.every((clause) => matchesClause(clause, resolved, payload, /* @__PURE__ */ new Set())));
+			if (rule) variation = selectVariation(rule, flagKey, resolved, payload);
+		}
+		variation ??= selectVariation(flag.fallthrough, flagKey, resolved, payload);
+	}
+	return variation === void 0 || !(variation in flag.variations) ? defaultValue : flag.variations[variation];
+}
+//#endregion
+//#region src/client.ts
+var DEFAULT_BASE_URL = "https://envflags.com";
+var DEFAULT_POLL_INTERVAL_MS = 3e4;
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parsePollResponse(value) {
+	if (!isRecord(value) || typeof value.envId !== "string" || !Number.isSafeInteger(value.version) || value.version < 0 || typeof value.etag !== "string" || typeof value.payloadUrl !== "string") throw new Error("The envflags poll response is invalid");
+	return value;
+}
+function parsePayload(value) {
+	if (!isRecord(value) || typeof value.envId !== "string" || !Number.isSafeInteger(value.version) || value.version < 0 || typeof value.salt !== "string" || !isRecord(value.flags) || !isRecord(value.segments)) throw new Error("The envflags payload is invalid");
+	return value;
+}
+function responseError(action, response) {
+	return /* @__PURE__ */ new Error(`Unable to ${action}: envflags returned ${response.status} ${response.statusText}`);
+}
+var EnvflagsClient = class {
+	#baseUrl;
+	#fetch;
+	#onError;
+	#pollIntervalMs;
+	#sdkKey;
+	#context;
+	#etag;
+	#payload;
+	#revision = 0;
+	#refreshPromise;
+	#subscribers = /* @__PURE__ */ new Set();
+	#timer;
+	constructor(sdkKey, options = {}) {
+		const normalizedSdkKey = sdkKey.trim();
+		if (!normalizedSdkKey) throw new Error("An envflags SDK key is required");
+		if (options.pollIntervalMs !== void 0 && options.pollIntervalMs !== false && (!Number.isFinite(options.pollIntervalMs) || options.pollIntervalMs < 0)) throw new Error("pollIntervalMs must be a non-negative finite number");
+		this.#sdkKey = normalizedSdkKey;
+		this.#baseUrl = new URL(options.baseUrl ?? DEFAULT_BASE_URL);
+		this.#fetch = options.fetch ?? globalThis.fetch.bind(globalThis);
+		this.#onError = options.onError ?? (() => void 0);
+		this.#pollIntervalMs = options.pollIntervalMs === void 0 ? DEFAULT_POLL_INTERVAL_MS : options.pollIntervalMs;
+		if (options.bootstrap) {
+			this.#payload = parsePayload(options.bootstrap);
+			this.#revision = 1;
+		}
+	}
+	get initialized() {
+		return this.#payload !== void 0;
+	}
+	get version() {
+		return this.#payload?.version;
+	}
+	/** Subscribe to payload changes. Intended for UI framework bindings. */
+	subscribe = (listener) => {
+		this.#subscribers.add(listener);
+		return () => {
+			this.#subscribers.delete(listener);
+		};
+	};
+	/** Return a stable value suitable for React's useSyncExternalStore. */
+	getSnapshot = () => this.#revision;
+	reportError(error) {
+		this.#onError(error);
+	}
+	async initialize() {
+		try {
+			await this.refresh();
+		} catch (cause) {
+			const error = cause instanceof Error ? cause : /* @__PURE__ */ new Error("Unable to initialize envflags");
+			this.reportError(error);
+			if (!this.#payload) throw error;
+		}
+		this.#startPolling();
+		return this;
+	}
+	refresh() {
+		if (!this.#refreshPromise) this.#refreshPromise = this.#performRefresh().finally(() => {
+			this.#refreshPromise = void 0;
+		});
+		return this.#refreshPromise;
+	}
+	close() {
+		if (this.#timer !== void 0) clearInterval(this.#timer);
+		this.#timer = void 0;
+	}
+	setContext(context) {
+		this.#context = context;
+		return this;
+	}
+	variation(flagKey, defaultValue, context) {
+		if (!this.#payload) return defaultValue;
+		return evaluate(this.#payload, flagKey, context ?? this.#context, defaultValue);
+	}
+	boolVariation(flagKey, defaultValue, context) {
+		const value = this.variation(flagKey, defaultValue, context);
+		return typeof value === "boolean" ? value : defaultValue;
+	}
+	stringVariation(flagKey, defaultValue, context) {
+		const value = this.variation(flagKey, defaultValue, context);
+		return typeof value === "string" ? value : defaultValue;
+	}
+	numberVariation(flagKey, defaultValue, context) {
+		const value = this.variation(flagKey, defaultValue, context);
+		return typeof value === "number" && Number.isFinite(value) ? value : defaultValue;
+	}
+	jsonVariation(flagKey, defaultValue, context) {
+		return this.variation(flagKey, defaultValue, context);
+	}
+	async #performRefresh() {
+		const headers = new Headers({
+			accept: "application/json",
+			authorization: `Bearer ${this.#sdkKey}`
+		});
+		if (this.#etag) headers.set("if-none-match", this.#etag);
+		const pollUrl = new URL("/sdk/poll", this.#baseUrl);
+		const pollResponse = await this.#fetch(pollUrl, { headers });
+		if (pollResponse.status === 304) return false;
+		if (!pollResponse.ok) throw responseError("poll for flag updates", pollResponse);
+		const pointer = parsePollResponse(await pollResponse.json());
+		if (this.#payload?.envId === pointer.envId && this.#payload.version === pointer.version) {
+			this.#etag = pointer.etag;
+			return false;
+		}
+		const payloadUrl = new URL(pointer.payloadUrl, this.#baseUrl);
+		const payloadResponse = await this.#fetch(payloadUrl, { headers: {
+			accept: "application/json",
+			authorization: `Bearer ${this.#sdkKey}`
+		} });
+		if (!payloadResponse.ok) throw responseError("fetch the flag payload", payloadResponse);
+		const payload = parsePayload(await payloadResponse.json());
+		if (payload.envId !== pointer.envId || payload.version !== pointer.version) throw new Error("The envflags payload does not match its version pointer");
+		this.#payload = payload;
+		this.#etag = pointer.etag;
+		this.#revision += 1;
+		for (const subscriber of this.#subscribers) subscriber();
+		return true;
+	}
+	#startPolling() {
+		if (this.#timer !== void 0 || this.#pollIntervalMs === false || this.#pollIntervalMs <= 0) return;
+		this.#timer = setInterval(() => {
+			this.refresh().catch((cause) => {
+				this.reportError(cause instanceof Error ? cause : /* @__PURE__ */ new Error("Unable to refresh envflags"));
+			});
+		}, this.#pollIntervalMs);
+	}
+};
+function createClient(sdkKey, options = {}) {
+	return new EnvflagsClient(sdkKey, options);
+}
+//#endregion
+//#region src/schema.ts
+/** Define one flag's runtime schema and offline/invalid-value fallback. */
+function flag(schema, defaultValue) {
+	return {
+		schema,
+		defaultValue
+	};
+}
+function isPromise(value) {
+	return typeof value === "object" && value !== null && "then" in value && typeof value.then === "function";
+}
+function isJsonValue(value, ancestors = /* @__PURE__ */ new Set()) {
+	if (value === null || typeof value === "boolean" || typeof value === "string") return true;
+	if (typeof value === "number") return Number.isFinite(value);
+	if (typeof value !== "object") return false;
+	if (ancestors.has(value)) return false;
+	const nestedAncestors = new Set(ancestors);
+	nestedAncestors.add(value);
+	if (Array.isArray(value)) return value.every((item) => isJsonValue(item, nestedAncestors));
+	const prototype = Object.getPrototypeOf(value);
+	if (prototype !== Object.prototype && prototype !== null) return false;
+	return Object.values(value).every((item) => isJsonValue(item, nestedAncestors));
+}
+function jsonEquals(left, right) {
+	if (left === right) return true;
+	if (Array.isArray(left) || Array.isArray(right)) return Array.isArray(left) && Array.isArray(right) && left.length === right.length && left.every((value, index) => jsonEquals(value, right[index]));
+	if (left === null || right === null) return false;
+	if (typeof left !== "object" || typeof right !== "object") return false;
+	const leftKeys = Object.keys(left);
+	const rightKeys = Object.keys(right);
+	return leftKeys.length === rightKeys.length && leftKeys.every((key) => key in right && jsonEquals(left[key], right[key]));
+}
+function formatIssues(issues) {
+	return issues.map((issue) => issue.message).join("; ") || "validation failed";
+}
+function validate(flagKey, schema, value) {
+	let result;
+	try {
+		result = schema["~standard"].validate(value);
+	} catch (cause) {
+		return {
+			ok: false,
+			message: cause instanceof Error ? cause.message : "validation threw"
+		};
+	}
+	if (isPromise(result)) return {
+		ok: false,
+		message: `Flag "${flagKey}" uses an asynchronous schema; flag schemas must validate synchronously`
+	};
+	if (result.issues) return {
+		ok: false,
+		message: formatIssues(result.issues)
+	};
+	if (!isJsonValue(result.value)) return {
+		ok: false,
+		message: `Flag "${flagKey}" schema produced a non-JSON value`
+	};
+	return {
+		ok: true,
+		value: result.value
+	};
+}
+function prepareFlagDefinitions(definitions) {
+	const prepared = {};
+	for (const [flagKey, definition] of Object.entries(definitions)) {
+		const schema = definition.schema;
+		if (schema?.["~standard"]?.version !== 1) throw new Error(`Flag "${flagKey}" must use a Standard Schema v1 schema`);
+		const result = validate(flagKey, schema, definition.defaultValue);
+		if (!result.ok) throw new Error(`Invalid default for flag "${flagKey}": ${result.message}`);
+		const repeated = validate(flagKey, schema, result.value);
+		if (!repeated.ok || !jsonEquals(result.value, repeated.value)) throw new Error(`Invalid default for flag "${flagKey}": schema output must remain stable when validated again`);
+		prepared[flagKey] = {
+			schema,
+			defaultValue: result.value
+		};
+	}
+	return { definitions: Object.freeze(prepared) };
+}
+var DefinedEnvflagsClient = class extends EnvflagsClient {
+	#prepared;
+	#cacheRevision = -1;
+	#validationCache = /* @__PURE__ */ new Map();
+	constructor(sdkKey, options, prepared) {
+		super(sdkKey, options);
+		this.#prepared = prepared;
+	}
+	flag(flagKey, context) {
+		const definition = this.#prepared.definitions[flagKey];
+		const candidate = this.variation(flagKey, definition.defaultValue, context);
+		if (this.#cacheRevision !== this.getSnapshot()) {
+			this.#cacheRevision = this.getSnapshot();
+			this.#validationCache.clear();
+		}
+		let flagCache = this.#validationCache.get(flagKey);
+		if (!flagCache) {
+			flagCache = /* @__PURE__ */ new Map();
+			this.#validationCache.set(flagKey, flagCache);
+		}
+		let result = flagCache.get(candidate);
+		if (!result) {
+			result = validate(flagKey, definition.schema, candidate);
+			flagCache.set(candidate, result);
+			if (!result.ok) this.reportError(/* @__PURE__ */ new Error(`Invalid value for flag "${flagKey}": ${result.message}; using its default`));
+		}
+		return result.ok ? result.value : definition.defaultValue;
+	}
+};
+function createDefinedClient(prepared, sdkKey, options = {}) {
+	return new DefinedEnvflagsClient(sdkKey, options, prepared);
+}
+//#endregion
+export { createClient as a, sha1 as c, EnvflagsClient as i, flag as n, bucket as o, prepareFlagDefinitions as r, evaluate as s, createDefinedClient as t };
+
+//# sourceMappingURL=shared.js.map

package/dist/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","names":["#baseUrl","#fetch","#onError","#pollIntervalMs","#sdkKey","#payload","#revision","#subscribers","#startPolling","#refreshPromise","#performRefresh","#timer","#context","#etag","#prepared","#cacheRevision","#validationCache"],"sources":["../src/sha1.ts","../src/evaluate.ts","../src/client.ts","../src/schema.ts"],"sourcesContent":["function rotateLeft(value: number, bits: number) {\n  return ((value << bits) | (value >>> (32 - bits))) >>> 0\n}\n\nfunction add(...values: number[]) {\n  return values.reduce((sum, value) => (sum + value) >>> 0, 0)\n}\n\n/** A small synchronous SHA-1 implementation so flag evaluation stays sync. */\nexport function sha1(value: string) {\n  const input = new TextEncoder().encode(value)\n  const paddedLength = Math.ceil((input.length + 9) / 64) * 64\n  const bytes = new Uint8Array(paddedLength)\n  bytes.set(input)\n  bytes[input.length] = 0x80\n\n  const bitLength = BigInt(input.length) * 8n\n  const view = new DataView(bytes.buffer)\n  view.setUint32(paddedLength - 8, Number(bitLength >> 32n), false)\n  view.setUint32(paddedLength - 4, Number(bitLength & 0xffffffffn), false)\n\n  let h0 = 0x67452301\n  let h1 = 0xefcdab89\n  let h2 = 0x98badcfe\n  let h3 = 0x10325476\n  let h4 = 0xc3d2e1f0\n  const words = new Uint32Array(80)\n\n  for (let offset = 0; offset < paddedLength; offset += 64) {\n    for (let index = 0; index < 16; index += 1) {\n      words[index] = view.getUint32(offset + index * 4, false)\n    }\n    for (let index = 16; index < 80; index += 1) {\n      words[index] = rotateLeft(\n        words[index - 3]! ^\n          words[index - 8]! ^\n          words[index - 14]! ^\n          words[index - 16]!,\n        1,\n      )\n    }\n\n    let a = h0\n    let b = h1\n    let c = h2\n    let d = h3\n    let e = h4\n\n    for (let index = 0; index < 80; index += 1) {\n      let f: number\n      let k: number\n\n      if (index < 20) {\n        f = (b & c) | (~b & d)\n        k = 0x5a827999\n      } else if (index < 40) {\n        f = b ^ c ^ d\n        k = 0x6ed9eba1\n      } else if (index < 60) {\n        f = (b & c) | (b & d) | (c & d)\n        k = 0x8f1bbcdc\n      } else {\n        f = b ^ c ^ d\n        k = 0xca62c1d6\n      }\n\n      const temporary = add(rotateLeft(a, 5), f, e, k, words[index]!)\n      e = d\n      d = c\n      c = rotateLeft(b, 30)\n      b = a\n      a = temporary\n    }\n\n    h0 = add(h0, a)\n    h1 = add(h1, b)\n    h2 = add(h2, c)\n    h3 = add(h3, d)\n    h4 = add(h4, e)\n  }\n\n  return [h0, h1, h2, h3, h4]\n    .map(word => word.toString(16).padStart(8, '0'))\n    .join('')\n}\n","import { sha1 } from './sha1'\nimport type {\n  Clause,\n  EvaluationContext,\n  EvaluationPayload,\n  JsonValue,\n  Segment,\n  VariationSelector,\n} from './types'\n\nconst BUCKET_DENOMINATOR = Number(0x0fff_ffff_ffff_ffffn)\n\nfunction hasAttribute(context: EvaluationContext, attribute: string) {\n  return Object.prototype.hasOwnProperty.call(context, attribute)\n}\n\nfunction scalarEquals(left: unknown, right: JsonValue) {\n  return (\n    (left === null ||\n      typeof left === 'boolean' ||\n      typeof left === 'number' ||\n      typeof left === 'string') &&\n    left === right\n  )\n}\n\nfunction matchesIn(attribute: unknown, values: JsonValue[]) {\n  const attributes = Array.isArray(attribute) ? attribute : [attribute]\n  return attributes.some(item =>\n    values.some(value => scalarEquals(item, value)),\n  )\n}\n\nfunction matchesStrings(\n  attribute: unknown,\n  values: JsonValue[],\n  predicate: (attribute: string, value: string) => boolean,\n) {\n  if (typeof attribute !== 'string') return false\n  return values.some(\n    value => typeof value === 'string' && predicate(attribute, value),\n  )\n}\n\nfunction matchesNumbers(\n  attribute: unknown,\n  values: JsonValue[],\n  predicate: (attribute: number, value: number) => boolean,\n) {\n  if (typeof attribute !== 'number' || !Number.isFinite(attribute)) return false\n  return values.some(\n    value =>\n      typeof value === 'number' &&\n      Number.isFinite(value) &&\n      predicate(attribute, value),\n  )\n}\n\nfunction instant(value: unknown) {\n  if (typeof value === 'number')\n    return Number.isFinite(value) ? value : undefined\n  if (\n    typeof value !== 'string' ||\n    !/^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})$/.test(\n      value,\n    )\n  ) {\n    return undefined\n  }\n\n  const parsed = Date.parse(value)\n  return Number.isFinite(parsed) ? parsed : undefined\n}\n\nfunction matchesDates(\n  attribute: unknown,\n  values: JsonValue[],\n  predicate: (attribute: number, value: number) => boolean,\n) {\n  const attributeInstant = instant(attribute)\n  if (attributeInstant === undefined) return false\n\n  return values.some(value => {\n    const valueInstant = instant(value)\n    return (\n      valueInstant !== undefined && predicate(attributeInstant, valueInstant)\n    )\n  })\n}\n\nfunction matchesSegment(\n  segment: Segment,\n  context: EvaluationContext,\n  payload: EvaluationPayload,\n  visiting: Set<string>,\n) {\n  const key = context.key\n  if (typeof key === 'string' && key.length > 0) {\n    if (segment.excluded?.includes(key)) return false\n    if (segment.included?.includes(key)) return true\n  }\n\n  return (segment.rules ?? []).some(rule =>\n    rule.clauses.every(clause =>\n      matchesClause(clause, context, payload, visiting),\n    ),\n  )\n}\n\nfunction matchesSegments(\n  values: JsonValue[],\n  context: EvaluationContext,\n  payload: EvaluationPayload,\n  visiting: Set<string>,\n) {\n  return values.some(value => {\n    if (typeof value !== 'string' || visiting.has(value)) return false\n    const segment = payload.segments[value]\n    if (!segment) return false\n\n    const nestedVisiting = new Set(visiting)\n    nestedVisiting.add(value)\n    return matchesSegment(segment, context, payload, nestedVisiting)\n  })\n}\n\nfunction matchesClause(\n  clause: Clause,\n  context: EvaluationContext,\n  payload: EvaluationPayload,\n  visiting: Set<string>,\n): boolean {\n  if (!hasAttribute(context, clause.attribute)) return false\n  const attribute = context[clause.attribute]\n\n  switch (clause.op) {\n    case 'in':\n      return matchesIn(attribute, clause.values)\n    case 'notIn':\n      return !matchesIn(attribute, clause.values)\n    case 'startsWith':\n      return matchesStrings(attribute, clause.values, (left, right) =>\n        left.startsWith(right),\n      )\n    case 'endsWith':\n      return matchesStrings(attribute, clause.values, (left, right) =>\n        left.endsWith(right),\n      )\n    case 'contains':\n      return matchesStrings(attribute, clause.values, (left, right) =>\n        left.includes(right),\n      )\n    case 'matches':\n      return matchesStrings(attribute, clause.values, (left, right) => {\n        try {\n          return new RegExp(right).test(left)\n        } catch {\n          return false\n        }\n      })\n    case 'lessThan':\n      return matchesNumbers(\n        attribute,\n        clause.values,\n        (left, right) => left < right,\n      )\n    case 'greaterThan':\n      return matchesNumbers(\n        attribute,\n        clause.values,\n        (left, right) => left > right,\n      )\n    case 'before':\n      return matchesDates(\n        attribute,\n        clause.values,\n        (left, right) => left < right,\n      )\n    case 'after':\n      return matchesDates(\n        attribute,\n        clause.values,\n        (left, right) => left > right,\n      )\n    case 'segmentMatch':\n      return matchesSegments(clause.values, context, payload, visiting)\n  }\n}\n\nexport function bucket(flagKey: string, salt: string, bucketBy: string) {\n  const digest = sha1(`${flagKey}.${salt}.${bucketBy}`)\n  const integer = BigInt(`0x${digest.slice(0, 15)}`)\n  return Number(integer) / BUCKET_DENOMINATOR\n}\n\nfunction selectVariation(\n  selector: VariationSelector,\n  flagKey: string,\n  context: EvaluationContext,\n  payload: EvaluationPayload,\n) {\n  if ('variation' in selector && selector.variation !== undefined) {\n    return selector.variation\n  }\n\n  const rollout = selector.rollout\n  if (!rollout?.length) return undefined\n\n  const bucketAttribute = selector.bucketBy ?? 'key'\n  if (!hasAttribute(context, bucketAttribute)) {\n    return rollout.at(-1)?.variation\n  }\n\n  const bucketBy = String(context[bucketAttribute])\n  const contextBucket = bucket(flagKey, payload.salt, bucketBy)\n  let accumulatedWeight = 0\n\n  for (const entry of rollout) {\n    accumulatedWeight += entry.weight / 100_000\n    if (contextBucket < accumulatedWeight) return entry.variation\n  }\n\n  return rollout.at(-1)?.variation\n}\n\nexport function evaluate<T extends JsonValue>(\n  payload: EvaluationPayload,\n  flagKey: string,\n  context: EvaluationContext | undefined,\n  defaultValue: T,\n): JsonValue {\n  const flag = payload.flags[flagKey]\n  if (!flag) return defaultValue\n\n  const resolved = context ?? {}\n  const key = resolved.key\n\n  let variation: number | undefined\n\n  if (!flag.on) {\n    variation = flag.offVariation\n  } else {\n    variation = flag.targets.find(\n      target =>\n        typeof key === 'string' &&\n        key.length > 0 &&\n        target.values.includes(key),\n    )?.variation\n\n    if (variation === undefined) {\n      const rule = flag.rules.find(candidate =>\n        candidate.clauses.every(clause =>\n          matchesClause(clause, resolved, payload, new Set()),\n        ),\n      )\n      if (rule) variation = selectVariation(rule, flagKey, resolved, payload)\n    }\n\n    variation ??= selectVariation(flag.fallthrough, flagKey, resolved, payload)\n  }\n\n  return variation === undefined || !(variation in flag.variations)\n    ? defaultValue\n    : flag.variations[variation]!\n}\n","import { evaluate } from './evaluate'\nimport type { EvaluationContext, EvaluationPayload, JsonValue } from './types'\n\nconst DEFAULT_BASE_URL = 'https://envflags.com'\nconst DEFAULT_POLL_INTERVAL_MS = 30_000\n\ntype Fetch = typeof globalThis.fetch\n\nexport type EnvflagsClientOptions = {\n  baseUrl?: string\n  bootstrap?: EvaluationPayload\n  fetch?: Fetch\n  onError?: (error: Error) => void\n  pollIntervalMs?: number | false\n}\n\ntype PollResponse = {\n  envId: string\n  version: number\n  etag: string\n  payloadUrl: string\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nfunction parsePollResponse(value: unknown): PollResponse {\n  if (\n    !isRecord(value) ||\n    typeof value.envId !== 'string' ||\n    !Number.isSafeInteger(value.version) ||\n    (value.version as number) < 0 ||\n    typeof value.etag !== 'string' ||\n    typeof value.payloadUrl !== 'string'\n  ) {\n    throw new Error('The envflags poll response is invalid')\n  }\n\n  return value as PollResponse\n}\n\nfunction parsePayload(value: unknown): EvaluationPayload {\n  if (\n    !isRecord(value) ||\n    typeof value.envId !== 'string' ||\n    !Number.isSafeInteger(value.version) ||\n    (value.version as number) < 0 ||\n    typeof value.salt !== 'string' ||\n    !isRecord(value.flags) ||\n    !isRecord(value.segments)\n  ) {\n    throw new Error('The envflags payload is invalid')\n  }\n\n  return value as EvaluationPayload\n}\n\nfunction responseError(action: string, response: Response) {\n  return new Error(\n    `Unable to ${action}: envflags returned ${response.status} ${response.statusText}`,\n  )\n}\n\nexport class EnvflagsClient {\n  readonly #baseUrl: URL\n  readonly #fetch: Fetch\n  readonly #onError: (error: Error) => void\n  readonly #pollIntervalMs: number | false\n  readonly #sdkKey: string\n  #context?: EvaluationContext\n  #etag?: string\n  #payload?: EvaluationPayload\n  #revision = 0\n  #refreshPromise?: Promise<boolean>\n  #subscribers = new Set<() => void>()\n  #timer?: ReturnType<typeof setInterval>\n\n  constructor(sdkKey: string, options: EnvflagsClientOptions = {}) {\n    const normalizedSdkKey = sdkKey.trim()\n    if (!normalizedSdkKey) throw new Error('An envflags SDK key is required')\n    if (\n      options.pollIntervalMs !== undefined &&\n      options.pollIntervalMs !== false &&\n      (!Number.isFinite(options.pollIntervalMs) || options.pollIntervalMs < 0)\n    ) {\n      throw new Error('pollIntervalMs must be a non-negative finite number')\n    }\n\n    this.#sdkKey = normalizedSdkKey\n    this.#baseUrl = new URL(options.baseUrl ?? DEFAULT_BASE_URL)\n    this.#fetch = options.fetch ?? globalThis.fetch.bind(globalThis)\n    this.#onError = options.onError ?? (() => undefined)\n    this.#pollIntervalMs =\n      options.pollIntervalMs === undefined\n        ? DEFAULT_POLL_INTERVAL_MS\n        : options.pollIntervalMs\n    if (options.bootstrap) {\n      this.#payload = parsePayload(options.bootstrap)\n      this.#revision = 1\n    }\n  }\n\n  get initialized() {\n    return this.#payload !== undefined\n  }\n\n  get version() {\n    return this.#payload?.version\n  }\n\n  /** Subscribe to payload changes. Intended for UI framework bindings. */\n  subscribe = (listener: () => void) => {\n    this.#subscribers.add(listener)\n    return () => {\n      this.#subscribers.delete(listener)\n    }\n  }\n\n  /** Return a stable value suitable for React's useSyncExternalStore. */\n  getSnapshot = () => this.#revision\n\n  protected reportError(error: Error) {\n    this.#onError(error)\n  }\n\n  async initialize() {\n    try {\n      await this.refresh()\n    } catch (cause) {\n      const error =\n        cause instanceof Error\n          ? cause\n          : new Error('Unable to initialize envflags')\n      this.reportError(error)\n      if (!this.#payload) throw error\n    }\n\n    this.#startPolling()\n    return this\n  }\n\n  refresh() {\n    if (!this.#refreshPromise) {\n      this.#refreshPromise = this.#performRefresh().finally(() => {\n        this.#refreshPromise = undefined\n      })\n    }\n\n    return this.#refreshPromise\n  }\n\n  close() {\n    if (this.#timer !== undefined) clearInterval(this.#timer)\n    this.#timer = undefined\n  }\n\n  setContext(context: EvaluationContext) {\n    this.#context = context\n    return this\n  }\n\n  variation<T extends JsonValue>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n  ): T {\n    if (!this.#payload) return defaultValue\n    return evaluate(\n      this.#payload,\n      flagKey,\n      context ?? this.#context,\n      defaultValue,\n    ) as T\n  }\n\n  boolVariation(\n    flagKey: string,\n    defaultValue: boolean,\n    context?: EvaluationContext,\n  ) {\n    const value = this.variation(flagKey, defaultValue, context)\n    return typeof value === 'boolean' ? value : defaultValue\n  }\n\n  stringVariation(\n    flagKey: string,\n    defaultValue: string,\n    context?: EvaluationContext,\n  ) {\n    const value = this.variation(flagKey, defaultValue, context)\n    return typeof value === 'string' ? value : defaultValue\n  }\n\n  numberVariation(\n    flagKey: string,\n    defaultValue: number,\n    context?: EvaluationContext,\n  ) {\n    const value = this.variation(flagKey, defaultValue, context)\n    return typeof value === 'number' && Number.isFinite(value)\n      ? value\n      : defaultValue\n  }\n\n  jsonVariation<T extends JsonValue>(\n    flagKey: string,\n    defaultValue: T,\n    context?: EvaluationContext,\n  ) {\n    return this.variation(flagKey, defaultValue, context)\n  }\n\n  async #performRefresh() {\n    const headers = new Headers({\n      accept: 'application/json',\n      authorization: `Bearer ${this.#sdkKey}`,\n    })\n    if (this.#etag) headers.set('if-none-match', this.#etag)\n\n    const pollUrl = new URL('/sdk/poll', this.#baseUrl)\n    const pollResponse = await this.#fetch(pollUrl, { headers })\n    if (pollResponse.status === 304) return false\n    if (!pollResponse.ok)\n      throw responseError('poll for flag updates', pollResponse)\n\n    const pointer = parsePollResponse(await pollResponse.json())\n    if (\n      this.#payload?.envId === pointer.envId &&\n      this.#payload.version === pointer.version\n    ) {\n      this.#etag = pointer.etag\n      return false\n    }\n\n    const payloadUrl = new URL(pointer.payloadUrl, this.#baseUrl)\n    const payloadResponse = await this.#fetch(payloadUrl, {\n      headers: {\n        accept: 'application/json',\n        authorization: `Bearer ${this.#sdkKey}`,\n      },\n    })\n    if (!payloadResponse.ok) {\n      throw responseError('fetch the flag payload', payloadResponse)\n    }\n\n    const payload = parsePayload(await payloadResponse.json())\n    if (\n      payload.envId !== pointer.envId ||\n      payload.version !== pointer.version\n    ) {\n      throw new Error('The envflags payload does not match its version pointer')\n    }\n\n    this.#payload = payload\n    this.#etag = pointer.etag\n    this.#revision += 1\n    for (const subscriber of this.#subscribers) subscriber()\n    return true\n  }\n\n  #startPolling() {\n    if (\n      this.#timer !== undefined ||\n      this.#pollIntervalMs === false ||\n      this.#pollIntervalMs <= 0\n    ) {\n      return\n    }\n\n    this.#timer = setInterval(() => {\n      void this.refresh().catch(cause => {\n        this.reportError(\n          cause instanceof Error\n            ? cause\n            : new Error('Unable to refresh envflags'),\n        )\n      })\n    }, this.#pollIntervalMs)\n  }\n}\n\nexport function createClient(\n  sdkKey: string,\n  options: EnvflagsClientOptions = {},\n) {\n  return new EnvflagsClient(sdkKey, options)\n}\n","import { EnvflagsClient, type EnvflagsClientOptions } from './client'\nimport type { EvaluationContext, JsonValue } from './types'\n\n/** The library-neutral Standard Schema v1 validation contract. */\nexport interface StandardSchemaV1<Input = unknown, Output = Input> {\n  readonly '~standard': StandardSchemaProps<Input, Output>\n}\n\nexport interface StandardSchemaProps<Input = unknown, Output = Input> {\n  readonly version: 1\n  readonly vendor: string\n  readonly validate: (\n    value: unknown,\n    options?: StandardSchemaOptions,\n  ) => StandardSchemaResult<Output> | Promise<StandardSchemaResult<Output>>\n  readonly types?: StandardSchemaTypes<Input, Output>\n}\n\nexport interface StandardSchemaOptions {\n  readonly libraryOptions?: Record<string, unknown>\n}\n\nexport interface StandardSchemaTypes<Input = unknown, Output = Input> {\n  readonly input: Input\n  readonly output: Output\n}\n\nexport type StandardSchemaIssue = {\n  readonly message: string\n  readonly path?: ReadonlyArray<PropertyKey | StandardSchemaPathSegment>\n}\n\nexport type StandardSchemaPathSegment = {\n  readonly key: PropertyKey\n}\n\nexport type StandardSchemaResult<Output> =\n  | { readonly value: Output; readonly issues?: undefined }\n  | { readonly issues: ReadonlyArray<StandardSchemaIssue> }\n\nexport type StandardSchemaOutput<Schema extends StandardSchemaV1> = NonNullable<\n  Schema['~standard']['types']\n>['output']\n\nexport type FlagDefinition<Schema extends StandardSchemaV1 = StandardSchemaV1> =\n  {\n    readonly schema: Schema\n    readonly defaultValue: StandardSchemaOutput<Schema>\n  }\n\nexport type FlagDefinitions = Record<string, FlagDefinition>\n\ntype FlagKey<Definitions extends FlagDefinitions> = Extract<\n  keyof Definitions,\n  string\n>\n\nexport type FlagValue<\n  Definitions extends FlagDefinitions,\n  Key extends FlagKey<Definitions>,\n> = StandardSchemaOutput<Definitions[Key]['schema']>\n\ntype ValidationResult =\n  { ok: true; value: JsonValue } | { ok: false; message: string }\n\ntype PreparedDefinition = {\n  schema: StandardSchemaV1<unknown, JsonValue>\n  defaultValue: JsonValue\n}\n\nexport type PreparedFlagDefinitions<Definitions extends FlagDefinitions> = {\n  readonly definitions: Readonly<\n    Record<FlagKey<Definitions>, PreparedDefinition>\n  >\n}\n\n/** Define one flag's runtime schema and offline/invalid-value fallback. */\nexport function flag<Schema extends StandardSchemaV1>(\n  schema: Schema,\n  defaultValue: StandardSchemaOutput<Schema>,\n): FlagDefinition<Schema> {\n  return { schema, defaultValue }\n}\n\nfunction isPromise<T>(value: unknown): value is Promise<T> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'then' in value &&\n    typeof value.then === 'function'\n  )\n}\n\nfunction isJsonValue(\n  value: unknown,\n  ancestors = new Set<object>(),\n): value is JsonValue {\n  if (\n    value === null ||\n    typeof value === 'boolean' ||\n    typeof value === 'string'\n  ) {\n    return true\n  }\n  if (typeof value === 'number') return Number.isFinite(value)\n  if (typeof value !== 'object') return false\n  if (ancestors.has(value)) return false\n\n  const nestedAncestors = new Set(ancestors)\n  nestedAncestors.add(value)\n  if (Array.isArray(value)) {\n    return value.every(item => isJsonValue(item, nestedAncestors))\n  }\n\n  const prototype = Object.getPrototypeOf(value)\n  if (prototype !== Object.prototype && prototype !== null) return false\n  return Object.values(value).every(item => isJsonValue(item, nestedAncestors))\n}\n\nfunction jsonEquals(left: JsonValue, right: JsonValue): boolean {\n  if (left === right) return true\n  if (Array.isArray(left) || Array.isArray(right)) {\n    return (\n      Array.isArray(left) &&\n      Array.isArray(right) &&\n      left.length === right.length &&\n      left.every((value, index) => jsonEquals(value, right[index]!))\n    )\n  }\n  if (left === null || right === null) return false\n  if (typeof left !== 'object' || typeof right !== 'object') return false\n\n  const leftKeys = Object.keys(left)\n  const rightKeys = Object.keys(right)\n  return (\n    leftKeys.length === rightKeys.length &&\n    leftKeys.every(key => key in right && jsonEquals(left[key]!, right[key]!))\n  )\n}\n\nfunction formatIssues(issues: ReadonlyArray<StandardSchemaIssue>) {\n  return issues.map(issue => issue.message).join('; ') || 'validation failed'\n}\n\nfunction validate(\n  flagKey: string,\n  schema: StandardSchemaV1<unknown, JsonValue>,\n  value: unknown,\n): ValidationResult {\n  let result:\n    StandardSchemaResult<JsonValue> | Promise<StandardSchemaResult<JsonValue>>\n  try {\n    result = schema['~standard'].validate(value)\n  } catch (cause) {\n    return {\n      ok: false,\n      message: cause instanceof Error ? cause.message : 'validation threw',\n    }\n  }\n\n  if (isPromise(result)) {\n    return {\n      ok: false,\n      message: `Flag \"${flagKey}\" uses an asynchronous schema; flag schemas must validate synchronously`,\n    }\n  }\n  if (result.issues) {\n    return { ok: false, message: formatIssues(result.issues) }\n  }\n  if (!isJsonValue(result.value)) {\n    return {\n      ok: false,\n      message: `Flag \"${flagKey}\" schema produced a non-JSON value`,\n    }\n  }\n\n  return { ok: true, value: result.value }\n}\n\nexport function prepareFlagDefinitions<Definitions extends FlagDefinitions>(\n  definitions: Definitions,\n): PreparedFlagDefinitions<Definitions> {\n  const prepared: Record<string, PreparedDefinition> = {}\n\n  for (const [flagKey, definition] of Object.entries(definitions)) {\n    const schema = definition.schema as StandardSchemaV1<unknown, JsonValue>\n    if (schema?.['~standard']?.version !== 1) {\n      throw new Error(`Flag \"${flagKey}\" must use a Standard Schema v1 schema`)\n    }\n\n    const result = validate(flagKey, schema, definition.defaultValue)\n    if (!result.ok) {\n      throw new Error(\n        `Invalid default for flag \"${flagKey}\": ${result.message}`,\n      )\n    }\n\n    const repeated = validate(flagKey, schema, result.value)\n    if (!repeated.ok || !jsonEquals(result.value, repeated.value)) {\n      throw new Error(\n        `Invalid default for flag \"${flagKey}\": schema output must remain stable when validated again`,\n      )\n    }\n\n    prepared[flagKey] = { schema, defaultValue: result.value }\n  }\n\n  return {\n    definitions: Object.freeze(prepared) as Record<\n      FlagKey<Definitions>,\n      PreparedDefinition\n    >,\n  }\n}\n\nexport class DefinedEnvflagsClient<\n  Definitions extends FlagDefinitions,\n> extends EnvflagsClient {\n  readonly #prepared: PreparedFlagDefinitions<Definitions>\n  #cacheRevision = -1\n  #validationCache = new Map<string, Map<JsonValue, ValidationResult>>()\n\n  constructor(\n    sdkKey: string,\n    options: EnvflagsClientOptions,\n    prepared: PreparedFlagDefinitions<Definitions>,\n  ) {\n    super(sdkKey, options)\n    this.#prepared = prepared\n  }\n\n  flag<Key extends FlagKey<Definitions>>(\n    flagKey: Key,\n    context?: EvaluationContext,\n  ): FlagValue<Definitions, Key> {\n    const definition = this.#prepared.definitions[flagKey]\n    const candidate = this.variation(flagKey, definition.defaultValue, context)\n\n    if (this.#cacheRevision !== this.getSnapshot()) {\n      this.#cacheRevision = this.getSnapshot()\n      this.#validationCache.clear()\n    }\n\n    let flagCache = this.#validationCache.get(flagKey)\n    if (!flagCache) {\n      flagCache = new Map()\n      this.#validationCache.set(flagKey, flagCache)\n    }\n\n    let result = flagCache.get(candidate)\n    if (!result) {\n      result = validate(flagKey, definition.schema, candidate)\n      flagCache.set(candidate, result)\n      if (!result.ok) {\n        this.reportError(\n          new Error(\n            `Invalid value for flag \"${flagKey}\": ${result.message}; using its default`,\n          ),\n        )\n      }\n    }\n\n    return (result.ok ? result.value : definition.defaultValue) as FlagValue<\n      Definitions,\n      Key\n    >\n  }\n}\n\nexport function createDefinedClient<Definitions extends FlagDefinitions>(\n  prepared: PreparedFlagDefinitions<Definitions>,\n  sdkKey: string,\n  options: EnvflagsClientOptions = {},\n) {\n  return new DefinedEnvflagsClient(sdkKey, options, prepared)\n}\n"],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+export type JsonPrimitive = boolean | null | number | string;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type FlagKind = 'boolean' | 'json' | 'number' | 'string';
+export type EvaluationContext = {
+    key?: string;
+    [attribute: string]: unknown;
+};
+export type ClauseOperator = 'after' | 'before' | 'contains' | 'endsWith' | 'greaterThan' | 'in' | 'lessThan' | 'matches' | 'notIn' | 'segmentMatch' | 'startsWith';
+export type Clause = {
+    attribute: string;
+    op: ClauseOperator;
+    values: JsonValue[];
+};
+export type RolloutEntry = {
+    variation: number;
+    weight: number;
+};
+export type VariationSelector = {
+    variation: number;
+    rollout?: never;
+    bucketBy?: never;
+} | {
+    variation?: never;
+    rollout: RolloutEntry[];
+    bucketBy?: string;
+};
+export type Rule = VariationSelector & {
+    clauses: Clause[];
+};
+export type Target = {
+    variation: number;
+    values: string[];
+};
+export type Flag = {
+    kind: FlagKind;
+    on: boolean;
+    variations: JsonValue[];
+    offVariation: number;
+    fallthrough: VariationSelector;
+    targets: Target[];
+    rules: Rule[];
+    clientSideAvailable: boolean;
+    value?: JsonValue;
+};
+export type Segment = {
+    included?: string[];
+    excluded?: string[];
+    rules?: Array<{
+        clauses: Clause[];
+    }>;
+};
+export type EvaluationPayload = {
+    envId: string;
+    version: number;
+    salt: string;
+    flags: Record<string, Flag>;
+    segments: Record<string, Segment>;
+};

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@envflags/js-sdk",
+  "version": "0.1.0",
+  "description": "JavaScript/TypeScript SDK for envflags",
+  "homepage": "https://envflags.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/envflags/envflags.git",
+    "directory": "sdks/js"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "vite build && tsc -p tsconfig.build.json",
+    "prepublishOnly": "bun run build"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "typescript": "^6.0.0",
+    "vite": "^8.2.1"
+  }
+}