datasourceadmin

package
v0.0.0-...-89e479d Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 6, 2026 License: Apache-2.0 Imports: 22 Imported by: 0

Documentation

Overview

Package datasourceadmin owns provider-neutral offline datasource administration.

Index

Constants

View Source
const (
	// SchemaVersionV1 identifies retained public-only legacy history. It is
	// never accepted as a signing or campaign source snapshot.
	SchemaVersionV1 = "dkim2-datasource-v1"
	// SchemaVersionV2 identifies the deployed native custody schema.
	SchemaVersionV2 = "dkim2-datasource-v2"
	// SchemaVersionV3 identifies operation-bound administrative generations.
	SchemaVersionV3 = "dkim2-datasource-v3"
)

Variables

This section is empty.

Functions

func AllocateGeneration

func AllocateGeneration(inventory Inventory, limits GenerationLimits) (uint64, error)

AllocateGeneration chooses the first free value above every observed generation.

func NewAuditReceipt

func NewAuditReceipt(target admincontract.PurgeTarget, operationClass string, destroyedAt time.Time, policyVersion string, purgePlan admincontract.Digest) (admincontract.AuditReceipt, error)

NewAuditReceipt validates one compact result using only safe target metadata.

func NewError

func NewError(code ErrorCode) error

NewError creates one bounded provider-adapter failure classification.

func RetentionAuthorityCommitment

func RetentionAuthorityCommitment(backend BackendClass, authority AuthorityDescriptor) (admincontract.Digest, error)

RetentionAuthorityCommitment binds protected purge planning to one exact configured authority.

func RetentionInventoryVersion

func RetentionInventoryVersion(inventory RetentionInventory, policyVersion string) (string, error)

RetentionInventoryVersion returns the canonical complete observed-inventory commitment.

func RetentionPolicyCommitment

func RetentionPolicyCommitment(policy RetentionPolicy) (admincontract.Digest, error)

RetentionPolicyCommitment canonically binds every effective purge setting.

func ValidateAuthority

func ValidateAuthority(backend BackendClass, descriptor AuthorityDescriptor) error

ValidateAuthority rejects a backend descriptor outside the canonical authority grammar.

func ValidateDNSPolicy

func ValidateDNSPolicy(policy DNSPolicy) error

ValidateDNSPolicy rejects resolver and proof policy outside the canonical plan grammar.

func ValidateHandleDeclaration

func ValidateHandleDeclaration(value string) error

ValidateHandleDeclaration delegates opaque-handle grammar and bounds to the public dataset owner.

func ValidateInventory

func ValidateInventory(inventory Inventory, limits GenerationLimits) error

ValidateInventory proves one complete bounded authority view without reserving capacity for another candidate.

func ValidatePurgeAuthority

func ValidatePurgeAuthority(backend BackendClass, descriptor AuthorityDescriptor) error

ValidatePurgeAuthority rejects a descriptor that does not bind a fourth, pairwise-distinct destructive authority for the selected backend.

Types

type Activation

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

Activation owns one exact expected-current move under the same operation lock.

func NewActivation

func NewActivation(
	lock AdministrationLock,
	operation OperationBinding,
	expectedCurrent uint64,
	candidate uint64,
	prepared PreparedEvidence,
	staged StagedEvidence,
) (Activation, error)

NewActivation validates one exact lock-bound activation request.

func (Activation) CandidateGeneration

func (a Activation) CandidateGeneration() uint64

CandidateGeneration returns the exact committed candidate generation.

func (Activation) ExpectedCurrent

func (a Activation) ExpectedCurrent() uint64

ExpectedCurrent returns the exact fenced current generation.

func (Activation) Format

func (Activation) Format(state fmt.State, _ rune)

Format prevents activation evidence from reaching formatting sinks.

func (Activation) GoString

func (Activation) GoString() string

GoString returns a constant protected activation representation.

func (Activation) Lock

func (a Activation) Lock() AdministrationLock

Lock returns the protected exact backend lock claim.

func (Activation) MarshalJSON

func (Activation) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected activation serialization.

func (Activation) Operation

func (a Activation) Operation() OperationBinding

Operation returns the protected exact operation binding.

func (Activation) Prepared

func (a Activation) Prepared() PreparedEvidence

Prepared returns the protected pre-stage evidence.

func (Activation) Staged

func (a Activation) Staged() StagedEvidence

Staged returns the protected canonical readback evidence.

func (Activation) String

func (Activation) String() string

String returns a constant protected activation representation.

func (Activation) Valid

func (a Activation) Valid() bool

Valid reports whether the activation is monotonic, same-operation, and digest-equal.

type AdministrationLock

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

AdministrationLock is one protected exact owner-and-revision claim.

func NewAdministrationLock

func NewAdministrationLock(owner OperationBinding, revision uint64) (AdministrationLock, error)

NewAdministrationLock constructs one claimed lock bound to an operation and revision.

func (AdministrationLock) Format

func (AdministrationLock) Format(state fmt.State, _ rune)

Format prevents lock ownership and revision from reaching formatting sinks.

func (AdministrationLock) GoString

func (AdministrationLock) GoString() string

GoString returns a constant protected administration-lock representation.

func (AdministrationLock) MarshalJSON

func (AdministrationLock) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected administration-lock serialization.

func (AdministrationLock) Owner

Owner returns the protected exact operation owner.

func (AdministrationLock) Revision

func (l AdministrationLock) Revision() uint64

Revision returns the exact claimed backend revision.

func (AdministrationLock) String

func (AdministrationLock) String() string

String returns a constant protected administration-lock representation.

func (AdministrationLock) ValidFor

func (l AdministrationLock) ValidFor(operation OperationBinding) bool

ValidFor reports whether this initialized claim belongs to the operation.

type AdministrationLockObservation

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

AdministrationLockObservation is one read-only backend lock owner and revision sight.

func NewAdministrationLockObservation

func NewAdministrationLockObservation(
	revision uint64,
	owner OperationBinding,
	claimed bool,
) (AdministrationLockObservation, error)

NewAdministrationLockObservation constructs one exact claimed or ownerless lock sight.

func (AdministrationLockObservation) Claimed

func (o AdministrationLockObservation) Claimed() bool

Claimed reports whether the observed revision has an owner.

func (AdministrationLockObservation) Format

func (AdministrationLockObservation) Format(state fmt.State, _ rune)

Format prevents lock observation evidence from reaching formatting sinks.

func (AdministrationLockObservation) GoString

GoString returns a constant protected lock-observation representation.

func (AdministrationLockObservation) MarshalJSON

func (AdministrationLockObservation) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected lock-observation serialization.

func (AdministrationLockObservation) Owner

Owner returns the protected exact owner or zero for ownerless state.

func (AdministrationLockObservation) Revision

Revision returns the exact backend administration revision.

func (AdministrationLockObservation) String

String returns a constant protected lock-observation representation.

func (AdministrationLockObservation) Valid

Valid reports whether revision and optional owner form one exact lock sight.

type AdministrationLocker

type AdministrationLocker interface {
	Claim(context.Context, OperationBinding, uint64) (AdministrationLock, error)
	Release(context.Context, AdministrationLock) (uint64, error)
	ObserveAdministrationLock(context.Context) (AdministrationLockObservation, error)
}

AdministrationLocker serializes allocation plus stage and activation against backend state.

type AllocatedCredential

type AllocatedCredential struct {
	Algorithm string
	HandleID  string
	Selector  string
}

AllocatedCredential is one algorithm-sorted key-free selector allocation.

func (AllocatedCredential) Format

func (AllocatedCredential) Format(state fmt.State, _ rune)

Format prevents allocated credential data from reaching formatting sinks.

func (AllocatedCredential) GoString

func (AllocatedCredential) GoString() string

GoString returns a constant protected allocated-credential representation.

func (AllocatedCredential) MarshalJSON

func (AllocatedCredential) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected allocated-credential serialization.

func (AllocatedCredential) String

func (AllocatedCredential) String() string

String returns a constant protected allocated-credential representation.

type AuditLog

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

AuditLog retains a finite compact set of key-free purge receipts.

func NewAuditLog

func NewAuditLog(maximum uint32) (*AuditLog, error)

NewAuditLog creates a finite receipt owner without any snapshot or identity storage.

func (*AuditLog) Append

func (l *AuditLog) Append(receipt admincontract.AuditReceipt) error

Append validates and retains one compact completed destruction receipt.

func (*AuditLog) Close

func (l *AuditLog) Close() error

Close erases the finite audit receipt cache.

func (*AuditLog) Commitments

func (l *AuditLog) Commitments() ([]admincontract.Digest, error)

Commitments returns detached key-free receipt commitments in stable retention order.

func (*AuditLog) Count

func (l *AuditLog) Count() uint32

Count returns the finite retained receipt count.

func (*AuditLog) Format

func (*AuditLog) Format(state fmt.State, _ rune)

Format prevents receipt metadata from becoming generic output.

func (*AuditLog) GoString

func (*AuditLog) GoString() string

GoString prevents receipt metadata from becoming generic output.

func (*AuditLog) MarshalJSON

func (*AuditLog) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic audit serialization.

func (*AuditLog) String

func (*AuditLog) String() string

String prevents receipt metadata from becoming generic output.

type AuthorityDescriptor

type AuthorityDescriptor struct {
	AuthorityID                  string
	Endpoints                    []AuthorityEndpoint
	LDAP                         *LDAPAuthority
	SQL                          *SQLAuthority
	TrustFingerprints            [][sha256.Size]byte
	ClientCertificateFingerprint *[sha256.Size]byte
}

AuthorityDescriptor is one protected canonical provider authority binding.

func (AuthorityDescriptor) Format

func (AuthorityDescriptor) Format(state fmt.State, _ rune)

Format prevents authority identifiers and principals from reaching formatting sinks.

func (AuthorityDescriptor) GoString

func (AuthorityDescriptor) GoString() string

GoString returns a constant protected authority representation.

func (AuthorityDescriptor) MarshalJSON

func (AuthorityDescriptor) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected authority serialization.

func (AuthorityDescriptor) String

func (AuthorityDescriptor) String() string

String returns a constant protected authority representation.

type AuthorityEndpoint

type AuthorityEndpoint struct {
	Scheme        string
	Host          string
	Port          uint16
	TLSServerName string
}

AuthorityEndpoint is one ordered canonical verified-TLS provider endpoint.

func (AuthorityEndpoint) Format

func (AuthorityEndpoint) Format(state fmt.State, _ rune)

Format prevents authority endpoints from reaching formatting sinks.

func (AuthorityEndpoint) GoString

func (AuthorityEndpoint) GoString() string

GoString returns a constant protected authority-endpoint representation.

func (AuthorityEndpoint) MarshalJSON

func (AuthorityEndpoint) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected authority-endpoint serialization.

func (AuthorityEndpoint) String

func (AuthorityEndpoint) String() string

String returns a constant protected authority-endpoint representation.

type BackendClass

type BackendClass string

BackendClass identifies one closed administrative provider family.

const (
	// BackendLDAP identifies the LDAP administrative provider.
	BackendLDAP BackendClass = "ldap"
	// BackendPostgreSQL identifies the PostgreSQL administrative provider.
	BackendPostgreSQL BackendClass = "postgresql"
	// BackendMySQL identifies the MySQL administrative provider.
	BackendMySQL BackendClass = "mysql"
	// BackendMariaDB identifies the MariaDB administrative provider.
	BackendMariaDB BackendClass = "mariadb"
)

type CandidateContent

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

CandidateContent owns one immutable version-neutral generation.

func NewCandidateContent

func NewCandidateContent(snapshot *Snapshot) (*CandidateContent, error)

NewCandidateContent takes ownership of one complete v2 or v3 snapshot.

func (*CandidateContent) Close

func (c *CandidateContent) Close() error

Close erases and releases all candidate state.

func (*CandidateContent) Format

func (*CandidateContent) Format(state fmt.State, _ rune)

Format prevents formatting verbs from exposing candidate content.

func (*CandidateContent) Generation

func (c *CandidateContent) Generation() uint64

Generation returns the candidate generation or zero after close.

func (*CandidateContent) GoString

func (*CandidateContent) GoString() string

GoString returns a constant protected candidate representation.

func (*CandidateContent) MarshalJSON

func (*CandidateContent) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected candidate serialization.

func (*CandidateContent) String

func (*CandidateContent) String() string

String returns a constant protected candidate representation.

func (*CandidateContent) WithRows

func (c *CandidateContent) WithRows(ctx context.Context, use func(Rows) error) error

WithRows supplies a detached projection outside the candidate owner lock.

type CandidateContentDigest

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

CandidateContentDigest is the immutable full-candidate identity.

func ParseCandidateContentDigest

func ParseCandidateContentDigest(value []byte) (CandidateContentDigest, error)

ParseCandidateContentDigest validates and detaches one exact stored digest.

func (CandidateContentDigest) Bytes

func (d CandidateContentDigest) Bytes() []byte

Bytes returns a detached protected candidate digest for backend metadata only.

func (CandidateContentDigest) Equal

Equal reports whether two candidate digests are identical.

func (CandidateContentDigest) Format

func (CandidateContentDigest) Format(state fmt.State, _ rune)

Format prevents candidate-digest correlation through formatting.

func (CandidateContentDigest) GoString

func (CandidateContentDigest) GoString() string

GoString returns a constant protected candidate-digest representation.

func (CandidateContentDigest) MarshalJSON

func (CandidateContentDigest) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected candidate-digest serialization.

func (CandidateContentDigest) String

func (CandidateContentDigest) String() string

String returns a constant protected candidate-digest representation.

func (CandidateContentDigest) Valid

func (d CandidateContentDigest) Valid() bool

Valid reports whether the candidate digest is initialized.

type CollisionInventory

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

CollisionInventory owns one lock-revision-bound complete identity view.

func NewCollisionInventory

func NewCollisionInventory(
	ctx context.Context,
	lock AdministrationLock,
	inventory Inventory,
	snapshots []CollisionSnapshot,
	limits GenerationLimits,
) (*CollisionInventory, error)

NewCollisionInventory consumes complete snapshots into one protected collision view.

func (*CollisionInventory) CandidateGeneration

func (i *CollisionInventory) CandidateGeneration() uint64

CandidateGeneration returns the bounded first unused higher generation.

func (*CollisionInventory) Close

func (i *CollisionInventory) Close() error

Close releases every protected identity and operation binding.

func (*CollisionInventory) Format

func (*CollisionInventory) Format(state fmt.State, _ rune)

Format prevents collision inventory data from reaching formatting sinks.

func (*CollisionInventory) GoString

func (*CollisionInventory) GoString() string

GoString returns a constant protected collision-inventory representation.

func (*CollisionInventory) HandleIDUsed

func (i *CollisionInventory) HandleIDUsed(value string) bool

HandleIDUsed reports an exact collision across current and outstanding snapshots.

func (*CollisionInventory) MarshalJSON

func (*CollisionInventory) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected collision-inventory serialization.

func (*CollisionInventory) OperationUsed

func (i *CollisionInventory) OperationUsed(value OperationBinding) bool

OperationUsed reports an exact retained operation-binding collision.

func (*CollisionInventory) PolicyUsed

func (i *CollisionInventory) PolicyUsed(tenantID, domain, use string) bool

PolicyUsed reports an exact tenant, signing-domain, and profile-use collision.

func (*CollisionInventory) ProfileIDUsed

func (i *CollisionInventory) ProfileIDUsed(value string) bool

ProfileIDUsed reports an exact collision across current and outstanding snapshots.

func (*CollisionInventory) SelectorUsed

func (i *CollisionInventory) SelectorUsed(value string) bool

SelectorUsed reports an exact collision across current and outstanding snapshots.

func (*CollisionInventory) String

func (*CollisionInventory) String() string

String returns a constant protected collision-inventory representation.

func (*CollisionInventory) TakePlanSource

func (i *CollisionInventory) TakePlanSource(lock AdministrationLock) (*PlanSource, error)

TakePlanSource transfers the exact lock-bound key-free current projection once.

func (*CollisionInventory) ValidFor

func (i *CollisionInventory) ValidFor(lock AdministrationLock) bool

ValidFor reports whether this view was constructed under the exact claim.

type CollisionSnapshot

type CollisionSnapshot struct {
	Info     GenerationInfo
	Snapshot *Snapshot
}

CollisionSnapshot transfers one complete current or outstanding generation.

func (CollisionSnapshot) Format

func (CollisionSnapshot) Format(state fmt.State, _ rune)

Format prevents collision snapshot data from reaching formatting sinks.

func (CollisionSnapshot) GoString

func (CollisionSnapshot) GoString() string

GoString returns a constant protected collision-snapshot representation.

func (CollisionSnapshot) MarshalJSON

func (CollisionSnapshot) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected collision-snapshot serialization.

func (CollisionSnapshot) String

func (CollisionSnapshot) String() string

String returns a constant protected collision-snapshot representation.

type CredentialRow

type CredentialRow struct {
	ProfileID  string
	Algorithm  string
	Selector   string
	PublicSPKI []byte
	HandleID   string
}

CredentialRow is one public selector-to-handle projection.

func (CredentialRow) Format

func (CredentialRow) Format(state fmt.State, _ rune)

Format prevents credential-row data from reaching formatting sinks.

func (CredentialRow) GoString

func (CredentialRow) GoString() string

GoString returns a constant protected credential-row representation.

func (CredentialRow) MarshalJSON

func (CredentialRow) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected credential-row serialization.

func (CredentialRow) String

func (CredentialRow) String() string

String returns a constant protected credential-row representation.

type DNSPolicy

type DNSPolicy struct {
	ResolverClass        string
	ResolverEndpoints    []string
	ExportTTLSeconds     uint64
	ProofLifetimeSeconds uint64
}

DNSPolicy is the exact key-proof policy bound into a plan.

func (DNSPolicy) Format

func (DNSPolicy) Format(state fmt.State, _ rune)

Format prevents resolver policy data from reaching formatting sinks.

func (DNSPolicy) GoString

func (DNSPolicy) GoString() string

GoString returns a constant protected DNS-policy representation.

func (DNSPolicy) MarshalJSON

func (DNSPolicy) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected DNS-policy serialization.

func (DNSPolicy) String

func (DNSPolicy) String() string

String returns a constant protected DNS-policy representation.

type DomainAddition

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

DomainAddition owns one complete validated single-domain append operation.

func NewDomainAddition

func NewDomainAddition(
	intent PlanIntent,
	profileID string,
	credentials []DomainCredential,
) (*DomainAddition, error)

NewDomainAddition validates and owns one exact new-domain row set.

func (*DomainAddition) Close

func (a *DomainAddition) Close() error

Close erases and releases all retained generated domain key material.

func (*DomainAddition) Format

func (*DomainAddition) Format(state fmt.State, _ rune)

Format prevents domain additions from reaching formatting sinks.

func (*DomainAddition) GoString

func (*DomainAddition) GoString() string

GoString returns a constant protected domain-addition representation.

func (*DomainAddition) MarshalJSON

func (*DomainAddition) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected domain-addition serialization.

func (*DomainAddition) NewSnapshot

func (a *DomainAddition) NewSnapshot(schema string, generation uint64) (*Snapshot, error)

NewSnapshot constructs the initial complete generation from this domain addition.

func (*DomainAddition) String

func (*DomainAddition) String() string

String returns a constant protected domain-addition representation.

type DomainCredential

type DomainCredential struct {
	Algorithm    string
	HandleID     string
	Selector     string
	PublicSPKI   []byte
	PrivatePKCS8 []byte
}

DomainCredential contains one complete generated selector and native key pair.

func (DomainCredential) Format

func (DomainCredential) Format(state fmt.State, _ rune)

Format prevents generated key material from reaching formatting sinks.

func (DomainCredential) GoString

func (DomainCredential) GoString() string

GoString returns a constant protected domain-credential representation.

func (DomainCredential) MarshalJSON

func (DomainCredential) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected domain-credential serialization.

func (DomainCredential) String

func (DomainCredential) String() string

String returns a constant protected domain-credential representation.

type Error

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

Error is one content-free datasource-administration failure.

func (*Error) Code

func (e *Error) Code() ErrorCode

Code returns the closed failure class.

func (*Error) Error

func (*Error) Error() string

Error returns a constant diagnostic.

func (*Error) Format

func (*Error) Format(state fmt.State, _ rune)

Format prevents formatting verbs from exposing administrative context.

func (*Error) GoString

func (*Error) GoString() string

GoString returns a constant protected Go representation.

func (*Error) String

func (*Error) String() string

String returns a constant protected representation.

type ErrorCode

type ErrorCode string

ErrorCode identifies one bounded administration failure.

const (
	// CodeNone reports no classified error.
	CodeNone ErrorCode = "none"
	// CodeInvalid reports malformed administrative content.
	CodeInvalid ErrorCode = "invalid"
	// CodeConflict reports disagreement with authoritative state.
	CodeConflict ErrorCode = "conflict"
	// CodeLimitExceeded reports a finite administrative resource fence.
	CodeLimitExceeded ErrorCode = "limit_exceeded"
	// CodeUnavailable reports an unavailable backend operation.
	CodeUnavailable ErrorCode = "unavailable"
	// CodeReconcileRequired reports an ambiguous mutation outcome.
	CodeReconcileRequired ErrorCode = "reconcile_required"
)

func CodeOf

func CodeOf(err error) ErrorCode

CodeOf extracts the stable administration failure class.

type GenerationInfo

type GenerationInfo struct {
	Generation uint64
	Current    bool
	State      GenerationState
	WasActive  bool
	Operation  OperationBinding
	// SourceGeneration is the immutable current generation frozen for a v3 campaign.
	SourceGeneration uint64
	Schema           string
	ContentDigest    CandidateContentDigest
}

GenerationInfo contains bounded backend-authoritative allocation evidence.

func (GenerationInfo) Format

func (GenerationInfo) Format(state fmt.State, _ rune)

Format prevents generation metadata from reaching formatting sinks.

func (GenerationInfo) GoString

func (GenerationInfo) GoString() string

GoString returns a constant protected generation-info representation.

func (GenerationInfo) MarshalJSON

func (GenerationInfo) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected generation-info serialization.

func (GenerationInfo) Outstanding

func (g GenerationInfo) Outstanding() bool

Outstanding reports whether this exact noncurrent generation retains candidate material.

func (GenerationInfo) String

func (GenerationInfo) String() string

String returns a constant protected generation-info representation.

type GenerationLimits

type GenerationLimits struct {
	MaxGenerations           uint32
	MaxOutstandingCandidates uint32
	MaxSnapshotRows          uint32
	MaxSnapshotBytes         uint32
	BackendDeadline          time.Duration
}

GenerationLimits bounds one stable inventory and allocation decision.

func (GenerationLimits) Validate

func (l GenerationLimits) Validate() error

Validate rejects zero, excessive, or unbounded generation limits.

type GenerationState

type GenerationState string

GenerationState identifies backend-durable publication state.

const (
	// StateStaging identifies one writable inactive generation.
	StateStaging GenerationState = "staging"
	// StateCommitted identifies one sealed generation.
	StateCommitted GenerationState = "committed"
)

type HandleRow

type HandleRow struct{ ID string }

HandleRow is one opaque handle projection.

func (HandleRow) Format

func (HandleRow) Format(state fmt.State, _ rune)

Format prevents handle-row data from reaching formatting sinks.

func (HandleRow) GoString

func (HandleRow) GoString() string

GoString returns a constant protected handle-row representation.

func (HandleRow) MarshalJSON

func (HandleRow) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected handle-row serialization.

func (HandleRow) String

func (HandleRow) String() string

String returns a constant protected handle-row representation.

type IdentityProjection

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

IdentityProjection owns the collision-relevant identities of complete snapshots.

func (*IdentityProjection) Close

func (p *IdentityProjection) Close() error

Close releases every collision-relevant identity.

func (*IdentityProjection) Format

func (*IdentityProjection) Format(state fmt.State, _ rune)

Format prevents snapshot identities from reaching formatting sinks.

func (*IdentityProjection) GoString

func (*IdentityProjection) GoString() string

GoString returns a constant protected identity-projection representation.

func (*IdentityProjection) HandleIDUsed

func (p *IdentityProjection) HandleIDUsed(value string) bool

HandleIDUsed reports an exact handle-identifier collision.

func (*IdentityProjection) MarshalJSON

func (*IdentityProjection) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected identity-projection serialization.

func (*IdentityProjection) Merge

func (p *IdentityProjection) Merge(other *IdentityProjection) error

Merge adds another complete protected collision index.

func (*IdentityProjection) PolicyUsed

func (p *IdentityProjection) PolicyUsed(tenantID, domain, use string) bool

PolicyUsed reports an exact tenant, signing-domain, and profile-use collision.

func (*IdentityProjection) ProfileIDUsed

func (p *IdentityProjection) ProfileIDUsed(value string) bool

ProfileIDUsed reports an exact profile-identifier collision.

func (*IdentityProjection) SelectorUsed

func (p *IdentityProjection) SelectorUsed(value string) bool

SelectorUsed reports an exact selector collision.

func (*IdentityProjection) String

func (*IdentityProjection) String() string

String returns a constant protected identity-projection representation.

type Inventory

type Inventory struct {
	Current     uint64
	Generations []GenerationInfo
}

Inventory contains one stable current pointer and every bounded generation.

func (Inventory) Canonicalize

func (i Inventory) Canonicalize() Inventory

Canonicalize sorts one detached inventory by generation for stable comparison.

func (Inventory) Equivalent

func (i Inventory) Equivalent(other Inventory) bool

Equivalent reports whether two bounded inventories contain identical ordered evidence.

func (Inventory) Format

func (Inventory) Format(state fmt.State, _ rune)

Format prevents inventory metadata from reaching formatting sinks.

func (Inventory) GoString

func (Inventory) GoString() string

GoString returns a constant protected inventory representation.

func (Inventory) MarshalJSON

func (Inventory) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected inventory serialization.

func (Inventory) String

func (Inventory) String() string

String returns a constant protected inventory representation.

type KeyMaterialRow

type KeyMaterialRow struct {
	TenantID     string
	Domain       string
	Use          string
	HandleID     string
	Algorithm    string
	PublicSPKI   []byte
	PrivatePKCS8 []byte
}

KeyMaterialRow is one canonical native private-key binding.

func (KeyMaterialRow) Format

func (KeyMaterialRow) Format(state fmt.State, _ rune)

Format prevents private key material from reaching formatting sinks.

func (KeyMaterialRow) GoString

func (KeyMaterialRow) GoString() string

GoString returns a constant protected key-material-row representation.

func (KeyMaterialRow) MarshalJSON

func (KeyMaterialRow) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected key-material-row serialization.

func (KeyMaterialRow) String

func (KeyMaterialRow) String() string

String returns a constant protected key-material-row representation.

type LDAPAuthority

type LDAPAuthority struct {
	BaseDN              string
	SnapshotPrincipal   string
	StagingPrincipal    string
	ActivationPrincipal string
	PurgePrincipal      string
}

LDAPAuthority is the exact base and three-principal administrative binding.

func (LDAPAuthority) Format

func (LDAPAuthority) Format(state fmt.State, _ rune)

Format prevents LDAP authority data from reaching formatting sinks.

func (LDAPAuthority) GoString

func (LDAPAuthority) GoString() string

GoString returns a constant protected LDAP-authority representation.

func (LDAPAuthority) MarshalJSON

func (LDAPAuthority) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected LDAP-authority serialization.

func (LDAPAuthority) String

func (LDAPAuthority) String() string

String returns a constant protected LDAP-authority representation.

type OperationBinding

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

OperationBinding is one protected canonical 128-bit operation identity.

func NewOperationBinding

func NewOperationBinding(value string) (OperationBinding, error)

NewOperationBinding validates and owns one canonical operation identity.

func (OperationBinding) Equal

func (b OperationBinding) Equal(other OperationBinding) bool

Equal reports whether two initialized operation bindings are identical.

func (OperationBinding) Format

func (OperationBinding) Format(state fmt.State, _ rune)

Format prevents operation identity from reaching formatting sinks.

func (OperationBinding) GoString

func (OperationBinding) GoString() string

GoString returns a constant protected operation-binding representation.

func (OperationBinding) Initialized

func (b OperationBinding) Initialized() bool

Initialized reports whether the binding contains one canonical operation identity.

func (OperationBinding) MarshalJSON

func (OperationBinding) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected operation-binding serialization.

func (OperationBinding) String

func (OperationBinding) String() string

String returns a constant protected operation-binding representation.

func (OperationBinding) WithValue

func (b OperationBinding) WithValue(ctx context.Context, use func(string) error) error

WithValue supplies the canonical operation value only to a bounded provider callback.

type PlanDigest

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

PlanDigest is the key-free operation-plan identity.

func NewPlanDigest

func NewPlanDigest(projection PlanProjection) (PlanDigest, error)

NewPlanDigest validates and hashes the exact typed key-free plan grammar.

func ParsePlanDigest

func ParsePlanDigest(value []byte) (PlanDigest, error)

ParsePlanDigest validates and detaches one exact stored plan digest.

func (PlanDigest) Bytes

func (d PlanDigest) Bytes() []byte

Bytes returns a detached protected plan digest for the internal journal codec only.

func (PlanDigest) Equal

func (d PlanDigest) Equal(other PlanDigest) bool

Equal reports whether two plan digests are identical.

func (PlanDigest) Format

func (PlanDigest) Format(state fmt.State, _ rune)

Format prevents plan-digest correlation through formatting.

func (PlanDigest) GoString

func (PlanDigest) GoString() string

GoString returns a constant protected plan-digest representation.

func (PlanDigest) MarshalJSON

func (PlanDigest) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected plan-digest serialization.

func (PlanDigest) String

func (PlanDigest) String() string

String returns a constant protected plan-digest representation.

func (PlanDigest) Valid

func (d PlanDigest) Valid() bool

Valid reports whether the plan digest is initialized.

type PlanIntent

type PlanIntent struct {
	Version       string
	Domain        string
	TenantID      string
	ProfileUse    string
	Algorithms    []string
	Rollout       string
	Compatibility string
}

PlanIntent is the canonical key-free domain intent projection.

func (PlanIntent) Format

func (PlanIntent) Format(state fmt.State, _ rune)

Format prevents plan intent data from reaching formatting sinks.

func (PlanIntent) GoString

func (PlanIntent) GoString() string

GoString returns a constant protected plan-intent representation.

func (PlanIntent) MarshalJSON

func (PlanIntent) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected plan-intent serialization.

func (PlanIntent) String

func (PlanIntent) String() string

String returns a constant protected plan-intent representation.

type PlanProjection

type PlanProjection struct {
	Backend             BackendClass
	Authority           AuthorityDescriptor
	ExpectedCurrent     uint64
	Current             *PlanSource
	Intent              PlanIntent
	ProfileID           string
	Credentials         []AllocatedCredential
	CandidateGeneration uint64
	DNS                 DNSPolicy
	OperationID         string
}

PlanProjection is the complete typed key-free plan digest input.

func (PlanProjection) Format

func (PlanProjection) Format(state fmt.State, _ rune)

Format prevents plan intent and authority data from reaching formatting sinks.

func (PlanProjection) GoString

func (PlanProjection) GoString() string

GoString returns a constant protected plan representation.

func (PlanProjection) MarshalJSON

func (PlanProjection) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected plan serialization.

func (PlanProjection) String

func (PlanProjection) String() string

String returns a constant protected plan representation.

type PlanSource

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

PlanSource owns one complete key-free current-snapshot projection.

func (*PlanSource) Clone

func (s *PlanSource) Clone() (*PlanSource, error)

Clone creates one separately owned key-free projection.

func (*PlanSource) Close

func (s *PlanSource) Close() error

Close releases every retained public identity and key projection.

func (*PlanSource) Format

func (*PlanSource) Format(state fmt.State, _ rune)

Format prevents source identities and public keys from reaching formatting sinks.

func (*PlanSource) Generation

func (s *PlanSource) Generation() uint64

Generation returns the exact source generation.

func (*PlanSource) GoString

func (*PlanSource) GoString() string

GoString returns a constant protected plan-source representation.

func (*PlanSource) MarshalJSON

func (*PlanSource) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected plan-source serialization.

func (*PlanSource) SchemaVersion

func (s *PlanSource) SchemaVersion() string

SchemaVersion returns the exact source datasource schema.

func (*PlanSource) String

func (*PlanSource) String() string

String returns a constant protected plan-source representation.

func (*PlanSource) WithRows

func (s *PlanSource) WithRows(ctx context.Context, use func(Rows) error) error

WithRows supplies one detached key-free row projection to a bounded callback.

type PolicyRow

type PolicyRow struct {
	TenantID        string
	Domain          string
	Use             string
	ProfileID       string
	Status          string
	Rollout         string
	Compatibility   string
	FeedbackRouteID *string
}

PolicyRow is one exact tenant/domain/use profile binding.

func (PolicyRow) Format

func (PolicyRow) Format(state fmt.State, _ rune)

Format prevents policy-row data from reaching formatting sinks.

func (PolicyRow) GoString

func (PolicyRow) GoString() string

GoString returns a constant protected policy-row representation.

func (PolicyRow) MarshalJSON

func (PolicyRow) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected policy-row serialization.

func (PolicyRow) String

func (PolicyRow) String() string

String returns a constant protected policy-row representation.

type PreparedEvidence

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

PreparedEvidence is the pre-stage candidate-content phase.

func ParsePreparedEvidence

func ParsePreparedEvidence(value []byte) (PreparedEvidence, error)

ParsePreparedEvidence validates one exact stored prepared candidate digest.

func (PreparedEvidence) Digest

Digest returns the protected prepared candidate-content identity.

func (PreparedEvidence) Format

func (PreparedEvidence) Format(state fmt.State, _ rune)

Format prevents prepared evidence from reaching formatting sinks.

func (PreparedEvidence) GoString

func (PreparedEvidence) GoString() string

GoString returns a constant protected prepared-evidence representation.

func (PreparedEvidence) MarshalJSON

func (PreparedEvidence) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected prepared-evidence serialization.

func (PreparedEvidence) Matches

func (p PreparedEvidence) Matches(staged StagedEvidence) bool

Matches proves prepared and staged phases carry equal content bytes.

func (PreparedEvidence) String

func (PreparedEvidence) String() string

String returns a constant protected prepared-evidence representation.

type ProfileRow

type ProfileRow struct {
	ID           string
	Domain       string
	Status       string
	NotBeforeUTC *string
	NotAfterUTC  *string
}

ProfileRow is one public signing profile projection.

func (ProfileRow) Format

func (ProfileRow) Format(state fmt.State, _ rune)

Format prevents profile-row data from reaching formatting sinks.

func (ProfileRow) GoString

func (ProfileRow) GoString() string

GoString returns a constant protected profile-row representation.

func (ProfileRow) MarshalJSON

func (ProfileRow) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected profile-row serialization.

func (ProfileRow) String

func (ProfileRow) String() string

String returns a constant protected profile-row representation.

type PublicationEnvelope

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

PublicationEnvelope owns one operation-bound v3 candidate and its immutable digest.

func NewCampaignPublicationEnvelope

func NewCampaignPublicationEnvelope(operation string, sourceGeneration uint64, content *CandidateContent) (*PublicationEnvelope, error)

NewCampaignPublicationEnvelope binds a new campaign candidate to its exact frozen source generation. The source is immutable and part of the digest.

func NewPublicationEnvelope

func NewPublicationEnvelope(operation string, content *CandidateContent) (*PublicationEnvelope, error)

NewPublicationEnvelope takes content ownership on success and leaves rejected content caller-owned.

func (*PublicationEnvelope) Binding

Binding returns the immutable operation binding or its zero value after close.

func (*PublicationEnvelope) Close

func (e *PublicationEnvelope) Close() error

Close erases and releases the operation envelope and neutral content.

func (*PublicationEnvelope) Digest

Digest returns the protected operation-bound content identity.

func (*PublicationEnvelope) Format

func (*PublicationEnvelope) Format(state fmt.State, _ rune)

Format prevents formatting verbs from exposing publication metadata or content.

func (*PublicationEnvelope) Generation

func (e *PublicationEnvelope) Generation() uint64

Generation returns the candidate generation or zero after close.

func (*PublicationEnvelope) GoString

func (*PublicationEnvelope) GoString() string

GoString returns a constant protected publication-envelope representation.

func (*PublicationEnvelope) MarshalJSON

func (*PublicationEnvelope) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected publication-envelope serialization.

func (*PublicationEnvelope) PreparedEvidence

func (e *PublicationEnvelope) PreparedEvidence() PreparedEvidence

PreparedEvidence returns the phase-specific pre-stage digest evidence.

func (*PublicationEnvelope) SourceGeneration

func (e *PublicationEnvelope) SourceGeneration() uint64

SourceGeneration returns the immutable frozen source generation, or zero for legacy v3 envelopes that must remain unknown/retained.

func (*PublicationEnvelope) String

func (*PublicationEnvelope) String() string

String returns a constant protected publication-envelope representation.

func (*PublicationEnvelope) WithMetadata

WithMetadata supplies protected operation and digest metadata to a bounded provider callback.

func (*PublicationEnvelope) WithRows

func (e *PublicationEnvelope) WithRows(ctx context.Context, use func(Rows) error) error

WithRows supplies a detached candidate projection outside the envelope lock.

type PublicationObservation

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

PublicationObservation owns one bounded provider-neutral current and candidate classification.

func NewPublicationObservation

func NewPublicationObservation(
	currentGeneration uint64,
	candidateGeneration uint64,
	state PublicationState,
	operation OperationBinding,
	staged StagedEvidence,
	oldCurrentWasActive bool,
) (PublicationObservation, error)

NewPublicationObservation validates one exact provider readback classification.

func (PublicationObservation) CandidateGeneration

func (o PublicationObservation) CandidateGeneration() uint64

CandidateGeneration returns the exact requested candidate generation.

func (PublicationObservation) CurrentGeneration

func (o PublicationObservation) CurrentGeneration() uint64

CurrentGeneration returns the exact observed current or zero for proven empty state.

func (PublicationObservation) Format

func (PublicationObservation) Format(state fmt.State, _ rune)

Format prevents publication evidence from reaching formatting sinks.

func (PublicationObservation) GoString

func (PublicationObservation) GoString() string

GoString returns a constant protected publication-observation representation.

func (PublicationObservation) MarshalJSON

func (PublicationObservation) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected publication-observation serialization.

func (PublicationObservation) OldCurrentWasActive

func (o PublicationObservation) OldCurrentWasActive() bool

OldCurrentWasActive reports backend-durable established-current history.

func (PublicationObservation) Operation

Operation returns exact operation evidence for an exact candidate.

func (PublicationObservation) Staged

Staged returns exact candidate digest evidence for an exact candidate.

func (PublicationObservation) State

State returns the closed candidate classification.

func (PublicationObservation) String

func (PublicationObservation) String() string

String returns a constant protected publication-observation representation.

func (PublicationObservation) Valid

func (o PublicationObservation) Valid() bool

Valid reports whether classification and exact evidence agree.

type PublicationState

type PublicationState string

PublicationState classifies one requested candidate from authoritative readback.

const (
	// PublicationAbsent proves the candidate generation does not exist.
	PublicationAbsent PublicationState = "absent"
	// PublicationExactStaging proves exact complete operation-bound staging content.
	PublicationExactStaging PublicationState = "exact_staging"
	// PublicationExactCommitted proves exact complete operation-bound committed content.
	PublicationExactCommitted PublicationState = "exact_committed"
	// PublicationPartial reports incomplete candidate content.
	PublicationPartial PublicationState = "partial"
	// PublicationMismatch reports complete content with mismatched ownership or digest.
	PublicationMismatch PublicationState = "mismatch"
	// PublicationUnknown reports an authority result that cannot be classified safely.
	PublicationUnknown PublicationState = "unknown"
)

type PurgeCommand

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

PurgeCommand is an ephemeral, exact target set available only after the protected plan and fresh inventory fences have both been verified. The zero value carries no targets and refuses every provider callback.

func NewVerifiedPurgeCommand

func NewVerifiedPurgeCommand(
	current uint64,
	planDigest admincontract.Digest,
	authority admincontract.Digest,
	policyVersion string,
	targets []admincontract.PurgeTarget,
) PurgeCommand

NewVerifiedPurgeCommand projects one protected purge plan into the provider-facing command. Only the rotation purge fence may call it, after the plan digest, authority commitment, and fresh inventory readback have all been verified; the targets are copied so the caller's plan stays owned by the caller.

func (PurgeCommand) AuthorityCommitment

func (c PurgeCommand) AuthorityCommitment() admincontract.Digest

AuthorityCommitment returns the exact dedicated destructive authority commitment.

func (PurgeCommand) Clear

func (c PurgeCommand) Clear()

Clear zeroes the command's private target copy once the provider call has returned, so verified target identities do not outlive one execution.

func (PurgeCommand) CurrentGeneration

func (c PurgeCommand) CurrentGeneration() uint64

CurrentGeneration returns the current-pointer fence that no target may equal.

func (PurgeCommand) PlanDigest

func (c PurgeCommand) PlanDigest() admincontract.Digest

PlanDigest returns the exact provider-neutral target commitment.

func (PurgeCommand) PolicyVersion

func (c PurgeCommand) PolicyVersion() string

PolicyVersion returns the closed retention policy version bound to the plan.

func (PurgeCommand) WithTargets

func (c PurgeCommand) WithTargets(ctx context.Context, use func([]admincontract.PurgeTarget) error) error

WithTargets supplies detached exact targets to one bounded provider callback.

type PurgeExecutionResult

type PurgeExecutionResult struct {
	Committed bool
	Unknown   bool
}

PurgeExecutionResult classifies only a conclusively committed destruction or an unknown outcome requiring provider-specific read-only reconciliation.

type PurgeExecutor

type PurgeExecutor interface {
	Purge(context.Context, PurgeCommand) (PurgeExecutionResult, error)
}

PurgeExecutor is a provider-owned destruction authority. It receives an exact verified command and must never retry an unknown backend outcome.

type PurgeReconciler

type PurgeReconciler interface {
	PurgeExecutor
	Reconcile(context.Context, PurgeCommand) (PurgeExecutionResult, error)
}

PurgeReconciler verifies an unknown destructive outcome using only exact provider readback. It must not invoke the destructive path during reconcile.

type RetentionClassification

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

RetentionClassification contains deterministic protected retention results.

func ClassifyRetention

func ClassifyRetention(inventory RetentionInventory, policy RetentionPolicy) (*RetentionClassification, error)

ClassifyRetention deterministically selects only exact recoverable noncurrent generations.

func ClassifyRetentionPages

func ClassifyRetentionPages(version string, current uint64, pages [][]RetentionGeneration, policy RetentionPolicy) (*RetentionClassification, error)

ClassifyRetentionPages concatenates a stable ordered page stream without applying allocation ceilings.

func (*RetentionClassification) CurrentGeneration

func (c *RetentionClassification) CurrentGeneration() uint64

CurrentGeneration returns the exact protected current pointer.

func (*RetentionClassification) Eligible

func (c *RetentionClassification) Eligible(generation uint64) bool

Eligible reports whether one exact generation is selected.

func (*RetentionClassification) EligibleCount

func (c *RetentionClassification) EligibleCount() int

EligibleCount returns the bounded destructive target count.

func (*RetentionClassification) EligibleTargets

func (c *RetentionClassification) EligibleTargets() []RetentionGeneration

EligibleTargets returns a detached canonical destructive target set.

func (*RetentionClassification) Format

func (*RetentionClassification) Format(state fmt.State, _ rune)

Format prevents generation metadata from reaching generic output.

func (*RetentionClassification) GoString

func (*RetentionClassification) GoString() string

GoString prevents generation metadata from reaching generic output.

func (*RetentionClassification) InventoryVersion

func (c *RetentionClassification) InventoryVersion() string

InventoryVersion returns the stable inventory commitment version.

func (*RetentionClassification) MarshalJSON

func (*RetentionClassification) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic retention serialization.

func (*RetentionClassification) Policy

Policy returns the detached finite policy used for selection.

func (*RetentionClassification) Reason

func (c *RetentionClassification) Reason(generation uint64) RetentionReason

Reason returns the exact closed classification reason or unknown for missing generation evidence.

func (*RetentionClassification) RetainedCount

func (c *RetentionClassification) RetainedCount() uint32

RetainedCount returns all non-eligible resolved generations.

func (*RetentionClassification) String

func (*RetentionClassification) String() string

String prevents generation metadata from reaching generic output.

func (*RetentionClassification) UnresolvedCount

func (c *RetentionClassification) UnresolvedCount() uint32

UnresolvedCount returns all never-eligible ambiguous generations.

type RetentionDecision

type RetentionDecision struct {
	Generation uint64
	Reason     RetentionReason
	Eligible   bool
}

RetentionDecision is one detached classification result.

type RetentionGeneration

type RetentionGeneration struct {
	Generation       uint64
	Operation        OperationBinding
	SourceGeneration uint64
	Schema           string
	State            GenerationState
	WasActive        bool
	Complete         bool
	Closed           bool
	Ownership        RetentionOwnership
	ContentDigest    admincontract.Digest
}

RetentionGeneration is key-free lifecycle metadata for one inventory generation.

func JoinTerminalRecovery

func JoinTerminalRecovery(generations []RetentionGeneration, terminals []TerminalRecord) []RetentionGeneration

JoinTerminalRecovery applies only exact immutable terminal evidence. A v3 campaign generation with missing or mismatched terminal evidence is unknown and therefore retained; it is never inferred from the current pointer.

type RetentionInventory

type RetentionInventory struct {
	Version     string
	Current     uint64
	Generations []RetentionGeneration
}

RetentionInventory is one stable, key-free, provider-neutral inventory projection.

func ReadRetentionInventory

func ReadRetentionInventory(ctx context.Context, reader RetentionInventoryReader, limits GenerationLimits) (RetentionInventory, error)

ReadRetentionInventory reads provider-owned metadata without invoking allocation.

func ReadRetentionRecoveryInventory

func ReadRetentionRecoveryInventory(ctx context.Context, reader RetentionRecoveryReader, limits RetentionRecoveryLimits) (RetentionInventory, error)

ReadRetentionRecoveryInventory builds a stable full recovery inventory without allocation limits.

type RetentionInventoryReader

type RetentionInventoryReader interface {
	Inventory(context.Context, GenerationLimits) (Inventory, error)
}

RetentionInventoryReader owns provider-side stable historical metadata reads.

type RetentionOwnership

type RetentionOwnership string

RetentionOwnership classifies the authority that supplied one generation's metadata.

const (
	// RetentionOwnershipTrusted identifies metadata from the configured generation owner.
	RetentionOwnershipTrusted RetentionOwnership = "trusted"
	// RetentionOwnershipForeign identifies metadata owned by another authority.
	RetentionOwnershipForeign RetentionOwnership = "foreign"
	// RetentionOwnershipUnknown identifies metadata without an exact owner proof.
	RetentionOwnershipUnknown RetentionOwnership = "unknown"
)

type RetentionPolicy

type RetentionPolicy struct {
	Version                         string
	MaxTotalGenerations             uint32
	MinActiveRollbackGenerations    uint32
	MaxClosedNeverActiveGenerations uint32
	MaxPurgeBatch                   uint32
	AllowLegacyV2                   bool
}

RetentionPolicy bounds purge selection independently of allocation limits.

func DefaultRetentionPolicy

func DefaultRetentionPolicy() RetentionPolicy

DefaultRetentionPolicy returns restrictive finite production defaults.

func (RetentionPolicy) Validate

func (p RetentionPolicy) Validate() error

Validate rejects unbounded, empty, or contradictory policy settings.

type RetentionReason

type RetentionReason string

RetentionReason is the closed provider-neutral result of one retention decision.

const (
	RetentionReasonCurrent             RetentionReason = "current"
	RetentionReasonOpenCampaign        RetentionReason = "open_campaign"
	RetentionReasonUnknown             RetentionReason = "unknown"
	RetentionReasonMalformed           RetentionReason = "malformed"
	RetentionReasonPartial             RetentionReason = "partial"
	RetentionReasonForeign             RetentionReason = "foreign"
	RetentionReasonLegacy              RetentionReason = "legacy_retained"
	RetentionReasonActiveRollback      RetentionReason = "active_rollback"
	RetentionReasonActiveHistory       RetentionReason = "active_history"
	RetentionReasonClosedNeverActive   RetentionReason = "closed_never_active"
	RetentionReasonEligibleActive      RetentionReason = "eligible_active_history"
	RetentionReasonEligibleNeverActive RetentionReason = "eligible_never_active"
)

RetentionReason values classify every closed retention outcome.

type RetentionRecoveryLimits

type RetentionRecoveryLimits struct {
	MaxGenerations uint32
	PageSize       uint32
	MaxReadBytes   uint32
}

RetentionRecoveryLimits bounds an allocation-independent historical recovery read.

func DefaultRetentionRecoveryLimits

func DefaultRetentionRecoveryLimits() RetentionRecoveryLimits

DefaultRetentionRecoveryLimits returns the fixed finite recovery window.

func (RetentionRecoveryLimits) Validate

func (l RetentionRecoveryLimits) Validate() error

Validate rejects widened or unbounded recovery reads.

type RetentionRecoveryReader

type RetentionRecoveryReader interface {
	RetentionCurrent(context.Context) (uint64, error)
	RetentionPage(context.Context, uint64, uint32) ([]RetentionGeneration, error)
}

RetentionRecoveryReader owns one provider's exact paged historical evidence read.

type Rows

type Rows struct {
	Handles     []HandleRow
	Profiles    []ProfileRow
	Credentials []CredentialRow
	Policies    []PolicyRow
	KeyMaterial []KeyMaterialRow
}

Rows contains one complete generation without provider records or metadata.

func (Rows) Format

func (Rows) Format(state fmt.State, _ rune)

Format prevents complete row projections from reaching formatting sinks.

func (Rows) GoString

func (Rows) GoString() string

GoString returns a constant protected row-set representation.

func (Rows) MarshalJSON

func (Rows) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected row-set serialization.

func (Rows) String

func (Rows) String() string

String returns a constant protected row-set representation.

type SQLAuthority

type SQLAuthority struct {
	Database       string
	Schema         string
	SnapshotRole   string
	StagingRole    string
	ActivationRole string
	PurgeRole      string
}

SQLAuthority is the exact database/schema and three-role administrative binding.

func (SQLAuthority) Format

func (SQLAuthority) Format(state fmt.State, _ rune)

Format prevents SQL authority data from reaching formatting sinks.

func (SQLAuthority) GoString

func (SQLAuthority) GoString() string

GoString returns a constant protected SQL-authority representation.

func (SQLAuthority) MarshalJSON

func (SQLAuthority) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected SQL-authority serialization.

func (SQLAuthority) String

func (SQLAuthority) String() string

String returns a constant protected SQL-authority representation.

type Snapshot

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

Snapshot owns one complete validated provider-neutral generation.

func NewSnapshot

func NewSnapshot(schema string, generation uint64, rows Rows) (*Snapshot, error)

NewSnapshot validates and takes detached ownership of one complete generation.

func NewSnapshotWithLimits

func NewSnapshotWithLimits(schema string, generation uint64, rows Rows, limits provider.Limits) (*Snapshot, error)

NewSnapshotWithLimits validates and owns one complete generation under an exact finite profile.

func (*Snapshot) AddDomain

func (s *Snapshot) AddDomain(
	schema string,
	generation uint64,
	addition *DomainAddition,
) (*Snapshot, error)

AddDomain clones the source and appends one validated domain without mutating either owner.

func (*Snapshot) CloneTo

func (s *Snapshot) CloneTo(schema string, generation uint64) (*Snapshot, error)

CloneTo creates a complete identical logical generation with a higher number.

func (*Snapshot) Close

func (s *Snapshot) Close() error

Close destroys all retained public and private key bytes and invalidates the snapshot.

func (*Snapshot) Format

func (*Snapshot) Format(state fmt.State, _ rune)

Format prevents formatting verbs from traversing snapshot rows.

func (*Snapshot) Generation

func (s *Snapshot) Generation() uint64

Generation returns the exact generation or zero after close.

func (*Snapshot) GoString

func (*Snapshot) GoString() string

GoString returns a constant protected Go representation.

func (*Snapshot) IdentityProjection

func (s *Snapshot) IdentityProjection(ctx context.Context) (*IdentityProjection, error)

IdentityProjection returns a detached protected collision index.

func (*Snapshot) MarshalJSON

func (*Snapshot) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected snapshot serialization.

func (*Snapshot) PlanSource

func (s *Snapshot) PlanSource(ctx context.Context) (*PlanSource, error)

PlanSource creates a detached projection and immediately omits all private PKCS8 fields.

func (*Snapshot) SchemaVersion

func (s *Snapshot) SchemaVersion() string

SchemaVersion returns the closed schema identifier or empty after close.

func (*Snapshot) String

func (*Snapshot) String() string

String returns a constant protected snapshot representation.

func (*Snapshot) WithRows

func (s *Snapshot) WithRows(ctx context.Context, use func(Rows) error) error

WithRows supplies a detached protected projection and erases it after the callback.

type SnapshotReader

type SnapshotReader interface {
	ReadCurrent(context.Context, GenerationLimits) (*Snapshot, error)
	Inventory(context.Context, GenerationLimits) (Inventory, error)
	// ReadCollisionInventory returns one atomic complete view bound to the exact supplied claim.
	ReadCollisionInventory(context.Context, AdministrationLock, GenerationLimits) (*CollisionInventory, error)
}

SnapshotReader reads one stable complete current generation and inventory.

type StagedEvidence

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

StagedEvidence is the canonical backend-readback phase.

func NewStagedEvidence

func NewStagedEvidence(digest CandidateContentDigest) StagedEvidence

NewStagedEvidence constructs exact canonical backend-readback evidence.

func ParseStagedEvidence

func ParseStagedEvidence(value []byte) (StagedEvidence, error)

ParseStagedEvidence validates one exact stored canonical readback digest.

func (StagedEvidence) Digest

Digest returns the protected staged readback candidate-content identity.

func (StagedEvidence) Format

func (StagedEvidence) Format(state fmt.State, _ rune)

Format prevents staged evidence from reaching formatting sinks.

func (StagedEvidence) GoString

func (StagedEvidence) GoString() string

GoString returns a constant protected staged-evidence representation.

func (StagedEvidence) MarshalJSON

func (StagedEvidence) MarshalJSON() ([]byte, error)

MarshalJSON rejects generic protected staged-evidence serialization.

func (StagedEvidence) String

func (StagedEvidence) String() string

String returns a constant protected staged-evidence representation.

type TerminalRecord

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

TerminalRecord is key-free immutable evidence for one terminal campaign outcome.

func NewTerminalRecord

func NewTerminalRecord(operation OperationBinding, candidateSchema, sourceSchema string, source, candidate, current uint64, digest CandidateContentDigest, state TerminalState, reason string, recordedAt time.Time) (TerminalRecord, error)

NewTerminalRecord validates exact one-way terminal evidence before it reaches a provider.

func (TerminalRecord) CandidateDigest

func (r TerminalRecord) CandidateDigest() CandidateContentDigest

CandidateDigest returns the exact immutable candidate commitment.

func (TerminalRecord) CandidateGeneration

func (r TerminalRecord) CandidateGeneration() uint64

CandidateGeneration returns the immutable campaign candidate generation.

func (TerminalRecord) CandidateSchema

func (r TerminalRecord) CandidateSchema() string

CandidateSchema returns the immutable v3 candidate schema class.

func (TerminalRecord) CurrentGeneration

func (r TerminalRecord) CurrentGeneration() uint64

CurrentGeneration returns the exact terminal current-pointer fence.

func (TerminalRecord) Operation

func (r TerminalRecord) Operation() OperationBinding

Operation returns the protected terminal operation identity.

func (TerminalRecord) Reason

func (r TerminalRecord) Reason() string

Reason returns the closed terminal reason class.

func (TerminalRecord) RecordedAt

func (r TerminalRecord) RecordedAt() time.Time

RecordedAt returns the exact UTC terminal timestamp.

func (TerminalRecord) SourceGeneration

func (r TerminalRecord) SourceGeneration() uint64

SourceGeneration returns the frozen source generation.

func (TerminalRecord) SourceSchema

func (r TerminalRecord) SourceSchema() string

SourceSchema returns the exact frozen source datasource schema class.

func (TerminalRecord) State

func (r TerminalRecord) State() TerminalState

State returns the closed terminal outcome class.

func (TerminalRecord) Valid

func (r TerminalRecord) Valid() bool

Valid accepts only exact campaign terminal evidence and closed reason classes.

type TerminalRecorder

type TerminalRecorder interface {
	RecordTerminal(context.Context, TerminalRecord) error
	ReadTerminal(context.Context, OperationBinding) (TerminalRecord, bool, error)
}

TerminalRecorder persists and reads exact one-way campaign terminal evidence.

type TerminalState

type TerminalState string

TerminalState identifies the one-way durable outcome of a campaign.

const (
	// TerminalClosed proves a campaign candidate became the exact current generation.
	TerminalClosed TerminalState = "closed"
	// TerminalAborted proves a nonactivating candidate was explicitly retired.
	TerminalAborted TerminalState = "aborted"
)

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL