@trustgraph/react-state 1.5.2 → 1.5.3

package/dist/state/chunked-download.d.ts

@@ -0,0 +1,56 @@
+export type DownloadStatus = "idle" | "downloading" | "completed" | "error" | "cancelled";
+export interface DownloadProgress {
+    /** Total number of chunks (known after first chunk arrives) */
+    totalChunks: number;
+    /** Number of chunks received */
+    chunksReceived: number;
+    /** Download percentage (0-100) */
+    percentage: number;
+    /** Current download status */
+    status: DownloadStatus;
+    /** Error message if status is 'error' */
+    error?: string;
+    /** Document ID being downloaded */
+    documentId?: string;
+}
+export interface ChunkedDownloadOptions {
+    /** Chunk size in bytes (default: 1MB) */
+    chunkSize?: number;
+    /** Progress callback for real-time updates */
+    onProgress?: (progress: DownloadProgress) => void;
+    /** Called when download completes with the Blob */
+    onComplete?: (blob: Blob, documentId: string) => void;
+    /** Called on error */
+    onError?: (error: string) => void;
+}
+export interface DownloadParams {
+    /** Document ID to download */
+    documentId: string;
+    /** Optional MIME type for the resulting Blob (default: application/octet-stream) */
+    mimeType?: string;
+    /** Optional filename for browser download (if not provided, returns Blob only) */
+    filename?: string;
+}
+/**
+ * Hook for managing streamed document downloads with progress tracking
+ *
+ * Features:
+ * - Streams large documents via WebSocket streaming response
+ * - Progress tracking (chunks received, percentage)
+ * - Cancel support
+ * - Returns Blob or triggers browser download
+ *
+ * @param options - Configuration options for the download
+ * @returns Download state and control methods
+ */
+export declare const useChunkedDownload: (options?: ChunkedDownloadOptions) => {
+    progress: DownloadProgress;
+    download: (params: DownloadParams) => Promise<Blob | null>;
+    cancel: () => void;
+    reset: () => void;
+    isIdle: boolean;
+    isDownloading: boolean;
+    isCompleted: boolean;
+    isError: boolean;
+};
+//# sourceMappingURL=chunked-download.d.ts.map

package/dist/state/chunked-download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunked-download.d.ts","sourceRoot":"","sources":["../../src/state/chunked-download.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,aAAa,GACb,WAAW,GACX,OAAO,GACP,WAAW,CAAC;AAEhB,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,MAAM,EAAE,cAAc,CAAC;IACvB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClD,mDAAmD;IACnD,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,sBAAsB;IACtB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA4BD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,GAAI,UAAS,sBAA2B;;uBAwC1D,cAAc,KAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;;;;;;;CA2JjD,CAAC"}

package/dist/state/chunked-upload.d.ts

@@ -0,0 +1,84 @@
+export type UploadStatus = "idle" | "preparing" | "uploading" | "paused" | "completing" | "completed" | "error" | "cancelled";
+export interface UploadProgress {
+    /** Total bytes to upload */
+    totalBytes: number;
+    /** Bytes uploaded so far */
+    bytesUploaded: number;
+    /** Upload percentage (0-100) */
+    percentage: number;
+    /** Total number of chunks */
+    totalChunks: number;
+    /** Number of chunks uploaded */
+    chunksUploaded: number;
+    /** Indices of chunks still pending */
+    pendingChunks: number[];
+    /** Current upload status */
+    status: UploadStatus;
+    /** Error message if status is 'error' */
+    error?: string;
+    /** Upload ID from server (for resume) */
+    uploadId?: string;
+    /** Document ID after completion */
+    documentId?: string;
+}
+export interface ChunkedUploadOptions {
+    /** Chunk size in bytes (default: 5MB) */
+    chunkSize?: number;
+    /** Number of parallel chunk uploads (default: 3) */
+    parallelUploads?: number;
+    /** Progress callback for real-time updates */
+    onProgress?: (progress: UploadProgress) => void;
+    /** Called when upload completes successfully */
+    onComplete?: (documentId: string) => void;
+    /** Called on error */
+    onError?: (error: string) => void;
+}
+export interface ChunkedUploadParams {
+    /** File to upload */
+    file: File;
+    /** Document title */
+    title: string;
+    /** Optional comments/description */
+    comments?: string;
+    /** Optional tags for categorization */
+    tags?: string[];
+    /** Optional collection name */
+    collection?: string;
+    /** Optional document ID (auto-generated if not provided) */
+    documentId?: string;
+}
+export interface ResumeUploadParams {
+    /** Upload ID from a previous session */
+    uploadId: string;
+    /** File to resume uploading (must match original) */
+    file: File;
+}
+/**
+ * Hook for managing chunked document uploads with progress tracking
+ *
+ * Features:
+ * - Automatic chunking of large files
+ * - Parallel chunk uploads for performance
+ * - Progress tracking (bytes, percentage, chunks)
+ * - Pause/resume support
+ * - Cancel support
+ * - Resumability after interruption
+ *
+ * @param options - Configuration options for the upload
+ * @returns Upload state and control methods
+ */
+export declare const useChunkedUpload: (options?: ChunkedUploadOptions) => {
+    progress: UploadProgress;
+    upload: (params: ChunkedUploadParams) => Promise<string | null>;
+    resume: (params: ResumeUploadParams) => Promise<string | null>;
+    pause: () => void;
+    unpause: () => void;
+    cancel: () => Promise<void>;
+    reset: () => void;
+    isIdle: boolean;
+    isUploading: boolean;
+    isPaused: boolean;
+    isCompleted: boolean;
+    isError: boolean;
+};
+//# sourceMappingURL=chunked-upload.d.ts.map

package/dist/state/chunked-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunked-upload.d.ts","sourceRoot":"","sources":["../../src/state/chunked-upload.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,WAAW,GACX,WAAW,GACX,QAAQ,GACR,YAAY,GACZ,WAAW,GACX,OAAO,GACP,WAAW,CAAC;AAEhB,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,4BAA4B;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAChD,gDAAgD;IAChD,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,sBAAsB;IACtB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,qBAAqB;IACrB,IAAI,EAAE,IAAI,CAAC;IACX,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,IAAI,EAAE,IAAI,CAAC;CACZ;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,GAAI,UAAS,oBAAyB;;qBAsIhD,mBAAmB,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;qBAiH5C,kBAAkB,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;;;;;;;;;;CAuL7D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trustgraph/react-state",
-  "version": "1.5.2",
+  "version": "1.5.3",
   "description": "React state management hooks for TrustGraph applications",
   "type": "module",
   "main": "dist/index.cjs",