rads-db 3.0.23 → 3.0.25

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];
@@ -700,18 +543,70 @@ async function fillDenormFieldsBeforePut(computedContext, docUpdates, ctx) {
   await Promise.all(promises);
 }
 
-function cleanUndefinedAndNull(obj) {
+function cleanUndefinedAndNull(obj, isChange = false) {
+  for (const key in obj) {
+    if (obj[key] == null && !isChange)
+      delete obj[key];
+    if (___default.isPlainObject(obj[key]))
+      cleanUndefinedAndNull(obj[key], key === "change");
+  }
+}
+
+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] == null)
+    if (obj[key] === void 0)
       delete obj[key];
     if (___default.isPlainObject(obj[key]))
-      cleanUndefinedAndNull(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";
   const { precomputedFields } = schema[key];
   async function getMany(args, ctx) {
     args = { ...args, where: { ...args?.where } };
@@ -743,7 +638,7 @@ function getRadsDbMethods(key, computedContext, driverInstance) {
     const docArgsToSave = docs.map((doc) => {
       const oldDoc = oldDocsById[doc.id];
       doc = merge(oldDoc, doc);
-      if (mustCleanNulls)
+      if (!options.keepNulls)
         cleanUndefinedAndNull(doc);
       return { oldDoc, doc };
     });
@@ -821,7 +716,7 @@ function getRadsDbMethods(key, computedContext, driverInstance) {
       const oldDoc = await driverInstance.get({ where: { id: doc.id } }, ctx);
       if (oldDoc)
         doc = merge(oldDoc, doc);
-      if (mustCleanNulls)
+      if (!options.keepNulls)
         cleanUndefinedAndNull(doc);
       const docArgsToSave = [{ doc, oldDoc }];
       await handlePrecomputed(computedContext, docArgsToSave, ctx);
@@ -863,7 +758,7 @@ function getRadsDbMethods(key, computedContext, driverInstance) {
             delete doc[p];
           }
         }
-        if (mustCleanNulls)
+        if (!options.keepNulls)
           cleanUndefinedAndNull(doc);
         return { oldDoc, doc };
       });
@@ -1007,7 +902,6 @@ function generateMethods(schema, validators, options) {
   if (!opts.noComputed) {
     verifyComputedPresense(schema, opts.computed, effects);
   }
-  verifyEventSourcingSetup(schema, effects);
   verifyRelationsSetup(schema, effects);
   const computedContextGlobal = {
     schema,
@@ -1243,6 +1137,7 @@ function createRadsDbClient(args) {
     ...args,
     noComputed: true,
     noCustomDrivers: true,
+    keepNulls: true,
     driver: restApi(args?.driver)
   };
   const s = radsDbArgs.schema || _radsDb.schema;
@@ -1250,12 +1145,16 @@ function createRadsDbClient(args) {
   return generateMethods(s, validators, radsDbArgs);
 }
 
+exports.cleanUndefinedAndNull = cleanUndefinedAndNull;
 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

@@ -186,6 +186,7 @@ interface CreateRadsDbArgs {
     beforeGet?: (args: GetArgsAny, ctx: RadsRequestContext, context: ComputedContext) => MaybePromise<void>;
     context?: Record<string, any> & Omit<RadsRequestContext, 'dryRun' | 'silent'>;
     features?: RadsFeature[];
+    keepNulls?: boolean;
 }
 type CreateRadsDbArgsNormalized = RequiredFields<CreateRadsDbArgs, 'computed' | 'features'> & {
     driver: CreateRadsArgsDrivers;
@@ -386,6 +387,15 @@ 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;
+
+declare function cleanUndefinedAndNull(obj: Record<string, any>, isChange?: boolean): void;
+
 /**
  * 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 +408,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, cleanUndefinedAndNull, 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];
@@ -692,18 +535,70 @@ async function fillDenormFieldsBeforePut(computedContext, docUpdates, ctx) {
   await Promise.all(promises);
 }
 
-function cleanUndefinedAndNull(obj) {
+function cleanUndefinedAndNull(obj, isChange = false) {
+  for (const key in obj) {
+    if (obj[key] == null && !isChange)
+      delete obj[key];
+    if (_.isPlainObject(obj[key]))
+      cleanUndefinedAndNull(obj[key], key === "change");
+  }
+}
+
+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] == null)
+    if (obj[key] === void 0)
       delete obj[key];
     if (_.isPlainObject(obj[key]))
-      cleanUndefinedAndNull(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";
   const { precomputedFields } = schema[key];
   async function getMany(args, ctx) {
     args = { ...args, where: { ...args?.where } };
@@ -735,7 +630,7 @@ function getRadsDbMethods(key, computedContext, driverInstance) {
     const docArgsToSave = docs.map((doc) => {
       const oldDoc = oldDocsById[doc.id];
       doc = merge(oldDoc, doc);
-      if (mustCleanNulls)
+      if (!options.keepNulls)
         cleanUndefinedAndNull(doc);
       return { oldDoc, doc };
     });
@@ -813,7 +708,7 @@ function getRadsDbMethods(key, computedContext, driverInstance) {
       const oldDoc = await driverInstance.get({ where: { id: doc.id } }, ctx);
       if (oldDoc)
         doc = merge(oldDoc, doc);
-      if (mustCleanNulls)
+      if (!options.keepNulls)
         cleanUndefinedAndNull(doc);
       const docArgsToSave = [{ doc, oldDoc }];
       await handlePrecomputed(computedContext, docArgsToSave, ctx);
@@ -855,7 +750,7 @@ function getRadsDbMethods(key, computedContext, driverInstance) {
             delete doc[p];
           }
         }
-        if (mustCleanNulls)
+        if (!options.keepNulls)
           cleanUndefinedAndNull(doc);
         return { oldDoc, doc };
       });
@@ -999,7 +894,6 @@ function generateMethods(schema, validators, options) {
   if (!opts.noComputed) {
     verifyComputedPresense(schema, opts.computed, effects);
   }
-  verifyEventSourcingSetup(schema, effects);
   verifyRelationsSetup(schema, effects);
   const computedContextGlobal = {
     schema,
@@ -1235,6 +1129,7 @@ function createRadsDbClient(args) {
     ...args,
     noComputed: true,
     noCustomDrivers: true,
+    keepNulls: true,
     driver: restApi(args?.driver)
   };
   const s = radsDbArgs.schema || schema;
@@ -1242,4 +1137,4 @@ function createRadsDbClient(args) {
   return generateMethods(s, validators, radsDbArgs);
 }
 
-export { computed, createRadsDb, createRadsDbClient, entity, field, getDriverInstance, precomputed, ui, validate };
+export { cleanUndefinedAndNull, computed, createRadsDb, createRadsDbClient, diff, entity, field, getDriverInstance, handlePrecomputed, merge, precomputed, ui, validate };

package/features/eventSourcing.cjs

@@ -0,0 +1,153 @@
+"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;
+          for (const ev of events) {
+            const newAggDoc = context.validators[entityName]((0, _radsDb.merge)(aggDoc || {
+              id: aggId
+            }, ev.change));
+            ev.beforeChange = aggDoc;
+            ev.change = (0, _radsDb.diff)(newAggDoc, aggDoc);
+            aggDoc = newAggDoc;
+            if (!context.options.keepNulls) (0, _radsDb.cleanUndefinedAndNull)(aggDoc);
+          }
+          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: {
+      type: "string"
+    },
+    change: {
+      type: entityName,
+      isChange: true
+    },
+    type: {
+      isEnum: true
+    },
+    beforeChange: {
+      type: entityName,
+      isChange: false,
+      isRelation: false,
+      isRequired: false
+    },
+    [aggregateRelationField]: {
+      type: entityName,
+      isRelation: true
+    },
+    date: {
+      type: "string"
+    }
+  };
+  for (const f in expectedFields) {
+    validateSchemaField(f, eventEntityName, expectedFields, schema);
+  }
+}
+function validateSchemaField(fieldName, eventEntityName, expectedFields, schema) {
+  const eventEntity = schema[eventEntityName];
+  const field = eventEntity.fields?.[fieldName];
+  if (!field) throw new Error(`"${eventEntityName}" must have field "${fieldName}"`);
+  const expectedField = expectedFields[fieldName];
+  if (expectedField.type && expectedField.type !== field.type) {
+    throw new Error(`"${eventEntityName}.${fieldName}" must have type "${expectedField.type}"`);
+  }
+  if (expectedField.isEnum) {
+    if (!schema[field.type]?.enumValues?.creation) throw new Error(`Field "${eventEntityName}.${fieldName}" must be enum that accepts value 'creation'`);
+  }
+  if (expectedField.isChange != null && expectedField.isChange !== (field.isChange || false)) {
+    const expectedType = expectedField.isChange ? `Change<${expectedField.type}>` : expectedField.type;
+    throw new Error(`"${eventEntityName}.${fieldName}" must have type "${expectedType}"`);
+  }
+  if (expectedField.isRelation != null && expectedField.isRelation !== (field.isRelation || false)) {
+    const expectedType = expectedField.isRelation ? `Relation<${expectedField.type}>` : expectedField.type;
+    throw new Error(`"${eventEntityName}.${fieldName}" must have type "${expectedType}"`);
+  }
+  if (expectedField.isRequired != null && expectedField.isRequired !== (field.isRequired || false)) {
+    const expectedRequired = expectedField.isRequired ? `required` : "optional";
+    throw new Error(`"${eventEntityName}.${fieldName}" must be ${expectedRequired}`);
+  }
+}

package/features/eventSourcing.d.ts

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

package/features/eventSourcing.mjs

@@ -0,0 +1,131 @@
+import _ from "lodash";
+import { cleanUndefinedAndNull, 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;
+          for (const ev of events) {
+            const newAggDoc = context.validators[entityName](merge(aggDoc || { id: aggId }, ev.change));
+            ev.beforeChange = aggDoc;
+            ev.change = diff(newAggDoc, aggDoc);
+            aggDoc = newAggDoc;
+            if (!context.options.keepNulls)
+              cleanUndefinedAndNull(aggDoc);
+          }
+          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: { type: "string" },
+    change: { type: entityName, isChange: true },
+    type: { isEnum: true },
+    beforeChange: { type: entityName, isChange: false, isRelation: false, isRequired: false },
+    [aggregateRelationField]: { type: entityName, isRelation: true },
+    date: { type: "string" }
+  };
+  for (const f in expectedFields) {
+    validateSchemaField(f, eventEntityName, expectedFields, schema);
+  }
+}
+function validateSchemaField(fieldName, eventEntityName, expectedFields, schema) {
+  const eventEntity = schema[eventEntityName];
+  const field = eventEntity.fields?.[fieldName];
+  if (!field)
+    throw new Error(`"${eventEntityName}" must have field "${fieldName}"`);
+  const expectedField = expectedFields[fieldName];
+  if (expectedField.type && expectedField.type !== field.type) {
+    throw new Error(`"${eventEntityName}.${fieldName}" must have type "${expectedField.type}"`);
+  }
+  if (expectedField.isEnum) {
+    if (!schema[field.type]?.enumValues?.creation)
+      throw new Error(`Field "${eventEntityName}.${fieldName}" must be enum that accepts value 'creation'`);
+  }
+  if (expectedField.isChange != null && expectedField.isChange !== (field.isChange || false)) {
+    const expectedType = expectedField.isChange ? `Change<${expectedField.type}>` : expectedField.type;
+    throw new Error(`"${eventEntityName}.${fieldName}" must have type "${expectedType}"`);
+  }
+  if (expectedField.isRelation != null && expectedField.isRelation !== (field.isRelation || false)) {
+    const expectedType = expectedField.isRelation ? `Relation<${expectedField.type}>` : expectedField.type;
+    throw new Error(`"${eventEntityName}.${fieldName}" must have type "${expectedType}"`);
+  }
+  if (expectedField.isRequired != null && expectedField.isRequired !== (field.isRequired || false)) {
+    const expectedRequired = expectedField.isRequired ? `required` : "optional";
+    throw new Error(`"${eventEntityName}.${fieldName}" must be ${expectedRequired}`);
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rads-db",
-  "version": "3.0.23",
+  "version": "3.0.25",
   "files": [
     "dist",
     "drivers",
@@ -107,7 +107,7 @@
     "test": "vitest --run && vitest typecheck --run",
     "link-rads-db": "symlink-dir ./test/_rads-db ./node_modules/_rads-db",
     "generate-test-schema": "rads-db",
-    "dev": "pnpm install && pnpm build && pnpm generate-test-schema && pnpm link-rads-db && vitest --ui --test-timeout 300000",
+    "dev": "pnpm install && pnpm link-rads-db && pnpm build && pnpm generate-test-schema && vitest --ui --test-timeout 300000",
     "lint": "cross-env NODE_ENV=production eslint src/**/*.* test/**/*.*",
     "dev-typecheck": "pnpm install && pnpm build && pnpm generate-test-schema && pnpm link-rads-db && vitest typecheck --ui",
     "build": "unbuild"