bindra 2.0.0

package/dist/core/DataSource.d.ts

@@ -0,0 +1,272 @@
+import { EventEmitter } from './EventEmitter';
+import { MiddlewareManager } from './MiddlewareManager';
+import { type Signal } from './Observable';
+import { Validator, type FieldConfig } from './validation';
+export interface RetryConfig {
+    maxRetries?: number;
+    retryDelay?: number;
+    backoffMultiplier?: number;
+}
+export interface CacheConfig {
+    enabled: boolean;
+    ttl?: number;
+    maxSize?: number;
+}
+export interface PaginationConfig {
+    pageSize: number;
+    currentPage: number;
+    totalRecords?: number;
+    totalPages?: number;
+}
+export interface RealtimeConfig {
+    enabled: boolean;
+    url?: string;
+    reconnect?: boolean;
+    reconnectInterval?: number;
+}
+export interface SecurityConfig {
+    csrfToken?: string;
+    csrfHeader?: string;
+    sanitizeFields?: (keyof any)[];
+}
+export interface DataSourceConfig<T extends Record<string, any> = any> {
+    url?: string | null;
+    data?: T[] | null;
+    retry?: RetryConfig;
+    fields?: FieldConfig<T>[];
+    cache?: CacheConfig;
+    pageSize?: number;
+    realtime?: RealtimeConfig;
+    security?: SecurityConfig;
+}
+export interface Field {
+    name: string;
+    type: string;
+}
+export interface Permissions {
+    allowInsert?: boolean;
+    allowUpdate?: boolean;
+    allowDelete?: boolean;
+}
+export interface QueryOptions<T = any> {
+    filter?: ((record: T) => boolean) | object | null;
+    sort?: string | ((a: T, b: T) => number) | null;
+    limit?: number | null;
+}
+/**
+ * DataSource - Type-safe reactive data management with CRUD operations
+ *
+ * @template T - The type of records managed by this DataSource
+ *
+ * @example
+ * ```typescript
+ * interface User {
+ *   id: number;
+ *   name: string;
+ *   email: string;
+ * }
+ *
+ * const ds = new DataSource<User>({
+ *   data: [{ id: 1, name: 'Alice', email: 'alice@example.com' }]
+ * });
+ * ```
+ */
+export declare class DataSource<T extends Record<string, any> = any> extends EventEmitter {
+    url: string | null;
+    data: T[] | null;
+    fields: Field[];
+    fieldConfigs: FieldConfig<T>[];
+    validator: Validator<T> | null;
+    permissions: Permissions;
+    middleware: MiddlewareManager;
+    currentIndex: Signal<number>;
+    currentRecord: Signal<T | null>;
+    isLocal: boolean;
+    private retryConfig;
+    private cache;
+    private cacheConfig;
+    pagination: Signal<PaginationConfig>;
+    private ws?;
+    private realtimeConfig;
+    private securityConfig;
+    constructor({ url, data, retry, fields, cache, pageSize, realtime, security }?: DataSourceConfig<T>);
+    _initRemote(url: string): Promise<void>;
+    _initLocal(data: T[]): void;
+    /**
+     * Create a new record
+     *
+     * @param record - The record to create (can be partial)
+     * @returns Promise resolving to the created record
+     *
+     * @example
+     * ```typescript
+     * const newUser = await ds.create({
+     *   name: 'Alice',
+     *   email: 'alice@example.com'
+     * });
+     * ```
+     */
+    create(record: Partial<T>): Promise<T>;
+    /**
+     * Update an existing record
+     *
+     * @param key - The key/id of the record to update
+     * @param changes - Partial changes to apply
+     * @returns Promise resolving to the updated record
+     */
+    update(key: any, changes: Partial<T>): Promise<T>;
+    /**
+     * Delete a record
+     *
+     * @param key - The key/id of the record to delete
+     * @returns Promise resolving to the deleted record
+     */
+    delete(key: any): Promise<T>;
+    /**
+     * Create multiple records in a single operation
+     *
+     * @param records - Array of partial records to create
+     * @returns Promise resolving to array of created records
+     */
+    createBatch(records: Partial<T>[]): Promise<T[]>;
+    /**
+     * Update multiple records in a single operation
+     *
+     * @param updates - Array of { key, changes } objects
+     * @returns Promise resolving to array of updated records
+     */
+    updateBatch(updates: Array<{
+        key: any;
+        changes: Partial<T>;
+    }>): Promise<T[]>;
+    /**
+     * Delete multiple records in a single operation
+     *
+     * @param keys - Array of keys/ids to delete
+     * @returns Promise resolving to array of deleted records
+     */
+    deleteBatch(keys: any[]): Promise<T[]>;
+    /**
+     * Optimistic update - immediately update UI, rollback on error
+     *
+     * @param key - The key/id of the record to update
+     * @param changes - Partial changes to apply
+     * @returns Promise resolving to the updated record
+     */
+    updateOptimistic(key: any, changes: Partial<T>): Promise<T>;
+    /**
+     * Query records with filtering, sorting, and limiting
+     *
+     * @param options - Query options
+     * @returns Promise resolving to array of matching records
+     */
+    query({ filter, sort, limit }?: QueryOptions<T>): Promise<T[]>;
+    /**
+     * Find a record by its key (local mode only)
+     *
+     * @param key - The key/id to search for
+     * @returns The found record or undefined
+     */
+    findByKey(key: any): T | undefined;
+    /**
+     * Fetch with automatic retry and exponential backoff
+     *
+     * @param url - The URL to fetch
+     * @param options - Fetch options
+     * @returns Promise resolving to Response
+     */
+    private _fetchWithRetry;
+    next(): void;
+    prev(): void;
+    goto(index: number): void;
+    private getCacheKey;
+    /**
+     * Get a record from cache (internal use)
+     * @internal
+     */
+    getFromCache(key: any): T | null;
+    private setCache;
+    /**
+     * Clear all cached records
+     */
+    clearCache(): void;
+    /**
+     * Invalidate a specific cached record
+     */
+    invalidateCache(key: any): void;
+    /**
+     * Load a specific page of data
+     *
+     * @param page - Page number (1-indexed)
+     * @returns Array of records for the requested page
+     */
+    loadPage(page: number): Promise<T[]>;
+    /**
+     * Load the next page
+     */
+    nextPage(): Promise<T[]>;
+    /**
+     * Load the previous page
+     */
+    prevPage(): Promise<T[]>;
+    /**
+     * Set page size
+     */
+    setPageSize(size: number): void;
+    /**
+     * Connect to WebSocket for real-time updates
+     */
+    connectWebSocket(): void;
+    /**
+     * Handle incoming WebSocket messages
+     */
+    private handleRealtimeUpdate;
+    /**
+     * Disconnect WebSocket
+     */
+    disconnectWebSocket(): void;
+    /**
+     * Send a message through WebSocket
+     */
+    sendWebSocketMessage(message: any): void;
+    /**
+     * Sanitize string to prevent XSS attacks
+     */
+    private sanitize;
+    /**
+     * Sanitize a record's fields that are marked for sanitization
+     */
+    private sanitizeRecord;
+    /**
+     * Get headers with CSRF token if configured
+     */
+    private getSecurityHeaders;
+    /**
+     * Validate a single field
+     *
+     * @param fieldName - Name of the field to validate
+     * @param value - Value to validate
+     * @param record - Optional full record for context
+     * @returns Error message if invalid, null if valid
+     */
+    validateField(fieldName: keyof T, value: any, record?: Partial<T>): Promise<string | null>;
+    /**
+     * Validate a complete record
+     *
+     * @param record - Record to validate
+     * @returns Object with field errors, or null if valid
+     */
+    validateRecord(record: Partial<T>): Promise<Record<string, string> | null>;
+    /**
+     * Get field configuration by name
+     *
+     * @param name - Field name
+     * @returns Field configuration or undefined
+     */
+    getFieldConfig(name: keyof T): FieldConfig<T> | undefined;
+    /**
+     * Check if validation is enabled
+     */
+    hasValidation(): boolean;
+}
+//# sourceMappingURL=DataSource.d.ts.map

package/dist/core/DataSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataSource.d.ts","sourceRoot":"","sources":["../../src/core/DataSource.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAA0B,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAOnE,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG;IACnE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,GAAG;IACnC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IAClD,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,CAAE,SAAQ,YAAY;IAC/E,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC;IACjB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/B,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,WAAW,CAAc;IACjC,UAAU,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,CAAC,CAAY;IACvB,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,cAAc,CAAiB;gBAE3B,EAAE,GAAU,EAAE,IAAW,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAE,gBAAgB,CAAC,CAAC,CAAM;IAuD/G,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB7C,UAAU,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI;IA4B3B;;;;;;;;;;;;;OAaG;IACG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA+D5C;;;;;;OAMG;IACG,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAuDvD;;;;;OAKG;IACG,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IA+ClC;;;;;OAKG;IACG,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IA4CtD;;;;;OAKG;IACG,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,GAAG,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAkDlF;;;;;OAKG;IACG,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAwC5C;;;;;;OAMG;IACG,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAsCjE;;;;;OAKG;IACG,KAAK,CAAC,EAAE,MAAa,EAAE,IAAW,EAAE,KAAY,EAAE,GAAE,YAAY,CAAC,CAAC,CAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IA2C7F;;;;;OAKG;IACH,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,GAAG,SAAS;IAQlC;;;;;;OAMG;YACW,eAAe;IAoD7B,IAAI,IAAI,IAAI;IAUZ,IAAI,IAAI,IAAI;IAUZ,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAWzB,OAAO,CAAC,WAAW;IAInB;;;OAGG;IACH,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,GAAG,IAAI;IAoBhC,OAAO,CAAC,QAAQ;IAehB;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI;IAS/B;;;;;OAKG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IA8C1C;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IAQ9B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IAQ9B;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAa/B;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAwCxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA6C5B;;OAEG;IACH,mBAAmB,IAAI,IAAI;IAO3B;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAYxC;;OAEG;IACH,OAAO,CAAC,QAAQ;IAUhB;;OAEG;IACH,OAAO,CAAC,cAAc;IAiBtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;;;;;;OAOG;IACG,aAAa,CACjB,SAAS,EAAE,MAAM,CAAC,EAClB,KAAK,EAAE,GAAG,EACV,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAOzB;;;;;OAKG;IACG,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAOhF;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS;IAIzD;;OAEG;IACH,aAAa,IAAI,OAAO;CAGzB"}