@layers/amba-web 4.0.6 → 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.6";
+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.
@@ -1316,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";
@@ -1633,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,
@@ -2402,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.6";
+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.6",
+  "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.6"
+    "@layers/amba-core": "^4.0.7"
   },
   "devDependencies": {
     "@types/node": "^22.13.14",