@layers/amba-react-native 4.0.14 → 4.1.0

package/dist/index.cjs

@@ -95,6 +95,9 @@ var AmbaHttpClient = class {
 	baseUrl;
 	sdkPlatform;
 	sdkVersionHeader;
+	appVersion;
+	deviceRegion;
+	deviceOs;
 	identity;
 	fetchImpl;
 	ensureSession;
@@ -104,6 +107,9 @@ var AmbaHttpClient = class {
 		this.baseUrl = opts.baseUrl.replace(/\/+$/, "");
 		this.sdkPlatform = opts.sdkPlatform;
 		this.sdkVersionHeader = opts.sdkVersionHeader;
+		this.appVersion = opts.appVersion;
+		this.deviceRegion = opts.deviceRegion;
+		this.deviceOs = opts.deviceOs;
 		this.identity = opts.identity;
 		this.ensureSession = opts.ensureSession;
 		this.onSessionRefused = opts.onSessionRefused;
@@ -132,6 +138,9 @@ var AmbaHttpClient = class {
 			Accept: "application/json",
 			...extra
 		};
+		if (this.appVersion) h["X-App-Version"] = this.appVersion;
+		if (this.deviceRegion) h["X-Device-Region"] = this.deviceRegion;
+		if (this.deviceOs) h["X-Device-OS"] = this.deviceOs;
 		const tok = this.identity.getSessionToken();
 		if (tok) h.Authorization = `Bearer ${tok}`;
 		return h;
@@ -1757,6 +1766,117 @@ const notifications = {
 	}
 };
 
+//#endregion
+//#region src/experiment-reporter.ts
+/** Keys remembered before the oldest are forgotten (bounds memory). */
+const DEFAULT_MAX_REPORTED = 1e4;
+var ExperimentAssignmentReporter = class {
+	listeners = /* @__PURE__ */ new Set();
+	reported = /* @__PURE__ */ new Set();
+	constructor(maxReported = DEFAULT_MAX_REPORTED) {
+		this.maxReported = maxReported;
+	}
+	/** Add a listener. Returns a function that removes it. */
+	subscribe(listener) {
+		if (typeof listener !== "function") throw new TypeError("onExperimentAssigned expects a function");
+		this.listeners.add(listener);
+		return () => {
+			this.listeners.delete(listener);
+		};
+	}
+	/**
+	* Call the listeners for `assignment` when this user has not reported this
+	* experiment yet in the session. Returns `assignment` unchanged.
+	*/
+	report(assignment) {
+		if (this.listeners.size === 0) return assignment;
+		const id = `${assignment.bucketingId}\u0000${assignment.experimentKey}`;
+		if (this.reported.has(id)) {
+			this.reported.delete(id);
+			this.reported.add(id);
+			return assignment;
+		}
+		this.reported.add(id);
+		if (this.reported.size > this.maxReported) {
+			const oldest = this.reported.values().next().value;
+			if (oldest !== void 0) this.reported.delete(oldest);
+		}
+		for (const listener of Array.from(this.listeners)) try {
+			const result = listener({ ...assignment });
+			if (result && typeof result.then === "function") result.then(void 0, logListenerError);
+		} catch (err) {
+			logListenerError(err);
+		}
+		return assignment;
+	}
+	/** Start a new session: every experiment reports again. */
+	reset() {
+		this.reported.clear();
+	}
+};
+function logListenerError(err) {
+	console.warn("[amba] onExperimentAssigned listener threw", err);
+}
+
+//#endregion
+//#region src/client-info.ts
+/**
+* Values for the `X-App-Version`, `X-Device-Region` and `X-Device-OS`
+* request headers. Each is omitted when unknown, so every helper here
+* returns `undefined` for a value the header can't carry as-is.
+*/
+/** Longest `X-App-Version` value sent (matches the core's limit). */
+const MAX_APP_VERSION_LENGTH = 64;
+/**
+* An app version for `X-App-Version`: the text before the first whitespace
+* (`"2.3.1 (45)"` sends `2.3.1`), which must start with an ASCII letter or
+* digit, hold only letters, digits and `.` `_` `+` `-`, and be at most
+* {@link MAX_APP_VERSION_LENGTH} characters: the shape the API records for
+* segment targeting. Anything else returns `undefined`.
+*/
+function normalizeAppVersion(raw) {
+	if (typeof raw !== "string") return void 0;
+	const v = raw.trim().split(/\s+/)[0] ?? "";
+	if (v.length === 0 || v.length > MAX_APP_VERSION_LENGTH) return void 0;
+	return /^[0-9A-Za-z][0-9A-Za-z._+-]*$/.test(v) ? v : void 0;
+}
+/**
+* The region subtag of a BCP 47 locale tag (`en-US` → `US`, `zh-Hant-TW` →
+* `TW`, POSIX `fr_FR.UTF-8` → `FR`, iOS `en_US@rg=gbzzzz` → `US`),
+* uppercased. Returns `undefined` when the tag carries no two-letter region
+* (`en`, `es-419`, `sr-Latn`).
+*/
+function regionFromLocale(tag) {
+	if (typeof tag !== "string" || tag.length === 0) return void 0;
+	const parts = tag.split(/[.@]/)[0].split(/[-_]/);
+	for (let i = 1; i < parts.length; i++) {
+		const part = parts[i];
+		if (part.length === 1) break;
+		if (/^[A-Za-z]{2}$/.test(part)) return part.toUpperCase();
+	}
+}
+const DEVICE_OS_VALUES = [
+	"ios",
+	"android",
+	"web",
+	"macos",
+	"windows",
+	"linux",
+	"other"
+];
+/**
+* Map a platform OS name (React Native's `Platform.OS`, for example) to an
+* `X-Device-OS` value. Listed names pass through lowercased; any other
+* non-empty name is a known-but-unlisted OS and maps to `"other"`. Empty or
+* missing returns `undefined`.
+*/
+function deviceOsFromPlatform(os) {
+	if (typeof os !== "string") return void 0;
+	const v = os.trim().toLowerCase();
+	if (v.length === 0) return void 0;
+	return DEVICE_OS_VALUES.includes(v) ? v : "other";
+}
+
 //#endregion
 //#region src/realtime.ts
 const INITIAL_BACKOFF_MS = 500;
@@ -2080,7 +2200,7 @@ function delay(ms) {
 //#endregion
 //#region src/index.ts
 /** SDK semver — burned in at build time. Bump alongside package.json. */
-const SDK_VERSION = "4.0.14";
+const SDK_VERSION = "4.1.0";
 /**
 * Default host that serves deployed functions. `Amba.functions.invoke(name)`
 * targets `https://<projectId>.<DEFAULT_FUNCTIONS_HOST>/<name>` unless a
@@ -2117,6 +2237,13 @@ function realtimeAuthHeaders() {
 	};
 }
 const authSubscribers = /* @__PURE__ */ new Set();
+/**
+* `Amba.onExperimentAssigned` listeners. `experiments.getVariant` reports
+* each result here; the reporter calls the listeners once per experiment per
+* user session. A sign-out (any auth change to no session) and `configure`
+* start a new session.
+*/
+const experimentReporter = new ExperimentAssignmentReporter();
 function snapshotSession(user) {
 	if (!user) return null;
 	return {
@@ -2127,6 +2254,7 @@ function snapshotSession(user) {
 	};
 }
 function notifyAuthSubscribers(session) {
+	if (session === null) experimentReporter.reset();
 	for (const cb of authSubscribers) try {
 		cb(session);
 	} catch (err) {
@@ -2543,6 +2671,7 @@ const P = {
 	aiAnthropic: "/v1/client/ai/anthropic/messages",
 	config: "/v1/client/config",
 	flags: "/v1/client/flags",
+	experiments: "/v1/client/experiments",
 	diagnosticsPing: "/v1/client/diagnostics/ping",
 	achievements: "/v1/client/achievements",
 	challenges: "/v1/client/challenges",
@@ -2686,6 +2815,39 @@ async function deleteDirect(s, name, id) {
 	return await s.http.delete(`${P.collections}/${encodePathSegment(name)}/${encodePathSegment(id)}`) ?? { data: { deleted: true } };
 }
 /**
+* The device OS for `X-Device-OS` from React Native's `Platform.OS`
+* (`ios`, `android`, `web` for react-native-web, `macos`, `windows`).
+* `undefined` outside React Native (Node, tests).
+*/
+function detectDeviceOs() {
+	try {
+		const os = require("react-native").Platform?.OS;
+		return deviceOsFromPlatform(typeof os === "string" ? os : void 0);
+	} catch {
+		return;
+	}
+}
+/**
+* The device locale's region for `X-Device-Region`: the iOS region setting
+* (`AppleLocale`) or Android's locale, falling back to the JS runtime's
+* default locale. `undefined` when none carries a two-letter region.
+*/
+function detectDeviceRegion() {
+	try {
+		const rn = require("react-native");
+		const ios = (rn.NativeModules?.["SettingsManager"])?.settings;
+		const android = rn.NativeModules?.["I18nManager"];
+		const tag = ios?.AppleLocale ?? android?.localeIdentifier;
+		const region = regionFromLocale(typeof tag === "string" ? tag : void 0);
+		if (region) return region;
+	} catch {}
+	try {
+		return regionFromLocale(Intl.DateTimeFormat().resolvedOptions().locale);
+	} catch {
+		return;
+	}
+}
+/**
 * Top-level SDK namespace for React Native.
 */
 const Amba = {
@@ -2717,6 +2879,9 @@ const Amba = {
 			baseUrl,
 			sdkPlatform: "react-native",
 			sdkVersionHeader,
+			appVersion: normalizeAppVersion(config.appVersion),
+			deviceRegion: detectDeviceRegion(),
+			deviceOs: detectDeviceOs(),
 			identity,
 			ensureSession: config.autoAnonymousSession === false ? void 0 : async (path) => {
 				if (pathSkipsLazySession(path)) return;
@@ -2729,6 +2894,7 @@ const Amba = {
 		if (prior?.offlineQueue) await prior.offlineQueue.dispose();
 		prior?.detachEventAppState?.();
 		if (prior?.eventQueue) await prior.eventQueue.dispose();
+		experimentReporter.reset();
 		const nextState = {
 			http,
 			identity,
@@ -3420,6 +3586,22 @@ const Amba = {
 			}
 		}
 	},
+	experiments: {
+		getVariant: async (key) => {
+			const s = getState();
+			const userBefore = s.identity.getAppUserId();
+			const env = await s.http.get(`${P.experiments}/${encodePathSegment(key)}/assignment`);
+			return experimentReporter.report({
+				experimentKey: env.data.experiment_key,
+				variant: env.data.variant,
+				bucketingId: userBefore ?? s.identity.getAppUserId() ?? ""
+			});
+		},
+		trackExposure: async (key) => {
+			await getState().http.post(`${P.experiments}/${encodePathSegment(key)}/exposure`, {});
+		}
+	},
+	onExperimentAssigned: (listener) => experimentReporter.subscribe(listener),
 	diagnostics: { ping: async () => {
 		return await getState().http.post(P.diagnosticsPing, {});
 	} },