@visulima/storage-client 1.0.0-alpha.12 → 1.0.0-alpha.14

package/dist/solid/index.d.ts

@@ -1,60 +1,690 @@
-export type { CreateAbortAllOptions, CreateAbortAllReturn } from "./create-abort-all.d.ts";
-export { createAbortAll } from "./create-abort-all.d.ts";
-export type { CreateAbortBatchOptions, CreateAbortBatchReturn } from "./create-abort-batch.d.ts";
-export { createAbortBatch } from "./create-abort-batch.d.ts";
-export type { CreateAbortItemOptions, CreateAbortItemReturn } from "./create-abort-item.d.ts";
-export { createAbortItem } from "./create-abort-item.d.ts";
-export type { CreateAllAbortListenerOptions } from "./create-all-abort-listener.d.ts";
-export { createAllAbortListener } from "./create-all-abort-listener.d.ts";
-export type { CreateBatchCancelledListenerOptions } from "./create-batch-cancelled-listener.d.ts";
-export { createBatchCancelledListener } from "./create-batch-cancelled-listener.d.ts";
-export type { BatchDeleteResult, CreateBatchDeleteFilesOptions, CreateBatchDeleteFilesReturn } from "./create-batch-delete-files.d.ts";
-export { createBatchDeleteFiles } from "./create-batch-delete-files.d.ts";
-export type { CreateBatchErrorListenerOptions } from "./create-batch-error-listener.d.ts";
-export { createBatchErrorListener } from "./create-batch-error-listener.d.ts";
-export type { CreateBatchFinalizeListenerOptions } from "./create-batch-finalize-listener.d.ts";
-export { createBatchFinalizeListener } from "./create-batch-finalize-listener.d.ts";
-export type { CreateBatchFinishListenerOptions } from "./create-batch-finish-listener.d.ts";
-export { createBatchFinishListener } from "./create-batch-finish-listener.d.ts";
-export type { CreateBatchProgressListenerOptions } from "./create-batch-progress-listener.d.ts";
-export { createBatchProgressListener } from "./create-batch-progress-listener.d.ts";
-export type { CreateBatchRetryOptions, CreateBatchRetryReturn } from "./create-batch-retry.d.ts";
-export { createBatchRetry } from "./create-batch-retry.d.ts";
-export type { CreateBatchStartListenerOptions } from "./create-batch-start-listener.d.ts";
-export { createBatchStartListener } from "./create-batch-start-listener.d.ts";
-export type { CreateBatchUploadOptions, CreateBatchUploadReturn } from "./create-batch-upload.d.ts";
-export { createBatchUpload } from "./create-batch-upload.d.ts";
-export type { CreateChunkedRestUploadOptions, CreateChunkedRestUploadReturn } from "./create-chunked-rest-upload.d.ts";
-export { createChunkedRestUpload } from "./create-chunked-rest-upload.d.ts";
-export type { CreateDeleteFileOptions, CreateDeleteFileReturn } from "./create-delete-file.d.ts";
-export { createDeleteFile } from "./create-delete-file.d.ts";
-export type { CreateFileInputOptions, CreateFileInputReturn } from "./create-file-input.d.ts";
-export { createFileInput } from "./create-file-input.d.ts";
-export type { CreateGetFileOptions, CreateGetFileReturn } from "./create-get-file.d.ts";
-export { createGetFile } from "./create-get-file.d.ts";
-export type { CreateGetFileListOptions, CreateGetFileListReturn, FileListResponse } from "./create-get-file-list.d.ts";
-export { createGetFileList } from "./create-get-file-list.d.ts";
-export type { CreateGetFileMetaOptions, CreateGetFileMetaReturn } from "./create-get-file-meta.d.ts";
-export { createGetFileMeta } from "./create-get-file-meta.d.ts";
-export type { CreateHeadFileOptions, CreateHeadFileReturn, FileHeadMetadata } from "./create-head-file.d.ts";
-export { createHeadFile } from "./create-head-file.d.ts";
-export type { CreateMultipartUploadOptions, CreateMultipartUploadReturn } from "./create-multipart-upload.d.ts";
-export { createMultipartUpload } from "./create-multipart-upload.d.ts";
-export type { CreatePasteUploadOptions, CreatePasteUploadReturn } from "./create-paste-upload.d.ts";
-export { createPasteUpload } from "./create-paste-upload.d.ts";
-export type { CreatePatchChunkOptions, CreatePatchChunkReturn } from "./create-patch-chunk.d.ts";
-export { createPatchChunk } from "./create-patch-chunk.d.ts";
-export type { CreatePutFileOptions, CreatePutFileReturn } from "./create-put-file.d.ts";
-export { createPutFile } from "./create-put-file.d.ts";
-export type { CreateRetryOptions, CreateRetryReturn } from "./create-retry.d.ts";
-export { createRetry } from "./create-retry.d.ts";
-export type { CreateRetryListenerOptions } from "./create-retry-listener.d.ts";
-export { createRetryListener } from "./create-retry-listener.d.ts";
-export type { CreateTransformFileOptions, CreateTransformFileReturn, TransformOptions } from "./create-transform-file.d.ts";
-export { createTransformFile } from "./create-transform-file.d.ts";
-export type { CreateTransformMetadataOptions, CreateTransformMetadataReturn, TransformMetadata } from "./create-transform-metadata.d.ts";
-export { createTransformMetadata } from "./create-transform-metadata.d.ts";
-export type { CreateTusUploadOptions, CreateTusUploadReturn } from "./create-tus-upload.d.ts";
-export { createTusUpload } from "./create-tus-upload.d.ts";
-export type { CreateUploadOptions, CreateUploadReturn } from "./create-upload.d.ts";
-export { createUpload } from "./create-upload.d.ts";
+import { c as UploadItem, B as BatchState, U as UploadResult, F as FileMeta, g as UploadMethod } from "../packem_shared/uploader.d-DsC50BbX.js";
+import { Accessor } from 'solid-js';
+import { QueryClient } from '@tanstack/solid-query';
+interface CreateAbortAllOptions {
+  endpoint: string;
+  metadata?: Record<string, string>;
+}
+interface CreateAbortAllReturn {
+  abortAll: () => void;
+}
+declare const createAbortAll: (options: CreateAbortAllOptions) => CreateAbortAllReturn;
+interface CreateAbortBatchOptions {
+  endpoint: string;
+  metadata?: Record<string, string>;
+}
+interface CreateAbortBatchReturn {
+  abortBatch: (batchId: string) => void;
+}
+declare const createAbortBatch: (options: CreateAbortBatchOptions) => CreateAbortBatchReturn;
+interface CreateAbortItemOptions {
+  endpoint: string;
+  metadata?: Record<string, string>;
+}
+interface CreateAbortItemReturn {
+  abortItem: (id: string) => void;
+}
+declare const createAbortItem: (options: CreateAbortItemOptions) => CreateAbortItemReturn;
+interface CreateAllAbortListenerOptions {
+  endpoint: string;
+  metadata?: Record<string, string>;
+  onAbort: (item: UploadItem) => void;
+}
+declare const createAllAbortListener: (options: CreateAllAbortListenerOptions) => void;
+interface CreateBatchCancelledListenerOptions {
+  endpoint: string;
+  metadata?: Record<string, string>;
+  onBatchCancelled: (batch: BatchState) => void;
+}
+declare const createBatchCancelledListener: (options: CreateBatchCancelledListenerOptions) => void;
+interface BatchDeleteResult {
+  /** Number of files that failed to delete */
+  failed?: number;
+  /** Number of files successfully deleted */
+  successful?: number;
+}
+interface CreateBatchDeleteFilesOptions {
+  /** Base endpoint URL for file operations */
+  endpoint: string;
+}
+interface CreateBatchDeleteFilesReturn {
+  /** Delete multiple files by IDs */
+  batchDeleteFiles: (ids: string[]) => Promise<BatchDeleteResult>;
+  /** Last request error, if any */
+  error: Accessor<Error | undefined>;
+  /** Whether a request is currently in progress */
+  isLoading: Accessor<boolean>;
+  /** Reset mutation state */
+  reset: () => void;
+}
+/**
+* Solid.js primitive for batch deleting files using TanStack Query.
+* Supports both query parameter and JSON body methods.
+* Automatically invalidates related queries.
+* @param options Hook configuration options
+* @returns Batch file deletion functions and state signals
+*/
+declare const createBatchDeleteFiles: (options: CreateBatchDeleteFilesOptions) => CreateBatchDeleteFilesReturn;
+interface CreateBatchErrorListenerOptions {
+  endpoint: string;
+  metadata?: Record<string, string>;
+  onBatchError: (batch: BatchState) => void;
+}
+declare const createBatchErrorListener: (options: CreateBatchErrorListenerOptions) => void;
+interface CreateBatchFinalizeListenerOptions {
+  endpoint: string;
+  metadata?: Record<string, string>;
+  onBatchFinalize: (batch: BatchState) => void;
+}
+declare const createBatchFinalizeListener: (options: CreateBatchFinalizeListenerOptions) => void;
+interface CreateBatchFinishListenerOptions {
+  endpoint: string;
+  metadata?: Record<string, string>;
+  onBatchFinish: (batch: BatchState) => void;
+}
+declare const createBatchFinishListener: (options: CreateBatchFinishListenerOptions) => void;
+interface CreateBatchProgressListenerOptions {
+  endpoint: string;
+  metadata?: Record<string, string>;
+  onBatchProgress: (batch: BatchState) => void;
+}
+declare const createBatchProgressListener: (options: CreateBatchProgressListenerOptions) => void;
+interface CreateBatchRetryOptions {
+  endpoint: string;
+  metadata?: Record<string, string>;
+}
+interface CreateBatchRetryReturn {
+  retryBatch: (batchId: string) => void;
+}
+declare const createBatchRetry: (options: CreateBatchRetryOptions) => CreateBatchRetryReturn;
+interface CreateBatchStartListenerOptions {
+  endpoint: string;
+  metadata?: Record<string, string>;
+  onBatchStart: (batch: BatchState) => void;
+}
+declare const createBatchStartListener: (options: CreateBatchStartListenerOptions) => void;
+interface CreateBatchUploadOptions {
+  /** Upload endpoint URL */
+  endpoint: string;
+  /** Additional metadata to include with the upload */
+  metadata?: Record<string, string>;
+  /** Callback when batch fails */
+  onError?: (error: Error, batchId: string) => void;
+  /** Callback when batch progress updates */
+  onProgress?: (progress: number, batchId: string) => void;
+  /** Callback when batch starts */
+  onStart?: (batchId: string) => void;
+  /** Callback when batch completes successfully */
+  onSuccess?: (results: UploadResult[], batchId: string) => void;
+}
+interface CreateBatchUploadReturn {
+  /** Abort a specific batch */
+  abortBatch: (batchId: string) => void;
+  /** Number of completed items in current batch */
+  completedCount: Accessor<number>;
+  /** Last batch error, if any */
+  error: Accessor<Error | undefined>;
+  /** Number of failed items in current batch */
+  errorCount: Accessor<number>;
+  /** Whether a batch is currently uploading */
+  isUploading: Accessor<boolean>;
+  /** All upload items in current batch */
+  items: Accessor<UploadItem[]>;
+  /** Current batch progress (0-100) */
+  progress: Accessor<number>;
+  /** Reset batch state */
+  reset: () => void;
+  /** Upload multiple files as a batch */
+  uploadBatch: (files: File[]) => string[];
+}
+/**
+* Solid.js primitive for batch file uploads using multipart/form-data.
+* @param options Upload configuration options
+* @returns Batch upload functions and state signals
+*/
+declare const createBatchUpload: (options: CreateBatchUploadOptions) => CreateBatchUploadReturn;
+interface CreateChunkedRestUploadOptions {
+  /** Chunk size for chunked REST uploads (default: 5MB) */
+  chunkSize?: number;
+  /** Chunked REST upload endpoint URL */
+  endpoint: string;
+  /** Maximum number of retry attempts */
+  maxRetries?: number;
+  /** Additional metadata to include with the upload */
+  metadata?: Record<string, string>;
+  /** Callback when upload fails */
+  onError?: (error: Error) => void;
+  /** Callback when upload is paused */
+  onPause?: () => void;
+  /** Callback when upload progress updates */
+  onProgress?: (progress: number, offset: number) => void;
+  /** Callback when upload is resumed */
+  onResume?: () => void;
+  /** Callback when upload starts */
+  onStart?: () => void;
+  /** Callback when upload completes successfully */
+  onSuccess?: (file: UploadResult) => void;
+  /** Enable automatic retry on failure */
+  retry?: boolean;
+}
+interface CreateChunkedRestUploadReturn {
+  /** Abort the current upload */
+  abort: () => void;
+  /** Last upload error, if any */
+  error: Accessor<Error | undefined>;
+  /** Whether the upload is paused */
+  isPaused: Accessor<boolean>;
+  /** Whether an upload is currently in progress */
+  isUploading: Accessor<boolean>;
+  /** Current upload offset (bytes uploaded) */
+  offset: Accessor<number>;
+  /** Pause the current upload */
+  pause: () => void;
+  /** Current upload progress (0-100) */
+  progress: Accessor<number>;
+  /** Reset upload state */
+  reset: () => void;
+  /** Last upload result, if any */
+  result: Accessor<UploadResult | undefined>;
+  /** Resume a paused upload */
+  resume: () => Promise<void>;
+  /** Upload a file using chunked REST protocol */
+  upload: (file: File) => Promise<UploadResult>;
+}
+/**
+* Solid.js primitive for chunked REST file uploads.
+* @param options Upload configuration options
+* @returns Upload functions and state signals
+*/
+declare const createChunkedRestUpload: (options: CreateChunkedRestUploadOptions) => CreateChunkedRestUploadReturn;
+interface CreateDeleteFileOptions {
+  /** Base endpoint URL for file operations */
+  endpoint: string;
+}
+interface CreateDeleteFileReturn {
+  /** Delete a file by ID */
+  deleteFile: (id: string) => Promise<void>;
+  /** Last request error, if any */
+  error: Accessor<Error | undefined>;
+  /** Whether a request is currently in progress */
+  isLoading: Accessor<boolean>;
+  /** Reset mutation state */
+  reset: () => void;
+}
+/**
+* Solid.js primitive for deleting a single file using TanStack Query.
+* Automatically invalidates related queries.
+* @param options Hook configuration options
+* @returns File deletion functions and state signals
+*/
+declare const createDeleteFile: (options: CreateDeleteFileOptions) => CreateDeleteFileReturn;
+interface CreateFileInputOptions {
+  accept?: string;
+  multiple?: boolean;
+  onFilesSelected?: (files: File[]) => void;
+}
+interface CreateFileInputReturn {
+  files: Accessor<File[]>;
+  handleDragLeave: (event: DragEvent) => void;
+  handleDragOver: (event: DragEvent) => void;
+  handleDrop: (event: DragEvent) => void;
+  handleFileChange: (event: Event) => void;
+  inputRef: {
+    current: HTMLInputElement | undefined;
+  };
+  isDragging: Accessor<boolean>;
+  openFileDialog: () => void;
+  reset: () => void;
+}
+declare const createFileInput: (options?: CreateFileInputOptions) => CreateFileInputReturn;
+interface CreateGetFileOptions {
+  /** Whether to enable the query */
+  enabled?: Accessor<boolean> | boolean;
+  /** Base endpoint URL for file operations */
+  endpoint: string;
+  /** File ID to fetch */
+  id: Accessor<string> | string;
+  /** Callback when request fails */
+  onError?: (error: Error) => void;
+  /** Callback when request succeeds */
+  onSuccess?: (data: Blob, meta: FileMeta | undefined) => void;
+  /** Optional QueryClient to use */
+  queryClient?: QueryClient;
+  /** Transformation parameters for media files */
+  transform?: Accessor<Record<string, string | number | boolean> | undefined> | Record<string, string | number | boolean>;
+}
+interface CreateGetFileReturn {
+  /** File data as Blob */
+  data: Accessor<Blob | undefined>;
+  /** Last request error, if any */
+  error: Accessor<Error | undefined>;
+  /** Whether a request is currently in progress */
+  isLoading: Accessor<boolean>;
+  /** File metadata from response headers */
+  meta: Accessor<FileMeta | undefined>;
+  /** Refetch the file */
+  refetch: () => void;
+}
+/**
+* Solid.js primitive for fetching/downloading files using TanStack Query.
+* Supports optional transformation parameters for media files.
+* @param options Hook configuration options
+* @returns File fetching functions and state signals
+*/
+declare const createGetFile: (options: CreateGetFileOptions) => CreateGetFileReturn;
+interface FileListResponse {
+  data: FileMeta[];
+  meta?: {
+    firstPage?: number;
+    firstPageUrl?: string;
+    lastPage?: number;
+    lastPageUrl?: string;
+    nextPageUrl?: string;
+    page?: number;
+    perPage?: number;
+    previousPageUrl?: string;
+    total?: number;
+  };
+}
+interface CreateGetFileListOptions {
+  /** Whether to enable the query */
+  enabled?: Accessor<boolean> | boolean;
+  /** Base endpoint URL for file operations */
+  endpoint: string;
+  /** Maximum number of elements to retrieve */
+  limit?: Accessor<number> | number;
+  /** Page number for pagination */
+  page?: Accessor<number> | number;
+  /** Optional QueryClient to use */
+  queryClient?: QueryClient;
+}
+interface CreateGetFileListReturn {
+  /** File list data */
+  data: Accessor<FileListResponse | undefined>;
+  /** Last request error, if any */
+  error: Accessor<Error | undefined>;
+  /** Whether a request is currently in progress */
+  isLoading: Accessor<boolean>;
+  /** Refetch the file list */
+  refetch: () => void;
+}
+/**
+* Solid.js primitive for fetching a list of files using TanStack Query.
+* Supports pagination via query parameters.
+* @param options Hook configuration options
+* @returns File list fetching functions and state signals
+*/
+declare const createGetFileList: (options: CreateGetFileListOptions) => CreateGetFileListReturn;
+interface CreateGetFileMetaOptions {
+  /** Whether to enable the query */
+  enabled?: Accessor<boolean> | boolean;
+  /** Base endpoint URL for file operations */
+  endpoint: string;
+  /** File ID to fetch metadata for */
+  id: Accessor<string> | string;
+  /** Optional QueryClient to use */
+  queryClient?: QueryClient;
+}
+interface CreateGetFileMetaReturn {
+  /** File metadata */
+  data: Accessor<FileMeta | undefined>;
+  /** Last request error, if any */
+  error: Accessor<Error | undefined>;
+  /** Whether a request is currently in progress */
+  isLoading: Accessor<boolean>;
+  /** Refetch the file metadata */
+  refetch: () => void;
+}
+/**
+* Solid.js primitive for fetching file metadata using TanStack Query.
+* @param options Hook configuration options
+* @returns File metadata fetching functions and state signals
+*/
+declare const createGetFileMeta: (options: CreateGetFileMetaOptions) => CreateGetFileMetaReturn;
+interface FileHeadMetadata {
+  /** Whether this is a chunked upload session */
+  chunkedUpload?: boolean;
+  /** Content length in bytes */
+  contentLength?: number;
+  /** Content type */
+  contentType?: string;
+  /** Entity tag for caching */
+  etag?: string;
+  /** Last modified date */
+  lastModified?: string;
+  /** Received chunk offsets (chunked uploads) */
+  receivedChunks?: number[];
+  /** Whether upload is complete (chunked uploads) */
+  uploadComplete?: boolean;
+  /** Upload expiration date */
+  uploadExpires?: string;
+  /** Upload offset for chunked uploads */
+  uploadOffset?: number;
+}
+interface CreateHeadFileOptions {
+  /** Whether to enable the query */
+  enabled?: Accessor<boolean> | boolean;
+  /** Base endpoint URL for file operations */
+  endpoint: string;
+  /** File ID to fetch metadata for */
+  id: Accessor<string> | string;
+}
+interface CreateHeadFileReturn {
+  /** File metadata from HEAD request */
+  data: Accessor<FileHeadMetadata | undefined>;
+  /** Last request error, if any */
+  error: Accessor<Error | undefined>;
+  /** Whether a request is currently in progress */
+  isLoading: Accessor<boolean>;
+  /** Refetch the file metadata */
+  refetch: () => void;
+}
+/**
+* Solid.js primitive for fetching file metadata via HEAD request using TanStack Query.
+* Useful for checking upload progress and file status without downloading.
+* @param options Hook configuration options
+* @returns File HEAD request functions and state signals
+*/
+declare const createHeadFile: (options: CreateHeadFileOptions) => CreateHeadFileReturn;
+interface CreateMultipartUploadOptions {
+  /** Upload endpoint URL */
+  endpoint: string;
+  /** Additional metadata to include with the upload */
+  metadata?: Record<string, string>;
+  /** Callback when upload fails */
+  onError?: (error: Error) => void;
+  /** Callback when upload progress updates */
+  onProgress?: (progress: number) => void;
+  /** Callback when upload starts */
+  onStart?: () => void;
+  /** Callback when upload completes successfully */
+  onSuccess?: (file: UploadResult) => void;
+}
+interface CreateMultipartUploadReturn {
+  /** Last upload error, if any */
+  error: Accessor<Error | undefined>;
+  /** Whether an upload is currently in progress */
+  isUploading: Accessor<boolean>;
+  /** Current upload progress (0-100) */
+  progress: Accessor<number>;
+  /** Reset upload state */
+  reset: () => void;
+  /** Last upload result, if any */
+  result: Accessor<UploadResult | undefined>;
+  /** Upload a file using multipart/form-data */
+  upload: (file: File) => Promise<UploadResult>;
+}
+/**
+* Solid.js primitive for multipart/form-data file uploads using rpldy uploader core.
+* @param options Upload configuration options
+* @returns Upload functions and state signals
+*/
+declare const createMultipartUpload: (options: CreateMultipartUploadOptions) => CreateMultipartUploadReturn;
+interface CreatePasteUploadOptions {
+  filter?: (file: File) => boolean;
+  onFilesPasted?: (files: File[]) => void;
+}
+interface CreatePasteUploadReturn {
+  handlePaste: (event: ClipboardEvent) => void;
+  pastedFiles: Accessor<File[]>;
+  reset: () => void;
+}
+declare const createPasteUpload: (options?: CreatePasteUploadOptions) => CreatePasteUploadReturn;
+interface CreatePatchChunkOptions {
+  /** Base endpoint URL for file operations */
+  endpoint: string;
+}
+interface CreatePatchChunkReturn {
+  /** Last upload result, if any */
+  data: Accessor<UploadResult | undefined>;
+  /** Last request error, if any */
+  error: Accessor<Error | undefined>;
+  /** Whether a request is currently in progress */
+  isLoading: Accessor<boolean>;
+  /** Upload a chunk for chunked uploads */
+  patchChunk: (id: string, chunk: Blob, offset: number, checksum?: string) => Promise<UploadResult>;
+  /** Reset mutation state */
+  reset: () => void;
+}
+/**
+* Solid.js primitive for uploading chunks in chunked uploads using TanStack Query.
+* Requires X-Chunk-Offset header and chunk data.
+* Automatically invalidates related queries when upload is complete.
+* @param options Hook configuration options
+* @returns Chunk upload functions and state signals
+*/
+declare const createPatchChunk: (options: CreatePatchChunkOptions) => CreatePatchChunkReturn;
+interface CreatePutFileOptions {
+  /** Base endpoint URL for file operations */
+  endpoint: string;
+  /** Callback when upload progress updates */
+  onProgress?: (progress: number) => void;
+}
+interface CreatePutFileReturn {
+  /** Last upload result, if any */
+  data: Accessor<UploadResult | undefined>;
+  /** Last request error, if any */
+  error: Accessor<Error | undefined>;
+  /** Whether a request is currently in progress */
+  isLoading: Accessor<boolean>;
+  /** Current upload progress (0-100) */
+  progress: Accessor<number>;
+  /** Create or update a file by ID */
+  putFile: (id: string, file: File | Blob) => Promise<UploadResult>;
+  /** Reset mutation state */
+  reset: () => void;
+}
+/**
+* Solid.js primitive for creating or updating files via PUT request using TanStack Query.
+* Automatically invalidates related queries.
+* @param options Hook configuration options
+* @returns File PUT functions and state signals
+*/
+declare const createPutFile: (options: CreatePutFileOptions) => CreatePutFileReturn;
+interface CreateRetryOptions {
+  endpoint: string;
+  metadata?: Record<string, string>;
+}
+interface CreateRetryReturn {
+  retryItem: (id: string) => void;
+}
+declare const createRetry: (options: CreateRetryOptions) => CreateRetryReturn;
+interface CreateRetryListenerOptions {
+  endpoint: string;
+  metadata?: Record<string, string>;
+  onRetry: (item: UploadItem) => void;
+}
+declare const createRetryListener: (options: CreateRetryListenerOptions) => void;
+interface TransformOptions {
+  /** Additional transformation parameters */
+  [key: string]: string | number | boolean | undefined;
+  /** Resize fit mode */
+  fit?: "cover" | "contain" | "fill" | "inside" | "outside";
+  /** Output format (jpeg, png, webp, etc.) */
+  format?: string;
+  /** Desired height in pixels */
+  height?: number;
+  /** Quality setting (0-100) */
+  quality?: number;
+  /** Desired width in pixels */
+  width?: number;
+}
+interface CreateTransformFileOptions {
+  /** Whether to enable the query */
+  enabled?: Accessor<boolean> | boolean;
+  /** Base endpoint URL for transform operations */
+  endpoint: string;
+  /** File ID to transform */
+  id: Accessor<string> | string;
+  /** Transformation parameters */
+  transform: Accessor<TransformOptions> | TransformOptions;
+}
+interface CreateTransformFileReturn {
+  /** Transformed file data as Blob */
+  data: Accessor<Blob | undefined>;
+  /** Last request error, if any */
+  error: Accessor<Error | undefined>;
+  /** Whether a request is currently in progress */
+  isLoading: Accessor<boolean>;
+  /** File metadata from response headers */
+  meta: Accessor<FileMeta | undefined>;
+  /** Refetch the transformed file */
+  refetch: () => void;
+}
+/**
+* Solid.js primitive for fetching transformed files using TanStack Query.
+* Supports image, video, and audio transformation parameters.
+* @param options Hook configuration options
+* @returns Transform file fetching functions and state signals
+*/
+declare const createTransformFile: (options: CreateTransformFileOptions) => CreateTransformFileReturn;
+interface TransformMetadata {
+  /** Available transformation formats */
+  formats?: string[];
+  /** Supported transformation parameters */
+  parameters?: string[];
+}
+interface CreateTransformMetadataOptions {
+  /** Whether to enable the query */
+  enabled?: Accessor<boolean> | boolean;
+  /** Base endpoint URL for transform operations */
+  endpoint: string;
+}
+interface CreateTransformMetadataReturn {
+  /** Transform metadata */
+  data: Accessor<TransformMetadata | undefined>;
+  /** Last request error, if any */
+  error: Accessor<Error | undefined>;
+  /** Whether a request is currently in progress */
+  isLoading: Accessor<boolean>;
+  /** Refetch the transform metadata */
+  refetch: () => void;
+}
+/**
+* Solid.js primitive for fetching transformation metadata using TanStack Query.
+* Returns available formats and transformation parameters.
+* @param options Hook configuration options
+* @returns Transform metadata fetching functions and state signals
+*/
+declare const createTransformMetadata: (options: CreateTransformMetadataOptions) => CreateTransformMetadataReturn;
+interface CreateTusUploadOptions {
+  /** Chunk size for TUS uploads (default: 1MB) */
+  chunkSize?: number;
+  /** TUS upload endpoint URL */
+  endpoint: string;
+  /** Maximum number of retry attempts */
+  maxRetries?: number;
+  /** Additional metadata to include with the upload */
+  metadata?: Record<string, string>;
+  /** Callback when upload fails */
+  onError?: (error: Error) => void;
+  /** Callback when upload is paused */
+  onPause?: () => void;
+  /** Callback when upload progress updates */
+  onProgress?: (progress: number) => void;
+  /** Callback when upload is resumed */
+  onResume?: () => void;
+  /** Callback when upload starts */
+  onStart?: () => void;
+  /** Callback when upload completes successfully */
+  onSuccess?: (file: UploadResult) => void;
+  /** Enable automatic retry on failure */
+  retry?: boolean;
+}
+interface CreateTusUploadReturn {
+  /** Abort the current upload */
+  abort: () => void;
+  /** Last upload error, if any */
+  error: Accessor<Error | undefined>;
+  /** Whether the upload is paused */
+  isPaused: Accessor<boolean>;
+  /** Whether an upload is currently in progress */
+  isUploading: Accessor<boolean>;
+  /** Current upload offset (bytes uploaded) */
+  offset: Accessor<number>;
+  /** Pause the current upload */
+  pause: () => void;
+  /** Current upload progress (0-100) */
+  progress: Accessor<number>;
+  /** Reset upload state */
+  reset: () => void;
+  /** Last upload result, if any */
+  result: Accessor<UploadResult | undefined>;
+  /** Resume a paused upload */
+  resume: () => Promise<void>;
+  /** Upload a file using TUS protocol */
+  upload: (file: File) => Promise<UploadResult>;
+}
+/**
+* Solid.js primitive for TUS resumable file uploads.
+* @param options Upload configuration options
+* @returns Upload functions and state signals
+*/
+declare const createTusUpload: (options: CreateTusUploadOptions) => CreateTusUploadReturn;
+interface CreateUploadOptions {
+  /** Chunk size for TUS and chunked REST uploads (default: 1MB for TUS, 5MB for chunked REST) */
+  chunkSize?: number;
+  /** Chunked REST upload endpoint URL */
+  endpointChunkedRest?: string;
+  /** Multipart upload endpoint URL */
+  endpointMultipart?: string;
+  /** TUS upload endpoint URL */
+  endpointTus?: string;
+  /** Maximum number of retry attempts (TUS and chunked REST only) */
+  maxRetries?: number;
+  /** Additional metadata to include with the upload */
+  metadata?: Record<string, string>;
+  /** Upload method to use: 'multipart', 'tus', 'chunked-rest', or 'auto'. If undefined, auto-detected based on provided endpoints */
+  method?: UploadMethod;
+  /** Callback when upload fails */
+  onError?: (error: Error) => void;
+  /** Callback when upload is paused (TUS and chunked REST only) */
+  onPause?: () => void;
+  /** Callback when upload progress updates */
+  onProgress?: (progress: number) => void;
+  /** Callback when upload is resumed (TUS and chunked REST only) */
+  onResume?: () => void;
+  /** Callback when upload starts */
+  onStart?: () => void;
+  /** Callback when upload completes successfully */
+  onSuccess?: (file: UploadResult) => void;
+  /** Enable automatic retry on failure (TUS and chunked REST only) */
+  retry?: boolean;
+  /** File size threshold for auto-selecting TUS (default: 10MB) */
+  tusThreshold?: number;
+}
+interface CreateUploadReturn {
+  /** Abort the current upload */
+  abort: () => void;
+  /** Current upload method being used */
+  currentMethod: Accessor<UploadMethod>;
+  /** Last upload error, if any */
+  error: Accessor<Error | undefined>;
+  /** Whether the upload is paused (TUS and chunked REST only) */
+  isPaused: Accessor<boolean | undefined>;
+  /** Whether an upload is currently in progress */
+  isUploading: Accessor<boolean>;
+  /** Current upload offset in bytes (TUS and chunked REST only) */
+  offset: Accessor<number | undefined>;
+  /** Pause the current upload (TUS and chunked REST only) */
+  pause: Accessor<(() => void) | undefined>;
+  /** Current upload progress (0-100) */
+  progress: Accessor<number>;
+  /** Reset upload state */
+  reset: () => void;
+  /** Last upload result, if any */
+  result: Accessor<UploadResult | undefined>;
+  /** Resume a paused upload (TUS and chunked REST only) */
+  resume: Accessor<(() => Promise<void>) | undefined>;
+  /** Upload a file using the configured method */
+  upload: (file: File) => Promise<UploadResult>;
+}
+/**
+* Solid.js primitive for file uploads with automatic method selection.
+* Uses custom uploader implementations for multipart, TUS, and chunked REST.
+* Automatically chooses between methods based on file size and method preference.
+* @param options Upload configuration options
+* @returns Upload functions and state signals
+*/
+declare const createUpload: (options: CreateUploadOptions) => CreateUploadReturn;
+export { type BatchDeleteResult, type CreateAbortAllOptions, type CreateAbortAllReturn, type CreateAbortBatchOptions, type CreateAbortBatchReturn, type CreateAbortItemOptions, type CreateAbortItemReturn, type CreateAllAbortListenerOptions, type CreateBatchCancelledListenerOptions, type CreateBatchDeleteFilesOptions, type CreateBatchDeleteFilesReturn, type CreateBatchErrorListenerOptions, type CreateBatchFinalizeListenerOptions, type CreateBatchFinishListenerOptions, type CreateBatchProgressListenerOptions, type CreateBatchRetryOptions, type CreateBatchRetryReturn, type CreateBatchStartListenerOptions, type CreateBatchUploadOptions, type CreateBatchUploadReturn, type CreateChunkedRestUploadOptions, type CreateChunkedRestUploadReturn, type CreateDeleteFileOptions, type CreateDeleteFileReturn, type CreateFileInputOptions, type CreateFileInputReturn, type CreateGetFileListOptions, type CreateGetFileListReturn, type CreateGetFileMetaOptions, type CreateGetFileMetaReturn, type CreateGetFileOptions, type CreateGetFileReturn, type CreateHeadFileOptions, type CreateHeadFileReturn, type CreateMultipartUploadOptions, type CreateMultipartUploadReturn, type CreatePasteUploadOptions, type CreatePasteUploadReturn, type CreatePatchChunkOptions, type CreatePatchChunkReturn, type CreatePutFileOptions, type CreatePutFileReturn, type CreateRetryListenerOptions, type CreateRetryOptions, type CreateRetryReturn, type CreateTransformFileOptions, type CreateTransformFileReturn, type CreateTransformMetadataOptions, type CreateTransformMetadataReturn, type CreateTusUploadOptions, type CreateTusUploadReturn, type CreateUploadOptions, type CreateUploadReturn, type FileHeadMetadata, type FileListResponse, type TransformMetadata, type TransformOptions, createAbortAll, createAbortBatch, createAbortItem, createAllAbortListener, createBatchCancelledListener, createBatchDeleteFiles, createBatchErrorListener, createBatchFinalizeListener, createBatchFinishListener, createBatchProgressListener, createBatchRetry, createBatchStartListener, createBatchUpload, createChunkedRestUpload, createDeleteFile, createFileInput, createGetFile, createGetFileList, createGetFileMeta, createHeadFile, createMultipartUpload, createPasteUpload, createPatchChunk, createPutFile, createRetry, createRetryListener, createTransformFile, createTransformMetadata, createTusUpload, createUpload };