@uploadista/client-core 0.0.3

package/dist/types/flow-upload-config.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Configuration for uploading a file through a flow pipeline.
+ *
+ * Flows enable processing uploaded files through a sequence of transformation
+ * nodes (e.g., image resize, format conversion, validation) before final storage.
+ *
+ * @example Basic flow upload
+ * ```typescript
+ * const config: FlowUploadConfig = {
+ *   flowId: 'image-optimization',
+ *   storageId: 'processed-images',
+ * };
+ *
+ * await client.uploadWithFlow(file, config, {
+ *   onProgress: (progress) => console.log(`${progress}%`),
+ *   onSuccess: (result) => console.log('Processed:', result),
+ * });
+ * ```
+ *
+ * @example With specific output node
+ * ```typescript
+ * const config: FlowUploadConfig = {
+ *   flowId: 'multi-format-conversion',
+ *   storageId: 'images',
+ *   outputNodeId: 'webp-output', // Get WebP version instead of first output
+ *   metadata: {
+ *     userId: '123',
+ *     album: 'vacation-2024',
+ *   },
+ * };
+ * ```
+ */
+export type FlowUploadConfig = {
+    /** Unique identifier of the flow to execute */
+    flowId: string;
+    /** Storage backend where flow outputs will be saved */
+    storageId: string;
+    /**
+     * Specify which output node to use for single-value callbacks like onSuccess.
+     *
+     * For flows with multiple output nodes, this determines which output
+     * is passed to the onSuccess callback. If not specified, uses the first
+     * output node. The onFlowComplete callback receives all outputs regardless.
+     */
+    outputNodeId?: string;
+    /**
+     * Additional metadata to attach to the upload and flow execution.
+     *
+     * This metadata is stored with the upload and can be used for tracking,
+     * filtering, or providing context to flow nodes.
+     */
+    metadata?: Record<string, string>;
+};
+//# sourceMappingURL=flow-upload-config.d.ts.map

package/dist/types/flow-upload-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-upload-config.d.ts","sourceRoot":"","sources":["../../src/types/flow-upload-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IAEf,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,CAAC"}

package/dist/types/flow-upload-config.js

@@ -0,0 +1 @@
+export {};

package/dist/types/flow-upload-item.d.ts

@@ -0,0 +1,16 @@
+import type { UploadFile } from "@uploadista/core";
+/**
+ * Flow upload item for multi-flow-upload tracking
+ */
+export interface FlowUploadItem<UploadInput> {
+    id: string;
+    file: UploadInput;
+    status: "pending" | "uploading" | "success" | "error" | "aborted";
+    progress: number;
+    bytesUploaded: number;
+    totalBytes: number;
+    error: Error | null;
+    result: UploadFile | null;
+    jobId: string | null;
+}
+//# sourceMappingURL=flow-upload-item.d.ts.map

package/dist/types/flow-upload-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-upload-item.d.ts","sourceRoot":"","sources":["../../src/types/flow-upload-item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,WAAW;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB"}

package/dist/types/flow-upload-item.js

@@ -0,0 +1 @@
+export {};

package/dist/types/flow-upload-options.d.ts

@@ -0,0 +1,41 @@
+import type { UploadFile } from "@uploadista/core/types";
+import type { FlowUploadConfig } from "./flow-upload-config";
+export interface FlowUploadOptions<TOutput = UploadFile> {
+    /**
+     * Flow configuration
+     */
+    flowConfig: FlowUploadConfig;
+    /**
+     * Called when upload progress updates
+     */
+    onProgress?: (progress: number, bytesUploaded: number, totalBytes: number | null) => void;
+    /**
+     * Called when a chunk completes
+     */
+    onChunkComplete?: (chunkSize: number, bytesAccepted: number, bytesTotal: number | null) => void;
+    /**
+     * Called when the flow completes successfully (receives full flow outputs)
+     * This is the recommended callback for multi-output flows
+     * Format: { [outputNodeId]: result, ... }
+     */
+    onFlowComplete?: (outputs: Record<string, unknown>) => void;
+    /**
+     * Called when upload succeeds (legacy, single-output flows)
+     * For single-output flows, receives the value from the specified outputNodeId
+     * or the first output node if outputNodeId is not specified
+     */
+    onSuccess?: (result: TOutput) => void;
+    /**
+     * Called when upload fails
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Called when upload is aborted
+     */
+    onAbort?: () => void;
+    /**
+     * Custom retry logic
+     */
+    onShouldRetry?: (error: Error, retryAttempt: number) => boolean;
+}
+//# sourceMappingURL=flow-upload-options.d.ts.map

package/dist/types/flow-upload-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-upload-options.d.ts","sourceRoot":"","sources":["../../src/types/flow-upload-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,WAAW,iBAAiB,CAAC,OAAO,GAAG,UAAU;IACrD;;OAEG;IACH,UAAU,EAAE,gBAAgB,CAAC;IAE7B;;OAEG;IACH,UAAU,CAAC,EAAE,CACX,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GAAG,IAAI,KACtB,IAAI,CAAC;IAEV;;OAEG;IACH,eAAe,CAAC,EAAE,CAChB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GAAG,IAAI,KACtB,IAAI,CAAC;IAEV;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAE5D;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAEtC;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEjC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;CACjE"}

package/dist/types/flow-upload-options.js

@@ -0,0 +1 @@
+export {};

package/dist/types/index.d.ts

@@ -0,0 +1,14 @@
+export * from "./chunk-metrics";
+export * from "./flow-result";
+export * from "./flow-upload-config";
+export * from "./flow-upload-item";
+export * from "./flow-upload-options";
+export * from "./multi-flow-upload-options";
+export * from "./multi-flow-upload-state";
+export * from "./performance-insights";
+export * from "./previous-upload";
+export * from "./upload-options";
+export * from "./upload-response";
+export * from "./upload-result";
+export * from "./upload-session-metrics";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,13 @@
+export * from "./chunk-metrics";
+export * from "./flow-result";
+export * from "./flow-upload-config";
+export * from "./flow-upload-item";
+export * from "./flow-upload-options";
+export * from "./multi-flow-upload-options";
+export * from "./multi-flow-upload-state";
+export * from "./performance-insights";
+export * from "./previous-upload";
+export * from "./upload-options";
+export * from "./upload-response";
+export * from "./upload-result";
+export * from "./upload-session-metrics";

package/dist/types/multi-flow-upload-options.d.ts

@@ -0,0 +1,33 @@
+import type { FlowUploadConfig } from "./flow-upload-config";
+import type { FlowUploadItem } from "./flow-upload-item";
+export interface MultiFlowUploadOptions<UploadInput> {
+    /**
+     * Flow configuration
+     */
+    flowConfig: FlowUploadConfig;
+    /**
+     * Maximum number of concurrent uploads (default: 3)
+     */
+    maxConcurrent?: number;
+    /**
+     * Called when an individual upload progresses
+     */
+    onItemProgress?: (item: FlowUploadItem<UploadInput>) => void;
+    /**
+     * Called when an individual upload succeeds
+     */
+    onItemSuccess?: (item: FlowUploadItem<UploadInput>) => void;
+    /**
+     * Called when an individual upload fails
+     */
+    onItemError?: (item: FlowUploadItem<UploadInput>, error: Error) => void;
+    /**
+     * Called when all uploads complete
+     */
+    onComplete?: (items: FlowUploadItem<UploadInput>[]) => void;
+    /**
+     * Custom retry logic
+     */
+    onShouldRetry?: (error: Error, retryAttempt: number) => boolean;
+}
+//# sourceMappingURL=multi-flow-upload-options.d.ts.map

package/dist/types/multi-flow-upload-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-flow-upload-options.d.ts","sourceRoot":"","sources":["../../src/types/multi-flow-upload-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,WAAW,sBAAsB,CAAC,WAAW;IACjD;;OAEG;IACH,UAAU,EAAE,gBAAgB,CAAC;IAE7B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAE7D;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAE5D;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAExE;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,WAAW,CAAC,EAAE,KAAK,IAAI,CAAC;IAE5D;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;CACjE"}

package/dist/types/multi-flow-upload-options.js

@@ -0,0 +1 @@
+export {};

package/dist/types/multi-flow-upload-state.d.ts

@@ -0,0 +1,9 @@
+import type { FlowUploadItem } from "./flow-upload-item";
+export interface MultiFlowUploadState<UploadInput> {
+    items: FlowUploadItem<UploadInput>[];
+    totalProgress: number;
+    activeUploads: number;
+    completedUploads: number;
+    failedUploads: number;
+}
+//# sourceMappingURL=multi-flow-upload-state.d.ts.map

package/dist/types/multi-flow-upload-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-flow-upload-state.d.ts","sourceRoot":"","sources":["../../src/types/multi-flow-upload-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,WAAW,oBAAoB,CAAC,WAAW;IAC/C,KAAK,EAAE,cAAc,CAAC,WAAW,CAAC,EAAE,CAAC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/dist/types/multi-flow-upload-state.js

@@ -0,0 +1 @@
+export {};

package/dist/types/performance-insights.d.ts

@@ -0,0 +1,11 @@
+export interface PerformanceInsights {
+    overallEfficiency: number;
+    chunkingEffectiveness: number;
+    networkStability: number;
+    recommendations: string[];
+    optimalChunkSizeRange: {
+        min: number;
+        max: number;
+    };
+}
+//# sourceMappingURL=performance-insights.d.ts.map

package/dist/types/performance-insights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance-insights.d.ts","sourceRoot":"","sources":["../../src/types/performance-insights.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,qBAAqB,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACrD"}

package/dist/types/performance-insights.js

@@ -0,0 +1 @@
+export {};

package/dist/types/previous-upload.d.ts

@@ -0,0 +1,20 @@
+import z from "zod";
+export type PreviousUpload = {
+    size: number | null;
+    metadata: {
+        [key: string]: string | number | boolean;
+    };
+    creationTime: string;
+    uploadId?: string;
+    parallelUploadUrls?: string[];
+    clientStorageKey: string;
+};
+export declare const previousUploadSchema: z.ZodObject<{
+    size: z.ZodNullable<z.ZodNumber>;
+    metadata: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+    creationTime: z.ZodString;
+    uploadId: z.ZodOptional<z.ZodString>;
+    parallelUploadUrls: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    clientStorageKey: z.ZodString;
+}, z.core.$strip>;
+//# sourceMappingURL=previous-upload.d.ts.map

package/dist/types/previous-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"previous-upload.d.ts","sourceRoot":"","sources":["../../src/types/previous-upload.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;iBAU/B,CAAC"}

package/dist/types/previous-upload.js

@@ -0,0 +1,9 @@
+import z from "zod";
+export const previousUploadSchema = z.object({
+    size: z.number().nullable(),
+    metadata: z.record(z.string(), z.union([z.string(), z.number(), z.boolean()])),
+    creationTime: z.string(),
+    uploadId: z.string().optional(),
+    parallelUploadUrls: z.array(z.string()).optional(),
+    clientStorageKey: z.string(),
+});

package/dist/types/upload-options.d.ts

@@ -0,0 +1,40 @@
+import type { UploadFile } from "@uploadista/core";
+export interface UploadOptions {
+    /**
+     * Upload metadata to attach to the file
+     */
+    metadata?: Record<string, string>;
+    /**
+     * Whether to defer the upload size calculation
+     */
+    uploadLengthDeferred?: boolean;
+    /**
+     * Manual upload size override
+     */
+    uploadSize?: number;
+    /**
+     * Called when upload progress updates
+     */
+    onProgress?: (progress: number, bytesUploaded: number, totalBytes: number | null) => void;
+    /**
+     * Called when a chunk completes
+     */
+    onChunkComplete?: (chunkSize: number, bytesAccepted: number, bytesTotal: number | null) => void;
+    /**
+     * Called when upload succeeds
+     */
+    onSuccess?: (result: UploadFile) => void;
+    /**
+     * Called when upload fails
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Called when upload is aborted
+     */
+    onAbort?: () => void;
+    /**
+     * Custom retry logic
+     */
+    onShouldRetry?: (error: Error, retryAttempt: number) => boolean;
+}
+//# sourceMappingURL=upload-options.d.ts.map

package/dist/types/upload-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-options.d.ts","sourceRoot":"","sources":["../../src/types/upload-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAElC;;OAEG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,UAAU,CAAC,EAAE,CACX,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GAAG,IAAI,KACtB,IAAI,CAAC;IAEV;;OAEG;IACH,eAAe,CAAC,EAAE,CAChB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GAAG,IAAI,KACtB,IAAI,CAAC;IAEV;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;IAEzC;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEjC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;CACjE"}

package/dist/types/upload-options.js

@@ -0,0 +1 @@
+export {};

package/dist/types/upload-response.d.ts

@@ -0,0 +1,6 @@
+import type { UploadFile } from "@uploadista/core";
+export type UploadResponse = {
+    upload?: UploadFile;
+    status: number;
+};
+//# sourceMappingURL=upload-response.d.ts.map

package/dist/types/upload-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-response.d.ts","sourceRoot":"","sources":["../../src/types/upload-response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/dist/types/upload-response.js

@@ -0,0 +1 @@
+export {};

package/dist/types/upload-result.d.ts

@@ -0,0 +1,57 @@
+import type { UploadFile } from "@uploadista/core";
+/**
+ * Discriminated union representing the result of an upload operation.
+ *
+ * Provides a type-safe way to handle the three possible outcomes of an upload:
+ * success, error, or cancellation. This pattern enables exhaustive checking
+ * of all cases at compile time.
+ *
+ * @template TOutput - The type of the successful result value. Defaults to UploadFile
+ *
+ * @example Handling upload results
+ * ```typescript
+ * function handleUploadResult(result: UploadResult) {
+ *   switch (result.type) {
+ *     case 'success':
+ *       console.log('Upload complete:', result.value.id);
+ *       break;
+ *     case 'error':
+ *       console.error('Upload failed:', result.error.message);
+ *       break;
+ *     case 'cancelled':
+ *       console.log('Upload was cancelled by user');
+ *       break;
+ *   }
+ * }
+ * ```
+ *
+ * @example With custom output type
+ * ```typescript
+ * interface ProcessedImage {
+ *   url: string;
+ *   width: number;
+ *   height: number;
+ * }
+ *
+ * const result: UploadResult<ProcessedImage> = await uploadAndProcess(file);
+ *
+ * if (result.type === 'success') {
+ *   console.log(`Image processed: ${result.value.width}x${result.value.height}`);
+ * }
+ * ```
+ */
+export type UploadResult<TOutput = UploadFile> = {
+    /** Indicates the upload completed successfully */
+    type: "success";
+    /** The successful result value (e.g., upload metadata or processed output) */
+    value: TOutput;
+} | {
+    /** Indicates the upload failed with an error */
+    type: "error";
+    /** The error that caused the upload to fail */
+    error: Error;
+} | {
+    /** Indicates the upload was cancelled by the user or application */
+    type: "cancelled";
+};
+//# sourceMappingURL=upload-result.d.ts.map

package/dist/types/upload-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-result.d.ts","sourceRoot":"","sources":["../../src/types/upload-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,MAAM,YAAY,CAAC,OAAO,GAAG,UAAU,IACzC;IACE,kDAAkD;IAClD,IAAI,EAAE,SAAS,CAAC;IAChB,8EAA8E;IAC9E,KAAK,EAAE,OAAO,CAAC;CAChB,GACD;IACE,gDAAgD;IAChD,IAAI,EAAE,OAAO,CAAC;IACd,+CAA+C;IAC/C,KAAK,EAAE,KAAK,CAAC;CACd,GACD;IACE,oEAAoE;IACpE,IAAI,EAAE,WAAW,CAAC;CACnB,CAAC"}

package/dist/types/upload-result.js

@@ -0,0 +1 @@
+export {};

package/dist/types/upload-session-metrics.d.ts

@@ -0,0 +1,16 @@
+export interface UploadSessionMetrics {
+    uploadId: string;
+    totalSize: number;
+    totalDuration: number;
+    chunksCompleted: number;
+    chunksTotal: number;
+    averageSpeed: number;
+    peakSpeed: number;
+    minSpeed: number;
+    totalRetries: number;
+    successRate: number;
+    adaptiveChunkingEnabled: boolean;
+    startTime: number;
+    endTime?: number;
+}
+//# sourceMappingURL=upload-session-metrics.d.ts.map

package/dist/types/upload-session-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-session-metrics.d.ts","sourceRoot":"","sources":["../../src/types/upload-session-metrics.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB,EAAE,OAAO,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/types/upload-session-metrics.js

@@ -0,0 +1 @@
+export {};

package/dist/upload/chunk-upload.d.ts

@@ -0,0 +1,40 @@
+import type { UploadistaApi } from "../client/uploadista-api";
+import { UploadistaError } from "../error";
+import type { Logger } from "../logger";
+import type { AbortControllerLike } from "../services";
+import type { FileSource } from "../services/file-reader-service";
+import type { PlatformService } from "../services/platform-service";
+import type { SmartChunker } from "../smart-chunker";
+import type { UploadResponse } from "../types/upload-response";
+export type OnProgress = (uploadId: string, bytesSent: number, bytesTotal: number | null) => void;
+export type OnShouldRetry = (error: UploadistaError, retryAttempt: number) => boolean;
+/**
+ * uploadChunk reads a chunk from the source and sends it using the
+ * supplied request object. It will not handle the response.
+ */
+export declare function uploadChunk({ uploadId, source, offset, uploadLengthDeferred, abortController, onProgress, smartChunker, uploadistaApi, logger, }: {
+    uploadId: string;
+    source: FileSource;
+    offset: number;
+    uploadLengthDeferred: boolean | undefined;
+    abortController: AbortControllerLike;
+    onProgress?: OnProgress;
+    smartChunker: SmartChunker;
+    uploadistaApi: UploadistaApi;
+    logger: Logger;
+}): Promise<UploadResponse>;
+/**
+ * Checks whether or not it is ok to retry a request.
+ * @param {UploadistaError} err the error returned from the last request
+ * @param {number} retryAttempt the number of times the request has already been retried
+ * @param {number[]} retryDelays configured retry delays
+ * @param {OnShouldRetry} onShouldRetry optional custom retry logic
+ */
+export declare function shouldRetry(platformService: PlatformService, err: UploadistaError, retryAttempt: number, retryDelays?: number[], onShouldRetry?: OnShouldRetry): boolean;
+/**
+ * determines if the request should be retried. Will only retry if not a status 4xx except a 409 or 423
+ * @param {UploadistaError} err
+ * @returns {boolean}
+ */
+export declare function defaultOnShouldRetry(platformService: PlatformService, err: UploadistaError): boolean;
+//# sourceMappingURL=chunk-upload.d.ts.map

package/dist/upload/chunk-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-upload.d.ts","sourceRoot":"","sources":["../../src/upload/chunk-upload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D,MAAM,MAAM,UAAU,GAAG,CACvB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GAAG,IAAI,KACtB,IAAI,CAAC;AAEV,MAAM,MAAM,aAAa,GAAG,CAC1B,KAAK,EAAE,eAAe,EACtB,YAAY,EAAE,MAAM,KACjB,OAAO,CAAC;AAEb;;;GAGG;AACH,wBAAsB,WAAW,CAAC,EAChC,QAAQ,EACR,MAAM,EACN,MAAM,EACN,oBAAoB,EACpB,eAAe,EACf,UAAU,EACV,YAAY,EACZ,aAAa,EACb,MAAM,GACP,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C,eAAe,EAAE,mBAAmB,CAAC;IACrC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,cAAc,CAAC,CA4D1B;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,eAAe,EAAE,eAAe,EAChC,GAAG,EAAE,eAAe,EACpB,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAcT;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,eAAe,EAChC,GAAG,EAAE,eAAe,GACnB,OAAO,CAMT"}

package/dist/upload/chunk-upload.js

@@ -0,0 +1,82 @@
+import { UploadistaError } from "../error";
+import { inStatusCategory } from "./upload-utils";
+/**
+ * uploadChunk reads a chunk from the source and sends it using the
+ * supplied request object. It will not handle the response.
+ */
+export async function uploadChunk({ uploadId, source, offset, uploadLengthDeferred, abortController, onProgress, smartChunker, uploadistaApi, logger, }) {
+    const start = offset ?? 0;
+    const remainingBytes = source.size ? source.size - start : undefined;
+    const chunkSizeDecision = smartChunker.getNextChunkSize(remainingBytes);
+    const currentChunkSize = chunkSizeDecision.size;
+    let end = start + currentChunkSize;
+    // The specified chunkSize may be Infinity or the calcluated end position
+    // may exceed the file's size. In both cases, we limit the end position to
+    // the input's total size for simpler calculations and correctness.
+    if (source.size &&
+        (end === Number.POSITIVE_INFINITY || end > source.size) &&
+        !uploadLengthDeferred) {
+        end = source.size;
+    }
+    const { value, size, done } = await source.slice(start, end);
+    const sizeOfValue = size ?? 0;
+    const chunkStartTime = Date.now();
+    // If the upload length is deferred, the upload size was not specified during
+    // upload creation. So, if the file reader is done reading, we know the total
+    // upload size and can tell the tus server.
+    if (uploadLengthDeferred && done) {
+        source.size = offset + sizeOfValue;
+    }
+    // The specified uploadSize might not match the actual amount of data that a source
+    // provides. In these cases, we cannot successfully complete the upload, so we
+    // rather error out and let the user know. If not, tus-js-client will be stuck
+    // in a loop of repeating empty PATCH requests.
+    // See https://community.transloadit.com/t/how-to-abort-hanging-companion-uploads/16488/13
+    const newSize = offset + sizeOfValue;
+    if (!uploadLengthDeferred && done && newSize !== source.size) {
+        throw new UploadistaError({
+            name: "WRONG_UPLOAD_SIZE",
+            message: `upload was configured with a size of ${size} bytes, but the source is done after ${newSize} bytes`,
+        });
+    }
+    const result = await uploadistaApi.uploadChunk(uploadId, value, {
+        onProgress: (bytes, total) => {
+            onProgress?.(uploadId, bytes, total);
+        },
+        abortController,
+    });
+    // Record performance metrics
+    const chunkDuration = Date.now() - chunkStartTime;
+    const success = result.status >= 200 && result.status < 300;
+    smartChunker.recordChunkResult(sizeOfValue, chunkDuration, success);
+    logger.log(`Chunk upload ${success ? "succeeded" : "failed"}: ${sizeOfValue} bytes in ${chunkDuration}ms (${chunkSizeDecision.strategy} strategy)`);
+    return result;
+}
+/**
+ * Checks whether or not it is ok to retry a request.
+ * @param {UploadistaError} err the error returned from the last request
+ * @param {number} retryAttempt the number of times the request has already been retried
+ * @param {number[]} retryDelays configured retry delays
+ * @param {OnShouldRetry} onShouldRetry optional custom retry logic
+ */
+export function shouldRetry(platformService, err, retryAttempt, retryDelays, onShouldRetry) {
+    if (retryDelays == null ||
+        retryAttempt >= retryDelays.length ||
+        !err.isNetworkError()) {
+        return false;
+    }
+    if (onShouldRetry) {
+        return onShouldRetry(err, retryAttempt);
+    }
+    return defaultOnShouldRetry(platformService, err);
+}
+/**
+ * determines if the request should be retried. Will only retry if not a status 4xx except a 409 or 423
+ * @param {UploadistaError} err
+ * @returns {boolean}
+ */
+export function defaultOnShouldRetry(platformService, err) {
+    const status = err.status ?? 0;
+    return ((!inStatusCategory(status, 400) || status === 409 || status === 423) &&
+        platformService.isOnline());
+}

package/dist/upload/flow-upload.d.ts

@@ -0,0 +1,48 @@
+import type { UploadFile } from "@uploadista/core/types";
+import type { UploadistaApi } from "../client/uploadista-api";
+import type { Logger } from "../logger";
+import type { AbortControllerLike } from "../services";
+import type { FileSource } from "../services/file-reader-service";
+import type { PlatformService, Timeout } from "../services/platform-service";
+import type { SmartChunker, SmartChunkerConfig } from "../smart-chunker";
+import type { FlowUploadConfig } from "../types/flow-upload-config";
+import type { Callbacks } from "./single-upload";
+import type { UploadMetrics } from "./upload-metrics";
+/**
+ * Start a flow-based upload by initializing the streaming input node
+ */
+export declare function startFlowUpload({ source, flowConfig, uploadistaApi, logger, platformService, openWebSocket, closeWebSocket, ...callbacks }: {
+    source: FileSource;
+    flowConfig: FlowUploadConfig;
+    uploadistaApi: UploadistaApi;
+    logger: Logger;
+    platformService: PlatformService;
+    openWebSocket: (jobId: string) => void;
+    closeWebSocket: (jobId: string) => void;
+} & Callbacks): Promise<{
+    jobId: string;
+    uploadFile: UploadFile;
+    inputNodeId: string;
+} | undefined>;
+/**
+ * Upload chunks directly to the upload API (not through continueFlow)
+ * This is more efficient and reuses the existing upload infrastructure
+ */
+export declare function performFlowUpload({ jobId, uploadFile, inputNodeId, offset, source, retryAttempt, abortController, retryDelays, smartChunker, uploadistaApi, logger, smartChunking, metrics, platformService, onRetry, ...callbacks }: {
+    jobId: string;
+    uploadFile: UploadFile;
+    inputNodeId: string;
+    offset: number;
+    retryAttempt?: number;
+    source: FileSource;
+    abortController: AbortControllerLike;
+    retryDelays: number[] | undefined;
+    smartChunker: SmartChunker;
+    uploadistaApi: UploadistaApi;
+    logger: Logger;
+    smartChunking?: SmartChunkerConfig;
+    metrics: UploadMetrics;
+    platformService: PlatformService;
+    onRetry?: (timeout: Timeout) => void;
+} & Callbacks): Promise<void>;
+//# sourceMappingURL=flow-upload.d.ts.map

package/dist/upload/flow-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-upload.d.ts","sourceRoot":"","sources":["../../src/upload/flow-upload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAGpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD;;GAEG;AACH,wBAAsB,eAAe,CAAC,EACpC,MAAM,EACN,UAAU,EACV,aAAa,EACb,MAAM,EACN,eAAe,EACf,aAAa,EACb,cAAc,EACd,GAAG,SAAS,EACb,EAAE;IACD,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,aAAa,EAAE,aAAa,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,eAAe,CAAC;IACjC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC,GAAG,SAAS,GAAG,OAAO,CACrB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,UAAU,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAC3E,CA0GA;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,EACtC,KAAK,EACL,UAAU,EACV,WAAW,EACX,MAAM,EACN,MAAM,EACN,YAAgB,EAChB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,aAAa,EACb,MAAM,EACN,aAAa,EACb,OAAO,EACP,eAAe,EACf,OAAO,EACP,GAAG,SAAS,EACb,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,UAAU,CAAC;IACnB,eAAe,EAAE,mBAAmB,CAAC;IACrC,WAAW,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAClC,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,OAAO,EAAE,aAAa,CAAC;IACvB,eAAe,EAAE,eAAe,CAAC;IACjC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACtC,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAwL5B"}