@layers/amba-react-native 4.0.2 → 4.0.3

package/dist/index.cjs

@@ -91,12 +91,14 @@ var AmbaHttpClient = class {
 	sdkVersionHeader;
 	identity;
 	fetchImpl;
+	ensureSession;
 	constructor(opts) {
 		this.apiKey = opts.apiKey;
 		this.baseUrl = opts.baseUrl.replace(/\/+$/, "");
 		this.sdkPlatform = opts.sdkPlatform;
 		this.sdkVersionHeader = opts.sdkVersionHeader;
 		this.identity = opts.identity;
+		this.ensureSession = opts.ensureSession;
 		this.fetchImpl = opts.fetchImpl ?? globalThis.fetch.bind(globalThis);
 	}
 	/** Build the absolute URL for an API path, optionally with a query string. */
@@ -139,6 +141,7 @@ var AmbaHttpClient = class {
 		return this.request("DELETE", path);
 	}
 	async request(method, path, body, query) {
+		if (this.ensureSession && !this.identity.getSessionToken()) await this.ensureSession(path);
 		const url = this.url(path, query);
 		const init = {
 			method,
@@ -351,7 +354,13 @@ function freshSeed() {
 //#endregion
 //#region src/index.ts
 /** SDK semver — burned in at build time. Bump alongside package.json. */
-const SDK_VERSION = "4.0.2";
+const SDK_VERSION = "4.0.3";
+/**
+* Default host that serves deployed functions. `Amba.functions.invoke(name)`
+* targets `https://<projectId>.<DEFAULT_FUNCTIONS_HOST>/<name>` unless a
+* `functionsBaseUrl` override is configured.
+*/
+const DEFAULT_FUNCTIONS_HOST = "fn.amba.host";
 let state = null;
 function getState() {
 	if (!state) throw new AmbaApiError("NOT_INITIALIZED", "@layers/amba-react-native: SDK not configured. Call Amba.configure({ projectId, clientKey }) at app start.");
@@ -395,6 +404,26 @@ async function postAuth(state_, path, body) {
 	await notifyFromAuthResult(result);
 	return result;
 }
+/** Paths that must NOT trigger lazy anonymous sign-in. */
+function pathSkipsLazySession(path) {
+	if (path.startsWith("/v1/client/auth/")) return true;
+	if (path === P.events || path.startsWith(`${P.events}/`)) return true;
+	if (path === P.diagnosticsPing) return true;
+	if (path === P.config || path.startsWith(`${P.config}/`)) return true;
+	if (path === P.flags || path.startsWith(`${P.flags}/`)) return true;
+	return false;
+}
+async function ensureAnonymousSession(state_) {
+	if (state_.identity.getSessionToken()) return;
+	if (!state_.anonSignInInflight) state_.anonSignInInflight = (async () => {
+		try {
+			await postAuth(state_, P.authAnonymous, { anonymous_id: state_.identity.getAnonymousId() });
+		} finally {
+			state_.anonSignInInflight = null;
+		}
+	})();
+	await state_.anonSignInInflight;
+}
 /**
 * POST helper for endpoints that return `{ data: { user } }` WITHOUT
 * minting new tokens. Used by `linkSmsOtp` / `linkEmailOtp` / `unlink*`
@@ -491,6 +520,22 @@ function encodePathSegment(s) {
 	return encodeURIComponent(s);
 }
 /**
+* Resolve the full invocation URL for a deployed function. With
+* `functionsBaseUrl` configured we POST to `<base>/<name>` verbatim;
+* otherwise we resolve the server-side project id once (via
+* `diagnostics.ping`, cached) and target
+* `https://<projectId>.fn.amba.host/<name>`.
+*/
+async function resolveFunctionUrl(s, name) {
+	if (s.functionsBaseUrl) return `${s.functionsBaseUrl.replace(/\/$/, "")}/${encodeURIComponent(name)}`;
+	if (!s.resolvedFunctionsProjectId) {
+		const ping = await Amba.diagnostics.ping();
+		if (!ping.ok || !ping.server_project_id) throw new AmbaApiError("FUNCTIONS_HOST_UNRESOLVED", "Could not resolve the functions host for this project. Pass `functionsBaseUrl` to Amba.configure() to invoke functions explicitly.", ping);
+		s.resolvedFunctionsProjectId = ping.server_project_id;
+	}
+	return `https://${s.resolvedFunctionsProjectId}.${DEFAULT_FUNCTIONS_HOST}/${encodeURIComponent(name)}`;
+}
+/**
 * Top-level SDK namespace for React Native.
 */
 const Amba = {
@@ -508,11 +553,17 @@ const Amba = {
 				baseUrl,
 				sdkPlatform: "react-native",
 				sdkVersionHeader,
-				identity
+				identity,
+				ensureSession: config.autoAnonymousSession === false ? void 0 : async (path) => {
+					if (pathSkipsLazySession(path)) return;
+					await ensureAnonymousSession(getState());
+				}
 			}),
 			identity,
 			debug: config.debug ?? false,
-			projectId: config.projectId
+			projectId: config.projectId,
+			functionsBaseUrl: config.functionsBaseUrl ?? null,
+			resolvedFunctionsProjectId: null
 		};
 	},
 	_reset: () => {
@@ -651,6 +702,19 @@ const Amba = {
 				session_token: sessionToken
 			});
 		},
+		linkEmailPassword: async (email, password) => {
+			requireEmail(email);
+			requirePassword(password);
+			const s = getState();
+			const sessionToken = s.identity.getSessionToken();
+			if (!sessionToken) throw new AmbaApiError("UNAUTHORIZED", "no active session — call signIn* first");
+			return postUserNoRotate(s, P.authLink, {
+				provider: "email_password",
+				email,
+				password,
+				session_token: sessionToken
+			});
+		},
 		unlinkSmsOtp: async () => unlinkProvider("sms_otp"),
 		unlinkEmailOtp: async () => unlinkProvider("email_otp"),
 		unlinkApple: async () => unlinkProvider("apple"),
@@ -899,8 +963,41 @@ const Amba = {
 		}
 	},
 	ai: { anthropic: { messages: { create: async (request) => {
-		return (await getState().http.post(P.aiAnthropic, request)).data;
+		const env = await getState().http.post(P.aiAnthropic, request);
+		if (!env || typeof env !== "object" || env.data === void 0) throw new AmbaApiError("MALFORMED_RESPONSE", "AI response was not wrapped in the expected { data } envelope", env);
+		return env.data;
 	} } } },
+	functions: { invoke: async (name, body, options) => {
+		const s = getState();
+		if (!name || name.trim() === "") throw new AmbaApiError("INVALID_ARGUMENT", "Amba.functions.invoke: a function name is required.");
+		const url = await resolveFunctionUrl(s, name);
+		const method = options?.method ?? "POST";
+		const headers = s.http.buildHeaders(options?.headers);
+		let requestBody;
+		if (body !== void 0 && method !== "GET") requestBody = JSON.stringify(body);
+		else delete headers["Content-Type"];
+		let response;
+		try {
+			response = await (globalThis.fetch ?? fetch)(url, {
+				method,
+				headers,
+				body: requestBody
+			});
+		} catch (err) {
+			throw new AmbaApiError("NETWORK_ERROR", `Amba.functions.invoke("${name}") network error: ${err instanceof Error ? err.message : String(err)}`, err);
+		}
+		const text = await response.text();
+		if (!response.ok) {
+			const ct = response.headers.get("content-type") ?? "";
+			throw mapHttpError(response, text, ct.includes("application/json"));
+		}
+		if (!text) return void 0;
+		try {
+			return JSON.parse(text);
+		} catch {
+			return text;
+		}
+	} },
 	config: { fetch: async () => {
 		const s = getState();
 		const url = s.http.url(P.config);
@@ -1210,19 +1307,19 @@ const Amba = {
 			return (await getState().http.get(`${P.content}/today/${encodePathSegment(channel)}`)).data ?? null;
 		},
 		library: async (channel = "default", options) => {
-			return (await getState().http.get(`${P.content}/library/${encodePathSegment(channel)}`, {
+			return (await getState().http.get(`${P.content}/libraries/${encodePathSegment(channel)}`, {
 				limit: options?.limit,
 				cursor: options?.cursor
 			})).data;
 		},
 		item: async (id) => {
-			return (await getState().http.get(`${P.content}/${encodePathSegment(id)}`)).data;
+			return (await getState().http.get(`${P.content}/items/${encodePathSegment(id)}`)).data;
 		},
 		updateItem: async (id, state_) => {
-			return (await getState().http.post(`${P.content}/${encodePathSegment(id)}/state`, state_)).data;
+			return (await getState().http.patch(`${P.content}/items/${encodePathSegment(id)}`, state_)).data;
 		},
 		createItem: async (channel, item) => {
-			return (await getState().http.post(`${P.content}/${encodePathSegment(channel)}`, item)).data;
+			return (await getState().http.post(`${P.content}/libraries/${encodePathSegment(channel)}/items`, item)).data;
 		}
 	},
 	deepLinks: {