@fragno-dev/upload 0.1.1 → 0.1.3

package/dist/node/index.d.ts

@@ -1,16 +1,17 @@
-import { FileKeyEncoded, FileKeyPart, FileKeyParts, decodeFileKey, encodeFileKey, encodeFileKeyPrefix } from "./keys.js";
+import { FileKey, FileKeyValidationResult, ValidateFileKeyOptions, assertFileKey, splitFileKey, validateFileKey } from "./file-key.js";
 import { StorageAdapter, StorageAdapterCapabilities, StorageAdapterLimits, StorageAdapterRecommendations, UploadChecksum, UploadMode, UploadTransport } from "./storage/types.js";
-import { FileStatus, UploadStatus } from "./types.js";
-import { CreateUploadAndTransferOptions, UploadHelpers, UploadProgress } from "./client/helpers.js";
+import { FileStatus, FileVisibility, UploadStatus } from "./types.js";
+import { CreateUploadAndTransferOptions, DownloadFileOptions, DownloadMethod, UploadHelpers, UploadProgress } from "./client/helpers.js";
 import { FileHookPayload, UploadFragmentConfig, UploadFragmentResolvedConfig, UploadTimeoutPayload, resolveUploadFragmentConfig } from "./config.js";
+import { FileByKeyInput, ListFilesInput, UpdateFileInput } from "./services/files.js";
+import { uploadSchema } from "./schema.js";
 import { CompletePartsInput, CreateUploadInput, CreateUploadResult, UploadProgressInput } from "./services/uploads.js";
-import { ListFilesInput, UpdateFileInput } from "./services/files.js";
-import { uploadRoutes } from "./routes/index.js";
 import { createUploadFragmentClients } from "./client/clients.js";
-import { uploadSchema } from "./schema.js";
+import { uploadRoutes } from "./routes/index.js";
 import { FilesystemStorageAdapterOptions, createFilesystemStorageAdapter } from "./storage/fs.js";
 import { S3CompatibleStorageAdapterOptions, S3Signer, S3SignerInput, createS3CompatibleStorageAdapter } from "./storage/s3.js";
 import { R2StorageAdapterOptions, createR2StorageAdapter } from "./storage/r2.js";
+import { R2BindingBucket, R2BindingStorageAdapterOptions, createR2BindingStorageAdapter, resolveR2BindingBucket } from "./storage/r2-binding.js";
 import { uploadFragmentDefinition } from "./definition.js";
 import * as _fragno_dev_core0 from "@fragno-dev/core";
 import * as _fragno_dev_db0 from "@fragno-dev/db";
@@ -18,12 +19,12 @@ import { FragnoPublicConfigWithDatabase } from "@fragno-dev/db";
 import * as _fragno_dev_db_schema0 from "@fragno-dev/db/schema";
 import * as zod0 from "zod";
 import * as zod_v4_core0 from "zod/v4/core";
-import * as _fragno_dev_core_api0 from "@fragno-dev/core/api";
 import * as _standard_schema_spec0 from "@standard-schema/spec";
 import * as _fragno_dev_db_fragment_definition_builder0 from "@fragno-dev/db/fragment-definition-builder";
 
 //#region src/index.d.ts
 declare function createUploadFragment(config: UploadFragmentConfig, options: FragnoPublicConfigWithDatabase): _fragno_dev_core0.FragnoInstantiatedFragment<readonly [_fragno_dev_core0.FragnoRouteConfig<"POST", "/uploads", zod0.ZodObject<{
+  provider: zod0.ZodOptional<zod0.ZodString>;
   keyParts: zod0.ZodOptional<zod0.ZodArray<zod0.ZodUnion<readonly [zod0.ZodString, zod0.ZodNumber]>>>;
   fileKey: zod0.ZodOptional<zod0.ZodString>;
   filename: zod0.ZodString;
@@ -45,6 +46,28 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
   uploaderId: zod0.ZodOptional<zod0.ZodString>;
   metadata: zod0.ZodOptional<zod0.ZodRecord<zod0.ZodString, zod0.ZodUnknown>>;
 }, zod_v4_core0.$strip>, zod0.ZodObject<{
+  provider: zod0.ZodString;
+  upload: zod0.ZodObject<{
+    mode: zod0.ZodEnum<{
+      single: "single";
+      multipart: "multipart";
+    }>;
+    transport: zod0.ZodEnum<{
+      proxy: "proxy";
+      direct: "direct";
+    }>;
+    uploadUrl: zod0.ZodOptional<zod0.ZodString>;
+    uploadHeaders: zod0.ZodOptional<zod0.ZodRecord<zod0.ZodString, zod0.ZodString>>;
+    partSizeBytes: zod0.ZodOptional<zod0.ZodNumber>;
+    maxParts: zod0.ZodOptional<zod0.ZodNumber>;
+    statusEndpoint: zod0.ZodString;
+    progressEndpoint: zod0.ZodString;
+    partsEndpoint: zod0.ZodOptional<zod0.ZodString>;
+    partsCompleteEndpoint: zod0.ZodOptional<zod0.ZodString>;
+    completeEndpoint: zod0.ZodString;
+    abortEndpoint: zod0.ZodString;
+    contentEndpoint: zod0.ZodOptional<zod0.ZodString>;
+  }, zod_v4_core0.$strip>;
   uploadId: zod0.ZodString;
   fileKey: zod0.ZodString;
   status: zod0.ZodEnum<{
@@ -57,6 +80,14 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     proxy: "proxy";
   }>;
   expiresAt: zod0.ZodDate;
+}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "UPLOAD_METADATA_MISMATCH" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "PROVIDER_MISMATCH" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR", string, _fragno_dev_db0.DatabaseRequestContext<{
+  onFileReady: _fragno_dev_db0.HookFn<any>;
+  onUploadFailed: _fragno_dev_db0.HookFn<any>;
+  cleanupStorageObject: _fragno_dev_db0.HookFn<any>;
+  onFileDeleted: _fragno_dev_db0.HookFn<any>;
+  onUploadTimeout: _fragno_dev_db0.HookFn<any>;
+}>>, _fragno_dev_core0.FragnoRouteConfig<"GET", "/uploads/:uploadId", _standard_schema_spec0.StandardSchemaV1<unknown, unknown> | undefined, zod0.ZodObject<{
+  provider: zod0.ZodString;
   upload: zod0.ZodObject<{
     mode: zod0.ZodEnum<{
       single: "single";
@@ -70,16 +101,14 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     uploadHeaders: zod0.ZodOptional<zod0.ZodRecord<zod0.ZodString, zod0.ZodString>>;
     partSizeBytes: zod0.ZodOptional<zod0.ZodNumber>;
     maxParts: zod0.ZodOptional<zod0.ZodNumber>;
+    statusEndpoint: zod0.ZodString;
+    progressEndpoint: zod0.ZodString;
     partsEndpoint: zod0.ZodOptional<zod0.ZodString>;
+    partsCompleteEndpoint: zod0.ZodOptional<zod0.ZodString>;
     completeEndpoint: zod0.ZodString;
+    abortEndpoint: zod0.ZodString;
     contentEndpoint: zod0.ZodOptional<zod0.ZodString>;
   }, zod_v4_core0.$strip>;
-}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "UPLOAD_METADATA_MISMATCH" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR", string, _fragno_dev_db0.DatabaseRequestContext<{
-  onFileReady: _fragno_dev_db0.HookFn<any>;
-  onUploadFailed: _fragno_dev_db0.HookFn<any>;
-  onFileDeleted: _fragno_dev_db0.HookFn<any>;
-  onUploadTimeout: _fragno_dev_db0.HookFn<any>;
-}>>, _fragno_dev_core0.FragnoRouteConfig<"GET", "/uploads/:uploadId", _standard_schema_spec0.StandardSchemaV1<unknown, unknown> | undefined, zod0.ZodObject<{
   uploadId: zod0.ZodString;
   fileKey: zod0.ZodString;
   status: zod0.ZodEnum<{
@@ -105,9 +134,10 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
   completedAt: zod0.ZodNullable<zod0.ZodDate>;
   errorCode: zod0.ZodNullable<zod0.ZodString>;
   errorMessage: zod0.ZodNullable<zod0.ZodString>;
-}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "UPLOAD_METADATA_MISMATCH" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR", string, _fragno_dev_db0.DatabaseRequestContext<{
+}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "UPLOAD_METADATA_MISMATCH" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "PROVIDER_MISMATCH" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR", string, _fragno_dev_db0.DatabaseRequestContext<{
   onFileReady: _fragno_dev_db0.HookFn<any>;
   onUploadFailed: _fragno_dev_db0.HookFn<any>;
+  cleanupStorageObject: _fragno_dev_db0.HookFn<any>;
   onFileDeleted: _fragno_dev_db0.HookFn<any>;
   onUploadTimeout: _fragno_dev_db0.HookFn<any>;
 }>>, _fragno_dev_core0.FragnoRouteConfig<"POST", "/uploads/:uploadId/progress", zod0.ZodObject<{
@@ -116,9 +146,10 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
 }, zod_v4_core0.$strip>, zod0.ZodObject<{
   bytesUploaded: zod0.ZodNumber;
   partsUploaded: zod0.ZodNumber;
-}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "UPLOAD_METADATA_MISMATCH" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR", string, _fragno_dev_db0.DatabaseRequestContext<{
+}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "UPLOAD_METADATA_MISMATCH" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "PROVIDER_MISMATCH" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR", string, _fragno_dev_db0.DatabaseRequestContext<{
   onFileReady: _fragno_dev_db0.HookFn<any>;
   onUploadFailed: _fragno_dev_db0.HookFn<any>;
+  cleanupStorageObject: _fragno_dev_db0.HookFn<any>;
   onFileDeleted: _fragno_dev_db0.HookFn<any>;
   onUploadTimeout: _fragno_dev_db0.HookFn<any>;
 }>>, _fragno_dev_core0.FragnoRouteConfig<"POST", "/uploads/:uploadId/parts", zod0.ZodObject<{
@@ -129,9 +160,10 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     url: zod0.ZodString;
     headers: zod0.ZodOptional<zod0.ZodRecord<zod0.ZodString, zod0.ZodString>>;
   }, zod_v4_core0.$strip>>;
-}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "UPLOAD_METADATA_MISMATCH" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR", string, _fragno_dev_db0.DatabaseRequestContext<{
+}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "UPLOAD_METADATA_MISMATCH" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "PROVIDER_MISMATCH" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR", string, _fragno_dev_db0.DatabaseRequestContext<{
   onFileReady: _fragno_dev_db0.HookFn<any>;
   onUploadFailed: _fragno_dev_db0.HookFn<any>;
+  cleanupStorageObject: _fragno_dev_db0.HookFn<any>;
   onFileDeleted: _fragno_dev_db0.HookFn<any>;
   onUploadTimeout: _fragno_dev_db0.HookFn<any>;
 }>>, _fragno_dev_core0.FragnoRouteConfig<"GET", "/uploads/:uploadId/parts", _standard_schema_spec0.StandardSchemaV1<unknown, unknown> | undefined, zod0.ZodObject<{
@@ -141,9 +173,10 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     sizeBytes: zod0.ZodNumber;
     createdAt: zod0.ZodDate;
   }, zod_v4_core0.$strip>>;
-}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "UPLOAD_METADATA_MISMATCH" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR", string, _fragno_dev_db0.DatabaseRequestContext<{
+}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "UPLOAD_METADATA_MISMATCH" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "PROVIDER_MISMATCH" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR", string, _fragno_dev_db0.DatabaseRequestContext<{
   onFileReady: _fragno_dev_db0.HookFn<any>;
   onUploadFailed: _fragno_dev_db0.HookFn<any>;
+  cleanupStorageObject: _fragno_dev_db0.HookFn<any>;
   onFileDeleted: _fragno_dev_db0.HookFn<any>;
   onUploadTimeout: _fragno_dev_db0.HookFn<any>;
 }>>, _fragno_dev_core0.FragnoRouteConfig<"POST", "/uploads/:uploadId/parts/complete", zod0.ZodObject<{
@@ -155,9 +188,10 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
 }, zod_v4_core0.$strip>, zod0.ZodObject<{
   bytesUploaded: zod0.ZodNumber;
   partsUploaded: zod0.ZodNumber;
-}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "UPLOAD_METADATA_MISMATCH" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR", string, _fragno_dev_db0.DatabaseRequestContext<{
+}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "UPLOAD_METADATA_MISMATCH" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "PROVIDER_MISMATCH" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR", string, _fragno_dev_db0.DatabaseRequestContext<{
   onFileReady: _fragno_dev_db0.HookFn<any>;
   onUploadFailed: _fragno_dev_db0.HookFn<any>;
+  cleanupStorageObject: _fragno_dev_db0.HookFn<any>;
   onFileDeleted: _fragno_dev_db0.HookFn<any>;
   onUploadTimeout: _fragno_dev_db0.HookFn<any>;
 }>>, _fragno_dev_core0.FragnoRouteConfig<"POST", "/uploads/:uploadId/complete", zod0.ZodObject<{
@@ -167,7 +201,6 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
   }, zod_v4_core0.$strip>>>;
 }, zod_v4_core0.$strip>, zod0.ZodObject<{
   fileKey: zod0.ZodString;
-  fileKeyParts: zod0.ZodArray<zod0.ZodUnion<readonly [zod0.ZodString, zod0.ZodNumber]>>;
   uploaderId: zod0.ZodNullable<zod0.ZodString>;
   filename: zod0.ZodString;
   sizeBytes: zod0.ZodNumber;
@@ -190,28 +223,29 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     ready: "ready";
     deleted: "deleted";
   }>;
-  storageProvider: zod0.ZodString;
+  provider: zod0.ZodString;
   createdAt: zod0.ZodString;
   updatedAt: zod0.ZodString;
   completedAt: zod0.ZodNullable<zod0.ZodString>;
   deletedAt: zod0.ZodNullable<zod0.ZodString>;
   errorCode: zod0.ZodNullable<zod0.ZodString>;
   errorMessage: zod0.ZodNullable<zod0.ZodString>;
-}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "UPLOAD_METADATA_MISMATCH" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR", string, _fragno_dev_db0.DatabaseRequestContext<{
+}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "UPLOAD_METADATA_MISMATCH" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "PROVIDER_MISMATCH" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR", string, _fragno_dev_db0.DatabaseRequestContext<{
   onFileReady: _fragno_dev_db0.HookFn<any>;
   onUploadFailed: _fragno_dev_db0.HookFn<any>;
+  cleanupStorageObject: _fragno_dev_db0.HookFn<any>;
   onFileDeleted: _fragno_dev_db0.HookFn<any>;
   onUploadTimeout: _fragno_dev_db0.HookFn<any>;
 }>>, _fragno_dev_core0.FragnoRouteConfig<"POST", "/uploads/:uploadId/abort", _standard_schema_spec0.StandardSchemaV1<unknown, unknown> | undefined, zod0.ZodObject<{
   ok: zod0.ZodLiteral<true>;
-}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "UPLOAD_METADATA_MISMATCH" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR", string, _fragno_dev_db0.DatabaseRequestContext<{
+}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "UPLOAD_METADATA_MISMATCH" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "PROVIDER_MISMATCH" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR", string, _fragno_dev_db0.DatabaseRequestContext<{
   onFileReady: _fragno_dev_db0.HookFn<any>;
   onUploadFailed: _fragno_dev_db0.HookFn<any>;
+  cleanupStorageObject: _fragno_dev_db0.HookFn<any>;
   onFileDeleted: _fragno_dev_db0.HookFn<any>;
   onUploadTimeout: _fragno_dev_db0.HookFn<any>;
 }>>, _fragno_dev_core0.FragnoRouteConfig<"PUT", "/uploads/:uploadId/content", _standard_schema_spec0.StandardSchemaV1<unknown, unknown> | undefined, zod0.ZodObject<{
   fileKey: zod0.ZodString;
-  fileKeyParts: zod0.ZodArray<zod0.ZodUnion<readonly [zod0.ZodString, zod0.ZodNumber]>>;
   uploaderId: zod0.ZodNullable<zod0.ZodString>;
   filename: zod0.ZodString;
   sizeBytes: zod0.ZodNumber;
@@ -234,21 +268,21 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     ready: "ready";
     deleted: "deleted";
   }>;
-  storageProvider: zod0.ZodString;
+  provider: zod0.ZodString;
   createdAt: zod0.ZodString;
   updatedAt: zod0.ZodString;
   completedAt: zod0.ZodNullable<zod0.ZodString>;
   deletedAt: zod0.ZodNullable<zod0.ZodString>;
   errorCode: zod0.ZodNullable<zod0.ZodString>;
   errorMessage: zod0.ZodNullable<zod0.ZodString>;
-}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "UPLOAD_METADATA_MISMATCH" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR", string, _fragno_dev_db0.DatabaseRequestContext<{
+}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "UPLOAD_METADATA_MISMATCH" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "PROVIDER_MISMATCH" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR", string, _fragno_dev_db0.DatabaseRequestContext<{
   onFileReady: _fragno_dev_db0.HookFn<any>;
   onUploadFailed: _fragno_dev_db0.HookFn<any>;
+  cleanupStorageObject: _fragno_dev_db0.HookFn<any>;
   onFileDeleted: _fragno_dev_db0.HookFn<any>;
   onUploadTimeout: _fragno_dev_db0.HookFn<any>;
 }>>, _fragno_dev_core0.FragnoRouteConfig<"POST", "/files", _standard_schema_spec0.StandardSchemaV1<unknown, unknown> | undefined, zod0.ZodObject<{
   fileKey: zod0.ZodString;
-  fileKeyParts: zod0.ZodArray<zod0.ZodUnion<readonly [zod0.ZodString, zod0.ZodNumber]>>;
   uploaderId: zod0.ZodNullable<zod0.ZodString>;
   filename: zod0.ZodString;
   sizeBytes: zod0.ZodNumber;
@@ -271,22 +305,22 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     ready: "ready";
     deleted: "deleted";
   }>;
-  storageProvider: zod0.ZodString;
+  provider: zod0.ZodString;
   createdAt: zod0.ZodString;
   updatedAt: zod0.ZodString;
   completedAt: zod0.ZodNullable<zod0.ZodString>;
   deletedAt: zod0.ZodNullable<zod0.ZodString>;
   errorCode: zod0.ZodNullable<zod0.ZodString>;
   errorMessage: zod0.ZodNullable<zod0.ZodString>;
-}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR" | "FILE_NOT_FOUND" | "SIGNED_URL_UNSUPPORTED", string, _fragno_dev_db0.DatabaseRequestContext<{
+}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR" | "FILE_NOT_FOUND" | "FILE_DELETED" | "SIGNED_URL_UNSUPPORTED", string, _fragno_dev_db0.DatabaseRequestContext<{
   onFileReady: _fragno_dev_db0.HookFn<any>;
   onUploadFailed: _fragno_dev_db0.HookFn<any>;
+  cleanupStorageObject: _fragno_dev_db0.HookFn<any>;
   onFileDeleted: _fragno_dev_db0.HookFn<any>;
   onUploadTimeout: _fragno_dev_db0.HookFn<any>;
 }>>, _fragno_dev_core0.FragnoRouteConfig<"GET", "/files", _standard_schema_spec0.StandardSchemaV1<unknown, unknown> | undefined, zod0.ZodObject<{
   files: zod0.ZodArray<zod0.ZodObject<{
     fileKey: zod0.ZodString;
-    fileKeyParts: zod0.ZodArray<zod0.ZodUnion<readonly [zod0.ZodString, zod0.ZodNumber]>>;
     uploaderId: zod0.ZodNullable<zod0.ZodString>;
     filename: zod0.ZodString;
     sizeBytes: zod0.ZodNumber;
@@ -309,7 +343,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
       ready: "ready";
       deleted: "deleted";
     }>;
-    storageProvider: zod0.ZodString;
+    provider: zod0.ZodString;
     createdAt: zod0.ZodString;
     updatedAt: zod0.ZodString;
     completedAt: zod0.ZodNullable<zod0.ZodString>;
@@ -319,14 +353,14 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
   }, zod_v4_core0.$strip>>;
   cursor: zod0.ZodOptional<zod0.ZodString>;
   hasNextPage: zod0.ZodBoolean;
-}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR" | "FILE_NOT_FOUND" | "SIGNED_URL_UNSUPPORTED", "status" | "uploaderId" | "pageSize" | "prefix" | "cursor", _fragno_dev_db0.DatabaseRequestContext<{
+}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR" | "FILE_NOT_FOUND" | "FILE_DELETED" | "SIGNED_URL_UNSUPPORTED", "provider" | "uploaderId" | "status" | "pageSize" | "prefix" | "cursor", _fragno_dev_db0.DatabaseRequestContext<{
   onFileReady: _fragno_dev_db0.HookFn<any>;
   onUploadFailed: _fragno_dev_db0.HookFn<any>;
+  cleanupStorageObject: _fragno_dev_db0.HookFn<any>;
   onFileDeleted: _fragno_dev_db0.HookFn<any>;
   onUploadTimeout: _fragno_dev_db0.HookFn<any>;
-}>>, _fragno_dev_core0.FragnoRouteConfig<"GET", "/files/:fileKey", _standard_schema_spec0.StandardSchemaV1<unknown, unknown> | undefined, zod0.ZodObject<{
+}>>, _fragno_dev_core0.FragnoRouteConfig<"GET", "/files/by-key", _standard_schema_spec0.StandardSchemaV1<unknown, unknown> | undefined, zod0.ZodObject<{
   fileKey: zod0.ZodString;
-  fileKeyParts: zod0.ZodArray<zod0.ZodUnion<readonly [zod0.ZodString, zod0.ZodNumber]>>;
   uploaderId: zod0.ZodNullable<zod0.ZodString>;
   filename: zod0.ZodString;
   sizeBytes: zod0.ZodNumber;
@@ -349,19 +383,20 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     ready: "ready";
     deleted: "deleted";
   }>;
-  storageProvider: zod0.ZodString;
+  provider: zod0.ZodString;
   createdAt: zod0.ZodString;
   updatedAt: zod0.ZodString;
   completedAt: zod0.ZodNullable<zod0.ZodString>;
   deletedAt: zod0.ZodNullable<zod0.ZodString>;
   errorCode: zod0.ZodNullable<zod0.ZodString>;
   errorMessage: zod0.ZodNullable<zod0.ZodString>;
-}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR" | "FILE_NOT_FOUND" | "SIGNED_URL_UNSUPPORTED", string, _fragno_dev_db0.DatabaseRequestContext<{
+}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR" | "FILE_NOT_FOUND" | "FILE_DELETED" | "SIGNED_URL_UNSUPPORTED", "key" | "provider", _fragno_dev_db0.DatabaseRequestContext<{
   onFileReady: _fragno_dev_db0.HookFn<any>;
   onUploadFailed: _fragno_dev_db0.HookFn<any>;
+  cleanupStorageObject: _fragno_dev_db0.HookFn<any>;
   onFileDeleted: _fragno_dev_db0.HookFn<any>;
   onUploadTimeout: _fragno_dev_db0.HookFn<any>;
-}>>, _fragno_dev_core0.FragnoRouteConfig<"PATCH", "/files/:fileKey", zod0.ZodObject<{
+}>>, _fragno_dev_core0.FragnoRouteConfig<"PATCH", "/files/by-key", zod0.ZodObject<{
   filename: zod0.ZodOptional<zod0.ZodString>;
   visibility: zod0.ZodOptional<zod0.ZodEnum<{
     private: "private";
@@ -372,7 +407,6 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
   metadata: zod0.ZodOptional<zod0.ZodNullable<zod0.ZodRecord<zod0.ZodString, zod0.ZodUnknown>>>;
 }, zod_v4_core0.$strip>, zod0.ZodObject<{
   fileKey: zod0.ZodString;
-  fileKeyParts: zod0.ZodArray<zod0.ZodUnion<readonly [zod0.ZodString, zod0.ZodNumber]>>;
   uploaderId: zod0.ZodNullable<zod0.ZodString>;
   filename: zod0.ZodString;
   sizeBytes: zod0.ZodNumber;
@@ -395,56 +429,62 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     ready: "ready";
     deleted: "deleted";
   }>;
-  storageProvider: zod0.ZodString;
+  provider: zod0.ZodString;
   createdAt: zod0.ZodString;
   updatedAt: zod0.ZodString;
   completedAt: zod0.ZodNullable<zod0.ZodString>;
   deletedAt: zod0.ZodNullable<zod0.ZodString>;
   errorCode: zod0.ZodNullable<zod0.ZodString>;
   errorMessage: zod0.ZodNullable<zod0.ZodString>;
-}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR" | "FILE_NOT_FOUND" | "SIGNED_URL_UNSUPPORTED", string, _fragno_dev_db0.DatabaseRequestContext<{
+}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR" | "FILE_NOT_FOUND" | "FILE_DELETED" | "SIGNED_URL_UNSUPPORTED", "key" | "provider", _fragno_dev_db0.DatabaseRequestContext<{
   onFileReady: _fragno_dev_db0.HookFn<any>;
   onUploadFailed: _fragno_dev_db0.HookFn<any>;
+  cleanupStorageObject: _fragno_dev_db0.HookFn<any>;
   onFileDeleted: _fragno_dev_db0.HookFn<any>;
   onUploadTimeout: _fragno_dev_db0.HookFn<any>;
-}>>, _fragno_dev_core0.FragnoRouteConfig<"DELETE", "/files/:fileKey", _standard_schema_spec0.StandardSchemaV1<unknown, unknown> | undefined, zod0.ZodObject<{
+}>>, _fragno_dev_core0.FragnoRouteConfig<"DELETE", "/files/by-key", _standard_schema_spec0.StandardSchemaV1<unknown, unknown> | undefined, zod0.ZodObject<{
   ok: zod0.ZodLiteral<true>;
-}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR" | "FILE_NOT_FOUND" | "SIGNED_URL_UNSUPPORTED", string, _fragno_dev_db0.DatabaseRequestContext<{
+}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR" | "FILE_NOT_FOUND" | "FILE_DELETED" | "SIGNED_URL_UNSUPPORTED", "key" | "provider", _fragno_dev_db0.DatabaseRequestContext<{
   onFileReady: _fragno_dev_db0.HookFn<any>;
   onUploadFailed: _fragno_dev_db0.HookFn<any>;
+  cleanupStorageObject: _fragno_dev_db0.HookFn<any>;
   onFileDeleted: _fragno_dev_db0.HookFn<any>;
   onUploadTimeout: _fragno_dev_db0.HookFn<any>;
-}>>, _fragno_dev_core0.FragnoRouteConfig<"GET", "/files/:fileKey/download-url", _standard_schema_spec0.StandardSchemaV1<unknown, unknown> | undefined, zod0.ZodObject<{
+}>>, _fragno_dev_core0.FragnoRouteConfig<"GET", "/files/by-key/download-url", _standard_schema_spec0.StandardSchemaV1<unknown, unknown> | undefined, zod0.ZodObject<{
   url: zod0.ZodString;
   headers: zod0.ZodOptional<zod0.ZodRecord<zod0.ZodString, zod0.ZodString>>;
   expiresAt: zod0.ZodDate;
-}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR" | "FILE_NOT_FOUND" | "SIGNED_URL_UNSUPPORTED", string, _fragno_dev_db0.DatabaseRequestContext<{
+}, zod_v4_core0.$strip>, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR" | "FILE_NOT_FOUND" | "FILE_DELETED" | "SIGNED_URL_UNSUPPORTED", "key" | "provider", _fragno_dev_db0.DatabaseRequestContext<{
   onFileReady: _fragno_dev_db0.HookFn<any>;
   onUploadFailed: _fragno_dev_db0.HookFn<any>;
+  cleanupStorageObject: _fragno_dev_db0.HookFn<any>;
   onFileDeleted: _fragno_dev_db0.HookFn<any>;
   onUploadTimeout: _fragno_dev_db0.HookFn<any>;
-}>>, _fragno_dev_core0.FragnoRouteConfig<"GET", "/files/:fileKey/content", _standard_schema_spec0.StandardSchemaV1<unknown, unknown> | undefined, _standard_schema_spec0.StandardSchemaV1<unknown, unknown> | undefined, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR" | "FILE_NOT_FOUND" | "SIGNED_URL_UNSUPPORTED", string, _fragno_dev_db0.DatabaseRequestContext<{
+}>>, _fragno_dev_core0.FragnoRouteConfig<"GET", "/files/by-key/content", _standard_schema_spec0.StandardSchemaV1<unknown, unknown> | undefined, _standard_schema_spec0.StandardSchemaV1<unknown, unknown> | undefined, "UPLOAD_NOT_FOUND" | "UPLOAD_ALREADY_ACTIVE" | "FILE_ALREADY_EXISTS" | "UPLOAD_EXPIRED" | "UPLOAD_INVALID_STATE" | "INVALID_FILE_KEY" | "INVALID_CHECKSUM" | "INVALID_REQUEST" | "STORAGE_ERROR" | "FILE_NOT_FOUND" | "FILE_DELETED" | "SIGNED_URL_UNSUPPORTED", "key" | "provider", _fragno_dev_db0.DatabaseRequestContext<{
   onFileReady: _fragno_dev_db0.HookFn<any>;
   onUploadFailed: _fragno_dev_db0.HookFn<any>;
+  cleanupStorageObject: _fragno_dev_db0.HookFn<any>;
   onFileDeleted: _fragno_dev_db0.HookFn<any>;
   onUploadTimeout: _fragno_dev_db0.HookFn<any>;
-}>>, ..._fragno_dev_core0.FragnoRouteConfig<_fragno_dev_core_api0.HTTPMethod, `/_internal/${string}`, any, any, any, any, any>[]], {
+}>>], {
   resolvedConfig: UploadFragmentResolvedConfig;
 } & _fragno_dev_db0.ImplicitDatabaseDependencies<_fragno_dev_db_schema0.Schema<{
-  file: _fragno_dev_db_schema0.Table<Record<string, _fragno_dev_db_schema0.AnyColumn> & Record<"id", _fragno_dev_db_schema0.IdColumn<"varchar(30)", string | _fragno_dev_db_schema0.FragnoId | null, _fragno_dev_db_schema0.FragnoId>> & Record<"fileKey", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"uploaderId", _fragno_dev_db_schema0.Column<"string", string | null, string | null>> & Record<"filename", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"sizeBytes", _fragno_dev_db_schema0.Column<"bigint", bigint, bigint>> & Record<"contentType", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"checksum", _fragno_dev_db_schema0.Column<"json", unknown, unknown>> & Record<"visibility", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"tags", _fragno_dev_db_schema0.Column<"json", unknown, unknown>> & Record<"metadata", _fragno_dev_db_schema0.Column<"json", unknown, unknown>> & Record<"status", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"storageProvider", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"storageKey", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"createdAt", _fragno_dev_db_schema0.Column<"timestamp", (_fragno_dev_db0.DbNow | Date) | null, Date>> & Record<"updatedAt", _fragno_dev_db_schema0.Column<"timestamp", (_fragno_dev_db0.DbNow | Date) | null, Date>> & Record<"completedAt", _fragno_dev_db_schema0.Column<"timestamp", (_fragno_dev_db0.DbNow | Date) | null, Date | null>> & Record<"deletedAt", _fragno_dev_db_schema0.Column<"timestamp", (_fragno_dev_db0.DbNow | Date) | null, Date | null>> & Record<"errorCode", _fragno_dev_db_schema0.Column<"string", string | null, string | null>> & Record<"errorMessage", _fragno_dev_db_schema0.Column<"string", string | null, string | null>>, Record<string, _fragno_dev_db_schema0.AnyRelation>, Record<string, _fragno_dev_db_schema0.Index<_fragno_dev_db_schema0.AnyColumn[], readonly string[]>> & Record<"idx_file_key", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"string", string, string>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["fileKey"]>> & Record<"idx_file_key_status", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"string", string, string>, _fragno_dev_db_schema0.Column<"string", string, string>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["fileKey", "status"]>> & Record<"idx_file_key_uploaderId", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"string", string, string>, _fragno_dev_db_schema0.Column<"string", string | null, string | null>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["fileKey", "uploaderId"]>> & Record<"idx_file_key_status_uploaderId", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"string", string, string>, _fragno_dev_db_schema0.Column<"string", string, string>, _fragno_dev_db_schema0.Column<"string", string | null, string | null>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["fileKey", "status", "uploaderId"]>> & Record<"idx_file_uploaderId", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"string", string | null, string | null>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["uploaderId"]>> & Record<"idx_file_createdAt", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"timestamp", (_fragno_dev_db0.DbNow | Date) | null, Date>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["createdAt"]>> & Record<"idx_file_status_createdAt", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"string", string, string>, _fragno_dev_db_schema0.Column<"timestamp", (_fragno_dev_db0.DbNow | Date) | null, Date>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["status", "createdAt"]>>>;
-  upload: _fragno_dev_db_schema0.Table<Record<string, _fragno_dev_db_schema0.AnyColumn> & Record<"id", _fragno_dev_db_schema0.IdColumn<"varchar(30)", string | _fragno_dev_db_schema0.FragnoId | null, _fragno_dev_db_schema0.FragnoId>> & Record<"fileKey", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"uploaderId", _fragno_dev_db_schema0.Column<"string", string | null, string | null>> & Record<"filename", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"expectedSizeBytes", _fragno_dev_db_schema0.Column<"bigint", bigint, bigint>> & Record<"contentType", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"checksum", _fragno_dev_db_schema0.Column<"json", unknown, unknown>> & Record<"visibility", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"tags", _fragno_dev_db_schema0.Column<"json", unknown, unknown>> & Record<"metadata", _fragno_dev_db_schema0.Column<"json", unknown, unknown>> & Record<"status", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"strategy", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"storageProvider", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"storageKey", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"storageUploadId", _fragno_dev_db_schema0.Column<"string", string | null, string | null>> & Record<"uploadUrl", _fragno_dev_db_schema0.Column<"string", string | null, string | null>> & Record<"uploadHeaders", _fragno_dev_db_schema0.Column<"json", unknown, unknown>> & Record<"bytesUploaded", _fragno_dev_db_schema0.Column<"bigint", bigint | null, bigint>> & Record<"partsUploaded", _fragno_dev_db_schema0.Column<"integer", number | null, number>> & Record<"partSizeBytes", _fragno_dev_db_schema0.Column<"integer", number | null, number | null>> & Record<"expiresAt", _fragno_dev_db_schema0.Column<"timestamp", _fragno_dev_db0.DbNow | Date, Date>> & Record<"createdAt", _fragno_dev_db_schema0.Column<"timestamp", (_fragno_dev_db0.DbNow | Date) | null, Date>> & Record<"updatedAt", _fragno_dev_db_schema0.Column<"timestamp", (_fragno_dev_db0.DbNow | Date) | null, Date>> & Record<"completedAt", _fragno_dev_db_schema0.Column<"timestamp", (_fragno_dev_db0.DbNow | Date) | null, Date | null>> & Record<"errorCode", _fragno_dev_db_schema0.Column<"string", string | null, string | null>> & Record<"errorMessage", _fragno_dev_db_schema0.Column<"string", string | null, string | null>>, Record<string, _fragno_dev_db_schema0.AnyRelation>, Record<string, _fragno_dev_db_schema0.Index<_fragno_dev_db_schema0.AnyColumn[], readonly string[]>> & Record<"idx_upload_file_key", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"string", string, string>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["fileKey"]>> & Record<"idx_upload_status", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"string", string, string>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["status"]>> & Record<"idx_upload_expiresAt", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"timestamp", _fragno_dev_db0.DbNow | Date, Date>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["expiresAt"]>>>;
-  upload_part: _fragno_dev_db_schema0.Table<Record<string, _fragno_dev_db_schema0.AnyColumn> & Record<"id", _fragno_dev_db_schema0.IdColumn<"varchar(30)", string | _fragno_dev_db_schema0.FragnoId | null, _fragno_dev_db_schema0.FragnoId>> & Record<"uploadId", _fragno_dev_db_schema0.Column<"bigint", string | bigint | _fragno_dev_db_schema0.FragnoId | _fragno_dev_db_schema0.FragnoReference, _fragno_dev_db_schema0.FragnoReference>> & Record<"partNumber", _fragno_dev_db_schema0.Column<"integer", number, number>> & Record<"etag", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"sizeBytes", _fragno_dev_db_schema0.Column<"bigint", bigint, bigint>> & Record<"createdAt", _fragno_dev_db_schema0.Column<"timestamp", (_fragno_dev_db0.DbNow | Date) | null, Date>>, Record<string, _fragno_dev_db_schema0.AnyRelation> & Record<"upload", _fragno_dev_db_schema0.Relation<"one", _fragno_dev_db_schema0.Table<Record<string, _fragno_dev_db_schema0.AnyColumn> & Record<"id", _fragno_dev_db_schema0.IdColumn<"varchar(30)", string | _fragno_dev_db_schema0.FragnoId | null, _fragno_dev_db_schema0.FragnoId>> & Record<"fileKey", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"uploaderId", _fragno_dev_db_schema0.Column<"string", string | null, string | null>> & Record<"filename", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"expectedSizeBytes", _fragno_dev_db_schema0.Column<"bigint", bigint, bigint>> & Record<"contentType", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"checksum", _fragno_dev_db_schema0.Column<"json", unknown, unknown>> & Record<"visibility", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"tags", _fragno_dev_db_schema0.Column<"json", unknown, unknown>> & Record<"metadata", _fragno_dev_db_schema0.Column<"json", unknown, unknown>> & Record<"status", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"strategy", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"storageProvider", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"storageKey", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"storageUploadId", _fragno_dev_db_schema0.Column<"string", string | null, string | null>> & Record<"uploadUrl", _fragno_dev_db_schema0.Column<"string", string | null, string | null>> & Record<"uploadHeaders", _fragno_dev_db_schema0.Column<"json", unknown, unknown>> & Record<"bytesUploaded", _fragno_dev_db_schema0.Column<"bigint", bigint | null, bigint>> & Record<"partsUploaded", _fragno_dev_db_schema0.Column<"integer", number | null, number>> & Record<"partSizeBytes", _fragno_dev_db_schema0.Column<"integer", number | null, number | null>> & Record<"expiresAt", _fragno_dev_db_schema0.Column<"timestamp", _fragno_dev_db0.DbNow | Date, Date>> & Record<"createdAt", _fragno_dev_db_schema0.Column<"timestamp", (_fragno_dev_db0.DbNow | Date) | null, Date>> & Record<"updatedAt", _fragno_dev_db_schema0.Column<"timestamp", (_fragno_dev_db0.DbNow | Date) | null, Date>> & Record<"completedAt", _fragno_dev_db_schema0.Column<"timestamp", (_fragno_dev_db0.DbNow | Date) | null, Date | null>> & Record<"errorCode", _fragno_dev_db_schema0.Column<"string", string | null, string | null>> & Record<"errorMessage", _fragno_dev_db_schema0.Column<"string", string | null, string | null>>, Record<string, _fragno_dev_db_schema0.AnyRelation>, Record<string, _fragno_dev_db_schema0.Index<_fragno_dev_db_schema0.AnyColumn[], readonly string[]>> & Record<"idx_upload_file_key", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"string", string, string>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["fileKey"]>> & Record<"idx_upload_status", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"string", string, string>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["status"]>> & Record<"idx_upload_expiresAt", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"timestamp", _fragno_dev_db0.DbNow | Date, Date>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["expiresAt"]>>>>>, Record<string, _fragno_dev_db_schema0.Index<_fragno_dev_db_schema0.AnyColumn[], readonly string[]>> & Record<"idx_upload_part_upload", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"bigint", string | bigint | _fragno_dev_db_schema0.FragnoId | _fragno_dev_db_schema0.FragnoReference, _fragno_dev_db_schema0.FragnoReference>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["uploadId"]>> & Record<"idx_upload_part_number", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"bigint", string | bigint | _fragno_dev_db_schema0.FragnoId | _fragno_dev_db_schema0.FragnoReference, _fragno_dev_db_schema0.FragnoReference>, _fragno_dev_db_schema0.Column<"integer", number, number>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["uploadId", "partNumber"]>>>;
+  file: _fragno_dev_db_schema0.Table<Record<"id", _fragno_dev_db_schema0.IdColumn<"varchar(128)", string | _fragno_dev_db_schema0.FragnoId | null, _fragno_dev_db_schema0.FragnoId>> & Record<"key", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"provider", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"uploaderId", _fragno_dev_db_schema0.Column<"string", string | null, string | null>> & Record<"filename", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"sizeBytes", _fragno_dev_db_schema0.Column<"bigint", bigint, bigint>> & Record<"contentType", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"checksum", _fragno_dev_db_schema0.Column<"json", unknown, unknown>> & Record<"visibility", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"tags", _fragno_dev_db_schema0.Column<"json", unknown, unknown>> & Record<"metadata", _fragno_dev_db_schema0.Column<"json", unknown, unknown>> & Record<"status", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"objectKey", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"createdAt", _fragno_dev_db_schema0.Column<"timestamp", (Date | _fragno_dev_db0.DbNow) | null, Date>> & Record<"updatedAt", _fragno_dev_db_schema0.Column<"timestamp", (Date | _fragno_dev_db0.DbNow) | null, Date>> & Record<"completedAt", _fragno_dev_db_schema0.Column<"timestamp", (Date | _fragno_dev_db0.DbNow) | null, Date | null>> & Record<"deletedAt", _fragno_dev_db_schema0.Column<"timestamp", (Date | _fragno_dev_db0.DbNow) | null, Date | null>> & Record<"errorCode", _fragno_dev_db_schema0.Column<"string", string | null, string | null>> & Record<"errorMessage", _fragno_dev_db_schema0.Column<"string", string | null, string | null>>, Record<string, _fragno_dev_db_schema0.AnyRelation>, Record<string, _fragno_dev_db_schema0.Index<_fragno_dev_db_schema0.AnyColumn[], readonly string[]>> & Record<"idx_file_provider_key", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"string", string, string>, _fragno_dev_db_schema0.Column<"string", string, string>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["provider", "key"]>> & Record<"idx_file_provider_key_status", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"string", string, string>, _fragno_dev_db_schema0.Column<"string", string, string>, _fragno_dev_db_schema0.Column<"string", string, string>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["provider", "key", "status"]>> & Record<"idx_file_provider_key_uploaderId", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"string", string, string>, _fragno_dev_db_schema0.Column<"string", string, string>, _fragno_dev_db_schema0.Column<"string", string | null, string | null>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["provider", "key", "uploaderId"]>> & Record<"idx_file_provider_key_status_uploaderId", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"string", string, string>, _fragno_dev_db_schema0.Column<"string", string, string>, _fragno_dev_db_schema0.Column<"string", string, string>, _fragno_dev_db_schema0.Column<"string", string | null, string | null>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["provider", "key", "status", "uploaderId"]>> & Record<"idx_file_uploaderId", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"string", string | null, string | null>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["uploaderId"]>> & Record<"idx_file_createdAt", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"timestamp", (Date | _fragno_dev_db0.DbNow) | null, Date>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["createdAt"]>> & Record<"idx_file_status_createdAt", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"string", string, string>, _fragno_dev_db_schema0.Column<"timestamp", (Date | _fragno_dev_db0.DbNow) | null, Date>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["status", "createdAt"]>>>;
+  upload: _fragno_dev_db_schema0.Table<Record<"id", _fragno_dev_db_schema0.IdColumn<"varchar(128)", string | _fragno_dev_db_schema0.FragnoId | null, _fragno_dev_db_schema0.FragnoId>> & Record<"key", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"provider", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"uploaderId", _fragno_dev_db_schema0.Column<"string", string | null, string | null>> & Record<"filename", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"expectedSizeBytes", _fragno_dev_db_schema0.Column<"bigint", bigint, bigint>> & Record<"contentType", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"checksum", _fragno_dev_db_schema0.Column<"json", unknown, unknown>> & Record<"visibility", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"tags", _fragno_dev_db_schema0.Column<"json", unknown, unknown>> & Record<"metadata", _fragno_dev_db_schema0.Column<"json", unknown, unknown>> & Record<"status", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"strategy", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"objectKey", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"storageUploadId", _fragno_dev_db_schema0.Column<"string", string | null, string | null>> & Record<"uploadUrl", _fragno_dev_db_schema0.Column<"string", string | null, string | null>> & Record<"uploadHeaders", _fragno_dev_db_schema0.Column<"json", unknown, unknown>> & Record<"bytesUploaded", _fragno_dev_db_schema0.Column<"bigint", bigint | null, bigint>> & Record<"partsUploaded", _fragno_dev_db_schema0.Column<"integer", number | null, number>> & Record<"partSizeBytes", _fragno_dev_db_schema0.Column<"integer", number | null, number | null>> & Record<"expiresAt", _fragno_dev_db_schema0.Column<"timestamp", Date | _fragno_dev_db0.DbNow, Date>> & Record<"createdAt", _fragno_dev_db_schema0.Column<"timestamp", (Date | _fragno_dev_db0.DbNow) | null, Date>> & Record<"updatedAt", _fragno_dev_db_schema0.Column<"timestamp", (Date | _fragno_dev_db0.DbNow) | null, Date>> & Record<"completedAt", _fragno_dev_db_schema0.Column<"timestamp", (Date | _fragno_dev_db0.DbNow) | null, Date | null>> & Record<"errorCode", _fragno_dev_db_schema0.Column<"string", string | null, string | null>> & Record<"errorMessage", _fragno_dev_db_schema0.Column<"string", string | null, string | null>>, Record<string, _fragno_dev_db_schema0.AnyRelation>, Record<string, _fragno_dev_db_schema0.Index<_fragno_dev_db_schema0.AnyColumn[], readonly string[]>> & Record<"idx_upload_provider_key", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"string", string, string>, _fragno_dev_db_schema0.Column<"string", string, string>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["provider", "key"]>> & Record<"idx_upload_status", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"string", string, string>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["status"]>> & Record<"idx_upload_expiresAt", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"timestamp", Date | _fragno_dev_db0.DbNow, Date>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["expiresAt"]>>>;
+  upload_part: _fragno_dev_db_schema0.Table<Record<"id", _fragno_dev_db_schema0.IdColumn<"varchar(128)", string | _fragno_dev_db_schema0.FragnoId | null, _fragno_dev_db_schema0.FragnoId>> & Record<"uploadId", _fragno_dev_db_schema0.Column<"bigint", string | bigint | _fragno_dev_db_schema0.FragnoId | _fragno_dev_db_schema0.FragnoReference, _fragno_dev_db_schema0.FragnoReference>> & Record<"partNumber", _fragno_dev_db_schema0.Column<"integer", number, number>> & Record<"etag", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"sizeBytes", _fragno_dev_db_schema0.Column<"bigint", bigint, bigint>> & Record<"createdAt", _fragno_dev_db_schema0.Column<"timestamp", (Date | _fragno_dev_db0.DbNow) | null, Date>>, Record<string, _fragno_dev_db_schema0.AnyRelation> & Record<"upload", _fragno_dev_db_schema0.Relation<"one", _fragno_dev_db_schema0.Table<Record<"id", _fragno_dev_db_schema0.IdColumn<"varchar(128)", string | _fragno_dev_db_schema0.FragnoId | null, _fragno_dev_db_schema0.FragnoId>> & Record<"key", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"provider", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"uploaderId", _fragno_dev_db_schema0.Column<"string", string | null, string | null>> & Record<"filename", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"expectedSizeBytes", _fragno_dev_db_schema0.Column<"bigint", bigint, bigint>> & Record<"contentType", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"checksum", _fragno_dev_db_schema0.Column<"json", unknown, unknown>> & Record<"visibility", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"tags", _fragno_dev_db_schema0.Column<"json", unknown, unknown>> & Record<"metadata", _fragno_dev_db_schema0.Column<"json", unknown, unknown>> & Record<"status", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"strategy", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"objectKey", _fragno_dev_db_schema0.Column<"string", string, string>> & Record<"storageUploadId", _fragno_dev_db_schema0.Column<"string", string | null, string | null>> & Record<"uploadUrl", _fragno_dev_db_schema0.Column<"string", string | null, string | null>> & Record<"uploadHeaders", _fragno_dev_db_schema0.Column<"json", unknown, unknown>> & Record<"bytesUploaded", _fragno_dev_db_schema0.Column<"bigint", bigint | null, bigint>> & Record<"partsUploaded", _fragno_dev_db_schema0.Column<"integer", number | null, number>> & Record<"partSizeBytes", _fragno_dev_db_schema0.Column<"integer", number | null, number | null>> & Record<"expiresAt", _fragno_dev_db_schema0.Column<"timestamp", Date | _fragno_dev_db0.DbNow, Date>> & Record<"createdAt", _fragno_dev_db_schema0.Column<"timestamp", (Date | _fragno_dev_db0.DbNow) | null, Date>> & Record<"updatedAt", _fragno_dev_db_schema0.Column<"timestamp", (Date | _fragno_dev_db0.DbNow) | null, Date>> & Record<"completedAt", _fragno_dev_db_schema0.Column<"timestamp", (Date | _fragno_dev_db0.DbNow) | null, Date | null>> & Record<"errorCode", _fragno_dev_db_schema0.Column<"string", string | null, string | null>> & Record<"errorMessage", _fragno_dev_db_schema0.Column<"string", string | null, string | null>>, Record<string, _fragno_dev_db_schema0.AnyRelation>, Record<string, _fragno_dev_db_schema0.Index<_fragno_dev_db_schema0.AnyColumn[], readonly string[]>> & Record<"idx_upload_provider_key", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"string", string, string>, _fragno_dev_db_schema0.Column<"string", string, string>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["provider", "key"]>> & Record<"idx_upload_status", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"string", string, string>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["status"]>> & Record<"idx_upload_expiresAt", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"timestamp", Date | _fragno_dev_db0.DbNow, Date>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["expiresAt"]>>>>>, Record<string, _fragno_dev_db_schema0.Index<_fragno_dev_db_schema0.AnyColumn[], readonly string[]>> & Record<"idx_upload_part_upload", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"bigint", string | bigint | _fragno_dev_db_schema0.FragnoId | _fragno_dev_db_schema0.FragnoReference, _fragno_dev_db_schema0.FragnoReference>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["uploadId"]>> & Record<"idx_upload_part_number", _fragno_dev_db_schema0.Index<readonly [_fragno_dev_db_schema0.Column<"bigint", string | bigint | _fragno_dev_db_schema0.FragnoId | _fragno_dev_db_schema0.FragnoReference, _fragno_dev_db_schema0.FragnoReference>, _fragno_dev_db_schema0.Column<"integer", number, number>] & _fragno_dev_db_schema0.AnyColumn[], readonly ["uploadId", "partNumber"]>>>;
 }>>, _fragno_dev_core0.BoundServices<{
   findFileByKey: (this: _fragno_dev_core0.RequestThisContext & {
     serviceTx<TSchema extends _fragno_dev_db_schema0.AnySchema>(schema: TSchema): _fragno_dev_db0.ServiceTxBuilder<TSchema, readonly [], [], [], unknown, unknown, false, false, false, false, {
       onFileReady: (payload: FileHookPayload) => void | Promise<void>;
       onUploadFailed: (payload: FileHookPayload) => void | Promise<void>;
       onFileDeleted: (payload: FileHookPayload) => void | Promise<void>;
+      cleanupStorageObject: (payload: FileHookPayload) => void | Promise<void>;
       onUploadTimeout: (payload: UploadTimeoutPayload) => void | Promise<void>;
     }>;
-  }, fileKey: FileKeyEncoded) => _fragno_dev_db0.TxResult<{
+  }, input: FileByKeyInput) => _fragno_dev_db0.TxResult<{
     id: _fragno_dev_db_schema0.FragnoId;
-    fileKey: string;
+    key: string;
+    provider: string;
     uploaderId: string | null;
     filename: string;
     sizeBytes: bigint;
@@ -454,8 +494,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     tags: unknown;
     metadata: unknown;
     status: string;
-    storageProvider: string;
-    storageKey: string;
+    objectKey: string;
     createdAt: Date;
     updatedAt: Date;
     completedAt: Date | null;
@@ -464,7 +503,8 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     errorMessage: string | null;
   } | null, {
     id: _fragno_dev_db_schema0.FragnoId;
-    fileKey: string;
+    key: string;
+    provider: string;
     uploaderId: string | null;
     filename: string;
     sizeBytes: bigint;
@@ -474,8 +514,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     tags: unknown;
     metadata: unknown;
     status: string;
-    storageProvider: string;
-    storageKey: string;
+    objectKey: string;
     createdAt: Date;
     updatedAt: Date;
     completedAt: Date | null;
@@ -488,11 +527,13 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
       onFileReady: (payload: FileHookPayload) => void | Promise<void>;
       onUploadFailed: (payload: FileHookPayload) => void | Promise<void>;
       onFileDeleted: (payload: FileHookPayload) => void | Promise<void>;
+      cleanupStorageObject: (payload: FileHookPayload) => void | Promise<void>;
       onUploadTimeout: (payload: UploadTimeoutPayload) => void | Promise<void>;
     }>;
-  }, fileKey: FileKeyEncoded) => _fragno_dev_db0.TxResult<{
+  }, input: FileByKeyInput) => _fragno_dev_db0.TxResult<{
     id: _fragno_dev_db_schema0.FragnoId;
-    fileKey: string;
+    key: string;
+    provider: string;
     uploaderId: string | null;
     filename: string;
     sizeBytes: bigint;
@@ -502,8 +543,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     tags: unknown;
     metadata: unknown;
     status: string;
-    storageProvider: string;
-    storageKey: string;
+    objectKey: string;
     createdAt: Date;
     updatedAt: Date;
     completedAt: Date | null;
@@ -512,7 +552,8 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     errorMessage: string | null;
   }, {
     id: _fragno_dev_db_schema0.FragnoId;
-    fileKey: string;
+    key: string;
+    provider: string;
     uploaderId: string | null;
     filename: string;
     sizeBytes: bigint;
@@ -522,8 +563,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     tags: unknown;
     metadata: unknown;
     status: string;
-    storageProvider: string;
-    storageKey: string;
+    objectKey: string;
     createdAt: Date;
     updatedAt: Date;
     completedAt: Date | null;
@@ -536,11 +576,13 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
       onFileReady: (payload: FileHookPayload) => void | Promise<void>;
       onUploadFailed: (payload: FileHookPayload) => void | Promise<void>;
       onFileDeleted: (payload: FileHookPayload) => void | Promise<void>;
+      cleanupStorageObject: (payload: FileHookPayload) => void | Promise<void>;
       onUploadTimeout: (payload: UploadTimeoutPayload) => void | Promise<void>;
     }>;
   }, input: ListFilesInput) => _fragno_dev_db0.TxResult<_fragno_dev_db0.CursorResult<{
     id: _fragno_dev_db_schema0.FragnoId;
-    fileKey: string;
+    key: string;
+    provider: string;
     uploaderId: string | null;
     filename: string;
     sizeBytes: bigint;
@@ -550,8 +592,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     tags: unknown;
     metadata: unknown;
     status: string;
-    storageProvider: string;
-    storageKey: string;
+    objectKey: string;
     createdAt: Date;
     updatedAt: Date;
     completedAt: Date | null;
@@ -560,7 +601,8 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     errorMessage: string | null;
   }>, _fragno_dev_db0.CursorResult<{
     id: _fragno_dev_db_schema0.FragnoId;
-    fileKey: string;
+    key: string;
+    provider: string;
     uploaderId: string | null;
     filename: string;
     sizeBytes: bigint;
@@ -570,8 +612,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     tags: unknown;
     metadata: unknown;
     status: string;
-    storageProvider: string;
-    storageKey: string;
+    objectKey: string;
     createdAt: Date;
     updatedAt: Date;
     completedAt: Date | null;
@@ -584,23 +625,24 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
       onFileReady: (payload: FileHookPayload) => void | Promise<void>;
       onUploadFailed: (payload: FileHookPayload) => void | Promise<void>;
       onFileDeleted: (payload: FileHookPayload) => void | Promise<void>;
+      cleanupStorageObject: (payload: FileHookPayload) => void | Promise<void>;
       onUploadTimeout: (payload: UploadTimeoutPayload) => void | Promise<void>;
     }>;
-  }, fileKey: FileKeyEncoded, input: UpdateFileInput) => _fragno_dev_db0.TxResult<{
+  }, fileByKey: FileByKeyInput, input: UpdateFileInput) => _fragno_dev_db0.TxResult<{
     filename: string;
     visibility: string;
     tags: unknown;
     metadata: unknown;
     updatedAt: Date;
     id: _fragno_dev_db_schema0.FragnoId;
-    fileKey: string;
+    key: string;
+    provider: string;
     uploaderId: string | null;
     sizeBytes: bigint;
     contentType: string;
     checksum: unknown;
     status: string;
-    storageProvider: string;
-    storageKey: string;
+    objectKey: string;
     createdAt: Date;
     completedAt: Date | null;
     deletedAt: Date | null;
@@ -608,7 +650,8 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     errorMessage: string | null;
   }, [{
     id: _fragno_dev_db_schema0.FragnoId;
-    fileKey: string;
+    key: string;
+    provider: string;
     uploaderId: string | null;
     filename: string;
     sizeBytes: bigint;
@@ -618,8 +661,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     tags: unknown;
     metadata: unknown;
     status: string;
-    storageProvider: string;
-    storageKey: string;
+    objectKey: string;
     createdAt: Date;
     updatedAt: Date;
     completedAt: Date | null;
@@ -632,11 +674,13 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
       onFileReady: (payload: FileHookPayload) => void | Promise<void>;
       onUploadFailed: (payload: FileHookPayload) => void | Promise<void>;
       onFileDeleted: (payload: FileHookPayload) => void | Promise<void>;
+      cleanupStorageObject: (payload: FileHookPayload) => void | Promise<void>;
       onUploadTimeout: (payload: UploadTimeoutPayload) => void | Promise<void>;
     }>;
-  }, fileKey: FileKeyEncoded, fileKeyParts: FileKeyParts, uploadId?: string) => _fragno_dev_db0.TxResult<{
+  }, fileByKey: FileByKeyInput, uploadId?: string) => _fragno_dev_db0.TxResult<{
     id: _fragno_dev_db_schema0.FragnoId;
-    fileKey: string;
+    key: string;
+    provider: string;
     uploaderId: string | null;
     filename: string;
     sizeBytes: bigint;
@@ -646,8 +690,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     tags: unknown;
     metadata: unknown;
     status: string;
-    storageProvider: string;
-    storageKey: string;
+    objectKey: string;
     createdAt: Date;
     updatedAt: Date;
     completedAt: Date | null;
@@ -656,7 +699,8 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     errorMessage: string | null;
   }, [{
     id: _fragno_dev_db_schema0.FragnoId;
-    fileKey: string;
+    key: string;
+    provider: string;
     uploaderId: string | null;
     filename: string;
     sizeBytes: bigint;
@@ -666,8 +710,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     tags: unknown;
     metadata: unknown;
     status: string;
-    storageProvider: string;
-    storageKey: string;
+    objectKey: string;
     createdAt: Date;
     updatedAt: Date;
     completedAt: Date | null;
@@ -680,6 +723,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
       onFileReady: (payload: FileHookPayload) => void | Promise<void>;
       onUploadFailed: (payload: FileHookPayload) => void | Promise<void>;
       onFileDeleted: (payload: FileHookPayload) => void | Promise<void>;
+      cleanupStorageObject: (payload: FileHookPayload) => void | Promise<void>;
       onUploadTimeout: (payload: UploadTimeoutPayload) => void | Promise<void>;
     }>;
   }, input: CreateUploadInput, options: {
@@ -690,16 +734,18 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
       onFileReady: (payload: FileHookPayload) => void | Promise<void>;
       onUploadFailed: (payload: FileHookPayload) => void | Promise<void>;
       onFileDeleted: (payload: FileHookPayload) => void | Promise<void>;
+      cleanupStorageObject: (payload: FileHookPayload) => void | Promise<void>;
       onUploadTimeout: (payload: UploadTimeoutPayload) => void | Promise<void>;
     }>;
   }, input: CreateUploadInput & {
     storageInit: Awaited<ReturnType<(input: {
-      fileKey: FileKeyEncoded;
-      fileKeyParts: FileKeyParts;
+      provider: string;
+      fileKey: FileKey;
       sizeBytes: bigint;
       contentType: string;
       checksum?: UploadChecksum | null;
       metadata?: Record<string, unknown> | null;
+      objectKeyVersionSegment?: string;
     }) => Promise<{
       strategy: "direct-single" | "direct-multipart" | "proxy";
       storageKey: string;
@@ -718,62 +764,229 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     result: CreateUploadResult;
   }, [{
     id: _fragno_dev_db_schema0.FragnoId;
-    fileKey: string;
+    key: string;
+    provider: string;
     uploaderId: string | null;
     filename: string;
-    sizeBytes: bigint;
+    expectedSizeBytes: bigint;
     contentType: string;
     checksum: unknown;
     visibility: string;
     tags: unknown;
     metadata: unknown;
     status: string;
-    storageProvider: string;
-    storageKey: string;
+    strategy: string;
+    objectKey: string;
+    storageUploadId: string | null;
+    uploadUrl: string | null;
+    uploadHeaders: unknown;
+    bytesUploaded: bigint;
+    partsUploaded: number;
+    partSizeBytes: number | null;
+    expiresAt: Date;
     createdAt: Date;
     updatedAt: Date;
     completedAt: Date | null;
-    deletedAt: Date | null;
     errorCode: string | null;
     errorMessage: string | null;
-  } | null, {
+  }[]]>;
+  createCompletedUpload: (this: _fragno_dev_core0.RequestThisContext & {
+    serviceTx<TSchema extends _fragno_dev_db_schema0.AnySchema>(schema: TSchema): _fragno_dev_db0.ServiceTxBuilder<TSchema, readonly [], [], [], unknown, unknown, false, false, false, false, {
+      onFileReady: (payload: FileHookPayload) => void | Promise<void>;
+      onUploadFailed: (payload: FileHookPayload) => void | Promise<void>;
+      onFileDeleted: (payload: FileHookPayload) => void | Promise<void>;
+      cleanupStorageObject: (payload: FileHookPayload) => void | Promise<void>;
+      onUploadTimeout: (payload: UploadTimeoutPayload) => void | Promise<void>;
+    }>;
+  }, input: CreateUploadInput & {
+    storageInit: Awaited<ReturnType<(input: {
+      provider: string;
+      fileKey: FileKey;
+      sizeBytes: bigint;
+      contentType: string;
+      checksum?: UploadChecksum | null;
+      metadata?: Record<string, unknown> | null;
+      objectKeyVersionSegment?: string;
+    }) => Promise<{
+      strategy: "direct-single" | "direct-multipart" | "proxy";
+      storageKey: string;
+      storageUploadId?: string;
+      partSizeBytes?: number;
+      expiresAt: Date;
+      uploadUrl?: string;
+      uploadHeaders?: Record<string, string>;
+    }>>>;
+    completedSizeBytes: bigint;
+  }) => _fragno_dev_db0.TxResult<{
+    upload: {
+      id: _fragno_dev_db_schema0.FragnoId;
+      key: string;
+      provider: string;
+      uploaderId: string | null;
+      filename: string;
+      expectedSizeBytes: bigint;
+      contentType: string;
+      checksum: unknown;
+      visibility: string;
+      tags: unknown;
+      metadata: unknown;
+      status: string;
+      strategy: string;
+      objectKey: string;
+      storageUploadId: string | null;
+      uploadUrl: string | null;
+      uploadHeaders: unknown;
+      bytesUploaded: bigint;
+      partsUploaded: number;
+      partSizeBytes: number | null;
+      expiresAt: Date;
+      createdAt: Date;
+      updatedAt: Date;
+      completedAt: Date | null;
+      errorCode: string | null;
+      errorMessage: string | null;
+    };
+    file: {
+      key: string;
+      provider: string;
+      uploaderId: string | null;
+      filename: string;
+      sizeBytes: bigint;
+      contentType: string;
+      checksum: UploadChecksum | null;
+      visibility: FileVisibility;
+      tags: string[] | null;
+      metadata: Record<string, unknown> | null;
+      status: FileStatus;
+      objectKey: string;
+      createdAt: Date;
+      updatedAt: Date;
+      completedAt: Date;
+      deletedAt: null;
+      errorCode: null;
+      errorMessage: null;
+      id: _fragno_dev_db_schema0.FragnoId;
+    };
+  }, [{
     id: _fragno_dev_db_schema0.FragnoId;
-    fileKey: string;
+    key: string;
+    provider: string;
     uploaderId: string | null;
     filename: string;
-    expectedSizeBytes: bigint;
+    sizeBytes: bigint;
     contentType: string;
     checksum: unknown;
     visibility: string;
     tags: unknown;
     metadata: unknown;
     status: string;
-    strategy: string;
-    storageProvider: string;
-    storageKey: string;
-    storageUploadId: string | null;
-    uploadUrl: string | null;
-    uploadHeaders: unknown;
-    bytesUploaded: bigint;
-    partsUploaded: number;
-    partSizeBytes: number | null;
-    expiresAt: Date;
+    objectKey: string;
     createdAt: Date;
     updatedAt: Date;
     completedAt: Date | null;
+    deletedAt: Date | null;
     errorCode: string | null;
     errorMessage: string | null;
-  }[]]>;
+  } | null]>;
+  createFailedUpload: (this: _fragno_dev_core0.RequestThisContext & {
+    serviceTx<TSchema extends _fragno_dev_db_schema0.AnySchema>(schema: TSchema): _fragno_dev_db0.ServiceTxBuilder<TSchema, readonly [], [], [], unknown, unknown, false, false, false, false, {
+      onFileReady: (payload: FileHookPayload) => void | Promise<void>;
+      onUploadFailed: (payload: FileHookPayload) => void | Promise<void>;
+      onFileDeleted: (payload: FileHookPayload) => void | Promise<void>;
+      cleanupStorageObject: (payload: FileHookPayload) => void | Promise<void>;
+      onUploadTimeout: (payload: UploadTimeoutPayload) => void | Promise<void>;
+    }>;
+  }, input: CreateUploadInput & {
+    storageInit: Awaited<ReturnType<(input: {
+      provider: string;
+      fileKey: FileKey;
+      sizeBytes: bigint;
+      contentType: string;
+      checksum?: UploadChecksum | null;
+      metadata?: Record<string, unknown> | null;
+      objectKeyVersionSegment?: string;
+    }) => Promise<{
+      strategy: "direct-single" | "direct-multipart" | "proxy";
+      storageKey: string;
+      storageUploadId?: string;
+      partSizeBytes?: number;
+      expiresAt: Date;
+      uploadUrl?: string;
+      uploadHeaders?: Record<string, string>;
+    }>>>;
+    errorCode: string;
+    errorMessage?: string | null;
+  }) => _fragno_dev_db0.TxResult<{
+    upload: {
+      id: _fragno_dev_db_schema0.FragnoId;
+      key: string;
+      provider: string;
+      uploaderId: string | null;
+      filename: string;
+      expectedSizeBytes: bigint;
+      contentType: string;
+      checksum: unknown;
+      visibility: string;
+      tags: unknown;
+      metadata: unknown;
+      status: string;
+      strategy: string;
+      objectKey: string;
+      storageUploadId: string | null;
+      uploadUrl: string | null;
+      uploadHeaders: unknown;
+      bytesUploaded: bigint;
+      partsUploaded: number;
+      partSizeBytes: number | null;
+      expiresAt: Date;
+      createdAt: Date;
+      updatedAt: Date;
+      completedAt: Date | null;
+      errorCode: string | null;
+      errorMessage: string | null;
+    };
+  }, {
+    upload: {
+      id: _fragno_dev_db_schema0.FragnoId;
+      key: string;
+      provider: string;
+      uploaderId: string | null;
+      filename: string;
+      expectedSizeBytes: bigint;
+      contentType: string;
+      checksum: unknown;
+      visibility: string;
+      tags: unknown;
+      metadata: unknown;
+      status: string;
+      strategy: string;
+      objectKey: string;
+      storageUploadId: string | null;
+      uploadUrl: string | null;
+      uploadHeaders: unknown;
+      bytesUploaded: bigint;
+      partsUploaded: number;
+      partSizeBytes: number | null;
+      expiresAt: Date;
+      createdAt: Date;
+      updatedAt: Date;
+      completedAt: Date | null;
+      errorCode: string | null;
+      errorMessage: string | null;
+    };
+  }>;
   getUploadStatus: (this: _fragno_dev_core0.RequestThisContext & {
     serviceTx<TSchema extends _fragno_dev_db_schema0.AnySchema>(schema: TSchema): _fragno_dev_db0.ServiceTxBuilder<TSchema, readonly [], [], [], unknown, unknown, false, false, false, false, {
       onFileReady: (payload: FileHookPayload) => void | Promise<void>;
       onUploadFailed: (payload: FileHookPayload) => void | Promise<void>;
       onFileDeleted: (payload: FileHookPayload) => void | Promise<void>;
+      cleanupStorageObject: (payload: FileHookPayload) => void | Promise<void>;
       onUploadTimeout: (payload: UploadTimeoutPayload) => void | Promise<void>;
     }>;
   }, uploadId: string) => _fragno_dev_db0.TxResult<{
     id: _fragno_dev_db_schema0.FragnoId;
-    fileKey: string;
+    key: string;
+    provider: string;
     uploaderId: string | null;
     filename: string;
     expectedSizeBytes: bigint;
@@ -784,8 +997,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     metadata: unknown;
     status: string;
     strategy: string;
-    storageProvider: string;
-    storageKey: string;
+    objectKey: string;
     storageUploadId: string | null;
     uploadUrl: string | null;
     uploadHeaders: unknown;
@@ -800,7 +1012,8 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     errorMessage: string | null;
   }, {
     id: _fragno_dev_db_schema0.FragnoId;
-    fileKey: string;
+    key: string;
+    provider: string;
     uploaderId: string | null;
     filename: string;
     expectedSizeBytes: bigint;
@@ -811,8 +1024,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     metadata: unknown;
     status: string;
     strategy: string;
-    storageProvider: string;
-    storageKey: string;
+    objectKey: string;
     storageUploadId: string | null;
     uploadUrl: string | null;
     uploadHeaders: unknown;
@@ -831,6 +1043,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
       onFileReady: (payload: FileHookPayload) => void | Promise<void>;
       onUploadFailed: (payload: FileHookPayload) => void | Promise<void>;
       onFileDeleted: (payload: FileHookPayload) => void | Promise<void>;
+      cleanupStorageObject: (payload: FileHookPayload) => void | Promise<void>;
       onUploadTimeout: (payload: UploadTimeoutPayload) => void | Promise<void>;
     }>;
   }, uploadId: string) => _fragno_dev_db0.TxResult<{
@@ -853,6 +1066,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
       onFileReady: (payload: FileHookPayload) => void | Promise<void>;
       onUploadFailed: (payload: FileHookPayload) => void | Promise<void>;
       onFileDeleted: (payload: FileHookPayload) => void | Promise<void>;
+      cleanupStorageObject: (payload: FileHookPayload) => void | Promise<void>;
       onUploadTimeout: (payload: UploadTimeoutPayload) => void | Promise<void>;
     }>;
   }, uploadId: string, input: UploadProgressInput) => _fragno_dev_db0.TxResult<{
@@ -860,7 +1074,8 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     partsUploaded: number;
   }, [{
     id: _fragno_dev_db_schema0.FragnoId;
-    fileKey: string;
+    key: string;
+    provider: string;
     uploaderId: string | null;
     filename: string;
     expectedSizeBytes: bigint;
@@ -871,8 +1086,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     metadata: unknown;
     status: string;
     strategy: string;
-    storageProvider: string;
-    storageKey: string;
+    objectKey: string;
     storageUploadId: string | null;
     uploadUrl: string | null;
     uploadHeaders: unknown;
@@ -891,6 +1105,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
       onFileReady: (payload: FileHookPayload) => void | Promise<void>;
       onUploadFailed: (payload: FileHookPayload) => void | Promise<void>;
       onFileDeleted: (payload: FileHookPayload) => void | Promise<void>;
+      cleanupStorageObject: (payload: FileHookPayload) => void | Promise<void>;
       onUploadTimeout: (payload: UploadTimeoutPayload) => void | Promise<void>;
     }>;
   }, uploadId: string, input: CompletePartsInput) => _fragno_dev_db0.TxResult<{
@@ -898,7 +1113,8 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     bytesUploaded: bigint;
   }, [{
     id: _fragno_dev_db_schema0.FragnoId;
-    fileKey: string;
+    key: string;
+    provider: string;
     uploaderId: string | null;
     filename: string;
     expectedSizeBytes: bigint;
@@ -909,8 +1125,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     metadata: unknown;
     status: string;
     strategy: string;
-    storageProvider: string;
-    storageKey: string;
+    objectKey: string;
     storageUploadId: string | null;
     uploadUrl: string | null;
     uploadHeaders: unknown;
@@ -931,14 +1146,42 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     sizeBytes: bigint;
     createdAt: Date;
   }[]]>;
-  markUploadComplete: (this: _fragno_dev_core0.RequestThisContext & {
+  markUploadCompleteFromSnapshot: (this: _fragno_dev_core0.RequestThisContext & {
     serviceTx<TSchema extends _fragno_dev_db_schema0.AnySchema>(schema: TSchema): _fragno_dev_db0.ServiceTxBuilder<TSchema, readonly [], [], [], unknown, unknown, false, false, false, false, {
       onFileReady: (payload: FileHookPayload) => void | Promise<void>;
       onUploadFailed: (payload: FileHookPayload) => void | Promise<void>;
       onFileDeleted: (payload: FileHookPayload) => void | Promise<void>;
+      cleanupStorageObject: (payload: FileHookPayload) => void | Promise<void>;
       onUploadTimeout: (payload: UploadTimeoutPayload) => void | Promise<void>;
     }>;
-  }, uploadId: string, fileKey: FileKeyEncoded, options?: {
+  }, upload: {
+    id: _fragno_dev_db_schema0.FragnoId;
+    key: string;
+    provider: string;
+    uploaderId: string | null;
+    filename: string;
+    expectedSizeBytes: bigint;
+    contentType: string;
+    checksum: unknown;
+    visibility: string;
+    tags: unknown;
+    metadata: unknown;
+    status: string;
+    strategy: string;
+    objectKey: string;
+    storageUploadId: string | null;
+    uploadUrl: string | null;
+    uploadHeaders: unknown;
+    bytesUploaded: bigint;
+    partsUploaded: number;
+    partSizeBytes: number | null;
+    expiresAt: Date;
+    createdAt: Date;
+    updatedAt: Date;
+    completedAt: Date | null;
+    errorCode: string | null;
+    errorMessage: string | null;
+  }, options?: {
     sizeBytes?: bigint;
   }) => _fragno_dev_db0.TxResult<{
     upload: {
@@ -947,7 +1190,8 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
       completedAt: Date;
       bytesUploaded: bigint;
       id: _fragno_dev_db_schema0.FragnoId;
-      fileKey: string;
+      key: string;
+      provider: string;
       uploaderId: string | null;
       filename: string;
       expectedSizeBytes: bigint;
@@ -957,8 +1201,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
       tags: unknown;
       metadata: unknown;
       strategy: string;
-      storageProvider: string;
-      storageKey: string;
+      objectKey: string;
       storageUploadId: string | null;
       uploadUrl: string | null;
       uploadHeaders: unknown;
@@ -970,7 +1213,8 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
       errorMessage: string | null;
     };
     file: {
-      fileKey: string;
+      key: string;
+      provider: string;
       uploaderId: string | null;
       filename: string;
       sizeBytes: bigint;
@@ -980,8 +1224,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
       tags: {} | null;
       metadata: {} | null;
       status: FileStatus;
-      storageProvider: string;
-      storageKey: string;
+      objectKey: string;
       createdAt: Date;
       updatedAt: Date;
       completedAt: Date;
@@ -992,34 +1235,8 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     };
   }, [{
     id: _fragno_dev_db_schema0.FragnoId;
-    fileKey: string;
-    uploaderId: string | null;
-    filename: string;
-    expectedSizeBytes: bigint;
-    contentType: string;
-    checksum: unknown;
-    visibility: string;
-    tags: unknown;
-    metadata: unknown;
-    status: string;
-    strategy: string;
-    storageProvider: string;
-    storageKey: string;
-    storageUploadId: string | null;
-    uploadUrl: string | null;
-    uploadHeaders: unknown;
-    bytesUploaded: bigint;
-    partsUploaded: number;
-    partSizeBytes: number | null;
-    expiresAt: Date;
-    createdAt: Date;
-    updatedAt: Date;
-    completedAt: Date | null;
-    errorCode: string | null;
-    errorMessage: string | null;
-  } | null, {
-    id: _fragno_dev_db_schema0.FragnoId;
-    fileKey: string;
+    key: string;
+    provider: string;
     uploaderId: string | null;
     filename: string;
     sizeBytes: bigint;
@@ -1029,8 +1246,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     tags: unknown;
     metadata: unknown;
     status: string;
-    storageProvider: string;
-    storageKey: string;
+    objectKey: string;
     createdAt: Date;
     updatedAt: Date;
     completedAt: Date | null;
@@ -1043,6 +1259,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
       onFileReady: (payload: FileHookPayload) => void | Promise<void>;
       onUploadFailed: (payload: FileHookPayload) => void | Promise<void>;
       onFileDeleted: (payload: FileHookPayload) => void | Promise<void>;
+      cleanupStorageObject: (payload: FileHookPayload) => void | Promise<void>;
       onUploadTimeout: (payload: UploadTimeoutPayload) => void | Promise<void>;
     }>;
   }, uploadId: string, errorCode: string, errorMessage?: string | null) => _fragno_dev_db0.TxResult<{
@@ -1052,7 +1269,8 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
       errorCode: string;
       errorMessage: string | null;
       id: _fragno_dev_db_schema0.FragnoId;
-      fileKey: string;
+      key: string;
+      provider: string;
       uploaderId: string | null;
       filename: string;
       expectedSizeBytes: bigint;
@@ -1062,8 +1280,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
       tags: unknown;
       metadata: unknown;
       strategy: string;
-      storageProvider: string;
-      storageKey: string;
+      objectKey: string;
       storageUploadId: string | null;
       uploadUrl: string | null;
       uploadHeaders: unknown;
@@ -1076,7 +1293,8 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     };
   }, [{
     id: _fragno_dev_db_schema0.FragnoId;
-    fileKey: string;
+    key: string;
+    provider: string;
     uploaderId: string | null;
     filename: string;
     expectedSizeBytes: bigint;
@@ -1087,8 +1305,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     metadata: unknown;
     status: string;
     strategy: string;
-    storageProvider: string;
-    storageKey: string;
+    objectKey: string;
     storageUploadId: string | null;
     uploadUrl: string | null;
     uploadHeaders: unknown;
@@ -1102,11 +1319,106 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     errorCode: string | null;
     errorMessage: string | null;
   } | null]>;
+  markUploadFailedFromSnapshot: (this: _fragno_dev_core0.RequestThisContext & {
+    serviceTx<TSchema extends _fragno_dev_db_schema0.AnySchema>(schema: TSchema): _fragno_dev_db0.ServiceTxBuilder<TSchema, readonly [], [], [], unknown, unknown, false, false, false, false, {
+      onFileReady: (payload: FileHookPayload) => void | Promise<void>;
+      onUploadFailed: (payload: FileHookPayload) => void | Promise<void>;
+      onFileDeleted: (payload: FileHookPayload) => void | Promise<void>;
+      cleanupStorageObject: (payload: FileHookPayload) => void | Promise<void>;
+      onUploadTimeout: (payload: UploadTimeoutPayload) => void | Promise<void>;
+    }>;
+  }, upload: {
+    id: _fragno_dev_db_schema0.FragnoId;
+    key: string;
+    provider: string;
+    uploaderId: string | null;
+    filename: string;
+    expectedSizeBytes: bigint;
+    contentType: string;
+    checksum: unknown;
+    visibility: string;
+    tags: unknown;
+    metadata: unknown;
+    status: string;
+    strategy: string;
+    objectKey: string;
+    storageUploadId: string | null;
+    uploadUrl: string | null;
+    uploadHeaders: unknown;
+    bytesUploaded: bigint;
+    partsUploaded: number;
+    partSizeBytes: number | null;
+    expiresAt: Date;
+    createdAt: Date;
+    updatedAt: Date;
+    completedAt: Date | null;
+    errorCode: string | null;
+    errorMessage: string | null;
+  }, errorCode: string, errorMessage?: string | null) => _fragno_dev_db0.TxResult<{
+    upload: {
+      status: UploadStatus;
+      updatedAt: Date;
+      errorCode: string;
+      errorMessage: string | null;
+      id: _fragno_dev_db_schema0.FragnoId;
+      key: string;
+      provider: string;
+      uploaderId: string | null;
+      filename: string;
+      expectedSizeBytes: bigint;
+      contentType: string;
+      checksum: unknown;
+      visibility: string;
+      tags: unknown;
+      metadata: unknown;
+      strategy: string;
+      objectKey: string;
+      storageUploadId: string | null;
+      uploadUrl: string | null;
+      uploadHeaders: unknown;
+      bytesUploaded: bigint;
+      partsUploaded: number;
+      partSizeBytes: number | null;
+      expiresAt: Date;
+      createdAt: Date;
+      completedAt: Date | null;
+    };
+  }, {
+    upload: {
+      status: UploadStatus;
+      updatedAt: Date;
+      errorCode: string;
+      errorMessage: string | null;
+      id: _fragno_dev_db_schema0.FragnoId;
+      key: string;
+      provider: string;
+      uploaderId: string | null;
+      filename: string;
+      expectedSizeBytes: bigint;
+      contentType: string;
+      checksum: unknown;
+      visibility: string;
+      tags: unknown;
+      metadata: unknown;
+      strategy: string;
+      objectKey: string;
+      storageUploadId: string | null;
+      uploadUrl: string | null;
+      uploadHeaders: unknown;
+      bytesUploaded: bigint;
+      partsUploaded: number;
+      partSizeBytes: number | null;
+      expiresAt: Date;
+      createdAt: Date;
+      completedAt: Date | null;
+    };
+  }>;
   markUploadAborted: (this: _fragno_dev_core0.RequestThisContext & {
     serviceTx<TSchema extends _fragno_dev_db_schema0.AnySchema>(schema: TSchema): _fragno_dev_db0.ServiceTxBuilder<TSchema, readonly [], [], [], unknown, unknown, false, false, false, false, {
       onFileReady: (payload: FileHookPayload) => void | Promise<void>;
       onUploadFailed: (payload: FileHookPayload) => void | Promise<void>;
       onFileDeleted: (payload: FileHookPayload) => void | Promise<void>;
+      cleanupStorageObject: (payload: FileHookPayload) => void | Promise<void>;
       onUploadTimeout: (payload: UploadTimeoutPayload) => void | Promise<void>;
     }>;
   }, uploadId: string) => _fragno_dev_db0.TxResult<{
@@ -1115,7 +1427,8 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
       updatedAt: Date;
       errorCode: string;
       id: _fragno_dev_db_schema0.FragnoId;
-      fileKey: string;
+      key: string;
+      provider: string;
       uploaderId: string | null;
       filename: string;
       expectedSizeBytes: bigint;
@@ -1125,8 +1438,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
       tags: unknown;
       metadata: unknown;
       strategy: string;
-      storageProvider: string;
-      storageKey: string;
+      objectKey: string;
       storageUploadId: string | null;
       uploadUrl: string | null;
       uploadHeaders: unknown;
@@ -1140,7 +1452,8 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     };
   }, [{
     id: _fragno_dev_db_schema0.FragnoId;
-    fileKey: string;
+    key: string;
+    provider: string;
     uploaderId: string | null;
     filename: string;
     expectedSizeBytes: bigint;
@@ -1151,8 +1464,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     metadata: unknown;
     status: string;
     strategy: string;
-    storageProvider: string;
-    storageKey: string;
+    objectKey: string;
     storageUploadId: string | null;
     uploadUrl: string | null;
     uploadHeaders: unknown;
@@ -1166,16 +1478,112 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     errorCode: string | null;
     errorMessage: string | null;
   } | null]>;
+  markUploadAbortedFromSnapshot: (this: _fragno_dev_core0.RequestThisContext & {
+    serviceTx<TSchema extends _fragno_dev_db_schema0.AnySchema>(schema: TSchema): _fragno_dev_db0.ServiceTxBuilder<TSchema, readonly [], [], [], unknown, unknown, false, false, false, false, {
+      onFileReady: (payload: FileHookPayload) => void | Promise<void>;
+      onUploadFailed: (payload: FileHookPayload) => void | Promise<void>;
+      onFileDeleted: (payload: FileHookPayload) => void | Promise<void>;
+      cleanupStorageObject: (payload: FileHookPayload) => void | Promise<void>;
+      onUploadTimeout: (payload: UploadTimeoutPayload) => void | Promise<void>;
+    }>;
+  }, upload: {
+    id: _fragno_dev_db_schema0.FragnoId;
+    key: string;
+    provider: string;
+    uploaderId: string | null;
+    filename: string;
+    expectedSizeBytes: bigint;
+    contentType: string;
+    checksum: unknown;
+    visibility: string;
+    tags: unknown;
+    metadata: unknown;
+    status: string;
+    strategy: string;
+    objectKey: string;
+    storageUploadId: string | null;
+    uploadUrl: string | null;
+    uploadHeaders: unknown;
+    bytesUploaded: bigint;
+    partsUploaded: number;
+    partSizeBytes: number | null;
+    expiresAt: Date;
+    createdAt: Date;
+    updatedAt: Date;
+    completedAt: Date | null;
+    errorCode: string | null;
+    errorMessage: string | null;
+  }) => _fragno_dev_db0.TxResult<{
+    upload: {
+      status: UploadStatus;
+      updatedAt: Date;
+      errorCode: string;
+      id: _fragno_dev_db_schema0.FragnoId;
+      key: string;
+      provider: string;
+      uploaderId: string | null;
+      filename: string;
+      expectedSizeBytes: bigint;
+      contentType: string;
+      checksum: unknown;
+      visibility: string;
+      tags: unknown;
+      metadata: unknown;
+      strategy: string;
+      objectKey: string;
+      storageUploadId: string | null;
+      uploadUrl: string | null;
+      uploadHeaders: unknown;
+      bytesUploaded: bigint;
+      partsUploaded: number;
+      partSizeBytes: number | null;
+      expiresAt: Date;
+      createdAt: Date;
+      completedAt: Date | null;
+      errorMessage: string | null;
+    };
+  }, {
+    upload: {
+      status: UploadStatus;
+      updatedAt: Date;
+      errorCode: string;
+      id: _fragno_dev_db_schema0.FragnoId;
+      key: string;
+      provider: string;
+      uploaderId: string | null;
+      filename: string;
+      expectedSizeBytes: bigint;
+      contentType: string;
+      checksum: unknown;
+      visibility: string;
+      tags: unknown;
+      metadata: unknown;
+      strategy: string;
+      objectKey: string;
+      storageUploadId: string | null;
+      uploadUrl: string | null;
+      uploadHeaders: unknown;
+      bytesUploaded: bigint;
+      partsUploaded: number;
+      partSizeBytes: number | null;
+      expiresAt: Date;
+      createdAt: Date;
+      completedAt: Date | null;
+      errorMessage: string | null;
+    };
+  }>;
   getUploadStorageInfo: (this: _fragno_dev_core0.RequestThisContext & {
     serviceTx<TSchema extends _fragno_dev_db_schema0.AnySchema>(schema: TSchema): _fragno_dev_db0.ServiceTxBuilder<TSchema, readonly [], [], [], unknown, unknown, false, false, false, false, {
       onFileReady: (payload: FileHookPayload) => void | Promise<void>;
       onUploadFailed: (payload: FileHookPayload) => void | Promise<void>;
       onFileDeleted: (payload: FileHookPayload) => void | Promise<void>;
+      cleanupStorageObject: (payload: FileHookPayload) => void | Promise<void>;
       onUploadTimeout: (payload: UploadTimeoutPayload) => void | Promise<void>;
     }>;
   }, uploadId: string) => _fragno_dev_db0.TxResult<{
     id: _fragno_dev_db_schema0.FragnoId;
-    fileKey: string;
+    key: string;
+    provider: string;
     uploaderId: string | null;
     filename: string;
     expectedSizeBytes: bigint;
@@ -1186,8 +1594,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     metadata: unknown;
     status: string;
     strategy: string;
-    storageProvider: string;
-    storageKey: string;
+    objectKey: string;
     storageUploadId: string | null;
     uploadUrl: string | null;
     uploadHeaders: unknown;
@@ -1202,7 +1609,8 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     errorMessage: string | null;
   }, {
     id: _fragno_dev_db_schema0.FragnoId;
-    fileKey: string;
+    key: string;
+    provider: string;
     uploaderId: string | null;
     filename: string;
     expectedSizeBytes: bigint;
@@ -1213,8 +1621,7 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
     metadata: unknown;
     status: string;
     strategy: string;
-    storageProvider: string;
-    storageKey: string;
+    objectKey: string;
     storageUploadId: string | null;
     uploadUrl: string | null;
     uploadHeaders: unknown;
@@ -1231,16 +1638,16 @@ declare function createUploadFragment(config: UploadFragmentConfig, options: Fra
 }>, _fragno_dev_db0.DatabaseServiceContext<{
   onFileReady: _fragno_dev_db0.HookFn<any>;
   onUploadFailed: _fragno_dev_db0.HookFn<any>;
+  cleanupStorageObject: _fragno_dev_db0.HookFn<any>;
   onFileDeleted: _fragno_dev_db0.HookFn<any>;
   onUploadTimeout: _fragno_dev_db0.HookFn<any>;
 }>, _fragno_dev_db0.DatabaseRequestContext<{
   onFileReady: _fragno_dev_db0.HookFn<any>;
   onUploadFailed: _fragno_dev_db0.HookFn<any>;
+  cleanupStorageObject: _fragno_dev_db0.HookFn<any>;
   onFileDeleted: _fragno_dev_db0.HookFn<any>;
   onUploadTimeout: _fragno_dev_db0.HookFn<any>;
-}>, _fragno_dev_db_fragment_definition_builder0.DatabaseRequestStorage, FragnoPublicConfigWithDatabase, {
-  _fragno_internal: _fragno_dev_db0.InternalFragmentInstance;
-}>;
+}>, _fragno_dev_db_fragment_definition_builder0.DatabaseRequestStorage, FragnoPublicConfigWithDatabase>;
 //#endregion
-export { type CreateUploadAndTransferOptions, type FileHookPayload, type FileKeyEncoded, type FileKeyPart, type FileKeyParts, type FilesystemStorageAdapterOptions, type R2StorageAdapterOptions, type S3CompatibleStorageAdapterOptions, type S3Signer, type S3SignerInput, type StorageAdapter, type StorageAdapterCapabilities, type StorageAdapterLimits, type StorageAdapterRecommendations, type UploadChecksum, type UploadFragmentConfig, type UploadFragmentResolvedConfig, type UploadHelpers, type UploadMode, type UploadProgress, type UploadTimeoutPayload, type UploadTransport, createFilesystemStorageAdapter, createR2StorageAdapter, createS3CompatibleStorageAdapter, createUploadFragment, createUploadFragmentClients, decodeFileKey, encodeFileKey, encodeFileKeyPrefix, resolveUploadFragmentConfig, uploadFragmentDefinition, uploadRoutes, uploadSchema };
+export { type CreateUploadAndTransferOptions, type DownloadFileOptions, type DownloadMethod, type FileHookPayload, type FileKey, type FileKeyValidationResult, type FilesystemStorageAdapterOptions, type R2BindingBucket, type R2BindingStorageAdapterOptions, type R2StorageAdapterOptions, type S3CompatibleStorageAdapterOptions, type S3Signer, type S3SignerInput, type StorageAdapter, type StorageAdapterCapabilities, type StorageAdapterLimits, type StorageAdapterRecommendations, type UploadChecksum, type UploadFragmentConfig, type UploadFragmentResolvedConfig, type UploadHelpers, type UploadMode, type UploadProgress, type UploadTimeoutPayload, type UploadTransport, type ValidateFileKeyOptions, assertFileKey, createFilesystemStorageAdapter, createR2BindingStorageAdapter, createR2StorageAdapter, createS3CompatibleStorageAdapter, createUploadFragment, createUploadFragmentClients, resolveR2BindingBucket, resolveUploadFragmentConfig, splitFileKey, uploadFragmentDefinition, uploadRoutes, uploadSchema, validateFileKey };
 //# sourceMappingURL=index.d.ts.map