@forestadmin/datasource-replica 1.0.0 → 1.0.2-alpha-widgets.1

package/dist/synchronization/cache-target.js

@@ -0,0 +1,85 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const sequelize_1 = require("sequelize");
+const flattener_1 = __importDefault(require("../flattener"));
+const utils_1 = require("../utils");
+class CacheTarget {
+    constructor(connection, options, logger) {
+        this.connection = connection;
+        this.options = options;
+        this.logger = logger;
+    }
+    async applyDump(changes, firstPage) {
+        if (firstPage) {
+            // Truncate tables
+            for (const collection of this.options.flattenSchema) {
+                await this.connection.model(collection.name).truncate();
+            }
+        }
+        const recordsByCollection = {};
+        const entries = changes.entries.flatMap(entry => this.flattenRecord(entry));
+        for (const entry of entries) {
+            if (entry !== undefined) {
+                if (!recordsByCollection[entry.collection])
+                    recordsByCollection[entry.collection] = [];
+                recordsByCollection[entry.collection].push(entry.record);
+            }
+        }
+        await this.connection.transaction(async (transaction) => {
+            for (const [collection, records] of Object.entries(recordsByCollection)) {
+                await this.connection.model(collection).bulkCreate(records, { transaction });
+            }
+        });
+    }
+    async applyDelta(changes) {
+        await this.connection.transaction(async (transaction) => {
+            for (const entry of changes.deletedEntries) {
+                if (this.checkCollection(entry.collection)) {
+                    await this.destroySubModels(entry, transaction);
+                    await this.connection
+                        .model(entry.collection)
+                        .destroy({ where: entry.record, transaction });
+                }
+            }
+            // Upsert records in both root and virtual collections
+            for (const entry of changes.newOrUpdatedEntries) {
+                if (this.checkCollection(entry.collection)) {
+                    await this.destroySubModels(entry, transaction);
+                    for (const subEntry of this.flattenRecord(entry))
+                        await this.connection
+                            .model(subEntry.collection)
+                            .upsert(subEntry.record, { transaction });
+                }
+            }
+        });
+    }
+    flattenRecord(recordWithCollection) {
+        if (this.checkCollection(recordWithCollection.collection))
+            return (0, flattener_1.default)(recordWithCollection, this.options.schema.find(s => s.name === recordWithCollection.collection).fields, this.options?.flattenOptions?.[recordWithCollection.collection]?.asFields ?? [], this.options?.flattenOptions?.[recordWithCollection.collection]?.asModels ?? []);
+    }
+    async destroySubModels(entry, transaction) {
+        const { asModels } = this.options.flattenOptions[entry.collection];
+        const { fields } = this.options.schema.find(c => c.name === entry.collection);
+        const promises = asModels.map(asModel => {
+            const recordId = (0, utils_1.getRecordId)(fields, entry.record);
+            return this.connection.model((0, utils_1.escape) `${entry.collection}.${asModel}`).destroy({
+                where: { _fid: { [sequelize_1.Op.startsWith]: `${recordId}.${asModel}` } },
+                transaction,
+            });
+        });
+        await Promise.all(promises);
+    }
+    checkCollection(collection) {
+        const collectionName = this.options.schema.find(s => s.name === collection);
+        if (!collectionName) {
+            this.logger('Error', `Collection '${collection}' not found in schema. Skipping.`);
+            return false;
+        }
+        return true;
+    }
+}
+exports.default = CacheTarget;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2FjaGUtdGFyZ2V0LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3N5bmNocm9uaXphdGlvbi9jYWNoZS10YXJnZXQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7QUFXQSx5Q0FBNEM7QUFFNUMsNkRBQXlDO0FBQ3pDLG9DQUErQztBQUUvQyxNQUFxQixXQUFXO0lBSzlCLFlBQVksVUFBcUIsRUFBRSxPQUF3QixFQUFFLE1BQWM7UUFDekUsSUFBSSxDQUFDLFVBQVUsR0FBRyxVQUFVLENBQUM7UUFDN0IsSUFBSSxDQUFDLE9BQU8sR0FBRyxPQUFPLENBQUM7UUFDdkIsSUFBSSxDQUFDLE1BQU0sR0FBRyxNQUFNLENBQUM7SUFDdkIsQ0FBQztJQUVELEtBQUssQ0FBQyxTQUFTLENBQUMsT0FBeUIsRUFBRSxTQUFrQjtRQUMzRCxJQUFJLFNBQVMsRUFBRTtZQUNiLGtCQUFrQjtZQUNsQixLQUFLLE1BQU0sVUFBVSxJQUFJLElBQUksQ0FBQyxPQUFPLENBQUMsYUFBYSxFQUFFO2dCQUNuRCxNQUFNLElBQUksQ0FBQyxVQUFVLENBQUMsS0FBSyxDQUFDLFVBQVUsQ0FBQyxJQUFJLENBQUMsQ0FBQyxRQUFRLEVBQUUsQ0FBQzthQUN6RDtTQUNGO1FBRUQsTUFBTSxtQkFBbUIsR0FBRyxFQUFrQyxDQUFDO1FBQy9ELE1BQU0sT0FBTyxHQUFHLE9BQU8sQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxFQUFFLENBQUMsSUFBSSxDQUFDLGFBQWEsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDO1FBRTVFLEtBQUssTUFBTSxLQUFLLElBQUksT0FBTyxFQUFFO1lBQzNCLElBQUksS0FBSyxLQUFLLFNBQVMsRUFBRTtnQkFDdkIsSUFBSSxDQUFDLG1CQUFtQixDQUFDLEtBQUssQ0FBQyxVQUFVLENBQUM7b0JBQUUsbUJBQW1CLENBQUMsS0FBSyxDQUFDLFVBQVUsQ0FBQyxHQUFHLEVBQUUsQ0FBQztnQkFDdkYsbUJBQW1CLENBQUMsS0FBSyxDQUFDLFVBQVUsQ0FBQyxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsTUFBTSxDQUFDLENBQUM7YUFDMUQ7U0FDRjtRQUVELE1BQU0sSUFBSSxDQUFDLFVBQVUsQ0FBQyxXQUFXLENBQUMsS0FBSyxFQUFDLFdBQVcsRUFBQyxFQUFFO1lBQ3BELEtBQUssTUFBTSxDQUFDLFVBQVUsRUFBRSxPQUFPLENBQUMsSUFBSSxNQUFNLENBQUMsT0FBTyxDQUFDLG1CQUFtQixDQUFDLEVBQUU7Z0JBQ3ZFLE1BQU0sSUFBSSxDQUFDLFVBQVUsQ0FBQyxLQUFLLENBQUMsVUFBVSxDQUFDLENBQUMsVUFBVSxDQUFDLE9BQU8sRUFBRSxFQUFFLFdBQVcsRUFBRSxDQUFDLENBQUM7YUFDOUU7UUFDSCxDQUFDLENBQUMsQ0FBQztJQUNMLENBQUM7SUFFRCxLQUFLLENBQUMsVUFBVSxDQUFDLE9BQTBCO1FBQ3pDLE1BQU0sSUFBSSxDQUFDLFVBQVUsQ0FBQyxXQUFXLENBQUMsS0FBSyxFQUFDLFdBQVcsRUFBQyxFQUFFO1lBQ3BELEtBQUssTUFBTSxLQUFLLElBQUksT0FBTyxDQUFDLGNBQWMsRUFBRTtnQkFDMUMsSUFBSSxJQUFJLENBQUMsZUFBZSxDQUFDLEtBQUssQ0FBQyxVQUFVLENBQUMsRUFBRTtvQkFDMUMsTUFBTSxJQUFJLENBQUMsZ0JBQWdCLENBQUMsS0FBSyxFQUFFLFdBQVcsQ0FBQyxDQUFDO29CQUNoRCxNQUFNLElBQUksQ0FBQyxVQUFVO3lCQUNsQixLQUFLLENBQUMsS0FBSyxDQUFDLFVBQVUsQ0FBQzt5QkFDdkIsT0FBTyxDQUFDLEVBQUUsS0FBSyxFQUFFLEtBQUssQ0FBQyxNQUFNLEVBQUUsV0FBVyxFQUFFLENBQUMsQ0FBQztpQkFDbEQ7YUFDRjtZQUVELHNEQUFzRDtZQUV0RCxLQUFLLE1BQU0sS0FBSyxJQUFJLE9BQU8sQ0FBQyxtQkFBbUIsRUFBRTtnQkFDL0MsSUFBSSxJQUFJLENBQUMsZUFBZSxDQUFDLEtBQUssQ0FBQyxVQUFVLENBQUMsRUFBRTtvQkFDMUMsTUFBTSxJQUFJLENBQUMsZ0JBQWdCLENBQUMsS0FBSyxFQUFFLFdBQVcsQ0FBQyxDQUFDO29CQUNoRCxLQUFLLE1BQU0sUUFBUSxJQUFJLElBQUksQ0FBQyxhQUFhLENBQUMsS0FBSyxDQUFDO3dCQUM5QyxNQUFNLElBQUksQ0FBQyxVQUFVOzZCQUNsQixLQUFLLENBQUMsUUFBUSxDQUFDLFVBQVUsQ0FBQzs2QkFDMUIsTUFBTSxDQUFDLFFBQVEsQ0FBQyxNQUFNLEVBQUUsRUFBRSxXQUFXLEVBQUUsQ0FBQyxDQUFDO2lCQUMvQzthQUNGO1FBQ0gsQ0FBQyxDQUFDLENBQUM7SUFDTCxDQUFDO0lBRU8sYUFBYSxDQUNuQixvQkFBOEM7UUFFOUMsSUFBSSxJQUFJLENBQUMsZUFBZSxDQUFDLG9CQUFvQixDQUFDLFVBQVUsQ0FBQztZQUN2RCxPQUFPLElBQUEsbUJBQWEsRUFDbEIsb0JBQW9CLEVBQ3BCLElBQUksQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxJQUFJLEtBQUssb0JBQW9CLENBQUMsVUFBVSxDQUFDLENBQUMsTUFBTSxFQUNoRixJQUFJLENBQUMsT0FBTyxFQUFFLGNBQWMsRUFBRSxDQUFDLG9CQUFvQixDQUFDLFVBQVUsQ0FBQyxFQUFFLFFBQVEsSUFBSSxFQUFFLEVBQy9FLElBQUksQ0FBQyxPQUFPLEVBQUUsY0FBYyxFQUFFLENBQUMsb0JBQW9CLENBQUMsVUFBVSxDQUFDLEVBQUUsUUFBUSxJQUFJLEVBQUUsQ0FDaEYsQ0FBQztJQUNOLENBQUM7SUFFTyxLQUFLLENBQUMsZ0JBQWdCLENBQzVCLEtBQStCLEVBQy9CLFdBQXlCO1FBRXpCLE1BQU0sRUFBRSxRQUFRLEVBQUUsR0FBRyxJQUFJLENBQUMsT0FBTyxDQUFDLGNBQWMsQ0FBQyxLQUFLLENBQUMsVUFBVSxDQUFDLENBQUM7UUFDbkUsTUFBTSxFQUFFLE1BQU0sRUFBRSxHQUFHLElBQUksQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxJQUFJLEtBQUssS0FBSyxDQUFDLFVBQVUsQ0FBQyxDQUFDO1FBQzlFLE1BQU0sUUFBUSxHQUFHLFFBQVEsQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLEVBQUU7WUFDdEMsTUFBTSxRQUFRLEdBQUcsSUFBQSxtQkFBVyxFQUFDLE1BQU0sRUFBRSxLQUFLLENBQUMsTUFBTSxDQUFDLENBQUM7WUFFbkQsT0FBTyxJQUFJLENBQUMsVUFBVSxDQUFDLEtBQUssQ0FBQyxJQUFBLGNBQU0sRUFBQSxHQUFHLEtBQUssQ0FBQyxVQUFVLElBQUksT0FBTyxFQUFFLENBQUMsQ0FBQyxPQUFPLENBQUM7Z0JBQzNFLEtBQUssRUFBRSxFQUFFLElBQUksRUFBRSxFQUFFLENBQUMsY0FBRSxDQUFDLFVBQVUsQ0FBQyxFQUFFLEdBQUcsUUFBUSxJQUFJLE9BQU8sRUFBRSxFQUFFLEVBQUU7Z0JBQzlELFdBQVc7YUFDWixDQUFDLENBQUM7UUFDTCxDQUFDLENBQUMsQ0FBQztRQUVILE1BQU0sT0FBTyxDQUFDLEdBQUcsQ0FBQyxRQUFRLENBQUMsQ0FBQztJQUM5QixDQUFDO0lBRU8sZUFBZSxDQUFDLFVBQWtCO1FBQ3hDLE1BQU0sY0FBYyxHQUFHLElBQUksQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxJQUFJLEtBQUssVUFBVSxDQUFDLENBQUM7UUFFNUUsSUFBSSxDQUFDLGNBQWMsRUFBRTtZQUNuQixJQUFJLENBQUMsTUFBTSxDQUFDLE9BQU8sRUFBRSxlQUFlLFVBQVUsa0NBQWtDLENBQUMsQ0FBQztZQUVsRixPQUFPLEtBQUssQ0FBQztTQUNkO1FBRUQsT0FBTyxJQUFJLENBQUM7SUFDZCxDQUFDO0NBQ0Y7QUF0R0QsOEJBc0dDIn0=

package/dist/synchronization/customer-source.d.ts

@@ -0,0 +1,31 @@
+import type CacheDataSourceInterface from '../cache-interface/datasource';
+import type { PullDeltaReason, PullDumpReason, ReplicaDataSourceOptions, SynchronizationSource, SynchronizationTarget } from '../types';
+import type { Logger } from '@forestadmin/datasource-toolkit';
+import type { Sequelize } from 'sequelize';
+export default class CustomerSource implements SynchronizationSource {
+    requestCache: CacheDataSourceInterface;
+    private readonly logger;
+    private options;
+    private connection;
+    private isRunning;
+    private queuedPullDumpReasons;
+    private queuedPullDeltaReasons;
+    private queuedPushDeltaRequest;
+    private schedules;
+    private target;
+    constructor(connection: Sequelize, options: ReplicaDataSourceOptions, logger: Logger);
+    start(target: SynchronizationTarget): Promise<void>;
+    stop(): Promise<void>;
+    private queuePushDelta;
+    queuePullDump(reason: PullDumpReason): Promise<void>;
+    queuePullDelta(reason: PullDeltaReason): Promise<void>;
+    private tick;
+    private runPushDelta;
+    private runPullDump;
+    private runPullDelta;
+    private getStartupState;
+    private setStartupState;
+    private getDeltaState;
+    private setDeltaState;
+}
+//# sourceMappingURL=customer-source.d.ts.map

package/dist/synchronization/customer-source.js

@@ -0,0 +1,188 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const datasource_toolkit_1 = require("@forestadmin/datasource-toolkit");
+const croner_1 = require("croner");
+class CustomerSource {
+    constructor(connection, options, logger) {
+        this.requestCache = null;
+        this.isRunning = false;
+        this.queuedPullDumpReasons = null;
+        this.queuedPullDeltaReasons = null;
+        this.queuedPushDeltaRequest = null;
+        this.schedules = [];
+        this.connection = connection;
+        this.options = options;
+        this.logger = logger;
+        const hasPullDeltaFlag = options.pullDeltaOnRestart ||
+            options.pullDeltaOnSchedule ||
+            options.pullDeltaOnAfterWrite ||
+            options.pullDeltaOnBeforeAccess;
+        if (options.pullDeltaHandler && !hasPullDeltaFlag)
+            throw new Error('Using pullDeltaHandler without pullDelta[*] flags');
+        if (hasPullDeltaFlag && !options.pullDeltaHandler)
+            throw new Error('Using pullDelta[*] flags without pullDeltaHandler');
+    }
+    async start(target) {
+        const { options } = this;
+        if (this.target)
+            throw new Error('Already started');
+        this.target = target;
+        if (options.pullDumpHandler &&
+            (options.pullDumpOnRestart || (await this.getStartupState()) !== 'done'))
+            await this.queuePullDump({ name: 'startup' });
+        if (options.pullDeltaHandler && options.pullDeltaOnRestart)
+            await this.queuePullDelta({ name: 'startup' });
+        if (options.pushDeltaHandler) {
+            options.pushDeltaHandler({ cache: this.requestCache, getPreviousDeltaState: () => this.getDeltaState() }, async (changes) => this.queuePushDelta(changes));
+        }
+        if (options.pullDumpHandler && options.pullDumpOnSchedule) {
+            const schedule = options.pullDumpOnSchedule;
+            for (const pattern of Array.isArray(schedule) ? schedule : [schedule]) {
+                this.schedules.push((0, croner_1.Cron)(pattern, () => this.queuePullDump({ name: 'schedule' })));
+            }
+        }
+        if (options.pullDeltaHandler && options.pullDeltaOnSchedule) {
+            const schedule = options.pullDeltaOnSchedule;
+            for (const pattern of Array.isArray(schedule) ? schedule : [schedule]) {
+                this.schedules.push((0, croner_1.Cron)(pattern, () => this.queuePullDelta({ name: 'schedule' })));
+            }
+        }
+    }
+    async stop() {
+        this.schedules.forEach(cron => cron.stop());
+        this.schedules.length = 0;
+    }
+    queuePushDelta(delta) {
+        if (!this.queuedPushDeltaRequest)
+            this.queuedPushDeltaRequest = { newOrUpdatedEntries: [], deletedEntries: [] };
+        this.queuedPushDeltaRequest.deletedEntries.push(...delta.deletedEntries);
+        this.queuedPushDeltaRequest.newOrUpdatedEntries.push(...delta.newOrUpdatedEntries);
+        if (delta.nextDeltaState)
+            this.queuedPushDeltaRequest.nextDeltaState = delta.nextDeltaState;
+        this.tick();
+    }
+    queuePullDump(reason) {
+        if (!this.queuedPullDumpReasons)
+            this.queuedPullDumpReasons = { deferred: new datasource_toolkit_1.Deferred(), reasons: [] };
+        const { deferred } = this.queuedPullDumpReasons;
+        this.queuedPullDumpReasons.reasons.push({ ...reason, at: new Date() });
+        this.tick();
+        return deferred.promise;
+    }
+    queuePullDelta(reason) {
+        if (!this.queuedPullDeltaReasons)
+            this.queuedPullDeltaReasons = { deferred: new datasource_toolkit_1.Deferred(), reasons: [] };
+        const { deferred } = this.queuedPullDeltaReasons;
+        this.queuedPullDeltaReasons.reasons.push({ ...reason, at: new Date() });
+        // We wait for the access delay before running the delta
+        // This allows to batch delta requests at the cost of adding a floor delay to all requests.
+        if (this.options.pullDeltaOnBeforeAccessDelay)
+            setTimeout(() => this.tick(), this.options.pullDeltaOnBeforeAccessDelay);
+        else
+            this.tick();
+        return deferred.promise;
+    }
+    tick() {
+        if (!this.isRunning) {
+            if (this.queuedPushDeltaRequest) {
+                this.runPushDelta(this.queuedPushDeltaRequest);
+                this.queuedPushDeltaRequest = null;
+            }
+            else if (this.queuedPullDumpReasons) {
+                this.runPullDump(this.queuedPullDumpReasons);
+                this.queuedPullDumpReasons = null;
+            }
+            else if (this.queuedPullDeltaReasons) {
+                this.runPullDelta(this.queuedPullDeltaReasons);
+                this.queuedPullDeltaReasons = null;
+            }
+        }
+    }
+    async runPushDelta(changes) {
+        this.isRunning = true;
+        await this.target.applyDelta(changes);
+        this.isRunning = false;
+        this.tick();
+    }
+    /* eslint-disable no-await-in-loop */
+    async runPullDump(queue) {
+        this.isRunning = true;
+        let state = null;
+        let more = true;
+        let firstPage = true;
+        await this.setStartupState('in_progress');
+        // Fill table with dump
+        while (more) {
+            try {
+                const changes = await this.options.pullDumpHandler({
+                    reasons: queue.reasons,
+                    cache: this.requestCache,
+                    previousDumpState: state,
+                });
+                await this.target.applyDump(changes, firstPage);
+                firstPage = false;
+                more = changes.more;
+                if (changes.more === true)
+                    state = changes.nextDumpState;
+                if (changes.more === false && changes.nextDeltaState)
+                    await this.setDeltaState(changes.nextDeltaState);
+            }
+            catch (error) {
+                more = false;
+                this.logger('Warn', `Dump failed for the namespace "${this.options.cacheNamespace}": ${error.message}`);
+            }
+        }
+        await this.setStartupState('done');
+        this.isRunning = false;
+        queue.deferred.resolve();
+        this.tick();
+    }
+    async runPullDelta(queue) {
+        this.isRunning = true;
+        let more = true;
+        while (more) {
+            // Update records in database
+            const previousState = await this.getDeltaState();
+            const collections = queue.reasons.flatMap(r => 'affectedCollections' in r ? r.affectedCollections : []);
+            try {
+                const changes = await this.options.pullDeltaHandler({
+                    reasons: queue.reasons,
+                    affectedCollections: [...new Set(collections)],
+                    cache: this.requestCache,
+                    previousDeltaState: previousState,
+                });
+                await this.target.applyDelta(changes);
+                await this.setDeltaState(changes.nextDeltaState);
+                more = changes.more;
+            }
+            catch (error) {
+                more = false;
+                this.logger('Warn', `Delta failed for the namespace "${this.options.cacheNamespace}": ${error.message}`);
+            }
+        }
+        this.isRunning = false;
+        queue.deferred.resolve();
+        this.tick();
+    }
+    /* eslint-enable no-await-in-loop */
+    async getStartupState() {
+        const metadataModel = this.connection.model(`${this.options.cacheNamespace}_metadata`);
+        const stateRecord = await metadataModel.findByPk('statup_state');
+        return stateRecord ? JSON.parse(stateRecord.dataValues.content) : 'pending';
+    }
+    async setStartupState(state) {
+        const metadataModel = this.connection.model(`${this.options.cacheNamespace}_metadata`);
+        await metadataModel.upsert({ id: 'statup_state', content: JSON.stringify(state) });
+    }
+    async getDeltaState() {
+        const metadataModel = this.connection.model(`${this.options.cacheNamespace}_metadata`);
+        const stateRecord = await metadataModel.findByPk('delta_state');
+        return stateRecord ? JSON.parse(stateRecord.dataValues.content) : null;
+    }
+    async setDeltaState(state) {
+        const metadataModel = this.connection.model(`${this.options.cacheNamespace}_metadata`);
+        await metadataModel.upsert({ id: 'delta_state', content: JSON.stringify(state) });
+    }
+}
+exports.default = CustomerSource;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY3VzdG9tZXItc291cmNlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3N5bmNocm9uaXphdGlvbi9jdXN0b21lci1zb3VyY2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFZQSx3RUFBMkQ7QUFDM0QsbUNBQThCO0FBYzlCLE1BQXFCLGNBQWM7SUFnQmpDLFlBQVksVUFBcUIsRUFBRSxPQUFpQyxFQUFFLE1BQWM7UUFmcEYsaUJBQVksR0FBNkIsSUFBSSxDQUFDO1FBTXRDLGNBQVMsR0FBRyxLQUFLLENBQUM7UUFFbEIsMEJBQXFCLEdBQTBCLElBQUksQ0FBQztRQUNwRCwyQkFBc0IsR0FBMkIsSUFBSSxDQUFDO1FBQ3RELDJCQUFzQixHQUFzQixJQUFJLENBQUM7UUFFakQsY0FBUyxHQUFXLEVBQUUsQ0FBQztRQUk3QixJQUFJLENBQUMsVUFBVSxHQUFHLFVBQVUsQ0FBQztRQUM3QixJQUFJLENBQUMsT0FBTyxHQUFHLE9BQU8sQ0FBQztRQUN2QixJQUFJLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQztRQUVyQixNQUFNLGdCQUFnQixHQUNwQixPQUFPLENBQUMsa0JBQWtCO1lBQzFCLE9BQU8sQ0FBQyxtQkFBbUI7WUFDM0IsT0FBTyxDQUFDLHFCQUFxQjtZQUM3QixPQUFPLENBQUMsdUJBQXVCLENBQUM7UUFFbEMsSUFBSSxPQUFPLENBQUMsZ0JBQWdCLElBQUksQ0FBQyxnQkFBZ0I7WUFDL0MsTUFBTSxJQUFJLEtBQUssQ0FBQyxtREFBbUQsQ0FBQyxDQUFDO1FBRXZFLElBQUksZ0JBQWdCLElBQUksQ0FBQyxPQUFPLENBQUMsZ0JBQWdCO1lBQy9DLE1BQU0sSUFBSSxLQUFLLENBQUMsbURBQW1ELENBQUMsQ0FBQztJQUN6RSxDQUFDO0lBRUQsS0FBSyxDQUFDLEtBQUssQ0FBQyxNQUE2QjtRQUN2QyxNQUFNLEVBQUUsT0FBTyxFQUFFLEdBQUcsSUFBSSxDQUFDO1FBRXpCLElBQUksSUFBSSxDQUFDLE1BQU07WUFB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

package/dist/types.d.ts

@@ -0,0 +1,176 @@
+import type CacheDataSourceInterface from './cache-interface/datasource';
+import type { TFilter, TPaginatedFilter } from '@forestadmin/datasource-customizer';
+import type { ConnectionOptions } from '@forestadmin/datasource-sql';
+import type { Aggregation, Caller, ColumnSchema, Logger, PrimitiveTypes, Projection, RecordData } from '@forestadmin/datasource-toolkit';
+export type ValueOrPromiseOrFactory<T> = T | Promise<T> | (() => T) | (() => Promise<T>);
+export type RecordDataWithCollection = {
+    collection: string;
+    record: RecordData;
+};
+export declare function isLeafField(field: Field): field is LeafField;
+export type ObjectField = {
+    [key: string]: Field;
+};
+export type ArrayField = [Field];
+export type LeafField = {
+    type: PrimitiveTypes | 'Integer';
+    defaultValue?: unknown;
+    enumValues?: string[];
+    isPrimaryKey?: boolean;
+    isReadOnly?: boolean;
+    unique?: boolean;
+    validation?: ColumnSchema['validation'];
+    reference?: {
+        relationName: string;
+        targetCollection: string;
+        targetField: string;
+        relationInverse?: string;
+    };
+};
+export type Field = ArrayField | ObjectField | LeafField;
+export type CollectionReplicaSchema = {
+    name: string;
+    fields: Record<string, Field>;
+};
+export type PullDumpReason = {
+    name: 'startup' | 'schedule';
+};
+export type PullDeltaReason = {
+    collection?: string;
+    affectedCollections?: string[];
+} & ({
+    name: 'startup';
+} | {
+    name: 'schedule';
+} | {
+    name: 'before-list';
+    caller: Caller;
+    filter: TPaginatedFilter;
+    projection: Projection;
+} | {
+    name: 'before-aggregate';
+    caller: Caller;
+    filter: TFilter;
+    aggregation: Aggregation;
+} | {
+    name: 'after-create';
+    caller: Caller;
+    records: RecordData[];
+} | {
+    name: 'after-update';
+    caller: Caller;
+    filter: TFilter;
+    patch: RecordData;
+} | {
+    name: 'after-delete';
+    caller: Caller;
+    filter: TFilter;
+});
+export type PullDeltaRequest = {
+    previousDeltaState: unknown;
+    cache: CacheDataSourceInterface;
+    affectedCollections: string[];
+    reasons: Array<PullDeltaReason & {
+        at: Date;
+    }>;
+};
+export type PullDumpRequest = {
+    previousDumpState: unknown;
+    cache: CacheDataSourceInterface;
+    reasons: Array<PullDumpReason & {
+        at: Date;
+    }>;
+};
+export type PushDeltaRequest = {
+    getPreviousDeltaState(): unknown;
+    cache: CacheDataSourceInterface;
+};
+export type PullDumpResponse = {
+    more: true;
+    entries: RecordDataWithCollection[];
+    nextDumpState: unknown;
+} | {
+    more: false;
+    entries: RecordDataWithCollection[];
+    nextDeltaState?: unknown;
+};
+export type PullDeltaResponse = {
+    more: boolean;
+    nextDeltaState: unknown;
+    newOrUpdatedEntries: RecordDataWithCollection[];
+    deletedEntries: RecordDataWithCollection[];
+};
+export type PushDeltaResponse = Omit<PullDeltaResponse, 'more' | 'nextDeltaState'> & {
+    nextDeltaState?: unknown;
+};
+export type FlattenOptions = {
+    [modelName: string]: {
+        asModels?: string[];
+        asFields?: Array<string | {
+            field: string;
+            level: number;
+        }>;
+    };
+};
+export type ReplicaDataSourceOptions = {
+    /** URL of the cache database (default to in-memory sqlite) */
+    cacheInto?: ConnectionOptions;
+    /**
+     * Prefix that should be used when creating the tables on the cache
+     * Defaults to 'forest_cache_'.
+     *
+     * Using a prefix allows to share the same database between multiple projects, environments, or
+     * datasources.
+     */
+    cacheNamespace?: string;
+    /** Schema options */
+    schema?: ValueOrPromiseOrFactory<CollectionReplicaSchema[]>;
+    flattenMode?: 'auto' | 'manual';
+    flattenOptions?: ValueOrPromiseOrFactory<FlattenOptions>;
+    /** Writing options */
+    createRecordHandler?: (collectionName: string, record: RecordData) => Promise<RecordData>;
+    updateRecordHandler?: (collectionName: string, record: RecordData) => Promise<void>;
+    deleteRecordHandler?: (collectionName: string, record: RecordData) => Promise<void>;
+    /** Push options */
+    pushDeltaHandler?: (request: PushDeltaRequest, onChanges: (changes: PushDeltaResponse) => Promise<void>) => void | Promise<void>;
+    /** Pull dump options */
+    pullDumpHandler?: (request: PullDumpRequest) => Promise<PullDumpResponse>;
+    pullDumpOnRestart?: boolean;
+    pullDumpOnSchedule?: string | string[];
+    /** Pull delta options */
+    pullDeltaHandler?: (request: PullDeltaRequest) => Promise<PullDeltaResponse>;
+    pullDeltaOnRestart?: boolean;
+    pullDeltaOnSchedule?: string | string[];
+    pullDeltaOnBeforeAccess?: boolean;
+    pullDeltaOnAfterWrite?: boolean;
+    /**
+     * Delay that should be waited before each cache access to give the opportunity for
+     * multiple requests to be batched together.
+     *
+     * Note that this delay will add latency to each request, so set it to a low value (< 100ms)
+     */
+    pullDeltaOnBeforeAccessDelay?: number;
+};
+export type ResolvedOptions = Pick<ReplicaDataSourceOptions, 'cacheInto' | 'cacheNamespace' | 'createRecordHandler' | 'updateRecordHandler' | 'deleteRecordHandler' | 'pullDeltaOnBeforeAccess' | 'pullDeltaOnAfterWrite'> & {
+    schema?: CollectionReplicaSchema[];
+    flattenSchema?: CollectionReplicaSchema[];
+    flattenOptions?: {
+        [modelName: string]: {
+            asModels?: string[];
+            asFields?: string[];
+        };
+    };
+    logger: Logger;
+    source: SynchronizationSource;
+};
+export interface SynchronizationTarget {
+    applyDump(changes: PullDumpResponse, firstPage: boolean): Promise<void>;
+    applyDelta(changes: PushDeltaResponse): Promise<void>;
+}
+export interface SynchronizationSource {
+    requestCache: CacheDataSourceInterface;
+    start(target: SynchronizationTarget): Promise<void>;
+    queuePullDump(reason: PullDumpReason): Promise<void>;
+    queuePullDelta(reason: PullDeltaReason): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLeafField = void 0;
+/// //////
+// Schema
+/// //////
+function isLeafField(field) {
+    return typeof field === 'object' && 'type' in field;
+}
+exports.isLeafField = isLeafField;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvdHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBZ0JBLFVBQVU7QUFDVixTQUFTO0FBQ1QsVUFBVTtBQUVWLFNBQWdCLFdBQVcsQ0FBQyxLQUFZO0lBQ3RDLE9BQU8sT0FBTyxLQUFLLEtBQUssUUFBUSxJQUFJLE1BQU0sSUFBSSxLQUFLLENBQUM7QUFDdEQsQ0FBQztBQUZELGtDQUVDIn0=

package/dist/utils.d.ts

@@ -0,0 +1,7 @@
+import type { CollectionReplicaSchema } from './types';
+import type { RecordData } from '@forestadmin/datasource-toolkit';
+export declare function escape(strings: TemplateStringsArray, ...exps: unknown[]): string;
+export declare function deepclone(any: unknown): any;
+export declare function extractValue(record: RecordData, path: string, remove: boolean): any;
+export declare function getRecordId(fields: CollectionReplicaSchema['fields'], record: RecordData): unknown;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRecordId = exports.extractValue = exports.deepclone = exports.escape = void 0;
+function escape(strings, ...exps) {
+    return strings.reduce((acc, str, i) => acc + str + (exps[i] ?? ''), '').replace(/\./g, '_');
+}
+exports.escape = escape;
+function deepclone(any) {
+    return JSON.parse(JSON.stringify(any));
+}
+exports.deepclone = deepclone;
+function extractValue(record, path, remove) {
+    if (!path)
+        return record;
+    const [prefix, suffix] = path.split(/\.(.*)/);
+    const value = extractValue(record?.[prefix], suffix, remove);
+    if (remove && record && (!suffix || !Object.keys(record?.[prefix] ?? {}).length))
+        delete record[prefix];
+    return value;
+}
+exports.extractValue = extractValue;
+function getRecordId(fields, record) {
+    // eslint-disable-next-line no-underscore-dangle
+    if (record._fid)
+        return record._fid;
+    const pks = Object.entries(fields)
+        .filter(([, v]) => 'type' in v && v.isPrimaryKey)
+        .map(([k]) => record[k]);
+    if (pks.length === 0)
+        throw new Error('No primary key found');
+    else if (pks.length === 1)
+        return pks[0];
+}
+exports.getRecordId = getRecordId;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvdXRpbHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBR0EsU0FBZ0IsTUFBTSxDQUFDLE9BQTZCLEVBQUUsR0FBRyxJQUFlO0lBQ3RFLE9BQU8sT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQUFDLEdBQUcsRUFBRSxHQUFHLEVBQUUsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxHQUFHLEdBQUcsR0FBRyxHQUFHLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxJQUFJLEVBQUUsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxLQUFLLEVBQUUsR0FBRyxDQUFDLENBQUM7QUFDOUYsQ0FBQztBQUZELHdCQUVDO0FBRUQsU0FBZ0IsU0FBUyxDQUFDLEdBQVk7SUFDcEMsT0FBTyxJQUFJLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQztBQUN6QyxDQUFDO0FBRkQsOEJBRUM7QUFFRCxTQUFnQixZQUFZLENBQUMsTUFBa0IsRUFBRSxJQUFZLEVBQUUsTUFBZTtJQUM1RSxJQUFJLENBQUMsSUFBSTtRQUFFLE9BQU8sTUFBTSxDQUFDO0lBRXpCLE1BQU0sQ0FBQyxNQUFNLEVBQUUsTUFBTSxDQUFDLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxRQUFRLENBQUMsQ0FBQztJQUM5QyxNQUFNLEtBQUssR0FBRyxZQUFZLENBQUMsTUFBTSxFQUFFLENBQUMsTUFBTSxDQUFDLEVBQUUsTUFBTSxFQUFFLE1BQU0sQ0FBQyxDQUFDO0lBQzdELElBQUksTUFBTSxJQUFJLE1BQU0sSUFBSSxDQUFDLENBQUMsTUFBTSxJQUFJLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxNQUFNLEVBQUUsQ0FBQyxNQUFNLENBQUMsSUFBSSxFQUFFLENBQUMsQ0FBQyxNQUFNLENBQUM7UUFDOUUsT0FBTyxNQUFNLENBQUMsTUFBTSxDQUFDLENBQUM7SUFFeEIsT0FBTyxLQUFLLENBQUM7QUFDZixDQUFDO0FBVEQsb0NBU0M7QUFFRCxTQUFnQixXQUFXLENBQ3pCLE1BQXlDLEVBQ3pDLE1BQWtCO0lBRWxCLGdEQUFnRDtJQUNoRCxJQUFJLE1BQU0sQ0FBQyxJQUFJO1FBQUUsT0FBTyxNQUFNLENBQUMsSUFBSSxDQUFDO0lBRXBDLE1BQU0sR0FBRyxHQUFHLE1BQU0sQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDO1NBQy9CLE1BQU0sQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsTUFBTSxJQUFJLENBQUMsSUFBSSxDQUFDLENBQUMsWUFBWSxDQUFDO1NBQ2hELEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLEVBQUUsRUFBRSxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDO0lBRTNCLElBQUksR0FBRyxDQUFDLE1BQU0sS0FBSyxDQUFDO1FBQUUsTUFBTSxJQUFJLEtBQUssQ0FBQyxzQkFBc0IsQ0FBQyxDQUFDO1NBQ3pELElBQUksR0FBRyxDQUFDLE1BQU0sS0FBSyxDQUFDO1FBQUUsT0FBTyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUM7QUFDM0MsQ0FBQztBQWJELGtDQWFDIn0=

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forestadmin/datasource-replica",
-  "version": "1.0.0",
+  "version": "1.0.2-alpha-widgets.1",
   "main": "dist/index.js",
   "license": "GPL-3.0",
   "publishConfig": {
@@ -12,8 +12,8 @@
     "directory": "packages/datasource-replica"
   },
   "files": [
-    "dist/src/**/*.js",
-    "dist/src/**/*.d.ts"
+    "dist/**/*.js",
+    "dist/**/*.d.ts"
   ],
   "scripts": {
     "build": "tsc",
@@ -23,10 +23,10 @@
     "test": "jest"
   },
   "dependencies": {
-    "@forestadmin/datasource-customizer": "1.15.0",
-    "@forestadmin/datasource-sequelize": "1.5.0",
-    "@forestadmin/datasource-sql": "1.7.10",
-    "@forestadmin/datasource-toolkit": "1.9.0",
+    "@forestadmin/datasource-customizer": "1.16.0-alpha-widgets.1",
+    "@forestadmin/datasource-sequelize": "1.5.1-alpha-widgets.1",
+    "@forestadmin/datasource-sql": "1.7.11-alpha-widgets.1",
+    "@forestadmin/datasource-toolkit": "1.10.0-alpha-widgets.1",
     "croner": "^6.0.6",
     "sequelize": "^6.28.0"
   }