Documentation
¶
Overview ¶
Package datasourceadmin owns provider-neutral offline datasource administration.
Index ¶
- Constants
- func AllocateGeneration(inventory Inventory, limits GenerationLimits) (uint64, error)
- func NewAuditReceipt(target admincontract.PurgeTarget, operationClass string, destroyedAt time.Time, ...) (admincontract.AuditReceipt, error)
- func NewError(code ErrorCode) error
- func RetentionAuthorityCommitment(backend BackendClass, authority AuthorityDescriptor) (admincontract.Digest, error)
- func RetentionInventoryVersion(inventory RetentionInventory, policyVersion string) (string, error)
- func RetentionPolicyCommitment(policy RetentionPolicy) (admincontract.Digest, error)
- func ValidateAuthority(backend BackendClass, descriptor AuthorityDescriptor) error
- func ValidateDNSPolicy(policy DNSPolicy) error
- func ValidateHandleDeclaration(value string) error
- func ValidateInventory(inventory Inventory, limits GenerationLimits) error
- func ValidatePurgeAuthority(backend BackendClass, descriptor AuthorityDescriptor) error
- type Activation
- func (a Activation) CandidateGeneration() uint64
- func (a Activation) ExpectedCurrent() uint64
- func (Activation) Format(state fmt.State, _ rune)
- func (Activation) GoString() string
- func (a Activation) Lock() AdministrationLock
- func (Activation) MarshalJSON() ([]byte, error)
- func (a Activation) Operation() OperationBinding
- func (a Activation) Prepared() PreparedEvidence
- func (a Activation) Staged() StagedEvidence
- func (Activation) String() string
- func (a Activation) Valid() bool
- type AdministrationLock
- func (AdministrationLock) Format(state fmt.State, _ rune)
- func (AdministrationLock) GoString() string
- func (AdministrationLock) MarshalJSON() ([]byte, error)
- func (l AdministrationLock) Owner() OperationBinding
- func (l AdministrationLock) Revision() uint64
- func (AdministrationLock) String() string
- func (l AdministrationLock) ValidFor(operation OperationBinding) bool
- type AdministrationLockObservation
- func (o AdministrationLockObservation) Claimed() bool
- func (AdministrationLockObservation) Format(state fmt.State, _ rune)
- func (AdministrationLockObservation) GoString() string
- func (AdministrationLockObservation) MarshalJSON() ([]byte, error)
- func (o AdministrationLockObservation) Owner() OperationBinding
- func (o AdministrationLockObservation) Revision() uint64
- func (AdministrationLockObservation) String() string
- func (o AdministrationLockObservation) Valid() bool
- type AdministrationLocker
- type AllocatedCredential
- type AuditLog
- func (l *AuditLog) Append(receipt admincontract.AuditReceipt) error
- func (l *AuditLog) Close() error
- func (l *AuditLog) Commitments() ([]admincontract.Digest, error)
- func (l *AuditLog) Count() uint32
- func (*AuditLog) Format(state fmt.State, _ rune)
- func (*AuditLog) GoString() string
- func (*AuditLog) MarshalJSON() ([]byte, error)
- func (*AuditLog) String() string
- type AuthorityDescriptor
- type AuthorityEndpoint
- type BackendClass
- type CandidateContent
- func (c *CandidateContent) Close() error
- func (*CandidateContent) Format(state fmt.State, _ rune)
- func (c *CandidateContent) Generation() uint64
- func (*CandidateContent) GoString() string
- func (*CandidateContent) MarshalJSON() ([]byte, error)
- func (*CandidateContent) String() string
- func (c *CandidateContent) WithRows(ctx context.Context, use func(Rows) error) error
- type CandidateContentDigest
- func (d CandidateContentDigest) Bytes() []byte
- func (d CandidateContentDigest) Equal(other CandidateContentDigest) bool
- func (CandidateContentDigest) Format(state fmt.State, _ rune)
- func (CandidateContentDigest) GoString() string
- func (CandidateContentDigest) MarshalJSON() ([]byte, error)
- func (CandidateContentDigest) String() string
- func (d CandidateContentDigest) Valid() bool
- type CollisionInventory
- func (i *CollisionInventory) CandidateGeneration() uint64
- func (i *CollisionInventory) Close() error
- func (*CollisionInventory) Format(state fmt.State, _ rune)
- func (*CollisionInventory) GoString() string
- func (i *CollisionInventory) HandleIDUsed(value string) bool
- func (*CollisionInventory) MarshalJSON() ([]byte, error)
- func (i *CollisionInventory) OperationUsed(value OperationBinding) bool
- func (i *CollisionInventory) PolicyUsed(tenantID, domain, use string) bool
- func (i *CollisionInventory) ProfileIDUsed(value string) bool
- func (i *CollisionInventory) SelectorUsed(value string) bool
- func (*CollisionInventory) String() string
- func (i *CollisionInventory) TakePlanSource(lock AdministrationLock) (*PlanSource, error)
- func (i *CollisionInventory) ValidFor(lock AdministrationLock) bool
- type CollisionSnapshot
- type CredentialRow
- type DNSPolicy
- type DomainAddition
- func (a *DomainAddition) Close() error
- func (*DomainAddition) Format(state fmt.State, _ rune)
- func (*DomainAddition) GoString() string
- func (*DomainAddition) MarshalJSON() ([]byte, error)
- func (a *DomainAddition) NewSnapshot(schema string, generation uint64) (*Snapshot, error)
- func (*DomainAddition) String() string
- type DomainCredential
- type Error
- type ErrorCode
- type GenerationInfo
- type GenerationLimits
- type GenerationPublisher
- type GenerationState
- type HandleRow
- type IdentityProjection
- func (p *IdentityProjection) Close() error
- func (*IdentityProjection) Format(state fmt.State, _ rune)
- func (*IdentityProjection) GoString() string
- func (p *IdentityProjection) HandleIDUsed(value string) bool
- func (*IdentityProjection) MarshalJSON() ([]byte, error)
- func (p *IdentityProjection) Merge(other *IdentityProjection) error
- func (p *IdentityProjection) PolicyUsed(tenantID, domain, use string) bool
- func (p *IdentityProjection) ProfileIDUsed(value string) bool
- func (p *IdentityProjection) SelectorUsed(value string) bool
- func (*IdentityProjection) String() string
- type Inventory
- type KeyMaterialRow
- type LDAPAuthority
- type OperationBinding
- func (b OperationBinding) Equal(other OperationBinding) bool
- func (OperationBinding) Format(state fmt.State, _ rune)
- func (OperationBinding) GoString() string
- func (b OperationBinding) Initialized() bool
- func (OperationBinding) MarshalJSON() ([]byte, error)
- func (OperationBinding) String() string
- func (b OperationBinding) WithValue(ctx context.Context, use func(string) error) error
- type PlanDigest
- type PlanIntent
- type PlanProjection
- type PlanSource
- func (s *PlanSource) Clone() (*PlanSource, error)
- func (s *PlanSource) Close() error
- func (*PlanSource) Format(state fmt.State, _ rune)
- func (s *PlanSource) Generation() uint64
- func (*PlanSource) GoString() string
- func (*PlanSource) MarshalJSON() ([]byte, error)
- func (s *PlanSource) SchemaVersion() string
- func (*PlanSource) String() string
- func (s *PlanSource) WithRows(ctx context.Context, use func(Rows) error) error
- type PolicyRow
- type PreparedEvidence
- func (p PreparedEvidence) Digest() CandidateContentDigest
- func (PreparedEvidence) Format(state fmt.State, _ rune)
- func (PreparedEvidence) GoString() string
- func (PreparedEvidence) MarshalJSON() ([]byte, error)
- func (p PreparedEvidence) Matches(staged StagedEvidence) bool
- func (PreparedEvidence) String() string
- type ProfileRow
- type PublicationEnvelope
- func (e *PublicationEnvelope) Binding() OperationBinding
- func (e *PublicationEnvelope) Close() error
- func (e *PublicationEnvelope) Digest() CandidateContentDigest
- func (*PublicationEnvelope) Format(state fmt.State, _ rune)
- func (e *PublicationEnvelope) Generation() uint64
- func (*PublicationEnvelope) GoString() string
- func (*PublicationEnvelope) MarshalJSON() ([]byte, error)
- func (e *PublicationEnvelope) PreparedEvidence() PreparedEvidence
- func (e *PublicationEnvelope) SourceGeneration() uint64
- func (*PublicationEnvelope) String() string
- func (e *PublicationEnvelope) WithMetadata(ctx context.Context, ...) error
- func (e *PublicationEnvelope) WithRows(ctx context.Context, use func(Rows) error) error
- type PublicationObservation
- func (o PublicationObservation) CandidateGeneration() uint64
- func (o PublicationObservation) CurrentGeneration() uint64
- func (PublicationObservation) Format(state fmt.State, _ rune)
- func (PublicationObservation) GoString() string
- func (PublicationObservation) MarshalJSON() ([]byte, error)
- func (o PublicationObservation) OldCurrentWasActive() bool
- func (o PublicationObservation) Operation() OperationBinding
- func (o PublicationObservation) Staged() StagedEvidence
- func (o PublicationObservation) State() PublicationState
- func (PublicationObservation) String() string
- func (o PublicationObservation) Valid() bool
- type PublicationState
- type PurgeCommand
- func (c PurgeCommand) AuthorityCommitment() admincontract.Digest
- func (c PurgeCommand) Clear()
- func (c PurgeCommand) CurrentGeneration() uint64
- func (c PurgeCommand) PlanDigest() admincontract.Digest
- func (c PurgeCommand) PolicyVersion() string
- func (c PurgeCommand) WithTargets(ctx context.Context, use func([]admincontract.PurgeTarget) error) error
- type PurgeExecutionResult
- type PurgeExecutor
- type PurgeReconciler
- type RetentionClassification
- func (c *RetentionClassification) CurrentGeneration() uint64
- func (c *RetentionClassification) Eligible(generation uint64) bool
- func (c *RetentionClassification) EligibleCount() int
- func (c *RetentionClassification) EligibleTargets() []RetentionGeneration
- func (*RetentionClassification) Format(state fmt.State, _ rune)
- func (*RetentionClassification) GoString() string
- func (c *RetentionClassification) InventoryVersion() string
- func (*RetentionClassification) MarshalJSON() ([]byte, error)
- func (c *RetentionClassification) Policy() RetentionPolicy
- func (c *RetentionClassification) Reason(generation uint64) RetentionReason
- func (c *RetentionClassification) RetainedCount() uint32
- func (*RetentionClassification) String() string
- func (c *RetentionClassification) UnresolvedCount() uint32
- type RetentionDecision
- type RetentionGeneration
- type RetentionInventory
- type RetentionInventoryReader
- type RetentionOwnership
- type RetentionPolicy
- type RetentionReason
- type RetentionRecoveryLimits
- type RetentionRecoveryReader
- type Rows
- type SQLAuthority
- type Snapshot
- func (s *Snapshot) AddDomain(schema string, generation uint64, addition *DomainAddition) (*Snapshot, error)
- func (s *Snapshot) CloneTo(schema string, generation uint64) (*Snapshot, error)
- func (s *Snapshot) Close() error
- func (*Snapshot) Format(state fmt.State, _ rune)
- func (s *Snapshot) Generation() uint64
- func (*Snapshot) GoString() string
- func (s *Snapshot) IdentityProjection(ctx context.Context) (*IdentityProjection, error)
- func (*Snapshot) MarshalJSON() ([]byte, error)
- func (s *Snapshot) PlanSource(ctx context.Context) (*PlanSource, error)
- func (s *Snapshot) SchemaVersion() string
- func (*Snapshot) String() string
- func (s *Snapshot) WithRows(ctx context.Context, use func(Rows) error) error
- type SnapshotReader
- type StagedEvidence
- type TerminalRecord
- func (r TerminalRecord) CandidateDigest() CandidateContentDigest
- func (r TerminalRecord) CandidateGeneration() uint64
- func (r TerminalRecord) CandidateSchema() string
- func (r TerminalRecord) CurrentGeneration() uint64
- func (r TerminalRecord) Operation() OperationBinding
- func (r TerminalRecord) Reason() string
- func (r TerminalRecord) RecordedAt() time.Time
- func (r TerminalRecord) SourceGeneration() uint64
- func (r TerminalRecord) SourceSchema() string
- func (r TerminalRecord) State() TerminalState
- func (r TerminalRecord) Valid() bool
- type TerminalRecorder
- type TerminalState
Constants ¶
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 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 ¶
ValidateDNSPolicy rejects resolver and proof policy outside the canonical plan grammar.
func ValidateHandleDeclaration ¶
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 ¶
func (l AdministrationLock) Owner() OperationBinding
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 ¶
func (AdministrationLockObservation) GoString() string
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 ¶
func (o AdministrationLockObservation) Owner() OperationBinding
Owner returns the protected exact owner or zero for ownerless state.
func (AdministrationLockObservation) Revision ¶
func (o AdministrationLockObservation) Revision() uint64
Revision returns the exact backend administration revision.
func (AdministrationLockObservation) String ¶
func (AdministrationLockObservation) String() string
String returns a constant protected lock-observation representation.
func (AdministrationLockObservation) Valid ¶
func (o AdministrationLockObservation) Valid() bool
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 ¶
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 ¶
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) Commitments ¶
func (l *AuditLog) Commitments() ([]admincontract.Digest, error)
Commitments returns detached key-free receipt commitments in stable retention order.
func (*AuditLog) MarshalJSON ¶
MarshalJSON rejects generic audit serialization.
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 ¶
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.
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 ¶
func (d CandidateContentDigest) Equal(other CandidateContentDigest) bool
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) MarshalJSON ¶
MarshalJSON rejects generic protected DNS-policy serialization.
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.
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 ErrorCode = "unavailable" // CodeReconcileRequired reports an ambiguous mutation outcome. CodeReconcileRequired ErrorCode = "reconcile_required" )
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 GenerationPublisher ¶
type GenerationPublisher interface {
Current(context.Context, GenerationLimits) (GenerationInfo, error)
Stage(context.Context, AdministrationLock, OperationBinding, *PublicationEnvelope) (StagedEvidence, error)
Inspect(context.Context, OperationBinding, uint64, uint64, GenerationLimits) (*PublicationEnvelope, GenerationInfo, error)
Observe(context.Context, OperationBinding, uint64, uint64, GenerationLimits) (PublicationObservation, error)
Activate(context.Context, Activation) error
}
GenerationPublisher stages, inspects, and atomically activates generations.
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) MarshalJSON ¶
MarshalJSON rejects generic protected handle-row serialization.
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 ¶
Canonicalize sorts one detached inventory by generation for stable comparison.
func (Inventory) Equivalent ¶
Equivalent reports whether two bounded inventories contain identical ordered evidence.
func (Inventory) MarshalJSON ¶
MarshalJSON rejects generic protected inventory serialization.
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.
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.
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) MarshalJSON ¶
MarshalJSON rejects generic protected policy-row serialization.
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 ¶
func (p PreparedEvidence) Digest() CandidateContentDigest
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 ¶
func (e *PublicationEnvelope) Binding() OperationBinding
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 ¶
func (e *PublicationEnvelope) Digest() CandidateContentDigest
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 ¶
func (e *PublicationEnvelope) WithMetadata( ctx context.Context, use func(OperationBinding, uint64, CandidateContentDigest) error, ) error
WithMetadata supplies protected operation and digest metadata to a bounded provider callback.
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 ¶
func (o PublicationObservation) Operation() OperationBinding
Operation returns exact operation evidence for an exact candidate.
func (PublicationObservation) Staged ¶
func (o PublicationObservation) Staged() StagedEvidence
Staged returns exact candidate digest evidence for an exact candidate.
func (PublicationObservation) State ¶
func (o PublicationObservation) State() PublicationState
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 ¶
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 ¶
func (c *RetentionClassification) Policy() RetentionPolicy
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 ¶
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) MarshalJSON ¶
MarshalJSON rejects generic protected row-set serialization.
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 ¶
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 ¶
CloneTo creates a complete identical logical generation with a higher number.
func (*Snapshot) Close ¶
Close destroys all retained public and private key bytes and invalidates the snapshot.
func (*Snapshot) Generation ¶
Generation returns the exact generation or zero after close.
func (*Snapshot) IdentityProjection ¶
func (s *Snapshot) IdentityProjection(ctx context.Context) (*IdentityProjection, error)
IdentityProjection returns a detached protected collision index.
func (*Snapshot) MarshalJSON ¶
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 ¶
SchemaVersion returns the closed schema identifier or empty after close.
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 ¶
func (s StagedEvidence) Digest() CandidateContentDigest
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" )