@edgebasejs/client-core 0.1.8 → 0.1.9

package/dist/core/src/sync/sync-engine.d.ts

@@ -0,0 +1,68 @@
+import type { SyncRequest, SyncResponse, User } from '@edgebasejs/types';
+import { ColumnSecurityManager } from '../access-rules/column-security';
+import { EncryptionManager } from '../encryption/encryption-manager';
+export interface SyncDatabase {
+    getOne(sql: string, params: any[]): Promise<any>;
+    getAll(sql: string, params: any[]): Promise<any[]>;
+    run(sql: string, params: any[]): Promise<any>;
+    batch(statements: Array<{
+        sql: string;
+        params?: any[];
+    }>): Promise<any[]>;
+}
+export interface EntitySchema {
+    accessRules?: any;
+}
+export interface ServerSyncOptions {
+    schemas: Map<string, EntitySchema>;
+    db: SyncDatabase;
+    user: User;
+    columnSecurity?: ColumnSecurityManager;
+    encryption?: EncryptionManager;
+}
+/**
+ * Server-side sync engine
+ */
+export declare class ServerSyncEngine {
+    private schemas;
+    private db;
+    private user;
+    private serverTimestamp;
+    private columnSecurity?;
+    private encryption?;
+    constructor(options: ServerSyncOptions);
+    /**
+     * Process sync request from client
+     */
+    sync(request: SyncRequest): Promise<SyncResponse>;
+    /**
+     * Process changes from client
+     */
+    private processClientChanges;
+    /**
+     * Apply a change to the database
+     */
+    private applyChange;
+    /**
+     * Get server changes since last sync
+     */
+    private getServerChanges;
+    /**
+     * Filter record columns based on column-level security
+     */
+    private filterColumns;
+    /**
+     * Filter writable columns for client changes
+     */
+    private filterWritableData;
+    /**
+     * Encrypt sensitive fields before storing
+     */
+    private encryptData;
+    /**
+     * Decrypt sensitive fields after retrieving
+     */
+    private decryptData;
+}
+export default ServerSyncEngine;
+//# sourceMappingURL=sync-engine.d.ts.map

package/dist/core/src/sync/sync-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-engine.d.ts","sourceRoot":"","sources":["../../../../../core/src/sync/sync-engine.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACjD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACnD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9C,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;CAC3E;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,GAAG,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACnC,EAAE,EAAE,YAAY,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,EAAE,CAAe;IACzB,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,cAAc,CAAC,CAAwB;IAC/C,OAAO,CAAC,UAAU,CAAC,CAAoB;gBAE3B,OAAO,EAAE,iBAAiB;IAStC;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IA0BvD;;OAEG;YACW,oBAAoB;IA0JlC;;OAEG;YACW,WAAW;IAsDzB;;OAEG;YACW,gBAAgB;IA6F9B;;OAEG;YACW,aAAa;IAQ3B;;OAEG;YACW,kBAAkB;IAYhC;;OAEG;YACW,WAAW;IAQzB;;OAEG;YACW,WAAW;CAO1B;AAED,eAAe,gBAAgB,CAAC"}

package/dist/core/src/sync/sync-engine.js

@@ -0,0 +1,317 @@
+// Server-side synchronization engine
+import { AccessRulesEngine } from '../access-rules/engine';
+/**
+ * Server-side sync engine
+ */
+export class ServerSyncEngine {
+    constructor(options) {
+        this.schemas = options.schemas;
+        this.db = options.db;
+        this.user = options.user;
+        this.serverTimestamp = Date.now();
+        this.columnSecurity = options.columnSecurity;
+        this.encryption = options.encryption;
+    }
+    /**
+     * Process sync request from client
+     */
+    async sync(request) {
+        const response = {
+            serverTimestamp: this.serverTimestamp,
+            changes: [],
+            conflicts: [],
+            errors: [],
+        };
+        const appliedChangeKeys = new Set();
+        // Process client changes
+        if (request.changes && request.changes.length > 0) {
+            await this.processClientChanges(request.changes, response);
+            for (const change of response.changes) {
+                if (change.entity && change.id) {
+                    appliedChangeKeys.add(`${change.entity}:${change.id}`);
+                }
+            }
+        }
+        // Get server changes since last sync
+        await this.getServerChanges(request.lastSyncTimestamp, response, appliedChangeKeys);
+        return response;
+    }
+    /**
+     * Process changes from client
+     */
+    async processClientChanges(changes, response) {
+        for (const change of changes) {
+            try {
+                if (!change.entity) {
+                    response.errors.push({
+                        entity: change.entity,
+                        id: change.id,
+                        operation: change.operation,
+                        error: 'Missing entity',
+                        code: 'VALIDATION_ERROR',
+                    });
+                    continue;
+                }
+                if (!change.id) {
+                    response.errors.push({
+                        entity: change.entity,
+                        id: change.id,
+                        operation: change.operation,
+                        error: 'Missing record id',
+                        code: 'VALIDATION_ERROR',
+                    });
+                    continue;
+                }
+                if ((change.operation === 'create' || change.operation === 'update') &&
+                    (!change.data || typeof change.data !== 'object')) {
+                    response.errors.push({
+                        entity: change.entity,
+                        id: change.id,
+                        operation: change.operation,
+                        error: 'Missing data',
+                        code: 'VALIDATION_ERROR',
+                    });
+                    continue;
+                }
+                // Get schema for entity
+                const schema = this.schemas.get(change.entity);
+                if (!schema) {
+                    response.errors.push({
+                        entity: change.entity,
+                        id: change.id,
+                        operation: change.operation,
+                        error: 'Unknown entity',
+                        code: 'NOT_FOUND',
+                    });
+                    continue;
+                }
+                // Check access rules
+                const accessContext = {
+                    user: this.user,
+                    operation: change.operation,
+                    data: change.data ?? {},
+                };
+                // Get existing data for update/delete operations
+                if (change.operation === 'update' || change.operation === 'delete') {
+                    const existing = await this.db.getOne(`SELECT * FROM ${change.entity} WHERE id = ?`, [
+                        change.id,
+                    ]);
+                    if (existing) {
+                        accessContext.existingData = existing;
+                    }
+                }
+                // Evaluate access rules
+                const accessDecision = await AccessRulesEngine.evaluate(accessContext, schema.accessRules);
+                if (!accessDecision.allowed) {
+                    response.errors.push({
+                        entity: change.entity,
+                        id: change.id,
+                        operation: change.operation,
+                        error: accessDecision.reason || 'Access denied',
+                        code: 'ACCESS_DENIED',
+                    });
+                    continue;
+                }
+                // Filter writable columns for create/update operations
+                if (change.data && (change.operation === 'create' || change.operation === 'update')) {
+                    const { filtered, rejected } = await this.filterWritableData(change.entity, change.data, accessContext.existingData);
+                    if (rejected.length > 0) {
+                        // Log rejected columns (optional: could add to response warnings)
+                        console.warn(`Rejected columns for ${change.entity}:${change.id}:`, rejected);
+                    }
+                    // Use filtered data
+                    change.data = filtered;
+                }
+                // Get current version
+                const metadata = await this.db.getOne('SELECT version FROM sync_metadata WHERE entity = ? AND record_id = ?', [change.entity, change.id]);
+                const currentVersion = metadata?.version || 0;
+                // Check for conflicts (version mismatch)
+                if (metadata && change.version !== currentVersion) {
+                    // Get current data
+                    const currentData = await this.db.getOne(`SELECT * FROM ${change.entity} WHERE id = ?`, [
+                        change.id,
+                    ]);
+                    response.conflicts.push({
+                        entity: change.entity,
+                        id: change.id,
+                        clientVersion: change.version,
+                        serverVersion: currentVersion,
+                        serverData: currentData || {},
+                    });
+                    continue;
+                }
+                // Apply change to database
+                await this.applyChange(change, currentVersion + 1);
+                // Filter columns before sending back to client
+                const filteredData = change.data ? await this.filterColumns(change.entity, change.data) : {};
+                // Add to response changes
+                response.changes.push({
+                    ...change,
+                    data: filteredData,
+                    serverTimestamp: this.serverTimestamp,
+                    version: currentVersion + 1,
+                });
+            }
+            catch (error) {
+                console.error('Error processing change:', error);
+                response.errors.push({
+                    entity: change.entity,
+                    id: change.id,
+                    operation: change.operation,
+                    error: error instanceof Error ? error.message : 'Processing failed',
+                    code: 'VALIDATION_ERROR',
+                });
+            }
+        }
+    }
+    /**
+     * Apply a change to the database
+     */
+    async applyChange(change, version) {
+        const now = Date.now();
+        switch (change.operation) {
+            case 'create': {
+                // Insert record
+                const columns = ['id', ...Object.keys(change.data)];
+                const values = [change.id, ...Object.values(change.data)];
+                const placeholders = columns.map(() => '?').join(', ');
+                await this.db.run(`INSERT INTO ${change.entity} (${columns.join(', ')}) VALUES (${placeholders})`, values);
+                // Insert metadata
+                await this.db.run('INSERT OR REPLACE INTO sync_metadata (entity, record_id, version, updated_at) VALUES (?, ?, ?, ?)', [change.entity, change.id, version, now]);
+                break;
+            }
+            case 'update': {
+                // Update record
+                const updates = Object.entries(change.data)
+                    .map(([key]) => `${key} = ?`)
+                    .join(', ');
+                const values = [...Object.values(change.data), change.id];
+                await this.db.run(`UPDATE ${change.entity} SET ${updates} WHERE id = ?`, values);
+                // Update metadata
+                await this.db.run('INSERT OR REPLACE INTO sync_metadata (entity, record_id, version, updated_at) VALUES (?, ?, ?, ?)', [change.entity, change.id, version, now]);
+                break;
+            }
+            case 'delete': {
+                // Delete record
+                await this.db.run(`DELETE FROM ${change.entity} WHERE id = ?`, [change.id]);
+                // Mark as deleted in metadata
+                await this.db.run('INSERT OR REPLACE INTO sync_metadata (entity, record_id, version, updated_at, deleted_at) VALUES (?, ?, ?, ?, ?)', [change.entity, change.id, version, now, now]);
+                break;
+            }
+        }
+    }
+    /**
+     * Get server changes since last sync
+     */
+    async getServerChanges(lastSyncTimestamp, response, appliedChangeKeys) {
+        if (!lastSyncTimestamp) {
+            // First sync - get all data
+            for (const entity of this.schemas.keys()) {
+                try {
+                    const records = await this.db.getAll(`SELECT m.version, r.* FROM ${entity} r
+               LEFT JOIN sync_metadata m ON m.entity = ? AND m.record_id = r.id`, [entity]);
+                    for (const record of records) {
+                        if (appliedChangeKeys.has(`${entity}:${record.id}`)) {
+                            continue;
+                        }
+                        const entitySchema = this.schemas.get(entity);
+                        if (entitySchema?.accessRules?.read) {
+                            const accessDecision = await AccessRulesEngine.evaluate({ user: this.user, operation: 'read', data: record }, entitySchema.accessRules);
+                            if (!accessDecision.allowed) {
+                                continue;
+                            }
+                        }
+                        // Filter columns based on column-level security
+                        const filteredData = await this.filterColumns(entity, record);
+                        response.changes.push({
+                            entity,
+                            operation: 'create',
+                            id: record.id,
+                            data: filteredData,
+                            serverTimestamp: this.serverTimestamp,
+                            version: record.version || 1,
+                        });
+                    }
+                }
+                catch (error) {
+                    console.error(`Error fetching records from ${entity}:`, error);
+                }
+            }
+        }
+        else {
+            // Get changes since last sync
+            for (const entity of this.schemas.keys()) {
+                try {
+                    const records = await this.db.getAll(`SELECT m.version, m.deleted_at, m.record_id, r.* FROM sync_metadata m
+               LEFT JOIN ${entity} r ON r.id = m.record_id
+               WHERE m.entity = ? AND m.updated_at > ?`, [entity, lastSyncTimestamp]);
+                    for (const record of records) {
+                        const recordId = record.record_id || record.id;
+                        if (appliedChangeKeys.has(`${entity}:${recordId}`)) {
+                            continue;
+                        }
+                        const operation = record.deleted_at ? 'delete' : 'update';
+                        const entitySchema = this.schemas.get(entity);
+                        if (!record.deleted_at && entitySchema?.accessRules?.read) {
+                            const accessDecision = await AccessRulesEngine.evaluate({ user: this.user, operation: 'read', data: record }, entitySchema.accessRules);
+                            if (!accessDecision.allowed) {
+                                continue;
+                            }
+                        }
+                        // Filter columns based on column-level security
+                        const filteredData = record.deleted_at ? {} : await this.filterColumns(entity, record);
+                        response.changes.push({
+                            entity,
+                            operation: operation,
+                            id: record.record_id || record.id,
+                            data: filteredData,
+                            serverTimestamp: this.serverTimestamp,
+                            version: record.version || 1,
+                        });
+                    }
+                }
+                catch (error) {
+                    console.error(`Error fetching changes from ${entity}:`, error);
+                }
+            }
+        }
+    }
+    /**
+     * Filter record columns based on column-level security
+     */
+    async filterColumns(entity, data) {
+        if (!this.columnSecurity) {
+            return data; // No column security = return all data
+        }
+        return await this.columnSecurity.filterReadableColumns(entity, data, this.user);
+    }
+    /**
+     * Filter writable columns for client changes
+     */
+    async filterWritableData(entity, data, existingRecord) {
+        if (!this.columnSecurity) {
+            return { filtered: data, rejected: [] }; // No column security = allow all
+        }
+        return await this.columnSecurity.filterWritableColumns(entity, data, this.user, existingRecord);
+    }
+    /**
+     * Encrypt sensitive fields before storing
+     */
+    async encryptData(entity, data) {
+        if (!this.encryption) {
+            return data; // No encryption = return as is
+        }
+        return await this.encryption.encryptRecord(entity, data);
+    }
+    /**
+     * Decrypt sensitive fields after retrieving
+     */
+    async decryptData(entity, data) {
+        if (!this.encryption) {
+            return data; // No encryption = return as is
+        }
+        return await this.encryption.decryptRecord(entity, data);
+    }
+}
+export default ServerSyncEngine;
+//# sourceMappingURL=sync-engine.js.map

package/dist/core/src/sync/sync-engine.js.map

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

package/dist/core/src/sync/transaction-manager.d.ts

@@ -0,0 +1,83 @@
+import type { SyncDatabase } from './sync-engine';
+import type { User } from '@edgebasejs/types';
+export type IsolationLevel = 'READ_UNCOMMITTED' | 'READ_COMMITTED' | 'SERIALIZABLE';
+export type TransactionStatus = 'active' | 'committed' | 'rolled_back' | 'expired';
+export interface Transaction {
+    id: string;
+    userId: string;
+    status: TransactionStatus;
+    isolationLevel: IsolationLevel;
+    createdAt: number;
+    expiresAt: number;
+    completedAt?: number;
+    changes: TransactionChange[];
+}
+export interface TransactionChange {
+    id: string;
+    entity: string;
+    recordId: string;
+    operation: 'create' | 'update' | 'delete';
+    data: Record<string, any>;
+    version?: number;
+}
+/**
+ * Manages database transactions with ACID guarantees
+ * Handles begin, commit, and rollback operations
+ */
+export declare class TransactionManager {
+    private db;
+    private activeTransactions;
+    private readonly transactionTimeout;
+    private readonly maxRetries;
+    constructor(db: SyncDatabase);
+    /**
+     * Begin a new transaction
+     */
+    begin(user: User, isolationLevel?: IsolationLevel): Promise<string>;
+    /**
+     * Add a change to a transaction
+     */
+    addChange(transactionId: string, entity: string, recordId: string, operation: 'create' | 'update' | 'delete', data: Record<string, any>, version?: number): Promise<void>;
+    /**
+     * Get a transaction by ID
+     */
+    getTransaction(transactionId: string): Transaction | undefined;
+    /**
+     * Commit a transaction
+     * Applies all changes atomically
+     */
+    commit(transactionId: string): Promise<{
+        appliedCount: number;
+        errors: string[];
+    }>;
+    /**
+     * Rollback a transaction
+     * Reverts all changes
+     */
+    rollback(transactionId: string): Promise<void>;
+    /**
+     * Detect conflicts for a record
+     */
+    private detectConflict;
+    /**
+     * Apply a single change to the database
+     */
+    private applyChange;
+    /**
+     * Get all active transactions for a user
+     */
+    getActiveTransactions(userId: string): Transaction[];
+    /**
+     * Cleanup expired transactions
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Get transaction statistics
+     */
+    getStats(): {
+        activeTransactions: number;
+        committedTransactions: number;
+        rolledBackTransactions: number;
+    };
+}
+//# sourceMappingURL=transaction-manager.d.ts.map

package/dist/core/src/sync/transaction-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-manager.d.ts","sourceRoot":"","sources":["../../../../../core/src/sync/transaction-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,MAAM,cAAc,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,cAAc,CAAC;AACpF,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC;AAEnF,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,iBAAiB,CAAC;IAC1B,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAKjB,OAAO,CAAC,EAAE;IAJtB,OAAO,CAAC,kBAAkB,CAAkC;IAC5D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAU;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAK;gBAEZ,EAAE,EAAE,YAAY;IAEpC;;OAEG;IACG,KAAK,CACT,IAAI,EAAE,IAAI,EACV,cAAc,GAAE,cAAiC,GAChD,OAAO,CAAC,MAAM,CAAC;IA4BlB;;OAEG;IACG,SAAS,CACb,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,EACzC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAsChB;;OAEG;IACH,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI9D;;;OAGG;IACG,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAkExF;;;OAGG;IACG,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBpD;;OAEG;YACW,cAAc;IA8C5B;;OAEG;YACW,WAAW;IAwBzB;;OAEG;IACH,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE;IAMpD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B;;OAEG;IACH,QAAQ,IAAI;QACV,kBAAkB,EAAE,MAAM,CAAC;QAC3B,qBAAqB,EAAE,MAAM,CAAC;QAC9B,sBAAsB,EAAE,MAAM,CAAC;KAChC;CAaF"}