@layers/amba-core-wasm 1.0.0

package/README.md

@@ -0,0 +1,44 @@
+# @layers/amba-core-wasm
+
+The amba SDK's Rust core compiled to WebAssembly. Internal package — applications consume one of the friendlier wrappers:
+
+| If you're targeting…             | Use                         |
+| -------------------------------- | --------------------------- |
+| Browser                          | `@layers/amba-web`          |
+| Node.js                          | `@layers/amba-node`         |
+| React Native (Expo Go + bare RN) | `@layers/amba-react-native` |
+| Expo with config plugin          | `@layers/amba-expo`         |
+| Any other JS runtime             | this package, directly      |
+
+## Direct usage
+
+```ts
+import init, { AmbaCoreWasm } from "@layers/amba-core-wasm";
+
+await init(); // load the .wasm binary
+
+const core = AmbaCoreWasm.init(
+  JSON.stringify({
+    api_key: "amba_pk_…",
+    sdk_platform: "web",
+    sdk_wrapper_version: "custom/1.0.0",
+  }),
+  window.fetch.bind(window),
+);
+
+await core.track("app_opened", JSON.stringify({ source: "deep_link" }));
+const user = await core.signInAnonymously();
+console.log(user);
+```
+
+## Source
+
+The Rust source lives at `core/` in this monorepo. To rebuild after Rust changes:
+
+```bash
+pnpm --filter @layers/amba-core-wasm run build
+```
+
+## License
+
+MIT.

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@layers/amba-core-wasm",
+  "version": "1.0.0",
+  "description": "amba SDK Rust core compiled to WASM. Consumed by @layers/amba-web, @layers/amba-node, @layers/amba-react-native.",
+  "type": "module",
+  "main": "./pkg/amba_core.js",
+  "types": "./pkg/amba_core.d.ts",
+  "exports": {
+    ".": {
+      "types": "./pkg/amba_core.d.ts",
+      "import": "./pkg/amba_core.js"
+    },
+    "./wasm": "./pkg/amba_core_bg.wasm"
+  },
+  "files": [
+    "pkg/amba_core.js",
+    "pkg/amba_core_bg.wasm",
+    "pkg/amba_core.d.ts",
+    "pkg/amba_core_bg.wasm.d.ts",
+    "README.md"
+  ],
+  "sideEffects": [
+    "./pkg/snippets/*"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/layers/amba-sdks.git",
+    "directory": "packages/core-wasm"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "cd ../../core && wasm-pack build --target web --out-name amba_core --out-dir ../packages/core-wasm/pkg",
+    "build:bundler": "cd ../../core && wasm-pack build --target bundler --out-name amba_core --out-dir ../packages/core-wasm/pkg-bundler",
+    "build:nodejs": "cd ../../core && wasm-pack build --target nodejs --out-name amba_core --out-dir ../packages/core-wasm/pkg-node"
+  }
+}

package/pkg/amba_core.d.ts

@@ -0,0 +1,262 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/**
+ * JS-callable opaque handle to [`AmbaCore`].
+ *
+ * The JS side instantiates it via `AmbaCoreWasm.init(configJson, fetchFn)`
+ * and stashes it for the lifetime of the page.
+ */
+export class AmbaCoreWasm {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    achievementsGetAll(): Promise<any>;
+    achievementsGetProgress(): Promise<any>;
+    aiAnthropicMessages(request_json: string): Promise<any>;
+    anonymousId(): string;
+    appUserId(): string | undefined;
+    catalogList(): Promise<any>;
+    challengesClaim(id: string): Promise<any>;
+    challengesGet(id: string): Promise<any>;
+    challengesGetActive(): Promise<any>;
+    challengesGetProgress(id: string): Promise<any>;
+    collectionsDelete(collection: string, id: string): Promise<any>;
+    collectionsFind(collection: string, options_json: string): Promise<any>;
+    collectionsFindOne(collection: string, id: string): Promise<any>;
+    collectionsInsert(collection: string, row_json: string): Promise<any>;
+    collectionsUpdate(collection: string, id: string, set_json: string): Promise<any>;
+    configFetch(): Promise<any>;
+    contentCreateItem(channel: string, item_json: string): Promise<any>;
+    contentGetItem(id: string): Promise<any>;
+    /**
+     * `channel` is optional; `limit` caps results per page; `cursor` is
+     * the server-issued opaque pagination token. Mirror the TS wrapper
+     * signature: getLibrary(channel?, { limit?, cursor? }).
+     */
+    contentGetLibrary(channel?: string | null, limit?: number | null, cursor?: string | null): Promise<any>;
+    /**
+     * `channel` is optional; when omitted, FFI defaults to `"default"` so
+     * single-channel apps can call `Amba.content.getToday()` without args.
+     */
+    contentGetToday(channel?: string | null): Promise<any>;
+    contentUpdateItem(id: string, state_json: string): Promise<any>;
+    currenciesGetBalance(): Promise<any>;
+    currenciesGetTransactions(currency_key: string): Promise<any>;
+    deepLinksCreate(params_json: string): Promise<any>;
+    deepLinksGet(short_code: string): Promise<any>;
+    entitlementsHas(name: string): Promise<any>;
+    entitlementsList(): Promise<any>;
+    feedsGetActivity(feed?: string | null, cursor?: string | null): Promise<any>;
+    flagsFetch(): Promise<any>;
+    friendsBlockUser(user_id: string): Promise<any>;
+    friendsGetFriends(): Promise<any>;
+    friendsGetList(): Promise<any>;
+    friendsRemoveBlock(friendship_id: string): Promise<any>;
+    friendsUnblockUser(user_id: string): Promise<any>;
+    groupsCreate(params_json: string): Promise<any>;
+    groupsDelete(id: string): Promise<any>;
+    groupsGet(id: string): Promise<any>;
+    groupsGetMembers(id: string): Promise<any>;
+    groupsInvite(id: string, user_id: string): Promise<any>;
+    groupsJoin(id: string): Promise<any>;
+    groupsLeave(id: string): Promise<any>;
+    groupsUpdate(id: string, patch_json: string): Promise<any>;
+    /**
+     * Initialize the SDK.
+     *
+     * `config_json`: JSON-stringified `AmbaConfig` (api_key, base_url,
+     * sdk_platform, sdk_wrapper_version, consent_required, debug).
+     *
+     * `fetch_fn`: a JS function `(url, init) => Promise<Response>`
+     * matching the global `fetch` signature. The wrapper passes
+     * `window.fetch.bind(window)` or a server-side polyfill.
+     */
+    static init(config_json: string, fetch_fn: Function): AmbaCoreWasm;
+    inventoryConsume(request_json: string): Promise<any>;
+    inventoryGetItem(id: string): Promise<any>;
+    inventoryGetItems(): Promise<any>;
+    inventoryPurchase(request_json: string): Promise<any>;
+    isAuthenticated(): boolean;
+    leaderboardsGet(key: string): Promise<any>;
+    leaderboardsGetEntries(key: string, limit?: number | null): Promise<any>;
+    leaderboardsGetMyRank(key: string): Promise<any>;
+    me(): Promise<any>;
+    messagingGetConversations(): Promise<any>;
+    messagingGetMessage(id: string): Promise<any>;
+    messagingSendMessage(request_json: string): Promise<any>;
+    moderationGetReportStatus(id: string): Promise<any>;
+    moderationReportContent(request_json: string): Promise<any>;
+    moderationReportUser(request_json: string): Promise<any>;
+    onboardingComplete(): Promise<any>;
+    onboardingGetStatus(): Promise<any>;
+    onboardingNextStep(payload_json: string): Promise<any>;
+    onboardingSkipStep(): Promise<any>;
+    pushGetTokens(): Promise<any>;
+    pushRegister(token: string, platform: string, bundle_id?: string | null): Promise<any>;
+    pushSubscribe(topic: string): Promise<any>;
+    pushUnregister(token: string): Promise<any>;
+    pushUnsubscribe(topic: string): Promise<any>;
+    referralsClaimReferral(code: string): Promise<any>;
+    referralsCreate(code?: string | null, max_uses?: number | null): Promise<any>;
+    referralsGetReferralCode(): Promise<any>;
+    refreshSession(): Promise<any>;
+    reviewsCreate(params_json: string): Promise<any>;
+    reviewsDelete(id: string): Promise<any>;
+    reviewsList(target_type: string, target_id: string): Promise<any>;
+    reviewsUpdate(id: string, patch_json: string): Promise<any>;
+    rolesGetMyRoles(): Promise<any>;
+    rolesHasPermission(permission: string): Promise<any>;
+    setDebug(enabled: boolean): void;
+    signInAnonymously(): Promise<any>;
+    signInWithEmail(email: string, password: string): Promise<any>;
+    signInWithSocial(provider: string, id_token: string): Promise<any>;
+    signOut(rotate_anonymous_id: boolean): Promise<any>;
+    signUpWithEmail(email: string, password: string): Promise<any>;
+    storageCommit(upload_id: string, asset_id: string): Promise<any>;
+    storagePresign(bucket: string, filename: string, mime_type: string, size_bytes: number, retention_days?: number | null): Promise<any>;
+    storesGetPurchaseOptions(store_key: string): Promise<any>;
+    storesList(): Promise<any>;
+    storesPurchase(store_key: string, purchase_option_id: string, receipt_json: string): Promise<any>;
+    streaksGetAll(): Promise<any>;
+    streaksQualify(streak_key: string): Promise<any>;
+    /**
+     * Track an event. Returns a Promise that resolves to undefined on success.
+     */
+    track(event: string, properties_json?: string | null): Promise<any>;
+    xpClaim(grant_key: string): Promise<any>;
+    xpGetBalance(): Promise<any>;
+    xpGetHistory(limit?: number | null): Promise<any>;
+}
+
+export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
+
+export interface InitOutput {
+    readonly memory: WebAssembly.Memory;
+    readonly __wbg_ambacorewasm_free: (a: number, b: number) => void;
+    readonly ambacorewasm_achievementsGetAll: (a: number) => number;
+    readonly ambacorewasm_achievementsGetProgress: (a: number) => number;
+    readonly ambacorewasm_aiAnthropicMessages: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_anonymousId: (a: number, b: number) => void;
+    readonly ambacorewasm_appUserId: (a: number, b: number) => void;
+    readonly ambacorewasm_catalogList: (a: number) => number;
+    readonly ambacorewasm_challengesClaim: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_challengesGet: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_challengesGetActive: (a: number) => number;
+    readonly ambacorewasm_challengesGetProgress: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_collectionsDelete: (a: number, b: number, c: number, d: number, e: number) => number;
+    readonly ambacorewasm_collectionsFind: (a: number, b: number, c: number, d: number, e: number) => number;
+    readonly ambacorewasm_collectionsFindOne: (a: number, b: number, c: number, d: number, e: number) => number;
+    readonly ambacorewasm_collectionsInsert: (a: number, b: number, c: number, d: number, e: number) => number;
+    readonly ambacorewasm_collectionsUpdate: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => number;
+    readonly ambacorewasm_configFetch: (a: number) => number;
+    readonly ambacorewasm_contentCreateItem: (a: number, b: number, c: number, d: number, e: number) => number;
+    readonly ambacorewasm_contentGetItem: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_contentGetLibrary: (a: number, b: number, c: number, d: number, e: number, f: number) => number;
+    readonly ambacorewasm_contentGetToday: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_contentUpdateItem: (a: number, b: number, c: number, d: number, e: number) => number;
+    readonly ambacorewasm_currenciesGetBalance: (a: number) => number;
+    readonly ambacorewasm_currenciesGetTransactions: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_deepLinksCreate: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_deepLinksGet: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_entitlementsHas: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_entitlementsList: (a: number) => number;
+    readonly ambacorewasm_feedsGetActivity: (a: number, b: number, c: number, d: number, e: number) => number;
+    readonly ambacorewasm_flagsFetch: (a: number) => number;
+    readonly ambacorewasm_friendsBlockUser: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_friendsGetFriends: (a: number) => number;
+    readonly ambacorewasm_friendsGetList: (a: number) => number;
+    readonly ambacorewasm_friendsRemoveBlock: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_friendsUnblockUser: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_groupsCreate: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_groupsDelete: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_groupsGet: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_groupsGetMembers: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_groupsInvite: (a: number, b: number, c: number, d: number, e: number) => number;
+    readonly ambacorewasm_groupsJoin: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_groupsLeave: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_groupsUpdate: (a: number, b: number, c: number, d: number, e: number) => number;
+    readonly ambacorewasm_init: (a: number, b: number, c: number, d: number) => void;
+    readonly ambacorewasm_inventoryConsume: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_inventoryGetItem: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_inventoryGetItems: (a: number) => number;
+    readonly ambacorewasm_inventoryPurchase: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_isAuthenticated: (a: number) => number;
+    readonly ambacorewasm_leaderboardsGet: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_leaderboardsGetEntries: (a: number, b: number, c: number, d: number) => number;
+    readonly ambacorewasm_leaderboardsGetMyRank: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_me: (a: number) => number;
+    readonly ambacorewasm_messagingGetConversations: (a: number) => number;
+    readonly ambacorewasm_messagingGetMessage: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_messagingSendMessage: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_moderationGetReportStatus: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_moderationReportContent: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_moderationReportUser: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_onboardingComplete: (a: number) => number;
+    readonly ambacorewasm_onboardingGetStatus: (a: number) => number;
+    readonly ambacorewasm_onboardingNextStep: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_onboardingSkipStep: (a: number) => number;
+    readonly ambacorewasm_pushGetTokens: (a: number) => number;
+    readonly ambacorewasm_pushRegister: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => number;
+    readonly ambacorewasm_pushSubscribe: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_pushUnregister: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_pushUnsubscribe: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_referralsClaimReferral: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_referralsCreate: (a: number, b: number, c: number, d: number) => number;
+    readonly ambacorewasm_referralsGetReferralCode: (a: number) => number;
+    readonly ambacorewasm_refreshSession: (a: number) => number;
+    readonly ambacorewasm_reviewsCreate: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_reviewsDelete: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_reviewsList: (a: number, b: number, c: number, d: number, e: number) => number;
+    readonly ambacorewasm_reviewsUpdate: (a: number, b: number, c: number, d: number, e: number) => number;
+    readonly ambacorewasm_rolesGetMyRoles: (a: number) => number;
+    readonly ambacorewasm_rolesHasPermission: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_setDebug: (a: number, b: number) => void;
+    readonly ambacorewasm_signInAnonymously: (a: number) => number;
+    readonly ambacorewasm_signInWithEmail: (a: number, b: number, c: number, d: number, e: number) => number;
+    readonly ambacorewasm_signInWithSocial: (a: number, b: number, c: number, d: number, e: number) => number;
+    readonly ambacorewasm_signOut: (a: number, b: number) => number;
+    readonly ambacorewasm_signUpWithEmail: (a: number, b: number, c: number, d: number, e: number) => number;
+    readonly ambacorewasm_storageCommit: (a: number, b: number, c: number, d: number, e: number) => number;
+    readonly ambacorewasm_storagePresign: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => number;
+    readonly ambacorewasm_storesGetPurchaseOptions: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_storesList: (a: number) => number;
+    readonly ambacorewasm_storesPurchase: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => number;
+    readonly ambacorewasm_streaksGetAll: (a: number) => number;
+    readonly ambacorewasm_streaksQualify: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_track: (a: number, b: number, c: number, d: number, e: number) => number;
+    readonly ambacorewasm_xpClaim: (a: number, b: number, c: number) => number;
+    readonly ambacorewasm_xpGetBalance: (a: number) => number;
+    readonly ambacorewasm_xpGetHistory: (a: number, b: number) => number;
+    readonly __wasm_bindgen_func_elem_2351: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_2347: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_2351_96: (a: number, b: number, c: number, d: number) => void;
+    readonly __wbindgen_export: (a: number, b: number) => number;
+    readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
+    readonly __wbindgen_export3: (a: number) => void;
+    readonly __wbindgen_export4: (a: number, b: number) => void;
+    readonly __wbindgen_add_to_stack_pointer: (a: number) => number;
+    readonly __wbindgen_export5: (a: number, b: number, c: number) => void;
+}
+
+export type SyncInitInput = BufferSource | WebAssembly.Module;
+
+/**
+ * Instantiates the given `module`, which can either be bytes or
+ * a precompiled `WebAssembly.Module`.
+ *
+ * @param {{ module: SyncInitInput }} module - Passing `SyncInitInput` directly is deprecated.
+ *
+ * @returns {InitOutput}
+ */
+export function initSync(module: { module: SyncInitInput } | SyncInitInput): InitOutput;
+
+/**
+ * If `module_or_path` is {RequestInfo} or {URL}, makes a request and
+ * for everything else, calls `WebAssembly.instantiate` directly.
+ *
+ * @param {{ module_or_path: InitInput | Promise<InitInput> }} module_or_path - Passing `InitInput` directly is deprecated.
+ *
+ * @returns {Promise<InitOutput>}
+ */
+export default function __wbg_init (module_or_path?: { module_or_path: InitInput | Promise<InitInput> } | InitInput | Promise<InitInput>): Promise<InitOutput>;