atsign-foundation/at_client_sdk
57.8
Weak · 5 November 2026
133.2k
lines of production code
Dart
primary language
4
measurements over time
What this system is
Features
Add AtBuffer interface and implementations for string and byte data
Introduces the AtBuffer abstract class along with concrete implementations for managing string (StringBuffer) and byte (ByteBuffer) data. This provides a standardized way to handle buffered messages with configurable capacity and terminating characters, including overflow protection that throws AtBufferOverFlowException when limits are exceeded.
_packages/at\commons/lib/src/buffer · high confidence
Add ChatScreen widget for displaying chat history and messages
Introduced a new ChatScreen widget that displays a list of chat messages using incoming and outgoing message bubbles. The screen supports both full-screen and bottom-sheet modes, allows customization of message and avatar colors, and integrates with a ChatService to stream and display chat history. It also includes functionality to delete selected messages and show feedback via snackbars.
_packages/at\_chat\flutter/lib/screens · high confidence
Add Zariot IoT Secure Element example code
The \packages/at\_chops/example/zariot\ directory now includes example code for interacting with a Zariot IoT Secure Element. This adds an \ExternalSigner\ class to handle low-level serial communication (via \dart\_periphery\) for operations like key generation, signing, and public key retrieval, along with an \AtChopsSecureElement\ implementation that integrates this signer with the AT Chops library. A \compute\_verify\_signature\_sim.dart\ script demonstrates the full workflow, including opening serial channels, selecting the IoTsafe application, generating key pairs, computing signatures on precomputed hashes, and verifying them.
_packages/at\chops/example/zariot · high confidence
Add base2e15 and dart\_utf7 encoding packages
Introduced two new Dart packages to the repository: \base2e15\, a binary-to-text encoding scheme using Unicode characters (15 bits per character), and \dart\_utf7\, a UTF-7 encoder/decoder. These packages include their core libraries, tests, and documentation, providing null-safe implementations for downstream atPlatform libraries.
packages/base2e15 · high confidence
Add example app for at\_location\_flutter
The example application for the at\_location\_flutter package has been added, providing a complete demo of the library's capabilities. The app includes an onboarding flow using at\_onboarding\_flutter, a main screen for managing atSign authentication, and a second screen that demonstrates key features such as sending and requesting location updates, tracking location via the AtLocationFlutterPlugin, and displaying multiple location points on a map. It also integrates a notification stream to display incoming location data.
_packages/at\_location\flutter/example/lib · high confidence
Added Message model for chat data representation
Introduced the Message model class in the chat package to represent individual chat messages. This model supports both text and image content types, tracks message direction (incoming/outgoing), and includes serialization methods (JSON/map) for data persistence and transmission. Users can now utilize this structured data type to handle message creation, copying, and equality checks within the chat interface.
_packages/at\_chat\flutter/lib/models · high confidence
Added authorization exception models
The library now includes specific exception classes for authorization failures, including InvalidSppException, OtpGenerationException, UnexpectedResponseException, and exceptions for failing to approve, deny, or revoke enrollment requests. These are exported via the models.dart file to allow consumers to catch and handle these specific error conditions.
_packages/at\_client\flutter/lib/src/models · high confidence
Added cryptographic benchmarking harness
A new benchmark script (\crypto\_bench.dart\) has been added to the \at\_client\ package to measure the performance of cryptographic operations. The harness times symmetric encryption (AES-256-GCM vs. legacy AES-256-CTR) and key conveyance methods (X-Wing post-quantum vs. legacy RSA-2048) across various data sizes, providing metrics such as median and p90 execution times in microseconds.
_packages/at\client/benchmark · high confidence
Added macOS example app scaffolding
The \at\_chat\_flutter\ example now includes a complete macOS platform implementation, enabling users to build and run the chat application on macOS. This addition provides the necessary Xcode project structure, including the \Runner\ target, CocoaPods integration, and Flutter plugin registration for \biometric\_storage\, \file\_picker\, \package\_info\_plus\, and \path\_provider\_foundation\. It also configures macOS-specific entitlements for keychain access and network capabilities, and registers the \.atkeys\ file type in the app's Info.plist to support cryptographic key file handling.
_packages/at\_chat\flutter/example/macos · high confidence
Added macOS platform support for the example app
The \at\_events\_flutter\ example application now includes a complete macOS implementation, enabling users to build and run the app on macOS. This change adds the necessary Xcode project structure, including the \Runner\ target, \AppDelegate\, and \MainFlutterWindow\, along with a \GeneratedPluginRegistrant.swift\ file that registers platform-specific plugins such as \at\_file\_saver\, \biometric\_storage\, \geolocator\_apple\, and \sqflite\_darwin\. The configuration also sets up build settings, entitlements for sandboxing and file access, and defines the \.atkeys\ file type in the \Info.plist\.
_packages/at\_events\flutter/example/macos · high confidence
Example app iOS project scaffolded for Flutter v2 embedding and iOS 12+
The iOS native project for the at\_events\_flutter example app has been added, providing a complete Xcode workspace configured for the Flutter v2 embedding. This includes the standard Runner target, CocoaPods integration, and asset configurations. The app now targets a minimum iOS version of 12.0 and declares location permissions (when in use and always) in its Info.plist, enabling location-based features in the example.
_packages/at\_events\flutter/example/ios · high confidence
Example app project structure and configuration added
The example application for the at\_location\_flutter package now includes essential project configuration files: a .gitignore to exclude build artifacts and local environment variables, an analysis\_options.yaml to enforce standard Flutter linting rules, and a .metadata file tracking the Flutter SDK version. Documentation files (README.md and EXAMPLE.md) have also been added to guide users on how to run the sample app and understand its features.
_packages/at\_location\flutter/example · high confidence
Experimental invitations, envelope signing, and notification retries
This change introduces several new experimental capabilities to the at\_client. First, it adds a full invitation system (Invitations mixin) allowing apps to create, send, and process invitations with encrypted content, public previews, and out-of-band codes. Second, it introduces envelope signing (EnvelopeSigning mixin and AtClientEnvelopeSigner) enabling clients to wrap payloads in signed JSON envelopes and verify signatures from other clients using APKAM keys. Third, it adds an AtClientBindings mixin that provides a notify method with built-in retry logic (defaulting to 3 attempts) for notifications. Finally, it includes the ApkamSigning mixin which manages the publication and retrieval of APKAM signing keys.
_packages/at\client/lib/src/mixins · high confidence
Initial commit of Flutter plugin scaffolding and theme utilities
This change introduces the foundational structure for several new Flutter packages: at\_chat\_flutter, at\_events\_flutter, at\_location\_flutter, and at\_theme\_flutter. For the platform-specific plugins (chat, events, location), the diff adds the necessary Android (Kotlin plugins, Gradle wrapper 7.5, manifests) and iOS (Swift/Objective-C plugins) boilerplate to enable native method channel communication, alongside standard .gitignore files. The at\_theme\_flutter package adds the core library exports, a ThemeService for persisting theme data, and utility constants for configuration.
(repo-wide) · high confidence
Initial release of at\_events\_flutter package
The at\_events\_flutter package is now available for Flutter developers to integrate event management features, including creating and updating events with location and participants, into their applications. This initial release (v1.0.0) provides a decentralized, edge-computing solution using the atPlatform, ensuring cryptographic control of data access, end-to-end encryption, and private connectivity without requiring a backend. The package includes an example application, comprehensive documentation, and standard project configuration files (such as .gitignore, analysis\_options.yaml, and LICENSE) to facilitate easy adoption.
(repo-wide) · high confidence
Initial release of at\_location\_flutter package with deprecation notice
The at\_location\_flutter package is introduced to allow Flutter developers to share and receive location data between atsigns using the atPlatform's decentralized model. The package includes a CHANGELOG indicating version 3.2.1, which carries a deprecation notice stating the package is no longer recommended for new apps, directing users to the location\_sharing example in at\_client\_flutter instead. The release also establishes standard project files including a BSD 3-Clause license, .gitignore rules for build artifacts, and analysis options based on flutter\_lints.
_packages/at\_location\flutter · high confidence
Initial release of at\_notify\_flutter package and example app
The at\_notify\_flutter package is now available for Flutter developers to handle notifications within Atsign Protocol apps, featuring cryptographic data access control and end-to-end encryption without requiring a backend. This release includes the core library, a complete example application demonstrating usage (including onboarding and notification sending), and native platform support for Android and iOS.
_packages/at\_notify\flutter · high confidence
Initial release of the at\_contact library for managing contacts and groups
The \at\_contact\ package is introduced, providing a new API for managing individual contacts and contact groups within the atServer ecosystem. The library exposes \AtContact\ and \AtGroup\ models along with an implementation (\AtContactsImpl\) that handles CRUD operations (add, update, delete, get) and filtering (list, active, blocked, favorite). It manages storage using specific key prefixes (\atconnections\, \groups\) and includes logic to migrate legacy key formats to the new structure. Users can now programmatically maintain their contact lists and group memberships via this dedicated library.
_packages/at\contact/lib · high confidence
Initial release of the at\_login\_flutter plugin
This change introduces the at\_login\_flutter package, a Flutter plugin for implementing zero-trust logins using the Atsign Protocol. The package provides an AtLogin screen for scanning QR codes to capture login requests and an AtLoginDashboard screen for viewing request history. It includes the necessary Android and iOS native configurations, such as permissions for camera and storage, and exposes a Dart API for integrating the login flow into an application.
_packages/at\_login\flutter · high confidence
Initial release of utility modules for at\_events\_flutter
This change introduces the foundational utility layer for the at\_events\_flutter package, making core resources and initialization logic available to the application. It adds a centralized color palette and deterministic contact-initials color generator, a text-styles singleton for consistent typography, and a constants class for managing map and API keys alongside event notification timing options. Additionally, it provides a comprehensive library of localized UI strings for event creation, participant management, and location sharing, along with an initialization service that sets up the event service, location tracking, and notification listeners.
_packages/at\_events\flutter/lib/utils · high confidence
Introduce AtBytes class for base64 key management
A new AtBytes class has been added to manage base64 encoded byte data, providing a wrapper around Uint8List. This class supports construction from strings via base64 decoding, string comparison, and direct byte-level equality checks using the == operator and hashCode, replacing previous string-based equality methods to reduce overhead.
_packages/at\commons/lib/src/key · high confidence
Introduce AtCollection for typed, reactive, shareable data
Adds the \AtCollection\<T\>\ API, enabling applications to manage typed, shareable collections with built-in CRUD operations, composable queries (including live watch streams), nested sub-collections, and automatic read receipts. The implementation introduces an \EventSource\ enum allowing apps to choose whether collection events are sourced from local data events, remote notifications, or both, providing flexibility in how real-time updates and sync catch-up are handled.
_packages/at\client/lib/src/collections · high confidence
Introduce AtRpc for request-response communication via atProtocol notifications
Added a new \AtRpc\ class and \AtRpcClient\ helper in the \at\_client\ package that implement a simple RPC request-response API using atProtocol notifications under the hood. This allows applications to send structured requests and receive corresponding responses (ack, success, error, or nack) by leveraging the notification service, with support for namespacing, allow-listing of atSigns, and automatic handling of request IDs and timeouts.
_packages/at\client/lib/src/rpc · high confidence
Introduce at\_auth package for activation and onboarding
The new \at\_auth\ package centralizes the client-side activation flow, providing the \AtAuth\ interface and \AtAuthImpl\ to manage CRAM and PKAM authentication, key minting, and the first enrollment. Users can now onboard a new atSign by calling \onboard\, which handles connecting to the server, authenticating, generating key pairs (including post-quantum support), and persisting the resulting keys via a provided \AtKeysIo\ store. The package also exposes a \progressStream\ for monitoring onboarding status and includes constants for key schema definitions.
_packages/at\auth/lib/src · high confidence
Introduce event and location notification data models
Added new data models in the \at\_events\_flutter\ package to handle event and location sharing notifications. This includes \EventNotificationModel\ for parsing and serializing event details (such as venue, recurrence, and group membership), \EventMemberLocation\ for tracking individual member location shares, \HybridNotificationModel\ to unify event and location notifications, and utility enums and functions in \enums\_model.dart\ for adjusting start and end times.
_packages/at\_events\flutter/lib/models · high confidence
Introduce event notification, contact, and venue management services
The \at\_events\_flutter\ package now includes a new set of service classes in the \lib/services\ directory to handle core event logic. \AtEventNotificationListener\ monitors and processes incoming encrypted notifications for new or updated events, displaying a dialog when appropriate. \EventKeyStreamService\ manages the local stream of event notifications, retrieving existing events, filtering past ones, and tracking user responses. \ContactService\ retrieves and caches AtContact details (name, image) for event participants. \EventService\ handles the creation and editing of events by writing keys to the At Protocol. \HomeEventService\ provides UI helper logic for determining action states (e.g., 'Action required', 'Cancelled') for events in the home view. \VenuesServices\ manages a local queue of frequently used venue locations, persisting them to the At Protocol for reuse.
_packages/at\_events\flutter/lib/services · high confidence
Introduce experimental at\_telemetry package for OpenTelemetry-compatible telemetry
The new \at\_telemetry\ package (v0.1.0) provides an OpenTelemetry-style telemetry system for apps and atServers. It introduces the \AtTelemetry\ entry point for recording events and logs, which routes all delivery failures to an \onError\ handler rather than throwing. The package includes an \AtTelemetryNotificationExporter\ that batches records and sends them as notifications to a collector atSign, and an \AtTelemetryLogsCodec\ for encoding/decoding OTLP/JSON payloads without a protobuf dependency. It also implements the \at-telemetry\ HTTP signature profile (RFC 9421 with Ed25519) for securing telemetry sent by atServers.
_packages/at\telemetry · high confidence
Introduces new encryption and encoding converters in the at\_client library
The at\_client library now includes new converter implementations for data handling: byte splitting via \byte\_splitter.dart\, base64 encoding/decoding via \at\_encoder.dart\ and \at\_decoder.dart\, and AES encryption/decryption via \aes\_converter.dart\. These changes introduce new capabilities for splitting byte streams, encoding/decoding strings to/from base64, and encrypting/decrypting data using AES with optional IV support, laying groundwork for future encryption metadata enhancements.
_packages/at\client/lib/src/converters · high confidence
Introduction of AtServerEvent interface and AtSignPKChangedEvent
A new event system has been added to the atServer layer, starting with the \AtServerEvent\ abstract interface and the \AtSignPKChangedEvent\ concrete class. This allows the atServer to emit structured events, specifically notifying when an atSign's public key changes. The event includes the atSign and can be serialized to and from JSON, providing a foundation for future event types.
_packages/at\commons/lib/src/atserver · high confidence
Introduction of ChatService for message management and synchronization
A new ChatService singleton has been added to handle chat history retrieval, message interleaving by timestamp, and real-time notification monitoring. This service initializes with AtClientManager configuration, subscribes to encrypted notifications to update the chat stream, and manages both one-to-one and group chat states, including fetching and merging local and remote message histories.
_packages/at\_chat\flutter/lib/services · high confidence
New CLI examples for AtCollection, custom crypto, and dockerstats
The \packages/at\client/example/bin\ directory now includes a suite of new command-line examples demonstrating the AtCollection API and related features. \collections\\*.dart\ files show how to store and share binary data, generic objects, primitives (Maps/Strings), and domain objects (Pets), as well as how to use sub-collections for hierarchical data (posts/comments) and a full TUI-based todo app. \custom\_crypto\provider.dart\ demonstrates implementing and wiring a custom \CryptoProvider\ (XOR demo). \dockerstats\\*.dart\ provides a publisher/subscriber pair for live Docker container statistics using notifications, including simulation mode and graceful shutdown handling. \notifications.dart\ and \rpcs.dart\ show basic fire-and-forget messaging and RPC patterns.
_packages/at\client/example/bin · high confidence
New Flutter-specific UI components and utility extensions
The at\_client\_flutter library now exposes a comprehensive set of Flutter-specific UI widgets and helper extensions. Users can now utilize new dialog components for authentication flows, including PKAM, CRAM, and APKAM dialogs, as well as utilities for file picking and enrollment request lists. Additionally, a new extensions file provides Flutter-specific utility functions, such as file handling helpers, to simplify integration with existing at\_sign libraries.
_packages/at\_client\flutter/lib · high confidence
New KeyStream API for reactive AtKey monitoring
The at\_client library now exposes a new \KeyStream\ API (including \IterableKeyStream\, \ListKeyStream\, \SetKeyStream\, and \MapKeyStream\) that allows applications to subscribe to real-time streams of AtKey data. These streams automatically handle notification subscriptions, filtering by regex or atSigns, and pre-loading initial keys, enabling seamless integration with Flutter's \StreamBuilder\ for reactive UI updates.
_packages/at\_client/lib/src/key\stream · high confidence
New RSA, ECDSA, and Ed25519 signing implementations alongside ML-DSA-65 backends
The signing algorithm module now includes dedicated implementations for RSA (RsaSignatureAlgo), ECDSA (EccSigningAlgo), and Ed25519 (Ed25519SigningAlgo), in addition to the existing ML-DSA-65 (MlDsa65FfiAlgo and MlDsa65PureDartAlgo) backends. These new classes implement the AtSignatureAlgorithm interface, allowing users to perform data signing and verification using these specific cryptographic standards. RSA signing supports 2048 and 4096-bit keys with SHA-256 or SHA-512 hashing, while ECDSA uses SHA-256 with secp256r1, and Ed25519 provides standard elliptic curve signing. The ML-DSA-65 implementations remain available for post-quantum cryptography, with the FFI backend leveraging OpenSSL and the pure-Dart backend using the pqcrypto library.
_packages/at\chops/lib/src/algorithm/signing · high confidence
New UI components for the device authorization interface
The authorization section now includes a set of reusable Flutter widgets to build the device management and enrollment request screens. This adds an overlay for displaying enrollment status feedback (Pending, Approved, Denied, Revoked, Expired), a list tile with optional badge support for navigation sections, and a section header widget. It also introduces cards for managing devices (identifying the current manager device), displaying enrollment requests with expandable namespace permission details (using namespace chips), and showing informational tips. These components provide the visual structure for the new authorization lifecycle views.
_packages/at\_client\flutter/lib/src/widgets/authorisation/components · high confidence
New acceptance ledger and JWS vector verification tools
Added three new tooling scripts to \packages/at\_client/tool\: \acceptance\_ledger.dart\ renders a Markdown report showing which acceptance test clauses were actually exercised and passed in a given run set; \generate\_jws\_vectors.dart\ regenerates the committed JWS signed-envelope test fixtures (supporting RS256 and ML-DSA-65) to ensure deterministic golden files for regression testing; and \verify\_jws\_vectors.mjs\ uses the third-party \jose\ library to validate those JWS vectors against RFC 7515 general JSON serialization, including tamper detection. These tools improve confidence in cryptographic signing behavior by providing automated, verifiable checks for both acceptance test coverage and signed-envelope integrity.
_packages/at\client/tool · high confidence
New chat UI components and utilities in at\_chat\_flutter
The at\_chat\_flutter package now includes a set of new widgets and utilities to support the chat interface. This adds a SendMessage widget for composing and sending text or media, IncomingMessageBubble and OutgoingMessageBubble for displaying chat messages (with long-press delete support for outgoing messages), and helper widgets like ContactInitial for avatar initials and CustomCircleAvatar for profile images. It also introduces utility files for managing chat service initialization, color theming (CustomColors and ContactInitialsColors), and confirmation dialogs (dialog\_utils).
_packages/at\_chat\flutter/lib/widgets · high confidence
New common UI components for the events interface
The \common\_components\ directory now includes a suite of reusable widgets to support the events feature, including \bottom\_sheet.dart\ for modal sheets, \concurrent\_event\_request\_dialog.dart\ for handling overlapping event creation, and \contact\_list\_tile.dart\ alongside \overlapping\_contacts.dart\ for managing contact selection and display. Visual presentation is handled by \custom\_button.dart\, \custom\_heading.dart\, \custom\_toast.dart\, \display\_tile.dart\, \floating\_icon.dart\, \invite\_card.dart\, \location\_tile.dart\, \text\_tile.dart\, and \pop\_button.dart\. State and navigation utilities include \loading\_widget.dart\ for async feedback, \custom\_popup\_route.dart\ for custom route transitions, and \custom\_circle\_avatar.dart\ for profile images. Additional specific components include \event\_time\_selection.dart\ for scheduling, \error\_screen.dart\ for failure states, \draggable\_symbol.dart\ for UI handles, and \triple\_dot\_loading.dart\ for typing indicators.
_packages/at\_events\_flutter/lib/common\components · high confidence
New composite action to setup Flutter and Dart with channel-specific caching
A new GitHub Action named 'Setup Flutter and Dart' has been added to the repository. This composite action installs both Flutter and Dart SDKs, allowing users to specify the channel (stable or beta) for each. It introduces a mechanism to cache Flutter installations based on specific commit SHAs stored in \flutter\_ref-stable\ and \flutter\_ref-beta\ files, ensuring consistent and cached builds. Additionally, it includes a validation step to ensure that the \dart\ binary on the PATH is not sourced from the Flutter SDK, preventing potential conflicts.
actions · high confidence
New encryption algorithms and backends: AES-CTR, AES-256-GCM, ChaCha20-Poly1305, and ML-KEM
The encryption module now includes implementations for AES-CTR (with both pure-Dart and OpenSSL FFI backends), AES-256-GCM (pure-Dart and FFI), ChaCha20-Poly1305, and ML-KEM-768/1024 (pure-Dart and FFI). These additions provide authenticated encryption (GCM, ChaCha20-Poly1305) and post-quantum key encapsulation (ML-KEM), alongside unauthenticated stream encryption (CTR). The FFI backends leverage OpenSSL 3 for performance, while pure-Dart versions ensure cross-platform compatibility. Specific classes like \AesCtrFfiAlgo\, \AesGcm256FfiAlgo\, \MlKem768FfiAlgo\, and \MlKem1024PureDartAlgo\ are introduced to handle these operations, with clear distinctions between serializable pure-Dart keys and process-lifetime FFI handles where applicable.
_packages/at\chops/lib/src/algorithm/encryption · high confidence
New enrollment request list widget for Flutter
Added the EnrollmentRequestList widget in the authorisation containers, which displays a real-time list of pending enrollment requests and allows users to approve or deny them via the AtClient. The widget subscribes to enrollment streams, handles initial fetches, and provides visual feedback overlays for approval/denial actions, including error handling for authorization failures.
_packages/at\_client\flutter/lib/src/widgets/authorisation/containers · high confidence
New enrollment-based signing infrastructure with ML-DSA-65 support
The signing subsystem has been refactored to support per-enrollment signing keys, introducing new files for key composition, envelope signatures, and algorithm resolution. Users can now mint and manage signing keys for multiple algorithms (including the post-quantum ML-DSA-65) alongside legacy RSA-2048, with keys advertised in a structured \\_apsk\ record that distinguishes active signers from retired ones. Envelopes are now signed using a standardized JWS shape that includes explicit type and algorithm claims, ensuring verifiers can correctly identify the signing key and algorithm used.
_packages/at\client/lib/src/signing · high confidence
New example app for at\_events\_flutter with onboarding and event management
The example application for the at\_events\_flutter package has been rewritten to demonstrate core functionality. It now includes a main entry point that handles AtSign onboarding via the at\_onboarding\_flutter package and manages theme switching. A second screen allows authenticated users to create events and view a list of existing events, utilizing the HomeEventService for event logic and display. The app also implements a reset feature to clear onboarding state.
_packages/at\_events\flutter/example/lib · high confidence
New example scripts for atsign onboarding and app enrollment
Added two new CLI example scripts in the at\_auth package: \onboard.dart\ demonstrates the initial atsign activation process using CRAM secrets and PKAM, saving the resulting keys to a file, while \enrollment\_request.dart\ shows how a new application can request enrollment into an existing atsign account using an OTP and specific signing algorithms. These examples provide concrete usage patterns for the core authentication and enrollment flows.
_packages/at\auth/example · high confidence
New factory for building AtClient instances with explicit lifecycle and service wiring
The \at\_client\ package now exposes a \buildAtClient\ factory in \at\_client\_factory.dart\ that allows applications to create and own an \AtClient\ instance directly, rather than relying solely on the global \AtClientManager\. This factory wires the client's notification, sync, and enrollment services, handles storage injection (allowing the caller to own the storage lifecycle), and enforces that only one client exists per principal (enrollment or credential) to prevent conflicts. It also supports injecting custom service builders and \AtKeysIo\ for keyfile-based authentication, providing a more explicit and testable client lifecycle.
_packages/at\client/lib/src/client · high confidence
New foundational classes and constants for at\_commons
This change introduces several new core components to the at\_commons library. It adds the AtConstants class, which centralizes string constants for keys, operations, and configuration. It also introduces the AtRootDomain class to handle parsing and validation of root domain addresses, including proxy support. Additionally, new files define the AtMessage enum for standardized error messaging, the SharedKeyStatus enum for tracking key synchronization states, and the AtTelemetryService interface along with its event and sample classes to support software telemetry.
_packages/at\commons/lib/src · high confidence
New hashing algorithm implementations and parameter types
The hashing module now includes dedicated implementations for Argon2id, HKDF (SHA-256 and SHA-384), MD5, SHA-256, and SHA-512. Argon2id supports configurable parameters (parallelism, memory, iterations, hash length) and includes an OWASP-compliant minimum configuration, while retaining backward-compatible defaults for existing key files. HKDF is exposed via separate SHA-256 and SHA-384 classes, supporting extract, expand, and derive-key operations. New parameter types (HashParams, ArgonHashParams, DefaultHashParams) allow users to customize algorithm behavior.
_packages/at\chops/lib/src/algorithm/hashing · high confidence
New library entry points and Atsign type extension
The at\_commons package now exposes two new top-level libraries, at\_builders.dart and at\_commons.dart, which consolidate exports for verb builders, exceptions, key management, and telemetry. Additionally, a new Atsign extension type is introduced, allowing strings to be converted into a validated, normalized Atsign object (handling lowercase conversion, dot removal, and reserved character checks) via the toAtsign() method.
_packages/at\commons/lib · high confidence
New modular authentication components for activation and credential handling
The at\_auth package introduces a set of new, focused classes in the auth source directory to handle the authentication lifecycle. The \activateAtSign\ function and \\_ConnectedActivation\ class manage the full activation flow, including waiting for provisioning, authenticating with a CRAM secret, minting key material (supporting both legacy RSA and post-quantum ML-DSA algorithms), and submitting the first enrollment. The \at\_authenticator.dart\ file provides factory functions (\authenticatorFor\, \authenticatorForChops\, \authenticatorForCramSecret\, \authenticatorForPrivateKey\) that select the appropriate authentication method (PKAM, CRAM, or legacy private key) based on the available credentials and configuration. Additionally, \cram\_authenticator.dart\ and \pkam\_authenticator.dart\ encapsulate the specific logic for CRAM and PKAM authentication steps, while \onboarding\_mint.dart\ handles the generation of key material for new atSigns, distinguishing between legacy and post-quantum key shapes.
_packages/at\auth/lib/src/auth · high confidence
New onboarding and authentication dialog widgets
The Flutter package now includes a set of new UI widgets to guide users through atSign lifecycle events. \AtKeysFileDialog\ allows users to select a local .atKeys file for authentication. \AtSignSelectionDialog\ lets users type or select an existing atSign and optionally configure a custom root domain. For activation, \RegistrarCramDialog\ handles OTP verification to obtain a CRAM key, which is then used by \CramDialog\ to activate the atSign. For existing users, \PkamDialog\ opens a client using stored keys and can optionally back them up. Finally, \ApkamActivationDialog\ manages the full APKAM enrollment flow, including OTP entry, waiting for approval, and opening the client. All dialogs include improved error handling and timeout management to prevent hanging.
_packages/at\_client\flutter/lib/src/widgets · high confidence
New post-quantum and X25519 example scripts for AtChops
The \packages/at\_chops/example/pq\ directory now includes runnable Dart examples demonstrating key generation, encapsulation, and signing for X25519, ML-KEM-768, and ML-DSA-65. Each algorithm is provided in two variants: an FFI-based implementation that interfaces with OpenSSL (requiring libcrypto) and a pure-Dart fallback, allowing users to see how to integrate these post-quantum and classical algorithms into their applications.
_packages/at\chops/example/pq · high confidence
New regex-based key validation utilities added to at\_commons
The at\_commons package now includes dedicated utilities for validating and classifying at-sign keys. A new \at\_key\_regex\_utils.dart\ file introduces a \Regexes\ abstraction and a \RegexUtil\ class that use regular expressions to determine the type of an at-key (public, private, self, shared, cached, reserved, or local) based on its structure and an optional namespace enforcement flag. Additionally, a \string\_utils.dart\ file adds an extension on nullable strings to provide convenient \isNullOrEmpty\ and \isNotNullOrEmpty\ checks.
_packages/at\commons/lib/src/utils · high confidence
New response transformers for get, put, and notification operations
The at\_client library now includes dedicated response transformers for handling get, put, and notification responses. The GetResponseTransformer processes get responses by decoding JSON, parsing metadata, and handling decryption based on the isEncrypted flag and key type (public/cached). The NotificationResponseTransformer handles notification decryption, properly managing key parsing and namespace extraction. The PutResponseTransformer simply parses put responses using the existing DefaultResponseParser. These transformers provide a more structured approach to response handling in the at\_client.
_packages/at\_client/lib/src/transformer/response\transformer · high confidence
New shared UI components for loading states and type-ahead selection
The \packages/at\_client\_flutter/lib/src/widgets/shared\ directory now includes two new reusable widgets: \LoadingDialog\, which displays a customizable modal with a progress indicator, title, and description, and \TypableDropdown\, an autocomplete-style input that allows users to type to filter a list of options or select from them. These components provide consistent visual feedback during operations and enhanced selection usability across the application.
_packages/at\_client\flutter/lib/src/widgets/shared · high confidence
New utility classes for validation, encryption, and sync operations
The at\_client library introduces a suite of new utility classes in the \src/util\ directory to centralize common logic. \AtClientValidation\ now enforces rules for keys, metadata (TTL/TTB/TTR), and put requests, while also validating notification parameters and atSign existence. \AtClientUtil\ provides helpers for metadata preparation, namespace handling, and RSA challenge signing. \EncryptionUtil\ exposes AES and RSA encryption/decryption methods, and \SyncUtil\ offers functions to retrieve the latest server commit ID and filter keys that should be synced. Additional utilities include \AtCollectionUtil\ for forming AtKeys, \closeWithoutWaiting\ for non-blocking stream closure, and \logSwallowed\ to distinguish defects from conditions in background error logging.
_packages/at\client/lib/src/util · high confidence
New verb builders and APKAM enrollment support
The \packages/at\_commons/lib/src/verb\ directory now contains a comprehensive set of new verb builders (including \AbstractVerbBuilder\, \ConfigVerbBuilder\, \DeleteVerbBuilder\, \EnrollVerbBuilder\, \KeysVerbBuilder\, \MonitorVerbBuilder\, \NotifyVerbBuilder\, \PkamVerbBuilder\, \ScanVerbBuilder\, and \SyncVerbBuilder\) along with \EnrollParams\ and \OperationEnum\. This introduces support for the APKAM enrollment workflow (with fields for \signingAlgo\, \apsk\, and \enrollmentStatusFilter\), adds new flags to the \Monitor\ verb for self-notifications, and updates the \Delete\ verb to support \force\, \noCommit\, and \deletedAt\ parameters.
_packages/at\commons/lib/src/verb · high confidence
OpenSSL FFI integration with runtime capability probing
The library now supports offloading cryptographic operations to OpenSSL via FFI, introducing bindings for key encapsulation (ML-KEM-768), digital signatures (ML-DSA-65), asymmetric key exchange (X25519), and symmetric encryption (AES-256-GCM, AES-256-CTR). To ensure stability on systems with restricted or older OpenSSL versions, the new \openssl\_loader\ module provides runtime probes that verify algorithm support before selection; if the underlying \libcrypto\ lacks support for a specific algorithm, the system falls back to pure-Dart implementations rather than failing at runtime.
_packages/at\chops/lib/src/algorithm/ffi · high confidence
Post-quantum secret sharing substrate with X-Wing and ML-KEM-1024 support
The secret-sharing subsystem has been replaced with a new post-quantum implementation that supports X-Wing (hybrid) and ML-KEM-1024 (pure) key-establishment algorithms. This change introduces a new \SecretSharingAlgos\ registry to manage algorithm identifiers and sealing suites, and updates the key package structure to be signed by the enrollment's APKAM key rather than using legacy RSA wrapping. The system now mints encapsulation keypairs for configured algorithms, manages their lifecycle (minting and retiring) via \KeyPackageMinting\, and conveys enrollment symmetric keys through signed \pqSeal\ envelopes. Envelope addressing uses a new \\_\_ssenv\ marker, and the enrollment directory now verifies key packages against the \\_apsk\ before treating them as valid encapsulation targets.
_packages/at\_client/lib/src/secret\sharing · high confidence
SQLite-backed storage backend for AtClient
The AtClient now supports a new storage backend that persists both the key-value store and the sync queue within a single SQLite database. This implementation allows for local data persistence using a specified database path, while also supporting in-memory storage (via \:memory:\) for scenarios where disk persistence is not required. The sync queue is stored in a dedicated \sync\_queue\ table within the same database file, ensuring that both key-value data and synchronization state are managed together.
_packages/at\client/lib/src/storage/sqlite · high confidence
at\_contacts\_flutter package scaffolding and example app added
The at\_contacts\_flutter package is introduced with its core structure, including a CHANGELOG documenting versions from 0.0.1 to 4.1.1, a BSD-3-Clause license, and a README detailing usage for managing contacts (add, delete, block/unblock) via the atPlatform. The package exposes UI screens (ContactsScreen, BlockedScreen, DesktopContactsScreen) and services, and includes a complete example application with native Android (Kotlin/Gradle) and iOS (Swift/Xcode) implementations to demonstrate integration.
_packages/at\_contacts\flutter · high confidence
Behavioural changes
1 commit (0 fixes) modifying features/at\_utils
A change to existing behaviour in features/at\_utils — 1 commit, 1 file: “feat(at\_utils)!: at\_progress.dart builds for the web”.
_features/at\utils · medium confidence · unverified
10 commits (2 fixes) modifying packages/at\_client/lib/src/storage
A change to existing behaviour in packages/at\_client/lib/src/storage — 10 commits (2 fixs), 1 file: “test(functional): isolate each test file's storage, on a selectable backend (\#2210)”; “docs: storage backends differ only over unencrypted records”; “docs: say only that encrypted values are stored as ciphertext”; and 7 more (refs \#2210, \#2204, \#2208).
_packages/at\client/lib/src/storage · medium confidence · unverified
10 commits (2 fixes) modifying packages/at\_client\_flutter/example/lib/snippets
A change to existing behaviour in packages/at\_client\_flutter/example/lib/snippets — 10 commits (2 fixs), 1 file: “chore: clear analyzer lint across the core packages and live packs”; “feat(at\_client\_flutter)!: dialogs and keychain over the lifecycle verbs”; “feat(at\_client\_flutter): introduce at\_backup\_key.dart in snippets”; and 7 more.
_packages/at\_client\flutter/example/lib/snippets · medium confidence · unverified
10 commits (2 fixes) modifying packages/at\_client\_flutter/example/todos
A change to existing behaviour in packages/at\_client\_flutter/example/todos — 10 commits (2 fixs), 134 files: “docs: Flutter and CLI READMEs fix export, onboarding and posture notes”; “chore(at\_client): the post-quantum APIs are no longer experimental”; “feat(examples): the todos and CLI examples run at pqActive”; and 7 more.
_packages/at\_client\flutter/example/todos · medium confidence · unverified
12 commits (1 fix) modifying packages/at\_client\_flutter/lib/src/lifecycle
A change to existing behaviour in packages/at\_client\_flutter/lib/src/lifecycle — 12 commits (1 fix), 1 file: “chore(at\_client\_flutter): format atsign\_flows.dart as CI's gate wants”; “feat(at\_client\_flutter)!: dialogs and keychain over the lifecycle verbs”; “feat(at\_client\_flutter): dialogs keep a pending enrollment until Cancel”; and 9 more.
_packages/at\_client\flutter/lib/src/lifecycle · medium confidence · unverified
14 commits (2 fixes) modifying tools
A change to existing behaviour in tools — 14 commits (2 fixs), 14 files: “feat(wasm\_shakedown): add wasm regression tests and compile gates for at\_chops (\#2149)”; “feat(at\_chops): 4.0.0 break, not included in root workspace(\#2099)”; “fix(wasm\_shakedown): the positive control cannot be the barrel being cleaned”; and 11 more (refs \#2149, \#2099, \#2183).
tools · medium confidence · unverified
17 commits (0 fixes) modifying packages/at\_client\_cli/lib/src
A change to existing behaviour in packages/at\_client\_cli/lib/src — 17 commits, 2 files: “refactor(at\_client\_cli)!: CLIBase takes no downloadDir”; “docs(at\_client\_cli,at\_lookup): every public class has a dartdoc”; “feat(at\_client\_cli): at\_onboarding\_cli and at\_cli\_commons as one package”; and 14 more (refs \#2415).
_packages/at\_client\cli/lib/src · medium confidence · unverified
17 commits (2 fixes) modifying features/at\_auth
A change to existing behaviour in features/at\_auth — 17 commits (2 fixs), 3 files: “docs: scenario for a keyfile rewritten by root”; “docs: scenarios for keyfiles the previous published at\_auth wrote”; “docs: scenarios for the narrowing log and a link at the temporary path”; and 14 more (refs \#2397).
_features/at\auth · medium confidence · unverified
17 commits (6 fixes) modifying packages/at\_client\_cli/lib/src/commands
A change to existing behaviour in packages/at\_client\_cli/lib/src/commands — 17 commits (6 fixs), 5 files: “chore(at\_client): the post-quantum APIs are no longer experimental”; “docs(at\_client\_cli,at\_lookup): every public class has a dartdoc”; “feat(at\_client\_cli): at\_onboarding\_cli and at\_cli\_commons as one package”; and 14 more (refs \#2415).
_packages/at\_client\cli/lib/src/commands · medium confidence · unverified
18 commits (6 fixes) modifying packages/at\_client\_flutter/example/invitations
A change to existing behaviour in packages/at\_client\_flutter/example/invitations — 18 commits (6 fixs), 109 files: “fix(at\_client\_flutter): a contact takes the name its invitee gave”; “style(at\_client\_flutter): format the invitations example as CI does”; “feat(at\_client\_flutter): invitations example app, issuer and EE scripts”; and 15 more.
_packages/at\_client\flutter/example/invitations · medium confidence · unverified
2 commits (1 fix) modifying features/at\_chops
A change to existing behaviour in features/at\_chops — 2 commits (1 fix), 1 file: “feat(at\_chops): newSeed on AtSeededSignatureAlgorithm; correct FFI seed-copy wording”; “fix(at\_chops): address review on seeded ML-DSA-65 keygen”.
_features/at\chops · medium confidence · unverified
25 commits (6 fixes) modifying packages/at\_policy
A change to existing behaviour in packages/at\_policy — 25 commits (6 fixs), 21 files: “docs: at\_policy CHANGELOG.md”; “feat(at\_client\_cli): at\_onboarding\_cli and at\_cli\_commons as one package”; “chore(at\_client): renumber to 4.0.0”; and 22 more.
_packages/at\policy · medium confidence · unverified
263 commits (94 fixes) modifying packages/at\_lookup
A change to existing behaviour in packages/at\_lookup — 263 commits (94 fixs), 91 files: “feat(at\_lookup): assert the 'from:' challenge format”; “docs(at\_client\_cli,at\_lookup): every public class has a dartdoc”; “test: Add a \@visibleForTesting Duration? delayBeforeClose;\ variable to OutboundMessageListener to allow us to inject a pause before actually closing a connection. In turn makes it possible to reliably reproduce race conditions (if they exist) related to program code trying to write to a connection which should be closed but has not yet been marked as closed for whatever reason”; and 255 more (refs \#2396, \#2174, \#2415, \#1923, \#1909, …).
_packages/at\lookup · medium confidence · unverified
3 commits (0 fixes) modifying packages/at\_client\_flutter/example/android, packages/at\_client\_flutter/example/web
A change to existing behaviour in packages/at\_client\_flutter/example/android, packages/at\_client\_flutter/example/web — 3 commits, 22 files: “feat(at\_client\_flutter): example”; “chore: remove example from this PR”; “feat(at\_client\_flutter): example app for widgets”.
_packages/at\_client\_flutter/example/android, packages/at\_client\flutter/example/web · medium confidence · unverified
3 commits (1 fix) modifying packages/at\_client/lib/src/storage/memory
A change to existing behaviour in packages/at\_client/lib/src/storage/memory — 3 commits (1 fix), 3 files: “feat(at\_client): InMemoryAtClientStorage is pure Dart”; “fix(at\_client): a closed memory keystore refuses every operation”; “refactor(at\_client)!: each storage backend comes from its own barrel”.
_packages/at\client/lib/src/storage/memory · medium confidence · unverified
4 commits (0 fixes) modifying packages/at\_chops/benchmark
A change to existing behaviour in packages/at\_chops/benchmark — 4 commits, 2 files: “build(at\_chops): 3.7.1 in the workspace, in place of 4.0.0-rc.1”; “feat(at\_chops): 4.0.0 break, not included in root workspace(\#2099)”; “test(at\_chops): interleave and repeat the throughput samples”; and 1 more (refs \#2099).
_packages/at\chops/benchmark · medium confidence · unverified
4 commits (0 fixes) modifying packages/at\_cli\_commons/lib
A change to existing behaviour in packages/at\_cli\_commons/lib — 4 commits, 1 file: “feat(at\_client\_cli): at\_onboarding\_cli and at\_cli\_commons as one package”; “fix: cleaned up all of the lint in the non-flutter packages”; “refactor: some code reorganization feat: use the new default logging handler feature in AtSignLogger to direct all log output to stdErr”; and 1 more.
_packages/at\_cli\commons/lib · medium confidence · unverified
4 commits (0 fixes) modifying packages/at\_location\_flutter/lib/common\_components
A change to existing behaviour in packages/at\_location\_flutter/lib/common\_components — 4 commits, 22 files: “fix: lint warnings and errors”; “feat: improve pub score”; “refactor: move packages to packages dir, remove files that should be gitignored”; and 1 more.
_packages/at\_location\_flutter/lib/common\components · medium confidence · unverified
4 commits (1 fix) modifying packages/at\_location\_flutter/lib/screens
A change to existing behaviour in packages/at\_location\_flutter/lib/screens — 4 commits (1 fix), 5 files: “fix: the legacy Flutter packages import at\_lookup.dart again”; “breaking(at\_lookup): the atDirectory lookup moves behind at\_lookup\_io.dart”; “feat: improve pub score”; and 1 more.
_packages/at\_location\flutter/lib/screens · medium confidence · unverified
40 commits (6 fixes) modifying packages/at\_client\_cli
A change to existing behaviour in packages/at\_client\_cli — 40 commits (6 fixs), 10 files: “refactor(at\_client\_cli)!: CLIBase takes no downloadDir”; “docs: Flutter and CLI READMEs fix export, onboarding and posture notes”; “feat(at\_client\_cli): at\_onboarding\_cli and at\_cli\_commons as one package”; and 37 more (refs \#2423, \#2415).
_packages/at\_client\cli · medium confidence · unverified
48 commits (15 fixes) modifying packages/at\_client\_flutter/example/lib
A change to existing behaviour in packages/at\_client\_flutter/example/lib — 48 commits (15 fixs), 3 files: “fix(at\_client\_flutter): prevent dialogs form hanging and improve api key error handling (\#1923)”; “chore: clear analyzer lint across the core packages and live packs”; “feat(at\_client\_flutter): add an onboard with atKeys file button”; and 43 more (refs \#1923, \#1754, \#2083).
_packages/at\_client\flutter/example/lib · medium confidence · unverified
5 commits (0 fixes) modifying packages/at\_client\_cli/example/bin
A change to existing behaviour in packages/at\_client\_cli/example/bin — 5 commits, 8 files: “feat(at\_client\_cli): at\_onboarding\_cli and at\_cli\_commons as one package”; “feat(at\_client\_cli)!: remove the -d and --hashingAlgoType arguments”; “feat(at\_client\_cli)!: the adapter ends; CliKeys holds keys and store”; and 2 more.
_packages/at\_client\cli/example/bin · medium confidence · unverified
5 commits (0 fixes) modifying packages/at\_client\_flutter/example/ios
A change to existing behaviour in packages/at\_client\_flutter/example/ios — 5 commits, 39 files: “feat(at\_client\_flutter): example”; “build: update build specific files to be compatible with flutter 3.29+”; “chore: remove example from this PR”; and 2 more.
_packages/at\_client\flutter/example/ios · medium confidence · unverified
5 commits (0 fixes) modifying packages/at\_location\_flutter/lib
A change to existing behaviour in packages/at\_location\_flutter/lib — 5 commits, 3 files: “feat: improve pub score”; “refactor: move packages to packages dir, remove files that should be gitignored”; “chore: dangling doc comment resolved”; and 1 more.
_packages/at\_location\flutter/lib · medium confidence · unverified
5 commits (2 fixes) modifying packages/at\_client\_cli/lib/src/keys
A change to existing behaviour in packages/at\_client\_cli/lib/src/keys — 5 commits (2 fixs), 1 file: “feat(at\_client\_cli): CliKeys' default store is the one CLIBase opens”; “feat(at\_client\_cli)!: the adapter ends; CliKeys holds keys and store”; “fix(at\_client\_cli): CliKeys.storageFor defaults to the home directory”; and 2 more.
_packages/at\_client\cli/lib/src/keys · medium confidence · unverified
5 commits (2 fixes) modifying packages/at\_location\_flutter/lib/service
A change to existing behaviour in packages/at\_location\_flutter/lib/service — 5 commits (2 fixs), 14 files: “fix: Lint issues in the following packages: at\_inivitation\_flutter, at\_theme\_flutter, at\_onboarding\_flutter, at\_login\_flutter”; “feat: improve pub score”; “refactor: move packages to packages dir, remove files that should be gitignored”; and 1 more.
_packages/at\_location\flutter/lib/service · medium confidence · unverified
51 commits (10 fixes) modifying packages/at\_utils
A change to existing behaviour in packages/at\_utils — 51 commits (10 fixs), 19 files: “perf: AtSignLogger copies unescaped text in runs”; “docs: added docs for ProgressPublisher refactor: changed ProgressEventType.failure to ProgressEventType.error”; “chore: publish at\_utils for at\_commons 5.0.0 uptake”; and 46 more (refs \#480).
_packages/at\utils · medium confidence · unverified
58 commits (15 fixes) modifying packages/at\_client/lib/src/lifecycle
A change to existing behaviour in packages/at\_client/lib/src/lifecycle — 58 commits (15 fixs), 5 files: “chore(at\_client): the post-quantum APIs are no longer experimental”; “feat(at\_client): open a client from its keys, reporting its connection”; “chore: clear analyzer lint across the core packages and live packs”; and 55 more.
_packages/at\client/lib/src/lifecycle · medium confidence · unverified
6 commits (0 fixes) modifying packages/at\_location\_flutter/lib/map\_content
A change to existing behaviour in packages/at\_location\_flutter/lib/map\_content — 6 commits, 47 files: “fix: lint warnings and errors”; “feat: uplift at\_location\_flutter to Flutter 3.10”; “feat: improve pub score”; and 2 more.
_packages/at\_location\_flutter/lib/map\content · medium confidence · unverified
62 commits (19 fixes) modifying packages/at\_client/lib/src/enroll
A change to existing behaviour in packages/at\_client/lib/src/enroll — 62 commits (19 fixs), 10 files: “chore(at\_client): the post-quantum APIs are no longer experimental”; “refactor(at\_client,at\_onboarding\_cli): hand at\_auth the muxable lookup”; “fix(at\_client): add self\_retrofit.dart, which 677fd4374 exported but never staged”; and 59 more.
_packages/at\client/lib/src/enroll · medium confidence · unverified
67 commits (10 fixes) modifying packages/at\_client\_skills
A change to existing behaviour in packages/at\_client\_skills — 67 commits (10 fixs), 7 files: “docs(at\_client\_skills): the skill's samples work at pqActive”; “docs: skills and knowledge docs take locks with the server mutex”; “chore: release 1.2.0 of at\_client\_skills”; and 64 more.
_packages/at\_client\skills · medium confidence · unverified
7 commits (0 fixes) modifying packages/at\_client\_cli/lib/src/util
A change to existing behaviour in packages/at\_client\_cli/lib/src/util — 7 commits, 5 files: “docs(at\_client\_cli,at\_lookup): every public class has a dartdoc”; “feat(at\_lookup)!: lookups take no clientConfig”; “feat(at\_client\_cli): at\_onboarding\_cli and at\_cli\_commons as one package”; and 4 more.
_packages/at\_client\cli/lib/src/util · medium confidence · unverified
7 commits (0 fixes) modifying packages/at\_client\_flutter/example/linux, packages/at\_client\_flutter/example/windows
A change to existing behaviour in packages/at\_client\_flutter/example/linux, packages/at\_client\_flutter/example/windows — 7 commits, 28 files: “feat(at\_client\_flutter): example”; “feat(at\_client\_flutter): at\_invitation\_flutter.dart.dart snippet”; “refactor(at\_client\_flutter): package updates”; and 4 more.
_packages/at\_client\_flutter/example/linux, packages/at\_client\flutter/example/windows · medium confidence · unverified
7 commits (1 fix) modifying packages/at\_client/example/lib
A change to existing behaviour in packages/at\_client/example/lib — 7 commits (1 fix), 12 files: “feat(at\_client\_cli): at\_onboarding\_cli and at\_cli\_commons as one package”; “feat(examples): the todos and CLI examples run at pqActive”; “fix(at\_client): example senders wait for the receiver's namespace key”; and 4 more.
_packages/at\client/example/lib · medium confidence · unverified
7 commits (1 fix) modifying packages/at\_client\_flutter/example/macos
A change to existing behaviour in packages/at\_client\_flutter/example/macos — 7 commits (1 fix), 28 files: “feat(at\_client\_flutter): example”; “feat(at\_client\_flutter): at\_invitation\_flutter.dart.dart snippet”; “chore(at\_client\_flutter): the example's backup snippet compiles”; and 4 more.
_packages/at\_client\flutter/example/macos · medium confidence · unverified
8 commits (0 fixes) modifying packages/at\_client\_flutter/example
A change to existing behaviour in packages/at\_client\_flutter/example — 8 commits, 4 files: “feat(at\_client\_flutter): example”; “feat(at\_client\_flutter): at\_invitation\_flutter.dart.dart snippet”; “docs: point at\_invitation\_flutter's replacement at AtClientInvitations”; and 5 more.
_packages/at\_client\flutter/example · medium confidence · unverified
8 commits (1 fix) modifying packages/at\_client\_flutter/example/dockerstats
A change to existing behaviour in packages/at\_client\_flutter/example/dockerstats — 8 commits (1 fix), 129 files: “chore(at\_client): the post-quantum APIs are no longer experimental”; “chore(at\_client\_flutter): examples drop imports the package exports”; “fix(at\_client\_flutter): HiveAtClientStorage comes through this package”; and 5 more.
_packages/at\_client\flutter/example/dockerstats · medium confidence · unverified
Added macOS Runner configuration for .atkeys file support
The macOS example app now includes the necessary native configuration files to properly handle onboarding via .atkeys files. This change adds the AppDelegate, window controller, and interface builder files required for the macOS platform, along with an updated Info.plist that registers the .atkeys extension as a recognized file type (UTTypeIdentifier com.atsign.atkeys). This ensures the application can correctly open and process cryptographic key files during the setup process.
_packages/at\_location\flutter/example/macos/Runner · high confidence
Android example app scaffolded with Android 12 compatibility and V2 embedding
The Android example project for at\_chat\_flutter has been initialized with the standard Flutter V2 embedding structure. This includes a MainActivity extending FlutterActivity, splash screen resources, and theme definitions for light and dark modes. Crucially, the main AndroidManifest.xml now sets android:exported="true" on the launcher activity to satisfy Android 12 (API level 31+) requirements, ensuring the app can be launched correctly on modern devices. Debug and profile manifests include the necessary INTERNET permission for development workflows.
_packages/at\_chat\flutter/example/android · high confidence
Approver apps and CLI now display enrollment expiry details
Approver applications and the at\_activate CLI now expose both the key expiry duration requested by the client (apkamKeysExpiryDuration) and the actual expiration time recorded by the server (expiresAt). This allows approvers to see when an enrollment will expire before deciding to approve, and ensures the approval command returns the enrollment exactly as the server holds it, including the final term. The at\_activate list and fetch commands now print these expiry details, and the approve/auto\_approve commands print the expiration time or indicate if the enrollment has been revoked or lacks an expiry date.
features/enrollment · high confidence
AtSignLogger escapes control and bidirectional characters in logged messages
The AtSignLogger now sanitizes log messages and logger names by converting control characters (C0, DEL, C1), bidirectional formatting characters, and line/paragraph separators into visible escape sequences (e.g., \\\r\, \\\x1b\, \\\u202e\) before passing them to the LoggingHandler. This prevents terminal forgery, cursor manipulation, and line reordering attacks when logging untrusted input, while preserving LF characters (followed by two spaces for indentation) and leaving emojis, backslashes, and stack traces unchanged. The escaping is applied per-record before the handler is called, ensuring that even if a message originates from an external zone or contains malicious formatting, the handler receives a safe, printable string.
features/logging · high confidence
Centralized network timeout policy with distinct budgets for operations and responses
The SDK now enforces a unified network timeout strategy via the new \AtNetworkTimeouts\ class, which caps any single network operation (such as connecting to an atServer or waiting for response bytes) at a maximum of 60 seconds, with a default of 30 seconds. This policy introduces separate, uncapped budgets for specific scenarios: a 5-minute timeout for the onboarding provisioning poll and a 90-second budget for the total duration of a single server response, ensuring that long-running or multi-chunk operations are not prematurely terminated by the per-operation cap. Additionally, \SecureSocketConfig\ now exposes a \connectTimeout\ setting that integrates with this central policy, allowing callers to specify a custom connection timeout that is automatically clamped to the defined maximum.
_packages/at\commons/lib/src/security · high confidence
Deprecate APKAM authentication mode
The \apkam\ value in the \PkamAuthMode\ enum has been marked as deprecated and is no longer used. Users relying on this specific authentication mode should migrate to the supported \keysFile\ or \sim\ modes.
_packages/at\commons/lib/src/auth · high confidence
Deprecated compatibility API for cryptographic operations
The \AtChops\ base class and \AtChopsImpl\ implementation are now marked as deprecated, signaling that users should migrate to using the new algorithm classes directly for encryption, decryption, signing, and verification. This change introduces a cleaner, more modular design where specific algorithms (such as AES, RSA, ECC, and various hashing methods like SHA256/SHA512/Argon2id via \AtHashingAlgorithmFactory\) are instantiated and used explicitly, rather than through the legacy abstract interface. The \AtKeysCrypto\ class for passphrase-protected key encryption is also deprecated and slated for removal or relocation to the \at\_auth\ package. Existing code using \AtChops\ or \AtChopsImpl\ will continue to function but will trigger deprecation warnings, with the compatibility API scheduled for removal in the next major release.
_packages/at\chops/lib/src · high confidence
Deprecated utility class for legacy key generation and IV helpers
The \AtChopsUtil\ class in \packages/at\_chops/lib/src/util\ is now marked as deprecated and will be removed in the next major release. This utility previously provided static methods for generating initialization vectors (including legacy and base64-based variants) and various key pairs (RSA, EC, Ed25519, X25519, ML-KEM-768, X-Wing, ML-DSA-65, and AES). Users should migrate to using the static \generate\ methods on the specific key classes directly (e.g., \AtEncryptionKeyPair.create\, \AtMlKem768KeyPair.create\) and the algorithm classes for cryptographic operations, as indicated by the deprecation notice.
_packages/at\chops/lib/src/util · high confidence
Deprecation of legacy signing and encryption metadata/result classes
The \at\_chops\ library has deprecated its legacy compatibility API for data signing and encryption. New files in the metadata directory (\at\_signing\_input.dart\, \signing\_metadata.dart\, \signing\_result.dart\, \encryption\_metadata.dart\, \encryption\_result.dart\) introduce classes like \AtSigningInput\, \AtSigningResult\, and \AtEncryptionResult\, but mark them with \@Deprecated\ annotations. Users are now instructed to call \AtSigningAlgorithm\ implementations directly and handle result bytes and metadata themselves, as these compatibility wrappers will be removed in the next major release.
_packages/at\chops/lib/src/metadata · high confidence
Enrollment logic refactored into dedicated collaborators with post-quantum support
The enrollment workflow in \at\_auth\ has been restructured from a monolithic implementation into distinct collaborators: \EnrollmentSubmitter\ handles key minting and request submission, \EnrollmentApprover\ manages approval and denial decisions, and \EnrollmentHandshake\ waits for approval and collects the resulting keys. This change introduces support for post-quantum cryptography (PQC) by allowing enrollments to advertise signing keys (including \mldsa65\) via a structured \\_apsk\ format, enabling key rotation and status tracking (\active\/\retired\). The approval process now explicitly handles key material separation, and the handshake ensures secure decryption of encryption and self-encryption keys using the approved APKAM symmetric key.
_packages/at\auth/lib/src/enroll · high confidence
Example app configuration and documentation updates
The example application for the at\_events\_flutter package has been updated with new configuration files and documentation. A .env file is now included to define the ROOT\_DOMAIN, and a .gitignore file has been added to exclude build artifacts and IDE-specific files from version control. Additionally, the project now includes an analysis\_options.yaml file to enforce standard Flutter linting rules, and the README and EXAMPLE documentation files have been refreshed to guide users through setup and usage.
_packages/at\_events\flutter/example · high confidence
Example app now supports Android and macOS platforms
The \at\_location\_flutter\ example application has been updated to run on Android and macOS. This change adds the necessary Android project structure, including \AndroidManifest.xml\ with location permissions (\ACCESS\_FINE\_LOCATION\, \ACCESS\_COARSE\_LOCATION\), a Kotlin \MainActivity\, and Gradle configuration. It also adds the macOS Xcode project files (\Runner.xcodeproj\), including the \Info.plist\, \AppDelegate.swift\, and build schemes, enabling developers to test the package on these additional platforms.
_packages/at\_location\_flutter/example/android, packages/at\_location\flutter/example/macos/Runner.xcodeproj · high confidence
Example project scaffolding and configuration updates
The at\_chat\_flutter example application has been restructured with the addition of a .gitignore file to exclude build artifacts and local configuration, a .metadata file tracking the Flutter stable channel, and an analysis\_options.yaml file enforcing standard Flutter lints. The README.md has also been updated to reflect the current package documentation and usage instructions.
_packages/at\_chat\flutter/example · high confidence
Hive storage now manages sync queue lifecycles and migrates stray queues from previous versions
The Hive-based client storage implementation has been refactored to strictly manage the lifecycle of the sync queue alongside the keystore. It now enforces that only one client instance can hold a specific storage path or sync queue box at a time, preventing data corruption from concurrent access. Additionally, upon opening, the storage automatically detects and adopts 'stray' sync queue boxes left behind by earlier releases in other directories, migrating pending writes to the current store to ensure no sync data is lost during upgrades or path changes.
_packages/at\client/lib/src/storage/hive · high confidence
Introduces algorithm type enums and stateless signing interfaces
The library now defines explicit enums for signing and hashing algorithms, including a \SigningAlgoType\ that establishes a verifier preference order (strongest first) and a \HashingAlgoType\ for algorithm identification. A new stateless \AtSignatureAlgorithm\ interface replaces the legacy, stateful \AtSigningAlgorithm\ by requiring key material to be passed per call, which improves thread safety and singleton usage. Additionally, a \KemSeedMixin\ standardizes seed handling for Key Encapsulation Mechanisms, and deprecated wrappers for legacy signing and hashing defaults are provided for backward compatibility.
_packages/at\chops/lib/src/algorithm · high confidence
Introduces enrollment status tracking and server-side key management constants
The at\_commons library now includes an EnrollmentStatus enum with a new 'expired' state alongside pending, approved, denied, and revoked, allowing systems to track the full lifecycle of an enrollment. Additionally, new EnrollmentConstants define server-side-only regex patterns for managing enrollment records, private encryption keys (PEK), and self-encryption keys (SEK), ensuring these sensitive identifiers are never synced to clients. A 'primary' enrollment ID is also established for an atSign's own credential, which is kept off the wire to simplify authentication.
_packages/at\commons/lib/src/enroll · high confidence
Introduction of granular AtKeys exception types
The at\_auth package now exposes a dedicated set of exceptions for handling AtKeys operations, replacing generic error handling with specific types such as AtKeysFileOverwriteException, AtKeysParseException, and AtKeysValidationException. A key addition is AtKeysSourceAbsentException (and its subclass AtKeysNotInMemoryException), which allows callers to distinguish between a key source that is genuinely empty (a cold start) and one that is unreadable due to corruption or missing passphrases, preventing silent failures in scenarios like notification park filing.
_packages/at\auth/lib/src/exception · high confidence
Keychain storage migrates to colon-delimited store names and supports multiple SPPs
The Flutter keychain implementation now uses a colon (\:\) delimiter in store names (e.g., \@atsigns:packageName\) instead of the legacy underscore (\\_\) format. Existing data stored with the underscore delimiter is automatically migrated to the new colon-delimited store on read, while the legacy store remains in place for backward compatibility until version 3.0.0. Additionally, the keychain now supports storing multiple Single-Passcode (SPP) entries per atSign via the new \SppListData\ structure, replacing the previous single-SPP limitation.
_packages/at\_client\flutter/lib/src/keychain · high confidence
Keyfile serialization refactored with typed vocabularies and passphrase salting
The keyfile serialization logic has been restructured to use strongly-typed extension types for cryptographic algorithms, roles, and material status, replacing previous string-based or enum-based approaches to ensure forward compatibility and prevent silent failures on unknown values. A new assurance module enforces structural invariants, such as rejecting keyfiles with duplicate active keys within an enrollment while tolerating multiple live enrollments for backward compatibility. Additionally, the passphrase envelope now uses a random salt for Argon2id key derivation (version 1), fixing a security weakness in the legacy unsalted derivation, while maintaining support for reading older, unsalted files.
_packages/at\auth/lib/src/keys/serialization · high confidence
Legacy encryption and decryption logic is extracted into a dedicated provider
The at\_client now isolates its pre-pluggable, legacy encryption scheme into a new \LegacyCryptoProvider\ within the \crypto/legacy\ directory. This change introduces dedicated \LegacyEncryption\ and \LegacyDecryption\ classes that handle self-encryption, shared-key encryption, and decryption for keys shared by or with other users. By wrapping these legacy algorithms in a standard \CryptoProvider\ interface, the client ensures that data stamped with the legacy provider ID is correctly routed to these specific decryption paths, maintaining compatibility with older encrypted records while cleaning up the internal crypto architecture.
_packages/at\client/lib/src/crypto/legacy · high confidence
Major refactoring of client services and introduction of new enrollment and encryption services
The service layer in \packages/at\_client/lib/src/service\ has been significantly restructured. New abstract interfaces and implementations have been added for \EnrollmentService\ and \EncryptionService\, introducing new mechanisms for managing device enrollments and handling encryption keys. The \NotificationService\ and \SyncService\ interfaces have been updated to expose more granular state and progress information, such as \SyncProgress\ events and listener states. Additionally, the \FileTransferService\ has been deprecated as file sharing functionality moves to the application layer. These changes represent a shift towards a more modular and testable service architecture, with improved handling of cryptographic operations and synchronization states.
_packages/at\client/lib/src/service · high confidence
Migrated event screens to Dart 3
The event creation and management screens in the \at\_events\_flutter\ package have been migrated to Dart 3. This update ensures compatibility with the latest Dart language version and resolves associated lint warnings and formatting issues across the event UI components.
_packages/at\_events\flutter/lib/screens · medium confidence
New keystore key model and public key hashing support
The keystore module now uses a redesigned \AtKey\ class with explicit \sharedBy\ (owner) and \sharedWith\ (recipient) properties, replacing the previous implicit key-string parsing logic. This change introduces dedicated builder classes (\PublicKeyBuilder\, \SharedKeyBuilder\, \SelfKeyBuilder\, \LocalKeyBuilder\) to construct keys with clear semantics for public, shared, self, and local storage types. Additionally, a new \PublicKeyHash\ class is added to represent hashed public keys along with the hashing algorithm used, supporting the migration from MD5 to SHA-512 as indicated by the commit history and new hashing constants.
_packages/at\commons/lib/src/keystore · high confidence
New library entry points and collection API consolidation
The at\_client package now exposes three new library entry points: \at\_client.dart\ (the main barrel), \at\_client\_mixins.dart\ (for signing, enrollment, and invitation mixins), and \sqlite.dart\ (SQLite-backed storage, kept separate to avoid pulling in SQLite dependencies by default). Additionally, the legacy \AtCollection\ APIs are now marked as deprecated in favor of the new \AtClient.collection\ interface, guiding users toward the updated collection-style operations.
_packages/at\client/lib · high confidence
New persisted sync queue implementation with storage-path isolation
The sync subsystem now uses a dedicated \AtSyncQueue\ backed by a Hive box to persist pending client-to-server writes. This queue ensures that operations are correctly ordered by replaying persisted entries in timestamp order on startup and uses a monotonic sequence counter to handle rapid updates and deletes of the same key. Crucially, the queue is now isolated per storage path, allowing multiple clients for the same atSign in a single process to maintain separate queues without interfering with each other, resolving previous issues where different storage paths shared a single global queue.
_packages/at\client/lib/src/sync · high confidence
New post-quantum and symmetric key implementations with deprecated compatibility wrappers
The library now includes new key-pair implementations for post-quantum algorithms (ML-DSA-65, ML-KEM-768, X25519, and X-Wing) and symmetric encryption (AES), replacing the previous generic key structures with algorithm-specific classes. To support existing code during this transition, deprecated compatibility wrappers (such as AtEncryptionKeyPair, AtSigningKeyPair, and AtChopsKeys) are provided but marked for removal in the next major release, encouraging users to migrate to the new specific key classes and direct key material passing.
_packages/at\chops/lib/src/key/impl · high confidence
New registrar service for atSign generation and person registration
The registrar module has been replaced with a new v4 API implementation that handles atSign lifecycle operations. This includes generating free atSigns (randomly or by category), registering persons via email with OTP validation, and activating atSigns. The service uses a standard HTTP client by default for WASM compatibility, but supports a custom \dart:io\ client to allow ignoring bad certificates when needed (primarily for testing). API key validation is now enforced at initialization, and authentication failures return specific exceptions.
_packages/at\auth/lib/src/registrar · high confidence
New response parsing and notification model classes
The at\_client library introduces a new set of classes in the response package to handle server communication and notification data. This includes the AtNotification model, which now supports parsing the shared public key hash from metadata, and the Enrollment model, which exposes namespace permissions and enrollment status. Additionally, a new DefaultResponseParser and NotificationResponseParser are added to standardize how data and error prefixes are stripped from server responses and how notification lists are decoded, replacing previous ad-hoc parsing logic.
_packages/at\client/lib/src/response · high confidence
New typed authentication request, response, and session models
The at\_auth package introduces a new set of typed models for the authentication lifecycle: \AuthRequest\ and \AtOnboardingRequest\ define the inputs for activation, including specific signing algorithms, legacy material opt-outs, and key I/O sources; \AtOnboardingResponse\ and \AuthResponse\ represent the outcomes, explicitly carrying the resulting \AtAuthSession\; and \AtAuthSession\ serves as the typed hand-off containing the atSign, root domain, key source, and enrollment ID. Additionally, \RetryOptions\ provides configurable retry logic with distinct timeout behaviors for onboarding versus authentication. These changes replace previous ad-hoc or less structured approaches with a clear, type-safe contract for onboarding and session management.
_packages/at\auth/lib/src/auth/models · high confidence
New typed key management model with enrollment-scoped access
The \AtKeys\ class in \at\_auth\ has been replaced with a new in-memory model that organizes cryptographic material by enrollment rather than a flat list. Key identity is now defined by the combination of \enrollmentId\ and \keyId\, allowing multiple enrollments to hold keys with the same identifier without conflict. The model distinguishes between an atSign's own keys (like the signing root) and keys belonging to specific enrollments, providing typed accessors for both. It also introduces \AtKeysEnrollment\ to store metadata such as namespaces, app name, and device name, which are reconciled from the enrollment record. This change supports reading keyfiles with multiple live enrollments and ensures that key lookups are explicit about their scope.
_packages/at\auth/lib/src/keys · high confidence
Post-quantum crypto readiness and configurable legacy fallback
The SDK now supports a post-quantum-ready encryption posture, allowing clients to read post-quantum records while continuing to write with legacy encryption during migration. A new \disallowLegacyEncryption\ preference lets applications refuse to write data using legacy schemes, throwing a \LegacyEncryptionRefusedException\ if a destination cannot be reached securely under a post-quantum algorithm. The crypto configuration is now managed via \CryptoConfig\, which supports pluggable providers and namespace key (nskey) rotation policies, while \CryptoRuntime\ centralizes the write path logic to ensure consistent provider selection and readiness checks across \put\ and \notify\ operations.
_packages/at\client/lib/src/crypto · high confidence
Post-quantum enrollment support and explicit signing algorithm selection
The enrollment models now support post-quantum cryptography by introducing a new key exchange mode where the approver generates and conveys the symmetric key via a key package, removing the RSA-wrapping step that is vulnerable to quantum adversaries. Additionally, apps enrolling over OTP can now explicitly specify the signing algorithm for their APKAM authentication keypair, preventing the creation of legacy RSA credentials on post-quantum deployments. The models also introduce a mechanism for callers to contribute signed metadata during enrollment and provide JSON serialization for enrollment responses.
_packages/at\auth/lib/src/enroll/models · high confidence
Post-quantum readiness controlled via a unified PqPosture in AtClientPreference
The \AtClientPreference\ class now uses a single \PqPosture\ parameter to configure the client's post-quantum capabilities, replacing scattered flags. This posture determines the authentication and data-signing algorithms (e.g., ML-DSA-65 vs RSA-2048), whether post-quantum crypto providers are initialized, and if new data is encrypted using post-quantum keys by default. Three built-in postures are available: \legacy\ (classical only, default), \pqReady\ (post-quantum authentication and namespace keys, but legacy data encryption), and \pqActive\ (full post-quantum encryption and signing). The preference also exposes specific algorithm lists for sealing and key establishment, allowing apps to control which cryptographic standards are accepted or advertised.
_packages/at\client/lib/src/preference · high confidence
Refactored client lifecycle and connection management
The client manager now uses a new \AtClientManager\ singleton to hold the active \AtClient\ instance, replacing the deprecated \setCurrentAtSign\ method which is scheduled for removal in version 4.0. Switching atSigns now explicitly stops the outgoing client and recreates services, with idempotency checks to prevent race conditions when reusing the same atSign. The \Monitor\ class has been refactored to consume an \AtLookupMuxable\ connection instead of managing its own socket, simplifying connection handling and improving resilience against network interruptions. Additionally, a new \StorageManager\ class has been introduced to handle local persistence initialization, ensuring proper lifecycle management of the Hive storage bundle.
_packages/at\client/lib/src/manager · high confidence
Refactored exception hierarchy and added new error codes for enrollment and throttling
The exception handling in at\_commons has been restructured to support more granular error reporting. New exception classes have been introduced, including AtInvalidEnrollmentException, AtEnrollmentRevokeException, AtThrottleLimitExceeded, IllegalStateException, and StoppedException (for operations on stopped clients). Error codes have been mapped to these exceptions (e.g., AT0029 for expired enrollment, AT0028 for throttling, AT0032 for illegal state), and the AtExceptionUtils factory now routes these specific codes to their corresponding types. Additionally, client-side exceptions like InvalidPinException and CryptoProviderNotRegistered have been added to the AtClientException hierarchy.
_packages/at\commons/lib/src/exception · high confidence
Refactored key model with new key types and raw byte accessors
The key management API has been restructured to support a broader range of cryptographic algorithms and improved usability. New key types including RSA-4096, AES-256, X25519, and ML-KEM-768 are now explicitly defined in the key type enum, alongside updated key name constants for legacy and new keys. The core key classes have been consolidated into a sealed hierarchy (AbstractKey, SymmetricKey, AtPrivateKey, AtPublicKey, and AsymmetricKeyPair), providing a unified structure for all key representations. Additionally, a new RawKeyPairBytes mixin has been introduced to allow direct access to raw public and private key bytes for post-quantum and X25519 key pairs, simplifying operations that require raw byte manipulation.
_packages/at\chops/lib/src/key · high confidence
Refactored request transformers to use CryptoRuntime and support encryption options
The request transformers for GET, PUT, and NOTIFY operations have been rewritten to integrate with the new CryptoRuntime. PUT requests now support explicit encryption options via PutRequestOptions, allowing users to control whether data is encrypted and which crypto provider is used, while public keys are signed instead of encrypted. NOTIFY requests now route through the crypto provider to handle namespace resolution and encryption metadata stamping, with a fallback to legacy encryption if a key is unavailable. GET requests have been updated to use the LookUpBuilderManager with explicit request options. These changes ensure consistent encryption handling and better support for namespace-aware keys across all write and read operations.
_packages/at\_client/lib/src/transformer/request\transformer · high confidence
Restructured public API and added PKCS7 padding support
The at\_chops package has been refactored to provide a cleaner public surface. The main barrel (at\_chops.dart) now explicitly exports algorithm interfaces, key implementations, and metadata classes, while deliberately hiding internal RFC 9180 key-schedule details to preserve API stability. A new FFI barrel (at\_chops\_ffi.dart) exposes OpenSSL-backed algorithms and the AtPqc module for non-web environments. Additionally, a new PKCS7 padding implementation and its associated types have been added to support AES encryption block alignment, and the legacy AtEncrypted model is now marked as deprecated in favor of application-specific payload models.
_packages/at\chops/lib · high confidence
Telemetry classes marked for removal in at\_commons 6.0.0
The telemetry service classes in at\_commons (AtTelemetryService, AtTelemetryItem, AtTelemetryEvent, and AtTelemetrySample) are now deprecated and will be removed in version 6.0.0. These classes are considered an unused prototype and are marked with @experimental and @Deprecated annotations. Users relying on these telemetry features should prepare for their removal in the next major version.
_packages/at\commons/lib/src/telemetry · high confidence
Updated iOS example app to support iOS 12+ and modern Flutter tooling
The iOS example project for at\_location\_flutter has been regenerated to align with Flutter 3.10 standards. The minimum deployment target is now iOS 12.0, and the app bundle includes the necessary configuration files (such as AppFrameworkInfo.plist and xcconfig files) to support CocoaPods integration and modern Xcode build settings. This ensures the example app builds correctly with current Flutter tooling and supports the required location permissions.
_packages/at\_location\flutter/example/ios · high confidence
Updated iOS example project scaffolding for Flutter 3.0.13
The iOS example project for at\_chat\_flutter has been regenerated to align with the at\_chat\_flutter 3.0.13 update. This includes a new .gitignore, updated Xcode project and workspace configurations, and a minimum iOS deployment target of 12.0. The example app's Info.plist now includes the \UIApplicationSupportsIndirectInputEvents\ key to support newer iOS input behaviors, and the AppDelegate has been updated to use the modern \@main\ entry point.
_packages/at\_chat\flutter/example/ios · high confidence
Updated macOS example to include new plugin registrations
The macOS example project now includes a regenerated \GeneratedPluginRegistrant.swift\ file that registers additional plugins, including \at\_file\_saver\, \at\_login\_flutter\, \biometric\_storage\, \device\_info\_plus\, \emoji\_picker\_flutter\, \file\_picker\, \flutter\_image\_compress\_macos\, \flutter\_local\_notifications\, \geolocator\_apple\, \package\_info\_plus\, \path\_provider\_foundation\, \share\_plus\, \shared\_preferences\_foundation\, \sqflite\_darwin\, \url\_launcher\_macos\, and \webview\_flutter\_wkwebview\. This ensures these plugins are properly initialized when the macOS example app runs.
_packages/at\_location\flutter/example/macos/Flutter · high confidence
at\_auth package split into WASM-compatible core and dart:io-specific barrel
The at\_auth package is now structured into two entry points to support WebAssembly (WASM) targets. The main \at\_auth.dart\ barrel exports the core authentication, enrollment, and key material logic that does not depend on \dart:io\, allowing WASM clients to authenticate. A new \at\_auth\_io.dart\ barrel exports platform-specific implementations requiring filesystem or socket access (such as \FileAtKeysIo\ and \fileRetrofitSerializer\), which must be explicitly imported by \dart:io\ applications. This separation ensures that WASM builds remain free of \dart:io\ dependencies while preserving full functionality for native environments.
_packages/at\auth/lib · high confidence
at\_onboarding\_cli 2.0.0-rc3: major API overhaul and post-quantum support
This release introduces breaking changes to the \AtOnboardingService\ API, moving core lifecycle verbs (\activate\, \enroll\, \resumeEnrollment\) to \Atsign\ and \PendingEnrollment\ in \at\_client\, while \at\_activate\ now requires an explicit command (e.g., \onboard\) instead of running it by default. It adds post-quantum cryptography support via \--posture\ flags (\legacy\, \pqReady\, \pqActive\) and \--key-exchange\ options, and enforces stricter security by routing crypto through \at\_chops\ and requiring \at\_client\ ^3.15.0-rc2 and \at\_auth\ ^4.0.0-rc3.
_packages/at\_onboarding\cli · high confidence
at\_sync\_ui\_flutter package deprecated in version 1.2.0
The \at\_sync\_ui\_flutter\ package has been deprecated, with version 1.2.0 serving as the final minor release. Existing APIs like \AtSyncUIService\ and sync progress widgets remain available for backward compatibility, but new Flutter applications should migrate to using \AtCollection\<T\>\ and \Query.watch()\ from the \at\_client\ package. The package documentation now includes migration guidance and examples demonstrating how to use collection streams for state management instead of foreground sync indicators. Also in this area: Example app configuration and documentation refreshed; Added macOS example app scaffolding; Added macOS platform support for the example app; Add AtSync UI Flutter package with Material and Cupertino sync indicators; Example app now supports custom sync indicators and theme toggling; and 2 more.
_packages/at\_sync\_ui\flutter · high confidence
at\_theme\_flutter package is deprecated
The at\_theme\_flutter package is now deprecated and no longer recommended for new Flutter apps. Users should migrate to using Material3 themes in the at\_client\_flutter package instead. This change affects the package's documentation and status, signaling that the theme selection functionality previously provided by at\_theme\_flutter is being consolidated into at\_client\_flutter.
_packages/at\_theme\flutter · high confidence
Fixes
15 commits (9 fixes) fixing features/at\_lookup
A fix in features/at\_lookup — 15 commits (9 fixs), 8 files: “fix(at\_lookup): a login serves only the authenticator that made it”; “fix(at\_lookup): a lost connection fails a verb with AT0004”; “fix(at\_lookup): reconnect after a transport closes unread”; and 12 more (refs \#2396).
_features/at\lookup · medium confidence · unverified
17 commits (9 fixes) fixing packages/at\_client\_cli/lib/src/register
A fix in packages/at\_client\_cli/lib/src/register — 17 commits (9 fixs), 7 files: “docs(at\_client\_cli,at\_lookup): every public class has a dartdoc”; “feat(at\_client\_cli): at\_onboarding\_cli and at\_cli\_commons as one package”; “fix(at\_client\_cli): at\_register exits with its activation's code”; and 14 more (refs \#2423, \#2415).
_packages/at\_client\cli/lib/src/register · medium confidence · unverified
23 commits (12 fixes) fixing features/at\_client\_cli
A fix in features/at\_client\_cli — 23 commits (12 fixs), 9 files: “docs(at\_client\_cli): specify confirmation after a refused confirmation”; “feat(at\_client\_cli): at\_onboarding\_cli and at\_cli\_commons as one package”; “fix(at\_client\_cli): at\_register exits with its activation's code”; and 20 more (refs \#2423).
_features/at\_client\cli · medium confidence · unverified
263 commits (135 fixes) fixing packages/at\_client/lib/src/crypto/nskey
A fix in packages/at\_client/lib/src/crypto/nskey — 263 commits (135 fixs), 21 files: “fix: keep each enrollment's content-key pointer in its own namespace”; “fix(at\_client): a mint lock refuses its own enrollment's other processes”; “fix(at\_client): publish a filed nskey generation, not a second one”; and 260 more (refs \#2382, \#2415).
_packages/at\client/lib/src/crypto/nskey · medium confidence · unverified
3 commits (2 fixes) fixing packages/at\_location\_flutter/lib/utils
A fix in packages/at\_location\_flutter/lib/utils — 3 commits (2 fixs), 5 files: “refactor: move packages to packages dir, remove files that should be gitignored”; “fix: fixed warnnings in at\_location\_flutter”.
_packages/at\_location\flutter/lib/utils · medium confidence · unverified
48 commits (25 fixes) fixing packages/at\_auth/lib/src/keys/io
A fix in packages/at\_auth/lib/src/keys/io — 48 commits (25 fixs), 6 files: “fix(at\_auth): report a failed keyfile call in a locale that is not UTF-8”; “docs(at\_auth): say the OS error read after a failed call is best effort”; “fix(at\_auth): reach the owner-only file calls through a conditional import”; and 45 more (refs \#2179, \#2195, \#2047, \#2397).
_packages/at\auth/lib/src/keys/io · medium confidence · unverified
6 commits (4 fixes) fixing packages/at\_client/lib/src/listener
A fix in packages/at\_client/lib/src/listener — 6 commits (4 fixs), 2 files: “fix: Added check to SwitchAtSignEvent constructor to prevent events being created when the atClients are the same debug: Added a logger to AtClientManager. Log INFO when switching atSigns refactor: Removed instance variable \_previousAtClient from AtClientManager. Instead, determine previousAtClient within the setCurrentAtSign method fix: Added duplicate check to AtClientManager.listenToAtSignChange fix: Changed \_currentAtClient from \late\ to being nullable to prevent uninitialized check in setCurrentAtSign fix: AtClientManager now calls \_notifyListeners before creating the new NotificationServiceImpl and SyncServiceImpl refactor: Removed static maps of instances in NotificationServiceImpl and SyncServiceImpl thus allowing some code simplification refactor: Simplified NotificationServiceImpl.listenToAtSignChange refactor: Simplified SyncServiceImpl.listenToAtSignChange, and added code to close the RemoteSecondary's AtLookUp's connection if there is one”; “chore: move at\_client and at\_client\_mobile to packages directory”; “refactor(at\_client): cut the barrel cycle — no src file imports a public barrel”; and 3 more.
_packages/at\client/lib/src/listener · medium confidence · unverified
76 commits (41 fixes) fixing features/at\_client
A fix in features/at\_client — 76 commits (41 fixs), 23 files: “docs: expiry sweep and allowAll in the CHANGELOG and AtRpc feature”; “fix(at\_client): a mint lock refuses its own enrollment's other processes”; “docs: what clients before at\_client 3.2.1 sent, and the get's costs”; and 73 more.
_features/at\client · medium confidence · unverified
9 commits (5 fixes) fixing features/at\_client\_flutter
A fix in features/at\_client\_flutter — 9 commits (5 fixs), 5 files: “feat(at\_client\_flutter): dialogs keep a pending enrollment until Cancel”; “feat(examples): the todos and CLI examples run at pqActive”; “fix(at\_client\_flutter): the todos example stops its client on logout”; and 6 more.
_features/at\_client\flutter · medium confidence · unverified
Example app now uses AtAuthService for onboarding
The at\_chat\_flutter example app has been updated to replace the previous AtClientService with AtAuthService for the onboarding flow. Users now authenticate via a new sequence involving AtSignSelectionDialog, KeychainAtKeysIo (or file picker fallback), and PkamDialog, with credentials stored in the device keychain. The app also includes screens for initiating one-to-one chats and group chats, and allows clearing paired atsigns.
_packages/at\_chat\flutter/example/lib · high confidence
New atKey validation implementation with specific length limits
The at\_commons package introduces a new implementation for validating atKeys, replacing previous logic. This change enforces strict key length limits, capping standard keys at 248 characters and cached keys at 255 characters. It also implements comprehensive validation for key format, ownership, and reserved entity checks to ensure keys adhere to the defined regex patterns and access control rules.
_packages/at\commons/lib/src/validators · high confidence
Test coverage
1 commit adding/updating tests in packages/at\_client\_flutter/example/test; 14 commits adding/updating tests in tests/pq\_matrix/scenario; 15 commits adding/updating tests in packages/at\_auth/test/test\_utils; 18 commits adding/updating tests in packages/at\_client/test/enroll; 19 commits adding/updating tests in packages/at\_client/test/samples; 2 commits adding/updating tests in packages/at\_auth/test/data; 2 commits adding/updating tests in packages/at\_cli\_commons/test; 30 commits adding/updating tests in packages/at\_client/test/storage; 44 commits adding/updating tests in packages/at\_client\_cli/test; 5 commits adding/updating tests in packages/at\_chops/example/zariot/test; 5 commits adding/updating tests in tests/upgrade/scenario; 605 commits adding/updating tests in tests; 68 commits adding/updating tests in packages/at\_client/test/lifecycle; 68 commits adding/updating tests in packages/at\_client\_flutter/test; 7 commits adding/updating tests in packages/at\_client/test/samples/monitor; 8 commits adding/updating tests in packages/at\_chops/lib/src/algorithm/spec; 8 commits adding/updating tests in packages/at\_contact/test; Added keychain test fixtures and schema validation; Added smoke tests for example apps; Added test helper for Material app widget testing; Added tests for AtRpc client lifecycle, readiness, and request handling; Added tests for Enrollment response parsing and permissions; Added tests for the acceptance ledger and APKAM signing behavior; Added tests verifying client stop allows process exit; Added unit and widget tests for at\_events\_flutter; Added unit tests for ChatService; Added unit tests for at\_auth key management and authentication flows; Added widget tests for chat UI components; Define end-to-end tests for scoped enrollment lifecycle and concurrency; Executable post-quantum acceptance test suite for at\_client; Expanded test coverage for AES, Argon2id, and Post-Quantum Cryptography backends; Expanded unit test coverage for at\_commons core types and verb builders; New end-to-end test infrastructure for APKAM and post-quantum scenarios; New shared test utilities for the at\_client package; Test fixtures now include pre-generated cryptographic keys for demo users.
Dependencies
Initial release of at\_auth 4.0.0-rc3 and at\_chops 3.7.0
This change introduces the initial versions of the \at\_auth\ (4.0.0-rc3) and \at\_chops\ (3.7.0) packages, establishing the cryptographic and authentication foundations for the SDK. \at\_auth\ is defined as the package implementing common logic for onboarding and authenticating an atsign to a secondary server, while \at\_chops\ handles cryptographic and hashing operations. Both packages are configured for the Dart 3.6.0 SDK and are integrated into the workspace, with \at\_auth\ depending on \at\_chops\ ^3.6.0 and \at\_commons\ ^5.18.0.
(dependencies) · high confidence
Housekeeping
Version bump to 3.15.0-rc9
The at\_client package version has been updated to 3.15.0-rc9. This change is reflected in the generated version.dart file, which now reports the new version number.
_packages/at\client/lib/src · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 51 → 58 (+6.4)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 75 → 76 (+0.0)
- Architecture 95 → 95 (+0.0)
- Maturity 43 → 70 (+26.4)
- Readiness 51 → 51 (+0.0)
- Security 76 → 71 (-5.2)
- Domain Modelling 60 → 60 (+0.0)
- Performance 60 → 60 (+0.4)
Resolved (58)
- AtAuthImpl.onboard (cyclomatic 16) (packages/at_auth/lib/src/at_auth_impl.dart)
- AtClientManager.setCurrentAtSign (cognitive 21) (packages/at_client/lib/src/manager/at_client_manager.dart)
- AtClientManager.setCurrentAtSign (cyclomatic 20) (packages/at_client/lib/src/manager/at_client_manager.dart)
- AtCollectionQueryOperationsImpl._getAtCollectionModelsFromAtKey (cognitive 19) (packages/at_client/lib/src/at_collection/impl/at_collection_query_operations_impl.dart)
- AtCollectionQueryOperationsImpl.getModelsByCollectionName (cognitive 18) (packages/at_client/lib/src/at_collection/impl/at_collection_query_operations_impl.dart)
- AtLookupImpl._processCommand (cognitive 17) (packages/at_lookup/lib/src/at_lookup_impl.dart)
- Change coupling: ml_kem_768_pure_dart.dart ↔ x_wing_ffi.dart (packages/at_chops/lib/src/algorithm/encryption/ml_kem_768_pure_dart.dart)
- Change-coupling hub: ml_dsa_65_ffi.dart → ml_kem_768_ffi.dart, ml_kem_768_pure_dart.dart, x_wing_ffi.dart, x_wing_pure_dart.dart, ml_dsa_65_pure_dart.dart (packages/at_chops/lib/src/algorithm/signing/ml_dsa_65_ffi.dart)
- ClassTooLong: AuthCliArgs (packages/at_onboarding_cli/lib/src/cli/auth_cli_args.dart)
- Duplicated block (13–14 lines × 2) (packages/at_chops/example/zariot/external_signer.dart)
- Duplicated block (14 lines × 2) (packages/at_client/lib/src/at_collection/impl/at_collection_query_operations_impl.dart)
- Duplicated block (14 lines × 2) (packages/at_client_flutter/lib/src/widgets/authorisation/containers/enrollment_request_list.dart)
- Duplicated block (16 lines × 2) (packages/at_lookup/lib/src/at_lookup_impl.dart)
- Duplicated block (30 lines × 2) (packages/at_cli_commons/lib/src/service_factories.dart)
- Duplicated block (54 lines × 2) (packages/at_client_flutter/lib/src/widgets/apkam_dialog.dart)
- Duplicated block (8 lines × 2) (packages/at_client/lib/src/util/at_client_util.dart)
- EnvelopeEnrollmentConveyance.conveySecretsTo (cyclomatic 17) (packages/at_client/lib/src/service/envelope_enrollment_conveyance.dart)
- FileTooLong: cli/auth_cli_args.dart (packages/at_onboarding_cli/lib/src/cli/auth_cli_args.dart)
- Hotspot: packages/at_client/lib/src/manager/at_client_manager.dart (packages/at_client/lib/src/manager/at_client_manager.dart)
- Hotspot: packages/at_client/lib/src/service/envelope_enrollment_conveyance.dart (packages/at_client/lib/src/service/envelope_enrollment_conveyance.dart)
- …and 38 more
New (65)
- AtCollection._put (cyclomatic 16) (packages/at_client/lib/src/collections/collections.dart)
- AtKeysAssurance.validateMapUpdate (cognitive 18) (packages/at_auth/lib/src/keys/serialization/assurance.dart)
- AtKeysAssurance.validateMapUpdate (cyclomatic 18) (packages/at_auth/lib/src/keys/serialization/assurance.dart)
- Change coupling: apkam_dialog.dart ↔ pkam_dialog.dart (packages/at_client_flutter/lib/src/widgets/apkam_dialog.dart)
- Change coupling: cram_dialog.dart ↔ pkam_dialog.dart (packages/at_client_flutter/lib/src/widgets/cram_dialog.dart)
- Change coupling: ml_dsa_65_ffi.dart ↔ ml_dsa_65_pure_dart.dart (packages/at_chops/lib/src/algorithm/signing/ml_dsa_65_ffi.dart)
- CkManager._ownKey (cognitive 22) (packages/at_client/lib/src/crypto/nskey/ck_manager.dart)
- ClassTooLong: AuthCliArgs (packages/at_client_cli/lib/src/commands/auth_cli_args.dart)
- Duplicated block (13 lines × 2) (packages/at_client_flutter/lib/src/widgets/authorisation/containers/enrollment_request_list.dart)
- Duplicated block (17–18 lines × 2) (packages/at_client_flutter/lib/src/widgets/apkam_dialog.dart)
- Duplicated block (36–37 lines × 2) (packages/at_client_flutter/lib/src/widgets/apkam_dialog.dart)
- Duplicated block (6 lines × 2) (packages/at_client/lib/src/storage/memory/in_memory_at_client_storage.dart)
- EnrollmentHandshake._waitForPkamAuthSuccess (cyclomatic 21) (packages/at_auth/lib/src/enroll/enrollment_handshake.dart)
- EnrollmentSubmitter._handleSelfEnrollmentRequest (cognitive 19) (packages/at_auth/lib/src/enroll/enrollment_submitter.dart)
- EnrollmentSubmitter._handleSelfEnrollmentRequest (cyclomatic 17) (packages/at_auth/lib/src/enroll/enrollment_submitter.dart)
- EnvelopeEnrollmentConveyance._linkKeysOf (cognitive 16) (packages/at_client/lib/src/service/envelope_enrollment_conveyance.dart)
- FileTooLong: commands/auth_cli.dart (packages/at_client_cli/lib/src/commands/auth_cli.dart)
- FileTooLong: commands/auth_cli_args.dart (packages/at_client_cli/lib/src/commands/auth_cli_args.dart)
- FileTooLong: nskey/ck_manager.dart (packages/at_client/lib/src/crypto/nskey/ck_manager.dart)
- FileTooLong: rpc/at_rpc.dart (packages/at_client/lib/src/rpc/at_rpc.dart)
- …and 45 more
Changes since last survey
- 300 commits — 165 feature/other, 135 fixes
By area
- packages/at_client — 147 commits
- (repo) — 32 commits
- packages/at_client_cli — 28 commits
- docs/projects — 13 commits
- packages/at_auth — 13 commits
- packages/at_client_flutter — 13 commits
- tests/at_functional_test — 10 commits
- packages/at_client_skills — 8 commits
- packages/at_chops — 7 commits
- packages/at_lookup — 6 commits
- features/at_client — 5 commits
- docs/upgrade-to-4.md — 3 commits
- packages/at_utils — 3 commits
- .github/workflows — 2 commits
- actions/setup-flutter-and-dart — 2 commits
- features/at_client_cli — 2 commits
- packages/at_theme_flutter — 2 commits
- (root) — 1 commit
- packages/at_policy — 1 commit
- tests/at_client_cli_functional_tests — 1 commit
Notable commits
- fix: Merge branch 'trunk' into fix/pr2397-preexisting-0df75a0ee237
- fix: Merge branch 'trunk' into fix/pr2397-preexisting-0df75a0ee237
- fix: Merge branch 'trunk' into gkc-v4-newdev-fixes
- fix: Merge branch 'trunk' into st/pr2415-review-fixes
- fix: Merge gkc-v4-ga into fix/pr2415-review-findings-b3c1161e302b
- fix: Merge pull request #2410 from atsign-foundation/fix/pr2397-preexisting-0df75a0ee237
- fix: Merge pull request #2417 from atsign-foundation/fix/pr2415-review-findings-b3c1161e302b
- fix: Merge pull request #2423 from atsign-foundation/st/pr2415-review-fixes
- fix: Merge pull request #2426 from atsign-foundation/gkc-v4-newdev-fixes
- fix: Merge pull request #2434 from atsign-foundation/st/fix-lookups-for-flake
- fix: Merge pull request #2442 from atsign-foundation/fix/pr2433-review-findings-73e1bead369d
- fix: Merge pull request #2447 from atsign-foundation/fix/pr2446-review-findings-627c864c18e5
- fix: Merge remote-tracking branch 'origin/trunk' into st/pr2415-review-fixes
- fix: chore: merge trunk, which brings the review fixes from #2423
- fix: fix(at_auth): a cancel signal that fails ends the wait
- fix: fix(at_auth): a cancelled wait for approval ends with the cancel
- fix: fix(at_auth): a keyfile's .bak never keeps a removed pending enrollment
- fix: fix(at_auth): a self-enrollment checks its keyfile takes a write first
- fix: fix(at_auth): revoke a self-enrollment whose keyfile save fails
- fix: fix(at_chops): AtKeysCrypto's refusal names the hashing type it refused
- …and 280 more
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
atsign-foundation/at_client_sdk was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 5 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit fd645388200b01089ef9da4d813a4dbf06c8c0c0 — the exact code this score is about.
- Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.2+preprod-5c4e66d9318b.