@layers/amba-web 4.0.5 → 4.0.7

package/dist-rn/index.d.ts

@@ -38,6 +38,17 @@ interface AmbaConfig {
   debug?: boolean;
   /** Override the localStorage key prefix. Defaults to `"amba"`. */
   storagePrefix?: string;
+  /**
+   * Advanced: explicit URL or RequestInfo for the @layers/amba-core WASM file.
+   * Browser bundlers should not need this; the browser entry supplies a
+   * bundler-safe core runtime automatically.
+   */
+  wasmUrl?: RequestInfo | URL;
+  /**
+   * Advanced: explicit compiled module, response, or bytes for the WASM core.
+   * Mutually exclusive with `wasmUrl`.
+   */
+  wasmModule?: Response | BufferSource | WebAssembly.Module;
 }
 type SocialProvider = "apple" | "google";
 type PushPlatform = "apns" | "fcm" | "web";
@@ -116,7 +127,7 @@ interface OrderBy {
 }
 /**
  * Eager-load related rows from another collection in the same `find` call,
- * avoiding an N+1 round-trip per base row. Single-level (MVP).
+ * avoiding an N+1 round-trip per base row.
  *
  * belongs-to — each base row's `localKey` column points at the related row:
  *   { collection: "novels", localKey: "novel_id", as: "novel", single: true }
@@ -145,6 +156,24 @@ interface IncludeClause {
   single?: boolean;
   /** has-many only: cap related rows per base row (default 100, max 1000). */
   limit?: number;
+  /**
+   * Filtered include — an extra predicate on the related rows, in the
+   * server's where-DSL shape (`{ status: "published" }`,
+   * `{ score: { gte: 10 } }`). The target collection's own read policy +
+   * soft-delete still apply.
+   */
+  where?: Record<string, unknown>;
+  /**
+   * Projection on the included rows — only these columns are returned
+   * (join keys are handled internally).
+   */
+  select?: string[];
+  /**
+   * Nested include — eager-load relations OF the included rows
+   * (e.g. novels → chapters → comments). Max depth 3; max 10 clauses
+   * total per find.
+   */
+  include?: IncludeClause[];
 }
 interface FindOptions {
   filter?: Filter;
@@ -2402,7 +2431,7 @@ declare function getCoreWasm(): AmbaCoreWasm;
  * `verify-sdk-version-coherence` GH action gates every publish on the
  * pair agreeing (and matching the `web-v<X.Y.Z>` tag when tag-triggered).
  */
-declare const SDK_VERSION = "4.0.5";
+declare const SDK_VERSION = "4.0.7";
 //#endregion
 export { Achievement, AchievementProgress, AiContentBlock, AiImageInput, AiMessage, AiMessageRequest, AiMessageResponse, type AiStreamDelta, type AiStreamDone, type AiStreamEvent, type AiStreamOptions, AiUsage, Amba, AmbaApiError, type AmbaApiErrorCode, AmbaConfig, AndFilter, AppSession, AuthResult, CatalogItem, Challenge, ChallengeProgress, CollectionSubscription, ConditionFilter, ConfigBundle, ConsumeRequest, ContentItem, Conversation, ConversationParticipant, ConversationSubscription, ConversationType, CreateConversationRequest, CurrencyBalance, CurrencyTransaction, DeepLink, DeepLinkCreate, DeleteManyResult, DiagnosticsEnvironment, EntitlementPeriodType, EntitlementStore, EventExplainResult, ExplainMatchedRule, FeedItem, FeedResponse, Filter, FilterValue, FindOptions, FindResponse, FlagAssignment, type FlushResult, Friendship, FriendshipState, type GamificationChange, type GamificationKind, GamificationSubscription, Group, GroupCreate, GroupMember, GroupUpdate, IncludeClause, InventoryItem, InvokeOptions, type KvStore, Leaderboard, LeaderboardEntry, LeagueCohort, LeagueCohortMember, LeagueCohortView, LeagueMembership, LeagueTier, LinkedIdentifier, ListMessagesOptions, LocalNotificationHandle, LocalNotificationTrigger, type LocalNotificationsNamespace, MarkReadResult, MediaAsset, MediaCatalog, MediaCatalogItem, MediaListResponse, Message, type MessageChange, MessageType, NearestOptions, NearestResponse, NotFilter, Offering, OfferingPackage, OfferingProduct, OfferingsResult, OnboardingStatus, OrFilter, OrderBy, type OutboxOp, type OutboxOpKind, PingResult, PresignData, PullChangesCursor, PullChangesResult, PurchaseOption, PurchaseRequest, PurchaseResult, PushChangesResult, PushPlatform, PushToken, type RealtimeChange, ReferralClaim, ReferralCode, Report, ReportRequest, RestoreResult, Review, ReviewCreate, ReviewUpdate, Role, type RowChangeOp, SDK_VERSION, ScheduleLocalNotificationInput, ScheduledLocalNotification, SendMessageRequest, Session, SocialProvider, Store, Streak, type SubscribeOptions, SyncChange, SyncConflict, TransactionOp, TransactionOpResult, type Unsubscribe, UpsertOptions, User, UserEntitlement, XpBalance, XpTransaction, getCoreWasm, withOptimistic };
 //# sourceMappingURL=index.d.ts.map

package/dist-rn/index.js

@@ -1,5 +1,3 @@
-import init, { AmbaCoreWasm } from "@layers/amba-core";
-
 //#region src/storage-adapter.ts
 /**
 * Browser localStorage adapter for SDK identity persistence.
@@ -131,14 +129,13 @@ var AmbaApiError = class extends Error {
 	}
 };
 /**
-* Best-effort: pull a stable error code out of a Rust `AmbaError`
-* Display string. Used by `toAmbaApiError` when the underlying thrown
-* value is a generic `Error` produced by `wasm-bindgen`'s `JsError::new`.
+* Best-effort: pull a stable error code out of an `AmbaError` display
+* string. Used by `toAmbaApiError` when the underlying thrown value is a
+* generic `Error` produced by the SDK core.
 *
-* Keep in sync with `sdks/core/src/error.rs::AmbaError`'s `#[error]`
-* format strings — but the parser falls back to UNKNOWN_ERROR for any
-* pattern it doesn't recognize, so a stale match list isn't a footgun,
-* just a quality-of-life regression.
+* Keep in sync with the SDK core's `AmbaError` format strings — but the
+* parser falls back to UNKNOWN_ERROR for any pattern it doesn't recognize,
+* so a stale match list isn't a footgun, just a quality-of-life regression.
 */
 function codeFromMessage(message) {
 	if (message.startsWith("Unauthorized")) return "UNAUTHORIZED";
@@ -181,6 +178,18 @@ function toAmbaApiError(err) {
 //#region src/realtime.ts
 const INITIAL_BACKOFF_MS = 500;
 const MAX_BACKOFF_MS = 15e3;
+const DEFAULT_API_URL$1 = "https://api.amba.dev";
+const DEFAULT_REALTIME_URL = "https://realtime.amba.host";
+/**
+* Resolve the base URL for live-update connections. Long-lived streams are
+* served from a dedicated realtime host (no request-duration ceiling), so
+* when the SDK points at the default production API the stream connects
+* there instead. Any custom `apiUrl` (dev, staging, self-hosted, proxy)
+* keeps live updates on that same origin — override semantics unchanged.
+*/
+function resolveRealtimeBaseUrl(baseUrl) {
+	return baseUrl.replace(/\/+$/, "") === DEFAULT_API_URL$1 ? DEFAULT_REALTIME_URL : baseUrl;
+}
 /**
 * Builder returned by `Amba.collection(name)`. Chain `.where(...)` to
 * narrow, then `.subscribe(cb)` to start streaming.
@@ -204,7 +213,7 @@ var CollectionSubscription = class {
 		if (!this.ctx.authHeaders()) throw new Error("Amba.collection().subscribe() requires an authenticated session — call Amba.auth.signIn*/verify* first.");
 		const qs = Object.keys(this.filters).length > 0 ? `?where=${encodeURIComponent(JSON.stringify(this.filters))}` : "";
 		return openStream({
-			url: `${this.ctx.baseUrl}/v1/client/realtime/collections/${encodeURIComponent(this.name)}${qs}`,
+			url: `${resolveRealtimeBaseUrl(this.ctx.baseUrl)}/v1/client/realtime/collections/${encodeURIComponent(this.name)}${qs}`,
 			authHeaders: this.ctx.authHeaders,
 			onChange: cb,
 			options
@@ -325,7 +334,7 @@ var ConversationSubscription = class {
 	subscribe(cb, options = {}) {
 		if (!this.ctx.authHeaders()) throw new Error("Amba.messaging.conversation().subscribe() requires an authenticated session — call Amba.auth.signIn*/verify* first.");
 		return openStream({
-			url: `${this.ctx.baseUrl}/v1/client/realtime/conversations/${encodeURIComponent(this.conversationId)}`,
+			url: `${resolveRealtimeBaseUrl(this.ctx.baseUrl)}/v1/client/realtime/conversations/${encodeURIComponent(this.conversationId)}`,
 			authHeaders: this.ctx.authHeaders,
 			onChange: cb,
 			options
@@ -354,7 +363,7 @@ var GamificationSubscription = class {
 	subscribe(cb, options = {}) {
 		if (!this.ctx.authHeaders()) throw new Error("Amba.gamification.subscribe() requires an authenticated session — call Amba.auth.signIn*/verify* first.");
 		return openGamificationStream({
-			url: `${this.ctx.baseUrl}/v1/client/realtime/gamification`,
+			url: `${resolveRealtimeBaseUrl(this.ctx.baseUrl)}/v1/client/realtime/gamification`,
 			authHeaders: this.ctx.authHeaders,
 			onChange: cb,
 			options
@@ -1305,6 +1314,26 @@ const notifications = {
 	}
 };
 
+//#endregion
+//#region src/wasm-loader.ts
+let coreInit;
+let coreWasmClass;
+function setCoreRuntime(init, wasmClass) {
+	coreInit = init;
+	coreWasmClass = wasmClass;
+}
+async function getCoreRuntime() {
+	if (coreInit === void 0 || coreWasmClass === void 0) {
+		const core = await import("@layers/amba-core");
+		setCoreRuntime(core.default, core.AmbaCoreWasm);
+	}
+	if (coreInit === void 0 || coreWasmClass === void 0) throw new Error("Amba.configure: core WASM runtime failed to load");
+	return {
+		initCore: coreInit,
+		wasmClass: coreWasmClass
+	};
+}
+
 //#endregion
 //#region src/index.ts
 const DEFAULT_API_URL = "https://api.amba.dev";
@@ -1622,12 +1651,19 @@ const Amba = {
 	configure: async (config) => {
 		if (!config.projectId || config.projectId.trim() === "") throw new Error("Amba.configure: projectId is required");
 		if (!config.clientKey || config.clientKey.trim() === "") throw new Error("Amba.configure: clientKey is required");
-		await init(); // Hermes-stripped Node-init block (DX-15) — see scripts/build-rn.mjs
+		if (config.wasmUrl !== void 0 && config.wasmModule !== void 0) throw new Error("Amba.configure: pass only one of wasmUrl or wasmModule");
+		else {
+			const { initCore } = await getCoreRuntime();
+			const explicitWasmInput = config.wasmModule ?? config.wasmUrl;
+			if (explicitWasmInput !== void 0) await initCore({ module_or_path: explicitWasmInput });
+			else await initCore(); // Hermes-stripped Node-init block (DX-15) — see scripts/build-rn.mjs
+		}
 		const persistence = new LocalStoragePersistence(config.storagePrefix ?? "amba");
 		persistence.hydrate();
 		let nextCore;
 		try {
-			nextCore = AmbaCoreWasm.init(encodeJson({
+			const { wasmClass } = await getCoreRuntime();
+			nextCore = wasmClass.init(encodeJson({
 				api_key: config.clientKey,
 				base_url: config.apiUrl,
 				project_id: config.projectId,
@@ -2391,7 +2427,7 @@ function getCoreWasm() {
 * `verify-sdk-version-coherence` GH action gates every publish on the
 * pair agreeing (and matching the `web-v<X.Y.Z>` tag when tag-triggered).
 */
-const SDK_VERSION = "4.0.5";
+const SDK_VERSION = "4.0.7";
 
 //#endregion
 export { Amba, AmbaApiError, CollectionSubscription, ConversationSubscription, GamificationSubscription, SDK_VERSION, getCoreWasm, withOptimistic };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@layers/amba-web",
-  "version": "4.0.5",
+  "version": "4.0.7",
   "description": "amba SDK for browser apps — full SDK 4.0 surface (34 modules: auth + magic link, users, sessions, sync, collections + vector search, storage + list/delete/download, push, entitlements, flags, config, deep links, onboarding, content, messaging, friends, groups, feeds, reviews, moderation, roles, referrals, achievements, xp, streaks, challenges, leaderboards, leagues, currencies, inventory, stores, catalog, ai, diagnostics).",
   "type": "module",
   "main": "./dist/index.js",
@@ -10,7 +10,7 @@
     ".": {
       "types": "./dist/index.d.ts",
       "react-native": "./dist-rn/index.js",
-      "browser": "./dist/index.js",
+      "browser": "./dist/index.browser.js",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     }
@@ -32,7 +32,7 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@layers/amba-core": "^4.0.5"
+    "@layers/amba-core": "^4.0.7"
   },
   "devDependencies": {
     "@types/node": "^22.13.14",