@fragno-dev/upload 0.1.1

package/dist/node/client/clients.d.ts

@@ -0,0 +1,295 @@
+import { UploadHelpers } from "./helpers.js";
+import * as zod2160 from "zod";
+import * as _fragno_dev_core_client0 from "@fragno-dev/core/client";
+import { FragnoPublicClientConfig } from "@fragno-dev/core/client";
+import * as zod_v4_core182 from "zod/v4/core";
+import * as _fragno_dev_core_api25 from "@fragno-dev/core/api";
+import * as _standard_schema_spec36 from "@standard-schema/spec";
+
+//#region src/client/clients.d.ts
+declare function createUploadFragmentClients(config?: FragnoPublicClientConfig): {
+  useFiles: _fragno_dev_core_client0.FragnoClientHookData<"GET", "/files", zod2160.ZodObject<{
+    files: zod2160.ZodArray<zod2160.ZodObject<{
+      fileKey: zod2160.ZodString;
+      fileKeyParts: zod2160.ZodArray<zod2160.ZodUnion<readonly [zod2160.ZodString, zod2160.ZodNumber]>>;
+      uploaderId: zod2160.ZodNullable<zod2160.ZodString>;
+      filename: zod2160.ZodString;
+      sizeBytes: zod2160.ZodNumber;
+      contentType: zod2160.ZodString;
+      checksum: zod2160.ZodNullable<zod2160.ZodObject<{
+        algo: zod2160.ZodEnum<{
+          sha256: "sha256";
+          md5: "md5";
+        }>;
+        value: zod2160.ZodString;
+      }, zod_v4_core182.$strip>>;
+      visibility: zod2160.ZodEnum<{
+        private: "private";
+        public: "public";
+        unlisted: "unlisted";
+      }>;
+      tags: zod2160.ZodNullable<zod2160.ZodArray<zod2160.ZodString>>;
+      metadata: zod2160.ZodNullable<zod2160.ZodRecord<zod2160.ZodString, zod2160.ZodUnknown>>;
+      status: zod2160.ZodEnum<{
+        ready: "ready";
+        deleted: "deleted";
+      }>;
+      storageProvider: zod2160.ZodString;
+      createdAt: zod2160.ZodString;
+      updatedAt: zod2160.ZodString;
+      completedAt: zod2160.ZodNullable<zod2160.ZodString>;
+      deletedAt: zod2160.ZodNullable<zod2160.ZodString>;
+      errorCode: zod2160.ZodNullable<zod2160.ZodString>;
+      errorMessage: zod2160.ZodNullable<zod2160.ZodString>;
+    }, zod_v4_core182.$strip>>;
+    cursor: zod2160.ZodOptional<zod2160.ZodString>;
+    hasNextPage: zod2160.ZodBoolean;
+  }, zod_v4_core182.$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">;
+  useFile: _fragno_dev_core_client0.FragnoClientHookData<"GET", "/files/:fileKey", zod2160.ZodObject<{
+    fileKey: zod2160.ZodString;
+    fileKeyParts: zod2160.ZodArray<zod2160.ZodUnion<readonly [zod2160.ZodString, zod2160.ZodNumber]>>;
+    uploaderId: zod2160.ZodNullable<zod2160.ZodString>;
+    filename: zod2160.ZodString;
+    sizeBytes: zod2160.ZodNumber;
+    contentType: zod2160.ZodString;
+    checksum: zod2160.ZodNullable<zod2160.ZodObject<{
+      algo: zod2160.ZodEnum<{
+        sha256: "sha256";
+        md5: "md5";
+      }>;
+      value: zod2160.ZodString;
+    }, zod_v4_core182.$strip>>;
+    visibility: zod2160.ZodEnum<{
+      private: "private";
+      public: "public";
+      unlisted: "unlisted";
+    }>;
+    tags: zod2160.ZodNullable<zod2160.ZodArray<zod2160.ZodString>>;
+    metadata: zod2160.ZodNullable<zod2160.ZodRecord<zod2160.ZodString, zod2160.ZodUnknown>>;
+    status: zod2160.ZodEnum<{
+      ready: "ready";
+      deleted: "deleted";
+    }>;
+    storageProvider: zod2160.ZodString;
+    createdAt: zod2160.ZodString;
+    updatedAt: zod2160.ZodString;
+    completedAt: zod2160.ZodNullable<zod2160.ZodString>;
+    deletedAt: zod2160.ZodNullable<zod2160.ZodString>;
+    errorCode: zod2160.ZodNullable<zod2160.ZodString>;
+    errorMessage: zod2160.ZodNullable<zod2160.ZodString>;
+  }, zod_v4_core182.$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>;
+  useCreateUpload: _fragno_dev_core_client0.FragnoClientMutatorData<_fragno_dev_core_api25.NonGetHTTPMethod, "/uploads", zod2160.ZodObject<{
+    keyParts: zod2160.ZodOptional<zod2160.ZodArray<zod2160.ZodUnion<readonly [zod2160.ZodString, zod2160.ZodNumber]>>>;
+    fileKey: zod2160.ZodOptional<zod2160.ZodString>;
+    filename: zod2160.ZodString;
+    sizeBytes: zod2160.ZodNumber;
+    contentType: zod2160.ZodString;
+    checksum: zod2160.ZodOptional<zod2160.ZodOptional<zod2160.ZodNullable<zod2160.ZodObject<{
+      algo: zod2160.ZodEnum<{
+        sha256: "sha256";
+        md5: "md5";
+      }>;
+      value: zod2160.ZodString;
+    }, zod_v4_core182.$strip>>>>;
+    tags: zod2160.ZodOptional<zod2160.ZodArray<zod2160.ZodString>>;
+    visibility: zod2160.ZodOptional<zod2160.ZodEnum<{
+      private: "private";
+      public: "public";
+      unlisted: "unlisted";
+    }>>;
+    uploaderId: zod2160.ZodOptional<zod2160.ZodString>;
+    metadata: zod2160.ZodOptional<zod2160.ZodRecord<zod2160.ZodString, zod2160.ZodUnknown>>;
+  }, zod_v4_core182.$strip> | undefined, zod2160.ZodObject<{
+    uploadId: zod2160.ZodString;
+    fileKey: zod2160.ZodString;
+    status: zod2160.ZodEnum<{
+      created: "created";
+      in_progress: "in_progress";
+    }>;
+    strategy: zod2160.ZodEnum<{
+      "direct-single": "direct-single";
+      "direct-multipart": "direct-multipart";
+      proxy: "proxy";
+    }>;
+    expiresAt: zod2160.ZodDate;
+    upload: zod2160.ZodObject<{
+      mode: zod2160.ZodEnum<{
+        single: "single";
+        multipart: "multipart";
+      }>;
+      transport: zod2160.ZodEnum<{
+        proxy: "proxy";
+        direct: "direct";
+      }>;
+      uploadUrl: zod2160.ZodOptional<zod2160.ZodString>;
+      uploadHeaders: zod2160.ZodOptional<zod2160.ZodRecord<zod2160.ZodString, zod2160.ZodString>>;
+      partSizeBytes: zod2160.ZodOptional<zod2160.ZodNumber>;
+      maxParts: zod2160.ZodOptional<zod2160.ZodNumber>;
+      partsEndpoint: zod2160.ZodOptional<zod2160.ZodString>;
+      completeEndpoint: zod2160.ZodString;
+      contentEndpoint: zod2160.ZodOptional<zod2160.ZodString>;
+    }, zod_v4_core182.$strip>;
+  }, zod_v4_core182.$strip> | undefined, "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>;
+  useUploadStatus: _fragno_dev_core_client0.FragnoClientHookData<"GET", "/uploads/:uploadId", zod2160.ZodObject<{
+    uploadId: zod2160.ZodString;
+    fileKey: zod2160.ZodString;
+    status: zod2160.ZodEnum<{
+      created: "created";
+      in_progress: "in_progress";
+      completed: "completed";
+      aborted: "aborted";
+      failed: "failed";
+      expired: "expired";
+    }>;
+    strategy: zod2160.ZodEnum<{
+      "direct-single": "direct-single";
+      "direct-multipart": "direct-multipart";
+      proxy: "proxy";
+    }>;
+    expectedSizeBytes: zod2160.ZodNumber;
+    bytesUploaded: zod2160.ZodNumber;
+    partsUploaded: zod2160.ZodNumber;
+    partSizeBytes: zod2160.ZodNullable<zod2160.ZodNumber>;
+    expiresAt: zod2160.ZodDate;
+    createdAt: zod2160.ZodDate;
+    updatedAt: zod2160.ZodDate;
+    completedAt: zod2160.ZodNullable<zod2160.ZodDate>;
+    errorCode: zod2160.ZodNullable<zod2160.ZodString>;
+    errorMessage: zod2160.ZodNullable<zod2160.ZodString>;
+  }, zod_v4_core182.$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>;
+  useCompleteUpload: _fragno_dev_core_client0.FragnoClientMutatorData<_fragno_dev_core_api25.NonGetHTTPMethod, "/uploads/:uploadId/complete", zod2160.ZodObject<{
+    parts: zod2160.ZodOptional<zod2160.ZodArray<zod2160.ZodObject<{
+      partNumber: zod2160.ZodNumber;
+      etag: zod2160.ZodString;
+    }, zod_v4_core182.$strip>>>;
+  }, zod_v4_core182.$strip> | undefined, zod2160.ZodObject<{
+    fileKey: zod2160.ZodString;
+    fileKeyParts: zod2160.ZodArray<zod2160.ZodUnion<readonly [zod2160.ZodString, zod2160.ZodNumber]>>;
+    uploaderId: zod2160.ZodNullable<zod2160.ZodString>;
+    filename: zod2160.ZodString;
+    sizeBytes: zod2160.ZodNumber;
+    contentType: zod2160.ZodString;
+    checksum: zod2160.ZodNullable<zod2160.ZodObject<{
+      algo: zod2160.ZodEnum<{
+        sha256: "sha256";
+        md5: "md5";
+      }>;
+      value: zod2160.ZodString;
+    }, zod_v4_core182.$strip>>;
+    visibility: zod2160.ZodEnum<{
+      private: "private";
+      public: "public";
+      unlisted: "unlisted";
+    }>;
+    tags: zod2160.ZodNullable<zod2160.ZodArray<zod2160.ZodString>>;
+    metadata: zod2160.ZodNullable<zod2160.ZodRecord<zod2160.ZodString, zod2160.ZodUnknown>>;
+    status: zod2160.ZodEnum<{
+      ready: "ready";
+      deleted: "deleted";
+    }>;
+    storageProvider: zod2160.ZodString;
+    createdAt: zod2160.ZodString;
+    updatedAt: zod2160.ZodString;
+    completedAt: zod2160.ZodNullable<zod2160.ZodString>;
+    deletedAt: zod2160.ZodNullable<zod2160.ZodString>;
+    errorCode: zod2160.ZodNullable<zod2160.ZodString>;
+    errorMessage: zod2160.ZodNullable<zod2160.ZodString>;
+  }, zod_v4_core182.$strip> | undefined, "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>;
+  useAbortUpload: _fragno_dev_core_client0.FragnoClientMutatorData<_fragno_dev_core_api25.NonGetHTTPMethod, "/uploads/:uploadId/abort", _standard_schema_spec36.StandardSchemaV1<unknown, unknown> | undefined, zod2160.ZodObject<{
+    ok: zod2160.ZodLiteral<true>;
+  }, zod_v4_core182.$strip> | undefined, "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>;
+  useUpdateFile: _fragno_dev_core_client0.FragnoClientMutatorData<_fragno_dev_core_api25.NonGetHTTPMethod, "/files/:fileKey", _standard_schema_spec36.StandardSchemaV1<unknown, unknown> | zod2160.ZodObject<{
+    filename: zod2160.ZodOptional<zod2160.ZodString>;
+    visibility: zod2160.ZodOptional<zod2160.ZodEnum<{
+      private: "private";
+      public: "public";
+      unlisted: "unlisted";
+    }>>;
+    tags: zod2160.ZodOptional<zod2160.ZodNullable<zod2160.ZodArray<zod2160.ZodString>>>;
+    metadata: zod2160.ZodOptional<zod2160.ZodNullable<zod2160.ZodRecord<zod2160.ZodString, zod2160.ZodUnknown>>>;
+  }, zod_v4_core182.$strip> | undefined, zod2160.ZodObject<{
+    fileKey: zod2160.ZodString;
+    fileKeyParts: zod2160.ZodArray<zod2160.ZodUnion<readonly [zod2160.ZodString, zod2160.ZodNumber]>>;
+    uploaderId: zod2160.ZodNullable<zod2160.ZodString>;
+    filename: zod2160.ZodString;
+    sizeBytes: zod2160.ZodNumber;
+    contentType: zod2160.ZodString;
+    checksum: zod2160.ZodNullable<zod2160.ZodObject<{
+      algo: zod2160.ZodEnum<{
+        sha256: "sha256";
+        md5: "md5";
+      }>;
+      value: zod2160.ZodString;
+    }, zod_v4_core182.$strip>>;
+    visibility: zod2160.ZodEnum<{
+      private: "private";
+      public: "public";
+      unlisted: "unlisted";
+    }>;
+    tags: zod2160.ZodNullable<zod2160.ZodArray<zod2160.ZodString>>;
+    metadata: zod2160.ZodNullable<zod2160.ZodRecord<zod2160.ZodString, zod2160.ZodUnknown>>;
+    status: zod2160.ZodEnum<{
+      ready: "ready";
+      deleted: "deleted";
+    }>;
+    storageProvider: zod2160.ZodString;
+    createdAt: zod2160.ZodString;
+    updatedAt: zod2160.ZodString;
+    completedAt: zod2160.ZodNullable<zod2160.ZodString>;
+    deletedAt: zod2160.ZodNullable<zod2160.ZodString>;
+    errorCode: zod2160.ZodNullable<zod2160.ZodString>;
+    errorMessage: zod2160.ZodNullable<zod2160.ZodString>;
+  }, zod_v4_core182.$strip> | zod2160.ZodObject<{
+    ok: zod2160.ZodLiteral<true>;
+  }, zod_v4_core182.$strip> | 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>;
+  useDeleteFile: _fragno_dev_core_client0.FragnoClientMutatorData<_fragno_dev_core_api25.NonGetHTTPMethod, "/files/:fileKey", _standard_schema_spec36.StandardSchemaV1<unknown, unknown> | zod2160.ZodObject<{
+    filename: zod2160.ZodOptional<zod2160.ZodString>;
+    visibility: zod2160.ZodOptional<zod2160.ZodEnum<{
+      private: "private";
+      public: "public";
+      unlisted: "unlisted";
+    }>>;
+    tags: zod2160.ZodOptional<zod2160.ZodNullable<zod2160.ZodArray<zod2160.ZodString>>>;
+    metadata: zod2160.ZodOptional<zod2160.ZodNullable<zod2160.ZodRecord<zod2160.ZodString, zod2160.ZodUnknown>>>;
+  }, zod_v4_core182.$strip> | undefined, zod2160.ZodObject<{
+    fileKey: zod2160.ZodString;
+    fileKeyParts: zod2160.ZodArray<zod2160.ZodUnion<readonly [zod2160.ZodString, zod2160.ZodNumber]>>;
+    uploaderId: zod2160.ZodNullable<zod2160.ZodString>;
+    filename: zod2160.ZodString;
+    sizeBytes: zod2160.ZodNumber;
+    contentType: zod2160.ZodString;
+    checksum: zod2160.ZodNullable<zod2160.ZodObject<{
+      algo: zod2160.ZodEnum<{
+        sha256: "sha256";
+        md5: "md5";
+      }>;
+      value: zod2160.ZodString;
+    }, zod_v4_core182.$strip>>;
+    visibility: zod2160.ZodEnum<{
+      private: "private";
+      public: "public";
+      unlisted: "unlisted";
+    }>;
+    tags: zod2160.ZodNullable<zod2160.ZodArray<zod2160.ZodString>>;
+    metadata: zod2160.ZodNullable<zod2160.ZodRecord<zod2160.ZodString, zod2160.ZodUnknown>>;
+    status: zod2160.ZodEnum<{
+      ready: "ready";
+      deleted: "deleted";
+    }>;
+    storageProvider: zod2160.ZodString;
+    createdAt: zod2160.ZodString;
+    updatedAt: zod2160.ZodString;
+    completedAt: zod2160.ZodNullable<zod2160.ZodString>;
+    deletedAt: zod2160.ZodNullable<zod2160.ZodString>;
+    errorCode: zod2160.ZodNullable<zod2160.ZodString>;
+    errorMessage: zod2160.ZodNullable<zod2160.ZodString>;
+  }, zod_v4_core182.$strip> | zod2160.ZodObject<{
+    ok: zod2160.ZodLiteral<true>;
+  }, zod_v4_core182.$strip> | 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>;
+  useUploadHelpers: _fragno_dev_core_client0.FragnoStoreData<UploadHelpers>;
+};
+//# sourceMappingURL=clients.d.ts.map
+
+//#endregion
+export { createUploadFragmentClients };
+//# sourceMappingURL=clients.d.ts.map

package/dist/node/client/clients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.d.ts","names":[],"sources":["../../../src/client/clients.ts"],"sourcesContent":[],"mappings":";;;;;;;;;iBAMgB,2BAAA,UAAoC;;;eAA6B,OAAA,CAAA;;;;;MAAjE,WAAA,mBAA2B;MAAA,QAAA,qBAAA,kBAAA,CAAA;QAAS,IAAA,iBAAA,CAAA;UAA6B,MAAA,EAAA,QAAA"}

package/dist/node/client/clients.js

@@ -0,0 +1,49 @@
+import { uploadFragmentDefinition } from "../definition.js";
+import { uploadRoutes } from "../routes/index.js";
+import { createUploadHelpers } from "./helpers.js";
+import { createClientBuilder } from "@fragno-dev/core/client";
+
+//#region src/client/clients.ts
+function createUploadFragmentClients(config = {}) {
+	const builder = createClientBuilder(uploadFragmentDefinition, config, uploadRoutes);
+	const { fetcher, defaultOptions } = builder.getFetcher();
+	const helpers = createUploadHelpers({
+		buildUrl: (path) => builder.buildUrl(path),
+		fetcher,
+		defaultOptions
+	});
+	return {
+		useFiles: builder.createHook("/files"),
+		useFile: builder.createHook("/files/:fileKey"),
+		useCreateUpload: builder.createMutator("POST", "/uploads"),
+		useUploadStatus: builder.createHook("/uploads/:uploadId"),
+		useCompleteUpload: builder.createMutator("POST", "/uploads/:uploadId/complete", (invalidate, params) => {
+			const uploadId = params.pathParams.uploadId;
+			if (!uploadId) return;
+			invalidate("GET", "/uploads/:uploadId", { pathParams: { uploadId } });
+			invalidate("GET", "/files", {});
+		}),
+		useAbortUpload: builder.createMutator("POST", "/uploads/:uploadId/abort", (invalidate, params) => {
+			const uploadId = params.pathParams.uploadId;
+			if (!uploadId) return;
+			invalidate("GET", "/uploads/:uploadId", { pathParams: { uploadId } });
+		}),
+		useUpdateFile: builder.createMutator("PATCH", "/files/:fileKey", (invalidate, params) => {
+			const fileKey = params.pathParams.fileKey;
+			if (!fileKey) return;
+			invalidate("GET", "/files/:fileKey", { pathParams: { fileKey } });
+			invalidate("GET", "/files", {});
+		}),
+		useDeleteFile: builder.createMutator("DELETE", "/files/:fileKey", (invalidate, params) => {
+			const fileKey = params.pathParams.fileKey;
+			if (!fileKey) return;
+			invalidate("GET", "/files/:fileKey", { pathParams: { fileKey } });
+			invalidate("GET", "/files", {});
+		}),
+		useUploadHelpers: builder.createStore(helpers)
+	};
+}
+
+//#endregion
+export { createUploadFragmentClients };
+//# sourceMappingURL=clients.js.map

package/dist/node/client/clients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.js","names":[],"sources":["../../../src/client/clients.ts"],"sourcesContent":["import { createClientBuilder } from \"@fragno-dev/core/client\";\nimport type { FragnoPublicClientConfig } from \"@fragno-dev/core/client\";\nimport { uploadFragmentDefinition } from \"../definition\";\nimport { uploadRoutes } from \"../routes\";\nimport { createUploadHelpers } from \"./helpers\";\n\nexport function createUploadFragmentClients(config: FragnoPublicClientConfig = {}) {\n  const builder = createClientBuilder(uploadFragmentDefinition, config, uploadRoutes);\n  const { fetcher, defaultOptions } = builder.getFetcher();\n  const helpers = createUploadHelpers({\n    buildUrl: (path) => builder.buildUrl(path),\n    fetcher,\n    defaultOptions,\n  });\n\n  return {\n    useFiles: builder.createHook(\"/files\"),\n    useFile: builder.createHook(\"/files/:fileKey\"),\n    useCreateUpload: builder.createMutator(\"POST\", \"/uploads\"),\n    useUploadStatus: builder.createHook(\"/uploads/:uploadId\"),\n    useCompleteUpload: builder.createMutator(\n      \"POST\",\n      \"/uploads/:uploadId/complete\",\n      (invalidate, params) => {\n        const uploadId = params.pathParams.uploadId;\n        if (!uploadId) {\n          return;\n        }\n        invalidate(\"GET\", \"/uploads/:uploadId\", { pathParams: { uploadId } });\n        invalidate(\"GET\", \"/files\", {});\n      },\n    ),\n    useAbortUpload: builder.createMutator(\n      \"POST\",\n      \"/uploads/:uploadId/abort\",\n      (invalidate, params) => {\n        const uploadId = params.pathParams.uploadId;\n        if (!uploadId) {\n          return;\n        }\n        invalidate(\"GET\", \"/uploads/:uploadId\", { pathParams: { uploadId } });\n      },\n    ),\n    useUpdateFile: builder.createMutator(\"PATCH\", \"/files/:fileKey\", (invalidate, params) => {\n      const fileKey = params.pathParams.fileKey;\n      if (!fileKey) {\n        return;\n      }\n      invalidate(\"GET\", \"/files/:fileKey\", { pathParams: { fileKey } });\n      invalidate(\"GET\", \"/files\", {});\n    }),\n    useDeleteFile: builder.createMutator(\"DELETE\", \"/files/:fileKey\", (invalidate, params) => {\n      const fileKey = params.pathParams.fileKey;\n      if (!fileKey) {\n        return;\n      }\n      invalidate(\"GET\", \"/files/:fileKey\", { pathParams: { fileKey } });\n      invalidate(\"GET\", \"/files\", {});\n    }),\n    useUploadHelpers: builder.createStore(helpers),\n  };\n}\n"],"mappings":";;;;;;AAMA,SAAgB,4BAA4B,SAAmC,EAAE,EAAE;CACjF,MAAM,UAAU,oBAAoB,0BAA0B,QAAQ,aAAa;CACnF,MAAM,EAAE,SAAS,mBAAmB,QAAQ,YAAY;CACxD,MAAM,UAAU,oBAAoB;EAClC,WAAW,SAAS,QAAQ,SAAS,KAAK;EAC1C;EACA;EACD,CAAC;AAEF,QAAO;EACL,UAAU,QAAQ,WAAW,SAAS;EACtC,SAAS,QAAQ,WAAW,kBAAkB;EAC9C,iBAAiB,QAAQ,cAAc,QAAQ,WAAW;EAC1D,iBAAiB,QAAQ,WAAW,qBAAqB;EACzD,mBAAmB,QAAQ,cACzB,QACA,gCACC,YAAY,WAAW;GACtB,MAAM,WAAW,OAAO,WAAW;AACnC,OAAI,CAAC,SACH;AAEF,cAAW,OAAO,sBAAsB,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;AACrE,cAAW,OAAO,UAAU,EAAE,CAAC;IAElC;EACD,gBAAgB,QAAQ,cACtB,QACA,6BACC,YAAY,WAAW;GACtB,MAAM,WAAW,OAAO,WAAW;AACnC,OAAI,CAAC,SACH;AAEF,cAAW,OAAO,sBAAsB,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;IAExE;EACD,eAAe,QAAQ,cAAc,SAAS,oBAAoB,YAAY,WAAW;GACvF,MAAM,UAAU,OAAO,WAAW;AAClC,OAAI,CAAC,QACH;AAEF,cAAW,OAAO,mBAAmB,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;AACjE,cAAW,OAAO,UAAU,EAAE,CAAC;IAC/B;EACF,eAAe,QAAQ,cAAc,UAAU,oBAAoB,YAAY,WAAW;GACxF,MAAM,UAAU,OAAO,WAAW;AAClC,OAAI,CAAC,QACH;AAEF,cAAW,OAAO,mBAAmB,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;AACjE,cAAW,OAAO,UAAU,EAAE,CAAC;IAC/B;EACF,kBAAkB,QAAQ,YAAY,QAAQ;EAC/C"}

package/dist/node/client/helpers.d.ts

@@ -0,0 +1,51 @@
+import { FileKeyEncoded, FileKeyParts } from "../keys.js";
+import { UploadChecksum } from "../storage/types.js";
+import { FileMetadata, FileVisibility, UploadStrategy } from "../types.js";
+
+//#region src/client/helpers.d.ts
+type UploadProgress = {
+  bytesUploaded: number;
+  totalBytes: number;
+  partsUploaded: number;
+  totalParts?: number;
+};
+type CreateUploadAndTransferOptions = {
+  keyParts?: FileKeyParts;
+  fileKey?: FileKeyEncoded;
+  filename?: string;
+  contentType?: string;
+  checksum?: UploadChecksum | null;
+  tags?: string[];
+  visibility?: FileVisibility;
+  uploaderId?: string;
+  metadata?: Record<string, unknown>;
+  onProgress?: (progress: UploadProgress) => void;
+};
+type UploadCreateResponse = {
+  uploadId: string;
+  fileKey: string;
+  status: "created";
+  strategy: UploadStrategy;
+  expiresAt: string;
+  upload: {
+    mode: "single" | "multipart";
+    transport: "direct" | "proxy";
+    uploadUrl?: string;
+    uploadHeaders?: Record<string, string>;
+    partSizeBytes?: number;
+    maxParts?: number;
+    partsEndpoint?: string;
+    completeEndpoint: string;
+    contentEndpoint?: string;
+  };
+};
+type UploadHelpers = {
+  createUploadAndTransfer: (file: Blob, options: CreateUploadAndTransferOptions) => Promise<{
+    upload: UploadCreateResponse;
+    file: FileMetadata;
+  }>;
+  downloadFile: (fileKeyOrParts: FileKeyEncoded | FileKeyParts) => Promise<Response>;
+};
+//#endregion
+export { CreateUploadAndTransferOptions, UploadCreateResponse, UploadHelpers, UploadProgress };
+//# sourceMappingURL=helpers.d.ts.map

package/dist/node/client/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","names":[],"sources":["../../../src/client/helpers.ts"],"sourcesContent":[],"mappings":";;;;;KAIY,cAAA;;EAAA,UAAA,EAAA,MAAc;EAOd,aAAA,EAAA,MAAA;EAA8B,UAAA,CAAA,EAAA,MAAA;;AAE9B,KAFA,8BAAA,GAEA;UAGC,CAAA,EAJA,YAIA;SAEE,CAAA,EALH,cAKG;UAEF,CAAA,EAAA,MAAA;aACa,CAAA,EAAA,MAAA;EAAc,QAAA,CAAA,EAL3B,cAK2B,GAAA,IAAA;EAG5B,IAAA,CAAA,EAAA,MAAA,EAAA;EAAoB,UAAA,CAAA,EANjB,cAMiB;YAIpB,CAAA,EAAA,MAAA;UAMQ,CAAA,EAdP,MAcO,CAAA,MAAA,EAAA,OAAA,CAAA;EAAM,UAAA,CAAA,EAAA,CAAA,QAAA,EAbA,cAaA,EAAA,GAAA,IAAA;AAS1B,CAAA;AAAyB,KAnBb,oBAAA,GAmBa;UAEf,EAAA,MAAA;SACG,EAAA,MAAA;QACY,EAAA,SAAA;UAA4B,EAnBzC,cAmByC;WAA9C,EAAA,MAAA;QAC0B,EAAA;IAAiB,IAAA,EAAA,QAAA,GAAA,WAAA;IAAyB,SAAA,EAAA,QAAA,GAAA,OAAA;IAAR,SAAA,CAAA,EAAA,MAAA;IAAO,aAAA,CAAA,EAdtD,MAcsD,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;KAL9D,aAAA;kCAEF,eACG,mCACN;YAAkB;UAA4B;;iCACpB,iBAAiB,iBAAiB,QAAQ"}

package/dist/node/client/helpers.js

@@ -0,0 +1,242 @@
+import { encodeFileKey } from "../keys.js";
+
+//#region src/client/helpers.ts
+const DEFAULT_CONTENT_TYPE = "application/octet-stream";
+const mergeHeaders = (base, next) => {
+	const merged = new Headers(base ?? void 0);
+	if (!next) return merged;
+	if (next instanceof Headers) for (const [key, value] of next.entries()) merged.set(key, value);
+	else if (Array.isArray(next)) for (const [key, value] of next) merged.set(key, value);
+	else for (const [key, value] of Object.entries(next)) merged.set(key, value);
+	return merged;
+};
+const buildRequestInit = (defaults, init) => {
+	if (!defaults) return init;
+	return {
+		...defaults,
+		...init,
+		headers: mergeHeaders(defaults.headers, init.headers)
+	};
+};
+const readJsonSafely = async (response) => {
+	try {
+		return await response.json();
+	} catch {
+		return null;
+	}
+};
+const createUploadHelpers = (input) => {
+	const { buildUrl, fetcher, defaultOptions } = input;
+	const fetchJson = async (path, init, expectedErrorCode) => {
+		const response = await fetcher(buildUrl(path), buildRequestInit(defaultOptions, init));
+		if (!response.ok) {
+			const payload = await readJsonSafely(response);
+			const code = typeof payload === "object" && payload ? payload.code : void 0;
+			if (expectedErrorCode && code === expectedErrorCode) throw new Error(expectedErrorCode);
+			const message = typeof payload === "object" && payload && "message" in payload ? String(payload.message) : `Request failed (${response.status})`;
+			throw new Error(message);
+		}
+		return await response.json();
+	};
+	const reportProgress = async (uploadId, progress, onProgress) => {
+		onProgress?.(progress);
+		await fetchJson(`/uploads/${uploadId}/progress`, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify({
+				bytesUploaded: progress.bytesUploaded,
+				partsUploaded: progress.partsUploaded
+			})
+		});
+	};
+	const createUploadAndTransfer = async (file, options) => {
+		const filename = options.filename ?? (typeof File !== "undefined" && file instanceof File && file.name ? file.name : "upload");
+		const contentType = options.contentType ?? (file.type && file.type.length > 0 ? file.type : void 0) ?? DEFAULT_CONTENT_TYPE;
+		const sizeBytes = file.size;
+		if (!options.keyParts && !options.fileKey) throw new Error("File key parts or file key is required");
+		const upload = await fetchJson("/uploads", {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify({
+				keyParts: options.keyParts,
+				fileKey: options.fileKey,
+				filename,
+				sizeBytes,
+				contentType,
+				checksum: options.checksum ?? null,
+				tags: options.tags,
+				visibility: options.visibility,
+				uploaderId: options.uploaderId,
+				metadata: options.metadata
+			})
+		});
+		const totalBytes = sizeBytes;
+		let bytesUploaded = 0;
+		let partsUploaded = 0;
+		if (upload.strategy === "direct-single") {
+			if (!upload.upload.uploadUrl) throw new Error("Missing upload URL for direct upload");
+			const uploadResponse = await fetcher(upload.upload.uploadUrl, {
+				method: "PUT",
+				headers: upload.upload.uploadHeaders,
+				body: file
+			});
+			if (!uploadResponse.ok) throw new Error(`Direct upload failed (${uploadResponse.status})`);
+			bytesUploaded = totalBytes;
+			partsUploaded = 1;
+			await reportProgress(upload.uploadId, {
+				bytesUploaded,
+				totalBytes,
+				partsUploaded,
+				totalParts: 1
+			}, options.onProgress);
+			return {
+				upload,
+				file: await fetchJson(upload.upload.completeEndpoint, {
+					method: "POST",
+					headers: { "Content-Type": "application/json" },
+					body: JSON.stringify({})
+				})
+			};
+		}
+		if (upload.strategy === "direct-multipart") {
+			const partSizeBytes = upload.upload.partSizeBytes;
+			if (!partSizeBytes || !upload.upload.partsEndpoint) throw new Error("Missing multipart configuration for upload");
+			const totalParts = Math.ceil(totalBytes / partSizeBytes);
+			if (upload.upload.maxParts && totalParts > upload.upload.maxParts) throw new Error("Multipart upload exceeds maximum parts");
+			const partNumbers = Array.from({ length: totalParts }, (_, i) => i + 1);
+			const parts = (await fetchJson(upload.upload.partsEndpoint, {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify({ partNumbers })
+			})).parts.sort((a, b) => a.partNumber - b.partNumber);
+			const completedParts = [];
+			const completionParts = [];
+			for (const part of parts) {
+				const start = (part.partNumber - 1) * partSizeBytes;
+				const end = Math.min(start + partSizeBytes, totalBytes);
+				const partBlob = file.slice(start, end);
+				const response = await fetcher(part.url, {
+					method: "PUT",
+					headers: part.headers,
+					body: partBlob
+				});
+				if (!response.ok) throw new Error(`Multipart upload failed (${response.status})`);
+				const etag = response.headers.get("ETag") ?? response.headers.get("etag");
+				if (!etag) throw new Error("Missing ETag for uploaded part");
+				const partSize = partBlob.size;
+				completedParts.push({
+					partNumber: part.partNumber,
+					etag,
+					sizeBytes: partSize
+				});
+				completionParts.push({
+					partNumber: part.partNumber,
+					etag
+				});
+				bytesUploaded += partSize;
+				partsUploaded += 1;
+				await reportProgress(upload.uploadId, {
+					bytesUploaded,
+					totalBytes,
+					partsUploaded,
+					totalParts
+				}, options.onProgress);
+			}
+			await fetchJson(`/uploads/${upload.uploadId}/parts/complete`, {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify({ parts: completedParts })
+			});
+			return {
+				upload,
+				file: await fetchJson(upload.upload.completeEndpoint, {
+					method: "POST",
+					headers: { "Content-Type": "application/json" },
+					body: JSON.stringify({ parts: completionParts })
+				})
+			};
+		}
+		if (!upload.upload.contentEndpoint) throw new Error("Missing proxy content endpoint for upload");
+		const source = file.stream();
+		const stream = new ReadableStream({ start(controller) {
+			const reader = source.getReader();
+			const pump = () => {
+				reader.read().then(({ done, value }) => {
+					if (done) {
+						controller.close();
+						return;
+					}
+					if (value) {
+						bytesUploaded += value.byteLength;
+						options.onProgress?.({
+							bytesUploaded,
+							totalBytes,
+							partsUploaded: 0
+						});
+						controller.enqueue(value);
+					}
+					pump();
+				}, (error) => {
+					controller.error(error);
+				});
+			};
+			pump();
+		} });
+		const requestInit = buildRequestInit(defaultOptions, {
+			method: "PUT",
+			headers: { "Content-Type": DEFAULT_CONTENT_TYPE },
+			body: stream
+		});
+		requestInit.duplex = "half";
+		let proxyResponse;
+		try {
+			proxyResponse = await fetcher(buildUrl(upload.upload.contentEndpoint), requestInit);
+		} catch (_error) {
+			const fallbackResponse = await fetcher(buildUrl(upload.upload.contentEndpoint), buildRequestInit(defaultOptions, {
+				method: "PUT",
+				headers: { "Content-Type": DEFAULT_CONTENT_TYPE },
+				body: file
+			}));
+			if (!fallbackResponse.ok) throw new Error(`Proxy upload failed (${fallbackResponse.status})`);
+			options.onProgress?.({
+				bytesUploaded: totalBytes,
+				totalBytes,
+				partsUploaded: 0
+			});
+			return {
+				upload,
+				file: await fallbackResponse.json()
+			};
+		}
+		if (!proxyResponse.ok) throw new Error(`Proxy upload failed (${proxyResponse.status})`);
+		return {
+			upload,
+			file: await proxyResponse.json()
+		};
+	};
+	const downloadFile = async (fileKeyOrParts) => {
+		const fileKey = Array.isArray(fileKeyOrParts) ? encodeFileKey(fileKeyOrParts) : fileKeyOrParts;
+		const downloadUrlResponse = await fetcher(buildUrl(`/files/${fileKey}/download-url`), buildRequestInit(defaultOptions, { method: "GET" }));
+		if (downloadUrlResponse.ok) {
+			const payload = await downloadUrlResponse.json();
+			return fetcher(payload.url, {
+				method: "GET",
+				headers: payload.headers
+			});
+		}
+		const errorPayload = await readJsonSafely(downloadUrlResponse);
+		if ((typeof errorPayload === "object" && errorPayload ? errorPayload.code : void 0) !== "SIGNED_URL_UNSUPPORTED") {
+			const message = typeof errorPayload === "object" && errorPayload && "message" in errorPayload ? String(errorPayload.message) : `Download failed (${downloadUrlResponse.status})`;
+			throw new Error(message);
+		}
+		return fetcher(buildUrl(`/files/${fileKey}/content`), buildRequestInit(defaultOptions, { method: "GET" }));
+	};
+	return {
+		createUploadAndTransfer,
+		downloadFile
+	};
+};
+
+//#endregion
+export { createUploadHelpers };
+//# sourceMappingURL=helpers.js.map