@plyaz/api 1.6.6 → 1.6.8

package/dist/api/services/files/POST/useGenerateDocument.d.ts

@@ -0,0 +1,39 @@
+/**
+ * React Query Mutation Hook for Generating Documents
+ * Provides mutation state for document generation
+ */
+import { createApiMutation } from '../../../hooks/factories';
+import type { GenerateDocumentRequest, GenerateDocumentResponse, ServiceOptions } from '@plyaz/types/api';
+import type { ErrorResponse } from '@plyaz/types/errors';
+import type { EndpointsList } from '@/api/endpoints';
+/**
+ * Hook for generating documents
+ *
+ * @param serviceOptions - Service options (apiClient, apiConfig, updateConfigOptions)
+ * @param mutationOptions - React Query mutation options
+ * @returns React Query mutation result
+ *
+ * @example
+ * ```typescript
+ * const { mutate, isPending, data } = useGenerateDocument();
+ *
+ * const handleGenerate = () => {
+ *   mutate({
+ *     templateId: 'invoices/standard',
+ *     templateData: { invoiceNumber: 'INV-001', total: 100 },
+ *     outputFormat: 'pdf',
+ *   }, {
+ *     onSuccess: (result) => {
+ *       // Convert base64 to blob and download
+ *       const blob = new Blob([
+ *         Uint8Array.from(atob(result.buffer), c => c.charCodeAt(0))
+ *       ], { type: 'application/pdf' });
+ *       const url = URL.createObjectURL(blob);
+ *       window.open(url);
+ *     }
+ *   });
+ * };
+ * ```
+ */
+export declare function useGenerateDocument<TEndpoints = EndpointsList>(serviceOptions?: ServiceOptions<TEndpoints>, mutationOptions?: Parameters<ReturnType<typeof createApiMutation<GenerateDocumentResponse, ErrorResponse, GenerateDocumentRequest, unknown, TEndpoints>>>[1]): ReturnType<ReturnType<typeof createApiMutation<GenerateDocumentResponse, ErrorResponse, GenerateDocumentRequest, unknown, TEndpoints>>>;
+//# sourceMappingURL=useGenerateDocument.d.ts.map

package/dist/api/services/files/POST/useGenerateDocument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGenerateDocument.d.ts","sourceRoot":"","sources":["../../../../../src/api/services/files/POST/useGenerateDocument.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EACV,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,GAAG,aAAa,EAC5D,cAAc,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,EAC3C,eAAe,CAAC,EAAE,UAAU,CAC1B,UAAU,CACR,OAAO,iBAAiB,CACtB,wBAAwB,EACxB,aAAa,EACb,uBAAuB,EACvB,OAAO,EACP,UAAU,CACX,CACF,CACF,CAAC,CAAC,CAAC,GACH,UAAU,CACX,UAAU,CACR,OAAO,iBAAiB,CACtB,wBAAwB,EACxB,aAAa,EACb,uBAAuB,EACvB,OAAO,EACP,UAAU,CACX,CACF,CACF,CAWA"}

package/dist/api/services/files/POST/useUploadFile.d.ts

@@ -0,0 +1,34 @@
+/**
+ * React Query Mutation Hook for Uploading Files
+ * Provides mutation state and cache invalidation
+ */
+import { createApiMutation } from '../../../hooks/factories';
+import type { UploadFileRequest, UploadFileResponse, ServiceOptions } from '@plyaz/types/api';
+import type { ErrorResponse } from '@plyaz/types/errors';
+import type { EndpointsList } from '@/api/endpoints';
+/**
+ * Hook for uploading files
+ *
+ * @param serviceOptions - Service options (apiClient, apiConfig, updateConfigOptions)
+ * @param mutationOptions - React Query mutation options
+ * @returns React Query mutation result
+ *
+ * @example
+ * ```typescript
+ * const { mutate, isPending } = useUploadFile();
+ *
+ * const handleUpload = () => {
+ *   mutate({
+ *     templateId: 'invoices/standard',
+ *     templateData: { invoiceNumber: 'INV-001' },
+ *     filename: 'invoice.pdf',
+ *   }, {
+ *     onSuccess: (result) => {
+ *       console.log('File uploaded:', result.url);
+ *     }
+ *   });
+ * };
+ * ```
+ */
+export declare function useUploadFile<TEndpoints = EndpointsList>(serviceOptions?: ServiceOptions<TEndpoints>, mutationOptions?: Parameters<ReturnType<typeof createApiMutation<UploadFileResponse, ErrorResponse, UploadFileRequest, unknown, TEndpoints>>>[1]): ReturnType<ReturnType<typeof createApiMutation<UploadFileResponse, ErrorResponse, UploadFileRequest, unknown, TEndpoints>>>;
+//# sourceMappingURL=useUploadFile.d.ts.map

package/dist/api/services/files/POST/useUploadFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUploadFile.d.ts","sourceRoot":"","sources":["../../../../../src/api/services/files/POST/useUploadFile.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAAC,UAAU,GAAG,aAAa,EACtD,cAAc,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,EAC3C,eAAe,CAAC,EAAE,UAAU,CAC1B,UAAU,CACR,OAAO,iBAAiB,CACtB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,OAAO,EACP,UAAU,CACX,CACF,CACF,CAAC,CAAC,CAAC,GACH,UAAU,CACX,UAAU,CACR,OAAO,iBAAiB,CACtB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,OAAO,EACP,UAAU,CACX,CACF,CACF,CAkBA"}

package/dist/api/services/files/POST/useUploadFiles.d.ts

@@ -0,0 +1,36 @@
+/**
+ * React Query Mutation Hook for Uploading Multiple Files
+ * Provides mutation state and cache invalidation
+ */
+import { createApiMutation } from '../../../hooks/factories';
+import type { UploadFilesRequest, UploadFilesResponse, ServiceOptions } from '@plyaz/types/api';
+import type { ErrorResponse } from '@plyaz/types/errors';
+import type { EndpointsList } from '@/api/endpoints';
+/**
+ * Hook for uploading multiple files
+ *
+ * @param serviceOptions - Service options (apiClient, apiConfig, updateConfigOptions)
+ * @param mutationOptions - React Query mutation options
+ * @returns React Query mutation result
+ *
+ * @example
+ * ```typescript
+ * const { mutate, isPending } = useUploadFiles();
+ *
+ * const handleBulkUpload = () => {
+ *   mutate({
+ *     files: [
+ *       { base64: '...', mimeType: 'image/png', category: 'images', entityType: 'user', entityId: 'user-1' },
+ *       { base64: '...', mimeType: 'image/jpeg', category: 'images', entityType: 'user', entityId: 'user-1' },
+ *     ],
+ *     options: { concurrency: 3, continueOnError: true }
+ *   }, {
+ *     onSuccess: (result) => {
+ *       console.log(`Uploaded ${result.summary.succeeded}/${result.summary.total} files`);
+ *     }
+ *   });
+ * };
+ * ```
+ */
+export declare function useUploadFiles<TEndpoints = EndpointsList>(serviceOptions?: ServiceOptions<TEndpoints>, mutationOptions?: Parameters<ReturnType<typeof createApiMutation<UploadFilesResponse, ErrorResponse, UploadFilesRequest, unknown, TEndpoints>>>[1]): ReturnType<ReturnType<typeof createApiMutation<UploadFilesResponse, ErrorResponse, UploadFilesRequest, unknown, TEndpoints>>>;
+//# sourceMappingURL=useUploadFiles.d.ts.map

package/dist/api/services/files/POST/useUploadFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUploadFiles.d.ts","sourceRoot":"","sources":["../../../../../src/api/services/files/POST/useUploadFiles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAAC,UAAU,GAAG,aAAa,EACvD,cAAc,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,EAC3C,eAAe,CAAC,EAAE,UAAU,CAC1B,UAAU,CACR,OAAO,iBAAiB,CACtB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,OAAO,EACP,UAAU,CACX,CACF,CACF,CAAC,CAAC,CAAC,GACH,UAAU,CACX,UAAU,CACR,OAAO,iBAAiB,CACtB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,OAAO,EACP,UAAU,CACX,CACF,CACF,CAkBA"}

package/dist/api/services/files/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Files Services and Hooks
+ * Complete file operations with React Query integration
+ *
+ * Supports:
+ * - File upload (single and bulk with concurrency control)
+ * - Document generation (returns buffer without upload)
+ * - File metadata retrieval
+ * - File download
+ * - Signed URL generation
+ * - File deletion
+ */
+export * from './GET';
+export * from './POST';
+export * from './DELETE';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/services/files/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/services/files/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,cAAc,OAAO,CAAC;AAGtB,cAAc,QAAQ,CAAC;AAGvB,cAAc,UAAU,CAAC"}

package/dist/api/services/index.d.ts

@@ -8,4 +8,5 @@ export * from './featureFlags';
 export * from './infobip';
 export * from './virustotal';
 export * from './cdn';
+export * from './files';
 //# sourceMappingURL=index.d.ts.map

package/dist/api/services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/services/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGrE,cAAc,aAAa,CAAC;AAG5B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,WAAW,CAAC;AAG1B,cAAc,cAAc,CAAC;AAG7B,cAAc,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/services/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGrE,cAAc,aAAa,CAAC;AAG5B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,WAAW,CAAC;AAG1B,cAAc,cAAc,CAAC;AAG7B,cAAc,OAAO,CAAC;AAGtB,cAAc,SAAS,CAAC"}

package/dist/api/upload/browser.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Browser Upload Implementation
+ */
+import type { UploadWithProgressOptions, UploadWithProgressResult } from '@plyaz/types/api';
+/**
+ * Execute upload with retry logic for browser
+ */
+export declare function uploadWithProgressBrowser(options: UploadWithProgressOptions): Promise<UploadWithProgressResult>;
+//# sourceMappingURL=browser.d.ts.map

package/dist/api/upload/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../src/api/upload/browser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EAIzB,MAAM,kBAAkB,CAAC;AAqH1B;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CA2CnC"}

package/dist/api/upload/config.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Upload Configuration Helpers
+ */
+import type { UploadWithProgressOptions, MergedUploadConfig } from '@plyaz/types/api';
+/**
+ * Get merged configuration from global config and options
+ */
+export declare function getMergedConfig(options: UploadWithProgressOptions): MergedUploadConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/api/upload/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/api/upload/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAe,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAmEnG;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,yBAAyB,GAAG,kBAAkB,CAgBtF"}

package/dist/api/upload/constants.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Upload Constants
+ */
+export declare const UPLOAD_CONSTANTS: {
+    readonly DEFAULT_CHUNK_SIZE: number;
+    readonly DEFAULT_THROTTLE_MS: 100;
+    readonly DEFAULT_CONTENT_TYPE: "application/octet-stream";
+    readonly DEFAULT_TIMEOUT: 120000;
+    readonly DEFAULT_RETRY_DELAY: 1000;
+    readonly DEFAULT_RETRY_BACKOFF: 2;
+    readonly DEFAULT_RETRY_MAX_DELAY: 30000;
+    readonly PROGRESS_PERCENTAGE_THRESHOLD: 5;
+    readonly FULL_PERCENTAGE: 100;
+    readonly HTTPS_DEFAULT_PORT: 443;
+    readonly HTTP_DEFAULT_PORT: 80;
+    /** Max server error status code (exclusive boundary for 5xx range) */
+    readonly MAX_SERVER_ERROR_STATUS: 600;
+};
+/** Error codes that indicate retryable network/connection issues */
+export declare const RETRYABLE_ERROR_CODES: readonly ["ETIMEDOUT", "ECONNRESET", "ECONNREFUSED", "ENOTFOUND", "ENETUNREACH", "EAI_AGAIN"];
+/** Message patterns that indicate retryable errors */
+export declare const RETRYABLE_MESSAGE_PATTERNS: readonly ["timeout", "timed out", "network", "econnreset", "econnrefused", "etimedout", "service unavailable", "rate limit", "too many requests"];
+//# sourceMappingURL=constants.d.ts.map

package/dist/api/upload/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/api/upload/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;IAY3B,sEAAsE;;CAE9D,CAAC;AAEX,oEAAoE;AACpE,eAAO,MAAM,qBAAqB,+FAOxB,CAAC;AAEX,sDAAsD;AACtD,eAAO,MAAM,0BAA0B,mJAU7B,CAAC"}

package/dist/api/upload/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Upload Module
+ * Provides upload functionality with progress tracking
+ *
+ * Cross-platform upload helper that provides real-time progress events.
+ * - Node.js: Uses http/https modules with chunked writes
+ * - Browser: Uses XMLHttpRequest with progress events
+ *
+ * @example
+ * ```typescript
+ * import { uploadWithProgress } from '@plyaz/api';
+ *
+ * const result = await uploadWithProgress({
+ *   url: 'https://storage.example.com/upload',
+ *   data: fileBuffer,
+ *   contentType: 'application/pdf',
+ *   onProgress: (event) => {
+ *     console.log(`${event.percentage}% uploaded`);
+ *   },
+ * });
+ * ```
+ */
+export { uploadWithProgress } from './uploadWithProgress';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/upload/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/upload/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/api/upload/node.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Node.js Upload Implementation
+ */
+import type { UploadWithProgressOptions, UploadWithProgressResult } from '@plyaz/types/api';
+/**
+ * Execute upload with retry logic for Node.js
+ */
+export declare function uploadWithProgressNode(options: UploadWithProgressOptions): Promise<UploadWithProgressResult>;
+//# sourceMappingURL=node.d.ts.map

package/dist/api/upload/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/api/upload/node.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EAIzB,MAAM,kBAAkB,CAAC;AAwJ1B;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CA2CnC"}

package/dist/api/upload/retry.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Upload Retry Helpers
+ */
+import type { RetryConfig, UploadWithProgressResult, MergedUploadConfig, RetryContext, RetryErrorParams } from '@plyaz/types/api';
+/**
+ * Check if an error is retryable based on error type or HTTP status
+ * Uses patterns consistent with BaseError.isRetryable() and notifications retry logic
+ */
+export declare function isRetryableError(error: Error, status?: number): boolean;
+/**
+ * Calculate delay for retry attempt with exponential backoff
+ */
+export declare function calculateRetryDelay(attempt: number, config: RetryConfig): number;
+/**
+ * Handle retry error notification
+ */
+export declare function notifyRetryError(params: RetryErrorParams): void;
+/**
+ * Handle final error notification
+ */
+export declare function notifyFinalError(ctx: RetryContext, error: Error): void;
+/**
+ * Check if we should retry a failed result
+ */
+export declare function shouldRetryResult(result: UploadWithProgressResult, config: MergedUploadConfig, attempt: number, maxAttempts: number): boolean;
+/**
+ * Check if we should retry an error
+ */
+export declare function shouldRetryError(error: Error, config: MergedUploadConfig, attempt: number, maxAttempts: number): boolean;
+/**
+ * Handle retry delay
+ */
+export declare function handleRetryDelay(attempt: number, config: RetryConfig): Promise<void>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/api/upload/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/api/upload/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,wBAAwB,EACxB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AA4C1B;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAYvE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAMhF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAa/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAUtE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,wBAAwB,EAChC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAMT;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAIT;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1F"}

package/dist/api/upload/uploadWithProgress.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Upload with Progress Tracking
+ *
+ * Cross-platform upload helper that provides real-time progress events.
+ * - Node.js: Uses http/https modules with chunked writes
+ * - Browser: Uses XMLHttpRequest with progress events
+ *
+ * Integrates with @plyaz/api global configuration:
+ * - Automatically merges global headers (auth, etc.)
+ * - Uses global timeout, baseURL, retry, onError, withCredentials
+ * - Respects API client configuration
+ */
+import type { UploadWithProgressOptions, UploadWithProgressResult } from '@plyaz/types/api';
+/**
+ * Upload data to a URL with progress tracking
+ *
+ * Automatically selects the appropriate implementation:
+ * - Node.js: Uses http/https modules with chunked writes
+ * - Browser: Uses XMLHttpRequest with progress events
+ *
+ * @param options - Upload options
+ * @returns Promise resolving to upload result
+ *
+ * @example
+ * ```typescript
+ * const result = await uploadWithProgress({
+ *   url: 'https://storage.example.com/upload',
+ *   data: fileBuffer,
+ *   contentType: 'application/pdf',
+ *   onProgress: (event) => {
+ *     console.log(`${event.percentage}% - ${event.speed} bytes/s`);
+ *   },
+ * });
+ *
+ * if (result.success) {
+ *   console.log('Upload complete!');
+ * }
+ * ```
+ */
+export declare function uploadWithProgress(options: UploadWithProgressOptions): Promise<UploadWithProgressResult>;
+//# sourceMappingURL=uploadWithProgress.d.ts.map

package/dist/api/upload/uploadWithProgress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploadWithProgress.d.ts","sourceRoot":"","sources":["../../../src/api/upload/uploadWithProgress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAK5F;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CAKnC"}

package/dist/api/upload/utils.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Upload Utility Functions
+ */
+import type { UploadProgressEvent, UploadState } from '@plyaz/types/api';
+/**
+ * Resolve URL with baseURL if provided
+ */
+export declare function resolveUrl(url: string, baseURL?: string): string;
+/**
+ * Convert data to Buffer (Node.js) or ensure it's usable
+ */
+export declare function normalizeData(data: Buffer | Blob | ArrayBuffer | Uint8Array): Buffer | Uint8Array;
+/**
+ * Create initial upload state
+ */
+export declare function createUploadState(totalSize: number): UploadState;
+/**
+ * Calculate progress metrics
+ */
+export declare function calculateProgress(state: UploadState): UploadProgressEvent;
+/**
+ * Emit final progress event
+ */
+export declare function emitFinalProgress(onProgress: ((event: UploadProgressEvent) => void) | undefined, totalSize: number, startTime: number): void;
+/**
+ * Check if progress should be emitted based on throttling
+ */
+export declare function shouldEmitProgress(state: UploadState, totalSize: number, throttleMs: number): boolean;
+/**
+ * Parse response headers from Node.js response
+ */
+export declare function parseNodeHeaders(headers: Record<string, string | string[] | undefined>): Record<string, string>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/api/upload/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/api/upload/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAKzE;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAUhE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,CASjG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAUhE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,mBAAmB,CAiBzE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,CAAC,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC,GAAG,SAAS,EAC9D,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,IAAI,CAUN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAaT;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GACrD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxB"}