@routier/core 0.2.0 → 0.2.1

package/dist/plugins/index.js

@@ -6,10 +6,20 @@ __webpack_require__.d(__webpack_exports__, {
   assertInstanceOf: () => (assertInstanceOf),
   assertIsArray: () => (assertIsArray),
   assertIsNotNull: () => (assertIsNotNull),
-  assertString: () => (assertString)
+  assertIsNumber: () => (assertIsNumber),
+  assertString: () => (assertString),
+  isComparatorExpression: () => (isComparatorExpression),
+  isEmptyExpression: () => (isEmptyExpression),
+  isExpression: () => (isExpression),
+  isNotParsableExpression: () => (isNotParsableExpression),
+  isOperatorExpression: () => (isOperatorExpression),
+  isPropertyExpression: () => (isPropertyExpression),
+  isValueExpression: () => (isValueExpression)
 });
+/* import */ var _expressions_constants__rspack_import_1 = __webpack_require__("./src/expressions/constants.ts");
 /* import */ var _utilities__rspack_import_0 = __webpack_require__("./src/utilities/dates.ts");
 
+
 function assertDate(data) {
     if ((0,_utilities__rspack_import_0.isDate)(data) === false) {
         throw new TypeError('Value is not a Date');
@@ -41,209 +51,76 @@ function assertInstanceOf(value, Instance) {
         return;
     }
     if (value != null && typeof value === "object" && "constructor" in value) {
-        throw new TypeError(`Value is not instance of type.  Type: ${value.constructor.name}`);
+        throw new TypeError(`value is not instance of type.  Type: ${value.constructor.name}`);
     }
-    throw new TypeError(`Value is not instance of type`);
+    throw new TypeError(`value is not instance of type`);
 }
-
-
-},
-"./src/collections/Changes.ts"(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
-__webpack_require__.r(__webpack_exports__);
-__webpack_require__.d(__webpack_exports__, {
-  BulkPersistChanges: () => (BulkPersistChanges),
-  BulkPersistResult: () => (BulkPersistResult),
-  SchemaPersistChanges: () => (SchemaPersistChanges),
-  SchemaPersistResult: () => (SchemaPersistResult)
-});
-/* import */ var _TagCollection__rspack_import_0 = __webpack_require__("./src/collections/TagCollection.ts");
-
-class BulkPersistResult extends Map {
-    resolve(schemaId) {
-        if (this.has(schemaId)) {
-            return this.get(schemaId);
-        }
-        this.set(schemaId, new SchemaPersistResult());
-        return this.get(schemaId);
-    }
-    get(schemaId) {
-        return super.get(schemaId);
-    }
-    get aggregate() {
-        return {
-            size: this.aggregateSize,
-            adds: this.aggregateAddsSize,
-            updates: this.aggregateUpdatesSize,
-            removes: this.aggregateRemovesSize
-        };
-    }
-    get aggregateSize() {
-        let count = 0;
-        for (const [, result] of this) {
-            count += result.total;
-        }
-        return count;
-    }
-    get aggregateAddsSize() {
-        let count = 0;
-        for (const [, result] of this) {
-            count += result.adds.length;
-        }
-        return count;
-    }
-    get aggregateUpdatesSize() {
-        let count = 0;
-        for (const [, result] of this) {
-            count += result.updates.length;
-        }
-        return count;
-    }
-    get aggregateRemovesSize() {
-        let count = 0;
-        for (const [, result] of this) {
-            count += result.removes.length;
-        }
-        return count;
+function assertIsNumber(value) {
+    if (typeof value !== "number") {
+        throw new TypeError("value is not of type `number`");
     }
 }
-class BulkPersistChanges extends Map {
-    resolve(schemaId) {
-        if (this.has(schemaId)) {
-            return this.get(schemaId);
-        }
-        this.set(schemaId, new SchemaPersistChanges());
-        return this.get(schemaId);
-    }
-    get(schemaId) {
-        return super.get(schemaId);
-    }
-    get aggregate() {
-        return {
-            size: this.aggregateSize,
-            adds: this.aggregateAddsSize,
-            updates: this.aggregateUpdatesSize,
-            removes: this.aggregateRemovesSize
-        };
-    }
-    get aggregateSize() {
-        let count = 0;
-        for (const [, result] of this) {
-            count += result.total;
-        }
-        return count;
-    }
-    get aggregateAddsSize() {
-        let count = 0;
-        for (const [, result] of this) {
-            count += result.adds.length;
-        }
-        return count;
-    }
-    get aggregateUpdatesSize() {
-        let count = 0;
-        for (const [, result] of this) {
-            count += result.updates.length;
-        }
-        return count;
-    }
-    get aggregateRemovesSize() {
-        let count = 0;
-        for (const [, result] of this) {
-            count += result.removes.length;
-        }
-        return count;
-    }
-    /**
-     * Ensures the result has the same result sets as the change sets
-     * @returns
-     */
-    toResult() {
-        const result = new BulkPersistResult();
-        for (const [schemaId] of this) {
-            result.set(schemaId, new SchemaPersistResult());
-        }
-        return result;
-    }
+function isObjectWithType(value) {
+    return typeof value === "object" && value !== null && "type" in value;
 }
-class SchemaPersistChanges {
-    adds = [];
-    updates = [];
-    removes = [];
-    tags = new _TagCollection__rspack_import_0.TagCollection();
-    get hasItems() {
-        return this.total > 0;
-    }
-    get total() {
-        return this.adds.length + this.updates.length + this.removes.length;
-    }
+/**
+ * Type guard: narrows `value` to `Expression` when it is an object with a valid `type` property.
+ */
+function isExpression(value) {
+    return isObjectWithType(value) && _expressions_constants__rspack_import_1.EXPRESSION_TYPES.includes(value.type);
 }
-class SchemaPersistResult {
-    adds = [];
-    updates = [];
-    removes = [];
-    get hasItems() {
-        return this.total > 0;
-    }
-    get total() {
-        return this.adds.length + this.updates.length + this.removes.length;
-    }
+/**
+ * Type guard: narrows `value` to `OperatorExpression` when it is an object with `type === "operator"`.
+ */
+function isOperatorExpression(value) {
+    return isObjectWithType(value) && value.type === "operator";
+}
+/**
+ * Type guard: narrows `value` to `ComparatorExpression` when it is an object with `type === "comparator"`.
+ */
+function isComparatorExpression(value) {
+    return isObjectWithType(value) && value.type === "comparator";
+}
+/**
+ * Type guard: narrows `value` to `PropertyExpression` when it is an object with `type === "property"`.
+ */
+function isPropertyExpression(value) {
+    return isObjectWithType(value) && value.type === "property";
+}
+/**
+ * Type guard: narrows `value` to `ValueExpression` when it is an object with `type === "value"`.
+ */
+function isValueExpression(value) {
+    return isObjectWithType(value) && value.type === "value";
+}
+/**
+ * Type guard: narrows `value` to `EmptyExpression` when it is an object with `type === "empty"`.
+ */
+function isEmptyExpression(value) {
+    return isObjectWithType(value) && value.type === "empty";
+}
+/**
+ * Type guard: narrows `value` to `NotParsableExpression` when it is an object with `type === "not-parsable"`.
+ */
+function isNotParsableExpression(value) {
+    return isObjectWithType(value) && value.type === "not-parsable";
 }
 
 
 },
-"./src/collections/TagCollection.ts"(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+"./src/expressions/constants.ts"(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
-  TagCollection: () => (TagCollection)
+  EXPRESSION_TYPES: () => (EXPRESSION_TYPES)
 });
-class TagCollection {
-    data = new Map();
-    _size = 0;
-    get size() {
-        return this._size;
-    }
-    get(key) {
-        return this.data.get(key);
-    }
-    has(key) {
-        return this.data.has(key);
-    }
-    set(key, tag) {
-        this._size++;
-        return this.data.set(key, tag);
-    }
-    delete(key) {
-        const result = this.data.delete(key);
-        if (result) {
-            this._size--;
-        }
-        return result;
-    }
-    setMany(keys, tag) {
-        this._size += keys.length;
-        for (let i = 0, length = keys.length; i < length; i++) {
-            const key = keys[i];
-            this.set(key, tag);
-        }
-    }
-    combine(tags) {
-        for (const [key, value] of tags) {
-            this.data.set(key, value);
-        }
-    }
-    values() {
-        return this.data.values();
-    }
-    keys() {
-        return this.data.keys();
-    }
-    [Symbol.dispose]() {
-        this.data.clear();
-    }
-    [Symbol.iterator]() {
-        return this.data[Symbol.iterator]();
-    }
-}
+const EXPRESSION_TYPES = [
+    "operator",
+    "comparator",
+    "property",
+    "value",
+    "empty",
+    "not-parsable",
+];
 
 
 },
@@ -251,8 +128,7 @@ class TagCollection {
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
   forEach: () => (forEach),
-  getProperties: () => (getProperties),
-  isPropertyExpression: () => (isPropertyExpression)
+  getProperties: () => (getProperties)
 });
 /**
  * Extracts all properties referenced in an expression
@@ -277,9 +153,6 @@ function getProperties(expression) {
     traverse(expression);
     return properties;
 }
-function isPropertyExpression(expression) {
-    return expression.type === "property";
-}
 function forEach(expression, callback) {
     function traverse(expr) {
         // Call the callback for this expression
@@ -304,37 +177,6 @@ function forEach(expression, callback) {
 }
 
 
-},
-"./src/performance/index.ts"(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
-__webpack_require__.r(__webpack_exports__);
-__webpack_require__.d(__webpack_exports__, {
-  measure: () => (measure),
-  now: () => (now)
-});
-/* import */ var _utilities__rspack_import_0 = __webpack_require__("./src/utilities/logger.ts");
-
-const measurements = {};
-const now = () => {
-    if (typeof performance !== 'undefined' && performance.now) {
-        // Browser or modern Node.js
-        return performance.now();
-    }
-    // Fallback for older environments
-    return Date.now();
-};
-const measure = {
-    start: (name) => {
-        measurements[name] = now();
-    },
-    end: (name) => {
-        const start = measurements[name];
-        delete measurements[name];
-        const delta = now() - start;
-        _utilities__rspack_import_0.logger.log(`[ROUTIER] - Performance: ${name} took ${delta}`);
-    }
-};
-
-
 },
 "./src/pipeline/TrampolinePipeline.ts"(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
 __webpack_require__.r(__webpack_exports__);
@@ -644,9 +486,9 @@ class EphemeralDataPlugin {
                         // For adds-only operations, we can skip load for better performance
                         const needsLoad = updatesLength > 0 || removesLength > 0;
                         const processChanges = () => {
-                            result.adds = new Array(addsLength);
-                            result.updates = new Array(updatesLength);
-                            result.removes = new Array(removesLength);
+                            result.adds = Array.from({ length: addsLength });
+                            result.updates = Array.from({ length: updatesLength });
+                            result.removes = Array.from({ length: removesLength });
                             for (let j = 0; j < addsLength; j++) {
                                 const item = adds[j];
                                 collection.add(item);
@@ -718,7 +560,7 @@ class EphemeralDataPlugin {
                 }
                 const records = collection.records;
                 const length = records.length;
-                const cloned = new Array(length);
+                const cloned = Array.from({ length });
                 for (let i = 0; i < length; i++) {
                     cloned[i] = schema.clone(records[i]);
                 }
@@ -795,8 +637,10 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
   QueryOptionsCollection: () => (QueryOptionsCollection)
 });
+/* import */ var _assertions__rspack_import_1 = __webpack_require__("./src/assertions/index.ts");
 /* import */ var _expressions_utils__rspack_import_0 = __webpack_require__("./src/expressions/utils.ts");
 
+
 class QueryOptionsCollection {
     options = new Map();
     nextExecutionTarget = "database";
@@ -833,7 +677,7 @@ class QueryOptionsCollection {
             }
             else {
                 (0,_expressions_utils__rspack_import_0.forEach)(filterValue.expression, (expression) => {
-                    if ((0,_expressions_utils__rspack_import_0.isPropertyExpression)(expression) && expression.property.isUnmapped) {
+                    if ((0,_assertions__rspack_import_1.isPropertyExpression)(expression) && expression.property.isUnmapped) {
                         // Cut over to memory execution, unmapped properties are not in the database and
                         // cannot be queried
                         this.nextExecutionTarget = "memory";
@@ -873,6 +717,10 @@ class QueryOptionsCollection {
             database: databaseQueryOptionsCollection
         };
     }
+    hasTransformations() {
+        const transformationOptions = ["map", "group", "min", "max", "count", "sum"];
+        return transformationOptions.some((name) => this.options.has(name));
+    }
     has(name) {
         return this.options.has(name);
     }
@@ -942,358 +790,6 @@ var QueryOrdering;
 })(QueryOrdering || (QueryOrdering = {}));
 
 
-},
-"./src/plugins/replication/OptimisticReplicationDbPlugin.ts"(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
-__webpack_require__.r(__webpack_exports__);
-__webpack_require__.d(__webpack_exports__, {
-  OptimisticReplicationDbPlugin: () => (OptimisticReplicationDbPlugin)
-});
-/* import */ var _results__rspack_import_2 = __webpack_require__("./src/results/Result.ts");
-/* import */ var _pipeline__rspack_import_5 = __webpack_require__("./src/pipeline/TrampolinePipeline.ts");
-/* import */ var _query__rspack_import_1 = __webpack_require__("./src/plugins/query/Query.ts");
-/* import */ var _utilities__rspack_import_0 = __webpack_require__("./src/utilities/uuid.ts");
-/* import */ var _utilities__rspack_import_6 = __webpack_require__("./src/utilities/replication.ts");
-/* import */ var _collections__rspack_import_3 = __webpack_require__("./src/collections/Changes.ts");
-/* import */ var _performance__rspack_import_4 = __webpack_require__("./src/performance/index.ts");
-
-
-7;
-
-
-
-
-const getMemoryPluginCollectionSize = (plugin, schema) => {
-    if ("getCollectionSize" in plugin && typeof plugin.getCollectionSize === "function") {
-        return plugin.getCollectionSize(schema.collectionName);
-    }
-    throw new Error("Cannot get size of collection for MemoryPlugin, not an instance of MemoryPlugin");
-};
-const MAX_HYDRATION_WAIT_MS = 60_000; // 60 seconds max wait
-const HYDRATION_POLL_INTERVAL_MS = 10; // Check ever 10 ms
-class OptimisticReplicationDbPlugin {
-    plugins;
-    // Give more control over hydration, if the plugin is destroyed, so is the in memory data.
-    // It is up to the dev to control the lifecycle
-    collectionHydrationStatuses = new Map();
-    /**
-     * Creates a new OptimisticDbPluginReplicator that coordinates operations between a source database and its replicas.
-     *
-     * @param plugins Configuration object containing the source, read, and replica database plugins
-     * @param plugins.source The primary database plugin that will receive all operations first
-     * @param plugins.read The read-optimized plugin (typically a memory plugin) used for fast queries
-     * @param plugins.replicas Additional database plugins that will replicate operations from the source
-     */
-    constructor(plugins) {
-        this.plugins = plugins;
-    }
-    /**
-     * Will query the read plugin if there is one, otherwise the source plugin will be queried
-    */
-    query(event, done) {
-        try {
-            const readPlugin = this.plugins.read;
-            const sourcePlugin = this.plugins.source;
-            const collectionSize = getMemoryPluginCollectionSize(this.plugins.read, event.operation.schema);
-            if (collectionSize === 0 && this.collectionHydrationStatuses.get(event.operation.schema.collectionName) == null) {
-                // Notify the cache that the db was hydrated right away
-                this.collectionHydrationStatuses.set(event.operation.schema.collectionName, "pending");
-                // nothing is hydrated, let's try and hydrate before querying
-                // Memory plugin might not be hydrated, lets hydrate it for the targeted schema only,
-                // Other queries will do the same and hydrate if needed
-                // We want to select all data here
-                sourcePlugin.query({
-                    id: (0,_utilities__rspack_import_0.uuid)(8),
-                    schemas: event.schemas,
-                    source: "collection",
-                    // Select All Data
-                    operation: _query__rspack_import_1.Query.EMPTY(event.operation.schema)
-                }, (sourceResult) => {
-                    if (sourceResult.ok === _results__rspack_import_2.Result.ERROR) {
-                        // Notify that hydration failed
-                        this.collectionHydrationStatuses.set(event.operation.schema.collectionName, "rejected");
-                        done(sourceResult);
-                        return;
-                    }
-                    // Source plugin can have no data, still should succeed
-                    if (Array.isArray(sourceResult.data.value) === false) {
-                        // Notify that hydration failed
-                        this.collectionHydrationStatuses.set(event.operation.schema.collectionName, "rejected");
-                        done(_results__rspack_import_2.PluginEventResult.error(event.id, "Query result is not an array"));
-                        return;
-                    }
-                    const changesCollection = new _collections__rspack_import_3.BulkPersistChanges();
-                    const schemaChanges = changesCollection.resolve(event.operation.schema.id);
-                    // Add the existing items into the persist payload as adds
-                    schemaChanges.adds = sourceResult.data.value;
-                    readPlugin.bulkPersist({
-                        id: (0,_utilities__rspack_import_0.uuid)(8),
-                        schemas: event.schemas,
-                        operation: changesCollection,
-                        source: "collection",
-                    }, (readPersistResult) => {
-                        if (readPersistResult.ok === _results__rspack_import_2.Result.ERROR) {
-                            // Notify that hydration failed
-                            this.collectionHydrationStatuses.set(event.operation.schema.collectionName, "rejected");
-                            done(readPersistResult);
-                            return;
-                        }
-                        this.collectionHydrationStatuses.set(event.operation.schema.collectionName, "fulfilled");
-                        // requery the read plugin
-                        readPlugin.query(event, done);
-                    });
-                });
-                return;
-            }
-            if (this.collectionHydrationStatuses.get(event.operation.schema.collectionName) === "rejected") {
-                done(_results__rspack_import_2.PluginEventResult.error(event.id, "Hydration failed, unable to query read plugin"));
-                return;
-            }
-            // If hydration is pending, do not query empty collection, wait for hydration
-            if (this.collectionHydrationStatuses.get(event.operation.schema.collectionName) === "pending") {
-                const start = (0,_performance__rspack_import_4.now)();
-                const pollHydrationStatus = () => {
-                    const delta = (0,_performance__rspack_import_4.now)() - start;
-                    if (delta > MAX_HYDRATION_WAIT_MS) {
-                        this.collectionHydrationStatuses.set(event.operation.schema.collectionName, "rejected");
-                        done(_results__rspack_import_2.PluginEventResult.error(event.id, `Hydration timeout: exceeded maximum wait time of ${MAX_HYDRATION_WAIT_MS}ms`));
-                        return;
-                    }
-                    if (this.collectionHydrationStatuses.get(event.operation.schema.collectionName) === "rejected") {
-                        done(_results__rspack_import_2.PluginEventResult.error(event.id, "Hydration failed, unable to query read plugin"));
-                        return;
-                    }
-                    if (this.collectionHydrationStatuses.get(event.operation.schema.collectionName) === "fulfilled") {
-                        // Hydration completed successfully, proceed with query
-                        readPlugin.query(event, (readResult) => {
-                            if (readResult.ok === _results__rspack_import_2.Result.ERROR) {
-                                done(readResult);
-                                return;
-                            }
-                            done(readResult);
-                        });
-                        return;
-                    }
-                    // Still pending, check again after interval
-                    setTimeout(pollHydrationStatus, HYDRATION_POLL_INTERVAL_MS);
-                };
-                pollHydrationStatus();
-                return;
-            }
-            // Collection is hydrated for the targeted collection and should be in sync
-            readPlugin.query(event, (readResult) => {
-                if (readResult.ok === _results__rspack_import_2.Result.ERROR) {
-                    done(readResult);
-                    return;
-                }
-                done(readResult);
-                return;
-            });
-        }
-        catch (e) {
-            done(_results__rspack_import_2.PluginEventResult.error(event.id, e));
-        }
-    }
-    destroy(event, done) {
-        try {
-            const workPipeline = new _pipeline__rspack_import_5.WorkPipeline();
-            const plugins = [this.plugins.source, ...this.plugins.replicas];
-            for (let i = 0, length = plugins.length; i < length; i++) {
-                workPipeline.pipe((done) => plugins[i].destroy(event, done));
-            }
-            workPipeline.filter((result) => {
-                if (result.ok === _results__rspack_import_2.Result.ERROR) {
-                    done(_results__rspack_import_2.PluginEventResult.error(event.id, result.error));
-                    return;
-                }
-                done(_results__rspack_import_2.PluginEventResult.success(event.id));
-            });
-        }
-        catch (e) {
-            done(_results__rspack_import_2.PluginEventResult.error(event.id, e));
-        }
-    }
-    bulkPersist(event, done) {
-        try {
-            const workPipeline = new _pipeline__rspack_import_5.WorkPipeline();
-            const deferredPlugins = [this.plugins.source, ...this.plugins.replicas];
-            // Since we are doing optimistic, we insert into the read plugin first and assume later plugins will succeed
-            // This means the read plugin will generate ids for the source plugin
-            this.plugins.read.bulkPersist({
-                id: (0,_utilities__rspack_import_0.uuid)(8),
-                operation: event.operation,
-                schemas: event.schemas,
-                source: "data-store",
-            }, (r) => {
-                if (r.ok !== _results__rspack_import_2.Result.SUCCESS) {
-                    done(r);
-                    return;
-                }
-                // optimistically call done and still continue saving the rest of the data.  We read from the memory
-                // db anyways
-                done(r);
-                const optimisticBulkPersistChanges = new _collections__rspack_import_3.BulkPersistChanges();
-                // make sure we swap the adds here, that way we can make sure other persist events
-                // don't take their additions and try to change subsequent calls
-                (0,_utilities__rspack_import_6.resolveBulkPersistChanges)(event, r.data, optimisticBulkPersistChanges);
-                for (let i = 0, length = deferredPlugins.length; i < length; i++) {
-                    workPipeline.pipe((d) => {
-                        const plugin = deferredPlugins[i];
-                        plugin.bulkPersist({
-                            id: (0,_utilities__rspack_import_0.uuid)(8),
-                            operation: optimisticBulkPersistChanges,
-                            schemas: event.schemas,
-                            source: "data-store",
-                        }, (r) => {
-                            if (r.ok === _results__rspack_import_2.Result.ERROR) {
-                                d(r);
-                                return;
-                            }
-                            d(_results__rspack_import_2.Result.success());
-                        });
-                    });
-                }
-                setTimeout(() => {
-                    workPipeline.filter((_) => {
-                        // no-op for now, maybe implement retries?
-                    });
-                }, 5);
-            });
-        }
-        catch (e) {
-            done(_results__rspack_import_2.PluginEventResult.error(event.id, e));
-        }
-    }
-}
-
-
-},
-"./src/plugins/replication/ReplicationDbPlugin.ts"(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
-__webpack_require__.r(__webpack_exports__);
-__webpack_require__.d(__webpack_exports__, {
-  ReplicationDbPlugin: () => (ReplicationDbPlugin)
-});
-/* import */ var _results__rspack_import_0 = __webpack_require__("./src/results/Result.ts");
-/* import */ var _pipeline__rspack_import_1 = __webpack_require__("./src/pipeline/TrampolinePipeline.ts");
-/* import */ var _collections__rspack_import_2 = __webpack_require__("./src/collections/Changes.ts");
-/* import */ var _utilities__rspack_import_3 = __webpack_require__("./src/utilities/replication.ts");
-
-
-
-
-class ReplicationDbPlugin {
-    plugins;
-    /**
-     * Creates a new DbPluginReplicator that coordinates operations between a source database and its replicas.
-     *
-     * @param plugins Configuration object containing the source, read (optional), and replica database plugins
-     * @param plugins.source The primary database plugin that will receive all operations first
-     * @param plugins.read Optional read-optimized plugin (typically a memory plugin) used for fast queries
-     * @param plugins.replicas Additional database plugins that will replicate operations from the source
-     */
-    constructor(plugins) {
-        this.plugins = plugins;
-    }
-    /**
-     * Will query the read plugin if there is one, otherwise the source plugin will be queried
-    */
-    query(event, done) {
-        try {
-            const plugin = this.plugins.read != null ? this.plugins.read : this.plugins.source;
-            plugin.query(event, done);
-        }
-        catch (e) {
-            done(_results__rspack_import_0.PluginEventResult.error(event.id, e));
-        }
-    }
-    destroy(event, done) {
-        try {
-            const pipeline = new _pipeline__rspack_import_1.WorkPipeline();
-            const plugins = [this.plugins.source, ...this.plugins.replicas];
-            for (let i = 0, length = plugins.length; i < length; i++) {
-                pipeline.pipe((done) => plugins[i].destroy(event, done));
-            }
-            pipeline.filter((result) => {
-                if (result.ok === _results__rspack_import_0.Result.ERROR) {
-                    done(_results__rspack_import_0.PluginEventResult.error(event.id, result.error));
-                    return;
-                }
-                done(_results__rspack_import_0.PluginEventResult.success(event.id));
-            });
-        }
-        catch (e) {
-            done(_results__rspack_import_0.PluginEventResult.error(event.id, e));
-        }
-    }
-    bulkPersist(event, done) {
-        try {
-            // insert into the source first to generate any ids, then take the result and persist that into the replicas
-            const pipeline = new _pipeline__rspack_import_1.WorkPipeline();
-            const plugins = [this.plugins.source, ...this.plugins.replicas];
-            if (this.plugins.read != null) {
-                plugins.push(this.plugins.read);
-            }
-            const result = new _collections__rspack_import_2.BulkPersistResult();
-            for (let i = 0, length = plugins.length; i < length; i++) {
-                pipeline.pipe((d) => {
-                    const plugin = plugins[i];
-                    // source is first
-                    if (i === 0) {
-                        plugin.bulkPersist(event, (r) => {
-                            if (r.ok === _results__rspack_import_0.Result.ERROR) {
-                                d(r);
-                                return;
-                            }
-                            // make sure we swap the adds here, that way we can make sure other persist events
-                            // don't take their additions and try to change subsequent calls
-                            (0,_utilities__rspack_import_3.resolveBulkPersistChanges)(event, r.data, event.operation);
-                            d(_results__rspack_import_0.Result.success());
-                        });
-                        return;
-                    }
-                    plugin.bulkPersist(event, (r) => {
-                        if (r.ok === _results__rspack_import_0.Result.ERROR) {
-                            d(r);
-                            return;
-                        }
-                        d(_results__rspack_import_0.Result.success());
-                    });
-                });
-            }
-            let successCount = 0;
-            pipeline.filter((r) => {
-                if (r.ok === _results__rspack_import_0.Result.ERROR) {
-                    if (successCount > 0) {
-                        done(_results__rspack_import_0.PluginEventResult.partial(event.id, result, r.error));
-                        return;
-                    }
-                    done(_results__rspack_import_0.PluginEventResult.error(event.id, r.error));
-                    return;
-                }
-                successCount++;
-                done(_results__rspack_import_0.PluginEventResult.success(event.id, result));
-            });
-        }
-        catch (e) {
-            done(_results__rspack_import_0.PluginEventResult.error(event.id, e));
-        }
-    }
-}
-
-
-},
-"./src/plugins/replication/index.ts"(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
-__webpack_require__.r(__webpack_exports__);
-__webpack_require__.d(__webpack_exports__, {
-  OptimisticReplicationDbPlugin: () => (/* reexport safe */ _OptimisticReplicationDbPlugin__rspack_import_1.OptimisticReplicationDbPlugin),
-  ReplicationDbPlugin: () => (/* reexport safe */ _ReplicationDbPlugin__rspack_import_0.ReplicationDbPlugin)
-});
-/* import */ var _ReplicationDbPlugin__rspack_import_0 = __webpack_require__("./src/plugins/replication/ReplicationDbPlugin.ts");
-/* import */ var _OptimisticReplicationDbPlugin__rspack_import_1 = __webpack_require__("./src/plugins/replication/OptimisticReplicationDbPlugin.ts");
-
-
-
-
-
 },
 "./src/plugins/translators/DataTranslator.ts"(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
 __webpack_require__.r(__webpack_exports__);
@@ -1325,16 +821,17 @@ class DataTranslator {
         this.query = query;
     }
     translate(data) {
+        const isTransformed = this.query.options.hasTransformations();
         this.query.options.forEach(item => {
             data = this.functionMap[item.name](data, item);
         });
         if (Array.isArray(data)) {
-            return new _TranslatedArrayValue__rspack_import_0.TranslatedArrayValue(data);
+            return new _TranslatedArrayValue__rspack_import_0.TranslatedArrayValue(data, isTransformed);
         }
         if (this.query.options.has("group")) {
-            return new _TranslatedGroupValue__rspack_import_1.TranslatedGroupValue(data);
+            return new _TranslatedGroupValue__rspack_import_1.TranslatedGroupValue(data, isTransformed);
         }
-        return new _TranslatedSingleValue__rspack_import_2.TranslatedSingleValue(data);
+        return new _TranslatedSingleValue__rspack_import_2.TranslatedSingleValue(data, isTransformed);
     }
 }
 
@@ -1369,7 +866,7 @@ class JsonTranslator extends _DataTranslator__rspack_import_0.DataTranslator {
         if (Array.isArray(data) == false) {
             throw new Error("Can only map an array of data");
         }
-        const response = new Array(data.length);
+        const response = Array.from({ length: data.length });
         for (let i = 0, length = data.length; i < length; i++) {
             for (let j = 0, l = option.value.fields.length; j < l; j++) {
                 const field = option.value.fields[j];
@@ -1632,8 +1129,12 @@ __webpack_require__.d(__webpack_exports__, {
 });
 class TranslatedArrayValue {
     value;
-    constructor(value) {
+    isTransformed;
+    isEmpty;
+    constructor(value, isTransformed) {
         this.value = value;
+        this.isEmpty = value == null || (Array.isArray(value) && value.length === 0);
+        this.isTransformed = isTransformed;
     }
     forEach(callback) {
         const data = this.value;
@@ -1656,8 +1157,12 @@ __webpack_require__.d(__webpack_exports__, {
 });
 class TranslatedGroupValue {
     value;
-    constructor(value) {
+    isTransformed;
+    isEmpty;
+    constructor(value, isTransformed) {
         this.value = value;
+        this.isEmpty = value == null;
+        this.isTransformed = isTransformed;
     }
     forEach(callback) {
         const group = this.value;
@@ -1685,8 +1190,12 @@ __webpack_require__.d(__webpack_exports__, {
 });
 class TranslatedSingleValue {
     value;
-    constructor(value) {
+    isTransformed;
+    isEmpty;
+    constructor(value, isTransformed) {
         this.value = value;
+        this.isEmpty = value == null;
+        this.isTransformed = isTransformed;
     }
     forEach(callback) {
         const result = callback(this.value);
@@ -1829,16 +1338,27 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
   logger: () => (logger)
 });
-const isDevelopment = () => {
-    if (typeof process === 'undefined' || process.env == null) {
-        return false;
-    }
-    const env = "development"?.toLowerCase();
-    return env === 'dev' || env === 'development' || env === 'test';
+/**
+ * Enable logging by setting `globalThis.__ROUTIER_DEBUG__ = true` before any routier code runs.
+ */
+const shouldLog = () => {
+    if (typeof globalThis !== 'undefined') {
+        const g = globalThis;
+        if (g.__ROUTIER_DEBUG__ === true)
+            return true;
+    }
+    if (typeof process !== 'undefined' && process.env != null) {
+        const debug = process.env.DEBUG;
+        if (debug === 'routier' || debug === '*')
+            return true;
+        const env = "development"?.toLowerCase();
+        if (env === 'dev' || env === 'development' || env === 'test')
+            return true;
+    }
+    return false;
 };
-const shouldLog = isDevelopment();
 const tryLog = (type, ...args) => {
-    if (shouldLog) {
+    if (shouldLog()) {
         console[type](...args);
     }
 };
@@ -1864,88 +1384,6 @@ const logger = {
 };
 
 
-},
-"./src/utilities/replication.ts"(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
-__webpack_require__.r(__webpack_exports__);
-__webpack_require__.d(__webpack_exports__, {
-  resolveBulkPersistChanges: () => (resolveBulkPersistChanges)
-});
-const resolveBulkPersistChanges = (event, result, bulkPersistChanges) => {
-    // make sure we swap the adds here, that way we can make sure other persist events
-    // don't take their additions and try to change subsequent calls
-    for (const [schemaId, changes] of event.operation) {
-        const schemmaBulkPersistResult = result.get(schemaId);
-        const schemaBulkPersistChanges = bulkPersistChanges.resolve(schemaId);
-        // Set the original removes
-        schemaBulkPersistChanges.removes = changes.removes;
-        // Set the original updates
-        schemaBulkPersistChanges.updates = changes.updates;
-        // Take the adds from the result and set them to be persisted
-        // in the replicated plugins because the id's are set in the 
-        // memory data store
-        schemaBulkPersistChanges.adds = schemmaBulkPersistResult.adds;
-    }
-};
-
-
-},
-"./src/utilities/uuid.ts"(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
-__webpack_require__.r(__webpack_exports__);
-__webpack_require__.d(__webpack_exports__, {
-  uuid: () => (uuid),
-  uuidv4: () => (uuidv4)
-});
-const uuid = (length = 16) => {
-    const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
-    const charLength = chars.length;
-    let result = '';
-    for (let i = 0; i < length; i++) {
-        result += chars[Math.random() * charLength | 0];
-    }
-    return result;
-};
-const HEX_CHARS = '0123456789abcdef';
-const UUID_TEMPLATE = 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx';
-const hasCrypto = typeof crypto !== 'undefined' && typeof crypto.getRandomValues === 'function';
-const uuidv4 = () => {
-    let randomBytes = null;
-    if (hasCrypto) {
-        randomBytes = crypto.getRandomValues(new Uint8Array(16));
-    }
-    let byteIndex = 0;
-    let uuid = '';
-    for (let i = 0; i < UUID_TEMPLATE.length; i++) {
-        const c = UUID_TEMPLATE[i];
-        if (c === '-') {
-            uuid += '-';
-            continue;
-        }
-        let r;
-        if (hasCrypto && randomBytes) {
-            // Each byte gives two hex digits (nibbles)
-            r =
-                (i % 2 === 0
-                    ? randomBytes[byteIndex] >> 4
-                    : randomBytes[byteIndex++] & 0x0f);
-        }
-        else {
-            r = Math.floor(Math.random() * 16);
-        }
-        if (c === 'x') {
-            uuid += HEX_CHARS[r];
-        }
-        else if (c === 'y') {
-            // Variant bits: 8, 9, A, or B
-            uuid += HEX_CHARS[(r & 0x3) | 0x8];
-        }
-        else if (c === '4') {
-            uuid += '4';
-        }
-    }
-    return uuid;
-};
-
-
 },
 
 });
@@ -2002,23 +1440,19 @@ var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
   DataTranslator: () => (/* reexport safe */ _translators__rspack_import_0.DataTranslator),
-  EphemeralDataPlugin: () => (/* reexport safe */ _EphemeralDataPlugin__rspack_import_3.EphemeralDataPlugin),
+  EphemeralDataPlugin: () => (/* reexport safe */ _EphemeralDataPlugin__rspack_import_2.EphemeralDataPlugin),
   JsonTranslator: () => (/* reexport safe */ _translators__rspack_import_0.JsonTranslator),
-  OptimisticReplicationDbPlugin: () => (/* reexport safe */ _replication__rspack_import_1.OptimisticReplicationDbPlugin),
-  Query: () => (/* reexport safe */ _query__rspack_import_2.Query),
-  QueryOptionsCollection: () => (/* reexport safe */ _query__rspack_import_2.QueryOptionsCollection),
-  QueryOrdering: () => (/* reexport safe */ _query__rspack_import_2.QueryOrdering),
-  ReplicationDbPlugin: () => (/* reexport safe */ _replication__rspack_import_1.ReplicationDbPlugin),
+  Query: () => (/* reexport safe */ _query__rspack_import_1.Query),
+  QueryOptionsCollection: () => (/* reexport safe */ _query__rspack_import_1.QueryOptionsCollection),
+  QueryOrdering: () => (/* reexport safe */ _query__rspack_import_1.QueryOrdering),
   SqlTranslator: () => (/* reexport safe */ _translators__rspack_import_0.SqlTranslator),
   TranslatedArrayValue: () => (/* reexport safe */ _translators__rspack_import_0.TranslatedArrayValue),
   TranslatedGroupValue: () => (/* reexport safe */ _translators__rspack_import_0.TranslatedGroupValue),
   TranslatedSingleValue: () => (/* reexport safe */ _translators__rspack_import_0.TranslatedSingleValue)
 });
 /* import */ var _translators__rspack_import_0 = __webpack_require__("./src/plugins/translators/index.ts");
-/* import */ var _replication__rspack_import_1 = __webpack_require__("./src/plugins/replication/index.ts");
-/* import */ var _query__rspack_import_2 = __webpack_require__("./src/plugins/query/index.ts");
-/* import */ var _EphemeralDataPlugin__rspack_import_3 = __webpack_require__("./src/plugins/EphemeralDataPlugin.ts");
-
+/* import */ var _query__rspack_import_1 = __webpack_require__("./src/plugins/query/index.ts");
+/* import */ var _EphemeralDataPlugin__rspack_import_2 = __webpack_require__("./src/plugins/EphemeralDataPlugin.ts");
 
 
 
@@ -2029,15 +1463,13 @@ __webpack_require__.d(__webpack_exports__, {
 var __webpack_exports__DataTranslator = __webpack_exports__.DataTranslator;
 var __webpack_exports__EphemeralDataPlugin = __webpack_exports__.EphemeralDataPlugin;
 var __webpack_exports__JsonTranslator = __webpack_exports__.JsonTranslator;
-var __webpack_exports__OptimisticReplicationDbPlugin = __webpack_exports__.OptimisticReplicationDbPlugin;
 var __webpack_exports__Query = __webpack_exports__.Query;
 var __webpack_exports__QueryOptionsCollection = __webpack_exports__.QueryOptionsCollection;
 var __webpack_exports__QueryOrdering = __webpack_exports__.QueryOrdering;
-var __webpack_exports__ReplicationDbPlugin = __webpack_exports__.ReplicationDbPlugin;
 var __webpack_exports__SqlTranslator = __webpack_exports__.SqlTranslator;
 var __webpack_exports__TranslatedArrayValue = __webpack_exports__.TranslatedArrayValue;
 var __webpack_exports__TranslatedGroupValue = __webpack_exports__.TranslatedGroupValue;
 var __webpack_exports__TranslatedSingleValue = __webpack_exports__.TranslatedSingleValue;
-export { __webpack_exports__DataTranslator as DataTranslator, __webpack_exports__EphemeralDataPlugin as EphemeralDataPlugin, __webpack_exports__JsonTranslator as JsonTranslator, __webpack_exports__OptimisticReplicationDbPlugin as OptimisticReplicationDbPlugin, __webpack_exports__Query as Query, __webpack_exports__QueryOptionsCollection as QueryOptionsCollection, __webpack_exports__QueryOrdering as QueryOrdering, __webpack_exports__ReplicationDbPlugin as ReplicationDbPlugin, __webpack_exports__SqlTranslator as SqlTranslator, __webpack_exports__TranslatedArrayValue as TranslatedArrayValue, __webpack_exports__TranslatedGroupValue as TranslatedGroupValue, __webpack_exports__TranslatedSingleValue as TranslatedSingleValue };
+export { __webpack_exports__DataTranslator as DataTranslator, __webpack_exports__EphemeralDataPlugin as EphemeralDataPlugin, __webpack_exports__JsonTranslator as JsonTranslator, __webpack_exports__Query as Query, __webpack_exports__QueryOptionsCollection as QueryOptionsCollection, __webpack_exports__QueryOrdering as QueryOrdering, __webpack_exports__SqlTranslator as SqlTranslator, __webpack_exports__TranslatedArrayValue as TranslatedArrayValue, __webpack_exports__TranslatedGroupValue as TranslatedGroupValue, __webpack_exports__TranslatedSingleValue as TranslatedSingleValue };
 
 //# sourceMappingURL=index.js.map