functional-models 2.1.8 → 2.1.9

package/README.md

@@ -328,7 +328,12 @@ A value that is calculated and save if it doesn't exist, using other values for
 
 NOTE: If the value is provided as part of the instance, it is not re-calculated. If you want to re-calculate it, you must use either the property's method `calculate()` method to get the value and replace the existing OR pass in undefined for the property.
 
+<strong>Incremental data creation such as GUI forms:</strong>
+
+If you are incrementally creating and validating model data, such as a GUI form, you should make your denormalization callback understand that there may be properties that are required, but are not present (yet). What this means, is if you need a particular property's value to be part of the denormalization value, but it isn't there, you should check for the value, and if not there, return undefined. This will allow it to be recalculated later.
+
 <strong>A Strong Word of Caution</strong>
+
 Generally, we would recommend not using this as a primary key in a database. However, if you want to use a DenormalizedProperty as primary key in a database and you want to make changes to an instance, you need to delete the previous entry and then recreate it for every update. A dynamic primary key is not tracked between changes.
 
 <strong>Example</strong>

package/interfaces.d.ts

@@ -143,5 +143,5 @@ declare type OptionalModelOptions<T extends FunctionalModel, TModel extends Mode
     instanceCreatedCallback?: Nullable<Arrayable<(instance: TModelInstance) => void>>;
     [s: string]: any;
 }> | undefined;
-declare type CalculateDenormalization<T extends FunctionalValue, TModel extends FunctionalModel> = (modelData: TModel, modelInstance: ModelInstance<TModel>) => MaybePromise<T>;
+declare type CalculateDenormalization<T extends FunctionalValue, TModel extends FunctionalModel> = (modelData: TModel, modelInstance: ModelInstance<TModel>) => MaybePromise<T | undefined>;
 export { MaybeFunction, Maybe, MaybePromise, Nullable, Arrayable, MaybeLazy, JsonAble, toObj, ModelInstance, Model, PropertyValidatorComponent, PropertyValidatorComponentSync, PropertyValidatorComponentAsync, PropertyValidator, ModelValidatorComponent, PropertyInstance, PropertyConfig, FunctionalValue, ValueGetter, ModelReference, ModelDefinition, ModelOptions, OptionalModelOptions, ModelReferencePropertyInstance, PropertyGetters, PropertyValidators, PropertyValidatorComponentTypeAdvanced, FunctionalModel, ModelReferenceFunctions, ModelErrors, PrimaryKeyType, ModelFactory, ModelFetcher, CreateParams, ValidatorConfiguration, ValuePropertyValidatorComponent, ValueRequired, ValueOptional, PropertyModifier, ValidationErrors, ModelError, IsAsync, TypedJsonObj, JsonObj, ValueRequiredR, ValueOptionalR, CalculateDenormalization, };

package/interfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":";;AAuYA,kCAAkC"}
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":";;AA0YA,kCAAkC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "functional-models",
-  "version": "2.1.8",
+  "version": "2.1.9",
   "description": "A library for creating JavaScript function based models.",
   "main": "index.js",
   "types": "index.d.ts",