@plyaz/types 1.39.6 → 1.40.0

package/dist/core/hooks/files/progress.d.ts

@@ -0,0 +1,68 @@
+/**
+ * File Progress Hook Types
+ *
+ * Types for useAllFileProgress and useHasActiveFileOperations hooks.
+ */
+/**
+ * Operation type for file progress tracking
+ */
+export type CoreFileOperationType = 'upload' | 'download' | 'generate';
+/**
+ * Status for file operations
+ */
+export type CoreFileOperationStatus = 'pending' | 'uploading' | 'downloading' | 'processing' | 'generating' | 'completed' | 'failed' | 'cancelled';
+/**
+ * Unified file progress item from useAllFileProgress hook.
+ * Normalizes upload, download, and generate progress into a single format.
+ */
+export interface CoreFileProgressItem {
+    /** Unique identifier (fileId for upload/download, templateId for generate) */
+    id: string;
+    /** Type of operation */
+    type: CoreFileOperationType;
+    /** Progress percentage (0-100) */
+    percentage: number;
+    /** Bytes loaded (for upload/download) */
+    loaded: number;
+    /** Total bytes (for upload/download) */
+    total: number;
+    /** Current status */
+    status: CoreFileOperationStatus;
+    /** Filename if available */
+    filename?: string;
+    /** Error message if failed */
+    error?: string;
+    /** Timestamp when operation started */
+    startedAt?: string;
+}
+/**
+ * Options for useAllFileProgress hook
+ */
+export interface CoreAllFileProgressOptions {
+    /** Filter to only show progress for specific IDs */
+    filterByIds?: string[];
+    /** Include completed operations (default: false) */
+    includeCompleted?: boolean;
+    /** Include failed operations (default: true) */
+    includeFailed?: boolean;
+    /** Filter by operation type */
+    types?: CoreFileOperationType[];
+}
+/**
+ * Return type for useAllFileProgress hook
+ */
+export interface CoreAllFileProgressResult {
+    /** All active progress items */
+    items: CoreFileProgressItem[];
+    /** Count by operation type */
+    counts: {
+        upload: number;
+        download: number;
+        generate: number;
+        total: number;
+    };
+    /** Whether any operations are active */
+    hasActive: boolean;
+    /** Overall progress percentage across all operations */
+    overallPercentage: number;
+}

package/dist/core/hooks/files/upload.d.ts

@@ -0,0 +1,97 @@
+/**
+ * File Upload Hook Types
+ *
+ * Types for useFileUpload hook.
+ * Uses Pick to extend from existing API types where applicable.
+ */
+import type { UploadFileRequest, GenerateDocumentRequest } from '../../../api';
+/**
+ * Options for useFileUpload hook - direct file upload
+ *
+ * Note: Progress is tracked via streams (useUploadProgress, useOverallUploadProgress).
+ * Errors propagate to global error handling (error boundaries, global error store).
+ * Results are returned from the Promise - no callbacks needed.
+ */
+export interface CoreFileUploadOptions {
+    /** Entity type for file organization */
+    entityType?: string;
+    /** Entity ID for file organization */
+    entityId?: string;
+    /** File category */
+    category?: string;
+    /** Whether file is public */
+    isPublic?: boolean;
+}
+/**
+ * Options for template-based upload (generate document and upload to storage)
+ * Extended from UploadFileRequest API type for consistency.
+ */
+export interface CoreTemplateUploadOptions extends Required<Pick<UploadFileRequest, 'templateId'>>, Pick<UploadFileRequest, 'templateData' | 'outputFormat' | 'locale' | 'pdfOptions'> {
+    /** Entity type for file organization (default: 'default') */
+    entityType?: string;
+    /** Entity ID for file organization (default: 'default') */
+    entityId?: string;
+    /** File category (default: 'documents') */
+    category?: string;
+}
+/**
+ * Options for generate-only (returns buffer, no upload)
+ * Extended from GenerateDocumentRequest API type for consistency.
+ */
+export interface CoreGenerateOptions extends Required<Pick<GenerateDocumentRequest, 'templateId'>>, Pick<GenerateDocumentRequest, 'templateData' | 'outputFormat' | 'locale' | 'pdfOptions'> {
+    /** Custom renderer name (optional) */
+    rendererName?: string;
+    /** Validation options */
+    validation?: {
+        enabled?: boolean;
+        strict?: boolean;
+    };
+}
+/**
+ * Options for bulk template upload (generate multiple documents and upload)
+ */
+export interface CoreBulkTemplateUploadOptions {
+    /** Array of template upload configs */
+    files: Array<CoreTemplateUploadOptions & {
+        /** Custom filename for this file */
+        filename?: string;
+        /** Custom mimeType override */
+        mimeType?: string;
+    }>;
+    /** Bulk upload options */
+    options?: {
+        /** Max concurrent uploads (default: 2) */
+        concurrency?: number;
+        /** Continue on error (default: true) */
+        continueOnError?: boolean;
+    };
+}
+/**
+ * Return type for useFileUpload hook
+ *
+ * Note: Errors propagate through global error handling (error boundaries,
+ * global error alert store). Results are returned from the Promise.
+ */
+export interface CoreFileUploadResult {
+    /** Upload a file directly */
+    upload: (file: File, options?: CoreFileUploadOptions) => Promise<unknown>;
+    /** Upload multiple files directly */
+    uploadMultiple: (files: File[], options?: CoreFileUploadOptions) => Promise<unknown[]>;
+    /** Generate document from template and upload to storage */
+    uploadFromTemplate: (options: CoreTemplateUploadOptions) => Promise<unknown>;
+    /** Generate multiple documents from templates and upload to storage */
+    uploadMultipleFromTemplate: (options: CoreBulkTemplateUploadOptions) => Promise<unknown[]>;
+    /** Generate document from template (no upload - returns buffer for client download) */
+    generate: (options: CoreGenerateOptions) => Promise<{
+        buffer: string;
+        size: number;
+    }>;
+    /** Whether currently uploading/generating */
+    isUploading: boolean;
+    /** Current upload IDs */
+    currentFileIds: string[];
+    /** Current progress percentage (overall for bulk) */
+    progress: number;
+    /** Cancel current uploads */
+    cancel: () => void;
+}

package/dist/core/hooks/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Core Hooks Types
+ *
+ * Types for composite hooks in @plyaz/core.
+ * Organized by domain (files, etc.).
+ */
+export type { CoreFileOperationType, CoreFileOperationStatus, CoreFileProgressItem, CoreAllFileProgressOptions, CoreAllFileProgressResult, CoreFileDownloadOptions, CoreFileDownloadResult, CoreFileUploadOptions, CoreTemplateUploadOptions, CoreGenerateOptions, CoreBulkTemplateUploadOptions, CoreFileUploadResult, CoreFileResult, CoreFileDeleteResult, } from './files';

package/dist/core/index.cjs

@@ -534,6 +534,55 @@ var SERVICE_KEYS = {
 };
 var ALL_SERVICE_KEYS = Object.values(SERVICE_KEYS);
 
+// src/core/frameworks/route-types.ts
+var DEFAULT_SUCCESS_MESSAGES = {
+  GET: "Retrieved successfully",
+  POST: "Created successfully",
+  PUT: "Updated successfully",
+  PATCH: "Updated successfully",
+  DELETE: "Deleted successfully",
+  OPTIONS: "Options retrieved",
+  HEAD: "Head retrieved"
+};
+
+// src/core/frameworks/file-types.ts
+var MIME_TYPE_EXTENSIONS = {
+  "application/pdf": "pdf",
+  "application/msword": "doc",
+  "application/vnd.openxmlformats-officedocument.wordprocessingml.document": "docx",
+  "application/vnd.ms-excel": "xls",
+  "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": "xlsx",
+  "application/vnd.ms-powerpoint": "ppt",
+  "application/vnd.openxmlformats-officedocument.presentationml.presentation": "pptx",
+  "application/json": "json",
+  "application/xml": "xml",
+  "application/zip": "zip",
+  "text/plain": "txt",
+  "text/html": "html",
+  "text/css": "css",
+  "text/csv": "csv",
+  "image/png": "png",
+  "image/jpeg": "jpg",
+  "image/gif": "gif",
+  "image/webp": "webp",
+  "image/svg+xml": "svg",
+  "audio/mpeg": "mp3",
+  "audio/wav": "wav",
+  "video/mp4": "mp4",
+  "video/webm": "webm"
+};
+var FILE_SIZE_UNITS = ["Bytes", "KB", "MB", "GB", "TB", "PB"];
+var BYTES_PER_KB = 1024;
+var FILE_SIZE_MULTIPLIERS = {
+  B: 1,
+  KB: BYTES_PER_KB,
+  MB: BYTES_PER_KB * BYTES_PER_KB,
+  GB: BYTES_PER_KB * BYTES_PER_KB * BYTES_PER_KB,
+  TB: BYTES_PER_KB * BYTES_PER_KB * BYTES_PER_KB * BYTES_PER_KB,
+  PB: BYTES_PER_KB * BYTES_PER_KB * BYTES_PER_KB * BYTES_PER_KB * BYTES_PER_KB,
+  BYTES: 1
+};
+
 exports.ALL_SERVICE_KEYS = ALL_SERVICE_KEYS;
 exports.APP_CONTEXTS = APP_CONTEXTS;
 exports.ApiEventAction = ApiEventAction;
@@ -545,6 +594,7 @@ exports.CoreEventScope = CoreEventScope;
 exports.CreateFilesSchema = CreateFilesSchema;
 exports.CreateMediaVariantSchema = CreateMediaVariantSchema;
 exports.DATABASE_FIELDS = DATABASE_FIELDS;
+exports.DEFAULT_SUCCESS_MESSAGES = DEFAULT_SUCCESS_MESSAGES;
 exports.DatabaseEventAction = DatabaseEventAction;
 exports.EVALUATION_REASONS = EVALUATION_REASONS;
 exports.EntityEventAction = EntityEventAction;
@@ -563,11 +613,14 @@ exports.FILES_STREAM_MESSAGE_TYPE = FILES_STREAM_MESSAGE_TYPE;
 exports.FILES_STREAM_PROGRESS_STATUS = FILES_STREAM_PROGRESS_STATUS;
 exports.FILES_STREAM_SUBTYPE = FILES_STREAM_SUBTYPE;
 exports.FILE_ACCESS_LEVELS = FILE_ACCESS_LEVELS;
+exports.FILE_SIZE_MULTIPLIERS = FILE_SIZE_MULTIPLIERS;
+exports.FILE_SIZE_UNITS = FILE_SIZE_UNITS;
 exports.FILE_TYPES = FILE_TYPES;
 exports.FRONTEND_RUNTIMES = FRONTEND_RUNTIMES;
 exports.FeatureFlagEventAction = FeatureFlagEventAction;
 exports.FileTypeSchema = FileTypeSchema;
 exports.FilesDatabaseRowSchema = FilesDatabaseRowSchema;
+exports.MIME_TYPE_EXTENSIONS = MIME_TYPE_EXTENSIONS;
 exports.MediaAccessLevelSchema = MediaAccessLevelSchema;
 exports.MediaTypeSchema = MediaTypeSchema;
 exports.MediaVariantsDatabaseRowSchema = MediaVariantsDatabaseRowSchema;