amba
amba SDK for Flutter — the full 4.0 surface (auth, users, sessions, sync, leagues + 29 more namespaces) for the agent-native backend-as-a-service.
4.0.2
layers/amba
What this package is like to depend on
Last release 2 months ago
28 May 2026
Too new to tell
only 2 release windows
Nearly every release is documented
notes for 5 of 5 stable releases
Nothing withdrawn
no release was ever pulled
3 months old
5 releases · first in 2026
5 releases in the last 12 months
see the full history below
Release timeline
5 releases · May 2026 to May 2026Releases
latest 5-
4.0.228 May 2026Release notes
Open source →Version-alignment release across every published Amba package. Brings the infra-tier packages (
@layers/amba,@layers/amba-shared,@layers/amba-mcp— previously on 1.x) onto the same 4.x track as the SDKs so customers can pin a single version everywhere. No surface or behavior changes in this SDK.Removed from the package family in this release: the deprecated
@layers/amba-functionsand@layers/amba-clientpackages were unpublished from npm. Amba functions are plain ES modules with the standardexport default { async fetch(req, env, ctx) }shape — no wrapper. See docs.amba.dev/functions/runtime for the full contract. -
4.0.127 May 2026Release notes
Open source →Version-alignment release across every Amba SDK. No surface or behavior changes — bumps every SDK (web, node, react, react-native, expo, core, kotlin, swift, flutter, unity) to 4.0.1 so customers can pin to a single version across stacks. See
sdks/CANONICAL_API.mdfor the 4.0 surface. -
1.0.220 May 2026Release notes
Open source →Added
Amba.diagnostics.ping()— wire-verify primitive. Call once afterAmba.configure(...)to confirm the SDK is talking to the right project with the right API key in the right environment. Returns aPingResultwhose fields (serverProjectId,environment,keyFingerprint,latencyMs) are all server-decided, so comparingserverProjectIdagainst the configured project id catches "wrong key in .env" silent failures on the spot. Mirrors the TypeScript SDKs'Amba.diagnostics.ping()shape (added in 1.0.0).dart:developer log()calls from the SDK now usename: "amba-sdk", so Flutter DevTools /flutter logsfiltering on that name surfaces amba's own diagnostics without dragging in app-side log noise. The SDK never callsprint().
Known limitations
- The published xcframework still ships the iOS device slice only (arm64) — unchanged from 1.0.1. Running on an iOS simulator requires building a simulator slice locally. iOS device builds, App Store archives, and Android (all four ABIs) are fully supported out-of-box. The simulator-slice download follow-up tracked in 1.0.1 is still pending.
-
1.0.120 May 2026Release notes
Open source →Fixed
- Bundled prebuilt native binaries for Android (arm64-v8a, armeabi-v7a,
x86_64, x86) and iOS device (arm64) so
flutter build apkandflutter build ipasucceed without any local build step. - Added
android/src/main/kotlin/com/layers/amba/AmbaPlugin.ktandios/Classes/AmbaPlugin.swiftplugin stubs required by Flutter's plugin registration mechanism. - Added
android/build.gradle,android/src/main/AndroidManifest.xml, andios/amba.podspecneeded for Flutter to discover and link the plugin. - Fixed
Amba.versionconstant to match the published package version.
Known limitations
- The published xcframework ships the iOS device slice only (arm64).
Running on an iOS simulator requires building a simulator slice
locally — a follow-up release will add an automated podspec
prepare_commandthat downloads the matching slice onpod install. iOS device builds, App Store archives, and Android (all four ABIs) are fully supported out-of-box.
- Bundled prebuilt native binaries for Android (arm64-v8a, armeabi-v7a,
x86_64, x86) and iOS device (arm64) so
-
1.0.016 May 2026Release notes
Open source →Initial public release of the
ambaFlutter SDK on pub.dev.Added
Ambaclient class wrapping the Amba backend API for Flutter apps: configure with project id + client key; track events; anonymous sign-in; authenticated sign-in via magic link; collection CRUD; AI prompt invocation.- Smoke test fixtures under
test/integration/exercising the public surface against a live tenant.