bytekit 0.1.12

package/dist/utils/helpers/EventEmitter.js

@@ -0,0 +1,208 @@
+/**
+ * Event emitter for pub/sub pattern
+ * Framework-agnostic event system
+ */
+/**
+ * Event emitter for pub/sub communication
+ */
+export class EventEmitter {
+    eventMap = new Map();
+    onceMap = new Map();
+    maxListeners;
+    captureRejections;
+    errorHandlers = new Set();
+    constructor(options = {}) {
+        this.maxListeners = options.maxListeners ?? 10;
+        this.captureRejections = options.captureRejections ?? false;
+    }
+    /**
+     * Register event listener
+     */
+    on(event, listener) {
+        if (!this.eventMap.has(event)) {
+            this.eventMap.set(event, new Set());
+        }
+        const handlers = this.eventMap.get(event);
+        if (handlers.size >= this.maxListeners) {
+            console.warn(`MaxListenersExceededWarning: ${handlers.size + 1} listeners added for event "${String(event)}"`);
+        }
+        handlers.add(listener);
+        return this;
+    }
+    /**
+     * Register one-time event listener
+     */
+    once(event, listener) {
+        if (!this.onceMap.has(event)) {
+            this.onceMap.set(event, new Set());
+        }
+        const onceListener = async (data) => {
+            await listener(data);
+            // Remove the wrapped listener from eventMap
+            const handlers = this.eventMap.get(event);
+            if (handlers) {
+                handlers.delete(onceListener);
+            }
+            // Remove from onceMap
+            const onceHandlers = this.onceMap.get(event);
+            if (onceHandlers) {
+                onceHandlers.delete(onceListener);
+            }
+        };
+        this.onceMap.get(event).add(onceListener);
+        return this.on(event, onceListener);
+    }
+    /**
+     * Remove event listener
+     */
+    off(event, listener) {
+        const handlers = this.eventMap.get(event);
+        if (handlers) {
+            handlers.delete(listener);
+        }
+        const onceHandlers = this.onceMap.get(event);
+        if (onceHandlers) {
+            onceHandlers.delete(listener);
+        }
+        return this;
+    }
+    /**
+     * Remove all listeners for event
+     */
+    removeAllListeners(event) {
+        if (event) {
+            this.eventMap.delete(event);
+            this.onceMap.delete(event);
+        }
+        else {
+            this.eventMap.clear();
+            this.onceMap.clear();
+        }
+        return this;
+    }
+    /**
+     * Emit event
+     */
+    async emit(event, data) {
+        const handlers = this.eventMap.get(event);
+        if (!handlers || handlers.size === 0) {
+            return false;
+        }
+        const promises = [];
+        for (const handler of handlers) {
+            try {
+                const result = handler(data);
+                if (result instanceof Promise) {
+                    promises.push(result);
+                }
+            }
+            catch (error) {
+                if (this.captureRejections) {
+                    this.handleError(error, data);
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+        if (promises.length > 0) {
+            try {
+                await Promise.all(promises);
+            }
+            catch (error) {
+                if (this.captureRejections) {
+                    this.handleError(error, data);
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+        return true;
+    }
+    /**
+     * Emit event synchronously
+     */
+    emitSync(event, data) {
+        const handlers = this.eventMap.get(event);
+        if (!handlers || handlers.size === 0) {
+            return false;
+        }
+        for (const handler of handlers) {
+            try {
+                handler(data);
+            }
+            catch (error) {
+                if (this.captureRejections) {
+                    this.handleError(error, data);
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+        return true;
+    }
+    /**
+     * Register error handler
+     */
+    onError(listener) {
+        this.errorHandlers.add(listener);
+        return this;
+    }
+    /**
+     * Handle error
+     */
+    handleError(error, data) {
+        for (const handler of this.errorHandlers) {
+            try {
+                handler(data, error);
+            }
+            catch {
+                // Ignore errors in error handlers
+            }
+        }
+    }
+    /**
+     * Get listener count for event
+     */
+    listenerCount(event) {
+        const handlers = this.eventMap.get(event);
+        return handlers ? handlers.size : 0;
+    }
+    /**
+     * Get all listeners for event
+     */
+    getListeners(event) {
+        const handlers = this.eventMap.get(event);
+        return handlers
+            ? Array.from(handlers)
+            : [];
+    }
+    /**
+     * Get all event names
+     */
+    eventNames() {
+        return Array.from(this.eventMap.keys());
+    }
+    /**
+     * Set max listeners
+     */
+    setMaxListeners(n) {
+        this.maxListeners = n;
+        return this;
+    }
+    /**
+     * Get max listeners
+     */
+    getMaxListeners() {
+        return this.maxListeners;
+    }
+}
+/**
+ * Factory function for creating event emitters
+ */
+export function createEventEmitter(options) {
+    return new EventEmitter(options);
+}
+//# sourceMappingURL=EventEmitter.js.map

package/dist/utils/helpers/EventEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventEmitter.js","sourceRoot":"","sources":["../../../src/utils/helpers/EventEmitter.ts"],"names":[],"mappings":"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"}

package/dist/utils/helpers/FileUploadHelper.d.ts

@@ -0,0 +1,44 @@
+export interface UploadProgress {
+    loaded: number;
+    total: number;
+    percentage: number;
+}
+export interface FileUploadOptions {
+    onProgress?: (progress: UploadProgress) => void;
+    chunkSize?: number;
+    maxRetries?: number;
+    timeout?: number;
+    headers?: Record<string, string>;
+}
+export interface UploadResponse {
+    success: boolean;
+    fileId?: string;
+    url?: string;
+    error?: string;
+}
+export declare class FileUploadHelper {
+    /**
+     * Upload a file with progress tracking and chunking support
+     */
+    static uploadFile(file: File | Blob, endpoint: string, options?: FileUploadOptions): Promise<UploadResponse>;
+    /**
+     * Upload a single chunk
+     */
+    private static uploadChunk;
+    /**
+     * Generate a unique upload ID
+     */
+    private static generateUploadId;
+    /**
+     * Validate file before upload
+     */
+    static validateFile(file: File, options?: {
+        maxSize?: number;
+        allowedTypes?: string[];
+        allowedExtensions?: string[];
+    }): {
+        valid: boolean;
+        error?: string;
+    };
+}
+//# sourceMappingURL=FileUploadHelper.d.ts.map

package/dist/utils/helpers/FileUploadHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileUploadHelper.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers/FileUploadHelper.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAC9B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,gBAAgB;IACzB;;OAEG;WACU,UAAU,CACnB,IAAI,EAAE,IAAI,GAAG,IAAI,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,iBAAsB,GAChC,OAAO,CAAC,cAAc,CAAC;IAsF1B;;OAEG;mBACkB,WAAW;IAgChC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAI/B;;OAEG;IACH,MAAM,CAAC,YAAY,CACf,IAAI,EAAE,IAAI,EACV,OAAO,GAAE;QACL,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;KAC3B,GACP;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;CAoCxC"}

package/dist/utils/helpers/FileUploadHelper.js

@@ -0,0 +1,127 @@
+export class FileUploadHelper {
+    /**
+     * Upload a file with progress tracking and chunking support
+     */
+    static async uploadFile(file, endpoint, options = {}) {
+        const { onProgress, chunkSize = 5 * 1024 * 1024, // 5MB default
+        maxRetries = 3, timeout = 30000, headers = {}, } = options;
+        const totalSize = file.size;
+        let uploadedSize = 0;
+        try {
+            // For small files, upload directly
+            if (totalSize <= chunkSize) {
+                await this.uploadChunk(file, endpoint, 0, totalSize, headers, timeout);
+                return {
+                    success: true,
+                    fileId: this.generateUploadId(),
+                };
+            }
+            // For large files, upload in chunks
+            const chunks = Math.ceil(totalSize / chunkSize);
+            const uploadId = this.generateUploadId();
+            for (let i = 0; i < chunks; i++) {
+                const start = i * chunkSize;
+                const end = Math.min(start + chunkSize, totalSize);
+                const chunk = file.slice(start, end);
+                let retries = 0;
+                let success = false;
+                while (retries < maxRetries && !success) {
+                    try {
+                        await this.uploadChunk(chunk, endpoint, i, chunks, { ...headers, "X-Upload-ID": uploadId }, timeout);
+                        success = true;
+                        uploadedSize = end;
+                        if (onProgress) {
+                            onProgress({
+                                loaded: uploadedSize,
+                                total: totalSize,
+                                percentage: Math.round((uploadedSize / totalSize) * 100),
+                            });
+                        }
+                    }
+                    catch (error) {
+                        retries++;
+                        if (retries >= maxRetries) {
+                            throw error;
+                        }
+                        // Exponential backoff
+                        await new Promise((resolve) => setTimeout(resolve, Math.pow(2, retries) * 1000));
+                    }
+                }
+            }
+            return {
+                success: true,
+                fileId: this.generateUploadId(),
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : "Upload failed",
+            };
+        }
+    }
+    /**
+     * Upload a single chunk
+     */
+    static async uploadChunk(chunk, endpoint, chunkIndex, totalChunks, headers, timeout) {
+        const formData = new FormData();
+        formData.append("file", chunk);
+        formData.append("chunkIndex", String(chunkIndex));
+        formData.append("totalChunks", String(totalChunks));
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        try {
+            const response = await fetch(endpoint, {
+                method: "POST",
+                body: formData,
+                headers,
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw new Error(`Upload failed with status ${response.status}`);
+            }
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Generate a unique upload ID
+     */
+    static generateUploadId() {
+        return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+    }
+    /**
+     * Validate file before upload
+     */
+    static validateFile(file, options = {}) {
+        const { maxSize = 100 * 1024 * 1024, // 100MB default
+        allowedTypes = [], allowedExtensions = [], } = options;
+        // Check file size
+        if (file.size > maxSize) {
+            return {
+                valid: false,
+                error: `File size exceeds maximum of ${maxSize / 1024 / 1024}MB`,
+            };
+        }
+        // Check MIME type
+        if (allowedTypes.length > 0 && !allowedTypes.includes(file.type)) {
+            return {
+                valid: false,
+                error: `File type ${file.type} is not allowed`,
+            };
+        }
+        // Check extension
+        if (allowedExtensions.length > 0) {
+            const extension = file.name.split(".").pop()?.toLowerCase();
+            if (!extension || !allowedExtensions.includes(extension)) {
+                return {
+                    valid: false,
+                    error: `File extension .${extension} is not allowed`,
+                };
+            }
+        }
+        return { valid: true };
+    }
+}
+//# sourceMappingURL=FileUploadHelper.js.map

package/dist/utils/helpers/FileUploadHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileUploadHelper.js","sourceRoot":"","sources":["../../../src/utils/helpers/FileUploadHelper.ts"],"names":[],"mappings":"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"}

package/dist/utils/helpers/FormUtils.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Form validation and management utilities
+ * Framework-agnostic form handling with built-in validators
+ */
+export type ValidatorFn<T = unknown> = (value: T) => boolean | string;
+export type AsyncValidatorFn<T = unknown> = (value: T) => Promise<boolean | string>;
+export interface FieldRule<T = unknown> {
+    required?: boolean | string;
+    minLength?: number | string;
+    maxLength?: number | string;
+    min?: number | string;
+    max?: number | string;
+    pattern?: RegExp | string;
+    email?: boolean | string;
+    url?: boolean | string;
+    custom?: ValidatorFn<T> | ValidatorFn<T>[];
+    asyncCustom?: AsyncValidatorFn<T> | AsyncValidatorFn<T>[];
+}
+export interface FieldError {
+    field: string;
+    message: string;
+    rule?: string;
+}
+export interface FormState<T extends Record<string, unknown> = Record<string, unknown>> {
+    values: T;
+    errors: Record<string, string>;
+    touched: Record<string, boolean>;
+    dirty: Record<string, boolean>;
+    isValidating: boolean;
+    isValid: boolean;
+}
+export interface FormConfig<T extends Record<string, unknown> = Record<string, unknown>> {
+    initialValues: T;
+    rules?: Record<keyof T, FieldRule>;
+    onSubmit?: (values: T) => void | Promise<void>;
+    onError?: (errors: FieldError[]) => void;
+    validateOnChange?: boolean;
+    validateOnBlur?: boolean;
+}
+/**
+ * Built-in validators
+ */
+export declare const Validators: {
+    required: (value: unknown, message?: string) => boolean | string;
+    minLength: (value: unknown, min: number, message?: string) => boolean | string;
+    maxLength: (value: unknown, max: number, message?: string) => boolean | string;
+    min: (value: unknown, min: number, message?: string) => boolean | string;
+    max: (value: unknown, max: number, message?: string) => boolean | string;
+    email: (value: unknown, message?: string) => boolean | string;
+    url: (value: unknown, message?: string) => boolean | string;
+    pattern: (value: unknown, pattern: RegExp, message?: string) => boolean | string;
+    match: (value: unknown, other: unknown, message?: string) => boolean | string;
+};
+/**
+ * Form validation and state management
+ */
+export declare class FormUtils<T extends Record<string, unknown> = Record<string, unknown>> {
+    private state;
+    private rules;
+    private config;
+    private validationTimeouts;
+    constructor(config: FormConfig<T>);
+    /**
+     * Get current form state
+     */
+    getState(): FormState<T>;
+    /**
+     * Get field value
+     */
+    getValue<K extends keyof T>(field: K): T[K];
+    /**
+     * Set field value
+     */
+    setValue<K extends keyof T>(field: K, value: T[K]): void;
+    /**
+     * Set multiple values
+     */
+    setValues(values: Partial<T>): void;
+    /**
+     * Mark field as touched
+     */
+    touchField<K extends keyof T>(field: K): void;
+    /**
+     * Reset form to initial state
+     */
+    reset(): void;
+    /**
+     * Validate single field
+     */
+    validateField<K extends keyof T>(field: K): Promise<string | null>;
+    /**
+     * Validate all fields
+     */
+    validate(): Promise<FieldError[]>;
+    /**
+     * Submit form
+     */
+    submit(): Promise<boolean>;
+    /**
+     * Get field error
+     */
+    getFieldError<K extends keyof T>(field: K): string;
+    /**
+     * Check if field has error
+     */
+    hasError<K extends keyof T>(field: K): boolean;
+    /**
+     * Check if field is touched
+     */
+    isTouched<K extends keyof T>(field: K): boolean;
+    /**
+     * Check if field is dirty
+     */
+    isDirty<K extends keyof T>(field: K): boolean;
+    /**
+     * Get all errors
+     */
+    getErrors(): Record<string, string>;
+    /**
+     * Clear field error
+     */
+    clearFieldError<K extends keyof T>(field: K): void;
+    /**
+     * Clear all errors
+     */
+    clearErrors(): void;
+    /**
+     * Serialize form data
+     */
+    serialize(): T;
+    /**
+     * Deserialize form data
+     */
+    deserialize(data: Partial<T>): void;
+    /**
+     * Create form binding for framework integration
+     */
+    createBinding<K extends keyof T>(field: K): {
+        value: T[K];
+        onChange: (value: T[K]) => void;
+        onBlur: () => void;
+        error: string;
+        touched: boolean;
+        dirty: boolean;
+    };
+    /**
+     * Create form bindings for all fields
+     */
+    createBindings(): Record<string, {
+        value: T[keyof T];
+        onChange: (value: T[keyof T]) => void;
+        onBlur: () => void;
+        error: string;
+        touched: boolean;
+        dirty: boolean;
+    }>;
+}
+/**
+ * Factory function for creating forms
+ */
+export declare function createForm<T extends Record<string, unknown> = Record<string, unknown>>(config: FormConfig<T>): FormUtils<T>;
+//# sourceMappingURL=FormUtils.d.ts.map

package/dist/utils/helpers/FormUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers/FormUtils.ts"],"names":[],"mappings":"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"}