Interface: StoredFileReference

Defined in: server/storage/file-reference.ts:14

A durable, structured reference to a stored object — { storageBucket, storageKey } — NOT a raw (and expiring) presigned URL.

Persist a StoredFileReference (or just its storageKey, with the bucket implied by config) on your domain model. Presigned URLs are derived on demand from the reference via the adapter's getDownloadUrl; they are short-lived and must never be stored as the canonical pointer.

The reference round-trips through the opaque forms fileId: see toFileId / fromFileId in s3-file-store.ts (encodeFileId / parseFileId).

PropertiesCopy Anchor Link

storageBucketCopy Anchor Link

storageBucket: string;

Defined in: server/storage/file-reference.ts:16

The bucket the object lives in.

storageKeyCopy Anchor Link

storageKey: string;

Defined in: server/storage/file-reference.ts:18

The object key within the bucket (context/encodedActorId/uuid/filename).