services

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

type AgreementDeliveryDetail struct {
	AgreementID          string   `json:"agreement_id"`
	ExecutedStatus       string   `json:"executed_status"`
	CertificateStatus    string   `json:"certificate_status"`
	DistributionStatus   string   `json:"distribution_status"`
	ExecutedObjectKey    string   `json:"executed_object_key,omitempty"`
	CertificateObjectKey string   `json:"certificate_object_key,omitempty"`
	LastError            string   `json:"last_error,omitempty"`
	CorrelationIDs       []string `json:"correlation_ids,omitempty"`
}

type AgreementEmailWorkflow interface {
	OnAgreementSent(ctx context.Context, scope stores.Scope, notification AgreementNotification) error
	OnAgreementResent(ctx context.Context, scope stores.Scope, notification AgreementNotification) error
}

type AgreementNotification struct {
	AgreementID   string
	RecipientID   string
	CorrelationID string
	Type          AgreementNotificationType
	Token         stores.IssuedSigningToken
}

type AgreementNotificationType string

type AgreementPlacementOrchestrator interface {
	Run(ctx context.Context, input placementengine.RunInput) (placementmodels.Run, error)
}

type AgreementPlacementPolicyResolver interface {
	Resolve(ctx context.Context, input placementengine.PolicyResolveInput) (placementmodels.Policy, error)
}

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

type AgreementServiceOption func(*AgreementService)

type AgreementTokenService interface {
	Issue(ctx context.Context, scope stores.Scope, agreementID, recipientID string) (stores.IssuedSigningToken, error)
	Rotate(ctx context.Context, scope stores.Scope, agreementID, recipientID string) (stores.IssuedSigningToken, error)
	Revoke(ctx context.Context, scope stores.Scope, agreementID, recipientID string) error
}

type AgreementValidationResult struct {
	Valid          bool
	RecipientCount int
	FieldCount     int
	Issues         []ValidationIssue
}

type ApplyPlacementRunInput struct {
	UserID          string                `json:"user_id"`
	SuggestionIDs   []string              `json:"suggestion_ids"`
	ManualOverrides []ManuallyPlacedField `json:"manual_overrides"`
}

type ApplyPlacementRunResult struct {
	Run              stores.PlacementRunRecord    `json:"run"`
	AppliedInstances []stores.FieldInstanceRecord `json:"applied_instances"`
}

type ArtifactPipelineOption func(*ArtifactPipelineService)

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

type ArtifactRenderer interface {
	RenderExecuted(ctx context.Context, input ExecutedRenderInput) (RenderedArtifact, error)
	RenderCertificate(ctx context.Context, input CertificateRenderInput) (RenderedArtifact, error)
}

type AutoPlacementRunInput struct {
	UserID         string                   `json:"user_id"`
	PolicyOverride *PlacementPolicyOverride `json:"policy_override"`
	NativeFields   []NativePlacementField   `json:"native_form_fields"`
}

type AutoPlacementRunResult struct {
	Run stores.PlacementRunRecord `json:"run"`
}

type CertificateRenderInput struct {
	Scope          stores.Scope
	Agreement      stores.AgreementRecord
	Recipients     []stores.RecipientRecord
	Events         []stores.AuditEventRecord
	ExecutedSHA256 string
	CorrelationID  string
}

type CreateDraftInput struct {
	DocumentID             string
	Title                  string
	Message                string
	CreatedByUserID        string
	SourceType             string
	SourceGoogleFileID     string
	SourceGoogleDocURL     string
	SourceModifiedTime     *time.Time
	SourceExportedAt       *time.Time
	SourceExportedByUserID string
	SourceMimeType         string
	SourceIngestionMode    string
}

type CredentialCipher interface {
	Encrypt(ctx context.Context, plaintext string) (string, error)
	Decrypt(ctx context.Context, ciphertext string) (string, error)
}

type CredentialKeyVersioner interface {
	PrimaryKeyID() string
	CiphertextKeyID(ciphertext string) string
}

type DetectConflictInput struct {
	RunID          string
	BindingID      string
	Provider       string
	EntityKind     string
	ExternalID     string
	InternalID     string
	Reason         string
	Payload        map[string]any
	IdempotencyKey string
}

type DeterministicArtifactRenderer struct{}

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

type DocumentMetadata struct {
	SHA256    string
	SizeBytes int64
	PageCount int
}

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

type DocumentServiceOption func(*DocumentService)

type DocumentUploadInput struct {
	ID                     string
	Title                  string
	ObjectKey              string
	PDF                    []byte
	CreatedBy              string
	UploadedAt             time.Time
	SourceType             string
	SourceGoogleFileID     string
	SourceGoogleDocURL     string
	SourceModifiedTime     *time.Time
	SourceExportedAt       *time.Time
	SourceExportedByUserID string
	SourceMimeType         string
	SourceIngestionMode    string
}

type DraftCreateInput struct {
	WizardID        string
	WizardState     map[string]any
	Title           string
	CurrentStep     int
	DocumentID      string
	CreatedByUserID string
}

type DraftListInput struct {
	CreatedByUserID string
	Limit           int
	Cursor          string
}

type DraftSendInput struct {
	ExpectedRevision int64
	CreatedByUserID  string
}

type DraftSendResult struct {
	AgreementID  string
	Status       string
	DraftID      string
	DraftDeleted bool
}

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

type DraftServiceOption func(*DraftService)

type DraftUpdateInput struct {
	ExpectedRevision int64
	WizardState      map[string]any
	Title            string
	CurrentStep      int
	DocumentID       *string
	UpdatedByUserID  string
}

type EnvGoogleCredentialKeyProvider struct {
	ActiveKeyIDEnv string
	ActiveKeyEnv   string
	KeysJSONEnv    string
}

type ErrorCode string

type ExecutedRenderInput struct {
	Scope         stores.Scope
	Agreement     stores.AgreementRecord
	Recipients    []stores.RecipientRecord
	Fields        []stores.FieldRecord
	FieldValues   []stores.FieldValueRecord
	CorrelationID string
}

type ExpireInput struct {
	Reason string
}

type GoogleAccountInfo struct {
	AccountID  string     `json:"account_id"`
	Email      string     `json:"email"`
	Status     string     `json:"status"` // connected, expired, needs_reauth, degraded
	Scopes     []string   `json:"scopes"`
	ExpiresAt  *time.Time `json:"expires_at,omitempty"`
	CreatedAt  time.Time  `json:"created_at"`
	LastUsedAt *time.Time `json:"last_used_at,omitempty"`
	IsDefault  bool       `json:"is_default"`
}

type GoogleAgreementCreator interface {
	CreateDraft(ctx context.Context, scope stores.Scope, input CreateDraftInput) (stores.AgreementRecord, error)
}

type GoogleConnectInput struct {
	UserID      string
	AccountID   string
	AuthCode    string
	RedirectURI string
}

type GoogleCredentialKeyProvider interface {
	Resolve(ctx context.Context) (GoogleCredentialKeyring, error)
}

type GoogleCredentialKeyring struct {
	ActiveKeyID string
	Keys        map[string][]byte
}

type GoogleDocumentUploader interface {
	Upload(ctx context.Context, scope stores.Scope, input DocumentUploadInput) (stores.DocumentRecord, error)
}

type GoogleDriveFile struct {
	ID           string    `json:"id"`
	Name         string    `json:"name"`
	MimeType     string    `json:"mimeType"`
	WebViewURL   string    `json:"webViewLink,omitempty"`
	OwnerEmail   string    `json:"ownerEmail,omitempty"`
	ParentID     string    `json:"parentId,omitempty"`
	ModifiedTime time.Time `json:"modifiedTime"`
}

type GoogleDriveListResult struct {
	Files         []GoogleDriveFile
	NextPageToken string
}

type GoogleDriveQueryInput struct {
	UserID    string
	AccountID string
	Query     string
	FolderID  string
	PageToken string
	PageSize  int
}

type GoogleExportSnapshot struct {
	File GoogleDriveFile
	PDF  []byte
}

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

type GoogleHTTPProviderConfig struct {
	ClientID         string
	ClientSecret     string
	TokenEndpoint    string
	RevokeEndpoint   string
	DriveBaseURL     string
	UserInfoEndpoint string
	HealthEndpoint   string
	HTTPClient       *http.Client
}

type GoogleImportInput struct {
	UserID          string
	AccountID       string
	GoogleFileID    string
	DocumentTitle   string
	AgreementTitle  string
	CreatedByUserID string
}

type GoogleImportResult struct {
	Document       stores.DocumentRecord
	Agreement      stores.AgreementRecord
	SourceMimeType string
	IngestionMode  string
}

type GoogleIntegrationOption func(*GoogleIntegrationService)

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

type GoogleOAuthStatus struct {
	Provider             string     `json:"provider"`
	ProviderMode         string     `json:"provider_mode"`
	UserID               string     `json:"user_id"`
	AccountID            string     `json:"account_id,omitempty"`
	Connected            bool       `json:"connected"`
	AccountEmail         string     `json:"account_email,omitempty"`
	Scopes               []string   `json:"scopes"`
	ExpiresAt            *time.Time `json:"expires_at,omitempty"`
	IsExpired            bool       `json:"is_expired"`
	IsExpiringSoon       bool       `json:"is_expiring_soon"`
	CanAutoRefresh       bool       `json:"can_auto_refresh"`
	NeedsReauthorization bool       `json:"needs_reauthorization"`
	LeastPrivilege       bool       `json:"least_privilege"`
	Healthy              bool       `json:"healthy"`
	Degraded             bool       `json:"degraded"`
	DegradedReason       string     `json:"degraded_reason,omitempty"`
	HealthCheckedAt      *time.Time `json:"health_checked_at,omitempty"`
}

type GoogleOAuthToken struct {
	AccessToken  string
	RefreshToken string
	Scopes       []string
	ExpiresAt    time.Time
	AccountEmail string
}

type GoogleProvider interface {
	ExchangeCode(ctx context.Context, authCode, redirectURI string, requestedScopes []string) (GoogleOAuthToken, error)
	RevokeToken(ctx context.Context, accessToken string) error
	SearchFiles(ctx context.Context, accessToken, query, pageToken string, pageSize int) (GoogleDriveListResult, error)
	BrowseFiles(ctx context.Context, accessToken, folderID, pageToken string, pageSize int) (GoogleDriveListResult, error)
	GetFile(ctx context.Context, accessToken, fileID string) (GoogleDriveFile, error)
	ExportFilePDF(ctx context.Context, accessToken, fileID string) (GoogleExportSnapshot, error)
	DownloadFilePDF(ctx context.Context, accessToken, fileID string) (GoogleExportSnapshot, error)
}

type GoogleProviderError struct {
	Code     GoogleProviderErrorCode
	Message  string
	Metadata map[string]any
}

type GoogleProviderErrorCode string

type GoogleProviderHealthStatus struct {
	Mode      string
	Healthy   bool
	Reason    string
	CheckedAt *time.Time
}

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

type InboundApplyInput struct {
	Provider         string
	EntityKind       string
	ExternalID       string
	AgreementID      string
	MetadataTitle    string
	MetadataMessage  string
	Participants     []InboundParticipantInput
	FieldDefinitions []InboundFieldDefinitionInput
	IdempotencyKey   string
}

type InboundApplyResult struct {
	AgreementID          string
	ParticipantCount     int
	FieldDefinitionCount int
	Replay               bool
}

type InboundFieldDefinitionInput struct {
	FieldDefinitionID     string
	ParticipantID         string
	ParticipantExternalID string
	Type                  string
	Required              bool
	ValidationJSON        string
	PageNumber            int
	X                     float64
	Y                     float64
	Width                 float64
	Height                float64
	TabIndex              int
	Label                 string
	AppearanceJSON        string
}

type InboundParticipantInput struct {
	ExternalID   string
	Email        string
	Name         string
	Role         string
	SigningStage int
}

type IntegrationFoundationOption func(*IntegrationFoundationService)

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

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

type ManuallyPlacedField struct {
	FieldInstanceID   string  `json:"field_instance_id"`
	FieldDefinitionID string  `json:"field_definition_id"`
	PageNumber        int     `json:"page_number"`
	X                 float64 `json:"x"`
	Y                 float64 `json:"y"`
	Width             float64 `json:"width"`
	Height            float64 `json:"height"`
	TabIndex          *int    `json:"tab_index"`
	Label             string  `json:"label"`
}

type MappingCompileInput struct {
	ID              string
	Provider        string
	Name            string
	Version         int64
	Status          string
	CreatedByUserID string
	UpdatedByUserID string
	ExternalSchema  stores.ExternalSchema
	Rules           []stores.MappingRule
}

type MappingCompileResult struct {
	Spec          stores.MappingSpecRecord
	CanonicalJSON string
	Hash          string
	Warnings      []string
}

type NativePlacementField struct {
	Name          string  `json:"name"`
	FieldTypeHint string  `json:"field_type_hint"`
	PageNumber    int     `json:"page_number"`
	X             float64 `json:"x"`
	Y             float64 `json:"y"`
	Width         float64 `json:"width"`
	Height        float64 `json:"height"`
}

type OutboundChangeInput struct {
	Provider       string
	AgreementID    string
	EventType      string
	SourceEventID  string
	Payload        map[string]any
	IdempotencyKey string
}

type PlacementDocumentObjectStore interface {
	GetFile(ctx context.Context, path string) ([]byte, error)
}

type PlacementPolicyOverride struct {
	EnabledResolvers []string `json:"enabled_resolvers"`
	HardOrder        []string `json:"hard_order"`
	Weights          struct {
		Accuracy float64 `json:"accuracy"`
		Cost     float64 `json:"cost"`
		Latency  float64 `json:"latency"`
	} `json:"weights"`
	MaxBudget float64 `json:"max_budget"`
	MaxTimeMS int64   `json:"max_time_ms"`
}

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

type ReadableArtifactRendererOption func(*ReadableArtifactRenderer)

type RenderedArtifact struct {
	ObjectKey string
	SHA256    string
	Payload   []byte
}

type ResendInput struct {
	RecipientID           string
	RotateToken           bool
	InvalidateExisting    bool
	AllowOutOfOrderResend bool
	IdempotencyKey        string
}

type ResendResult struct {
	Agreement       stores.AgreementRecord
	Recipient       stores.RecipientRecord
	ActiveRecipient stores.RecipientRecord
	Token           stores.IssuedSigningToken
}

type ResolveConflictInput struct {
	ConflictID       string
	Status           string
	Resolution       map[string]any
	ResolvedByUserID string
	IdempotencyKey   string
}

type SaveCheckpointInput struct {
	RunID         string
	CheckpointKey string
	Cursor        string
	Payload       map[string]any
}

type SendInput struct {
	IdempotencyKey string
}

type SignerAssetContract struct {
	AgreementID               string `json:"agreement_id"`
	AgreementStatus           string `json:"agreement_status"`
	RecipientID               string `json:"recipient_id"`
	RecipientRole             string `json:"recipient_role"`
	SourceDocumentAvailable   bool   `json:"source_document_available"`
	ExecutedArtifactAvailable bool   `json:"executed_artifact_available"`
	CertificateAvailable      bool   `json:"certificate_available"`
	SourceObjectKey           string `json:"-"`
	ExecutedObjectKey         string `json:"-"`
	CertificateObjectKey      string `json:"-"`
}

type SignerAssetContractOption func(*SignerAssetContractService)

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

type SignerConsentInput struct {
	Accepted  bool   `json:"accepted"`
	IPAddress string `json:"-"`
	UserAgent string `json:"-"`
}

type SignerConsentResult struct {
	AcceptedAt time.Time `json:"accepted_at"`
}

type SignerDeclineInput struct {
	Reason    string `json:"reason"`
	IPAddress string `json:"-"`
	UserAgent string `json:"-"`
}

type SignerDeclineResult struct {
	Agreement stores.AgreementRecord `json:"agreement"`
	Recipient stores.RecipientRecord `json:"recipient"`
}

type SignerFieldValueInput struct {
	FieldID           string `json:"field_id,omitempty"`
	FieldInstanceID   string `json:"field_instance_id,omitempty"`
	FieldDefinitionID string `json:"field_definition_id,omitempty"`
	ValueText         string `json:"value_text,omitempty"`
	ValueBool         *bool  `json:"value_bool,omitempty"`
	ExpectedVersion   int64  `json:"expected_version,omitempty"`
	IPAddress         string `json:"-"`
	UserAgent         string `json:"-"`
}

type SignerSessionContext struct {
	AgreementID            string                     `json:"agreement_id"`
	AgreementStatus        string                     `json:"agreement_status"`
	DocumentName           string                     `json:"document_name"`
	PageCount              int                        `json:"page_count"`
	Viewer                 SignerSessionViewerContext `json:"viewer"`
	RecipientID            string                     `json:"recipient_id"`
	RecipientRole          string                     `json:"recipient_role"`
	RecipientEmail         string                     `json:"recipient_email"`
	RecipientName          string                     `json:"recipient_name"`
	RecipientOrder         int                        `json:"recipient_order"`
	RecipientStage         int                        `json:"recipient_stage,omitempty"`
	ActiveStage            int                        `json:"active_stage,omitempty"`
	State                  string                     `json:"state"`
	ActiveRecipientID      string                     `json:"active_recipient_id,omitempty"`
	ActiveRecipientIDs     []string                   `json:"active_recipient_ids,omitempty"`
	WaitingForRecipient    string                     `json:"waiting_for_recipient_id,omitempty"`
	WaitingForRecipientIDs []string                   `json:"waiting_for_recipient_ids,omitempty"`
	Fields                 []SignerSessionField       `json:"fields"`
}

type SignerSessionField struct {
	ID                string  `json:"id"`
	FieldInstanceID   string  `json:"field_instance_id"`
	FieldDefinitionID string  `json:"field_definition_id"`
	RecipientID       string  `json:"recipient_id"`
	Type              string  `json:"type"`
	Page              int     `json:"page"`
	PosX              float64 `json:"pos_x"`
	PosY              float64 `json:"pos_y"`
	Width             float64 `json:"width"`
	Height            float64 `json:"height"`
	PageWidth         float64 `json:"page_width,omitempty"`
	PageHeight        float64 `json:"page_height,omitempty"`
	PageRotation      int     `json:"page_rotation"`
	Required          bool    `json:"required"`
	Label             string  `json:"label,omitempty"`
	TabIndex          int     `json:"tab_index,omitempty"`
	ValueText         string  `json:"value_text,omitempty"`
	ValueBool         *bool   `json:"value_bool,omitempty"`
}

type SignerSessionViewerContext struct {
	CoordinateSpace string                    `json:"coordinate_space"`
	ContractVersion string                    `json:"contract_version,omitempty"`
	Unit            string                    `json:"unit,omitempty"`
	Origin          string                    `json:"origin,omitempty"`
	YAxisDirection  string                    `json:"y_axis_direction,omitempty"`
	Pages           []SignerSessionViewerPage `json:"pages,omitempty"`
}

type SignerSessionViewerPage struct {
	Page     int     `json:"page"`
	Width    float64 `json:"width"`
	Height   float64 `json:"height"`
	Rotation int     `json:"rotation"`
}

type SignerSignatureInput struct {
	FieldID           string `json:"field_id,omitempty"`
	FieldInstanceID   string `json:"field_instance_id,omitempty"`
	FieldDefinitionID string `json:"field_definition_id,omitempty"`
	Type              string `json:"type"`
	ObjectKey         string `json:"object_key"`
	SHA256            string `json:"sha256"`
	UploadToken       string `json:"upload_token,omitempty"`
	ValueText         string `json:"value_text,omitempty"`
	ExpectedVersion   int64  `json:"expected_version,omitempty"`
	IPAddress         string `json:"-"`
	UserAgent         string `json:"-"`
}

type SignerSignatureResult struct {
	Artifact   stores.SignatureArtifactRecord `json:"artifact"`
	FieldValue stores.FieldValueRecord        `json:"field_value"`
}

type SignerSignatureUploadCommitInput struct {
	UploadToken string `json:"upload_token"`
	ObjectKey   string `json:"object_key"`
	SHA256      string `json:"sha256"`
	ContentType string `json:"content_type"`
	SizeBytes   int64  `json:"size_bytes"`
	Payload     []byte `json:"-"`
	IPAddress   string `json:"-"`
	UserAgent   string `json:"-"`
}

type SignerSignatureUploadCommitResult struct {
	ObjectKey   string    `json:"object_key"`
	SHA256      string    `json:"sha256"`
	ContentType string    `json:"content_type"`
	SizeBytes   int64     `json:"size_bytes"`
	CommittedAt time.Time `json:"committed_at"`
}

type SignerSignatureUploadContract struct {
	UploadToken string         `json:"upload_token"`
	UploadURL   string         `json:"upload_url"`
	Method      string         `json:"method"`
	Headers     map[string]any `json:"headers,omitempty"`
	ObjectKey   string         `json:"object_key"`
	SHA256      string         `json:"sha256"`
	ContentType string         `json:"content_type"`
	SizeBytes   int64          `json:"size_bytes,omitempty"`
	ExpiresAt   time.Time      `json:"expires_at"`
}

type SignerSignatureUploadInput struct {
	FieldID           string `json:"field_id,omitempty"`
	FieldInstanceID   string `json:"field_instance_id,omitempty"`
	FieldDefinitionID string `json:"field_definition_id,omitempty"`
	SHA256            string `json:"sha256"`
	ContentType       string `json:"content_type,omitempty"`
	SizeBytes         int64  `json:"size_bytes,omitempty"`
	IPAddress         string `json:"-"`
	UserAgent         string `json:"-"`
}

type SignerSubmitInput struct {
	IdempotencyKey string `json:"idempotency_key"`
	IPAddress      string `json:"-"`
	UserAgent      string `json:"-"`
}

type SignerSubmitResult struct {
	Agreement        stores.AgreementRecord `json:"agreement"`
	Recipient        stores.RecipientRecord `json:"recipient"`
	NextRecipientID  string                 `json:"next_recipient_id,omitempty"`
	NextRecipientIDs []string               `json:"next_recipient_ids,omitempty"`
	NextStage        int                    `json:"next_stage,omitempty"`
	Completed        bool                   `json:"completed"`
	Replay           bool                   `json:"replay,omitempty"`
}

type SigningCompletionWorkflow interface {
	RunCompletionWorkflow(ctx context.Context, scope stores.Scope, agreementID, correlationID string) error
}

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

type SigningServiceOption func(*SigningService)

type StartSyncRunInput struct {
	Provider        string
	Direction       string
	MappingSpecID   string
	Cursor          string
	CreatedByUserID string
	IdempotencyKey  string
}

type SyncRunDiagnostics struct {
	Run         stores.IntegrationSyncRunRecord
	Checkpoints []stores.IntegrationCheckpointRecord
	Conflicts   []stores.IntegrationConflictRecord
}

type ValidationIssue struct {
	Code    string
	Field   string
	Message string
}

type VoidInput struct {
	Reason       string
	RevokeTokens bool
}