Documentation
¶
Index ¶
- Constants
- func Fetch[T any](ctx context.Context, cache *JetStreamKV, key string, ...) (T, error)
- func NatsOptionsFromConfig(name string, cfg NATSClientConfig) []nats.Option
- type BucketOptions
- type JSLock
- type JetStreamKV
- func (c *JetStreamKV) AcquireLock(key string, ttl time.Duration) (*JSLock, error)
- func (c *JetStreamKV) Create(key string, value []byte) (uint64, error)
- func (c *JetStreamKV) Delete(key string) error
- func (c *JetStreamKV) Get(key string) (nats.KeyValueEntry, error)
- func (c *JetStreamKV) Set(key string, value []byte) (uint64, error)
- func (c *JetStreamKV) Update(key string, value []byte, revision uint64) (uint64, error)
- type KVEvent
- type KVSubscriber
- type KVSubscriberOptions
- type Lock
- type NATSClient
- type NATSClientConfig
Constants ¶
const (
WORKSPACE_PROVISION_JOBS_BUCKET = "workspace-provision-jobs"
)
Variables ¶
This section is empty.
Functions ¶
func Fetch ¶
func Fetch[T any](ctx context.Context, cache *JetStreamKV, key string, fetch func(context.Context) (T, error), ) (T, error)
Fetch retrieves a value from cache by key. On miss, calls fetch(), caches result with TTL, and returns it.
func NatsOptionsFromConfig ¶
func NatsOptionsFromConfig(name string, cfg NATSClientConfig) []nats.Option
Types ¶
type BucketOptions ¶
type BucketOptions struct {
Bucket string `yaml:"bucket" json:"bucket"`
BucketTTL time.Duration `yaml:"bucketTTL" json:"bucketTTL"`
History uint8 `yaml:"history" json:"history"`
Storage nats.StorageType `yaml:"storage" json:"storage"`
Replicas int `yaml:"replicas" json:"replicas"`
}
BucketOptions holds options for the JetStream cache bucket.
type JSLock ¶
type JSLock struct {
// contains filtered or unexported fields
}
JSLock is a guard returned by AcquireLock. Call Release() when done.
type JetStreamKV ¶
type JetStreamKV struct {
// contains filtered or unexported fields
}
JetStreamKV is a cache client backed by NATS JetStream KV store.
func (*JetStreamKV) AcquireLock ¶
AcquireLock attempts to acquire a lock at key with TTL. Returns nats.ErrKeyExists if the lock is already held and not expired. On success returns a guard; call guard.Release() to release. Implemented using KV Create() and CAS Update() when taking over expired locks.
func (*JetStreamKV) Create ¶
func (c *JetStreamKV) Create(key string, value []byte) (uint64, error)
Create stores raw bytes at key only if missing. Returns nats.ErrKeyExists if already present.
func (*JetStreamKV) Delete ¶
func (c *JetStreamKV) Delete(key string) error
Delete removes a key. Returns nats.ErrKeyNotFound if missing.
func (*JetStreamKV) Get ¶
func (c *JetStreamKV) Get(key string) (nats.KeyValueEntry, error)
Get retrieves raw bytes at key.
type KVEvent ¶
type KVEvent struct {
Bucket string
Key string
Op string
Value []byte
Seq uint64
Time time.Time
Msg *nats.Msg
}
KVEvent represents a single key-value event.
type KVSubscriber ¶
type KVSubscriber struct {
// contains filtered or unexported fields
}
KVSubscriber is a NATS JetStream KV bucket subscriber.
func (*KVSubscriber) StartPull ¶
func (s *KVSubscriber) StartPull(ctx context.Context, handler func(context.Context, *KVEvent) error) error
StartPull runs the pull loop until ctx is canceled. handler must be idempotent; Ack happens only if handler returns nil.
func (*KVSubscriber) Stop ¶
func (s *KVSubscriber) Stop() error
Stop unsubscribes from the KV bucket.
type KVSubscriberOptions ¶
type KVSubscriberOptions struct {
DeliverAll bool // true to replay all from start; false to get new only
AckWait time.Duration
MaxAckPending int
FetchBatchSize int
FetchMaxWait time.Duration
}
KVSubscriberOptions holds options for the KVSubscriber.
type NATSClient ¶
type NATSClient struct {
// contains filtered or unexported fields
}
func NewNATSClient ¶
func NewNATSClient(cfg NATSClientConfig) (*NATSClient, error)
func (*NATSClient) Close ¶
func (c *NATSClient) Close()
func (*NATSClient) NewKV ¶
func (c *NATSClient) NewKV(bucketOpts BucketOptions) (*JetStreamKV, error)
func (*NATSClient) NewKVSubscriber ¶
func (c *NATSClient) NewKVSubscriber(bucket, durable string, o KVSubscriberOptions) (*KVSubscriber, error)
NewKVSubscriber connects to NATS using your config and prepares a subscriber. Close() will drain/close the connection (since this constructor owns it).
type NATSClientConfig ¶
type NATSClientConfig struct {
Enabled bool `yaml:"enabled" json:"enabled"`
URL string `yaml:"url" json:"url"`
Username string `yaml:"username" json:"username"`
Password string `yaml:"password" json:"password"`
Token string `yaml:"token" json:"token"`
MaxReconnects int `yaml:"maxReconnects" json:"maxReconnects"`
ReconnectWait time.Duration `yaml:"reconnectWait" json:"reconnectWait"`
}
NATSClientConfig holds NATS connection.