entropic-bond 1.59.5 → 1.60.0

package/README.md

@@ -19,7 +19,7 @@ Typically, you will derive all your business logic entities from the `EntropicCo
 
 ### API
 
-You can find the API documentation in the docs/ directory.
+You can find the API documentation in the [docs/](./docs) directory.
 
 ### Persistence
 
@@ -31,7 +31,7 @@ The properties or attributes that you want to be streamed should be preceded by
 
 ```ts
 @registerPersistentClass( 'MyEntity' )
-class MyEntity extends EntropicBond {
+class MyEntity extends Persistent {
 	@persistent private _persistentProp1: string
 	@persistent private _persistentProp2: boolean
 	@persistent private _persistentProp3: AnotherPersistentObject
@@ -88,10 +88,214 @@ You should instantiate the concrete implementation of the `DataSource` and pass
 Store.useDataSource( new JsonDataSource() )
 ```
 
+> See the complete example at [samples/01-persistence.ts](./samples/01-persistence.ts)
+
 ### Observability
 
+The observability mechanism allows entities to notify when their properties change. Derive your class from `EntropicComponent` (which extends `Persistent`) and use `changeProp` in setters or `pushAndNotify`/`removeAndNotify` for arrays.
+
+```ts
+import { EntropicComponent } from 'entropic-bond'
+
+class MyEntity extends EntropicComponent {
+  private _name: string = ''
+
+  get name(): string { return this._name }
+  set name(value: string) { this.changeProp('name', value) }
+}
+
+const entity = new MyEntity()
+const unsub = entity.onChange(event => console.log('Changed:', event))
+
+entity.name = 'new value' // triggers the onChange listener
+unsub() // removes the listener
+```
+
+You can also directly use the generic `Observable<T>` class for standalone observer patterns.
+
+```ts
+import { Observable } from 'entropic-bond'
+
+const observable = new Observable<string>()
+const unsubscribe = observable.subscribe(event => console.log(event))
+observable.notify('hello')
+```
+
+> See the complete example at [samples/02-observability.ts](./samples/02-observability.ts)
+
 ### Auth
 
+Authentication is abstracted via `AuthService`. Register a concrete implementation and use the `Auth` singleton.
+
+```ts
+import { Auth, AuthMock } from 'entropic-bond'
+
+Auth.useAuthService(new AuthMock())
+
+async function example() {
+  const user = await Auth.instance.login({ authProvider: 'email', email: 'user@test.com', password: '123456' })
+  console.log(user.id, user.email)
+
+  Auth.instance.onAuthStateChange(credentials => {
+    console.log('Auth state changed:', credentials)
+  })
+}
+```
+
+Plugins exist for production providers (e.g., Firebase Authentication). To create a custom provider, implement the `AuthService` abstract class.
+
+> See the complete example at [samples/03-auth.ts](./samples/03-auth.ts)
+
+### Server Auth
+
+For admin-level user management (list, update, delete users), use `ServerAuth`.
+
+```ts
+import { ServerAuth, ServerAuthMock } from 'entropic-bond'
+
+ServerAuth.useServerAuthService(new ServerAuthMock())
+
+const user = await ServerAuth.instance.getUser('user-id')
+await ServerAuth.instance.updateUser('user-id', { name: 'Updated Name' })
+await ServerAuth.instance.deleteUser('user-id')
+```
+
+> See the complete example at [samples/04-server-auth.ts](./samples/04-server-auth.ts)
+
+### Cloud Storage
+
+File storage is abstracted via `CloudStorage`. Register a provider and use the singleton, or use the `StoredFile` persistent entity.
+
+```ts
+import { CloudStorage, MockCloudStorage, StoredFile } from 'entropic-bond'
+
+CloudStorage.useCloudStorage(new MockCloudStorage())
+
+// Direct usage
+const url = await CloudStorage.defaultCloudStorage.save('my-file', fileData)
+const downloadUrl = await CloudStorage.defaultCloudStorage.getUrl('my-file')
+
+// Or with StoredFile (persistent entity)
+const file = new StoredFile()
+file.setDataToStore(someBlob)
+await file.save()
+console.log(file.url)
+```
+
+> See the complete example at [samples/05-cloud-storage.ts](./samples/05-cloud-storage.ts)
+
+### Cloud Functions
+
+Call serverless functions through an abstract interface.
+
+```ts
+import { CloudFunctions, CloudFunctionsMock } from 'entropic-bond'
+
+const mockService = new CloudFunctionsMock({
+  myFunction: async (params) => `Hello ${params.name}`
+})
+CloudFunctions.useCloudFunctionsService(mockService)
+
+const fn = CloudFunctions.instance.getFunction('myFunction')
+const result = await fn({ name: 'World' })
+```
+
+> See the complete example at [samples/06-cloud-functions.ts](./samples/06-cloud-functions.ts)
+
+### Realtime document listeners
+
+The `Model` supports realtime updates on documents and collections.
+
+```ts
+const model = Store.getModel<MyEntity>('MyEntity')
+
+// Listen to a single document
+const unsubscribe1 = model.onDocumentChange('doc-id', change => {
+  console.log('Before:', change.before, 'After:', change.after)
+})
+
+// Listen to a collection query
+const unsubscribe2 = model.onCollectionChange(
+  model.find().where('name', '==', 'foo'),
+  change => console.log('Collection changed:', change)
+)
+
+// Listen to a wildcard collection template
+const unsubscribe3 = model.onCollectionTemplateChange('{userId}/Posts', change => {
+  console.log('Post changed in', change.collectionPath)
+})
+```
+
+> See the complete example at [samples/07-realtime-listeners.ts](./samples/07-realtime-listeners.ts)
+
+### DataSource plugins
+
+The persistence layer uses a `DataSource` to communicate with the database. Implement the abstract `DataSource` class to support new backends.
+
+```ts
+import { DataSource, Store } from 'entropic-bond'
+
+class MyDatabase extends DataSource {
+  // implement all abstract methods: findById, find, save, delete, etc.
+}
+
+Store.useDataSource(new MyDatabase())
+```
+
+The official Firebase plugin is available as `entropic-bond-firebase`.
+
+```sh
+npm i entropic-bond-firebase
+```
+
+> See the complete example at [samples/10-datasource-plugin.ts](./samples/10-datasource-plugin.ts)
+
+### Cached property references
+
+When a property holds a reference to another persistent entity, you can embed selected primitive fields directly in the reference to avoid extra queries.
+
+```ts
+@registerPersistentClass('Team')
+class Team extends EntropicComponent {
+  @persistent private _name: string
+}
+
+@registerPersistentClass('User')
+class User extends EntropicComponent {
+  @persistentReferenceWithCachedProps(['_name'], 'Team')
+  private _team: Team
+}
+```
+
+The `CachedPropsUpdater` (installed via `DataSource.installCachedPropsUpdater()`) will propagate changes to cached props across all referencing documents.
+
+> See the complete example at [samples/08-cached-props.ts](./samples/08-cached-props.ts)
+
+### Utility functions
+
+```ts
+import { camelCase, snakeCase, replaceValue, getDeepValue } from 'entropic-bond'
+
+camelCase('hello-world')        // 'helloWorld'
+snakeCase('helloWorld')         // 'hello-world'
+replaceValue('Hi ${name}', { name: 'John' }) // 'Hi John'
+```
+
+> See the complete example at [samples/09-utils.ts](./samples/09-utils.ts)
 
+### Samples
 
+Complete, runnable examples are available in the [`samples/`](./samples) directory:
 
+| Section | Sample |
+|---------|--------|
+| Persistence | [01-persistence.ts](./samples/01-persistence.ts) |
+| Observability | [02-observability.ts](./samples/02-observability.ts) |
+| Auth | [03-auth.ts](./samples/03-auth.ts) |
+| Server Auth | [04-server-auth.ts](./samples/04-server-auth.ts) |
+| Cloud Storage | [05-cloud-storage.ts](./samples/05-cloud-storage.ts) |
+| Cloud Functions | [06-cloud-functions.ts](./samples/06-cloud-functions.ts) |
+| Realtime listeners | [07-realtime-listeners.ts](./samples/07-realtime-listeners.ts) |
+| Cached property references | [08-cached-props.ts](./samples/08-cached-props.ts) |
+| Utility functions | [09-utils.ts](./samples/09-utils.ts) |
+| DataSource plugins | [10-datasource-plugin.ts](./samples/10-datasource-plugin.ts) |

package/lib/entropic-bond.js

@@ -15,16 +15,16 @@ var e = class {
 	get subscribersCount() {
 		return this.subscribers.size;
 	}
-}, t = /* @__PURE__ */ new Uint8Array(16);
-function n() {
-	return crypto.getRandomValues(t);
+}, t = [];
+for (let e = 0; e < 256; ++e) t.push((e + 256).toString(16).slice(1));
+function n(e, n = 0) {
+	return (t[e[n + 0]] + t[e[n + 1]] + t[e[n + 2]] + t[e[n + 3]] + "-" + t[e[n + 4]] + t[e[n + 5]] + "-" + t[e[n + 6]] + t[e[n + 7]] + "-" + t[e[n + 8]] + t[e[n + 9]] + "-" + t[e[n + 10]] + t[e[n + 11]] + t[e[n + 12]] + t[e[n + 13]] + t[e[n + 14]] + t[e[n + 15]]).toLowerCase();
 }
 //#endregion
-//#region node_modules/uuid/dist/stringify.js
-var r = [];
-for (let e = 0; e < 256; ++e) r.push((e + 256).toString(16).slice(1));
-function i(e, t = 0) {
-	return (r[e[t + 0]] + r[e[t + 1]] + r[e[t + 2]] + r[e[t + 3]] + "-" + r[e[t + 4]] + r[e[t + 5]] + "-" + r[e[t + 6]] + r[e[t + 7]] + "-" + r[e[t + 8]] + r[e[t + 9]] + "-" + r[e[t + 10]] + r[e[t + 11]] + r[e[t + 12]] + r[e[t + 13]] + r[e[t + 14]] + r[e[t + 15]]).toLowerCase();
+//#region node_modules/uuid/dist/rng.js
+var r = /* @__PURE__ */ new Uint8Array(16);
+function i() {
+	return crypto.getRandomValues(r);
 }
 //#endregion
 //#region node_modules/uuid/dist/v4.js
@@ -33,17 +33,17 @@ function a(e, t, n) {
 }
 function o(e, t, r) {
 	e ||= {};
-	let a = e.random ?? e.rng?.() ?? n();
+	let a = e.random ?? e.rng?.() ?? i();
 	if (a.length < 16) throw Error("Random bytes length must be >= 16");
 	if (a[6] = a[6] & 15 | 64, a[8] = a[8] & 63 | 128, t) {
 		if (r ||= 0, r < 0 || r + 16 > t.length) throw RangeError(`UUID byte range ${r}:${r + 15} is out of buffer bounds`);
 		for (let e = 0; e < 16; ++e) t[r + e] = a[e];
 		return t;
 	}
-	return i(a);
+	return n(a);
 }
 //#endregion
-//#region \0@oxc-project+runtime@0.137.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.148.0/helpers/esm/decorate.js
 function s(e, t, n, r) {
 	var i = arguments.length, a = i < 3 ? t : r === null ? r = Object.getOwnPropertyDescriptor(t, n) : r, o;
 	if (typeof Reflect == "object" && typeof Reflect.decorate == "function") a = Reflect.decorate(e, t, n, r);
@@ -112,7 +112,7 @@ var c = class e {
 	}
 	isPropValueValid(e) {
 		let t = this.getPropInfo(e);
-		return t.validator ? t.validator(this[t.name], t, this) : !0;
+		return !t.validator || t.validator(this[t.name], t, this);
 	}
 	clone(e) {
 		let t = e.toObject();
@@ -222,8 +222,8 @@ var c = class e {
 			if (n.length === 0) return "undefined[]";
 			let t = n[0];
 			return t instanceof e ? t.className + "[]" : typeof t + "[]";
-		} else if (n instanceof e) return n.className;
-		else return typeof n;
+		}
+		return n instanceof e ? n.className : typeof n;
 	}
 	static getSystemRegisteredReferencesWithCachedProps() {
 		return e.registeredClasses().reduce((t, n) => {
@@ -282,7 +282,7 @@ function m(e, t, n, r) {
 }
 function h(e) {
 	return function(t, n) {
-		Object.getOwnPropertyDescriptor(t, "_persistentProperties") || (t._persistentProperties ? t._persistentProperties = [...t._persistentProperties] : t._persistentProperties = []);
+		Object.getOwnPropertyDescriptor(t, "_persistentProperties") || (t._persistentProperties = t._persistentProperties ? [...t._persistentProperties] : []);
 		let r = t._persistentProperties.find((e) => e.name === n);
 		r ? Object.assign(r, e) : t._persistentProperties.push({
 			name: n,
@@ -332,7 +332,7 @@ var S = class extends c {
 	}
 	changeProp(e, t) {
 		let n = "_" + String(e);
-		return this[n] === t ? !1 : (this[n] = t, this._onChange.notify({ [e]: t }), !0);
+		return this[n] !== t && (this[n] = t, this._onChange.notify({ [e]: t }), !0);
 	}
 	notify(e) {
 		this._onChange.notify(e);
@@ -377,6 +377,23 @@ var S = class extends c {
 			this._stream.delete(e, this.collectionName).then(() => t()).catch((e) => n(e));
 		});
 	}
+	runTransaction(e) {
+		return this._stream.runTransaction((t) => e({
+			findById: async (e) => {
+				let n = await t.findById(e, this.collectionName);
+				return n ? c.createInstance(n) : void 0;
+			},
+			save: async (e) => {
+				let n = e.toObject();
+				this.collectionName !== n.__className && (n.__rootCollections[this.collectionName] = n.__rootCollections[n.__className], delete n.__rootCollections[n.__className]), await Promise.all(Object.entries(n.__rootCollections).map(([e, n]) => Promise.all((n ?? []).map((n) => t.save(n.id, e, n)))));
+			},
+			delete: async (e) => {
+				await t.delete(e.id, this.collectionName);
+			}
+		})).catch((e) => {
+			throw e instanceof D && e.storedDoc && !(e.storedDoc instanceof c) && (e.storedDoc = c.createInstance(e.storedDoc)), e;
+		});
+	}
 	find() {
 		return new w(this);
 	}
@@ -398,13 +415,13 @@ var S = class extends c {
 		return this.mapToInstance(() => this._stream.next(e));
 	}
 	onDocumentChange(e, t) {
-		return this._stream.onDocumentChange(this.collectionName, e, (e) => t(D.toPersistentDocumentChange(e)));
+		return this._stream.onDocumentChange(this.collectionName, e, (e) => t(O.toPersistentDocumentChange(e)));
 	}
 	onCollectionChange(e, t) {
-		return this._stream.onCollectionChange(this.preprocessQueryObject(e.getQueryObject()), this.collectionName, (e) => t(e.map((e) => D.toPersistentDocumentChange(e))));
+		return this._stream.onCollectionChange(this.preprocessQueryObject(e.getQueryObject()), this.collectionName, (e) => t(e.map((e) => O.toPersistentDocumentChange(e))));
 	}
 	onCollectionTemplateChange(e, t) {
-		return this._stream.onDocumentTemplateChange(e, (e) => t(D.toPersistentDocumentChange(e)));
+		return this._stream.onDocumentTemplateChange(e, (e) => t(O.toPersistentDocumentChange(e)));
 	}
 	mapToInstance(e) {
 		return new Promise((t, n) => {
@@ -415,7 +432,7 @@ var S = class extends c {
 		if (Object.values(e).length === 0) return e;
 		let t = e.operations?.map((e) => {
 			let t = e.value[0] ?? e.value;
-			return D.isArrayOperator(e.operator) && t instanceof c ? {
+			return O.isArrayOperator(e.operator) && t instanceof c ? {
 				property: c.searchableArrayNameFor(e.property),
 				operator: e.operator,
 				value: Array.isArray(e.value) ? e.value.map((e) => e.id) : t.id,
@@ -578,10 +595,10 @@ var S = class extends c {
 		return n ? this.onDocumentChange(t, n) : Promise.resolve();
 	}
 	async onDocumentChange(t, n) {
-		let r = D.toPersistentDocumentChange(t);
+		let r = O.toPersistentDocumentChange(t);
 		this._beforeDocumentChange?.(r, n);
 		let i = {};
-		t.type !== "update" || !r.before || r.after?.id && this._disabledChangeListeners.has(r.after?.id) || (await Promise.all(n.map(async (t) => {
+		t.type === "update" && r.before && (r.after?.id && this._disabledChangeListeners.has(r.after?.id) || (await Promise.all(n.map(async (t) => {
 			let n = e.ownerCollectionPath(c.createInstance(t.ownerClassName()), t, r.params), a = await this._resolveCollectionPaths(n);
 			await Promise.all(a.map(async (e) => {
 				let n = T.getModel(e), a = n.find(), o = !1;
@@ -606,7 +623,7 @@ var S = class extends c {
 					} else return Promise.resolve();
 				})]);
 			}));
-		})), this._afterDocumentChange?.(i, n));
+		})), this._afterDocumentChange?.(i, n)));
 	}
 	disableChangeListener(e) {
 		this._disabledChangeListeners.add(e.id);
@@ -618,7 +635,11 @@ var S = class extends c {
 		let r;
 		return r = typeof t.ownerCollection == "function" ? t.ownerCollection(e, t, n) : t.ownerCollection ?? e.className, r;
 	}
-}, D = class e {
+}, D = class extends Error {
+	constructor(e) {
+		super("Transaction conflict: the document was modified by another writer."), this.storedDoc = e, this.name = "TransactionConflictError";
+	}
+}, O = class e {
 	constructor() {
 		this._cachedPropsUpdater = void 0;
 	}
@@ -659,7 +680,8 @@ var S = class extends c {
 		if (typeof e == "object" && !Array.isArray(e)) {
 			let t = Object.keys(e)[0], [n, r] = this.toPropertyPathValue(e[t]);
 			return [`${t}${n ? "." + n : ""}`, r];
-		} else return [void 0, e];
+		}
+		return [void 0, e];
 	}
 	static isStringMatchingTemplate(e, t) {
 		let n = e.split("/"), r = t.split("/");
@@ -689,9 +711,9 @@ var S = class extends c {
 		}
 		return i;
 	}
-}, O = class extends D {
+}, k = class extends O {
 	constructor(e) {
-		super(), this._jsonRawData = {}, this._lastMatchingDocs = [], this._lastLimit = 0, this._cursor = 0, this._simulateDelay = 0, this._pendingPromises = [], this._documentListeners = {}, this._collectionListeners = {}, e && (this._jsonRawData = e);
+		super(), this._jsonRawData = {}, this._versions = {}, this._lastMatchingDocs = [], this._lastLimit = 0, this._cursor = 0, this._simulateDelay = 0, this._pendingPromises = [], this._documentListeners = {}, this._collectionListeners = {}, e && (this._jsonRawData = e);
 	}
 	setDataStore(e) {
 		return this._jsonRawData = e, this;
@@ -708,7 +730,7 @@ var S = class extends c {
 		return Object.entries(e).forEach(([e, t]) => {
 			this._jsonRawData[e] || (this._jsonRawData[e] = {}), t?.forEach((t) => {
 				let n = this._jsonRawData[e][t.id];
-				this._jsonRawData[e][t.id] = t, this.notifyChange(e, t, n);
+				this._jsonRawData[e][t.id] = t, this.bumpVersion(e, t.id), this.notifyChange(e, t, n);
 			});
 		}), this.resolveWithDelay();
 	}
@@ -719,7 +741,42 @@ var S = class extends c {
 	}
 	delete(e, t) {
 		if (this._simulateError?.delete) throw Error(this._simulateError.delete);
-		return delete this._jsonRawData[t][e], this.resolveWithDelay();
+		return delete this._jsonRawData[t][e], this.bumpVersion(t, e), this.resolveWithDelay();
+	}
+	runTransaction(e) {
+		let t = [], n = [];
+		return e({
+			findById: (e, n) => (t.push({
+				collectionName: n,
+				id: e,
+				version: this.versionOf(n, e)
+			}), this.resolveWithDelay(this._jsonRawData[n]?.[e])),
+			save: (e, t, r) => (n.push({
+				type: "save",
+				collectionName: t,
+				id: e,
+				doc: r
+			}), this.resolveWithDelay()),
+			delete: (e, t) => (n.push({
+				type: "delete",
+				collectionName: t,
+				id: e
+			}), this.resolveWithDelay())
+		}).then((e) => {
+			let r = t.find((e) => e.version !== this.versionOf(e.collectionName, e.id));
+			if (r) throw new D(this._jsonRawData[r.collectionName]?.[r.id]);
+			return n.forEach((e) => {
+				if (e.type === "delete") delete this._jsonRawData[e.collectionName][e.id], this.bumpVersion(e.collectionName, e.id);
+				else {
+					this._jsonRawData[e.collectionName] || (this._jsonRawData[e.collectionName] = {});
+					let t = this._jsonRawData[e.collectionName][e.id], n = {
+						...t ?? {},
+						...e.doc
+					};
+					this._jsonRawData[e.collectionName][e.id] = n, this.bumpVersion(e.collectionName, e.id), this.notifyChange(e.collectionName, n, t);
+				}
+			}), e;
+		});
 	}
 	next(e) {
 		return e && (this._lastLimit = e), this.incCursor(this._lastLimit), this.resolveWithDelay(this._lastMatchingDocs.slice(this._cursor, this._cursor + this._lastLimit));
@@ -758,7 +815,7 @@ var S = class extends c {
 			let i = this._documentListeners[n];
 			i ||= (this._documentListeners[n] = {}, this._documentListeners[n]);
 			let a = (r) => {
-				r.params = D.extractTemplateParams(n, e), t(r);
+				r.params = O.extractTemplateParams(n, e), t(r);
 			}, o = Math.random().toString(36).substring(2, 9);
 			i[o] = a, r.push(() => delete i[o]);
 		}), () => r.forEach((e) => e());
@@ -773,12 +830,12 @@ var S = class extends c {
 		this._cursor += e, this._cursor > this._lastMatchingDocs.length && (this._cursor = this._lastMatchingDocs.length);
 	}
 	simulateError(e) {
-		return e === void 0 ? (this._simulateError = void 0, this) : (typeof e == "string" ? this._simulateError = {
+		return e === void 0 ? (this._simulateError = void 0, this) : (this._simulateError = typeof e == "string" ? {
 			store: e,
 			find: e,
 			findById: e,
 			delete: e
-		} : this._simulateError = e, this);
+		} : e, this);
 	}
 	notifyChange(e, t, n) {
 		let r = {
@@ -791,7 +848,7 @@ var S = class extends c {
 		Object.values(this._documentListeners[e] ?? {}).forEach((e) => e(r)), Object.values(this._collectionListeners[e] ?? {}).forEach((e) => e(r));
 	}
 	decCursor(e) {
-		return this._cursor -= e, this._cursor < 0 ? (this._cursor = 0, !0) : !1;
+		return this._cursor -= e, this._cursor < 0 && (this._cursor = 0, !0);
 	}
 	queryProcessor(e, t, n) {
 		return {
@@ -808,7 +865,8 @@ var S = class extends c {
 			if (n.aggregate) {
 				let i = e.filter((e) => this.isQueryMatched(e, n));
 				return r === 0 ? i : t.concat(i);
-			} else return t.filter((e) => this.isQueryMatched(e, n));
+			}
+			return t.filter((e) => this.isQueryMatched(e, n));
 		}, e);
 	}
 	deepValue(e, t) {
@@ -846,9 +904,15 @@ var S = class extends c {
 		return Promise.resolve(this.collectionsMatchingTemplate(e));
 	}
 	collectionsMatchingTemplate(e) {
-		return Object.keys(this._jsonRawData).filter((t) => D.isStringMatchingTemplate(e, t));
+		return Object.keys(this._jsonRawData).filter((t) => O.isStringMatchingTemplate(e, t));
+	}
+	versionOf(e, t) {
+		return this._versions[e]?.[t] ?? 0;
+	}
+	bumpVersion(e, t) {
+		this._versions[e] || (this._versions[e] = {}), this._versions[e][t] = (this._versions[e][t] ?? 0) + 1;
 	}
-}, k = class e {
+}, A = class e {
 	static registerCloudStorage(t, n) {
 		e._cloudStorageFactoryMap[t] = n;
 	}
@@ -871,14 +935,14 @@ var S = class extends c {
 		this._cloudStorageFactoryMap = {};
 	}
 };
-function A(e, t) {
-	return k.registerCloudStorage(e, t), (t) => {
+function j(e, t) {
+	return A.registerCloudStorage(e, t), (t) => {
 		t.prototype.__className = e;
 	};
 }
 //#endregion
 //#region src/cloud-storage/mock-cloud-storage.ts
-var j = class extends k {
+var M = class extends A {
 	constructor(e = "") {
 		super(), this._simulateDelay = 0, this._pendingPromises = [], this.mockFileSystem = {}, this._pathToMockFiles = e;
 	}
@@ -913,18 +977,18 @@ var j = class extends k {
 		return delete this.mockFileSystem[e], this.resolveWithDelay();
 	}
 };
-j = s([A("MockCloudStorage", () => new j())], j);
+M = s([j("MockCloudStorage", () => new M())], M);
 //#endregion
 //#region src/cloud-storage/stored-file.ts
-var M = /* @__PURE__ */ function(e) {
+var N = /* @__PURE__ */ function(e) {
 	return e[e.stored = 0] = "stored", e[e.pendingDataSet = 1] = "pendingDataSet", e[e.deleted = 2] = "deleted", e;
-}({}), N = class extends c {
+}({}), P = class extends c {
 	constructor(...t) {
 		super(...t), this._onChange = new e();
 	}
 	async save({ data: e, fileName: t, progress: n, cloudStorageProvider: r } = {}) {
 		let i = e || this._pendingData;
-		i && (this._reference && await this.delete(), this.provider = r || k.defaultCloudStorage, this._originalFileName = t || (i instanceof File ? i.name : void 0), this._reference = await this.provider.save(this.id, i, n), this._url = await this.provider.getUrl(this._reference), this._pendingData = void 0, this._onChange.notify({
+		i && (this._reference && await this.delete(), this.provider = r || A.defaultCloudStorage, this._originalFileName = t || (i instanceof File ? i.name : void 0), this._reference = await this.provider.save(this.id, i, n), this._url = await this.provider.getUrl(this._reference), this._pendingData = void 0, this._onChange.notify({
 			event: 0,
 			storedFile: this
 		}));
@@ -944,9 +1008,9 @@ var M = /* @__PURE__ */ function(e) {
 	}
 	get provider() {
 		if (!this._provider) try {
-			this._provider = k.createInstance(this._cloudStorageProviderName);
+			this._provider = A.createInstance(this._cloudStorageProviderName);
 		} catch {
-			this._provider = k.defaultCloudStorage;
+			this._provider = A.defaultCloudStorage;
 		}
 		return this._provider;
 	}
@@ -970,10 +1034,10 @@ var M = /* @__PURE__ */ function(e) {
 		return this._onChange.subscribe(e);
 	}
 };
-s([l], N.prototype, "_reference", void 0), s([l], N.prototype, "_url", void 0), s([l], N.prototype, "_cloudStorageProviderName", void 0), s([l], N.prototype, "_originalFileName", void 0), s([l], N.prototype, "_mimeType", void 0), N = s([g("StoredFile")], N);
+s([l], P.prototype, "_reference", void 0), s([l], P.prototype, "_url", void 0), s([l], P.prototype, "_cloudStorageProviderName", void 0), s([l], P.prototype, "_originalFileName", void 0), s([l], P.prototype, "_mimeType", void 0), P = s([g("StoredFile")], P);
 //#endregion
 //#region src/auth/auth.ts
-var P = class {}, F = class t extends P {
+var F = class {}, I = class t extends F {
 	static {
 		this.error = { shouldBeRegistered: "You should register an auth service before using Auth." };
 	}
@@ -1023,7 +1087,7 @@ var P = class {}, F = class t extends P {
 	static {
 		this._instance = void 0;
 	}
-}, I = class extends P {
+}, L = class extends F {
 	constructor(...e) {
 		super(...e), this.pendingPromises = [], this._fakeRegisteredUsers = {};
 	}
@@ -1098,7 +1162,7 @@ var P = class {}, F = class t extends P {
 			creationDate: 0
 		};
 	}
-}, L = class e {
+}, R = class e {
 	constructor() {}
 	static {
 		this.error = { shouldBeRegistered: "You should register a cloud functions service with useCloudFunctionsService static method before using CloudFunctions." };
@@ -1126,7 +1190,7 @@ var P = class {}, F = class t extends P {
 	processResult(e) {
 		if (e != null) return e.__className ? c.createInstance(e) : Array.isArray(e) ? e.map((e) => this.processResult(e)) : typeof e == "object" ? Object.entries(e).reduce((e, [t, n]) => (e[t] = this.processResult(n), e), {}) : e;
 	}
-}, R = class {
+}, z = class {
 	constructor(e) {
 		this._registeredFunctions = e;
 	}
@@ -1138,7 +1202,7 @@ var P = class {}, F = class t extends P {
 	callFunction(e, t) {
 		return e(t);
 	}
-}, z = class {}, B = class e extends z {
+}, B = class {}, V = class e extends B {
 	static {
 		this.error = { shouldBeRegistered: "You should register a Server Auth service before using the Server Auth." };
 	}
@@ -1167,7 +1231,7 @@ var P = class {}, F = class t extends P {
 	static {
 		this._instance = void 0;
 	}
-}, V = class extends z {
+}, H = class extends B {
 	constructor(e) {
 		super(), this._userCredentials = e;
 	}
@@ -1195,23 +1259,23 @@ var P = class {}, F = class t extends P {
 };
 //#endregion
 //#region src/utils/utils.ts
-function H(e, t) {
+function U(e, t) {
 	return e ? e.replace(/\${\s*(\w*)\s*}/g, function(e, n) {
 		return t[n] || "";
 	}) : "";
 }
-function U(e) {
+function W(e) {
 	return e ? e.replace(/([-_ ][\w])/g, (e) => e.toUpperCase().replace("-", "").replace("_", "").replace(" ", "")) : "";
 }
-function W(e, t = "-") {
+function G(e, t = "-") {
 	if (!e) return "";
 	let n = e.slice(1).replace(/( |[A-Z])/g, (e) => e === " " ? "-" : t + e[0].toLowerCase());
 	return e[0].toLocaleLowerCase() + n.replace(/--/g, "-");
 }
-function G(e, t) {
+function K(e, t) {
 	return t.split(".").reduce((e, t) => e[t], e);
 }
 //#endregion
-export { F as Auth, I as AuthMock, P as AuthService, E as CachedPropsUpdater, L as CloudFunctions, R as CloudFunctionsMock, k as CloudStorage, D as DataSource, S as EntropicComponent, O as JsonDataSource, j as MockCloudStorage, C as Model, e as Observable, c as Persistent, w as Query, B as ServerAuth, V as ServerAuthMock, z as ServerAuthService, T as Store, N as StoredFile, M as StoredFileEvent, U as camelCase, G as getDeepValue, l as persistent, h as persistentParser, p as persistentPureReference, m as persistentPureReferenceWithCachedProps, d as persistentReference, u as persistentReferenceAt, f as persistentReferenceWithCachedProps, A as registerCloudStorage, _ as registerLegacyClassName, g as registerPersistentClass, H as replaceValue, y as required, b as requiredWithValidator, v as searchableArray, W as snakeCase, x as typeName };
+export { I as Auth, L as AuthMock, F as AuthService, E as CachedPropsUpdater, R as CloudFunctions, z as CloudFunctionsMock, A as CloudStorage, O as DataSource, S as EntropicComponent, k as JsonDataSource, M as MockCloudStorage, C as Model, e as Observable, c as Persistent, w as Query, V as ServerAuth, H as ServerAuthMock, B as ServerAuthService, T as Store, P as StoredFile, N as StoredFileEvent, D as TransactionConflictError, W as camelCase, K as getDeepValue, l as persistent, h as persistentParser, p as persistentPureReference, m as persistentPureReferenceWithCachedProps, d as persistentReference, u as persistentReferenceAt, f as persistentReferenceWithCachedProps, j as registerCloudStorage, _ as registerLegacyClassName, g as registerPersistentClass, U as replaceValue, y as required, b as requiredWithValidator, v as searchableArray, G as snakeCase, x as typeName };
 
 //# sourceMappingURL=entropic-bond.js.map