Module meta_adapter 

Adapter that manages metadata. Everything including tenants, profiles, actions, file metadata, etc.

Structs

Action

ActionData

Additional action data (cached counts/stats)

ActionView

AddressBook

Address book collection metadata

AttachmentView

Calendar

Calendar collection metadata. Parallels AddressBook.

CalendarObject

Full calendar object row including the authoritative stored VCALENDAR blob.

CalendarObjectExtracted

Indexed projection of a calendar object — lives in DB columns alongside the authoritative iCalendar blob. Enables calendar-query time-range filtering and REST search.

CalendarObjectSyncEntry

One entry in a CalDAV sync-collection REPORT response. Tombstones (deleted: true) let clients drop stale objects.

CalendarObjectView

Calendar object summary without the iCalendar blob — for list endpoints.

CalendarObjectWrite

Borrowed write payload for calendar-object upserts. Groups the four fields that always travel together (authoritative blob + its derived etag + indexed projection) so trait methods writing multiple objects in one tx don’t accumulate parallel-scalar parameter lists.

Contact

Full contact row including the authoritative stored vCard blob.

ContactExtracted

Indexed projection of a contact — lives in DB columns, parallel to the stored vCard blob. Used both for REST API responses (via the handler layer’s JSON conversion) and for CardDAV addressbook-query REPORT text-match filtering.

ContactSyncEntry

One entry in a CardDAV sync-collection REPORT response. Tombstones (deleted: true) let clients drop stale cards.

ContactView

Contact summary without the vCard blob — for list endpoints (REST + CardDAV REPORTs that don’t need the full body).

CreateCalendarData

CreateFile

CreateFileVariant

CreateRefOptions

CreateShareEntry

FileUserData

User-specific file metadata (access tracking, pinned/starred status)

FileVariant

FileView

FinalizeActionOptions

Options for finalizing an action (resolved fields from ActionCreatorTask)

InstallApp

Data for installing an app

InstalledApp

Installed app record

ListActionOptions

Options for listing actions

ListCalendarObjectOptions

ListContactOptions

ListFileOptions

Options for listing files

ListProfileOptions

ListRefsOptions

ListTaskOptions

ListTenantsMetaOptions

Options for listing tenants in meta adapter

PathSegment

Single hop in a file’s folder ancestry chain.

Profile

ProfileData

Profile data returned from adapter queries

ProfileInfo

ProfileList

List of profiles response

PushSubscription

Full push subscription record stored in database

PushSubscriptionData

Web Push subscription data (RFC 8030)

PushSubscriptionKeys

Subscription keys for Web Push encryption

RefData

ShareEntry

Task

TaskPatch

Tenant

TenantListMeta

Tenant list item from meta adapter (without cover_pic and x fields)

UpdateActionDataOptions

Options for updating action metadata

UpdateAddressBookData

UpdateCalendarData

UpdateFileOptions

Options for updating file metadata

UpdateProfileData

UpdateRefOptions

Options for updating an existing reference via PATCH semantics.

UpdateShareEntryOptions

Options for updating an existing share entry via PATCH semantics.

UpdateTenantData

UpsertProfileFields

Fields for MetaAdapter::upsert_profile.

Enums

ActionCountGroupBy

Field to group an action count by. Mapped to a fixed column server-side (never interpolated from caller input) to keep the query injection-safe.

ActionId

AudienceType

Audience filter axis: classify actions by the type of the effective wall owner (coalesce(audience, issuer_tag) joined to profiles.type). Personal matches pa.type='P' (with NULL→Personal fallback for unknown remote profiles). Community matches pa.type='C'. Combines with audience (specific community) as AND.

BrokenReason

Reason a cross-context file row is tombstoned. Written by the refresh endpoint based on the source’s response. Tombstones are sticky, so this is reserved for permanent / authoritative source signals — transient network failures DO NOT mutate the row (the handler surfaces them out-of-band via refreshStatus in the response wrapper).

FileId

FileStatus

File status enum Note: Mutability is determined by fileTp (BLOB=immutable, CRDT/RTDB=mutable)

ProfileConnectionStatus

ProfileStatus

ProfileTrust

Per-profile proxy-token preference for passive reads of a remote profile’s content. Absent (NULL) means ask the user at the time of access.

ProfileType

UpsertResult

Outcome of an upsert_profile call.

Constants

MANAGED_PARENT_ID

Special parent_id value for system-managed files (action attachments, profile/cover images, cached remote profile images). Files in this hidden per-tenant folder are reaped by the file GC when no canonical column still references them.

ROOT_PARENT_ID

Sentinel parent_id value representing the root (files with no parent folder). API input/filter only — never appears in DB rows; root rows have parent_id = NULL in the files table. Use this constant only on the API surface when the request needs to disambiguate root from “no filter”.

TRASH_PARENT_ID

Special parent_id value for trashed files

Traits

MetaAdapter