@venizia/ignis 0.1.1-9 → 0.1.1

package/dist/connectors/relational/repositories/core/base.d.ts.map

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

package/dist/connectors/relational/repositories/core/base.js

@@ -0,0 +1,185 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RelationalBaseRepository = void 0;
+const core_1 = require("../../../../base/repositories/core");
+const common_1 = require("../../../../connectors/relational/datasources/common");
+const ignis_helpers_1 = require("@venizia/ignis-helpers");
+const drizzle_orm_1 = require("drizzle-orm");
+/** Relational implementation of `AbstractRepository`: adds the query dialect + hidden-column exclusion on top of the neutral base, and reaches the database only through `IRelationalQueryExecutor`. Both engine-facing parameters default to the neutral SQL contracts; an engine binds them by subclassing. */
+class RelationalBaseRepository extends core_1.AbstractRepository {
+    constructor(dataSource, opts) {
+        super(dataSource, opts);
+        /** Memoized Set view of the base's `hiddenFields` array - built once on first access. */
+        this._hiddenPropertySet = null;
+        /** Memoized Drizzle column-selection map derived from hidden fields. `null` = not yet computed; `undefined` = computed, no hidden fields. */
+        this._visibleColumns = null;
+    }
+    get dataSource() {
+        return super.dataSource;
+    }
+    set dataSource(value) {
+        super.dataSource = value;
+    }
+    get entity() {
+        return super.entity;
+    }
+    set entity(value) {
+        super.entity = value;
+    }
+    get queryDialect() {
+        return this.dataSource.getQueryDialect();
+    }
+    /** Every Drizzle call the repository tier makes goes through this port, supplied by the engine branch via the datasource. */
+    get queryExecutor() {
+        return this.dataSource.getQueryExecutor();
+    }
+    get connector() {
+        return this.dataSource.getConnector();
+    }
+    setDataSource(opts) {
+        super.setDataSource(opts);
+    }
+    getEntitySchema() {
+        return this.entity.schema;
+    }
+    /** Hidden fields as a memoized Set, derived from the base's class-keyed `hiddenFields` array. */
+    getHiddenProperties() {
+        this._hiddenPropertySet ??= new Set(this.hiddenFields);
+        return this._hiddenPropertySet;
+    }
+    hasHiddenProperties() {
+        return this.getHiddenProperties().size > 0;
+    }
+    /** Drizzle select/returning column map excluding hidden properties. Undefined if none hidden. Memoized. */
+    getVisibleProperties() {
+        if (this._visibleColumns !== null) {
+            return this._visibleColumns;
+        }
+        const hiddenProps = this.getHiddenProperties();
+        if (hiddenProps.size === 0) {
+            this._visibleColumns = undefined;
+            return undefined;
+        }
+        const columns = (0, drizzle_orm_1.getTableColumns)(this.entity.schema);
+        const visibleProperties = {};
+        for (const key in columns) {
+            if (!hiddenProps.has(key)) {
+                visibleProperties[key] = columns[key];
+            }
+        }
+        this._visibleColumns = visibleProperties;
+        return this._visibleColumns;
+    }
+    getDefaultFilter() {
+        return this.modelSettings?.defaultFilter;
+    }
+    getDefaultLimit() {
+        return this.defaultLimit;
+    }
+    hasDefaultFilter() {
+        const defaultFilter = this.getDefaultFilter();
+        return defaultFilter !== undefined && Object.keys(defaultFilter).length > 0;
+    }
+    /** Merges default filter with user filter. Skippable via shouldSkipDefaultFilter. */
+    applyDefaultFilter(opts) {
+        const { userFilter, shouldSkipDefaultFilter } = opts;
+        if (shouldSkipDefaultFilter) {
+            return userFilter ?? {};
+        }
+        const defaultFilter = this.getDefaultFilter();
+        if (!defaultFilter) {
+            return userFilter ?? {};
+        }
+        return this.queryDialect.mergeFilter({ defaultFilter, userFilter });
+    }
+    async beginTransaction(opts) {
+        return this.dataSource.beginTransaction(opts);
+    }
+    /** Builds Drizzle query options from a filter, excluding hidden properties. */
+    buildQuery(opts) {
+        const result = this.queryDialect.build({
+            tableName: this.entity.name,
+            schema: this.entity.schema,
+            filter: opts.filter,
+        });
+        if (!this.hasHiddenProperties()) {
+            return result;
+        }
+        const hiddenProps = this.getHiddenProperties();
+        if (result.columns) {
+            result.columns = this.omitHiddenColumns({ columns: result.columns, hiddenProps });
+            return result;
+        }
+        const visibleProps = this.getVisibleProperties();
+        if (visibleProps) {
+            const filteredColumns = {};
+            for (const key in visibleProps) {
+                filteredColumns[key] = true;
+            }
+            result.columns = filteredColumns;
+        }
+        return result;
+    }
+    /** Copy of a Drizzle column selection with hidden properties dropped. */
+    omitHiddenColumns(opts) {
+        const { columns, hiddenProps } = opts;
+        const filteredColumns = {};
+        for (const key in columns) {
+            if (hiddenProps.has(key)) {
+                continue;
+            }
+            filteredColumns[key] = columns[key];
+        }
+        return filteredColumns;
+    }
+    /** Resolves the database connector, using the transaction's connector if provided. */
+    resolveConnector(opts) {
+        const { transaction } = opts ?? {};
+        if (!transaction) {
+            return this.dataSource.getConnector();
+        }
+        if (!transaction.isActive) {
+            throw (0, ignis_helpers_1.getError)({
+                message: `[${this.constructor.name}][resolveConnector] Transaction is no longer active`,
+            });
+        }
+        if (!(0, common_1.isRelationalTransaction)(transaction)) {
+            throw (0, ignis_helpers_1.getError)({
+                message: `[${this.constructor.name}][resolveConnector] Transaction is not a relational transaction`,
+            });
+        }
+        return transaction.connector;
+    }
+    /** Validates lock options: requires transaction, incompatible with Query API (include/fields). */
+    validateLockOptions(opts) {
+        if (!opts.lock) {
+            return;
+        }
+        if (!opts.transaction) {
+            throw (0, ignis_helpers_1.getError)({
+                message: `[${this.constructor.name}][validateLockOptions] Row-level locking requires a transaction`,
+            });
+        }
+        if (opts.usesQueryAPI) {
+            throw (0, ignis_helpers_1.getError)({
+                message: `[${this.constructor.name}][validateLockOptions] Row-level locking is incompatible with Query API`,
+            });
+        }
+    }
+    updateBy(opts) {
+        const { data, where, options } = opts;
+        if (options?.shouldReturn === false) {
+            return this.updateAll({ data, where, options: { ...options, shouldReturn: false } });
+        }
+        return this.updateAll({ data, where, options });
+    }
+    deleteBy(opts) {
+        const { where, options } = opts;
+        if (options?.shouldReturn === false) {
+            return this.deleteAll({ where, options: { ...options, shouldReturn: false } });
+        }
+        return this.deleteAll({ where, options });
+    }
+}
+exports.RelationalBaseRepository = RelationalBaseRepository;
+//# sourceMappingURL=base.js.map

package/dist/connectors/relational/repositories/core/base.js.map

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

package/dist/connectors/relational/repositories/core/default.d.ts

@@ -0,0 +1,9 @@
+import type { IExtraOptions } from '../../../../base/repositories/common';
+import type { IRelationalDataSource } from '../../../../connectors/relational/datasources/common';
+import type { TTableInsert, TTableObject, TTableSchemaWithId } from '../../../../connectors/relational/models';
+import type { IRelationalExtraOptions } from '../common';
+import { PersistableRelationalRepository } from './persistable';
+/** Recommended base class for most repositories - full CRUD. Engine-neutral: an engine binds `ExtraOptions` and `TDataSource` by subclassing, the way `DefaultCRUDRepository` does for Postgres. */
+export declare class DefaultRelationalRepository<EntitySchema extends TTableSchemaWithId = TTableSchemaWithId, DataObject extends TTableObject<EntitySchema> = TTableObject<EntitySchema>, PersistObject extends TTableInsert<EntitySchema> = TTableInsert<EntitySchema>, ExtraOptions extends IExtraOptions = IRelationalExtraOptions, TDataSource extends IRelationalDataSource = IRelationalDataSource> extends PersistableRelationalRepository<EntitySchema, DataObject, PersistObject, ExtraOptions, TDataSource> {
+}
+//# sourceMappingURL=default.d.ts.map

package/dist/connectors/relational/repositories/core/default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/relational/repositories/core/default.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,kBAAkB,EACnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,+BAA+B,EAAE,MAAM,eAAe,CAAC;AAEhE,oMAAoM;AACpM,qBAAa,2BAA2B,CACtC,YAAY,SAAS,kBAAkB,GAAG,kBAAkB,EAC5D,UAAU,SAAS,YAAY,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC,YAAY,CAAC,EAC1E,aAAa,SAAS,YAAY,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC,YAAY,CAAC,EAC7E,YAAY,SAAS,aAAa,GAAG,uBAAuB,EAC5D,WAAW,SAAS,qBAAqB,GAAG,qBAAqB,CACjE,SAAQ,+BAA+B,CACvC,YAAY,EACZ,UAAU,EACV,aAAa,EACb,YAAY,EACZ,WAAW,CACZ;CAAG"}

package/dist/connectors/relational/repositories/core/default.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultRelationalRepository = void 0;
+const persistable_1 = require("./persistable");
+/** Recommended base class for most repositories - full CRUD. Engine-neutral: an engine binds `ExtraOptions` and `TDataSource` by subclassing, the way `DefaultCRUDRepository` does for Postgres. */
+class DefaultRelationalRepository extends persistable_1.PersistableRelationalRepository {
+}
+exports.DefaultRelationalRepository = DefaultRelationalRepository;
+//# sourceMappingURL=default.js.map

package/dist/connectors/relational/repositories/core/default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.js","sourceRoot":"","sources":["../../../../../src/connectors/relational/repositories/core/default.ts"],"names":[],"mappings":";;;AAQA,+CAAgE;AAEhE,oMAAoM;AACpM,MAAa,2BAMX,SAAQ,6CAMT;CAAG;AAZJ,kEAYI"}

package/dist/connectors/relational/repositories/core/index.d.ts

@@ -0,0 +1,6 @@
+export * from './base';
+export * from './readable';
+export * from './persistable';
+export * from './default';
+export * from './soft-deletable';
+//# sourceMappingURL=index.d.ts.map

package/dist/connectors/relational/repositories/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/relational/repositories/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC"}

package/dist/connectors/relational/repositories/core/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./base"), exports);
+__exportStar(require("./readable"), exports);
+__exportStar(require("./persistable"), exports);
+__exportStar(require("./default"), exports);
+__exportStar(require("./soft-deletable"), exports);
+//# sourceMappingURL=index.js.map

package/dist/connectors/relational/repositories/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/connectors/relational/repositories/core/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,6CAA2B;AAC3B,gDAA8B;AAC9B,4CAA0B;AAC1B,mDAAiC"}

package/dist/connectors/relational/repositories/core/persistable.d.ts

@@ -0,0 +1,181 @@
+import type { IdType } from '../../../../base/models';
+import type { IExtraOptions, TCount, TRepositoryLogOptions, TWhere } from '../../../../base/repositories/common';
+import type { IRelationalDataSource } from '../../../../connectors/relational/datasources/common';
+import type { BaseRelationalEntity, TTableInsert, TTableObject, TTableSchemaWithId } from '../../../../connectors/relational/models';
+import type { AnyType, TClass, TNullable } from '@venizia/ignis-helpers';
+import type { SQL } from 'drizzle-orm';
+import type { IRelationalExtraOptions } from '../common';
+import { ReadableRelationalRepository } from './readable';
+/** Full CRUD repository extending ReadableRelationalRepository with create, update, and delete. */
+export declare class PersistableRelationalRepository<EntitySchema extends TTableSchemaWithId = TTableSchemaWithId, DataObject extends TTableObject<EntitySchema> = TTableObject<EntitySchema>, PersistObject extends TTableInsert<EntitySchema> = TTableInsert<EntitySchema>, ExtraOptions extends IExtraOptions = IRelationalExtraOptions, TDataSource extends IRelationalDataSource = IRelationalDataSource> extends ReadableRelationalRepository<EntitySchema, DataObject, PersistObject, ExtraOptions, TDataSource> {
+    constructor(ds?: TDataSource, opts?: {
+        entityClass?: TClass<BaseRelationalEntity<EntitySchema>>;
+    });
+    /** @deprecated Reach the engine's update transform through `dataSource.getQueryDialect()`. Engines without an update builder return `undefined`. `AnyType` rather than `unknown`: the concrete builder is engine-specific, and `unknown` breaks every `updateBuilder.transform(...)` call site. */
+    get updateBuilder(): AnyType;
+    /** Guards id-based operations against a null/undefined id */
+    protected validateId(opts: {
+        id: unknown;
+        operationName: string;
+    }): void;
+    /** Prevents accidental table-wide updates/deletes by requiring an explicit force flag; returns the built where SQL so callers reuse it instead of rebuilding on identical input. */
+    protected validateWhereCondition(opts: {
+        where: TWhere<DataObject>;
+        force?: boolean;
+        operationName: string;
+    }): {
+        condition: SQL | undefined;
+        isEmptyWhere: boolean;
+    };
+    protected _create<R = DataObject>(opts: {
+        data: Array<PersistObject>;
+        options: ExtraOptions & {
+            shouldReturn?: boolean;
+            log?: TRepositoryLogOptions;
+        };
+    }): Promise<TCount & {
+        data: TNullable<Array<R>>;
+    }>;
+    create(opts: {
+        data: PersistObject;
+        options: ExtraOptions & {
+            shouldReturn: false;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    create<R = DataObject>(opts: {
+        data: PersistObject;
+        options?: ExtraOptions & {
+            shouldReturn?: true;
+        };
+    }): Promise<TCount & {
+        data: R;
+    }>;
+    createAll(opts: {
+        data: Array<PersistObject>;
+        options: ExtraOptions & {
+            shouldReturn: false;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    createAll<R = DataObject>(opts: {
+        data: Array<PersistObject>;
+        options?: ExtraOptions & {
+            shouldReturn?: true;
+        };
+    }): Promise<TCount & {
+        data: Array<R>;
+    }>;
+    protected _update<R = DataObject>(opts: {
+        data: Partial<PersistObject>;
+        where: TWhere<DataObject>;
+        options?: ExtraOptions & {
+            shouldReturn?: boolean;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: TNullable<Array<R>>;
+    }>;
+    updateById(opts: {
+        id: IdType;
+        data: Partial<PersistObject>;
+        options: ExtraOptions & {
+            shouldReturn: false;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    updateById<R = DataObject>(opts: {
+        id: IdType;
+        data: Partial<PersistObject>;
+        options?: ExtraOptions & {
+            shouldReturn?: true;
+        };
+    }): Promise<TCount & {
+        data: R;
+    }>;
+    updateAll(opts: {
+        data: Partial<PersistObject>;
+        where: TWhere<DataObject>;
+        options: ExtraOptions & {
+            shouldReturn: false;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    updateAll<R = DataObject>(opts: {
+        data: Partial<PersistObject>;
+        where: TWhere<DataObject>;
+        options?: ExtraOptions & {
+            shouldReturn?: true;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: Array<R>;
+    }>;
+    protected _delete<R = DataObject>(opts: {
+        where: TWhere<DataObject>;
+        options?: ExtraOptions & {
+            shouldReturn?: boolean;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: TNullable<Array<R>>;
+    }>;
+    deleteById(opts: {
+        id: IdType;
+        options: ExtraOptions & {
+            shouldReturn: false;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    deleteById<R = DataObject>(opts: {
+        id: IdType;
+        options?: ExtraOptions & {
+            shouldReturn?: true;
+        };
+    }): Promise<TCount & {
+        data: R;
+    }>;
+    deleteAll(opts: {
+        where?: TWhere<DataObject>;
+        options: ExtraOptions & {
+            shouldReturn: false;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    deleteAll<R = DataObject>(opts: {
+        where?: TWhere<DataObject>;
+        options?: ExtraOptions & {
+            shouldReturn?: true;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: Array<R>;
+    }>;
+    deleteBy(opts: {
+        where: TWhere<DataObject>;
+        options: ExtraOptions & {
+            shouldReturn: false;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    deleteBy<R = DataObject>(opts: {
+        where: TWhere<DataObject>;
+        options?: ExtraOptions & {
+            shouldReturn?: true;
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: Array<R>;
+    }>;
+}
+//# sourceMappingURL=persistable.d.ts.map

package/dist/connectors/relational/repositories/core/persistable.d.ts.map

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

package/dist/connectors/relational/repositories/core/persistable.js

@@ -0,0 +1,185 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PersistableRelationalRepository = void 0;
+const common_1 = require("../../../../base/repositories/common");
+const ignis_helpers_1 = require("@venizia/ignis-helpers");
+const readable_1 = require("./readable");
+/** Full CRUD repository extending ReadableRelationalRepository with create, update, and delete. */
+class PersistableRelationalRepository extends readable_1.ReadableRelationalRepository {
+    constructor(ds, opts) {
+        super(ds, { entityClass: opts?.entityClass });
+        this._operationScope = common_1.RepositoryOperationScopes.READ_WRITE;
+    }
+    /** @deprecated Reach the engine's update transform through `dataSource.getQueryDialect()`. Engines without an update builder return `undefined`. `AnyType` rather than `unknown`: the concrete builder is engine-specific, and `unknown` breaks every `updateBuilder.transform(...)` call site. */
+    get updateBuilder() {
+        return this.queryDialect.updateBuilder;
+    }
+    /** Guards id-based operations against a null/undefined id */
+    validateId(opts) {
+        if (opts.id !== null && opts.id !== undefined) {
+            return;
+        }
+        throw (0, ignis_helpers_1.getError)({
+            message: `[${opts.operationName}] DENY to perform | entity: ${this.entity.name} | id is null or undefined`,
+        });
+    }
+    /** Prevents accidental table-wide updates/deletes by requiring an explicit force flag; returns the built where SQL so callers reuse it instead of rebuilding on identical input. */
+    validateWhereCondition(opts) {
+        const condition = this.queryDialect.toWhere({
+            tableName: this.entity.name,
+            schema: this.entity.schema,
+            where: opts.where ?? {},
+        });
+        const isEmptyWhere = condition === undefined;
+        if (!opts.force && isEmptyWhere) {
+            throw (0, ignis_helpers_1.getError)({
+                message: `[${opts.operationName}] Entity: ${this.entity.name} | DENY to perform ${opts.operationName.replace('_', '')} | Empty where condition`,
+            });
+        }
+        return { condition, isEmptyWhere };
+    }
+    async _create(opts) {
+        const { shouldReturn = true, log, transaction } = opts.options ?? {};
+        if (log?.use) {
+            this.logger.for('_create').log(log.level ?? 'info', 'Executing with opts: %j', opts);
+        }
+        const rs = await this.queryExecutor.insert({
+            connector: this.resolveConnector({ transaction }),
+            table: this.entity.schema,
+            values: opts.data,
+            returning: this.getVisibleProperties(),
+            shouldReturn,
+        });
+        if (!shouldReturn) {
+            this.logger
+                .for('_create')
+                .debug('INSERT result | shouldReturn: %s | rs: %j', shouldReturn, rs);
+            return { count: rs.count, data: null };
+        }
+        this.logger.for('_create').debug('INSERT result | shouldReturn: %s | rs: %j', shouldReturn, rs);
+        return { count: rs.count, data: rs.rows };
+    }
+    async create(opts) {
+        // ExtraOptions is caller-bound and otherwise unconstrained, so the spread cannot be proven to satisfy the generic bound, only the concrete shape below.
+        const options = { shouldReturn: true, ...opts.options };
+        const rs = await this._create({ data: [opts.data], options });
+        return { count: rs.count, data: rs.data?.[0] ?? null };
+    }
+    createAll(opts) {
+        // ExtraOptions is caller-bound and otherwise unconstrained, so the spread cannot be proven to satisfy the generic bound, only the concrete shape below.
+        const options = { shouldReturn: true, ...opts.options };
+        return this._create({ data: opts.data, options });
+    }
+    async _update(opts) {
+        const { shouldReturn = true, force = false, log, transaction, shouldSkipDefaultFilter, } = opts?.options ?? {};
+        if (log?.use) {
+            this.logger.for('_update').log(log.level ?? 'info', 'Executing with opts: %j', opts);
+        }
+        const mergedFilter = this.applyDefaultFilter({
+            userFilter: { where: opts.where },
+            shouldSkipDefaultFilter,
+        });
+        const mergedWhere = mergedFilter.where ?? opts.where;
+        const { condition: where, isEmptyWhere } = this.validateWhereCondition({
+            where: mergedWhere,
+            force,
+            operationName: '_update',
+        });
+        if (isEmptyWhere) {
+            this.logger
+                .for('_update')
+                .warn('Entity: %s | Performing update with empty condition | data: %j', this.entity.name, opts.data);
+        }
+        // JSON-path update composition is engine-specific (Postgres composes `jsonb_set`), so it goes through the dialect port rather than the executor.
+        const transformed = this.queryDialect.transformUpdate({
+            tableName: this.entity.name,
+            schema: this.entity.schema,
+            data: opts.data,
+        });
+        const updateData = this.queryDialect.toUpdateData({ transformed });
+        const rs = await this.queryExecutor.update({
+            connector: this.resolveConnector({ transaction }),
+            table: this.entity.schema,
+            data: updateData,
+            where,
+            returning: this.getVisibleProperties(),
+            shouldReturn,
+        });
+        if (!shouldReturn) {
+            this.logger
+                .for('_update')
+                .debug('UPDATE result | shouldReturn: %s | rs: %j', shouldReturn, rs);
+            return { count: rs.count, data: null };
+        }
+        this.logger.for('_update').debug('UPDATE result | shouldReturn: %s | rs: %j', shouldReturn, rs);
+        return { count: rs.count, data: rs.rows };
+    }
+    async updateById(opts) {
+        this.validateId({ id: opts.id, operationName: 'updateById' });
+        const rs = await this._update({
+            where: { id: opts.id },
+            data: opts.data,
+            options: opts.options,
+        });
+        return { count: rs.count, data: rs.data?.[0] ?? null };
+    }
+    updateAll(opts) {
+        return this._update(opts);
+    }
+    async _delete(opts) {
+        const { shouldReturn = true, force = false, log, transaction, shouldSkipDefaultFilter, } = opts?.options ?? {};
+        if (log?.use) {
+            this.logger.for('_delete').log(log.level ?? 'info', 'Executing with opts: %j', opts);
+        }
+        const mergedFilter = this.applyDefaultFilter({
+            userFilter: { where: opts.where },
+            shouldSkipDefaultFilter,
+        });
+        const mergedWhere = mergedFilter.where ?? opts.where;
+        const { condition: where, isEmptyWhere } = this.validateWhereCondition({
+            where: mergedWhere,
+            force,
+            operationName: '_delete',
+        });
+        if (isEmptyWhere) {
+            this.logger
+                .for('_delete')
+                .warn('Entity: %s | Performing delete with empty condition', this.entity.name);
+        }
+        const rs = await this.queryExecutor.remove({
+            connector: this.resolveConnector({ transaction }),
+            table: this.entity.schema,
+            where,
+            returning: this.getVisibleProperties(),
+            shouldReturn,
+        });
+        if (!shouldReturn) {
+            this.logger
+                .for('_delete')
+                .debug('DELETE result | shouldReturn: %s | rs: %j', shouldReturn, rs);
+            return { count: rs.count, data: null };
+        }
+        this.logger.for('_delete').debug('DELETE result | shouldReturn: %s | rs: %j', shouldReturn, rs);
+        return { count: rs.count, data: rs.rows };
+    }
+    async deleteById(opts) {
+        this.validateId({ id: opts.id, operationName: 'deleteById' });
+        const rs = await this._delete({
+            where: { id: opts.id },
+            options: opts.options,
+        });
+        return { count: rs.count, data: rs.data?.[0] ?? null };
+    }
+    deleteAll(opts) {
+        return this._delete({ where: opts.where ?? {}, options: opts.options });
+    }
+    deleteBy(opts) {
+        const { where, options } = opts;
+        if (options?.shouldReturn === false) {
+            return this.deleteAll({ where, options: { ...options, shouldReturn: false } });
+        }
+        return this.deleteAll({ where, options });
+    }
+}
+exports.PersistableRelationalRepository = PersistableRelationalRepository;
+//# sourceMappingURL=persistable.js.map