tenantexport

type ErrTenantExportInFlight struct {
	ExistingTicket string
}

type Job struct {
	Ticket     string
	TenantID   tenant.TenantID
	Status     JobStatus
	BlobKey    string // set once Status == JobComplete
	Error      string // set once Status == JobFailed
	CreatedAt  time.Time
	FinishedAt time.Time
}

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

type JobStatus string

type PackageResult struct {
	// Key is the blob key the export was stored under.
	Key string
	// SHA256 is the stored content's hash, as returned by the blob
	// store itself.
	SHA256 string
	// Bytes is the packaged zip's own size.
	Bytes int64
}

type PebbleKV struct {
	Key   string `json:"key_b64"`
	Value string `json:"value_b64"`
}

type PebbleStoreSpec struct {
	Dir  string
	Name string
}

type SQLiteTableSpec struct {
	// Name is a label for this table, used for the output JSON
	// filename and in error messages. When NameFunc is nil, Name is
	// ALSO the literal table name to query (optionally prefixed, see
	// TenantPrefixed) -- when NameFunc is set, Name is label-only and
	// NameFunc alone determines the real table name.
	Name string
	// NameFunc, when set, is the authoritative source for this
	// table's real name -- e.g. tenant.TenantID.NodesTableName,
	// which this package MUST call directly rather than re-derive the
	// same "prefix + suffix" pattern by hand. This is not a style
	// preference: a hand-rolled version of this exact logic already
	// caused two real bugs in this package (a missing table,
	// NodeSchemaTableName's own t<XXXX>_n_sch, that a generic
	// prefix+suffix builder had no way to know about since the
	// abbreviation "n_sch" isn't Name+prefix-shaped at all; and a
	// query against the literal, unprefixed string "nodes", which
	// doesn't exist -- both caught by TestIntegration_BlobExport_
	// FullAsyncFlow against a real server, not assumed away).
	// TenantPrefixed and TenantFiltered are both ignored when NameFunc
	// is set -- NameFunc already encodes the correct scoping.
	NameFunc func(tenantID uint16) string
	// TenantPrefixed is true when this table's REAL name is Name with
	// the tenant's own table prefix prepended
	// (tenant.TenantID.TablePrefix(), e.g. "bal_accounts" ->
	// "t0000_bal_accounts") -- verified directly against source for
	// every table this applies to (pkg/bal/store.go's own
	// accountsTable/journalTable/balancesTable and siblings in
	// rollup.go/seal.go, all "s.prefix + literal suffix", confirmed
	// simple with no abbreviation surprises, unlike the entity/graph
	// tables above). Used only when NameFunc is nil.
	TenantPrefixed bool
	// TenantFiltered is true when this table is shared across all
	// tenants and needs a "WHERE tenant_id = ?" filter (e.g.
	// cal_bookings, dxp_txn, fsm_machines -- confirmed directly
	// against their own real WHERE clauses, not assumed). Used only
	// when NameFunc is nil.
	TenantFiltered bool
}

type TenantDataSummary struct {
	// Primary holds one entry per PrimaryStoreTables spec, keyed by
	// spec.Name.
	Primary map[string]int `json:"primary"`
	// Loc holds one entry per LocStoreTables spec (loc.db). Present
	// but zero-valued for every entry when the tenant has never used
	// /loc at all (loc.db doesn't exist yet) -- distinct from a
	// tenant that used /loc and then deleted everything, which this
	// summary cannot and does not try to distinguish.
	Loc map[string]int `json:"loc"`
	// Obj holds one entry per ObjStoreTables spec (obj.db) -- this is
	// what closes XOT209's own emptiness-check gap for obj, ahead of
	// or independent of that item's own general REST enumeration
	// endpoint.
	Obj map[string]int `json:"obj"`
	// TS, CalIndex, and BalRollup are key counts in the three
	// per-tenant Pebble stores ExportTenant itself exports
	// (storelayout.TenantTSDir/TenantCalDir/TenantBalRollupDir).
	TS        int `json:"ts"`
	CalIndex  int `json:"cal_index"`
	BalRollup int `json:"bal_rollup"`
	// Blob is the tenant's own uploaded blob key count -- NOT part of
	// ExportTenant's own captured set (blob.Store there is only ever
	// the destination for a packaged export, never a source of
	// counted data; see this file's own XOT216 note on Summarize).
	// Always 0 when Summarize's own bs parameter is nil (blob
	// disabled on this server, or unavailable for this call) -- a
	// disabled primitive summarizing to zero, matching every other
	// per-store field's own "never used this primitive" treatment,
	// not a sentinel meaning "unknown."
	Blob int `json:"blob"`
}