@webda/models 0.0.0-stage → 4.0.0-beta.3

package/lib/repositories/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/repositories/event.ts"],"names":[],"mappings":"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"}

package/lib/repositories/event.js

@@ -0,0 +1,226 @@
+var _a;
+import { AbstractRepository } from "./abstract.js";
+import { WEBDA_TEST } from "./repository.js";
+/**
+ * Repository decorator that wraps another repository with event emission.
+ *
+ * Emits "before" events (Create, Update, Patch, Delete, PartialUpdate, Query)
+ * before delegating to the underlying repository, then emits "after" events
+ * (Created, Updated, Patched, Deleted, PartialUpdated, Queried) on success.
+ *
+ * @typeParam T - The ModelClass this repository manages
+ */
+export class EventRepository extends AbstractRepository {
+    static { _a = WEBDA_TEST; }
+    /**
+     * @param model - The model class constructor
+     * @param pks - Array of primary key field names
+     * @param repository - The underlying repository to delegate storage operations to
+     */
+    constructor(model, pks, repository) {
+        super(model, pks, "_");
+        this.repository = repository;
+        /** Test utilities - clears events and delegates to underlying repository */
+        this[_a] = {
+            clear: async (excludeListeners) => {
+                if (!excludeListeners) {
+                    this.events.clear();
+                }
+                // @ts-ignore
+                this.repository[WEBDA_TEST].clear();
+            }
+        };
+    }
+    /**
+     * Increment numeric attributes with event emission
+     * @override
+     */
+    async incrementAttributes(primaryKey, info, _conditionField, _condition) {
+        await this.emit("PartialUpdate", {
+            object_id: primaryKey,
+            partial_update: {
+                increments: info
+            }
+        });
+        await this.repository.incrementAttributes(primaryKey, info, _conditionField, _condition);
+        await this.emit("PartialUpdated", {
+            object_id: primaryKey,
+            partial_update: {
+                increments: info
+            }
+        });
+    }
+    /**
+     * Query with event emission
+     *
+     * Parameters are bound here, so the events carry the bound query and the underlying
+     * repository (often a store one) only ever receives a plain query.
+     * @param query - the query to execute
+     * @param params - values for the `?` or `:name` placeholders
+     * @returns the query results with optional continuation token
+     */
+    async query(query, params) {
+        if (params !== undefined) {
+            query = (await import("@webda/ql")).bind(query, params);
+        }
+        await this.emit("Query", { query });
+        const res = await this.repository.query(query);
+        await this.emit("Queried", { ...res, query });
+        return res;
+    }
+    /**
+     * Iterate through all objects
+     * @param query - the query filter
+     * @param params - values for the `?` or `:name` placeholders, bound before reaching the underlying repository
+     * @returns an async generator of objects
+     */
+    async *iterate(query, params) {
+        if (params !== undefined) {
+            query = (await import("@webda/ql")).bind(query, params);
+        }
+        yield* this.repository.iterate(query);
+    }
+    /**
+     * Delete an item from a collection
+     * @param uuid The UUID of the item
+     * @param collection The collection to delete from
+     * @param index The index of the item to delete
+     * @param itemWriteConditionField The field to use for the write condition
+     * @param itemWriteCondition The value to use for the write condition
+     */
+    async deleteItemFromCollection(uuid, collection, index, itemWriteConditionField, itemWriteCondition) {
+        await this.emit("PartialUpdate", {
+            object_id: uuid,
+            partial_update: {
+                delete_from_collection: {
+                    collection,
+                    index,
+                    itemWriteConditionField,
+                    itemWriteCondition
+                }
+            }
+        });
+        await this.repository.deleteItemFromCollection(uuid, collection, index, itemWriteConditionField, itemWriteCondition);
+        await this.emit("PartialUpdated", {
+            object_id: uuid,
+            partial_update: {
+                delete_from_collection: {
+                    collection,
+                    index,
+                    itemWriteConditionField,
+                    itemWriteCondition
+                }
+            }
+        });
+    }
+    /**
+     * Upsert item to collection with event emission
+     * @override
+     */
+    async upsertItemToCollection(uuid, collection, item, index, itemWriteConditionField, itemWriteCondition) {
+        await this.emit("PartialUpdate", {
+            object_id: uuid,
+            partial_update: {
+                upsert_in_collection: {
+                    collection,
+                    item,
+                    index,
+                    itemWriteConditionField,
+                    itemWriteCondition
+                }
+            }
+        });
+        await this.repository.upsertItemToCollection(uuid, collection, item, index, itemWriteConditionField, itemWriteCondition);
+        await this.emit("PartialUpdated", {
+            object_id: uuid,
+            partial_update: {
+                upsert_in_collection: {
+                    collection,
+                    item,
+                    index,
+                    itemWriteConditionField,
+                    itemWriteCondition
+                }
+            }
+        });
+    }
+    /**
+     * Remove attribute with event emission
+     * @override
+     */
+    async removeAttribute(uuid, attribute, conditionField, condition) {
+        await this.emit("PartialUpdate", {
+            object_id: uuid,
+            partial_update: {
+                remove_attribute: {
+                    attribute,
+                    conditionField,
+                    condition
+                }
+            }
+        });
+        await this.repository.removeAttribute(uuid, attribute, conditionField, condition);
+        await this.emit("PartialUpdated", {
+            object_id: uuid,
+            partial_update: {
+                remove_attribute: {
+                    attribute,
+                    conditionField,
+                    condition
+                }
+            }
+        });
+    }
+    /** @override */
+    async get(primaryKey) {
+        const res = await this.repository.get(primaryKey);
+        return res;
+    }
+    /**
+     * Create with event emission (emits Create before and Created after)
+     * @override
+     */
+    async create(data, save) {
+        // Build the instance once so a generated primary key is shared by the events
+        // and the underlying repository
+        const item = this.buildItem(data);
+        const object_id = this.getPrimaryKey(item);
+        await this.emit("Create", { object_id, object: item });
+        const res = await this.repository.create(item, save);
+        await this.emit("Created", { object_id, object: res });
+        return res;
+    }
+    /**
+     * Patch with event emission (emits Patch before and Patched after)
+     * @override
+     */
+    async patch(primaryKey, data, _conditionField, _condition) {
+        await this.emit("Patch", { object_id: primaryKey, object: data });
+        await this.repository.patch(primaryKey, data, _conditionField, _condition);
+        await this.emit("Patched", { object_id: primaryKey, object: data });
+    }
+    /**
+     * Update with event emission (emits Update before and Updated after)
+     * @override
+     */
+    async update(data, conditionField, condition) {
+        await this.emit("Update", { object_id: this.getPrimaryKey(data), object: data });
+        await this.repository.update(data, conditionField, condition);
+        await this.emit("Updated", { object_id: this.getPrimaryKey(data), object: data });
+    }
+    /**
+     * Delete with event emission (emits Delete before and Deleted after)
+     * @override
+     */
+    async delete(uuid, conditionField, condition) {
+        await this.emit("Delete", { object_id: uuid });
+        await this.repository.delete(uuid, conditionField, condition);
+        await this.emit("Deleted", { object_id: uuid });
+    }
+    /** @override */
+    async exists(uuid) {
+        const res = await this.repository.exists(uuid);
+        return res;
+    }
+}
+//# sourceMappingURL=event.js.map

package/lib/repositories/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/repositories/event.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGnD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;;;;;;GAQG;AACH,MAAM,OAAO,eAA4C,SAAQ,kBAAqB;kBA+QnF,UAAU;IA9QX;;;;OAIG;IACH,YACE,KAAQ,EACR,GAAa,EACH,UAAiC;QAE3C,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAFb,eAAU,GAAV,UAAU,CAAuB;QAqQ7C,4EAA4E;QAC5E,QAAY,GAER;YACF,KAAK,EAAE,KAAK,EAAC,gBAAgB,EAAC,EAAE;gBAC9B,IAAI,CAAC,gBAAgB,EAAE,CAAC;oBACtB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBACtB,CAAC;gBACD,aAAa;gBACb,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE,CAAC;YACtC,CAAC;SACF,CAAC;IA7QF,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,mBAAmB,CACvB,UAAkF,EAClF,IAAiE,EACjE,eAA0B,EAC1B,UAAgB;QAEhB,MAAM,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE;YAC/B,SAAS,EAAE,UAAU;YACrB,cAAc,EAAE;gBACd,UAAU,EAAE,IAAI;aACjB;SACK,CAAC,CAAC;QACV,MAAM,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;QACzF,MAAM,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE;YAChC,SAAS,EAAE,UAAU;YACrB,cAAc,EAAE;gBACd,UAAU,EAAE,IAAI;aACjB;SACK,CAAC,CAAC;IACZ,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,KAAK,CACT,KAAa,EACb,MAAwB;QAExB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,KAAK,GAAG,CAAC,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAS,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,GAAG,GAAG,EAAE,KAAK,EAAS,CAAC,CAAC;QACrD,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,CAAC,OAAO,CAAC,KAAa,EAAE,MAAwB;QACpD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,KAAK,GAAG,CAAC,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC1D,CAAC;QACD,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,wBAAwB,CAI5B,IAAqC,EACrC,UAAa,EACb,KAAa,EACb,uBAA2B,EAC3B,kBAAwD;QAExD,MAAM,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE;YAC/B,SAAS,EAAE,IAAI;YACf,cAAc,EAAE;gBACd,sBAAsB,EAAE;oBACtB,UAAU;oBACV,KAAK;oBACL,uBAAuB;oBACvB,kBAAkB;iBACnB;aACF;SACK,CAAC,CAAC;QACV,MAAM,IAAI,CAAC,UAAU,CAAC,wBAAwB,CAC5C,IAAI,EACJ,UAAU,EACV,KAAK,EACL,uBAAuB,EACvB,kBAAkB,CACnB,CAAC;QACF,MAAM,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE;YAChC,SAAS,EAAE,IAAI;YACf,cAAc,EAAE;gBACd,sBAAsB,EAAE;oBACtB,UAAU;oBACV,KAAK;oBACL,uBAAuB;oBACvB,kBAAkB;iBACnB;aACF;SACK,CAAC,CAAC;IACZ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,sBAAsB,CAI1B,IAAqC,EACrC,UAAa,EACb,IAAiF,EACjF,KAAc,EACd,uBAAqF,EACrF,kBAEoC;QAEpC,MAAM,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE;YAC/B,SAAS,EAAE,IAAI;YACf,cAAc,EAAE;gBACd,oBAAoB,EAAE;oBACpB,UAAU;oBACV,IAAI;oBACJ,KAAK;oBACL,uBAAuB;oBACvB,kBAAkB;iBACnB;aACF;SACK,CAAC,CAAC;QACV,MAAM,IAAI,CAAC,UAAU,CAAC,sBAAsB,CAC1C,IAAI,EACJ,UAAU,EACV,IAAI,EACJ,KAAK,EACL,uBAAuB,EACvB,kBAAkB,CACnB,CAAC;QACF,MAAM,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE;YAChC,SAAS,EAAE,IAAI;YACf,cAAc,EAAE;gBACd,oBAAoB,EAAE;oBACpB,UAAU;oBACV,IAAI;oBACJ,KAAK;oBACL,uBAAuB;oBACvB,kBAAkB;iBACnB;aACF;SACK,CAAC,CAAC;IACZ,CAAC;IACD;;;OAGG;IACH,KAAK,CAAC,eAAe,CACnB,IAAqC,EACrC,SAAY,EACZ,cAAyB,EACzB,SAA+F;QAE/F,MAAM,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE;YAC/B,SAAS,EAAE,IAAI;YACf,cAAc,EAAE;gBACd,gBAAgB,EAAE;oBAChB,SAAS;oBACT,cAAc;oBACd,SAAS;iBACV;aACF;SACK,CAAC,CAAC;QACV,MAAM,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;QAClF,MAAM,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE;YAChC,SAAS,EAAE,IAAI;YACf,cAAc,EAAE;gBACd,gBAAgB,EAAE;oBAChB,SAAS;oBACT,cAAc;oBACd,SAAS;iBACV;aACF;SACK,CAAC,CAAC;IACZ,CAAC;IACD,gBAAgB;IAChB,KAAK,CAAC,GAAG,CAAC,UAA2C;QACnD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAClD,OAAO,GAAG,CAAC;IACb,CAAC;IACD;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,IAA8B,EAAE,IAAc;QACzD,6EAA6E;QAC7E,gCAAgC;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAS,CAAC,CAAC;QAC9D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAgC,EAAE,IAAI,CAAC,CAAC;QACjF,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAS,CAAC,CAAC;QAC9D,OAAO,GAAG,CAAC;IACb,CAAC;IACD;;;OAGG;IACH,KAAK,CAAC,KAAK,CACT,UAAkF,EAClF,IAA8B,EAC9B,eAA0B,EAC1B,UAAgB;QAEhB,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAS,CAAC,CAAC;QACzE,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;QAC3E,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAS,CAAC,CAAC;IAC7E,CAAC;IACD;;;OAGG;IACH,KAAK,CAAC,MAAM,CACV,IAA8B,EAC9B,cAAyB,EACzB,SAAgD;QAEhD,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAS,CAAC,CAAC;QACxF,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;QAC9D,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAS,CAAC,CAAC;IAC3F,CAAC;IACD;;;OAGG;IACH,KAAK,CAAC,MAAM,CACV,IAAqC,EACrC,cAAyB,EACzB,SAA+F;QAE/F,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAS,CAAC,CAAC;QACtD,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;QAC9D,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAS,CAAC,CAAC;IACzD,CAAC;IACD,gBAAgB;IAChB,KAAK,CAAC,MAAM,CAAC,IAAqC;QAChD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/C,OAAO,GAAG,CAAC;IACb,CAAC;CAcF"}

package/lib/repositories/hooks.d.ts

@@ -0,0 +1,88 @@
+import type { ModelRefWithCreate } from "../relations.js";
+import { SettablePrimaryKey, type Storable, type ModelClass } from "../storable.js";
+import { Helpers } from "../types.js";
+import type { Repository } from "./repository.js";
+import type { QueryParameters, WebdaQLString } from "@webda/ql";
+/**
+ * Global registry mapping ModelClass constructors to their Repository instances.
+ *
+ * @internal — Populated by `Store.computeStores()`; not for app code. App code
+ * reaches a repository via `useRepository(Model)` or static model methods
+ * (`Model.create()`, `Model.query()`, `Model.ref()`).
+ */
+export declare const Repositories: WeakMap<ModelClass<Storable<any, any>>, Repository<any>>;
+/**
+ * Return a repository for a model
+ * @param arg - the model class to look up
+ * @returns the repository for the model
+ */
+export declare function useRepository<T extends ModelClass>(arg: T): Repository<T>;
+/**
+ * Register a repository
+ *
+ * @internal — Called by `Store.computeStores()`; not for app code.
+ * @param model - the model class to register for
+ * @param repository - the repository instance
+ */
+export declare function registerRepository<T extends ModelClass>(model: T, repository: Repository<T>): void;
+/**
+ * MixIn that adds static repository methods (create, query, iterate, ref, getRepository)
+ * to a base class, enabling Model classes to access their repository directly.
+ *
+ * @param Base - The base class to augment
+ * @returns the augmented class with repository methods
+ */
+export declare function RepositoryStorageClassMixIn<TBase extends new (...args: any[]) => object>(Base: TBase): {
+    new (...args: any[]): {
+        /**
+         * Return the proxied version of this model (identity by default)
+         * @returns this instance
+         */
+        toProxy(): /*elided*/ any;
+    };
+    /**
+     * Get the repository registered for this model class.
+     * @returns the repository
+     */
+    getRepository<T extends ModelClass>(this: T): Repository<T>;
+    /**
+     * Create the object directly
+     * @param this - the model class constructor
+     * @param data - the initial data
+     * @param save - whether to persist immediately
+     * @returns the created model instance
+     */
+    create<T extends ModelClass>(this: T, data: Helpers<InstanceType<T>>, save?: boolean): Promise<InstanceType<T>>;
+    /**
+     * Query the object directly
+     *
+     * ```ts
+     * Task.query("owner = ? AND priority >= ?", [user, 2]);
+     * Task.query("owner = :owner", { owner: user });
+     * ```
+     * @param this - the model class constructor
+     * @param query - the query string, optionally with `?` or `:name` placeholders
+     * @param params - values for the placeholders: an array for `?`, an object for `:name`
+     * @returns the query results
+     */
+    query<T extends ModelClass>(this: T, query: WebdaQLString<InstanceType<T>>, params?: QueryParameters): Promise<{
+        results: InstanceType<T>[];
+        continuationToken?: string;
+    }>;
+    /**
+     * Iterate through all objects
+     * @param this - the model class constructor
+     * @param query - the query string, optionally with `?` or `:name` placeholders
+     * @param params - values for the placeholders: an array for `?`, an object for `:name`
+     * @returns an async generator of model instances
+     */
+    iterate<T extends ModelClass>(this: T, query: WebdaQLString<InstanceType<T>>, params?: QueryParameters): AsyncGenerator<InstanceType<T>, any, any>;
+    /**
+     * Get a reference to the model
+     * @param this - the model class constructor
+     * @param key - the primary key value
+     * @returns a model reference with create capability
+     */
+    ref<T extends ModelClass>(this: T, key: SettablePrimaryKey<InstanceType<T>>): ModelRefWithCreate<InstanceType<T>>;
+} & TBase;
+//# sourceMappingURL=hooks.d.ts.map

package/lib/repositories/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/repositories/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAkB,kBAAkB,EAAqB,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACvH,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAEhE;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,0DAA6C,CAAC;AAEvE;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,UAAU,EAAE,GAAG,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CASzE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAElG;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK;kBAA7B,GAAG,EAAE;QA8EzE;;;WAGG;;;IA/EH;;;OAGG;kBACkB,CAAC,SAAS,UAAU,QAAQ,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IAIlE;;;;;;OAMG;WACW,CAAC,SAAS,UAAU,QAC1B,CAAC,QACD,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SACxB,OAAO,GACZ,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAI3B;;;;;;;;;;;OAWG;UACU,CAAC,SAAS,UAAU,QACzB,CAAC,SACA,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,WAC5B,eAAe,GACvB,OAAO,CAAC;QACT,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;IAIF;;;;;;OAMG;YACmB,CAAC,SAAS,UAAU,QAClC,CAAC,SACA,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,WAC5B,eAAe,GACvB,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC;IAM5C;;;;;OAKG;QACQ,CAAC,SAAS,UAAU,QACvB,CAAC,OACF,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GACvC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;UAYzC"}

package/lib/repositories/hooks.js

@@ -0,0 +1,105 @@
+/**
+ * Global registry mapping ModelClass constructors to their Repository instances.
+ *
+ * @internal — Populated by `Store.computeStores()`; not for app code. App code
+ * reaches a repository via `useRepository(Model)` or static model methods
+ * (`Model.create()`, `Model.query()`, `Model.ref()`).
+ */
+export const Repositories = new WeakMap();
+/**
+ * Return a repository for a model
+ * @param arg - the model class to look up
+ * @returns the repository for the model
+ */
+export function useRepository(arg) {
+    let clazz = arg;
+    while (!Repositories.has(clazz)) {
+        clazz = Object.getPrototypeOf(clazz);
+        if (clazz === null || clazz === Object) {
+            throw new Error(`No repository found for ${arg.prototype.constructor.name}`);
+        }
+    }
+    return Repositories.get(clazz);
+}
+/**
+ * Register a repository
+ *
+ * @internal — Called by `Store.computeStores()`; not for app code.
+ * @param model - the model class to register for
+ * @param repository - the repository instance
+ */
+export function registerRepository(model, repository) {
+    Repositories.set(model, repository);
+}
+/**
+ * MixIn that adds static repository methods (create, query, iterate, ref, getRepository)
+ * to a base class, enabling Model classes to access their repository directly.
+ *
+ * @param Base - The base class to augment
+ * @returns the augmented class with repository methods
+ */
+export function RepositoryStorageClassMixIn(Base) {
+    return class extends Base {
+        /**
+         * Get the repository registered for this model class.
+         * @returns the repository
+         */
+        static getRepository() {
+            return useRepository(this);
+        }
+        /**
+         * Create the object directly
+         * @param this - the model class constructor
+         * @param data - the initial data
+         * @param save - whether to persist immediately
+         * @returns the created model instance
+         */
+        static create(data, save = true) {
+            return useRepository(this).create(data, save);
+        }
+        /**
+         * Query the object directly
+         *
+         * ```ts
+         * Task.query("owner = ? AND priority >= ?", [user, 2]);
+         * Task.query("owner = :owner", { owner: user });
+         * ```
+         * @param this - the model class constructor
+         * @param query - the query string, optionally with `?` or `:name` placeholders
+         * @param params - values for the placeholders: an array for `?`, an object for `:name`
+         * @returns the query results
+         */
+        static query(query, params) {
+            return useRepository(this).query(query, params);
+        }
+        /**
+         * Iterate through all objects
+         * @param this - the model class constructor
+         * @param query - the query string, optionally with `?` or `:name` placeholders
+         * @param params - values for the placeholders: an array for `?`, an object for `:name`
+         * @returns an async generator of model instances
+         */
+        static async *iterate(query, params) {
+            for await (const item of useRepository(this).iterate(query, params)) {
+                yield item;
+            }
+        }
+        /**
+         * Get a reference to the model
+         * @param this - the model class constructor
+         * @param key - the primary key value
+         * @returns a model reference with create capability
+         */
+        static ref(key) {
+            return useRepository(this).ref(key);
+        }
+        /**
+         * Return the proxied version of this model (identity by default)
+         * @returns this instance
+         */
+        toProxy() {
+            return this;
+        }
+    };
+}
+//# sourceMappingURL=hooks.js.map

package/lib/repositories/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/repositories/hooks.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,OAAO,EAA+B,CAAC;AAEvE;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAuB,GAAM;IACxD,IAAI,KAAK,GAAQ,GAAG,CAAC;IACrB,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IACD,OAAO,YAAY,CAAC,GAAG,CAAC,KAAK,CAAkB,CAAC;AAClD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAuB,KAAQ,EAAE,UAAyB;IAC1F,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CAA+C,IAAW;IACnG,OAAO,KAAM,SAAQ,IAAI;QACvB;;;WAGG;QACH,MAAM,CAAC,aAAa;YAClB,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAED;;;;;;WAMG;QACH,MAAM,CAAC,MAAM,CAEX,IAA8B,EAC9B,IAAI,GAAY,IAAI;YAEpB,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAChD,CAAC;QAED;;;;;;;;;;;WAWG;QACH,MAAM,CAAC,KAAK,CAEV,KAAqC,EACrC,MAAwB;YAKxB,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAClD,CAAC;QAED;;;;;;WAMG;QACH,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAEnB,KAAqC,EACrC,MAAwB;YAExB,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;gBACpE,MAAM,IAAuB,CAAC;YAChC,CAAC;QACH,CAAC;QAED;;;;;WAKG;QACH,MAAM,CAAC,GAAG,CAER,GAAwC;YAExC,OAAO,aAAa,CAAC,IAAI,CAAE,CAAC,GAAG,CAAC,GAAU,CAAC,CAAC;QAC9C,CAAC;QAED;;;WAGG;QACH,OAAO;YACL,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/lib/repositories/memory.d.ts

@@ -0,0 +1,208 @@
+import type { ArrayElement } from "@webda/tsc-esm";
+import type { QueryParameters } from "@webda/ql";
+import type { PK, WEBDA_PRIMARY_KEY, ModelClass } from "../storable.js";
+import type { Helpers, JSONed, PropertyPaths, NumericPropertyPaths } from "../types.js";
+import { AbstractRepository } from "./abstract.js";
+import { Repository, WEBDA_TEST } from "./repository.js";
+/**
+ * Parsed query structure expected from the WebdaQL parser.
+ *
+ * Includes pagination (limit, continuationToken), ordering, and a filter
+ * with an `eval` function for in-memory evaluation.
+ */
+export type Query = {
+    limit: number;
+    orderBy?: {
+        field: string;
+        direction: "ASC" | "DESC";
+    }[];
+    continuationToken?: string;
+    filter: {
+        eval: (item: any) => boolean;
+    };
+};
+/** Result of a simulated find operation, including whether filtering was applied. */
+export type FindResult<T> = {
+    results: T[];
+    continuationToken?: string;
+    filter: boolean;
+};
+/**
+ * This is a simple in-memory repository implementation
+ * It is used for testing purposes only
+ */
+export declare class MemoryRepository<T extends ModelClass, K extends Map<string, string> = Map<string, string>> extends AbstractRepository<T> {
+    protected storage: K;
+    /**
+     * @param model - The model class constructor
+     * @param pks - Primary key field names
+     * @param separator - Composite key separator (default: "_")
+     * @param map - Optional pre-existing Map to use as storage backend
+     */
+    constructor(model: T, pks: string[], separator?: string, map?: K);
+    /** @override */
+    get(primaryKey: PK<InstanceType<T>, InstanceType<T>[typeof WEBDA_PRIMARY_KEY][number]> | string): Promise<Helpers<InstanceType<T>>>;
+    /** @override */
+    create(data: Helpers<InstanceType<T>>, save?: boolean): Promise<InstanceType<T>>;
+    /** @override */
+    update<K extends PropertyPaths<InstanceType<T>>>(data: Helpers<InstanceType<T>>, conditionField?: K | null, condition?: any): Promise<void>;
+    /**
+     * Verify an optimistic locking condition on an item
+     * @param item - The item to check
+     * @param conditionField - Field to validate
+     * @param condition - Expected value
+     * @throws Error if the condition does not match
+     */
+    protected checkCondition<K extends PropertyPaths<InstanceType<T>>>(item: InstanceType<T>, conditionField?: K | null, condition?: any): void;
+    /** @override */
+    patch<K extends PropertyPaths<InstanceType<T>>>(primaryKey: PK<InstanceType<T>, InstanceType<T>[typeof WEBDA_PRIMARY_KEY][number]> | string, data: Partial<InstanceType<T>>, conditionField?: K | null, condition?: any): Promise<void>;
+    /**
+     * Serialize the object to a string
+     *
+     * This method is used to allow switching between different serialization methods
+     *
+     * The serialized payload is also stamped with a top-level `__type` field
+     * carrying the concrete model identifier when available
+     * (`item.constructor.Metadata?.Identifier`). This lets `query()` and external
+     * storage backends filter results by class without re-instantiating every
+     * item — important when a single underlying storage map is shared across a
+     * model and its subclasses (the common case in production where each
+     * registered model owns its own MemoryRepository pointing at the same Map).
+     *
+     * The stamp lives on the serializer envelope (sibling of `value` /
+     * `$serializer`), not inside `value`. `deserialize()` re-surfaces it on the
+     * reconstructed instance as a non-enumerable `__type` property so WebdaQL's
+     * filter eval can read it without it ever leaking into `JSON.stringify` or
+     * `Object.keys` output — keeping API responses and re-serialize cycles
+     * byte-identical for the model's own fields.
+     *
+     * Models that don't carry Metadata (plain unit-test classes that don't go
+     * through Application.setModelMetadata) simply skip the stamp; the resulting
+     * payload is byte-identical to the previous implementation.
+     *
+     * @param item to serialize
+     * @returns serialized object
+     */
+    serialize(item: InstanceType<T>): string;
+    /**
+     * Unserialize the object from a string
+     *
+     * Beyond restoring the concrete type via `@webda/serialize`'s
+     * `$serializer.type` typeKey, this also surfaces the storage envelope's
+     * `__type` stamp on the in-memory instance as a NON-ENUMERABLE property. The
+     * non-enumerable bit keeps `__type` invisible to `JSON.stringify` and
+     * `Object.keys` (so API responses and re-serialize cycles are byte-identical
+     * for the model's own fields), while still being readable via direct
+     * property access — which is exactly how WebdaQL's filter eval reads it
+     * (`ComparisonExpression.getAttributeValue` walks `obj[name]`).
+     *
+     * Backward-compat: legacy rows written before the envelope-stamping was
+     * introduced won't carry `__type`. In that case we backfill from the
+     * repository's own `model.Metadata.Identifier` so they look like records of
+     * the parent class — which is exactly what `query()`'s prepended class
+     * filter expects (parent + descendants). Plain unit-test classes without
+     * Metadata get no stamp at all; their repos opt out of class filtering on
+     * the query side too (see `query`).
+     *
+     * @param item - the serialized string
+     * @returns the deserialized model instance
+     */
+    deserialize(item: string): InstanceType<T>;
+    /**
+     * Collect the WebdaQL class-filter identifier list — `this.model`'s
+     * identifier and every transitive descendant carried in `Metadata.Subclasses`.
+     *
+     * Returns `undefined` when the model carries no `Metadata` (plain unit-test
+     * classes that didn't go through `Application.setModelMetadata`). In that
+     * case `query()` skips the prepend and returns everything in storage,
+     * preserving the pre-fix behavior for those bare classes.
+     *
+     * @returns the list of identifiers to match, or `undefined` when no Metadata
+     */
+    protected buildClassFilterIdentifiers(): string[] | undefined;
+    /**
+     * Build the WebdaQL class-filter clause `__type IN ['A', 'B', ...]` covering
+     * `this.model`'s identifier and every transitive descendant.
+     *
+     * Returns `undefined` when the model carries no `Metadata`.
+     *
+     * @returns the class-filter WebdaQL clause, or `undefined` when no Metadata
+     */
+    protected buildClassFilter(): string | undefined;
+    /**
+     * Add query support
+     *
+     * Class filtering: when several model classes share the same underlying
+     * storage Map (e.g. a model and its subclasses each registering their own
+     * repository pointing at the same `Map` via `MemoryStore.getRepository`),
+     * results are restricted to instances of `this.model` and its transitive
+     * descendants. The filter is applied as a real WebdaQL clause —
+     * `__type IN ['Webda/Post', 'Webda/BlogPost', ...]` — prepended to the
+     * caller's query via `WebdaQL.PrependCondition` (string path) or merged
+     * directly into the AST (parsed-Query path used by `iterate`). Each stored
+     * item carries its `__type` as a non-enumerable property courtesy of
+     * `deserialize`, so the WebdaQL filter eval reads it directly without
+     * leaking it to JSON serialization. There is no post-filter step.
+     *
+     * Models without `Metadata` (plain unit-test classes) opt out of the
+     * prepend — `buildClassFilterIdentifiers` returns `undefined` and the query
+     * runs as given. External storage backends that adopt the same `__type`
+     * stamping convention can use `buildClassFilter` to produce the equivalent
+     * server-side WHERE clause.
+     *
+     * @param query - the query string or parsed query
+     * @param params - values for the `?` or `:name` placeholders of a query string
+     * @returns the query results with optional continuation token
+     */
+    query(query: string | Query, params?: QueryParameters): Promise<{
+        results: InstanceType<T>[];
+        continuationToken?: string;
+    }>;
+    /**
+     * Allow to simulate a find on a list of uuids
+     * It is static to be reusable by other repository like FileRepository
+     * @param query - the parsed query
+     * @param uuids - the list of UIDs to search
+     * @param repository - the repository to fetch objects from
+     * @returns the query results with optional continuation token
+     */
+    static simulateFind<T extends ModelClass>(query: Query, uuids: any[], repository: Repository<T>): Promise<{
+        results: InstanceType<T>[];
+        continuationToken?: string;
+    }>;
+    /**
+     * Add iterator support
+     * @param query - the query string
+     * @param params - values for the `?` or `:name` placeholders
+     */
+    iterate(query: string, params?: QueryParameters): AsyncGenerator<InstanceType<T>, any, any>;
+    /** @override */
+    delete<K extends PropertyPaths<InstanceType<T>>>(primaryKey: PK<InstanceType<T>, InstanceType<T>[typeof WEBDA_PRIMARY_KEY][number]>, _conditionField?: K | null, _condition?: any): Promise<void>;
+    /** @override */
+    exists(primaryKey: PK<InstanceType<T>, InstanceType<T>[typeof WEBDA_PRIMARY_KEY][number]> | string): Promise<boolean>;
+    /** @override */
+    incrementAttributes<K extends PropertyPaths<InstanceType<T>>, L extends NumericPropertyPaths<InstanceType<T>>>(primaryKey: PK<InstanceType<T>, InstanceType<T>[typeof WEBDA_PRIMARY_KEY][number]> | string, info: (L | {
+        property: L;
+        value?: number;
+    })[] | Record<L, number>, _conditionField?: K | null, _condition?: any): Promise<void>;
+    /**
+     * Verify a write condition on a collection item
+     * @param item - The array to check
+     * @param index - Index of the item in the array
+     * @param itemWriteConditionField - Field name to check on the item
+     * @param itemWriteCondition - Expected value for the field
+     * @throws Error if the condition does not match
+     */
+    protected checkItemWriteCondition(item: any[], index: number, itemWriteConditionField: string, itemWriteCondition: any): void;
+    /** @override */
+    upsertItemToCollection<K extends Extract<PropertyPaths<InstanceType<T>, any[]>, keyof InstanceType<T>>, L extends keyof ArrayElement<InstanceType<T>[K]>>(primaryKey: PK<InstanceType<T>, InstanceType<T>[typeof WEBDA_PRIMARY_KEY][number]>, collection: K, item: ArrayElement<InstanceType<T>[K]> | JSONed<ArrayElement<InstanceType<T>[K]>>, index?: number, itemWriteConditionField?: any, itemWriteCondition?: any): Promise<void>;
+    /** @override */
+    deleteItemFromCollection<K extends Extract<PropertyPaths<InstanceType<T>, any[]>, keyof InstanceType<T>>, L extends keyof ArrayElement<InstanceType<T>[K]>>(primaryKey: PK<InstanceType<T>, InstanceType<T>[typeof WEBDA_PRIMARY_KEY][number]>, collection: K, index: number, itemWriteConditionField?: any, itemWriteCondition?: any): Promise<void>;
+    /** @override */
+    removeAttribute<L extends PropertyPaths<InstanceType<T>>, K extends PropertyPaths<InstanceType<T>>>(primaryKey: PK<InstanceType<T>, InstanceType<T>[typeof WEBDA_PRIMARY_KEY][number]>, attribute: K, _conditionField?: L | null, _condition?: any): Promise<void>;
+    /** Test utilities - clears all stored data */
+    [WEBDA_TEST]: {
+        clear: () => Promise<void>;
+    };
+}
+//# sourceMappingURL=memory.d.ts.map