@layers/amba-react-native 3.0.3 → 4.0.1

package/dist/index.cjs

@@ -1,13 +1,39 @@
 
 //#region src/async-storage-adapter.ts
-let cachedStorage = null;
+let cachedStorage = void 0;
+/**
+* Late-imports `@react-native-async-storage/async-storage` and returns
+* it ONLY if the resolved module exposes the three methods we use
+* (`getItem` / `setItem` / `removeItem`). Otherwise returns null and
+* the persistence layer falls back to memory-only.
+*
+* Why the shape check: pnpm with auto-install-peers (default since
+* pnpm 7) installs declared peer deps even in non-RN scratch
+* directories (e.g., this SDK's docs-smoke harness). The installed
+* package's Node entry point doesn't expose AsyncStorage's methods
+* — it's a React Native native module — so the `await import(...)`
+* succeeds (no catch fires) but the returned object has no
+* `getItem`. Calling it throws `TypeError: storage.getItem is not a
+* function` from inside `read()` (verified at PR #246 docs-react-native
+* / docs-expo run on 547a1ff4). Checking method presence here turns
+* that into the same fall-through as "peer dep not installed at all."
+*/
+function isAsyncStorageLike(mod) {
+	return typeof mod === "object" && mod !== null && typeof mod.getItem === "function" && typeof mod.setItem === "function" && typeof mod.removeItem === "function";
+}
 async function getStorage() {
-	if (cachedStorage !== null) return cachedStorage;
+	if (cachedStorage !== void 0) return cachedStorage;
 	try {
 		const mod = await import("@react-native-async-storage/async-storage");
-		cachedStorage = mod.default ?? mod;
+		const candidate = mod.default ?? mod;
+		if (!isAsyncStorageLike(candidate)) {
+			cachedStorage = null;
+			return null;
+		}
+		cachedStorage = candidate;
 		return cachedStorage;
 	} catch {
+		cachedStorage = null;
 		return null;
 	}
 }
@@ -325,7 +351,7 @@ function freshSeed() {
 //#endregion
 //#region src/index.ts
 /** SDK semver — burned in at build time. Bump alongside package.json. */
-const SDK_VERSION = "3.0.0";
+const SDK_VERSION = "4.0.1";
 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.");
@@ -369,6 +395,24 @@ async function postAuth(state_, path, body) {
 	await notifyFromAuthResult(result);
 	return result;
 }
+/**
+* POST helper for endpoints that return `{ data: { user } }` WITHOUT
+* minting new tokens. Used by `linkSmsOtp` / `linkEmailOtp` / `unlink*`
+* — these are "decorate the current user," not "re-authenticate."
+* Existing session tokens stay untouched.
+*/
+async function postUserNoRotate(state_, path, body) {
+	return (await state_.http.post(path, body)).data.user;
+}
+async function unlinkProvider(provider) {
+	const s = getState();
+	const sessionToken = s.identity.getSessionToken();
+	if (!sessionToken) throw new AmbaApiError("UNAUTHORIZED", "no active session — call signIn* first");
+	return postUserNoRotate(s, P.authUnlink, {
+		provider,
+		session_token: sessionToken
+	});
+}
 function requireEmail(email) {
 	const trimmed = email.trim();
 	if (trimmed === "") throw new AmbaApiError("VALIDATION_ERROR", "email must not be empty");
@@ -377,15 +421,36 @@ function requireEmail(email) {
 function requirePassword(password) {
 	if (password.length < 8) throw new AmbaApiError("VALIDATION_ERROR", "password must be at least 8 characters");
 }
+function requireOtpCode(code) {
+	if (code.length !== 6 || !/^[0-9]{6}$/.test(code)) throw new AmbaApiError("VALIDATION_ERROR", "code must be 6 digits");
+}
+const E164_RE = /^\+[1-9][0-9]{6,14}$/;
+function requireE164Phone(phone) {
+	if (!E164_RE.test(phone)) throw new AmbaApiError("VALIDATION_ERROR", "phone must be E.164 (starts with +, 8–15 digits)");
+}
 const P = {
 	authAnonymous: "/v1/client/auth/anonymous",
 	authEmailLogin: "/v1/client/auth/email/login",
 	authEmailSignup: "/v1/client/auth/email/signup",
+	authEmailOtpRequest: "/v1/client/auth/email-otp/request",
+	authSmsOtpRequest: "/v1/client/auth/sms-otp/request",
+	authSmsOtpVerify: "/v1/client/auth/sms-otp/verify",
+	authEmailOtpVerify: "/v1/client/auth/email-otp/verify",
 	authSocial: "/v1/client/auth/social",
+	authMagicLinkRequest: "/v1/client/auth/magic-link/request",
+	authMagicLinkVerify: "/v1/client/auth/magic-link/verify",
+	authLink: "/v1/client/auth/link",
+	authUnlink: "/v1/client/auth/unlink",
+	authIdentifiers: "/v1/client/auth/identifiers",
 	authRefresh: "/v1/client/auth/refresh",
 	authLogout: "/v1/client/auth/logout",
 	authMe: "/v1/client/auth/me",
 	events: "/v1/client/events",
+	users: "/v1/client/users",
+	usersMe: "/v1/client/users/me",
+	sessions: "/v1/client/sessions",
+	sync: "/v1/client/sync",
+	leagues: "/v1/client/leagues",
 	collections: "/v1/client/collections",
 	storage: "/v1/client/media",
 	storagePresign: "/v1/client/media/presign",
@@ -400,6 +465,7 @@ const P = {
 	aiAnthropic: "/v1/client/ai/anthropic/messages",
 	config: "/v1/client/config",
 	flags: "/v1/client/flags",
+	diagnosticsPing: "/v1/client/diagnostics/ping",
 	achievements: "/v1/client/achievements",
 	challenges: "/v1/client/challenges",
 	catalog: "/v1/client/catalog",
@@ -468,14 +534,16 @@ const Amba = {
 	setDebug: (enabled) => {
 		getState().debug = enabled;
 	},
-	events: { track: async (event, properties) => {
+	events: { track: async (event, properties, options) => {
 		const s = getState();
-		await s.http.post(P.events, {
-			name: event,
+		const body = {
+			event,
 			properties: properties ?? void 0,
 			anonymous_id: s.identity.getAnonymousId(),
 			timestamp: (/* @__PURE__ */ new Date()).toISOString()
-		});
+		};
+		if (options?.telemetry) body["telemetry"] = true;
+		await s.http.post(P.events, body);
 	} },
 	auth: {
 		signInAnonymously: async () => {
@@ -498,13 +566,100 @@ const Amba = {
 				password
 			});
 		},
-		signInWithSocial: async (provider, idToken) => {
+		signInWithApple: async (identityToken) => {
+			if (identityToken.trim() === "") throw new AmbaApiError("VALIDATION_ERROR", "identity_token must not be empty");
+			return postAuth(getState(), P.authSocial, {
+				provider: "apple",
+				id_token: identityToken
+			});
+		},
+		signInWithGoogle: async (idToken) => {
 			if (idToken.trim() === "") throw new AmbaApiError("VALIDATION_ERROR", "id_token must not be empty");
 			return postAuth(getState(), P.authSocial, {
-				provider,
+				provider: "google",
 				id_token: idToken
 			});
 		},
+		requestEmailOtp: async (email) => {
+			requireEmail(email);
+			await getState().http.post(P.authEmailOtpRequest, { email });
+		},
+		verifyEmailOtp: async (email, code) => {
+			requireEmail(email);
+			requireOtpCode(code);
+			return postAuth(getState(), P.authEmailOtpVerify, {
+				email,
+				code
+			});
+		},
+		requestSmsOtp: async (phone) => {
+			requireE164Phone(phone);
+			await getState().http.post(P.authSmsOtpRequest, { phone });
+		},
+		verifySmsOtp: async (phone, code) => {
+			requireE164Phone(phone);
+			requireOtpCode(code);
+			return postAuth(getState(), P.authSmsOtpVerify, {
+				phone,
+				code
+			});
+		},
+		requestMagicLink: async (email) => {
+			requireEmail(email);
+			await getState().http.post(P.authMagicLinkRequest, { email });
+		},
+		verifyMagicLink: async (token) => {
+			if (token.trim() === "") throw new AmbaApiError("VALIDATION_ERROR", "token must not be empty");
+			return postAuth(getState(), P.authMagicLinkVerify, { token });
+		},
+		linkAccount: async (provider, credential) => {
+			const providerTrimmed = provider?.trim() ?? "";
+			if (providerTrimmed === "") throw new AmbaApiError("VALIDATION_ERROR", "provider must not be empty");
+			if (typeof credential !== "string" || credential.trim() === "") throw new AmbaApiError("VALIDATION_ERROR", "credential must not be empty");
+			const s = getState();
+			const sessionToken = s.identity.getSessionToken();
+			if (!sessionToken) throw new AmbaApiError("UNAUTHORIZED", "no active session — call signIn* first");
+			return postAuth(s, P.authLink, {
+				provider: providerTrimmed,
+				token: credential,
+				session_token: sessionToken
+			});
+		},
+		linkSmsOtp: async (phone, code) => {
+			requireE164Phone(phone);
+			requireOtpCode(code);
+			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: "sms_otp",
+				phone,
+				code,
+				session_token: sessionToken
+			});
+		},
+		linkEmailOtp: async (email, code) => {
+			requireEmail(email);
+			requireOtpCode(code);
+			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_otp",
+				email,
+				code,
+				session_token: sessionToken
+			});
+		},
+		unlinkSmsOtp: async () => unlinkProvider("sms_otp"),
+		unlinkEmailOtp: async () => unlinkProvider("email_otp"),
+		unlinkApple: async () => unlinkProvider("apple"),
+		unlinkGoogle: async () => unlinkProvider("google"),
+		getCurrentIdentifiers: async () => {
+			const s = getState();
+			if (!s.identity.getSessionToken()) throw new AmbaApiError("UNAUTHORIZED", "no active session — call signIn* first");
+			return (await s.http.get(P.authIdentifiers)).data.identifiers;
+		},
 		signOut: async (rotateAnonymousId = false) => {
 			const s = getState();
 			if (s.identity.getSessionToken()) try {
@@ -541,6 +696,41 @@ const Amba = {
 			};
 		}
 	},
+	users: {
+		get: async (userId) => {
+			const s = getState();
+			if (!s.identity.getSessionToken()) throw new AmbaApiError("UNAUTHORIZED", "no active session — call signIn* first");
+			const path = userId === void 0 || userId === null || userId === "" ? P.usersMe : `${P.users}/${encodePathSegment(userId)}`;
+			return (await s.http.get(path)).data;
+		},
+		update: ((arg1, arg2) => {
+			const s = getState();
+			if (!s.identity.getSessionToken()) throw new AmbaApiError("UNAUTHORIZED", "no active session — call signIn* first");
+			const isById = typeof arg1 === "string";
+			const patch = isById ? arg2 ?? {} : arg1;
+			const path = isById ? `${P.users}/${encodePathSegment(arg1)}` : `${P.users}/me`;
+			return s.http.patch(path, patch).then((env) => env.data);
+		})
+	},
+	sessions: {
+		list: async () => {
+			return (await getState().http.get(P.sessions)).data;
+		},
+		revoke: async (sessionId) => {
+			await getState().http.post(`${P.sessions}/${encodePathSegment(sessionId)}/end`, {});
+		}
+	},
+	sync: {
+		pushChanges: async (changes) => {
+			return (await getState().http.post(P.sync, { changes })).data;
+		},
+		pullChanges: async (since) => {
+			if (!since.entity_type || since.entity_type.trim() === "") throw new AmbaApiError("VALIDATION_ERROR", "pullChanges requires a non-empty entity_type");
+			const query = { entity_type: since.entity_type };
+			if (since.checkpoint_token !== void 0) query["checkpoint_token"] = since.checkpoint_token;
+			return (await getState().http.get(P.sync, query)).data;
+		}
+	},
 	collections: {
 		find: async (name, options = {}) => {
 			return getState().http.post(`${P.collections}/${encodePathSegment(name)}/find`, options);
@@ -548,6 +738,20 @@ const Amba = {
 		findOne: async (name, id) => {
 			return (await getState().http.get(`${P.collections}/${encodePathSegment(name)}/${encodePathSegment(id)}`)).data;
 		},
+		findNearest: async (name, vector, k, where) => {
+			const s = getState();
+			const body = {
+				to_vector: vector,
+				k
+			};
+			if (where !== void 0) body.where = where;
+			return (await s.http.post(`${P.collections}/${encodePathSegment(name)}/find-nearest`, body)).data;
+		},
+		count: async (name, where) => {
+			const s = getState();
+			const query = where !== void 0 ? { query: JSON.stringify({ where }) } : void 0;
+			return (await s.http.get(`${P.collections}/${encodePathSegment(name)}/count`, query)).data.count;
+		},
 		insert: async (name, row) => {
 			return (await getState().http.post(`${P.collections}/${encodePathSegment(name)}`, row)).data;
 		},
@@ -636,6 +840,33 @@ const Amba = {
 				upload_id: uploadId,
 				asset_id: assetId
 			})).data;
+		},
+		list: async (prefix) => {
+			const env = await getState().http.get(P.storage, prefix !== void 0 ? { prefix } : void 0);
+			return {
+				data: env.data ?? [],
+				next_cursor: env.next_cursor ?? null
+			};
+		},
+		delete: async (assetId) => {
+			await getState().http.delete(`${P.storage}/${encodePathSegment(assetId)}`);
+		},
+		download: async (assetId) => {
+			const assetEnv = await getState().http.get(`${P.storage}/${encodePathSegment(assetId)}`);
+			const cdnUrl = assetEnv.data.url ?? assetEnv.data.storage_url ?? "";
+			if (!cdnUrl) throw new AmbaApiError("NOT_FOUND", "asset has no resolvable CDN url");
+			let response;
+			try {
+				response = await (globalThis.fetch ?? fetch)(cdnUrl, { method: "GET" });
+			} catch (err) {
+				throw new AmbaApiError("NETWORK_ERROR", `Network error: ${err instanceof Error ? err.message : String(err)}`, err);
+			}
+			if (!response.ok) {
+				const text = await response.text();
+				const ct = response.headers.get("content-type") ?? "";
+				throw mapHttpError(response, text, ct.includes("application/json"));
+			}
+			return response.blob();
 		}
 	},
 	push: {
@@ -706,8 +937,21 @@ const Amba = {
 			values: parsed.data ?? {}
 		};
 	} },
-	flags: { fetch: async () => {
-		return (await getState().http.get(P.flags)).data;
+	flags: {
+		fetch: async () => {
+			return (await getState().http.get(P.flags)).data;
+		},
+		get: async (key) => {
+			try {
+				return (await getState().http.get(`${P.flags}/${encodePathSegment(key)}`)).data;
+			} catch (err) {
+				if (err instanceof AmbaApiError && err.code === "NOT_FOUND") return null;
+				throw err;
+			}
+		}
+	},
+	diagnostics: { ping: async () => {
+		return await getState().http.post(P.diagnosticsPing, {});
 	} },
 	achievements: {
 		getAll: async () => {
@@ -765,6 +1009,14 @@ const Amba = {
 			return (await getState().http.get(`${P.leaderboards}/${encodePathSegment(key)}/me`)).data;
 		}
 	},
+	leagues: {
+		me: async () => {
+			return (await getState().http.get(`${P.leagues}/me`)).data;
+		},
+		cohort: async () => {
+			return (await getState().http.get(`${P.leagues}/me/cohort`)).data;
+		}
+	},
 	stores: {
 		list: async () => {
 			return (await getState().http.get(P.stores)).data;
@@ -809,6 +1061,15 @@ const Amba = {
 		getFriends: async () => {
 			return (await getState().http.get(P.friends, { state: "accepted" })).data;
 		},
+		sendRequest: async (userId) => {
+			return (await getState().http.post(`${P.friends}/request`, { user_id: userId })).data;
+		},
+		acceptRequest: async (friendshipId) => {
+			return (await getState().http.post(`${P.friends}/${encodePathSegment(friendshipId)}/accept`, {})).data;
+		},
+		declineRequest: async (friendshipId) => {
+			await getState().http.post(`${P.friends}/${encodePathSegment(friendshipId)}/reject`, {});
+		},
 		blockUser: async (userId) => {
 			return (await getState().http.post(`${P.friends}/block`, { user_id: userId })).data;
 		},
@@ -817,6 +1078,9 @@ const Amba = {
 		},
 		removeBlock: async (friendshipId) => {
 			await getState().http.delete(`${P.friends}/${encodePathSegment(friendshipId)}`);
+		},
+		removeFriend: async (userId) => {
+			await getState().http.delete(`${P.friends}/by-user/${encodePathSegment(userId)}`);
 		}
 	},
 	groups: {
@@ -849,10 +1113,7 @@ const Amba = {
 		createConversation: async (request) => {
 			return (await getState().http.post(`${P.messaging}/conversations`, request)).data;
 		},
-		getConversations: async () => {
-			return (await getState().http.get(`${P.messaging}/conversations`)).data;
-		},
-		listConversations: async () => {
+		conversations: async () => {
 			return (await getState().http.get(`${P.messaging}/conversations`)).data;
 		},
 		sendMessage: async (conversationId, request) => {
@@ -866,6 +1127,24 @@ const Amba = {
 		},
 		markRead: async (conversationId) => {
 			return (await getState().http.post(`${P.messaging}/conversations/${encodePathSegment(conversationId)}/read`, {})).data;
+		},
+		getMessage: async (conversationId, messageId) => {
+			const PAGE_SIZE = 100;
+			const MAX_PAGES = 50;
+			const s = getState();
+			const path = `${P.messaging}/conversations/${encodePathSegment(conversationId)}/messages`;
+			let offset = 0;
+			for (let i = 0; i < MAX_PAGES; i++) {
+				const page = (await s.http.get(path, {
+					limit: PAGE_SIZE,
+					offset
+				})).data;
+				const hit = page.find((m) => m.id === messageId);
+				if (hit) return hit;
+				if (page.length < PAGE_SIZE) return null;
+				offset += PAGE_SIZE;
+			}
+			return null;
 		}
 	},
 	moderation: {
@@ -918,20 +1197,25 @@ const Amba = {
 			return (await getState().http.post(P.referrals, body)).data;
 		}
 	},
-	catalog: { list: async () => {
-		return (await getState().http.get(P.catalog)).data;
-	} },
+	catalog: {
+		list: async () => {
+			return (await getState().http.get(P.catalog)).data;
+		},
+		get: async (id) => {
+			return (await getState().http.get(`${P.catalog}/${encodePathSegment(id)}`)).data;
+		}
+	},
 	content: {
-		getToday: async (channel = "default") => {
+		today: async (channel = "default") => {
 			return (await getState().http.get(`${P.content}/today/${encodePathSegment(channel)}`)).data ?? null;
 		},
-		getLibrary: async (channel = "default", options) => {
+		library: async (channel = "default", options) => {
 			return (await getState().http.get(`${P.content}/library/${encodePathSegment(channel)}`, {
 				limit: options?.limit,
 				cursor: options?.cursor
 			})).data;
 		},
-		getItem: async (id) => {
+		item: async (id) => {
 			return (await getState().http.get(`${P.content}/${encodePathSegment(id)}`)).data;
 		},
 		updateItem: async (id, state_) => {