Version 0.15.1

Added

• Added journal.WithNameTransform(), kv.WithNameTransform() and set.WithNameTransform(), which transform the apply a function to transform the name of each journal, keyspace and set, respectively.

Version 0.15.0

Changed

• [BC] Changed keyspace revisions to use new kv.Revision type instead of uint64.
• [BC] The pgkv package now uses bias-encoded revisions, stored in PostgreSQL as signed BIGINT values (PostgreSQL's largest integer type), offering access to the full range of uint64 values.

Version 0.14.0

This release adds revision-based OCC support to the kv package.

• Keyspace.Get() now returns the current revision of the key/value pair.
• Keyspace.Set() now requires the current revision to be passed as an argument, otherwise a ConflictError is returned.
• Added Keyspace.SetUnconditional(), which has the same semantics as Set() prior to this version.

Version 0.13.0

Added

• Added set.WithInterceptor() to allow intercepting operations on sets.
• Added kv.WithInterceptor() to allow intercepting operations on keyspaces.
• Added journal.WithInterceptor() to allow intercepting operations on journals.

Removed

• [BC] Removed hooks from memoryset.Store and BinaryStore. Use set.WithInterceptor() instead.
• [BC] Removed hooks from memorykv.Store and BinaryStore. Use kv.WithInterceptor() instead.
• [BC] Removed hooks from memoryjournal.Store. Use journal.WithInterceptor() instead.

Version 0.12.0

Added

• Added set.Set.Range() method to iterate over all members of a set.

Changed

• [BC] Renamed pgset table from set_value to set_member to match terminology elsewhere.
• [BC] Renamed dynamoset attribute from V (value) to M (member) to match terminology elsewhere.

Version 0.11.2

Changed

• Change telemetry to use enginekit/telemetry package.

Version 0.11.1

Fixed

• DynamoDB based implementations now wait for table creation to complete before returning from dynamojournal.NewBinaryStore() and dynamokv.NewBinaryStore(). This prevents potential issues due to the asynchronous nature of DynamoDB table creation, which is not evident when using the local DynamoDB emulator.

Version 0.11.0

Changed

• [BC] The journal.WithTelemetry(), kv.WithTelemetry() and set.WithTelemetry() functions now require an OpenTelemetry LoggerProvider instead of an slog.Logger. This change means that all persistencekit telemetry is now "OpenTelemetry native", ensuring that all log messages are correlated with spans when tracing is enabled.
• Changed metric instruments to use more specific names, such as value_size instead of more generic/network-level names such as io.
• Added misses metric, for kv.Keyspace.Get() operations that do not find a value in the keyspace.

Version 0.10.2

Added

• Added set.NewMarshalingStore(), which wraps a set.BinaryStore with a marshaler.Marshaler to store values of arbitrary types.

Version 0.10.1

Added

• Added set package, which provides an abstraction of named sets of values of arbitrary type.
• Added memoryset package, a memory-based implementation of set.Store.
• Added dynamoset package, a DynamoDB-based implementation of set.BinaryStore.
• Added pgset package, a PostgreSQL-based implementation of set.BinaryStore.

Fixed

• Fixed issue telemetry/tracing issue with kv.Keyspace.Set() that would cause a (potentially unreadable) value to be added to the span attributes when the key was human-readable.