@onehat/data 1.5.1 → 1.5.2

package/cypress/integration/Repository/Repository.spec.js

@@ -511,6 +511,12 @@ describe('Repository Base', function() {
 			expect(didFireAdd).to.be.true;
 		});
 
+		it('createStandaloneEntity', async function() {
+			const entity = await this.repository.createStandaloneEntity({ key: 6, value: 'six' });
+			expect(entity.id).to.be.eq(6);
+			expect(_.size(this.repository.entities)).to.be.eq(5);
+		});
+
 		it('addMultiple', async function() {
 			await this.repository.addMultiple([
 				{ key: 6, value: 'six' },

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@onehat/data",
-	"version": "1.5.1",
+	"version": "1.5.2",
 	"description": "JS data modeling package with adapters for many storage mediums.",
 	"main": "src/index.js",
 	"type": "module",

package/src/Repository/Repository.js

@@ -878,6 +878,27 @@ export default class Repository extends EventEmitter {
 		return entity;
 	}
 
+	/**
+	 * Creates a new static Entity that does NOT persist in storage medium.
+	 * @param {object} data - Either raw data object or Entity. If raw data, keys are Property names, Values are Property values.
+	 * @param {boolean} isPersisted - Whether the new entity should be marked as already being persisted in storage medium.
+	 * @param {boolean} originalIsMapped - Has data already been mapped according to schema?
+	 * @return {object} entity - new Entity object
+	 */
+	createStandaloneEntity = async (data, isPersisted = false, originalIsMapped = false) => {
+		if (this.isDestroyed) {
+			throw Error('this.createStandaloneEntity is no longer valid. Repository has been destroyed.');
+		}
+		
+		const entity = Repository._createEntity(this.schema, data, this, isPersisted, originalIsMapped);
+
+		if (entity.isPhantom) {
+			entity.createId(); // either a UUID or a temp id
+		}
+
+		return entity;
+	}
+
 	/**
 	 * Convenience function to add entity with mapped data.
 	 */