NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #2446 most downloaded on pub.dev
The at_client library is the non-platform specific Client SDK which provides the essential methods for building an app using the atProtocol.
Latest stable
4.0.0
Last release 18 days ago
04 Nov 2026
Release timing varies
gaps range from 8 days to 4 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
3 versions withdrawn
withdrawn after publishing
6 years old
133 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
feat: the first release with post-quantum cryptography, chosen by AtClientPreference.posture (PqPosture.pqReady or pqActive): ML-DSA-65 signing, X-Win
AtClientPreference.posture (PqPosture.pqReady or pqActive):
ML-DSA-65 signing, X-Wing and ML-KEM-1024 key establishment,
per-namespace keys, a signing root, secret conveyance between an atSign's
enrollments, and key rotation. The default posture is still
PqPosture.legacy, which runs none of it unless a keyfile's own
post-quantum key material raises the client to its floor.pqReady, and an ML-DSA-65 data signing key
sets pqActive; a client configured lower logs a warning and is raised to
the floor, on its own copy of the preference, which getPreferences() and
setPreferences() reach. A raised client seeds no namespace keys and mints
no signing root that its configured posture would not.NotificationService.droppedEvents reports each notification a
client gives up on, such as one it cannot decrypt, with the reason it
logs at warning. A client whose posture reads no post-quantum data says
so when it drops one sealed post-quantum, that it is lost, and to
configure pqReady or above for later ones.sealToNamespace with no cryptoProviderId seals with the
namespace-key provider, so a pqReady program no longer names it; a
client whose config lacks it, as at PqPosture.legacy, is refused with
an error naming its posture or config.create's own copy is written and a recipient's is not, its
CollectionOpException<T> carries the item written as item, so the
share is retried with updateSharedWith(e.item!, ...) rather than a
second create.updateSharedWith(item, item.sharedWith) no longer empties the item's set.Atsign.open refuses keys a denial, a cancel or an expiry left
with no credential at once, with AtNoCredentialException saying to
enroll again, rather than failing a minute later as unreachable.AtStorageInUseException naming the store's location,
rather than with Hive's raw lock failure.getItems()
with a CItemReadException naming the record and the error its read
failed with, rather than a string; getItemsAsStream() with an onError
handler lists the rest._apsk both carry, against the key the signature
names, and a key the _apsk lists as retired still verifies, so what an
enrollment signed before a rotation stays valid. A later release re-signs
what an enrollment publishes under its active key, and then withdraws the
retired one._apsk stay as they were.PendingEnrollment.cancel() ends the wait client or
awaitApproval is in, which throws AtEnrollmentCancelledException once
the enrollment's pending keys are removed; cancel() throws when the key
store cannot remove them, and a later call tries again. The request stays on the atServer until the
atSign's manager decides it. A cancelled request cannot be resumed, even
from the copy a file store keeps beside its keyfile; enroll again.PendingEnrollment.stop() ends the wait and keeps the request, which
Atsign.resumeEnrollment picks up again, with no app or device when the
store holds one pending enrollment. A request that expires has its pending
keys removed, as a denied one does, and PendingEnrollment.approved says
whether an approval reached the key store before a stop or cancel. Once
stop() or cancel() returns, the atSign can be opened again at once on
an approval that landed just before.PqPosture.copyWith builds a posture from a named stage, changing
only the axes given: PqPosture.pqActive.copyWith(disallowLegacyEncryption: false) writes post-quantum and still allows legacy encryption.AtKeysFormatException comes through at_client, so an app tells a
keyfile that is not a JSON object by its reason and position without
importing at_auth.LocalSecondary.atChopsKeys is removed; a client signs with the
keys it is given.AtClient.notify, notifyChange, notifyAll and
startMonitor are removed; send through notificationService, one
notify per recipient. startCompactionJob and stopCompactionJob, which
did nothing, are removed too.NotificationParams.forText and NotificationParams.messageType
are removed: every notification is a key notification, the kind atServers
accept.NotificationService.send requires idAndNamespace; its
namespace: spelling is removed.AtClientManager.syncService and notificationService are
removed; use the client's own, client.syncService and
client.notificationService.SyncService.sync takes no onDone, and setOnDone is removed;
a SyncProgressListener hears how each sync went.SyncService.sync takes no onError, and SyncRequest has no
onError; a SyncProgressListener hears each sync that fails.sync() called while a sync is running runs once that one ends, so
a write made meanwhile no longer waits for the next periodic sync.AtServiceFactory.atClient is removed, and the factory's
notificationService and syncService take only the client.
AtClientImpl.create and SyncServiceImpl.create take no
atClientManager.AtClientPreference.syncStrategy and SyncStrategy, which
nothing read, are removed.AtClientManager.secondaryAddressFinder and
setSecondaryAddressFinder are removed; a client asks only the
secondaryAddressFinder it is built with.Atsign.enroll refuses an rsa2048 request under the pq key
exchange before sending it, and a PqPosture refuses rsa2048
authentication with the pq key exchange, or seeding namespace keys without
it. Each refusal names both settings.CollectionOpException lists each recipient's copy as OpNotAttempted.pqActive, a collection in a dotted namespace such as
todos.demos writes and shares its records.pqActive, a write to the client's own atSign made right after it
opens waits up to 30 seconds for the client to publish its namespace key,
instead of failing.pqActive, a share is sealed to the most specific namespace key
the recipient advertises for the key's whole name, and no longer waits for
the writer's start-up.PutRequestOptions.sealToNamespace, and sealToNamespace on
NotificationParams.forUpdate, NotificationService.send and
AtClientBindings.notify, seal a share to the recipient's key in one
namespace only; CryptoRuntime.canSealTo says whether the recipient
advertises one there, and answers false, with a warning, when it cannot
tell.PqStartupGates.inert() or with askOnReadMiss off.ensureReachable no longer answers failed for a namespace whose key
it has just published, when a revocation lands during the mint.lastKeyHolderRevokedAt
where it answers one, so a revocation of an enrollment that never held a key
package no longer triggers a rotation.EnrollmentDirectory.lastRevokedAt throws AtValueException for an
enroll:infons answer that names no revocation moment, rather than reading
it as no revocation.ensureReachable answers AtReachability.noKeyPackage.tryAcquireServerMutex writes holds the enrollment id
followed by a nonce drawn once per isolate._apsk. One it cannot
fetch, or one that verifies but offers no key it can use, is left in place,
and the error is thrown.getApkamPublicKey, and so verifying a signature, refuses a signer
that is not an enrollment id with AtSigningVerificationException, and an
envelope sent through a namespace no atKey can carry is not delivered. A
secret request whose requestId is not an id is answered as an unsolicited
delivery.AtClient.telemetry is removed, with
AtClientTelemetryService, AtClientTelemetryConsumer and
SyncTelemetryEvent.AtClientUtil.findSecondary is removed. Use
RemoteSecondary.findSecondaryUrl.Atsign.authenticatesAs no longer takes atLookUp; it takes
a required lookUps and secondaryAddressFinder, which choose how it
connects.AtClient.atChops and RemoteSecondary.atChops are removed, with
the atChops parameter of AtClientImpl.create. Hand a client its keys as
an AtKeysIo.ApkamSigning.publicSigningKey and privateSigningKey are
removed; sign with signingKeys.Query.fetch is removed; use get().LocalSecondary.getPrivateKey and getPublicKey are removed;
use getPkamPrivateKey and getPkamPublicKey.EncryptionUtil.decryptKey is removed; decrypt with at_chops'
RsaEncryptionAlgo.AtClient.stream and sendStreamAck are removed, as are
EncryptionService.encryptStream, decryptStream and
getSharedKeyForDecryption: atServers refuse the stream: command from
3.12.0. Encrypt for another atSign with put or notify.AtClient.persistenceBundle is removed; read the keystore from
the AtClientStorage the client was given.AtCollectionModel,
AtJsonCollectionModel and their factories) is removed; use
AtClient.collection.isDedicated parameter of put, get, delete, notify,
getMeta and notifyList is removed; it was ignored.sync parameter of executeVerb and
RemoteSecondary.executeAndParse is removed; it was ignored.RemoteSecondary.isAvailable is removed; at_lookup's
checkAtSignServer says whether an atSign's atServer is reachable.RemoteSecondary.authenticateCram is removed; Atsign.activate
takes the CRAM secret.AtClientPreference.atProtocolEmitted is removed; it was ignored.uploadFile, downloadFile,
reuploadFiles, shareFiles, FileTransferObject, FileStatus,
EncryptionService.encryptFileInChunks and decryptFileInChunks, and
AtClientPreference.downloadPath. File transfer belongs in the app.ConnectivityListener is removed; use a connectivity package of
the app's choice.RemoteSecondary.addStreamData is removed.AtClientPreference's commitLogPath, keyStoreSecret and
outboundConnectionTimeout are removed; nothing read them.AtClientPreference's decryptPackets, tlsKeysSavePath and
pathToCerts are removed; set them on the SecureSocketConfig of the
lookUps you pass, secureSocketLookUps(config: ...).AtClientPreference.enforceNamespace is removed: every key but a
local: one needs a namespace.EncryptionUtil is no longer exported; use at_chops'
AESEncryptionAlgo and RsaEncryptionAlgo.AtClientManager.setCurrentAtSign and fromAuthSession are
removed: open a client with Atsign(atSign).open(...) and make it current
with AtClientManager.getInstance().use(client), which does not stop the
previous one.AtClientImpl.holdsClientFor is removed.Atsign.open and activate,
PendingEnrollment.client, buildAtClient, selfRetrofit,
pqNativeOnboard, AtClientImpl.create) takes a required storage.
at_client no longer opens a store under hiveStoragePath: to keep using
that store, pass HiveAtClientStorage(atSign: ..., storagePath: <that path>, closedByClient: true).AtClientImpl.create's localSecondaryKeyStore is removed; pass
a storage.LocalSecondary takes a required syncQueue, the one the
client's storage holds.AtClientImpl.create and buildAtClient take a required
atKeysIo, and a client no longer signs with a PKAM key its local store
holds: pass the atSign's keyfile, such as FileAtKeysIo().AtClientImpl.create throws a StateError for a client of the same
atSign and enrollment whose stop() is still running, rather than
restarting it.collection() and service getters throw
StoppedException, like its other calls.AtClientImpl.create keeps one client per atSign and enrollment
rather than one per atSign. A caller naming no enrollment, whose keys name
none, gets the client for the primary enrollment; exactEnrollment: false hands it the one enrolled client already cached instead.AtClientImpl.setPreferences throws the ArgumentError for a
preference naming different rollout axes at the call, rather than as an
unhandled asynchronous error.AtReachability.noKeySource is removed, since every client has a
key source.FileAtKeysIo, secureSocketLookUps and
CacheableSecondaryAddressFinder come from the new at_client_io.dart;
at_client.dart no longer exports them, and builds for the web.enroll and resumeEnrollment
take a required lookUps and secondaryAddressFinder, as do authenticatesAs and retrofitIdentity,
and RemoteSecondary a required lookUps. secureSocketLookUps() and
CacheableSecondaryAddressFinder(preference.rootDomain, preference.rootPort)
connect as at_client 3 did.InMemoryAtClientStorage is pure Dart and needs no native library. A
SQLite database held in memory is still
SqliteAtClientStorage(..., dbPath: SqliteAtClientStorage.inMemoryPath).AtClientPreference.hiveStoragePath is read by nothing in
at_client, and goes in 5.0.0.ApkamSigning.signingKeys throws AtKeyNotFoundException when there is no
key to sign with, and a keyfile that cannot be read throws its read's error,
so no signing key or key package is published from it. An _apsk that names
no active signing key is not published.AtClientPreference.isLocalStoreRequired, privateKey,
useAtChops, signingAlgoType and hashingAlgoType are removed. A client
is given its storage, and signs with the keys in its AtKeysIo, which name
the algorithm.at_client.dart no longer exports LocalSecondary or
RemoteSecondary, which an app should not need; getLocalSecondary()
and getRemoteSecondary() remain, not for application use.AtClientPreference.syncIntervalMins is removed; it set nothing,
and sync's fallback timer runs every 30 seconds.RemoteSecondary's signingAlgoType parameter and
PutRequestOptions.storeSharedKeyEncryptedMetadata, which had no effect,
are removed.enroll:link; without one nothing is anchored, and everything else works as
before.client.enrollments.anchoring says whether an enrollment's keys are
anchored to the atSign's signing root, and names a key that is not.Enrollment carries the enrollment's authentication public key, as
apkamPublicKey.AtConnectionCause.enrollmentDenied, and enrollmentNotApproved means one
not yet approved. AtCredentialRefusedException says which.PqStartupGates.publishChainLink is removed,
PqStartupGates.publishRootLink is renamed anchorOwnKeys, and
PqSigningChain's methods are replaced.selfRetrofit closes the atLookUp it is given once the
retrofit is submitted, so the client it returns logs in as the new
enrollment. A command needing authentication on that lookup in between
fails rather than logging in as the old one.selfRetrofit given no atLookUp submits through the
secondaryAddressFinder it is given, as the client it opens does.AtRpc and AtRpcClient log request and response payloads at finest
only; at INFO and in their warnings a request is named by its id, and a
response by its type and request id.keyEstablishmentAlgorithms stops naming an
algorithm, the client treats that algorithm's key as retired at once, not
from its next start. AtClientSecretSharing.heldStatuses gives the status
of each key it holds.todos.demos, reads, writes and syncs its own records on the
device rather than being refused for insufficient privilege. As on the
atServer, a grant naming a namespace wins over *, a public key is
readable whatever the grant, no __manage key is reachable, and every
enrollment reads __atserver and reads and writes its own
per-enrollment records.at_commons ^5.23.0, the first to carry enroll:link.at_auth ^4.0.0.at_lookup ^4.0.0.at_persistence_secondary_server ^5.4.0.InMemoryAtKeysIo, which at_client re-exports, outside
a test draws an analyzer warning: the store a client runs on must be durable,
since a client may file the atSign's signing root into it.Your coding agent can read these notes before it upgrades. Set up the MCP server →
feat: Enrollment reports the key expiry a request asked for, as apkamKeysExpiryDuration (zero or less for none, null when the atServer does not say),
Enrollment reports the key expiry a request asked for, as
apkamKeysExpiryDuration (zero or less for none, null when the atServer
does not say), and when its record expires, as expiresAt.client.enrollments.approve returns the approved enrollment as the
atServer now holds it, including when it expires.fix: a client with isLocalStoreRequired false and no storage is refused, as the flag's deprecation says; pass one such as InMemoryAtClientStorage. Sto…
tryAcquireServerMutex takes a short-lived lock that every client of
the atSign shares, held on the atServer for at most 15 minutes; before
c3.16.2 and p3.16.5 an expired lock blocks until the atServer's expiry sweep,
up to about ten and a half minutes. It needs an atServer from p3.13.0, and
from c3.16.3 and p3.16.5 the lock records no commit.AtRpc's request mutex records no commit on an atServer from c3.16.3
or p3.16.5, so it no longer leaves an entry behind for every client of the
atSign to sync. It now needs an atServer from p3.13.0: on an older one, a
responder with enableRequestMutex handles no requests.PublishedNskeyKeyRing and PqSigningRoot refuse a lockTtl over 15
minutes when built.HiveAtClientStorage comes
from package:at_client/hive.dart and InMemoryAtClientStorage from
package:at_client/memory.dart, no longer from at_client.dart and
sqlite.dart.isLocalStoreRequired false and no storage is refused,
as the flag's deprecation says; pass one such as InMemoryAtClientStorage.
Storage an app passes is now always used.localSecondaryKeyStore with no
hiveStoragePath is refused; set the path, or pass a storage. With the path
set it is built whatever isLocalStoreRequired says.hiveStoragePath is refused with
the same ArgumentError as the other cases.AtClientManager.setCurrentAtSign refuses a client it could not build
for want of storage before it stops the current one, which stays current.hiveStoragePath, is held by one
client at a time: a second client asking for it meanwhile is refused with a
StateError instead of sharing it, which could hang an open or close the
other client's queue.Atsign.activate and PendingEnrollment.client refuse a client that
would have no local storage before the CRAM secret is spent or the approval
is waited for.localSecondaryKeyStore
closes the sync queue it opened.AtClientImpl.create's
localSecondaryKeyStore and AtClient.persistenceBundle; pass storage
instead.AtClientPreference.keyStoreSecret, which
nothing reads.NskeyPrivateNotHeldException.chat.app under app.rotateCkAfterOneWeek and neverRotateNskey remain for an app that wants
the old behaviour.shouldDecrypt
each receive notifications as they asked; the second no longer shares the
first one's stream and setting.AtRpc answers a request whose value it cannot parse with a NACK under
the request's id, and keeps serving; an error from a request or response
handler is logged and the listener carries on.get decrypts data that at_client 3.0.10 to 3.2.1 wrote, which from
3.13.0 came back still encrypted.get, put or notification whose shared key does not unwrap
under this atSign's key throws an AtException, as other decryption
failures do, not an ArgumentError.at_chops ^3.7.0.fix: an enrollment sent an ML-KEM-1024 namespace key can read that namespace, including one it received under an earlier 3.15.0 prerelease, and a name
feat: AtSignServerCheck, AtSignServerState, checkAtSignServer and AtSignLogger come through package:at_client/at_client.dart, so an app no longer need
AtSignServerCheck, AtSignServerState, checkAtSignServer and
AtSignLogger come through package:at_client/at_client.dart, so an app no
longer needs at_lookup or at_utils for them.fix: after an upgrade from 3.14.0, sync no longer stops for good, a restart no longer skips the notifications sent while the client was not running, a
local: record put back through the AtKey that read it can still be
read. A device a 3.15.0 prerelease left in that state recovers, except for an
app's own local: value shaped like ciphertext (base64 of a multiple of 16
bytes), which the app has to write again.Hive.init itself.Atsign.open refused by the atServer on
a device that has synced returns a client in the refused state rather than
throwing.AtChops and no key source, as
at_onboarding_cli 1.x builds one, uses the keys that AtChops holds again.readBy and wasMarkedReadByMe count a read receipt this client sent
before a restart, so markReadByMe no longer sends it a second time.CryptoConfig.supersededCkGrace) before it is cleaned up, so a recipient
can still open a notification sent under it just before the rotation.NotificationParams.forUpdate(..., ephemeral: true), send(..., ephemeral: true)): an atServer that supports
it delivers it without storing it, for at most 2 minutes. It cannot carry a
ttr or be cached at the recipient.ttln, so it no longer drifts at each hop.at_commons ^5.19.0.at_auth ^4.0.0-rc4: PendingEnrollment.awaitApproval on
an expired or unknown enrollment fails at once, with the atServer's reason.ensureReachable's result says whether this client can open what
peers seal to the namespace (AtReachabilityResult.holdsPrivate).* grant too.* can be approved; it was
refused for having no namespace to be sent its keys in.atClient.schemeOf(key) tells how a value another atSign shared was
protected: legacy or post-quantum, and under which KEM.
AtNotification.receivedUnder, passed as the cryptoProviderId of
NotificationService.send or AtClientBindings.notify (new there), lets an
app answer in the scheme it was asked in. A class that overrides
AtClientBindings.notify must add the parameter.AtRpc request can name its cryptoProviderId, and an AtRpc
server answers each request in the scheme it arrived in.AtRpc reply to a requester that cannot open a post-quantum answer
goes out under the server's default scheme, and a reply that could not be
sent is retried rather than dropped.AtRpc requests, from one client or several, no longer
share a request id, which could drop one or hand a caller another's response.AtKey reused for several puts or notifications carries nothing
over from one to the next.shouldEncrypt: false
is stored as given and treated as plain: the put drops isEncrypted,
ivNonce and the other encryption fields an app sets on the key's metadata.appMetadata no longer chooses the
provider for a notification the SDK encrypts; pass cryptoProviderId.noCommit put that falls back to legacy encryption still asks the
atServer not to record a commit.build: requires at_auth ^4.0.0-rc3, which releases a keyfile lock left behind by a process that stopped mid-write within 5 seconds.
at_auth ^4.0.0-rc3, which releases a keyfile lock left
behind by a process that stopped mid-write within 5 seconds.at_lookup ^3.7.0-rc3, whose notification connection logs
Heartbeat OK: lastReceipt <time> on each answered heartbeat again.isInSync() answers true once a client with a sync regex, or on an
enrollment limited to some namespaces, has pulled everything its filter
admits, rather than staying false until the next write the filter admits.feat (experimental): invitations, including to someone with no atSign yet: AtClientInvitations in at_client_mixins.dart, also as the Invitations mixin
AtClientInvitations in at_client_mixins.dart, also as the Invitations
mixin. An invitation is a link plus a separate code and can carry encrypted
content; the invitee previews and accepts it, and the inviter decides it
once.remoteLocalPref sends to the atServer now
sends its content key there too, so the atSign's other clients can read it.AtCollection that holds an item this atSign shared
post-quantum no longer fails.WithdrawnSigningKeyException, which says which.EnvelopeSigning.publicKeyCacheSettings no longer
takes resetOnLookup; a fetched key is kept for a fixed time.showHiddenKeys lists them.ensureReachable on a client with no AtKeysIo no longer publishes a
key only that process could open. It answers AtReachability.noKeySource,
which an exhaustive switch must now handle.…for a name with no dot; namespace is deprecated in favour of idAndNamespace.
AtClientPreference.posture (PqPosture.legacy, the default, pqReady or
pqActive): ML-DSA-65 signing, ML-KEM and X-Wing key establishment,
per-namespace keys, a signing root, secret conveyance at enrollment approval,
and key rotation. The default posture runs none of it. The 3.14.0
secret-sharing substrate changed shape.Atsign('@alice') lifecycle verbs: activate, enroll /
resumeEnrollment, open (serves local storage while offline) and
authenticatesAs. client.enrollments lists, approves, denies and revokes,
and issues OTPs and SPPs. buildAtClient(...) builds a client, and
AtClientManager.getInstance().use(client) makes it current.AtClientStorage, defaulting to
HiveAtClientStorage, with SqliteAtClientStorage and
InMemoryAtClientStorage in package:at_client/sqlite.dart.client.connection reports online, offline or refused;
attempt() and awaitOnline() retry. monitorSilenceTimeout (default 60s)
rebuilds a notification connection that has gone quiet.AtClient.stop() ends everything the client started and releases its
storage, so the process can exit. A stopped client cannot be restarted.NotificationService.send() encrypts under the namespace the caller
named and throws ArgumentError for a name with no dot; namespace is
deprecated in favour of idAndNamespace.appMetadata and immutable, expired records are reclaimed, and
AtCollection no longer duplicates, misses or deletes live items.clientConfig again,
AtClientImpl.create refuses a storage its cached client doesn't hold, and
closing a storage no longer races a concurrent attach.AtClientManager.setCurrentAtSign and
fromAuthSession; AtClient.atChops; AtClientPreference.decryptPackets,
tlsKeysSavePath, pathToCerts, hiveStoragePath and commitLogPath.at_auth ^4.0.0-rc2, at_lookup ^3.7.0-rc2, at_commons
^5.18.0, at_chops ^3.6.0 and at_persistence_secondary_server ^5.3.0.feat (experimental): per-APKAM same-atSign secret-sharing substrate — AtClientSecretSharing / PairwiseSecretSharing (mixins KeyPackageRegistration, En
AtClientSecretSharing / PairwiseSecretSharing (mixins KeyPackageRegistration,
EnvelopeSigning), SecretStore, KeyPackage, SecretEnvelope, and the
EnrollmentDirectory seam. Secrets travel in X-Wing-sealed (pqSeal),
APKAM-signed __ssenv envelopes addressed by kpid; key packages are
enrollment-internal (conveyed via enroll:request, discovered via the gated
enroll:listns verb) and never published. The whole surface is
@experimental — the wire shape is subject to change pending the atServer
verb work — and requires at_chops ^3.3.0 (pqSeal/pqOpen).deprecated: AtClient.startCompactionJob and AtClient.stopCompactionJob are retained for source compatibility but are now no-ops (a commit-log-free cli…
AtClientPreference.networkTimeout — when set on the preference used
to create an AtClient, it becomes the process-wide network-timeout default
(AtNetworkTimeouts.defaultTimeout, capped at 60s), bounding every atServer
connect / atDirectory lookup / operation so a dead network can't hang the SDK.
Supersedes the misnamed outboundConnectionTimeout (a socket idle time).
Requires at_commons ^5.13.0 (#1923).at_lookup: ^3.6.0, at_auth: ^3.2.0 — the bounded socket
connects and the deadline-driven validateAtServer live in those versions;
with older ones resolved, networkTimeout would set a policy nothing reads.at_persistence_secondary_server
5.0.0 — the client is now commit-log-free. The client no longer maintains a
local commit log or runs commit-log compaction; sync tracks its progress
with a persisted pull cursor, and key-expiry processing is driven by the
keystore's nextExpiresAt / peekNewlyAvailable surface. Requires
at_persistence_secondary_server ^5.0.0.AtClient.startCompactionJob and AtClient.stopCompactionJob
are retained for source compatibility but are now no-ops (a commit-log-free
client has no commit log to compact); they will be removed in a future
major release.FileTransferService and FileTransferObject are now marked
@Deprecated. The SDK file-sharing API (uploadFile / downloadFile /
shareFiles / reuploadFiles) has moved to the app layer and will be
removed, along with the archive dependency, in the next major version
(#1113).cron dependency — it was only used by the
commit-log compaction that the at_persistence_secondary_server 5.0.0
migration removed, and nothing in the client imports it (#1378). uuid is
already on ^4.0.0.chore: deprecated atClientManager param in the factories of AtClient, NotificationService, and SyncService
Several significant enhancements to the API to make it much easier to use.
send, to NotificationService which is much
easier to use than the old (still fine to use) notify method.factory AtRpc.server to make it much simpler to create AtRpc
servers.AtClientPreference.crypto, CryptoConfig, and
CryptoProvider.CryptoStorage to provider context for provider-owned local /
remote state, plus CryptoPolicy.onProviderNotFound for lazy
provider registration with a single retry.CSubItemUpdated events
that surfaced under EventSource.notifs (and EventSource.both)
when the keystore mirror landed under a key shape the readback
couldn't resolve, or raced ahead of sync writing the bare key.Major documentation uplift
And some tech debt cleanup
atClientManager param in the factories of AtClient, NotificationService, and SyncServicesync:from: request returns no entries because
the entire (lastReceivedServerCommitId, serverCommitId] range was filtered
out server-side (apkam namespace scope, syncRegex, or skipDeletesUntil),
advance the persisted server-commit cursor to the sync-start serverCommitId
snapshot instead of breaking out without advancing. Subsequent sync rounds
no-op until the server actually advances past it, rather than re-probing
the same filtered range every round.Nothing published for this version
Nothing published for this version
- chore(deps): at_auth ^3.0.0 - chore(deps): at_chops ^3.0.0
build(deps): Updated archive dependency to ^4.0.7
.toString() methods are JSON serialized
stringsfix: AtRpc - prevent NACK/ACK race when handling request mutex acquisition
chore: removed @experimental annotation from AtRpc and AtCollection
@experimental annotation from AtRpc and AtCollection// ignore: experimental_member_use for usages of the
still-experimental AtTelemetryfeat: introduce single-responder mode in AtRpc enabling redundancy support in request-response services relying on AtRpc. This feature is coupled with
enableRequestMutex flag that controls it.feat: add optional useRemoteAtServer flag to AtClient getKeys and getAtKeys so that apps can ask to fetch directly from atServer rather than the local
useRemoteAtServer flag to AtClient getKeys and
getAtKeys so that apps can ask to fetch directly from atServer rather
than the local datastore.isClient to true and isServer to false in AtRpcClient,
enabling same atSign communication of AtRpc clients and servers.chore(deps): at_persistence_secondary_server ^4.2.0
feat: deprecate the (misleadingly named) AtClientPreference.atProtocolEmitted and change its default value from 1.5.0 to 2.0.0
AtClientPreference.atProtocolEmitted and change its default value
from 1.5.0 to 2.0.0AtClientPreference.Atsign ProtocolEmitted and change its default value
from 1.5.0 to 2.0.0fix: ensure that namespaces in notify requests aren't messed up by multipart namespaces in AtClientPreference (e.g. namespace of foo.bar)
notify requests aren't messed up by
multipart namespaces in AtClientPreference (e.g. namespace of foo.bar)fix: ensure that namespace is preserved if it happens to be repeated in a notification's key (e.g. @bob:foo.my_app.my_app@alice )
@bob:foo.my_app.my_app@alice )feat: add atLookUp parameter to AtClientManager.setCurrentAtSign, AtClientImpl.create, etc. so we can inject an existing AtLookUp instance if we have
atLookUp parameter to AtClientManager.setCurrentAtSign,
AtClientImpl.create, etc. so we can inject an existing AtLookUp instance if
we have one rather than having to create a new one and authenticate againfix[performance]: when fetching public:publickey of another atSign from atServer, cache it in local storage instead of depending on sync to take care
public:publickey of another atSign from
atServer, cache it in local storage instead of depending on sync to take
care of that (since programs can disable sync)build[deps]: update dependencies including at_persistence major version changes
AtKeyNotFoundExceptions in
AtCollectionQueryOperationsImpllocal key, in which case the answer is always yes.build[deps]: update dependencies (at_commons, at_lookup, at_auth)
fix: potential bug handling atSigns which end in data e.g. @foo_data
data e.g. @foo_datafeat: Allows clients to skip delete commits until a specific commitID during initial sync
fix: remove deprecated isPaginated param from SyncVerbBuilder in SyncServiceImpl
feat: add the AtClientBindings mixin which was initially added to the noports_core package but has broader applicability.
build[deps]: Upgraded dependencies for the following packages:
feat: add optional param encryptValue to notify method
encryptValue to notify methodfeat: add allowAll flag (defaults to false) to AtRpc
allowAll flag (defaults to false) to AtRpcfeat: add useRemoteAtServer flag to GetRequestOptions to allow clients to fetch directly from the atServer rather than the client-side synced cache. T
useRemoteAtServer flag to GetRequestOptions to allow clients
to fetch directly from the atServer rather than the client-side synced
cache. This flag was added to PutRequestOptions and
DeleteRequestOptions in version 3.0.60NotificationResponseTransformer does not attempt to
decrypt when atNotification.isEncrypted == falsechore: publish clean version 3.0.78
fix: deprecate NotificationParams.forText and messageType getter by @srieteja in https://github.com/atsign-foundation/at_client_sdk/pull/1314
Full Changelog: https://github.com/atsign-foundation/at_client_sdk/compare/v3.0.76...v3.0.77
fix: remove incorrect version 3.0.78 from changelog
fix: melos bootstrapping issues by @xavierchanth in #1217
Full Changelog: v3.0.73...v3.0.76
feat: Introduce feature to fetch enrollment requests from the server
build[deps]: Upgraded dependencies for the following packages:
https://pub.dev/packages/at_client/changelog#3073
https://pub.dev/packages/at_client/changelog#3073
Full Changelog: v3.0.72...v3.0.73
https://pub.dev/packages/at_client/changelog#3073
Full Changelog: https://github.com/atsign-foundation/at_client_sdk/compare/v3.0.72...v3.0.73
…and after 3.2.0 specifically for this Dart breaking change which was introduced in dart 3.2.0
https://pub.dev/packages/at_client/changelog#3072
Minor change to allow us to support dart versions both before and after 3.2.0 specifically for this Dart breaking change which was introduced in dart 3.2.0
Full Changelog: v3.0.71...v3.0.72
build(deps): bump appleboy/ssh-action from 1.0.1 to 1.0.2 by @dependabot in #1191
build[deps]: Upgraded dependencies for the following packages:
>=1.4.1 <=1.5.0, crypton: >=2.1.0 <=2.2.1, encrypt: >=5.0.1 <=5.0.3, crypto: ^3.0.3feat: Add AtRpcClient for a much cleaner developer experience for sending AtRpc requests
feat: have AtRpc use ephemeral notifications
feat: Make enrollment available to SyncService/NotificationService for authentication
feat: deprecate useAtChops experimental flag and remove fallback code using private key from preferences/EncryptionUtil methods
'3.0.57', at_chops to '1.0.5, at_persistence_secondary_server to '3.0.59'feat: apkam changes for at_onboarding_cli
'3.0.55', at_chops to '1.0.4, at_lookup to '3.0.40'Made ConnectivityListener configurable, and removed some unnecessary network availability checks
socket.listen() in a runZonedGuarded blockfix: Fixed bug in AtRpc.sendRequest which was causing repeat sends of requests
fix: skip reserved keys during sync conflict checking
'>=0.13.5 <2.0.0'fix: ensure key exchange functions properly when the sync service is not being used
feat: add useRemoteAtServer to PutRequestOptions and (new) DeleteRequestOptions by @gkc in #1025
useRemoteAtServer to PutRequestOptions and (new) DeleteRequestOptions by @gkc in #1025useRemoteAtServer to PutRequestOptions and (new) DeleteRequestOptions by @gkc in https://github.com/atsign-foundation/at_client_sdk/pull/1025useRemoteAtServer to PutRequestOptions. When set, the update
request will be sent directly to the remote atServerdeleteRequestOptions to AtClient.deleteuseRemoteAtServer to DeleteRequestOptions. When set, the delete
request will be sent directly to the remote atServerfix: Sync running into infinite loop when an invalid key is present in the entries to sync into client
chore: upgrade dependencies. at_commons to 3.0.43, at_utils to 3.0.12, at_lookup to 3.0.36 and at_chops to 1.0.3
feat: Initial support of additional encryption metadata enabling encryption future-proofing
AtKeysfix: AtClient.put() throws null-check error when key's namespace is null
One column per quarter.