rads-db 3.0.22 → 3.0.24

package/dist/index.cjs

@@ -463,163 +463,6 @@ async function handleEffectsAfterPut(context, docs, beforePutResults, ctx) {
   );
 }
 
-const mergeFn = createMerge__default({
-  mergeArray(options) {
-    const clone = options.clone;
-    return function(target, source) {
-      return clone(source);
-    };
-  }
-});
-function merge(target, source) {
-  cleanUndefined(source);
-  const result = mergeFn(target, source);
-  return result;
-}
-function cleanUndefined(obj) {
-  if (!obj || !___default.isPlainObject(obj))
-    return;
-  cleanUndefinedInner(obj);
-}
-function cleanUndefinedInner(obj) {
-  for (const key in obj) {
-    if (obj[key] === void 0)
-      delete obj[key];
-    if (___default.isPlainObject(obj[key]))
-      cleanUndefinedInner(obj[key]);
-  }
-}
-
-function diff(object, base, includeDenormFields = false) {
-  if (!base)
-    return object;
-  return ___default.transform(object, (result, value, key) => {
-    const oldValue = base[key];
-    if (!___default.isEqual(value, oldValue)) {
-      if (mustUseDeepDiff(value, oldValue)) {
-        const isRelationField = (value.id || oldValue.id) && key !== "change";
-        if (isRelationField && !includeDenormFields) {
-          if (value.id !== oldValue.id)
-            result[key] = value;
-        } else {
-          const subDiff = diff(value, oldValue, includeDenormFields);
-          if (!___default.isEmpty(subDiff))
-            result[key] = subDiff;
-        }
-      } else {
-        result[key] = value;
-      }
-    }
-  });
-}
-function mustUseDeepDiff(value, oldValue) {
-  return ___default.isObject(value) && ___default.isObject(oldValue) && !___default.isArray(value) && !___default.isArray(oldValue);
-}
-
-function verifyEventSourcingSetup(schema, effects) {
-  for (const entityName in schema) {
-    if (!schema[entityName].decorators.entity)
-      continue;
-    if (schema[entityName].decorators.precomputed?.preset !== "eventSourcing")
-      continue;
-    const eventEntityName = `${entityName}Event`;
-    const aggregateRelationField = ___default.lowerFirst(entityName);
-    validateEventSourcingSetup(schema, entityName, eventEntityName, aggregateRelationField);
-    effects[eventEntityName].push({
-      async beforePut(context, docs, ctx) {
-        const docsByAggId = {};
-        const docsById = {};
-        for (const d of docs) {
-          if (!d.doc.id || docsById[d.doc.id])
-            continue;
-          docsById[d.doc.id] = d.doc;
-          const aggId = d.doc[aggregateRelationField].id;
-          if (!aggId)
-            throw new Error(`Missing ${entityName}.${aggregateRelationField}.id`);
-          if (d.oldDoc && aggId !== d.oldDoc[aggregateRelationField].id) {
-            throw new Error(`Field ${entityName}.${aggregateRelationField}.id cannot be changed`);
-          }
-          if (!docsByAggId[aggId])
-            docsByAggId[aggId] = [];
-          docsByAggId[aggId].push(d.doc);
-        }
-        const existingEvents = await context.drivers[eventEntityName].getAll(
-          {
-            where: {
-              [aggregateRelationField]: { id_in: ___default.keys(docsByAggId) },
-              _not: { id_in: docs.map((d) => d.doc.id) }
-            }
-          },
-          ctx
-        );
-        const existingEventsByAggId = ___default.groupBy(existingEvents, (ev) => ev[aggregateRelationField].id);
-        const existingAggregates = await context.drivers[entityName].getAll(
-          { where: { id_in: ___default.keys(docsByAggId) } },
-          ctx
-        );
-        const existingAggregatesById = ___default.keyBy(existingAggregates, "id");
-        const result = [];
-        for (const aggId in docsByAggId) {
-          const events = ___default.orderBy([...docsByAggId[aggId], ...existingEventsByAggId[aggId] || []], ["date"], "asc");
-          if (events[0].type !== "creation")
-            throw new Error(`First event must have type = "creation". (type: ${events[0].type}, id: ${events[0].id})`);
-          if (events.slice(1).some((ev) => ev.type === "creation")) {
-            throw new Error(`Only first event may have type = "creation"`);
-          }
-          let aggDoc = { id: aggId };
-          for (const ev of events) {
-            const newAggDoc = context.validators[entityName](merge(aggDoc, ev.change));
-            ev.change = diff(newAggDoc, aggDoc);
-            aggDoc = newAggDoc;
-          }
-          result.push({ aggDoc, events });
-        }
-        await handlePrecomputed(
-          { ...context, typeName: entityName },
-          result.map((v) => ({ doc: v.aggDoc, events: v.events, oldDoc: existingAggregatesById[v.aggDoc.id] })),
-          ctx
-        );
-        return result;
-      },
-      async afterPut(context, docs, beforePutResult, ctx) {
-        const aggs = beforePutResult.map((d) => d.aggDoc);
-        await context.drivers[entityName].putMany(aggs, ctx);
-      }
-    });
-  }
-}
-function validateEventSourcingSetup(schema, entityName, eventEntityName, aggregateRelationField) {
-  const eventEntity = schema[eventEntityName];
-  if (!eventEntity)
-    throw new Error(
-      `You must create entity with name "${eventEntityName}" to use eventSourcing feature with "${entityName}"`
-    );
-  if (!eventEntity.decorators.entity)
-    throw new Error(`"${eventEntityName}" must have "@entity()" decorator.`);
-  const expectedFields = {
-    id: "string",
-    type: "enum",
-    change: entityName,
-    [aggregateRelationField]: entityName,
-    date: "string"
-  };
-  for (const f in expectedFields) {
-    const field = eventEntity.fields?.[f];
-    if (!field)
-      throw new Error(`"${eventEntityName}" must have field "${f}"`);
-    if (expectedFields[f] === "enum") {
-      if (!schema[field.type]?.enumValues?.creation)
-        throw new Error(`Field "${eventEntityName}.${f}" must be enum that accepts value 'creation'`);
-    } else {
-      if (field.type !== expectedFields[f])
-        throw new Error(`"${eventEntityName}.${f}" must have type "${expectedFields[f]}"`);
-      if (f === "change" && !field.isChange) {
-        throw new Error(`"${eventEntityName}.${f}" must have type "Change<${expectedFields[f]}>"`);
-      }
-    }
-  }
-}
-
 function verifyRelationsSetup(schema, effects) {
   for (const entityName in schema) {
     const entity = schema[entityName];
@@ -709,6 +552,59 @@ function cleanUndefinedAndNull(obj) {
   }
 }
 
+const mergeFn = createMerge__default({
+  mergeArray(options) {
+    const clone = options.clone;
+    return function(target, source) {
+      return clone(source);
+    };
+  }
+});
+function merge(target, source) {
+  cleanUndefined(source);
+  const result = mergeFn(target, source);
+  return result;
+}
+function cleanUndefined(obj) {
+  if (!obj || !___default.isPlainObject(obj))
+    return;
+  cleanUndefinedInner(obj);
+}
+function cleanUndefinedInner(obj) {
+  for (const key in obj) {
+    if (obj[key] === void 0)
+      delete obj[key];
+    if (___default.isPlainObject(obj[key]))
+      cleanUndefinedInner(obj[key]);
+  }
+}
+
+function diff(object, base, includeDenormFields = false) {
+  if (!base)
+    return object;
+  return ___default.transform(object, (result, value, key) => {
+    const oldValue = base[key];
+    if (!___default.isEqual(value, oldValue)) {
+      if (mustUseDeepDiff(value, oldValue)) {
+        const isRelationField = (value.id || oldValue.id) && key !== "change";
+        if (isRelationField && !includeDenormFields) {
+          if (value.id !== oldValue.id)
+            result[key] = value;
+        } else {
+          const subDiff = diff(value, oldValue, includeDenormFields);
+          if (!___default.isEmpty(subDiff))
+            result[key] = subDiff;
+        }
+      } else {
+        result[key] = value;
+      }
+    }
+  });
+}
+function mustUseDeepDiff(value, oldValue) {
+  return ___default.isObject(value) && ___default.isObject(oldValue) && !___default.isArray(value) && !___default.isArray(oldValue);
+}
+
 function getRadsDbMethods(key, computedContext, driverInstance) {
   const { schema, options, validators } = computedContext;
   const mustCleanNulls = driverInstance.driverName !== "restApi";
@@ -1007,7 +903,6 @@ function generateMethods(schema, validators, options) {
   if (!opts.noComputed) {
     verifyComputedPresense(schema, opts.computed, effects);
   }
-  verifyEventSourcingSetup(schema, effects);
   verifyRelationsSetup(schema, effects);
   const computedContextGlobal = {
     schema,
@@ -1253,9 +1148,12 @@ function createRadsDbClient(args) {
 exports.computed = computed;
 exports.createRadsDb = createRadsDb;
 exports.createRadsDbClient = createRadsDbClient;
+exports.diff = diff;
 exports.entity = entity;
 exports.field = field;
 exports.getDriverInstance = getDriverInstance;
+exports.handlePrecomputed = handlePrecomputed;
+exports.merge = merge;
 exports.precomputed = precomputed;
 exports.ui = ui;
 exports.validate = validate;

package/dist/index.d.ts

@@ -386,6 +386,13 @@ declare function computed(meta?: ComputedDecoratorArgs): (a: any, b?: ClassField
 
 declare function getDriverInstance(schema: Schema, key: string, driverConstructor: DriverConstructor, driverInstances: Record<string, Driver>): Driver;
 
+declare function handlePrecomputed(context: ComputedContext, docs: any[], ctx: RadsRequestContext): Promise<void>;
+
+/** Performs immutable deep merge */
+declare function merge<T extends Record<string, any>>(target: T, source: any): T;
+
+declare function diff(object: any, base: any, includeDenormFields?: boolean): any;
+
 /**
  * Creates instance of rads db - object that provides access to all entities.
  * Intended to be used on the backend. On the client you may want to opt for "createRadsDbClient" instead.
@@ -398,4 +405,4 @@ declare function createRadsDb(args?: CreateRadsDbArgs): RadsDb;
  */
 declare function createRadsDbClient(args?: CreateRadsDbClientArgs): RadsDb;
 
-export { Change, ComputedContext, ComputedContextGlobal, ComputedDecoratorArgs, CreateRadsArgsDrivers, CreateRadsDbArgs, CreateRadsDbArgsNormalized, CreateRadsDbClientArgs, DeepPartial, Driver, DriverConstructor, EntityDecoratorArgs, EntityMethods, EnumDefinition, FieldDecoratorArgs, FieldDefinition, FileSystemNode, FileUploadArgs, FileUploadDriver, FileUploadResult, GenerateClientNormalizedOptions, GenerateClientOptions, GetAggArgs, GetAggArgsAgg, GetAggArgsAny, GetAggResponse, GetArgs, GetArgsAny, GetArgsInclude, GetManyArgs, GetManyArgsAny, GetManyResponse, GetResponse, GetResponseInclude, GetResponseIncludeSelect, GetResponseNoInclude, GetRestRoutesArgs, GetRestRoutesOptions, GetRestRoutesResponse, MinimalDriver, PutArgs, PutEffect, RadsFeature, RadsRequestContext, RadsUiSlotDefinition, RadsUiSlotName, RadsVitePluginOptions, Relation, RequiredFields, RestDriverOptions, RestFileUploadDriverOptions, Schema, SchemaValidators, TypeDefinition, UiDecoratorArgs, UiFieldDecoratorArgs, ValidateEntityDecoratorArgs, ValidateFieldDecoratorArgs, ValidateStringDecoratorArgs, VerifyManyArgs, VerifyManyArgsAny, VerifyManyResponse, computed, createRadsDb, createRadsDbClient, entity, field, getDriverInstance, precomputed, ui, validate };
+export { Change, ComputedContext, ComputedContextGlobal, ComputedDecoratorArgs, CreateRadsArgsDrivers, CreateRadsDbArgs, CreateRadsDbArgsNormalized, CreateRadsDbClientArgs, DeepPartial, Driver, DriverConstructor, EntityDecoratorArgs, EntityMethods, EnumDefinition, FieldDecoratorArgs, FieldDefinition, FileSystemNode, FileUploadArgs, FileUploadDriver, FileUploadResult, GenerateClientNormalizedOptions, GenerateClientOptions, GetAggArgs, GetAggArgsAgg, GetAggArgsAny, GetAggResponse, GetArgs, GetArgsAny, GetArgsInclude, GetManyArgs, GetManyArgsAny, GetManyResponse, GetResponse, GetResponseInclude, GetResponseIncludeSelect, GetResponseNoInclude, GetRestRoutesArgs, GetRestRoutesOptions, GetRestRoutesResponse, MinimalDriver, PutArgs, PutEffect, RadsFeature, RadsRequestContext, RadsUiSlotDefinition, RadsUiSlotName, RadsVitePluginOptions, Relation, RequiredFields, RestDriverOptions, RestFileUploadDriverOptions, Schema, SchemaValidators, TypeDefinition, UiDecoratorArgs, UiFieldDecoratorArgs, ValidateEntityDecoratorArgs, ValidateFieldDecoratorArgs, ValidateStringDecoratorArgs, VerifyManyArgs, VerifyManyArgsAny, VerifyManyResponse, computed, createRadsDb, createRadsDbClient, diff, entity, field, getDriverInstance, handlePrecomputed, merge, precomputed, ui, validate };

package/dist/index.mjs

@@ -455,163 +455,6 @@ async function handleEffectsAfterPut(context, docs, beforePutResults, ctx) {
   );
 }
 
-const mergeFn = createMerge({
-  mergeArray(options) {
-    const clone = options.clone;
-    return function(target, source) {
-      return clone(source);
-    };
-  }
-});
-function merge(target, source) {
-  cleanUndefined(source);
-  const result = mergeFn(target, source);
-  return result;
-}
-function cleanUndefined(obj) {
-  if (!obj || !_.isPlainObject(obj))
-    return;
-  cleanUndefinedInner(obj);
-}
-function cleanUndefinedInner(obj) {
-  for (const key in obj) {
-    if (obj[key] === void 0)
-      delete obj[key];
-    if (_.isPlainObject(obj[key]))
-      cleanUndefinedInner(obj[key]);
-  }
-}
-
-function diff(object, base, includeDenormFields = false) {
-  if (!base)
-    return object;
-  return _.transform(object, (result, value, key) => {
-    const oldValue = base[key];
-    if (!_.isEqual(value, oldValue)) {
-      if (mustUseDeepDiff(value, oldValue)) {
-        const isRelationField = (value.id || oldValue.id) && key !== "change";
-        if (isRelationField && !includeDenormFields) {
-          if (value.id !== oldValue.id)
-            result[key] = value;
-        } else {
-          const subDiff = diff(value, oldValue, includeDenormFields);
-          if (!_.isEmpty(subDiff))
-            result[key] = subDiff;
-        }
-      } else {
-        result[key] = value;
-      }
-    }
-  });
-}
-function mustUseDeepDiff(value, oldValue) {
-  return _.isObject(value) && _.isObject(oldValue) && !_.isArray(value) && !_.isArray(oldValue);
-}
-
-function verifyEventSourcingSetup(schema, effects) {
-  for (const entityName in schema) {
-    if (!schema[entityName].decorators.entity)
-      continue;
-    if (schema[entityName].decorators.precomputed?.preset !== "eventSourcing")
-      continue;
-    const eventEntityName = `${entityName}Event`;
-    const aggregateRelationField = _.lowerFirst(entityName);
-    validateEventSourcingSetup(schema, entityName, eventEntityName, aggregateRelationField);
-    effects[eventEntityName].push({
-      async beforePut(context, docs, ctx) {
-        const docsByAggId = {};
-        const docsById = {};
-        for (const d of docs) {
-          if (!d.doc.id || docsById[d.doc.id])
-            continue;
-          docsById[d.doc.id] = d.doc;
-          const aggId = d.doc[aggregateRelationField].id;
-          if (!aggId)
-            throw new Error(`Missing ${entityName}.${aggregateRelationField}.id`);
-          if (d.oldDoc && aggId !== d.oldDoc[aggregateRelationField].id) {
-            throw new Error(`Field ${entityName}.${aggregateRelationField}.id cannot be changed`);
-          }
-          if (!docsByAggId[aggId])
-            docsByAggId[aggId] = [];
-          docsByAggId[aggId].push(d.doc);
-        }
-        const existingEvents = await context.drivers[eventEntityName].getAll(
-          {
-            where: {
-              [aggregateRelationField]: { id_in: _.keys(docsByAggId) },
-              _not: { id_in: docs.map((d) => d.doc.id) }
-            }
-          },
-          ctx
-        );
-        const existingEventsByAggId = _.groupBy(existingEvents, (ev) => ev[aggregateRelationField].id);
-        const existingAggregates = await context.drivers[entityName].getAll(
-          { where: { id_in: _.keys(docsByAggId) } },
-          ctx
-        );
-        const existingAggregatesById = _.keyBy(existingAggregates, "id");
-        const result = [];
-        for (const aggId in docsByAggId) {
-          const events = _.orderBy([...docsByAggId[aggId], ...existingEventsByAggId[aggId] || []], ["date"], "asc");
-          if (events[0].type !== "creation")
-            throw new Error(`First event must have type = "creation". (type: ${events[0].type}, id: ${events[0].id})`);
-          if (events.slice(1).some((ev) => ev.type === "creation")) {
-            throw new Error(`Only first event may have type = "creation"`);
-          }
-          let aggDoc = { id: aggId };
-          for (const ev of events) {
-            const newAggDoc = context.validators[entityName](merge(aggDoc, ev.change));
-            ev.change = diff(newAggDoc, aggDoc);
-            aggDoc = newAggDoc;
-          }
-          result.push({ aggDoc, events });
-        }
-        await handlePrecomputed(
-          { ...context, typeName: entityName },
-          result.map((v) => ({ doc: v.aggDoc, events: v.events, oldDoc: existingAggregatesById[v.aggDoc.id] })),
-          ctx
-        );
-        return result;
-      },
-      async afterPut(context, docs, beforePutResult, ctx) {
-        const aggs = beforePutResult.map((d) => d.aggDoc);
-        await context.drivers[entityName].putMany(aggs, ctx);
-      }
-    });
-  }
-}
-function validateEventSourcingSetup(schema, entityName, eventEntityName, aggregateRelationField) {
-  const eventEntity = schema[eventEntityName];
-  if (!eventEntity)
-    throw new Error(
-      `You must create entity with name "${eventEntityName}" to use eventSourcing feature with "${entityName}"`
-    );
-  if (!eventEntity.decorators.entity)
-    throw new Error(`"${eventEntityName}" must have "@entity()" decorator.`);
-  const expectedFields = {
-    id: "string",
-    type: "enum",
-    change: entityName,
-    [aggregateRelationField]: entityName,
-    date: "string"
-  };
-  for (const f in expectedFields) {
-    const field = eventEntity.fields?.[f];
-    if (!field)
-      throw new Error(`"${eventEntityName}" must have field "${f}"`);
-    if (expectedFields[f] === "enum") {
-      if (!schema[field.type]?.enumValues?.creation)
-        throw new Error(`Field "${eventEntityName}.${f}" must be enum that accepts value 'creation'`);
-    } else {
-      if (field.type !== expectedFields[f])
-        throw new Error(`"${eventEntityName}.${f}" must have type "${expectedFields[f]}"`);
-      if (f === "change" && !field.isChange) {
-        throw new Error(`"${eventEntityName}.${f}" must have type "Change<${expectedFields[f]}>"`);
-      }
-    }
-  }
-}
-
 function verifyRelationsSetup(schema, effects) {
   for (const entityName in schema) {
     const entity = schema[entityName];
@@ -701,6 +544,59 @@ function cleanUndefinedAndNull(obj) {
   }
 }
 
+const mergeFn = createMerge({
+  mergeArray(options) {
+    const clone = options.clone;
+    return function(target, source) {
+      return clone(source);
+    };
+  }
+});
+function merge(target, source) {
+  cleanUndefined(source);
+  const result = mergeFn(target, source);
+  return result;
+}
+function cleanUndefined(obj) {
+  if (!obj || !_.isPlainObject(obj))
+    return;
+  cleanUndefinedInner(obj);
+}
+function cleanUndefinedInner(obj) {
+  for (const key in obj) {
+    if (obj[key] === void 0)
+      delete obj[key];
+    if (_.isPlainObject(obj[key]))
+      cleanUndefinedInner(obj[key]);
+  }
+}
+
+function diff(object, base, includeDenormFields = false) {
+  if (!base)
+    return object;
+  return _.transform(object, (result, value, key) => {
+    const oldValue = base[key];
+    if (!_.isEqual(value, oldValue)) {
+      if (mustUseDeepDiff(value, oldValue)) {
+        const isRelationField = (value.id || oldValue.id) && key !== "change";
+        if (isRelationField && !includeDenormFields) {
+          if (value.id !== oldValue.id)
+            result[key] = value;
+        } else {
+          const subDiff = diff(value, oldValue, includeDenormFields);
+          if (!_.isEmpty(subDiff))
+            result[key] = subDiff;
+        }
+      } else {
+        result[key] = value;
+      }
+    }
+  });
+}
+function mustUseDeepDiff(value, oldValue) {
+  return _.isObject(value) && _.isObject(oldValue) && !_.isArray(value) && !_.isArray(oldValue);
+}
+
 function getRadsDbMethods(key, computedContext, driverInstance) {
   const { schema, options, validators } = computedContext;
   const mustCleanNulls = driverInstance.driverName !== "restApi";
@@ -999,7 +895,6 @@ function generateMethods(schema, validators, options) {
   if (!opts.noComputed) {
     verifyComputedPresense(schema, opts.computed, effects);
   }
-  verifyEventSourcingSetup(schema, effects);
   verifyRelationsSetup(schema, effects);
   const computedContextGlobal = {
     schema,
@@ -1242,4 +1137,4 @@ function createRadsDbClient(args) {
   return generateMethods(s, validators, radsDbArgs);
 }
 
-export { computed, createRadsDb, createRadsDbClient, entity, field, getDriverInstance, precomputed, ui, validate };
+export { computed, createRadsDb, createRadsDbClient, diff, entity, field, getDriverInstance, handlePrecomputed, merge, precomputed, ui, validate };

package/features/eventSourcing.cjs

@@ -0,0 +1,118 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+module.exports = void 0;
+var _lodash = _interopRequireDefault(require("lodash"));
+var _radsDb = require("rads-db");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+var _default = () => {
+  return {
+    name: "eventSourcing",
+    init(db, context) {
+      verifyEventSourcingSetup(context.schema, context.effects);
+    }
+  };
+};
+module.exports = _default;
+function verifyEventSourcingSetup(schema, effects) {
+  for (const entityName in schema) {
+    if (!schema[entityName].decorators.entity) continue;
+    if (schema[entityName].decorators.precomputed?.preset !== "eventSourcing") continue;
+    const eventEntityName = `${entityName}Event`;
+    const aggregateRelationField = _lodash.default.lowerFirst(entityName);
+    validateEventSourcingSetup(schema, entityName, eventEntityName, aggregateRelationField);
+    effects[eventEntityName].push({
+      async beforePut(context, docs, ctx) {
+        const docsByAggId = {};
+        const docsById = {};
+        for (const d of docs) {
+          if (!d.doc.id || docsById[d.doc.id]) continue;
+          docsById[d.doc.id] = d.doc;
+          const aggId = d.doc[aggregateRelationField].id;
+          if (!aggId) throw new Error(`Missing ${entityName}.${aggregateRelationField}.id`);
+          if (d.oldDoc && aggId !== d.oldDoc[aggregateRelationField].id) {
+            throw new Error(`Field ${entityName}.${aggregateRelationField}.id cannot be changed`);
+          }
+          if (!docsByAggId[aggId]) docsByAggId[aggId] = [];
+          docsByAggId[aggId].push(d.doc);
+        }
+        const existingEvents = await context.drivers[eventEntityName].getAll({
+          where: {
+            [aggregateRelationField]: {
+              id_in: _lodash.default.keys(docsByAggId)
+            },
+            _not: {
+              id_in: docs.map(d => d.doc.id)
+            }
+          }
+        }, ctx);
+        const existingEventsByAggId = _lodash.default.groupBy(existingEvents, ev => ev[aggregateRelationField].id);
+        const existingAggregates = await context.drivers[entityName].getAll({
+          where: {
+            id_in: _lodash.default.keys(docsByAggId)
+          }
+        }, ctx);
+        const existingAggregatesById = _lodash.default.keyBy(existingAggregates, "id");
+        const result = [];
+        for (const aggId in docsByAggId) {
+          const events = _lodash.default.orderBy([...docsByAggId[aggId], ...(existingEventsByAggId[aggId] || [])], ["date"], "asc");
+          if (events[0].type !== "creation") throw new Error(`First event must have type = "creation". (type: ${events[0].type}, id: ${events[0].id})`);
+          if (events.slice(1).some(ev => ev.type === "creation")) {
+            throw new Error(`Only first event may have type = "creation"`);
+          }
+          let aggDoc = {
+            id: aggId
+          };
+          for (const ev of events) {
+            const newAggDoc = context.validators[entityName]((0, _radsDb.merge)(aggDoc, ev.change));
+            ev.change = (0, _radsDb.diff)(newAggDoc, aggDoc);
+            aggDoc = newAggDoc;
+          }
+          result.push({
+            aggDoc,
+            events
+          });
+        }
+        await (0, _radsDb.handlePrecomputed)({
+          ...context,
+          typeName: entityName
+        }, result.map(v => ({
+          doc: v.aggDoc,
+          events: v.events,
+          oldDoc: existingAggregatesById[v.aggDoc.id]
+        })), ctx);
+        return result;
+      },
+      async afterPut(context, docs, beforePutResult, ctx) {
+        const aggs = beforePutResult.map(d => d.aggDoc);
+        await context.drivers[entityName].putMany(aggs, ctx);
+      }
+    });
+  }
+}
+function validateEventSourcingSetup(schema, entityName, eventEntityName, aggregateRelationField) {
+  const eventEntity = schema[eventEntityName];
+  if (!eventEntity) throw new Error(`You must create entity with name "${eventEntityName}" to use eventSourcing feature with "${entityName}"`);
+  if (!eventEntity.decorators.entity) throw new Error(`"${eventEntityName}" must have "@entity()" decorator.`);
+  const expectedFields = {
+    id: "string",
+    type: "enum",
+    change: entityName,
+    [aggregateRelationField]: entityName,
+    date: "string"
+  };
+  for (const f in expectedFields) {
+    const field = eventEntity.fields?.[f];
+    if (!field) throw new Error(`"${eventEntityName}" must have field "${f}"`);
+    if (expectedFields[f] === "enum") {
+      if (!schema[field.type]?.enumValues?.creation) throw new Error(`Field "${eventEntityName}.${f}" must be enum that accepts value 'creation'`);
+    } else {
+      if (field.type !== expectedFields[f]) throw new Error(`"${eventEntityName}.${f}" must have type "${expectedFields[f]}"`);
+      if (f === "change" && !field.isChange) {
+        throw new Error(`"${eventEntityName}.${f}" must have type "Change<${expectedFields[f]}>"`);
+      }
+    }
+  }
+}

package/features/eventSourcing.d.ts

@@ -0,0 +1,2 @@
+declare const _default: () => RadsFeature;
+export default _default;

package/features/eventSourcing.mjs

@@ -0,0 +1,113 @@
+import _ from "lodash";
+import { diff, handlePrecomputed, merge } from "rads-db";
+export default () => {
+  return {
+    name: "eventSourcing",
+    init(db, context) {
+      verifyEventSourcingSetup(context.schema, context.effects);
+    }
+  };
+};
+function verifyEventSourcingSetup(schema, effects) {
+  for (const entityName in schema) {
+    if (!schema[entityName].decorators.entity)
+      continue;
+    if (schema[entityName].decorators.precomputed?.preset !== "eventSourcing")
+      continue;
+    const eventEntityName = `${entityName}Event`;
+    const aggregateRelationField = _.lowerFirst(entityName);
+    validateEventSourcingSetup(schema, entityName, eventEntityName, aggregateRelationField);
+    effects[eventEntityName].push({
+      async beforePut(context, docs, ctx) {
+        const docsByAggId = {};
+        const docsById = {};
+        for (const d of docs) {
+          if (!d.doc.id || docsById[d.doc.id])
+            continue;
+          docsById[d.doc.id] = d.doc;
+          const aggId = d.doc[aggregateRelationField].id;
+          if (!aggId)
+            throw new Error(`Missing ${entityName}.${aggregateRelationField}.id`);
+          if (d.oldDoc && aggId !== d.oldDoc[aggregateRelationField].id) {
+            throw new Error(`Field ${entityName}.${aggregateRelationField}.id cannot be changed`);
+          }
+          if (!docsByAggId[aggId])
+            docsByAggId[aggId] = [];
+          docsByAggId[aggId].push(d.doc);
+        }
+        const existingEvents = await context.drivers[eventEntityName].getAll(
+          {
+            where: {
+              [aggregateRelationField]: { id_in: _.keys(docsByAggId) },
+              _not: { id_in: docs.map((d) => d.doc.id) }
+            }
+          },
+          ctx
+        );
+        const existingEventsByAggId = _.groupBy(existingEvents, (ev) => ev[aggregateRelationField].id);
+        const existingAggregates = await context.drivers[entityName].getAll(
+          { where: { id_in: _.keys(docsByAggId) } },
+          ctx
+        );
+        const existingAggregatesById = _.keyBy(existingAggregates, "id");
+        const result = [];
+        for (const aggId in docsByAggId) {
+          const events = _.orderBy([...docsByAggId[aggId], ...existingEventsByAggId[aggId] || []], ["date"], "asc");
+          if (events[0].type !== "creation")
+            throw new Error(`First event must have type = "creation". (type: ${events[0].type}, id: ${events[0].id})`);
+          if (events.slice(1).some((ev) => ev.type === "creation")) {
+            throw new Error(`Only first event may have type = "creation"`);
+          }
+          let aggDoc = { id: aggId };
+          for (const ev of events) {
+            const newAggDoc = context.validators[entityName](merge(aggDoc, ev.change));
+            ev.change = diff(newAggDoc, aggDoc);
+            aggDoc = newAggDoc;
+          }
+          result.push({ aggDoc, events });
+        }
+        await handlePrecomputed(
+          { ...context, typeName: entityName },
+          result.map((v) => ({ doc: v.aggDoc, events: v.events, oldDoc: existingAggregatesById[v.aggDoc.id] })),
+          ctx
+        );
+        return result;
+      },
+      async afterPut(context, docs, beforePutResult, ctx) {
+        const aggs = beforePutResult.map((d) => d.aggDoc);
+        await context.drivers[entityName].putMany(aggs, ctx);
+      }
+    });
+  }
+}
+function validateEventSourcingSetup(schema, entityName, eventEntityName, aggregateRelationField) {
+  const eventEntity = schema[eventEntityName];
+  if (!eventEntity)
+    throw new Error(
+      `You must create entity with name "${eventEntityName}" to use eventSourcing feature with "${entityName}"`
+    );
+  if (!eventEntity.decorators.entity)
+    throw new Error(`"${eventEntityName}" must have "@entity()" decorator.`);
+  const expectedFields = {
+    id: "string",
+    type: "enum",
+    change: entityName,
+    [aggregateRelationField]: entityName,
+    date: "string"
+  };
+  for (const f in expectedFields) {
+    const field = eventEntity.fields?.[f];
+    if (!field)
+      throw new Error(`"${eventEntityName}" must have field "${f}"`);
+    if (expectedFields[f] === "enum") {
+      if (!schema[field.type]?.enumValues?.creation)
+        throw new Error(`Field "${eventEntityName}.${f}" must be enum that accepts value 'creation'`);
+    } else {
+      if (field.type !== expectedFields[f])
+        throw new Error(`"${eventEntityName}.${f}" must have type "${expectedFields[f]}"`);
+      if (f === "change" && !field.isChange) {
+        throw new Error(`"${eventEntityName}.${f}" must have type "Change<${expectedFields[f]}>"`);
+      }
+    }
+  }
+}

package/integrations/restEndpoints.cjs

@@ -11,6 +11,7 @@ var _lodash = _interopRequireDefault(require("lodash"));
 var _restEndpointsDev = _interopRequireDefault(require("./restEndpointsDev.cjs"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 function getRadsUiUser(radsAuthHeader, apiKey) {
+  if (!radsAuthHeader) return void 0;
   apiKey = apiKey || process.env.RadsApiKey;
   if (!apiKey) {
     throw (0, _h.createError)({
@@ -18,7 +19,6 @@ function getRadsUiUser(radsAuthHeader, apiKey) {
       message: `Please, provide "apiKey" option to "getRadsUiUser" call.`
     });
   }
-  if (!radsAuthHeader) return void 0;
   const [keyType, key, email, pretendAsUserId] = radsAuthHeader.split(" ");
   if (!email || !keyType || !key || keyType !== "ApiKey") {
     throw (0, _h.createError)({

package/integrations/restEndpoints.mjs

@@ -2,12 +2,12 @@ import { createError } from "h3";
 import _ from "lodash";
 import restEndpointsDev from "./restEndpointsDev.mjs";
 export function getRadsUiUser(radsAuthHeader, apiKey) {
+  if (!radsAuthHeader)
+    return void 0;
   apiKey = apiKey || process.env.RadsApiKey;
   if (!apiKey) {
     throw createError({ statusCode: 401, message: `Please, provide "apiKey" option to "getRadsUiUser" call.` });
   }
-  if (!radsAuthHeader)
-    return void 0;
   const [keyType, key, email, pretendAsUserId] = radsAuthHeader.split(" ");
   if (!email || !keyType || !key || keyType !== "ApiKey") {
     throw createError({ statusCode: 401, message: `Unauthorized - malformed authHeader` });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rads-db",
-  "version": "3.0.22",
+  "version": "3.0.24",
   "files": [
     "dist",
     "drivers",