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

Variable: vfsUploadSessionsTable

const vfsUploadSessionsTable: PgTableWithColumns<{ columns: { branch: PgColumn<{ baseColumn: never; columnType: "PgText"; data: string; dataType: "string"; driverParam: string; enumValues: [string, ...string[]]; generated: undefined; hasDefault: true; hasRuntimeDefault: false; identity: undefined; isAutoincrement: false; isPrimaryKey: false; name: "branch"; notNull: true; tableName: "vfs_upload_sessions"; }, { }, { }>; createdAt: PgColumn<{ baseColumn: never; columnType: "PgTimestamp"; data: Date; dataType: "date"; driverParam: string; enumValues: undefined; generated: undefined; hasDefault: true; hasRuntimeDefault: false; identity: undefined; isAutoincrement: false; isPrimaryKey: false; name: "created_at"; notNull: true; tableName: "vfs_upload_sessions"; }, { }, { }>; expiresAt: PgColumn<{ baseColumn: never; columnType: "PgTimestamp"; data: Date; dataType: "date"; driverParam: string; enumValues: undefined; generated: undefined; hasDefault: false; hasRuntimeDefault: false; identity: undefined; isAutoincrement: false; isPrimaryKey: false; name: "expires_at"; notNull: true; tableName: "vfs_upload_sessions"; }, { }, { }>; fileSize: PgColumn<{ baseColumn: never; columnType: "PgBigInt53"; data: number; dataType: "number"; driverParam: string | number; enumValues: undefined; generated: undefined; hasDefault: false; hasRuntimeDefault: false; identity: undefined; isAutoincrement: false; isPrimaryKey: false; name: "file_size"; notNull: false; tableName: "vfs_upload_sessions"; }, { }, { }>; id: PgColumn<{ baseColumn: never; columnType: "PgText"; data: string; dataType: "string"; driverParam: string; enumValues: [string, ...string[]]; generated: undefined; hasDefault: false; hasRuntimeDefault: false; identity: undefined; isAutoincrement: false; isPrimaryKey: true; name: "id"; notNull: true; tableName: "vfs_upload_sessions"; }, { }, { }>; lakeFSUploadId: PgColumn<{ baseColumn: never; columnType: "PgText"; data: string; dataType: "string"; driverParam: string; enumValues: [string, ...string[]]; generated: undefined; hasDefault: false; hasRuntimeDefault: false; identity: undefined; isAutoincrement: false; isPrimaryKey: false; name: "lakefs_upload_id"; notNull: true; tableName: "vfs_upload_sessions"; }, { }, { }>; mimeType: PgColumn<{ baseColumn: never; columnType: "PgText"; data: string; dataType: "string"; driverParam: string; enumValues: [string, ...string[]]; generated: undefined; hasDefault: false; hasRuntimeDefault: false; identity: undefined; isAutoincrement: false; isPrimaryKey: false; name: "mime_type"; notNull: false; tableName: "vfs_upload_sessions"; }, { }, { }>; numParts: PgColumn<{ baseColumn: never; columnType: "PgInteger"; data: number; dataType: "number"; driverParam: string | number; enumValues: undefined; generated: undefined; hasDefault: false; hasRuntimeDefault: false; identity: undefined; isAutoincrement: false; isPrimaryKey: false; name: "num_parts"; notNull: true; tableName: "vfs_upload_sessions"; }, { }, { }>; partSize: PgColumn<{ baseColumn: never; columnType: "PgInteger"; data: number; dataType: "number"; driverParam: string | number; enumValues: undefined; generated: undefined; hasDefault: false; hasRuntimeDefault: false; identity: undefined; isAutoincrement: false; isPrimaryKey: false; name: "part_size"; notNull: true; tableName: "vfs_upload_sessions"; }, { }, { }>; path: PgColumn<{ baseColumn: never; columnType: "PgText"; data: string; dataType: "string"; driverParam: string; enumValues: [string, ...string[]]; generated: undefined; hasDefault: false; hasRuntimeDefault: false; identity: undefined; isAutoincrement: false; isPrimaryKey: false; name: "path"; notNull: true; tableName: "vfs_upload_sessions"; }, { }, { }>; physicalAddress: PgColumn<{ baseColumn: never; columnType: "PgText"; data: string; dataType: "string"; driverParam: string; enumValues: [string, ...string[]]; generated: undefined; hasDefault: false; hasRuntimeDefault: false; identity: undefined; isAutoincrement: false; isPrimaryKey: false; name: "physical_address"; notNull: true; tableName: "vfs_upload_sessions"; }, { }, { }>; userId: PgColumn<{ baseColumn: never; columnType: "PgText"; data: string; dataType: "string"; driverParam: string; enumValues: [string, ...string[]]; generated: undefined; hasDefault: false; hasRuntimeDefault: false; identity: undefined; isAutoincrement: false; isPrimaryKey: false; name: "user_id"; notNull: true; tableName: "vfs_upload_sessions"; }, { }, { }>; workspaceId: PgColumn<{ baseColumn: never; columnType: "PgText"; data: string; dataType: "string"; driverParam: string; enumValues: [string, ...string[]]; generated: undefined; hasDefault: false; hasRuntimeDefault: false; identity: undefined; isAutoincrement: false; isPrimaryKey: false; name: "workspace_id"; notNull: true; tableName: "vfs_upload_sessions"; }, { }, { }>; }; dialect: "pg"; name: "vfs_upload_sessions"; schema: undefined; }>

Defined in: packages/fireflow-vfs/src/db/schema.ts:261

VFS Upload Sessions - tracks multipart uploads server-side

This table stores upload session state so that:

• Client never sees physicalAddress (S3 paths hidden)
• Client only needs uploadId for complete/abort operations
• Server can clean up expired/abandoned uploads