keybay 0.3.2

Cross-platform local secret storage for Dart without Flutter: one encrypted, platform-protected application store with optional passphrase or passkey protection.

keybay

One encrypted, platform-protected local store per Dart or Flutter application. No Flutter dependency, Keybay account, daemon or hosted service.

Requires Dart 3.11+. Supports iOS, Android 12+, macOS and ordinary Linux desktop. See platform setup for native integration and qualification limits. Desktop builds need Keypass's native build prerequisites, even for passphrase-only use. Distribute the complete native bundle; end users do not need build tools.

Upgrading: V1 stores are not migrated, and 0.3.0 rejects retired V2 singleton-passphrase packages. A 0.2.0 vault with a passphrase or passkey must have its methods removed with 0.2.0 before upgrading, then added back; platform-only vaults upgrade as is. See the changelog.

Open, use, close

import 'package:keybay/keybay.dart';

final session = await Keybay.open();
try {
  await session.set('api-token', 's3cr3t');
  final token = await session.get('api-token');
  await session.delete('api-token');
} finally {
  await session.close();
}

open() initializes fully absent state with platform protection. Record operations and auth.list() never prompt; opening, changing authentication and resetting may invoke provider UI. Binary access uses getBytes, setBytes and getManyBytes; listKeys returns names without decrypting values.

clearAll keeps protection while removing records. Keybay.reset() deletes the current store and deletable provider state. Never reset automatically on an unlock or state-conflict error; see recovery.

Application identity

Signed/package identity comes from the OS. Ordinary Dart executables on Linux and unentitled macOS declare a namespace in their owning pubspec.yaml:

keybay:
  application_id: com.example.my_app

Compile with dart run keybay:keybay_compile bin/app.dart -o build/app to embed it. The API has no runtime application-ID, path or store selector. A desktop namespace prevents collisions, not access by another same-user program. See identity and packaging.

Add protection

An open session enrolls protection explicitly. Complete enrollment before writing values that should require it:

const credential = PasskeyCredential.system(rpId: 'vault.example.com');
final session = await Keybay.open();
try {
  await session.auth.add(credential, label: 'Personal vault');
  await session.set('api-token', 's3cr3t');
} finally {
  await session.close();
}

Later, Keybay.open(credential: credential) authenticates that enrollment; it never creates a passkey or initializes a missing store. Use methodId: when several enrollments match.

Other credentials use the same open and auth.add operations:

Credential	Input
PassphraseCredential(phrase: bytes)	Caller-owned passphrase bytes.
PasskeyCredential.system(rpId: domain)	Native app host and domain association.
PasskeyCredential.hardware(rpId: namespace, pin: bytes)	Physical FIDO2 key; optional PIN for this attempt, no website required.

Credentials are data only. Operations copy mutable input synchronously and clear their copy; clear your own buffers after submitting the call. Hardware PIN and connection errors let your app request input and retry deliberately.

Protection is platform AND (passphrase OR passkey A OR passkey B ...): one passphrase at most, eight methods total. Manage them with auth.add, auth.list and auth.remove(method); there is no update/replace. Removing the last method returns to platform-only protection. Changing a passphrase requires separate remove/add commits, leaving that weaker state if it was the last method and adding fails. Add a replacement passkey before removing the old one when capacity allows.

Removing a method does not delete its provider credential or revoke older snapshots. The platform root is always required, so synced passkeys alone do not make a vault portable.

• SDK guide: complete flows, cancellation and errors.
• Security policy: guarantees and limitations.
• External review: exact baselines and outstanding work.

Pre-1.0 APIs and formats may change. MIT licensed.