identity

Documentation

Overview

Package identity defines runtime-owned opaque identifiers.

Index

• type Generator
  • func NewGenerator(source Source) (Generator, error)
  • func (g Generator) NewSessionID() (SessionID, error)
• type SessionID
  • func ParseSessionID(value string) (SessionID, error)
  • func (id SessionID) LogValue() slog.Value
  • func (id SessionID) MarshalJSON() ([]byte, error)
  • func (id SessionID) Redacted() string
  • func (id SessionID) String() string
  • func (id *SessionID) UnmarshalJSON(data []byte) error
• type Source

Types

type Generator

type Generator struct {
	// contains filtered or unexported fields
}

Generator creates typed runtime IDs from an injected source.

func NewGenerator

func NewGenerator(source Source) (Generator, error)

NewGenerator creates a Generator that uses source for opaque ID payloads.

func (Generator) NewSessionID

func (g Generator) NewSessionID() (SessionID, error)

NewSessionID creates a SessionID from the generator's injected source.

type SessionID

type SessionID string

SessionID identifies a Session without disclosing routing or authorization data.

func ParseSessionID

func ParseSessionID(value string) (SessionID, error)

ParseSessionID validates an externally supplied SessionID.

func (SessionID) LogValue

func (id SessionID) LogValue() slog.Value

LogValue implements slog.LogValuer with a redacted value.

func (SessionID) MarshalJSON

func (id SessionID) MarshalJSON() ([]byte, error)

MarshalJSON serializes a validated SessionID as a JSON string.

func (SessionID) Redacted

func (id SessionID) Redacted() string

Redacted returns a safe diagnostic representation of the ID.

func (SessionID) String

func (id SessionID) String() string

String returns the canonical identifier value for protocol use.

func (*SessionID) UnmarshalJSON

func (id *SessionID) UnmarshalJSON(data []byte) error

UnmarshalJSON validates a JSON SessionID string before accepting it.

type Source

type Source interface {
	// Next returns one canonical ASCII payload without a type prefix.
	Next() (string, error)
}

Source supplies opaque identifier payloads at the composition root.