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

Function: statObjectSafe()

statObjectSafe(repoName, ref, path): Promise<ObjectStats | null>

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

Get object stats safely - returns null if object doesn't exist

Use this for checking file existence without throwing errors. Useful for duplicate detection where non-existence is expected.

Parameters

repoName

string

ref

string

path

string

Returns

Promise<ObjectStats | null>

ObjectStats if object exists, null if not found

Throws

Error only for unexpected API errors (not 404)