ctx.files in queries.
Hierarchy
-
FilesReader↳FilesWriter
Methods
inspect
▸ inspect(file): Promise<FileInfo>
The metadata of a file, read through its locator. A protected file needs
the route it is read through (attachment(record, field)), decided as
delivery decides it, unless this transaction accepted it; its native row
and current source permissions are read dependencies, so an erasure
racing this transaction refuses its result or commit. Missing, erased
and unauthorized files, and a protected file named without a route,
throw FileUnavailable; an attachment whose field now names another
file throws FileAttachmentChanged. An ordinary file needs no route.
Parameters
Returns
Promise<FileInfo>
isAvailable
▸ isAvailable(file): Promise<boolean>
Logical availability in this component’s file namespace, including all
ancestor erasure barriers. Reveals no metadata, permissions or byte
capability; it does not probe physical blob existence.
Parameters
Returns
Promise<boolean>
erasure
▸ erasure(erasure): Promise<FileErasure | null>
The progress of an accepted erasure of this component’s file, read
from durable state, or null when the reference names none. Reveals no
digest, size, name or byte capability.
Parameters
Returns
Promise<FileErasure | null>
inspectWorkloadGrant
▸ inspectWorkloadGrant(file, options): Promise<WorkloadGrantInfo>
This component’s live workload grant of a file under the exact key.
Current source permissions and erasure are read dependencies. Returns
no URL or secret and never renews a delivery; suitable for queries and
operation review.
Parameters
Returns
Promise<WorkloadGrantInfo>