facade4datatug

type AccountPlanEffect struct {
	Fence                    PlanOwnerFence
	BuyerID                  string
	AccountKind              string
	PlanID                   string
	PlaceID                  string `json:",omitempty"`
	Tier                     string
	Period                   string
	Status                   string
	LastPaidEnd              time.Time
	ScheduledEnd             time.Time
	EffectiveEnd             time.Time
	PaidService              bool
	AppliedPercent           int
	LaunchGrant              bool
	Grants                   PlanEffectGrants
	Payments                 []PlanPayment
	CashBasisKnown           bool
	MoneyIngestEpoch         int64
	ObservedAt               time.Time
	CheckoutStartedAt        time.Time
	QuoteKey                 string
	PaidServiceProofID       string
	BasisOnly                bool
	SourceSubscriptionID     string
	SourceRevision           int64
	SourcePaidService        bool
	SourceQuoteKey           string
	SourcePaidServiceProofID string
	LastServiceRefund        *ServiceRefundProof
	TerminalFullRefund       bool `json:"terminalFullRefund,omitempty"`
}

type AccountPlanWriter struct {
	DB        dal.DB
	Owner     PlanEffectOwnerPort
	Personal  PersonalPlanOwnerPort
	Allocator PaidMonthAllocator
	Limits    ProLimitsResolver
	Clock     PlanClock
}

type AdmissionReader interface {
	ReadAdmission(context.Context, string, time.Time) (AdmissionState, error)
}

type AdmissionState struct {
	TodayUsed int64
	Blocked   string
}

type BusinessActivityActorVerifier interface {
	VerifyBusinessActivityActor(context.Context, dal.ReadTransaction, string) error
}

type BusinessActivityBinding struct {
	Period                                                  contract4paymentus.UsagePeriodRef
	PeriodStartUTC, PeriodEndUTC, PaidUntilUTC              time.Time
	PaidBindingProofID, PayerBindingDigest, QueryUseProofID string
	QueryUseAllowed                                         bool
}

type BusinessActivityBindingReader interface {
	ReadCurrentBusinessActivityBinding(context.Context, dal.ReadTransaction, string, string, string, time.Time) (BusinessActivityBinding, error)
}

type BusinessActivityBindingReaderOptions struct {
	Access        *BusinessProjectAccessVerifier
	InitialStarts contract4paymentus.InitialServiceStartReader
	Periods       contract4paymentus.UsagePeriodReader
	Contacts      CurrentProjectContactPort
	Actors        BusinessActivityActorVerifier
}

type BusinessProjectAccessPolicy struct {
	GrantVersion string
	// Mode is fixed by trusted server composition. Request values never select
	// the Paymentus environment.
	Mode contract4paymentus.Mode
}

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

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

type BusinessSharedProjectOptions struct {
	AccessPolicy  BusinessProjectAccessPolicy
	ServiceReader contract4paymentus.CurrentSpaceServiceReader
	ContactLinks  *PaidProjectOwnerLinksOptions
}

type BusinessUsageCloseTerms struct {
	Capacity           contract4paymentus.UsageCapacityEvidence
	BaseEvent          contract4paymentus.UsageBaseEvent
	BillMonthlyOverage bool
	DiscountPercent    int
}

type BusinessUsageCloseTermsReader interface {
	ReadBusinessUsageCloseTerms(context.Context, dal.ReadTransaction, contract4paymentus.UsagePeriodSnapshot) (BusinessUsageCloseTerms, error)
}

type BusinessUsageLifecycleResult struct {
	CheckpointsScanned int
	PeriodsOpened      int
	PeriodsClosed      int
	InvoicesProcessed  int
	ActivitySpaces     int
	ActivityScanned    int
	ActivityDelivered  int
	Failures           int
	CheckpointAfter    string
	PendingAfter       string
	CheckpointHasMore  bool
	PendingHasMore     bool
}

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

type BusinessUsagePeriodAuthorityOptions struct {
	Mode          contract4paymentus.Mode
	Access        *BusinessProjectAccessVerifier
	InitialStarts contract4paymentus.InitialServiceStartReader
	Periods       contract4paymentus.UsagePeriodReader
	CloseTerms    BusinessUsageCloseTermsReader
	// Pricing resolves the current server-approved config for new periods. It
	// is a server-owned dependency, never request input. Existing periods keep
	// the config frozen in their native snapshot.
	Pricing func() contract4paymentus.UsagePricingConfig
	Now     func() time.Time
}

type BusinessUsagePeriodOpener interface {
	OpenCurrent(context.Context, string) (contract4paymentus.UsagePeriodSnapshot, error)
}

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

type BusinessUsageRuntime struct {
	Access   *BusinessProjectAccessVerifier
	Activity *BusinessQueryActivityService

	Periods        *BusinessUsagePeriodService
	Invoices       contract4paymentus.UsageInvoiceService
	Worker         *BusinessUsageLifecycleWorker
	Ledger         contract4paymentus.UsageLedger
	PeriodReader   contract4paymentus.UsagePeriodReader
	PayerAuthority contract4paymentus.UsagePeriodInvoicePayerAuthority
	// contains filtered or unexported fields
}

type BusinessUsageRuntimeOptions struct {
	DB              dal.DB
	Query           dal.QueryExecutor
	Mode            contract4paymentus.Mode
	CurrentService  contract4paymentus.CurrentSpaceServiceReader
	InitialStarts   contract4paymentus.InitialServiceStartReader
	Contacts        CurrentProjectContactPort
	Actors          BusinessActivityActorVerifier
	AccessPolicy    BusinessProjectAccessPolicy
	TaxPolicies     []BusinessUsageTaxPolicyRegistration
	InvoiceProvider contract4paymentus.UsageInvoiceProvider
	Pricing         func() contract4paymentus.UsagePricingConfig
	Now             func() time.Time
	// contains filtered or unexported fields
}

type BusinessUsageTaxPolicyRegistration struct {
	Policy  contract4paymentus.UsageInvoiceStripeTaxPolicy
	Current bool
}

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

type CallerAdmissionReader interface {
	ReadAdmissionForCaller(context.Context, string, string, time.Time) (AdmissionState, error)
}

type ConfiguredProLimits struct {
	ByPlanID map[string]ProLimitsSnapshot
}

type CurrentProjectContactPort interface {
	ReadCurrentProjectContact(context.Context, dal.ReadTransaction, contract4linkage.RelationshipEntityRef) (ProjectContactState, error)
}

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

type DemoPersonalSpaceProvisioner interface {
	EnsurePersonalSpace(context.Context, string) (PersonalAccount, error)
}

type DetectiveDemoProjectRequest struct {
	SpaceID     string `json:"spaceID,omitempty"`
	OperationID string `json:"operationId"`
}

type DetectivePersonalActivationOptions struct {
	Activator contract4spaceus.TransactionalPersonalCapabilityActivator
}

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

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

type FirstAdmittedMonthReader interface {
	ReadFirstAdmittedMonth(context.Context, string, string, string) (string, error)
}

type GitHubActivityScope struct {
	SpaceID   string `json:"spaceID"`
	ProjectID string `json:"projectID"`
}

type GitHubCreateRepository interface {
	Scope() GitHubCreateRepositoryScope
	CurrentHead(context.Context, string) (string, error)
	EnsureFolderEmpty(context.Context, string, string) error
	CreateFilesCommit(context.Context, string, string, string, map[string][]byte) (string, error)
	FindCommitByMarker(context.Context, string, string, string, map[string][]byte) (string, error)
}

type GitHubCreateRepositoryScope struct {
	ActorID, Owner, Name, Permission string
	RepositoryID                     int64
}

type GitHubProjectAccess struct {
	SpaceID         string
	SharedProjectID string
	Binding         models4datatug.GitHubProjectBinding
	// ActivityScope is present only for a validated registered Business v2
	// admission. It is a client-side selector, not an authorization grant.
	ActivityScope *GitHubActivityScope `json:"-"`
}

type GitHubProjectCreateCommand struct {
	ActorID, SpaceID, OperationID, Title string
	BillingIntent                        SharedProjectBillingIntent
	Source                               models4datatug.GitHubCreateSource
}

type GitHubProjectCreateResult struct {
	ID              string `json:"id"`
	Storage         string `json:"storage"`
	Project         string `json:"project"`
	SpaceID         string `json:"spaceID"`
	SharedProjectID string `json:"sharedProjectID"`
	Branch          string `json:"branch"`
	BranchHead      string `json:"branchHead"`
	Revision        string `json:"revision"`
	TemplateID      string `json:"templateID"`
	TemplateCommit  string `json:"templateCommit"`
}

type GitHubQueryExpectedFile struct {
	OID  string
	Mode string
	Size int64
}

type GitHubQueryFileChange struct {
	Path    string
	Content []byte
	Delete  bool
}

type GitHubQueryRepository interface {
	Scope() GitHubCreateRepositoryScope
	PrepareQuerySave(context.Context, string, string, string, dto.SaveQueryRequest) (*GitHubQuerySavePlan, error)
	CurrentHead(context.Context, string) (string, error)
	CreateQueryCommit(context.Context, string, string, string, *GitHubQuerySavePlan) (string, error)
	FindQueryCommit(context.Context, string, string, string, *GitHubQuerySavePlan) (string, error)
}

type GitHubQuerySavePlan struct {
	Changes      []GitHubQueryFileChange
	ExpectedTree map[string]GitHubQueryExpectedFile
	Response     dto.SaveQueryResponse
	BodyChanged  bool
}

type HostedAIConfirm struct {
	HostedAIProjectRef
	detectiveai.ConfirmRequest
}

type HostedAIGenerate struct {
	HostedAIProjectRef
	OperationID    string               `json:"operationId"`
	Text           string               `json:"text"`
	CaseID         string               `json:"caseId,omitempty"`
	ExpectedCounts map[string]int       `json:"expectedCounts,omitempty"`
	Sources        []detectiveai.Source `json:"sources,omitempty"`
}

type HostedAIPage struct {
	Proposals  []detectiveai.Proposal `json:"proposals"`
	HasMore    bool                   `json:"hasMore"`
	NextCursor string                 `json:"nextCursor,omitempty"`
}

type HostedAIProjectRef struct {
	Storage string `json:"storage"`
	SpaceID string `json:"spaceID"`
	Project string `json:"project"`
}

type HostedAIReview struct {
	HostedAIProjectRef
	Type    string                            `json:"type"`
	Draft   *detectiveai.ReviewedDraftRequest `json:"draft,omitempty"`
	Context *detectiveai.ContextReviewRequest `json:"context,omitempty"`
}

type HostedDemoExecutor struct {
	Embedded *HostedEmbeddedDemoExecutor
	Public   *HostedOVDBExecutor
}

type HostedDetectiveAction struct {
	Storage     string `json:"storage"`
	SpaceID     string `json:"spaceID"`
	OperationID string `json:"operationId"`
	IfMatch     int64  `json:"ifMatch,omitempty"`
	detective.ActionRequest
	// contains filtered or unexported fields
}

type HostedDetectiveQueryExecutor interface {
	ExecuteSavedQuery(context.Context, HostedSavedQueryExecution) (HostedSavedQueryResult, error)
}

type HostedDetectiveResponse struct {
	detective.ActionResponse
	Revision       int64  `json:"revision,omitempty"`
	Receipt        string `json:"receipt,omitempty"`
	CaseLinkStatus string `json:"caseLinkStatus,omitempty"`
}

type HostedEmbeddedDemoExecutor struct {
	*HostedOVDBExecutor
	// contains filtered or unexported fields
}

type HostedIncidentAction struct {
	Storage     string          `json:"storage"`
	SpaceID     string          `json:"spaceID"`
	Project     string          `json:"project"`
	OperationID string          `json:"operationId"`
	IfMatch     int64           `json:"ifMatch,omitempty"`
	Type        string          `json:"type"` // create | link | start-case
	CaseID      string          `json:"caseId,omitempty"`
	IncidentRef string          `json:"incidentRef,omitempty"`
	Environment string          `json:"environment"`
	Title       string          `json:"title,omitempty"`
	Description string          `json:"description,omitempty"`
	Case        *detective.Case `json:"case,omitempty"`
}

type HostedIncidentLinks struct {
	CaseID    string                   `json:"caseId"`
	Incidents []incidents.IncidentView `json:"incidents"`
}

type HostedIncidentResponse struct {
	Incident          incidents.IncidentView `json:"incident"`
	Case              *detective.Case        `json:"case,omitempty"`
	Receipt           string                 `json:"receipt"`
	CaseLinkStatus    string                 `json:"caseLinkStatus,omitempty"` // linked | already-linked | link-pending
	LinkPendingReason string                 `json:"linkPendingReason,omitempty"`
}

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

type HostedKnowledgeAction struct {
	Storage     string                   `json:"storage"`
	SpaceID     string                   `json:"spaceID"`
	Project     string                   `json:"project"`
	OperationID string                   `json:"operationId"`
	IfMatch     int64                    `json:"ifMatch,omitempty"`
	Type        string                   `json:"type"` // save-draft | review | reject | export
	Proposal    *HostedKnowledgeProposal `json:"proposal,omitempty"`
	ProposalID  string                   `json:"proposalId,omitempty"`
	ReviewNote  string                   `json:"reviewNote,omitempty"`
	Target      *HostedKnowledgeTarget   `json:"target,omitempty"`
}

type HostedKnowledgeHandoff struct {
	Kind            string                `json:"kind"`
	Status          string                `json:"status"` // ready-for-target-review
	Target          HostedKnowledgeTarget `json:"target"`
	ProposalID      string                `json:"proposalId"`
	ProposalVersion int64                 `json:"proposalVersion"`
	CaseID          string                `json:"caseId"`
	ClaimStatus     string                `json:"claimStatus"`
	Statement       string                `json:"statement"`
	EvidenceRefs    []string              `json:"evidenceRefs"`
	FindingRefs     []string              `json:"findingRefs,omitempty"`
	PreparedAt      time.Time             `json:"preparedAt"`
	PreparedBy      string                `json:"preparedBy"`
	Receipt         string                `json:"receipt"`
}

type HostedKnowledgePage struct {
	Proposals  []HostedKnowledgeProposal `json:"proposals"`
	NextCursor string                    `json:"nextCursor,omitempty"`
	HasMore    bool                      `json:"hasMore"`
}

type HostedKnowledgeProposal struct {
	ID           string                   `json:"id"`
	CaseID       string                   `json:"caseId"`
	Kind         string                   `json:"kind"` // field-meaning | relationship | invariant | query | scenario
	Title        string                   `json:"title"`
	Statement    string                   `json:"statement"`
	EvidenceRefs []string                 `json:"evidenceRefs"`
	FindingRefs  []string                 `json:"findingRefs,omitempty"`
	ClaimStatus  string                   `json:"claimStatus"` // hypothesis | confirmed
	Status       string                   `json:"status"`      // draft | reviewed | rejected
	Version      int64                    `json:"version"`
	CreatedAt    time.Time                `json:"createdAt"`
	CreatedBy    string                   `json:"createdBy"`
	ReviewedAt   time.Time                `json:"reviewedAt,omitempty"`
	ReviewedBy   string                   `json:"reviewedBy,omitempty"`
	ReviewNote   string                   `json:"reviewNote,omitempty"`
	Handoffs     []HostedKnowledgeHandoff `json:"handoffs,omitempty"`
}

type HostedKnowledgeResponse struct {
	Proposal *HostedKnowledgeProposal `json:"proposal,omitempty"`
	Export   *HostedKnowledgeHandoff  `json:"export,omitempty"`
	Receipt  string                   `json:"receipt"`
}

type HostedKnowledgeTarget struct {
	System           string `json:"system"` // meaninggraph | modelspec
	Repository       string `json:"repository"`
	ResourceID       string `json:"resourceId"`
	ExpectedRevision string `json:"expectedRevision"`
}

type HostedOVDBExecutor struct {
	Origin         string
	AllowedSources map[string]map[string]bool
	Client         *http.Client
	Now            func() time.Time
}

type HostedProjectEnvironmentBinding struct {
	SpaceID   string
	ProjectID string
	Name      string
	Sources   []HostedProjectSourceBinding
}

type HostedProjectEnvironmentProvider interface {
	ReadProjectEnvironments(context.Context, dal.ReadTransaction, string, string) ([]HostedProjectEnvironmentBinding, error)
}

type HostedProjectSourceBinding struct {
	Origin     string
	Database   string
	Collection string
}

type HostedQueryRunRequest struct {
	Storage     string                                 `json:"storage"`
	SpaceID     string                                 `json:"spaceID"`
	Project     string                                 `json:"project"`
	OperationID string                                 `json:"operationId"`
	QueryID     string                                 `json:"queryId"`
	Environment string                                 `json:"environment"`
	Inputs      map[string]apicontract.TypedValueOrSet `json:"inputs,omitempty"`
}

type HostedQueryRunResponse struct {
	Result            apicontract.Result `json:"result"`
	QueryRevision     string             `json:"queryRevision"`
	ResultFingerprint string             `json:"resultFingerprint"`
	Receipt           string             `json:"receipt"`
}

type HostedSavedQueryExecution struct {
	ActorID, SpaceID, ProjectID, QueryID, Revision, Environment string
	QueryJSON                                                   []byte
	Inputs                                                      map[string]apicontract.TypedValueOrSet
}

type HostedSavedQueryResult struct {
	ResultJSON  []byte
	Revision    string
	Fingerprint string
}

type HostedSessionDetectiveOptions struct {
	Mounted          sessioncontext.MountedDatabase
	Detective        *DetectiveService
	ActiveAccount    func(context.Context, string) error
	AuthorizeContent func(context.Context, string, SessionOperationScope, *sessioncontext.Scope) error
	Enabled          bool
}

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

type IDGenerator interface {
	// NewID returns the id of a new record.
	NewID(ctx context.Context) (string, error)
}

type InitialProtectedProjectBasis struct {
	Digest    string
	Allocated int64
}

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

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

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

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

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

type PaidMonthAllocator interface {
	AllocatePaidMonths(PlanPayment, string) (map[string]int64, error)
}

type PaidProjectLinkageOptions struct {
	Paid     PaidSharedProjectOptions
	Business *BusinessProjectAccessVerifier
	Roles    ProjectRoleCatalog
	Contacts CurrentProjectContactPort
	Manager  ProjectRoleManagerPort
	Targets  ProjectContactRoleTargetPort
	Now      func() time.Time
}

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

type PaidProjectOwnerLinksOptions struct {
	Roles    ProjectRoleCatalog
	Owner    ProjectOwnerContactPort
	Contacts CurrentProjectContactPort
}

type PaidSharedProjectOptions struct {
	Version, Mode, Product string
	// EnableQueryEditCandidates is an explicit host opt-in. Existing paid
	// project routes keep their current behavior until private rules and the
	// observe-only source journey are reviewed and wired by the host.
	EnableQueryEditCandidates bool
	ContactLinks              *PaidProjectOwnerLinksOptions
	Config                    PlanConfig
	Directory                 PersonalAccountDirectory
	Personal                  PersonalPlanOwnerPort
	Owner                     interface {
		ReadOwner(context.Context, dal.ReadTransaction, string, string, string) (PlanOwnerFence, error)
	}
}

type PersonalAccount struct{ ID, Title string }

type PersonalAccountDirectory interface {
	PersonalAccount(context.Context, string) (PersonalAccount, error)
}

type PersonalPlanOwnerPort interface {
	VerifyPersonalOwner(context.Context, dal.ReadTransaction, string, string) error
}

type PersonalPlanService struct {
	Directory PersonalAccountDirectory
	Plans     PlanReader
	Usage     UsageReader
	Admission AdmissionReader
	// CallerAdmission takes precedence when bound. Admission remains supported
	// for existing consumers; a new host must bind this caller-aware port.
	CallerAdmission CallerAdmissionReader
	Config          PlanConfigReader
	Clock           PlanClock
	FirstMonth      FirstAdmittedMonthReader
}

type PlanAI struct {
	Unit     string      `json:"unit"`
	Enforced bool        `json:"enforced"`
	PeriodID string      `json:"periodId"`
	Used     int64       `json:"used"`
	Limit    int64       `json:"limit"`
	Left     int64       `json:"left"`
	ResetsAt time.Time   `json:"resetsAt"`
	Today    PlanToday   `json:"today"`
	Blocked  *string     `json:"blocked"`
	Models   []PlanModel `json:"models"`
}

type PlanAccount struct {
	AccountID string `json:"accountId"`
	Kind      string `json:"kind"`
	Title     string `json:"title"`
	Plan      string `json:"plan"`
	Role      string `json:"role"`
	Pays      bool   `json:"pays"`
}

type PlanApplyOutcome string

type PlanClock interface{ Now() time.Time }

type PlanConfig struct {
	FreeFirstMonthLimits models4datatug.PlanLimits
	FreeLaterMonthLimits models4datatug.PlanLimits
	ProLimits            models4datatug.PlanLimits
	FreeModels           []PlanModel
	ProModels            []PlanModel
	DailyLimit           int64
	// Zero grace stops paid access exactly at PaidUntil. Positive values are
	// explicit legacy policy; do not configure them for strict paid-through plans.
	ActiveGrace  time.Duration
	PastDueGrace time.Duration
	Enforced     bool
	UpgradeURL   string
	ManageURL    string
	SupportEmail string
}

type PlanConfigReader interface {
	ReadPlanConfig(context.Context, string, time.Time) (PlanConfig, error)
}

type PlanEffectAuthority string

type PlanEffectGrants struct {
	Contributors, ProjectContributors, AIQuestions int64
	AIPaysFor                                      string
	ProtectedProjects                              *int64 `json:"protectedProjects,omitempty"`
	ProtectedProjectUsers                          *int64 `json:"protectedProjectUsers,omitempty"`
}

type PlanEffectOwnerPort interface {
	ReadOwner(context.Context, dal.ReadTransaction, string, string, string) (PlanOwnerFence, error)
	ReadMoneyFence(context.Context, dal.ReadTransaction, string, string, string) (PlanMoneyFence, error)
	ClassifyEffect(context.Context, dal.ReadTransaction, PlanOwnerFence) (PlanEffectAuthority, error)
	VerifyCurrentEffect(context.Context, dal.ReadTransaction, AccountPlanEffect) error
	ReconcileMoney(context.Context, dal.ReadwriteTransaction, AccountPlanEffect) error
}

type PlanFacts struct {
	AccountKind               string                     `json:"accountKind"`
	Tier                      string                     `json:"tier"`
	Period                    string                     `json:"period"`
	ProviderStatus            string                     `json:"providerStatus"`
	PaidUntil                 *time.Time                 `json:"paidUntil,omitempty"`
	EndsAt                    *time.Time                 `json:"endsAt,omitempty"`
	LastInvoiceRefundedInFull bool                       `json:"lastInvoiceRefundedInFull"`
	TerminalFullRefund        bool                       `json:"terminalFullRefund,omitempty"`
	RefundedAt                *time.Time                 `json:"refundedAt,omitempty"`
	FirstPaidAt               *time.Time                 `json:"firstPaidAt,omitempty"`
	Founding                  bool                       `json:"founding"`
	Grants                    *models4datatug.PlanLimits `json:"grants,omitempty"`
}

type PlanModel struct {
	ID      string `json:"id"`
	Class   string `json:"class"`
	Weight  int64  `json:"weight"`
	Default bool   `json:"default"`
}

type PlanMoneyFence struct {
	IngestEpoch, ReconciledEpoch int64
	Unresolved                   bool
}

type PlanOwnerFence struct {
	Mode, Family, AccountID, OwnerSubscriptionID string
	OwnerGeneration, SubscriptionRevision        int64
}

type PlanPayment struct {
	Mode, Provider, InvoiceID, PaymentID, SubscriptionID, AccountID string
	Currency                                                        string
	ReceivedCents                                                   int64
	CashConfirmed, RefundsKnown, DisputeResolved                    bool
	Lines                                                           []PlanPaymentLine
	Refunds                                                         []PlanRefund
}

type PlanPaymentLine struct {
	ID, ProductFamily           string
	StartUTC, EndUTC            time.Time
	CashCents, RetainedTaxCents int64
	RetainedTaxKnown            bool
}

type PlanReader interface {
	ReadCurrentPlan(context.Context, string) (*models4datatug.PlanRecord, error)
}

type PlanRefund struct {
	ID               string
	GrossCents       int64
	LineGrossCents   map[string]int64
	AttributionKnown bool
}

type PlanResponse struct {
	V             int                       `json:"v"`
	Payer         string                    `json:"payer"`
	AccountID     string                    `json:"accountId"`
	AccountTitle  string                    `json:"accountTitle"`
	Role          string                    `json:"role"`
	Plan          string                    `json:"plan"`
	EffectivePlan string                    `json:"effectivePlan"`
	Status        string                    `json:"status"`
	Period        string                    `json:"period"`
	PaidUntil     *time.Time                `json:"paidUntil,omitempty"`
	Founding      bool                      `json:"founding"`
	Limits        models4datatug.PlanLimits `json:"limits"`
	AI            PlanAI                    `json:"ai"`
	OwnKeyWorks   bool                      `json:"ownKeyWorks"`
	CanUpgrade    bool                      `json:"canUpgrade"`
	UpgradeURL    string                    `json:"upgradeUrl"`
	ManageURL     string                    `json:"manageUrl,omitempty"`
	SupportEmail  string                    `json:"supportEmail,omitempty"`
	Accounts      []PlanAccount             `json:"accounts"`
}

type PlanStateResult struct {
	Outcome string                     `json:"outcome"`
	Reason  string                     `json:"reason,omitempty"`
	Record  *models4datatug.PlanRecord `json:"record,omitempty"`
}

type PlanToday struct {
	Used  int64 `json:"used"`
	Limit int64 `json:"limit"`
}

type PreparedSharedProjectCreate struct {
	Binding   SharedProjectCreateBinding
	IssuedAt  time.Time
	Validator SharedProjectCreateTransactionAuthority
}

type ProBusinessSharedProjectOptions struct {
	Pro      PaidSharedProjectOptions
	Business BusinessSharedProjectOptions
}

type ProLimitsResolver interface {
	ResolveProLimits(string, PlanEffectGrants) (ProLimitsSnapshot, error)
}

type ProLimitsSnapshot struct {
	Version            string
	ProjectGuestsKnown bool
	Limits             models4datatug.PlanLimits
}

type ProjectAIEligibility struct {
	AIAllowed bool   `json:"aiAllowed"`
	Reason    string `json:"reason,omitempty"`
}

type ProjectContactRoleChange struct {
	Contact          ProjectContactState
	Before, Proposed []string
}

type ProjectContactRoleTargetPort interface {
	AuthorizeProjectContactRoleChange(context.Context, dal.ReadTransaction, ProjectRoleMutationAuthorization, ProjectContactRoleChange) error
}

type ProjectContactState struct {
	Ref            contract4linkage.RelationshipEntityRef
	Exists, Active bool
	UserID         string
}

type ProjectOwnerContactPort interface {
	ResolveProjectOwnerContact(context.Context, dal.ReadTransaction, SharedProjectCreateBinding) (contract4linkage.RelationshipEntityRef, error)
}

type ProjectRoleCatalog struct {
	Version   string
	Roles     []string
	OwnerRole string
}

type ProjectRoleEvidence struct {
	Contact ProjectContactState
	Roles   []string
}

type ProjectRoleManagerPort interface {
	AuthorizeProjectRoleMutation(context.Context, dal.ReadTransaction, ProjectRoleMutationAuthorization) error
}

type ProjectRoleMutationAuthorization struct {
	ActorID       string
	Project       models4datatug.SharedProjectRef
	ActorContacts []ProjectRoleEvidence
	Changes       []ProjectContactRoleChange
}

type ProtectedProjectBasisAuthority interface {
	VerifyInitialProtectedProjectBasisInTransaction(context.Context, dal.ReadwriteTransaction, string, string, string, string, InitialProtectedProjectBasis) error
}

type PurchaseReadiness struct {
	DB       dal.DB
	Owner    PlanEffectOwnerPort
	Personal PersonalPlanOwnerPort
	Config   PlanConfigReader
	Clock    PlanClock
}

type PurchaseReadinessRequest struct {
	BuyerID, Mode, SiteID, Family, AccountID    string
	SubscriptionID, QuoteKey, SessionID, PlanID string
}

type QueryActivityContextResponse struct {
	ContextID    string    `json:"contextID"`
	ExpiresAtUTC time.Time `json:"expiresAtUTC"`
}

type QueryActivityContextService interface {
	IssueContext(context.Context, string, string, string) (QueryActivityContextResponse, error)
	Report(context.Context, string, string, QueryActivityReport) (QueryActivityReportResult, error)
}

type QueryActivityDrainRequest struct {
	Limit   int
	AfterID string
}

type QueryActivityDrainResult struct {
	Scanned     int
	Delivered   int
	Failed      int
	NextAfterID string
	HasMore     bool
}

type QueryActivityReport struct {
	ContextID   string                           `json:"contextID"`
	OperationID string                           `json:"operationID"`
	Kind        models4datatug.QueryActivityKind `json:"kind"`
}

type QueryActivityReportResult struct {
	Accepted  bool   `json:"accepted"`
	Coalesced bool   `json:"coalesced"`
	ReceiptID string `json:"receiptID,omitempty"`
}

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

type QueryActivityUsageAuthority struct{}

type RegisterGithubProjectRequest struct {
	Org    string `json:"org"`
	Repo   string `json:"repo"`
	Folder string `json:"folder"`
	Title  string `json:"title"`
}

type ServiceRefundProof struct {
	Known                 bool
	HasPaidServiceInvoice bool
	InvoiceID             string
	ServiceStartUTC       time.Time
	ServiceEndUTC         time.Time
	RefundedInFull        bool
}

type SessionDetectiveBinding struct {
	InputName  string `json:"inputName"`
	EntryID    string `json:"entryId"`
	RevisionID string `json:"revisionId"`
}

type SessionDetectiveRequest struct {
	OpID                 string                          `json:"operationId"`
	SessionID            string                          `json:"sessionId"`
	ExpectedVersion      int64                           `json:"expectedVersion"`
	ExpectedContextSetID string                          `json:"expectedContextSetId"`
	Scope                sessioncontext.Scope            `json:"scope"`
	CheckID              string                          `json:"checkId"`
	CaseID               string                          `json:"caseId,omitempty"`
	Attachments          []sessioncontext.EntryRef       `json:"attachments,omitempty"`
	Bindings             []SessionDetectiveBinding       `json:"bindings,omitempty"`
	Inputs               map[string]detective.InputValue `json:"inputs,omitempty"`
}

type SessionDetectiveStatus struct {
	OperationID    string                                 `json:"operationId"`
	Status         sessioncontext.AcceptedDetectiveStatus `json:"status"`
	OperationScope SessionOperationScope                  `json:"operationScope"`
}

type SessionOperationScope struct {
	Storage     string `json:"storage"`
	Project     string `json:"project"`
	SpaceID     string `json:"spaceID,omitempty"`
	DatabaseID  string `json:"databaseId"`
	ProjectID   string `json:"projectId"`
	NamespaceID string `json:"namespaceId"`
}

type SharedProjectActivationOptions struct {
	Activator      contract4spaceus.TransactionalRoleCapabilityActivator
	RequiredRoles  []string
	InventoryQuery dal.QueryExecutor
}

type SharedProjectBillingIntent string

type SharedProjectCreateAuthority interface {
	PrepareSharedProjectCreate(context.Context, SharedProjectCreateBinding) (PreparedSharedProjectCreate, error)
}

type SharedProjectCreateBinding struct {
	ActorID, SpaceID, CommandID, RequestDigest string
	// Paid binding is server-resolved. Legacy ownership-only commands leave it empty.
	PayerID, Mode, Product string
}

type SharedProjectCreateCommand struct {
	ActorID, SpaceID, CommandID, Title string
	BillingIntent                      SharedProjectBillingIntent
}

type SharedProjectCreateTransactionAuthority interface {
	// ValidateSharedProjectCreateInTransaction must re-read current Space,
	// membership/role, enabled module and durable reservation evidence in this
	// exact transaction on EVERY invocation, including command replay. It may
	// only read: no nested transaction, writes, provider call or clock read.
	ValidateSharedProjectCreateInTransaction(context.Context, dal.ReadwriteTransaction, SharedProjectCreateBinding, time.Time) error
}

type SharedProjectQueryOperationScope struct {
	ActorID, StoreID, SpaceID, ProjectID, Kind string
}

type SharedProjectQueryReadResult struct {
	Query                 json.RawMessage `json:"query"`
	Revision              string          `json:"revision"`
	SaveSupported         bool            `json:"saveSupported"`
	UnsupportedSaveReason string          `json:"unsupportedSaveReason,omitempty"`
}

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

type SpaceServiceAccess struct {
	Mode, ServiceID, PayerSpaceID, OwnerFamily, AccountKind, ProductID, PlanID string
	ProviderAccountID, CustomerID, LineageID, OwnerSubscriptionID              string
	PaidServiceProofID, GrantVersion                                           string
	OwnerGeneration, OwnerRevision                                             int64
	PaidUntilUTC                                                               time.Time
	State                                                                      string // active or ended, after complete source reconciliation
	UnlimitedProjects, UnlimitedContacts                                       bool
	// contains filtered or unexported fields
}

type UsageReader interface {
	ReadUsage(context.Context, string, string) (*models4datatug.AIUsageRecord, error)
}