PersistentAI API Documentation / @persistentai/fireflow-vfs / server / getObjectPresignedUrl

Function: getObjectPresignedUrl()

getObjectPresignedUrl(repoName, ref, path): Promise<PresignedUrlResult>

Defined in: packages/fireflow-vfs/src/steps/lakefs-steps.ts:686

Get a presigned URL for direct object download

This returns a temporary HTTP URL that clients can use to download the file directly from the underlying object storage (S3/MinIO), bypassing the server completely.

Benefits:

• No server memory usage (URL is ~500 bytes vs full file content)
• No event loop blocking
• Direct client-to-storage connection (faster)
• Works with any file size

Parameters

repoName

string

ref

string

path

string

Returns

Promise<PresignedUrlResult>

PresignedUrlResult with URL, expiration, and metadata

Throws

Error if object not found or presigning fails