@decaf-ts/core 0.7.2 → 0.7.3

package/lib/ram/handlers.d.ts

@@ -1,8 +1,7 @@
 import { Model } from "@decaf-ts/decorator-validation";
-import { Repo } from "../repository";
 import { RelationsMetadata } from "../model";
-import { RamFlags } from "./types";
-import { Context } from "@decaf-ts/db-decorators";
+import { RamRepository } from "./types";
+import { RamContext } from "./types";
 /**
  * @description Sets the created by field on a model during RAM create/update operations
  * @summary Automatically populates a model field with the UUID from the context during create or update operations.
@@ -22,4 +21,4 @@ import { Context } from "@decaf-ts/db-decorators";
  * @memberOf module:core
  * @category Ram
  */
-export declare function createdByOnRamCreateUpdate<M extends Model, R extends Repo<M, F, C>, V extends RelationsMetadata, F extends RamFlags, C extends Context<F>>(this: R, context: Context<F>, data: V, key: keyof M, model: M): Promise<void>;
+export declare function createdByOnRamCreateUpdate<M extends Model, R extends RamRepository<M>>(this: R, context: RamContext, data: RelationsMetadata, key: keyof M, model: M): Promise<void>;

package/lib/ram/handlers.js.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../src/ram/handlers.ts"],"names":[],"mappings":";;AA0BA,gEAmBC;AAxCD,4DAAkD;AAElD;;;;;;;;;;;;;;;;;;GAkBG;AACI,KAAK,UAAU,0BAA0B,CAQ9C,OAAmB,EACnB,IAAO,EACP,GAAY,EACZ,KAAQ;IAER,MAAM,IAAI,GAAW,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC,IAAI;QACP,MAAM,IAAI,8BAAgB,CACxB,mDAAmD,CACpD,CAAC;IACJ,KAAK,CAAC,GAAG,CAAC,GAAG,IAAkB,CAAC;AAClC,CAAC"}
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../src/ram/handlers.ts"],"names":[],"mappings":";;AAyBA,gEAgBC;AAtCD,4DAAkD;AAGlD;;;;;;;;;;;;;;;;;;GAkBG;AACI,KAAK,UAAU,0BAA0B,CAK9C,OAAmB,EACnB,IAAuB,EACvB,GAAY,EACZ,KAAQ;IAER,MAAM,IAAI,GAAW,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC,IAAI;QACP,MAAM,IAAI,8BAAgB,CACxB,mDAAmD,CACpD,CAAC;IACJ,KAAK,CAAC,GAAG,CAAC,GAAG,IAAkB,CAAC;AAClC,CAAC"}

package/lib/ram/index.cjs

@@ -20,7 +20,6 @@ RamAdapter_1.RamAdapter.decoration();
 __exportStar(require("./model/index.cjs"), exports);
 __exportStar(require("./constants.cjs"), exports);
 __exportStar(require("./handlers.cjs"), exports);
-__exportStar(require("./RamContext.cjs"), exports);
 __exportStar(require("./RamPaginator.cjs"), exports);
 __exportStar(require("./RamStatement.cjs"), exports);
 __exportStar(require("./RamSequence.cjs"), exports);

package/lib/ram/index.d.ts

@@ -1,7 +1,6 @@
 export * from "./model";
 export * from "./constants";
 export * from "./handlers";
-export * from "./RamContext";
 export * from "./RamPaginator";
 export * from "./RamStatement";
 export * from "./RamSequence";

package/lib/ram/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ram/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA0C;AAE1C,8CAA8C;AAC9C,uBAAU,CAAC,UAAU,EAAE,CAAC;AAExB,oDAAwB;AACxB,kDAA4B;AAC5B,iDAA2B;AAC3B,mDAA6B;AAC7B,qDAA+B;AAC/B,qDAA+B;AAC/B,oDAA8B;AAC9B,8CAAwB;AACxB,0BAA0B;AAC1B,mDAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ram/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA0C;AAE1C,8CAA8C;AAC9C,uBAAU,CAAC,UAAU,EAAE,CAAC;AAExB,oDAAwB;AACxB,kDAA4B;AAC5B,iDAA2B;AAC3B,qDAA+B;AAC/B,qDAA+B;AAC/B,oDAA8B;AAC9B,8CAAwB;AACxB,0BAA0B;AAC1B,mDAA6B"}

package/lib/ram/types.d.ts

@@ -1,8 +1,8 @@
 import { Model } from "@decaf-ts/decorator-validation";
 import { Repository } from "../repository";
 import { Context, RepositoryFlags } from "@decaf-ts/db-decorators";
-import { RamAdapter } from "./RamAdapter";
 import { Constructor } from "@decaf-ts/decoration";
+import { Adapter } from "../persistence";
 /**
  * @description In-memory storage structure for the RAM adapter
  * @summary A nested Map structure that stores all entities by their table name and primary key.
@@ -28,7 +28,7 @@ export type RamStorage = Map<string, Map<string | number, any>>;
  * @memberOf module:core
  * @category Ram
  */
-export type RawRamQuery<M extends Model> = {
+export type RawRamQuery<M extends Model = any> = {
     select: undefined | (keyof M)[];
     from: Constructor<M>;
     where: (el: M) => boolean;
@@ -48,16 +48,8 @@ export type RawRamQuery<M extends Model> = {
 export interface RamFlags extends RepositoryFlags {
     UUID: string;
 }
-/**
- * @description Type definition for RAM-specific repository
- * @summary A specialized repository type for working with models in the RAM adapter.
- * It combines the model type with RAM-specific query, adapter, flags, and context types.
- * @template M - The model type managed by the repository
- * @typedef {Repository<M, RawRamQuery<any>, RamAdapter, RamFlags, Context<RamFlags>>} RamRepository
- * @memberOf module:core
- * @category Ram
- */
-export type RamRepository<M extends Model<true | false>> = Repository<M, RawRamQuery<any>, RamAdapter, RamFlags, Context<RamFlags>>;
+export type RamRepository<M extends Model<boolean>> = Repository<M, Adapter<RamConfig, RamStorage, RawRamQuery<any>, RamContext>>;
+export type RamContext = Context<RamFlags>;
 export type RamConfig = {
     user: string;
 };

package/lib/repository/Repository.cjs

@@ -17,9 +17,8 @@ const constants_1 = require("./../persistence/constants.cjs");
 const constants_2 = require("./constants.cjs");
 const Sequence_1 = require("./../persistence/Sequence.cjs");
 const Condition_1 = require("./../query/Condition.cjs");
-const utils_1 = require("./../identity/utils.cjs");
 const ObserverHandler_1 = require("./../persistence/ObserverHandler.cjs");
-const utils_2 = require("./../utils/index.cjs");
+const logging_1 = require("@decaf-ts/logging");
 const decoration_1 = require("@decaf-ts/decoration");
 /**
  * @description Core repository implementation for database operations on models on a table by table way.
@@ -105,13 +104,14 @@ class Repository extends db_decorators_1.Repository {
      */
     get tableName() {
         if (!this._tableName)
-            this._tableName = Repository.table(this.class);
+            this._tableName = decorator_validation_1.Model.tableName(this.class);
         return this._tableName;
     }
     /**
      * @description Primary key properties for this repository's model.
      * @summary Gets the sequence options containing primary key information.
      * @return {SequenceOptions} The primary key properties.
+     * @deprecated for Model.sequenceFor(class)
      */
     get pkProps() {
         return super.pkProps;
@@ -125,17 +125,6 @@ class Repository extends db_decorators_1.Repository {
         if (clazz) {
             Repository.register(clazz, this, this.adapter.alias);
             if (adapter) {
-                // const flavour = Metadata.flavourOf(clazz);
-                // if (
-                //   flavour &&
-                //   flavour !== DefaultFlavour &&
-                //   flavour !== adapter.flavour
-                // ) {
-                //   this.log.warn(
-                //     `Incompatible flavours detected between adapter (${adapter.flavour}) and model (${flavour})`
-                //   );
-                //   // throw new InternalError("Incompatible flavours");
-                // }
                 const flavour = decoration_1.Metadata.get(clazz, decoration_1.DecorationKeys.FLAVOUR);
                 if (flavour === decoration_1.DefaultFlavour) {
                     (0, decoration_1.uses)(adapter.flavour)(clazz);
@@ -147,6 +136,9 @@ class Repository extends db_decorators_1.Repository {
             (0, db_decorators_1.wrapMethodWithContext)(this, this[name + "Prefix"], m, this[name + "Suffix"]);
         });
     }
+    logCtx(args, method) {
+        return Adapter_1.Adapter.logCtx(args, method);
+    }
     /**
      * @description Creates a proxy with overridden repository flags.
      * @summary Returns a proxy of this repository with the specified flags overridden.
@@ -154,9 +146,6 @@ class Repository extends db_decorators_1.Repository {
      * @return {Repository} A proxy of this repository with overridden flags.
      */
     override(flags) {
-        this.log
-            .for(this.override)
-            .debug(`Overriding repository flags with ${JSON.stringify(flags)}`);
         return new Proxy(this, {
             get: (target, p, receiver) => {
                 const result = Reflect.get(target, p, receiver);
@@ -208,11 +197,16 @@ class Repository extends db_decorators_1.Repository {
      */
     async createPrefix(model, ...args) {
         const contextArgs = await db_decorators_1.Context.args(db_decorators_1.OperationKeys.CREATE, this.class, args, this.adapter, this._overrides || {});
+        const shouldRunHandlers = contextArgs.context.get("ignoreHandlers") !== false;
+        const shouldValidate = !contextArgs.context.get("ignoreValidation");
         model = new this.class(model);
-        await (0, db_decorators_1.enforceDBDecorators)(this, contextArgs.context, model, db_decorators_1.OperationKeys.CREATE, db_decorators_1.OperationKeys.ON);
-        const errors = await Promise.resolve(model.hasErrors(...(contextArgs.context.get("ignoredValidationProperties") || [])));
-        if (errors)
-            throw new db_decorators_1.ValidationError(errors.toString());
+        if (shouldRunHandlers)
+            await (0, db_decorators_1.enforceDBDecorators)(this, contextArgs.context, model, db_decorators_1.OperationKeys.CREATE, db_decorators_1.OperationKeys.ON);
+        if (shouldValidate) {
+            const errors = await Promise.resolve(model.hasErrors(...(contextArgs.context.get("ignoredValidationProperties") || [])));
+            if (errors)
+                throw new db_decorators_1.ValidationError(errors.toString());
+        }
         return [model, ...contextArgs.args];
     }
     /**
@@ -223,13 +217,12 @@ class Repository extends db_decorators_1.Repository {
      * @return {Promise<M>} The created model with updated properties.
      */
     async create(model, ...args) {
+        const { ctx, log, ctxArgs } = this.logCtx(args, this.create);
+        log.debug(`Creating new ${this.class.name} in table ${decorator_validation_1.Model.tableName(this.class)}`);
         // eslint-disable-next-line prefer-const
-        let { record, id, transient } = this.adapter.prepare(model, this.pk);
-        record = await this.adapter.create(this.tableName, id, record, ...args);
-        let c = undefined;
-        if (args.length)
-            c = args[args.length - 1];
-        return this.adapter.revert(record, this.class, this.pk, id, c && c.get("rebuildWithTransient") ? transient : undefined);
+        let { record, id, transient } = this.adapter.prepare(model, ctx);
+        record = await this.adapter.create(this.class, id, record, ...ctxArgs);
+        return this.adapter.revert(record, this.class, id, transient, ctx);
     }
     /**
      * @description Post-creation hook.
@@ -251,11 +244,13 @@ class Repository extends db_decorators_1.Repository {
     async createAll(models, ...args) {
         if (!models.length)
             return models;
-        const prepared = models.map((m) => this.adapter.prepare(m, this.pk));
+        const { ctx, log, ctxArgs } = this.logCtx(args, this.createAll);
+        log.debug(`Creating ${models.length} new ${this.class.name} in table ${decorator_validation_1.Model.tableName(this.class)}`);
+        const prepared = models.map((m) => this.adapter.prepare(m, ctx));
         const ids = prepared.map((p) => p.id);
         let records = prepared.map((p) => p.record);
-        records = await this.adapter.createAll(this.tableName, ids, records, ...args);
-        return records.map((r, i) => this.adapter.revert(r, this.class, this.pk, ids[i]));
+        records = await this.adapter.createAll(this.class, ids, records, ...ctxArgs);
+        return records.map((r, i) => this.adapter.revert(r, this.class, ids[i], ctx.get("rebuildWithTransient") ? prepared[i].transient : undefined, ctx));
     }
     /**
      * @description Prepares multiple models for creation.
@@ -267,14 +262,16 @@ class Repository extends db_decorators_1.Repository {
      */
     async createAllPrefix(models, ...args) {
         const contextArgs = await db_decorators_1.Context.args(db_decorators_1.OperationKeys.CREATE, this.class, args, this.adapter, this._overrides || {});
+        const shouldRunHandlers = contextArgs.context.get("ignoreHandlers") !== false;
+        const shouldValidate = !contextArgs.context.get("ignoreValidation");
         if (!models.length)
             return [models, ...contextArgs.args];
-        const opts = Repository.getSequenceOptions(models[0]);
+        const opts = decorator_validation_1.Model.sequenceFor(models[0]);
         let ids = [];
         if (opts.type) {
             if (!opts.name)
                 opts.name = Sequence_1.Sequence.pk(models[0]);
-            ids = await (await this.adapter.Sequence(opts)).range(models.length);
+            ids = await (await this.adapter.Sequence(opts)).range(models.length, ...contextArgs.args);
         }
         else {
             ids = models.map((m, i) => {
@@ -292,21 +289,17 @@ class Repository extends db_decorators_1.Repository {
                         ? ids[i]
                         : `${m[this.pk]}`.toString());
             }
-            await (0, db_decorators_1.enforceDBDecorators)(this, contextArgs.context, m, db_decorators_1.OperationKeys.CREATE, db_decorators_1.OperationKeys.ON);
+            if (shouldRunHandlers)
+                await (0, db_decorators_1.enforceDBDecorators)(this, contextArgs.context, m, db_decorators_1.OperationKeys.CREATE, db_decorators_1.OperationKeys.ON);
             return m;
         }));
-        const ignoredProps = contextArgs.context.get("ignoredValidationProperties") || [];
-        const errors = await Promise.all(models.map((m) => Promise.resolve(m.hasErrors(...ignoredProps))));
-        const errorMessages = errors.reduce((accum, e, i) => {
-            if (e)
-                accum =
-                    typeof accum === "string"
-                        ? accum + `\n - ${i}: ${e.toString()}`
-                        : ` - ${i}: ${e.toString()}`;
-            return accum;
-        }, undefined);
-        if (errorMessages)
-            throw new db_decorators_1.ValidationError(errorMessages);
+        if (shouldValidate) {
+            const ignoredProps = contextArgs.context.get("ignoredValidationProperties") || [];
+            const errors = await Promise.all(models.map((m) => Promise.resolve(m.hasErrors(...ignoredProps))));
+            const errorMessages = (0, db_decorators_1.reduceErrorsToPrint)(errors);
+            if (errorMessages)
+                throw new db_decorators_1.ValidationError(errorMessages);
+        }
         return [models, ...contextArgs.args];
     }
     /**
@@ -326,13 +319,15 @@ class Repository extends db_decorators_1.Repository {
     /**
      * @description Reads a model from the database by ID.
      * @summary Retrieves a model instance from the database using its primary key.
-     * @param {string|number|bigint} id - The primary key of the model to read.
+     * @param {PrimaryKeyType} id - The primary key of the model to read.
      * @param {...any[]} args - Additional arguments.
      * @return {Promise<M>} The retrieved model instance.
      */
     async read(id, ...args) {
-        const m = await this.adapter.read(this.tableName, id, ...args);
-        return this.adapter.revert(m, this.class, this.pk, id);
+        const { ctx, log, ctxArgs } = this.logCtx(args, this.read);
+        log.debug(`reading ${this.class.name} from table ${decorator_validation_1.Model.tableName(this.class)} with pk ${this.pk}`);
+        const m = await this.adapter.read(this.class, id, ...ctxArgs);
+        return this.adapter.revert(m, this.class, id, undefined, ctx);
     }
     /**
      * @description Prepares for reading multiple models by IDs.
@@ -358,8 +353,10 @@ class Repository extends db_decorators_1.Repository {
      * @return {Promise<M[]>} The retrieved model instances.
      */
     async readAll(keys, ...args) {
-        const records = await this.adapter.readAll(this.tableName, keys, ...args);
-        return records.map((r, i) => this.adapter.revert(r, this.class, this.pk, keys[i]));
+        const { ctx, log, ctxArgs } = this.logCtx(args, this.readAll);
+        log.debug(`reading ${keys.length} ${this.class.name} in table ${decorator_validation_1.Model.tableName(this.class)}`);
+        const records = await this.adapter.readAll(this.class, keys, ...ctxArgs);
+        return records.map((r, i) => this.adapter.revert(r, this.class, keys[i], undefined, ctx));
     }
     /**
      * @description Updates a model in the database.
@@ -369,10 +366,12 @@ class Repository extends db_decorators_1.Repository {
      * @return {Promise<M>} The updated model with refreshed properties.
      */
     async update(model, ...args) {
+        const { ctxArgs, log, ctx } = this.logCtx(args, this.update);
         // eslint-disable-next-line prefer-const
-        let { record, id, transient } = this.adapter.prepare(model, this.pk);
-        record = await this.adapter.update(this.tableName, id, record, ...args);
-        return this.adapter.revert(record, this.class, this.pk, id, transient);
+        let { record, id, transient } = this.adapter.prepare(model, ctx);
+        log.debug(`updating ${this.class.name} in table ${decorator_validation_1.Model.tableName(this.class)} with id ${id}`);
+        record = await this.adapter.update(this.class, id, record, ...ctxArgs);
+        return this.adapter.revert(record, this.class, id, transient, ctx);
     }
     /**
      * @description Prepares a model for update.
@@ -385,18 +384,19 @@ class Repository extends db_decorators_1.Repository {
      */
     async updatePrefix(model, ...args) {
         const contextArgs = await db_decorators_1.Context.args(db_decorators_1.OperationKeys.UPDATE, this.class, args, this.adapter, this._overrides || {});
+        const shouldRunHandlers = contextArgs.context.get("ignoreHandlers") !== false;
+        const shouldValidate = !contextArgs.context.get("ignoreValidation");
         const pk = model[this.pk];
         if (!pk)
             throw new db_decorators_1.InternalError(`No value for the Id is defined under the property ${this.pk}`);
         const oldModel = await this.read(pk, ...contextArgs.args);
-        model = this.merge(oldModel, model);
-        await (0, db_decorators_1.enforceDBDecorators)(this, contextArgs.context, model, db_decorators_1.OperationKeys.UPDATE, db_decorators_1.OperationKeys.ON, oldModel);
-        const errors = await Promise.resolve(model.hasErrors(oldModel, ...Repository.relations(this.class), ...(contextArgs.context.get("ignoredValidationProperties") || [])));
-        if (errors)
-            throw new db_decorators_1.ValidationError(errors.toString());
-        if (Repository.getMetadata(oldModel)) {
-            if (!Repository.getMetadata(model))
-                Repository.setMetadata(model, Repository.getMetadata(oldModel));
+        model = decorator_validation_1.Model.merge(oldModel, model, this.class);
+        if (shouldRunHandlers)
+            await (0, db_decorators_1.enforceDBDecorators)(this, contextArgs.context, model, db_decorators_1.OperationKeys.UPDATE, db_decorators_1.OperationKeys.ON, oldModel);
+        if (shouldValidate) {
+            const errors = await Promise.resolve(model.hasErrors(oldModel, ...decorator_validation_1.Model.relations(this.class), ...(contextArgs.context.get("ignoredValidationProperties") || [])));
+            if (errors)
+                throw new db_decorators_1.ValidationError(errors.toString());
         }
         return [model, ...contextArgs.args];
     }
@@ -408,9 +408,11 @@ class Repository extends db_decorators_1.Repository {
      * @return {Promise<M[]>} The updated models with refreshed properties.
      */
     async updateAll(models, ...args) {
-        const records = models.map((m) => this.adapter.prepare(m, this.pk));
-        const updated = await this.adapter.updateAll(this.tableName, records.map((r) => r.id), records.map((r) => r.record), ...args);
-        return updated.map((u, i) => this.adapter.revert(u, this.class, this.pk, records[i].id));
+        const { ctx, log, ctxArgs } = this.logCtx(args, this.updateAll);
+        log.debug(`Updating ${models.length} new ${this.class.name} in table ${decorator_validation_1.Model.tableName(this.class)}`);
+        const records = models.map((m) => this.adapter.prepare(m, ctx));
+        const updated = await this.adapter.updateAll(this.class, records.map((r) => r.id), records.map((r) => r.record), ...ctxArgs);
+        return updated.map((u, i) => this.adapter.revert(u, this.class, records[i].id, ctx.get("rebuildWithTransient") ? records[i].transient : undefined, ctx));
     }
     /**
      * @description Prepares multiple models for update.
@@ -423,6 +425,8 @@ class Repository extends db_decorators_1.Repository {
      */
     async updateAllPrefix(models, ...args) {
         const contextArgs = await db_decorators_1.Context.args(db_decorators_1.OperationKeys.UPDATE, this.class, args, this.adapter, this._overrides || {});
+        const shouldRunHandlers = contextArgs.context.get("ignoreHandlers") !== false;
+        const shouldValidate = !contextArgs.context.get("ignoreValidation");
         const ids = models.map((m) => {
             const id = m[this.pk];
             if (!id)
@@ -431,32 +435,18 @@ class Repository extends db_decorators_1.Repository {
         });
         const oldModels = await this.readAll(ids, ...contextArgs.args);
         models = models.map((m, i) => {
-            m = this.merge(oldModels[i], m);
-            if (Repository.getMetadata(oldModels[i])) {
-                if (!Repository.getMetadata(m))
-                    Repository.setMetadata(m, Repository.getMetadata(oldModels[i]));
-            }
+            m = decorator_validation_1.Model.merge(oldModels[i], m, this.class);
             return m;
         });
-        await Promise.all(models.map((m, i) => (0, db_decorators_1.enforceDBDecorators)(this, contextArgs.context, m, db_decorators_1.OperationKeys.UPDATE, db_decorators_1.OperationKeys.ON, oldModels[i])));
-        const ignoredProps = contextArgs.context.get("ignoredValidationProperties") || [];
-        const errors = await Promise.all(models.map((m, i) => Promise.resolve(m.hasErrors(oldModels[i], m, ...ignoredProps))));
-        const errorMessages = errors.reduce((accum, e, i) => {
-            if (e)
-                accum =
-                    typeof accum === "string"
-                        ? accum + `\n - ${i}: ${e.toString()}`
-                        : ` - ${i}: ${e.toString()}`;
-            return accum;
-        }, undefined);
-        if (errorMessages)
-            throw new db_decorators_1.ValidationError(errorMessages);
-        models.forEach((m, i) => {
-            if (Repository.getMetadata(oldModels[i])) {
-                if (!Repository.getMetadata(m))
-                    Repository.setMetadata(m, Repository.getMetadata(oldModels[i]));
-            }
-        });
+        if (shouldRunHandlers)
+            await Promise.all(models.map((m, i) => (0, db_decorators_1.enforceDBDecorators)(this, contextArgs.context, m, db_decorators_1.OperationKeys.UPDATE, db_decorators_1.OperationKeys.ON, oldModels[i])));
+        if (shouldValidate) {
+            const ignoredProps = contextArgs.context.get("ignoredValidationProperties") || [];
+            const errors = await Promise.all(models.map((m, i) => Promise.resolve(m.hasErrors(oldModels[i], m, ...ignoredProps))));
+            const errorMessages = (0, db_decorators_1.reduceErrorsToPrint)(errors);
+            if (errorMessages)
+                throw new db_decorators_1.ValidationError(errorMessages);
+        }
         return [models, ...contextArgs.args];
     }
     /**
@@ -480,8 +470,10 @@ class Repository extends db_decorators_1.Repository {
      * @return {Promise<M>} The deleted model instance.
      */
     async delete(id, ...args) {
-        const m = await this.adapter.delete(this.tableName, id, ...args);
-        return this.adapter.revert(m, this.class, this.pk, id);
+        const { ctx, log, ctxArgs } = this.logCtx(args, this.delete);
+        log.debug(`deleting new ${this.class.name} in table ${decorator_validation_1.Model.tableName(this.class)} with pk ${id}`);
+        const m = await this.adapter.delete(this.class, id, ...ctxArgs);
+        return this.adapter.revert(m, this.class, id, undefined, ctx);
     }
     /**
      * @description Prepares for deleting multiple models by IDs.
@@ -506,8 +498,10 @@ class Repository extends db_decorators_1.Repository {
      * @return {Promise<M[]>} The deleted model instances.
      */
     async deleteAll(keys, ...args) {
-        const results = await this.adapter.deleteAll(this.tableName, keys, ...args);
-        return results.map((r, i) => this.adapter.revert(r, this.class, this.pk, keys[i]));
+        const { ctx, log, ctxArgs } = this.logCtx(args, this.create);
+        log.debug(`deleting ${keys.length} ${this.class.name} in table ${decorator_validation_1.Model.tableName(this.class)}`);
+        const results = await this.adapter.deleteAll(this.class, keys, ...ctxArgs);
+        return results.map((r, i) => this.adapter.revert(r, this.class, keys[i], undefined, ctx));
     }
     /**
      * @description Implementation of the select method.
@@ -559,8 +553,18 @@ class Repository extends db_decorators_1.Repository {
                 writable: false,
             });
         const log = this.log.for(this.observe);
-        const tableName = Repository.table(this.class);
-        this.adapter.observe(this, (table) => tableName === table);
+        const tableName = decorator_validation_1.Model.tableName(this.class);
+        this.adapter.observe(this, (table, 
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        event, 
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        id, 
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        ...args) => {
+            if (typeof table === "string")
+                return table === tableName;
+            return decoration_1.Metadata.constr(table) === decoration_1.Metadata.constr(this.class);
+        });
         log.verbose(`now observing ${this.adapter} filtering on table === ${tableName}`);
         this.observerHandler.observe(observer, filter);
         log.verbose(`Registered new observer ${observer.toString()}`);
@@ -599,12 +603,11 @@ class Repository extends db_decorators_1.Repository {
     async updateObservers(table, event, id, ...args) {
         if (!this.observerHandler)
             throw new db_decorators_1.InternalError("ObserverHandler not initialized. Did you register any observables?");
-        this.log
-            .for(this.updateObservers)
-            .verbose(`Updating ${this.observerHandler.count()} observers for ${this}`);
-        await this.observerHandler.updateObservers(this.log, table, event, Array.isArray(id)
-            ? id.map((i) => Sequence_1.Sequence.parseValue(this.pkProps?.type, i))
-            : Sequence_1.Sequence.parseValue(this.pkProps?.type, id), ...args);
+        const { log, ctxArgs } = this.logCtx(args, this.updateObservers);
+        log.verbose(`Updating ${this.observerHandler.count()} observers for ${this}`);
+        await this.observerHandler.updateObservers(table, event, Array.isArray(id)
+            ? id.map((i) => Sequence_1.Sequence.parseValue(decorator_validation_1.Model.sequenceFor(this.class).type, i))
+            : Sequence_1.Sequence.parseValue(decorator_validation_1.Model.sequenceFor(this.class).type, id), ...ctxArgs);
     }
     /**
      * @description Alias for updateObservers.
@@ -663,7 +666,7 @@ class Repository extends db_decorators_1.Repository {
      * @throws {InternalError} If no repository is registered for the model.
      */
     static get(model, alias) {
-        const name = Repository.table(model);
+        const name = decorator_validation_1.Model.tableName(model);
         let registryName = name;
         if (alias) {
             registryName = [name, alias].join(db_decorators_1.DefaultSeparator);
@@ -684,7 +687,7 @@ class Repository extends db_decorators_1.Repository {
      * @throws {InternalError} If a repository is already registered for the model.
      */
     static register(model, repo, alias) {
-        let name = Repository.table(model);
+        let name = decorator_validation_1.Model.tableName(model);
         if (alias) {
             name = [name, alias].join(db_decorators_1.DefaultSeparator);
         }
@@ -694,114 +697,16 @@ class Repository extends db_decorators_1.Repository {
         }
         this._cache[name] = repo;
     }
-    /**
-     * @description Sets metadata on a model instance.
-     * @summary Attaches metadata to a model instance using a non-enumerable property.
-     * @template M - The model type that extends Model.
-     * @param {M} model - The model instance.
-     * @param {any} metadata - The metadata to attach to the model.
-     */
-    static setMetadata(model, metadata) {
-        Object.defineProperty(model, constants_1.PersistenceKeys.METADATA, {
-            enumerable: false,
-            configurable: true,
-            writable: false,
-            value: metadata,
-        });
-    }
-    /**
-     * @description Gets metadata from a model instance.
-     * @summary Retrieves previously attached metadata from a model instance.
-     * @template M - The model type that extends Model.
-     * @param {M} model - The model instance.
-     * @return {any} The metadata or undefined if not found.
-     */
-    static getMetadata(model) {
-        const descriptor = Object.getOwnPropertyDescriptor(model, constants_1.PersistenceKeys.METADATA);
-        return descriptor ? descriptor.value : undefined;
-    }
-    /**
-     * @description Removes metadata from a model instance.
-     * @summary Deletes the metadata property from a model instance.
-     * @template M - The model type that extends Model.
-     * @param {M} model - The model instance.
-     */
-    static removeMetadata(model) {
-        const descriptor = Object.getOwnPropertyDescriptor(model, constants_1.PersistenceKeys.METADATA);
-        if (descriptor)
-            delete model[constants_1.PersistenceKeys.METADATA];
-    }
-    /**
-     * @description Gets sequence options for a model's primary key.
-     * @summary Retrieves the sequence configuration for a model's primary key from metadata.
-     * @template M - The model type that extends Model.
-     * @param {M} model - The model instance.
-     * @return {SequenceOptions} The sequence options for the model's primary key.
-     * @throws {InternalError} If no sequence options are defined for the model.
-     */
-    static getSequenceOptions(model) {
-        const pkName = decorator_validation_1.Model.pk(model.constructor);
-        const key = decoration_1.Metadata.key(db_decorators_1.DBKeys.ID, pkName);
-        const metadata = decoration_1.Metadata.get(model.constructor, key);
-        if (!metadata)
-            throw new db_decorators_1.InternalError("No sequence options defined for model. did you use the @pk decorator?");
-        return metadata;
-    }
-    /**
-     * @description Gets all indexes defined on a model.
-     * @summary Retrieves all index metadata from a model's property decorators.
-     * @template M - The model type that extends Model.
-     * @param {M | Constructor<M>} model - The model instance or constructor.
-     * @return {Record<string, Record<string, IndexMetadata>>} A nested record of property names to index metadata.
-     */
-    static indexes(model) {
-        const indexDecorators = decoration_1.Metadata.get(model instanceof decorator_validation_1.Model ? model.constructor : model, constants_1.PersistenceKeys.INDEX);
-        return Object.keys(indexDecorators || {}).reduce((acum, t) => {
-            acum[t] = { [constants_1.PersistenceKeys.INDEX]: indexDecorators[t] };
-            return acum;
-        }, {});
-    }
-    /**
-     * @description Gets all relation properties defined on a model.
-     * @summary Retrieves the names of all properties marked as relations in the model hierarchy.
-     * @template M - The model type that extends Model.
-     * @param {M | Constructor<M>} model - The model instance or constructor.
-     * @return {string[]} An array of property names that are relations.
-     */
-    static relations(model) {
-        return (decoration_1.Metadata.relations(model instanceof decorator_validation_1.Model ? model.constructor : model) || []);
-    }
-    /**
-     * @description Gets the table name for a model.
-     * @summary Retrieves the database table name associated with a model.
-     * @template M - The model type that extends Model.
-     * @param {M | Constructor<M>} model - The model instance or constructor.
-     * @return {string} The table name for the model.
-     */
-    static table(model) {
-        return (0, utils_1.getTableName)(model);
-    }
-    /**
-     * @description Gets the column name for a model attribute.
-     * @summary Retrieves the database column name for a model property.
-     * @template M - The model type that extends Model.
-     * @param {M} model - The model instance.
-     * @param {string} attribute - The attribute/property name.
-     * @return {string} The column name for the attribute.
-     */
-    static column(model, attribute) {
-        return (0, utils_1.getColumnName)(model, attribute);
-    }
 }
 exports.Repository = Repository;
 __decorate([
-    (0, utils_2.final)(),
+    (0, logging_1.final)(),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, Function]),
     __metadata("design:returntype", void 0)
 ], Repository.prototype, "observe", null);
 __decorate([
-    (0, utils_2.final)(),
+    (0, logging_1.final)(),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object]),
     __metadata("design:returntype", void 0)