@venizia/ignis 0.0.7-9 → 0.0.7

package/dist/base/repositories/core/soft-deletable.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SoftDeletableRepository = void 0;
+const ignis_helpers_1 = require("@venizia/ignis-helpers");
+const default_crud_1 = require("./default-crud");
+/**
+ * Soft-deletable repository that overrides delete operations to set deletedAt timestamp
+ * instead of physically removing records from the database.
+ *
+ * Models using this repository should:
+ * - Have a `deletedAt` column (Date | null)
+ * - Set `defaultFilter: { where: { deletedAt: null } }` in @model settings
+ * - Include `deletedAt` in `hiddenProperties` if you don't want to expose it
+ *
+ * @example
+ * ```typescript
+ * @model({
+ *   settings: {
+ *     hiddenProperties: ['deletedAt'],
+ *     defaultFilter: { where: { deletedAt: null } },
+ *   },
+ * })
+ * export class Category extends BaseEntity<typeof Category.schema> {
+ *   static schema = pgTable('Category', {
+ *     ...withTimestamps(),
+ *     ...withSoftDelete(),
+ *   });
+ * }
+ *
+ * @repository({ dataSource: PostgresDataSource, model: Category })
+ * export class CategoryRepository extends SoftDeletableRepository<typeof Category.schema> {}
+ * ```
+ */
+class SoftDeletableRepository extends default_crud_1.DefaultCRUDRepository {
+    async findById(opts) {
+        const result = await super.findById(opts);
+        if (opts.options?.isStrict && !result) {
+            throw (0, ignis_helpers_1.getError)({
+                message: `[${this.constructor.name}][findById] Entity with id ${opts.id} not found`,
+                statusCode: ignis_helpers_1.HTTP.ResultCodes.RS_4.NotFound,
+            });
+        }
+        return result;
+    }
+    async deleteById(opts) {
+        if (opts.options?.shouldHardDelete) {
+            return super.deleteById(opts);
+        }
+        return this.updateById({
+            id: opts.id,
+            data: { deletedAt: new Date() },
+            options: opts.options,
+        });
+    }
+    deleteAll(opts) {
+        if (opts.options?.shouldHardDelete) {
+            return super.deleteAll(opts);
+        }
+        return this.updateAll({
+            where: opts.where ?? {},
+            data: { deletedAt: new Date() },
+            options: opts.options,
+        });
+    }
+    deleteBy(opts) {
+        if (opts.options?.shouldHardDelete) {
+            return super.deleteBy(opts);
+        }
+        return this.updateAll({
+            where: opts.where,
+            data: { deletedAt: new Date() },
+            options: opts.options,
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Restore Operations
+    // ---------------------------------------------------------------------------
+    async restoreById(opts) {
+        const { shouldReturn = true, ...restOptions } = opts.options ?? {};
+        return this.updateById({
+            id: opts.id,
+            data: { deletedAt: null },
+            options: { ...restOptions, shouldReturn, shouldSkipDefaultFilter: true },
+        });
+    }
+    async restoreAll(opts) {
+        const { shouldReturn = true, force, ...restOptions } = opts.options ?? {};
+        return this.updateAll({
+            where: opts.where ?? {},
+            data: { deletedAt: null },
+            options: { ...restOptions, shouldReturn, force, shouldSkipDefaultFilter: true },
+        });
+    }
+    async restoreBy(opts) {
+        return this.restoreAll(opts);
+    }
+}
+exports.SoftDeletableRepository = SoftDeletableRepository;
+//# sourceMappingURL=soft-deletable.js.map

package/dist/base/repositories/core/soft-deletable.js.map

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

package/dist/base/repositories/mixins/default-filter.d.ts

@@ -2,61 +2,15 @@ import { BaseEntity, TTableSchemaWithId } from '../../../base/models';
 import { TMixinTarget } from '@venizia/ignis-helpers';
 import { TFilter } from '../common';
 import { FilterBuilder } from '../operators';
-/**
- * Mixin that adds default filter support to repositories.
- *
- * This mixin provides functionality to:
- * - Retrieve default filters defined in model metadata
- * - Automatically apply default filters to user queries
- * - Allow bypassing default filters when needed
- *
- * Common use cases include soft delete filters (e.g., `{ where: { isDeleted: false } }`)
- * that are automatically applied to all queries.
- *
- * @template T - The base class type to extend
- * @param baseClass - The base class to mix into
- * @returns The mixed class with default filter support
- *
- * @example
- * ```typescript
- * // In model metadata
- * @model({ settings: { defaultFilter: { where: { isDeleted: false } } } })
- * export class User extends BaseEntity<typeof UserSchema> { ... }
- *
- * // Default filter is automatically applied
- * const activeUsers = await userRepo.find({ filter: {} });
- * // SQL: SELECT * FROM users WHERE is_deleted = false
- *
- * // Bypass default filter when needed
- * const allUsers = await userRepo.find({
- *   filter: {},
- *   options: { shouldSkipDefaultFilter: true }
- * });
- * ```
- */
+/** Mixin that auto-applies default filters from model metadata (e.g., soft delete). */
 export declare const DefaultFilterMixin: <T extends TMixinTarget<object>>(baseClass: T) => (abstract new (...args: any[]) => {
-    /** Cached default filter. Null until first access, undefined if no default filter. */
     _defaultFilter: TFilter | null | undefined;
-    /**
-     * Abstract methods - must be implemented by the class using this mixin.
-     */
     getEntity(): BaseEntity<TTableSchemaWithId>;
     get filterBuilder(): FilterBuilder;
-    /**
-     * Gets default filter from model metadata.
-     * Cached for performance - computed once per repository instance.
-     *
-     * @returns The default filter or undefined if not configured
-     */
+    /** Gets default filter from model metadata. Cached after first access. */
     getDefaultFilter(): TFilter | undefined;
-    /**
-     * Check if this entity has default filter configured.
-     */
     hasDefaultFilter(): boolean;
-    /**
-     * Apply default filter to user-provided filter.
-     * Returns merged filter or user filter if shouldSkipDefaultFilter is true.
-     */
+    /** Merges default filter with user filter. Skippable via shouldSkipDefaultFilter. */
     applyDefaultFilter<DataObject = any>(opts: {
         userFilter?: TFilter<DataObject>;
         shouldSkipDefaultFilter?: boolean;

package/dist/base/repositories/mixins/default-filter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"default-filter.d.ts","sourceRoot":"","sources":["../../../../src/base/repositories/mixins/default-filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAE/D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAM7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,SAAS,YAAY,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAE3E,sFAAsF;oBACtE,OAAO,GAAG,IAAI,GAAG,SAAS;IAE1C;;OAEG;iBACmB,UAAU,CAAC,kBAAkB,CAAC;yBACtB,aAAa;IAM3C;;;;;OAKG;;IAeH;;OAEG;wBACiB,OAAO;IAK3B;;;OAGG;uBACgB,UAAU,cAAc;QACzC,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QACjC,uBAAuB,CAAC,EAAE,OAAO,CAAC;KACnC,GAAG,OAAO,CAAC,UAAU,CAAC;MAsB1B,CAAC"}
+{"version":3,"file":"default-filter.d.ts","sourceRoot":"","sources":["../../../../src/base/repositories/mixins/default-filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAE/D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,uFAAuF;AACvF,eAAO,MAAM,kBAAkB,GAAI,CAAC,SAAS,YAAY,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;oBAE3D,OAAO,GAAG,IAAI,GAAG,SAAS;iBAEpB,UAAU,CAAC,kBAAkB,CAAC;yBACtB,aAAa;IAE3C,0EAA0E;;wBActD,OAAO;IAK3B,qFAAqF;uBAClE,UAAU,cAAc;QACzC,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QACjC,uBAAuB,CAAC,EAAE,OAAO,CAAC;KACnC,GAAG,OAAO,CAAC,UAAU,CAAC;MAiB1B,CAAC"}

package/dist/base/repositories/mixins/default-filter.js

@@ -2,59 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DefaultFilterMixin = void 0;
 const inversion_1 = require("../../../helpers/inversion");
-// -----------------------------------------------------------------------------
-// Default Filter Mixin
-// -----------------------------------------------------------------------------
-/**
- * Mixin that adds default filter support to repositories.
- *
- * This mixin provides functionality to:
- * - Retrieve default filters defined in model metadata
- * - Automatically apply default filters to user queries
- * - Allow bypassing default filters when needed
- *
- * Common use cases include soft delete filters (e.g., `{ where: { isDeleted: false } }`)
- * that are automatically applied to all queries.
- *
- * @template T - The base class type to extend
- * @param baseClass - The base class to mix into
- * @returns The mixed class with default filter support
- *
- * @example
- * ```typescript
- * // In model metadata
- * @model({ settings: { defaultFilter: { where: { isDeleted: false } } } })
- * export class User extends BaseEntity<typeof UserSchema> { ... }
- *
- * // Default filter is automatically applied
- * const activeUsers = await userRepo.find({ filter: {} });
- * // SQL: SELECT * FROM users WHERE is_deleted = false
- *
- * // Bypass default filter when needed
- * const allUsers = await userRepo.find({
- *   filter: {},
- *   options: { shouldSkipDefaultFilter: true }
- * });
- * ```
- */
+/** Mixin that auto-applies default filters from model metadata (e.g., soft delete). */
 const DefaultFilterMixin = (baseClass) => {
     class Mixed extends baseClass {
         constructor() {
             super(...arguments);
-            /** Cached default filter. Null until first access, undefined if no default filter. */
             this._defaultFilter = null;
         }
-        // ---------------------------------------------------------------------------
-        // Default Filter
-        // ---------------------------------------------------------------------------
-        /**
-         * Gets default filter from model metadata.
-         * Cached for performance - computed once per repository instance.
-         *
-         * @returns The default filter or undefined if not configured
-         */
+        /** Gets default filter from model metadata. Cached after first access. */
         getDefaultFilter() {
-            // null = not computed yet, undefined = computed as "no default filter"
             if (this._defaultFilter !== null) {
                 return this._defaultFilter;
             }
@@ -64,30 +20,20 @@ const DefaultFilterMixin = (baseClass) => {
             this._defaultFilter = defaultFilter;
             return this._defaultFilter;
         }
-        /**
-         * Check if this entity has default filter configured.
-         */
         hasDefaultFilter() {
             const defaultFilter = this.getDefaultFilter();
             return defaultFilter !== undefined && Object.keys(defaultFilter).length > 0;
         }
-        /**
-         * Apply default filter to user-provided filter.
-         * Returns merged filter or user filter if shouldSkipDefaultFilter is true.
-         */
+        /** Merges default filter with user filter. Skippable via shouldSkipDefaultFilter. */
         applyDefaultFilter(opts) {
             const { userFilter, shouldSkipDefaultFilter } = opts;
-            // Skip default filter if explicitly requested
             if (shouldSkipDefaultFilter) {
                 return userFilter ?? {};
             }
-            // Get default filter from model metadata
             const defaultFilter = this.getDefaultFilter();
-            // No default filter configured - return user filter
             if (!defaultFilter) {
                 return userFilter ?? {};
             }
-            // Merge default filter with user filter
             return this.filterBuilder.mergeFilter({ defaultFilter, userFilter });
         }
     }

package/dist/base/repositories/mixins/default-filter.js.map

@@ -1 +1 @@
-{"version":3,"file":"default-filter.js","sourceRoot":"","sources":["../../../../src/base/repositories/mixins/default-filter.ts"],"names":[],"mappings":";;;AACA,mDAAuD;AAKvD,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACI,MAAM,kBAAkB,GAAG,CAAiC,SAAY,EAAE,EAAE;IACjF,MAAe,KAAM,SAAQ,SAAS;QAAtC;;YACE,sFAAsF;YACtF,mBAAc,GAA+B,IAAI,CAAC;QAkEpD,CAAC;QA1DC,8EAA8E;QAC9E,iBAAiB;QACjB,8EAA8E;QAE9E;;;;;WAKG;QACH,gBAAgB;YACd,uEAAuE;YACvE,IAAI,IAAI,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;gBACjC,OAAO,IAAI,CAAC,cAAc,CAAC;YAC7B,CAAC;YAED,MAAM,QAAQ,GAAG,4BAAgB,CAAC,WAAW,EAAE,CAAC;YAChD,MAAM,UAAU,GAAG,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3E,MAAM,aAAa,GAAG,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC;YAEpE,IAAI,CAAC,cAAc,GAAG,aAAa,CAAC;YACpC,OAAO,IAAI,CAAC,cAAc,CAAC;QAC7B,CAAC;QAED;;WAEG;QACH,gBAAgB;YACd,MAAM,aAAa,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC9C,OAAO,aAAa,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9E,CAAC;QAED;;;WAGG;QACH,kBAAkB,CAAmB,IAGpC;YACC,MAAM,EAAE,UAAU,EAAE,uBAAuB,EAAE,GAAG,IAAI,CAAC;YAErD,8CAA8C;YAC9C,IAAI,uBAAuB,EAAE,CAAC;gBAC5B,OAAO,UAAU,IAAI,EAAE,CAAC;YAC1B,CAAC;YAED,yCAAyC;YACzC,MAAM,aAAa,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAE9C,oDAAoD;YACpD,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,OAAO,UAAU,IAAI,EAAE,CAAC;YAC1B,CAAC;YAED,wCAAwC;YACxC,OAAO,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,CAAC;QACvE,CAAC;KACF;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAxEW,QAAA,kBAAkB,sBAwE7B"}
+{"version":3,"file":"default-filter.js","sourceRoot":"","sources":["../../../../src/base/repositories/mixins/default-filter.ts"],"names":[],"mappings":";;;AACA,mDAAuD;AAKvD,uFAAuF;AAChF,MAAM,kBAAkB,GAAG,CAAiC,SAAY,EAAE,EAAE;IACjF,MAAe,KAAM,SAAQ,SAAS;QAAtC;;YACE,mBAAc,GAA+B,IAAI,CAAC;QA0CpD,CAAC;QArCC,0EAA0E;QAC1E,gBAAgB;YACd,IAAI,IAAI,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;gBACjC,OAAO,IAAI,CAAC,cAAc,CAAC;YAC7B,CAAC;YAED,MAAM,QAAQ,GAAG,4BAAgB,CAAC,WAAW,EAAE,CAAC;YAChD,MAAM,UAAU,GAAG,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3E,MAAM,aAAa,GAAG,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC;YAEpE,IAAI,CAAC,cAAc,GAAG,aAAa,CAAC;YACpC,OAAO,IAAI,CAAC,cAAc,CAAC;QAC7B,CAAC;QAED,gBAAgB;YACd,MAAM,aAAa,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC9C,OAAO,aAAa,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9E,CAAC;QAED,qFAAqF;QACrF,kBAAkB,CAAmB,IAGpC;YACC,MAAM,EAAE,UAAU,EAAE,uBAAuB,EAAE,GAAG,IAAI,CAAC;YAErD,IAAI,uBAAuB,EAAE,CAAC;gBAC5B,OAAO,UAAU,IAAI,EAAE,CAAC;YAC1B,CAAC;YAED,MAAM,aAAa,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC9C,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,OAAO,UAAU,IAAI,EAAE,CAAC;YAC1B,CAAC;YAED,OAAO,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,CAAC;QACvE,CAAC;KACF;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AA/CW,QAAA,kBAAkB,sBA+C7B"}

package/dist/base/repositories/mixins/fields-visibility.d.ts

@@ -1,74 +1,18 @@
 import { BaseEntity, TTableSchemaWithId } from '../../../base/models';
 import { TMixinTarget } from '@venizia/ignis-helpers';
-/**
- * Mixin that adds hidden/visible property management to repositories.
- *
- * This mixin provides functionality to:
- * - Track hidden properties defined in model metadata
- * - Generate visible properties for Drizzle select/returning operations
- * - Cache computed properties for performance
- *
- * Hidden properties are automatically excluded from query results at the SQL level,
- * preventing sensitive data (like passwords) from being returned.
- *
- * @template T - The base class type to extend
- * @param baseClass - The base class to mix into
- * @returns The mixed class with fields visibility support
- *
- * @example
- * ```typescript
- * // In model metadata
- * @model({ settings: { hiddenProperties: ['password', 'secretToken'] } })
- * export class User extends BaseEntity<typeof UserSchema> { ... }
- *
- * // In repository, hidden fields are automatically excluded
- * const users = await userRepo.find({ filter: {} });
- * // users won't include 'password' or 'secretToken' fields
- * ```
- */
+/** Mixin that excludes hidden properties from query results at SQL level. */
 export declare const FieldsVisibilityMixin: <T extends TMixinTarget<object>>(baseClass: T) => (abstract new (...args: any[]) => {
-    /** Cached set of hidden property names. Null until first access. */
     _hiddenProperties: Set<string> | null;
-    /** Cached visible properties object. Null until first access, undefined if no hidden props. */
     _visibleProperties: Record<string, any> | null | undefined;
-    /**
-     * Abstract method - must be implemented by the class using this mixin.
-     * @returns The entity instance for this repository
-     */
     getEntity(): BaseEntity<TTableSchemaWithId>;
-    /**
-     * Gets the set of hidden property names.
-     * Auto-resolves from model metadata on first access.
-     */
     get hiddenProperties(): Set<string>;
-    /** Sets the hidden properties set. */
     set hiddenProperties(value: Set<string>);
-    /**
-     * Gets hidden properties from model metadata.
-     * Cached for performance - computed once per repository instance.
-     *
-     * @returns Set of hidden property names
-     */
+    /** Gets hidden properties from model metadata. Cached after first access. */
     getHiddenProperties(): Set<string>;
-    /**
-     * Checks if this entity has hidden properties configured.
-     *
-     * @returns True if there are hidden properties
-     */
     hasHiddenProperties(): boolean;
-    /**
-     * Gets visible properties object.
-     * Auto-resolves from schema excluding hidden properties.
-     */
     get visibleProperties(): Record<string, any> | undefined;
     set visibleProperties(value: Record<string, any> | undefined);
-    /**
-     * Get visible properties object for Drizzle select/returning.
-     * Excludes hidden properties. Cached for performance.
-     *
-     * @returns Column object for Drizzle (e.g., { id: schema.id, email: schema.email })
-     *          or undefined if no hidden properties (use default select all behavior)
-     */
+    /** Gets visible properties for Drizzle select/returning. Undefined if no hidden props. Cached. */
     getVisibleProperties(): Record<string, any> | undefined;
 }) & T;
 //# sourceMappingURL=fields-visibility.d.ts.map

package/dist/base/repositories/mixins/fields-visibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fields-visibility.d.ts","sourceRoot":"","sources":["../../../../src/base/repositories/mixins/fields-visibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAE/D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAOtD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,YAAY,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAE9E,oEAAoE;uBACjD,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI;IAErC,+FAA+F;wBAC3E,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS;IAE1D;;;OAGG;iBACmB,UAAU,CAAC,kBAAkB,CAAC;IAMpD;;;OAGG;4BACqB,GAAG,CAAC,MAAM,CAAC;IAInC,sCAAsC;gCACV,GAAG,CAAC,MAAM,CAAC;IAIvC;;;;;OAKG;2BACoB,GAAG,CAAC,MAAM,CAAC;IAalC;;;;OAIG;2BACoB,OAAO;IAQ9B;;;OAGG;6BACsB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS;iCAI3B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS;IAI5D;;;;;;OAMG;4BACqB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS;MA+B1D,CAAC"}
+{"version":3,"file":"fields-visibility.d.ts","sourceRoot":"","sources":["../../../../src/base/repositories/mixins/fields-visibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAE/D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGtD,6EAA6E;AAC7E,eAAO,MAAM,qBAAqB,GAAI,CAAC,SAAS,YAAY,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;uBAE3D,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI;wBACjB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS;iBAEpC,UAAU,CAAC,kBAAkB,CAAC;4BAE5B,GAAG,CAAC,MAAM,CAAC;gCAIP,GAAG,CAAC,MAAM,CAAC;IAIvC,6EAA6E;2BACtD,GAAG,CAAC,MAAM,CAAC;2BAaX,OAAO;6BAGL,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS;iCAI3B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS;IAI5D,kGAAkG;4BAC1E,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS;MA4B1D,CAAC"}

package/dist/base/repositories/mixins/fields-visibility.js

@@ -3,64 +3,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FieldsVisibilityMixin = void 0;
 const inversion_1 = require("../../../helpers/inversion");
 const drizzle_orm_1 = require("drizzle-orm");
-// -----------------------------------------------------------------------------
-// Fields Visibility Mixin
-// -----------------------------------------------------------------------------
-/**
- * Mixin that adds hidden/visible property management to repositories.
- *
- * This mixin provides functionality to:
- * - Track hidden properties defined in model metadata
- * - Generate visible properties for Drizzle select/returning operations
- * - Cache computed properties for performance
- *
- * Hidden properties are automatically excluded from query results at the SQL level,
- * preventing sensitive data (like passwords) from being returned.
- *
- * @template T - The base class type to extend
- * @param baseClass - The base class to mix into
- * @returns The mixed class with fields visibility support
- *
- * @example
- * ```typescript
- * // In model metadata
- * @model({ settings: { hiddenProperties: ['password', 'secretToken'] } })
- * export class User extends BaseEntity<typeof UserSchema> { ... }
- *
- * // In repository, hidden fields are automatically excluded
- * const users = await userRepo.find({ filter: {} });
- * // users won't include 'password' or 'secretToken' fields
- * ```
- */
+/** Mixin that excludes hidden properties from query results at SQL level. */
 const FieldsVisibilityMixin = (baseClass) => {
     class Mixed extends baseClass {
         constructor() {
             super(...arguments);
-            /** Cached set of hidden property names. Null until first access. */
             this._hiddenProperties = null;
-            /** Cached visible properties object. Null until first access, undefined if no hidden props. */
             this._visibleProperties = null;
         }
-        // ---------------------------------------------------------------------------
-        // Hidden Properties
-        // ---------------------------------------------------------------------------
-        /**
-         * Gets the set of hidden property names.
-         * Auto-resolves from model metadata on first access.
-         */
         get hiddenProperties() {
             return this.getHiddenProperties();
         }
-        /** Sets the hidden properties set. */
         set hiddenProperties(value) {
             this._hiddenProperties = value;
         }
-        /**
-         * Gets hidden properties from model metadata.
-         * Cached for performance - computed once per repository instance.
-         *
-         * @returns Set of hidden property names
-         */
+        /** Gets hidden properties from model metadata. Cached after first access. */
         getHiddenProperties() {
             if (this._hiddenProperties !== null) {
                 return this._hiddenProperties;
@@ -71,46 +28,25 @@ const FieldsVisibilityMixin = (baseClass) => {
             this._hiddenProperties = new Set(hiddenProps);
             return this._hiddenProperties;
         }
-        /**
-         * Checks if this entity has hidden properties configured.
-         *
-         * @returns True if there are hidden properties
-         */
         hasHiddenProperties() {
             return this.getHiddenProperties().size > 0;
         }
-        // ---------------------------------------------------------------------------
-        // Visible Properties
-        // ---------------------------------------------------------------------------
-        /**
-         * Gets visible properties object.
-         * Auto-resolves from schema excluding hidden properties.
-         */
         get visibleProperties() {
             return this.getVisibleProperties();
         }
         set visibleProperties(value) {
             this._visibleProperties = value;
         }
-        /**
-         * Get visible properties object for Drizzle select/returning.
-         * Excludes hidden properties. Cached for performance.
-         *
-         * @returns Column object for Drizzle (e.g., { id: schema.id, email: schema.email })
-         *          or undefined if no hidden properties (use default select all behavior)
-         */
+        /** Gets visible properties for Drizzle select/returning. Undefined if no hidden props. Cached. */
         getVisibleProperties() {
-            // null = not computed yet, undefined = computed as "no hidden properties"
             if (this._visibleProperties !== null) {
                 return this._visibleProperties;
             }
             const hiddenProps = this.getHiddenProperties();
-            // If no hidden properties, cache and return undefined (signal to use default behavior)
             if (hiddenProps.size === 0) {
                 this._visibleProperties = undefined;
                 return undefined;
             }
-            // Build columns object excluding hidden properties
             const schema = this.getEntity().schema;
             const columns = (0, drizzle_orm_1.getTableColumns)(schema);
             const visibleProperties = {};

package/dist/base/repositories/mixins/fields-visibility.js.map

@@ -1 +1 @@
-{"version":3,"file":"fields-visibility.js","sourceRoot":"","sources":["../../../../src/base/repositories/mixins/fields-visibility.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fields-visibility.js","sourceRoot":"","sources":["../../../../src/base/repositories/mixins/fields-visibility.ts"],"names":[],"mappings":";;;AACA,mDAAuD;AAEvD,6CAA8C;AAE9C,6EAA6E;AACtE,MAAM,qBAAqB,GAAG,CAAiC,SAAY,EAAE,EAAE;IACpF,MAAe,KAAM,SAAQ,SAAS;QAAtC;;YACE,sBAAiB,GAAuB,IAAI,CAAC;YAC7C,uBAAkB,GAA2C,IAAI,CAAC;QA+DpE,CAAC;QA3DC,IAAI,gBAAgB;YAClB,OAAO,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACpC,CAAC;QAED,IAAI,gBAAgB,CAAC,KAAkB;YACrC,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC;QACjC,CAAC;QAED,6EAA6E;QAC7E,mBAAmB;YACjB,IAAI,IAAI,CAAC,iBAAiB,KAAK,IAAI,EAAE,CAAC;gBACpC,OAAO,IAAI,CAAC,iBAAiB,CAAC;YAChC,CAAC;YAED,MAAM,QAAQ,GAAG,4BAAgB,CAAC,WAAW,EAAE,CAAC;YAChD,MAAM,UAAU,GAAG,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3E,MAAM,WAAW,GAAG,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,IAAI,EAAE,CAAC;YAE3E,IAAI,CAAC,iBAAiB,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;YAC9C,OAAO,IAAI,CAAC,iBAAiB,CAAC;QAChC,CAAC;QAED,mBAAmB;YACjB,OAAO,IAAI,CAAC,mBAAmB,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,iBAAiB;YACnB,OAAO,IAAI,CAAC,oBAAoB,EAAE,CAAC;QACrC,CAAC;QAED,IAAI,iBAAiB,CAAC,KAAsC;YAC1D,IAAI,CAAC,kBAAkB,GAAG,KAAK,CAAC;QAClC,CAAC;QAED,kGAAkG;QAClG,oBAAoB;YAClB,IAAI,IAAI,CAAC,kBAAkB,KAAK,IAAI,EAAE,CAAC;gBACrC,OAAO,IAAI,CAAC,kBAAkB,CAAC;YACjC,CAAC;YAED,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAE/C,IAAI,WAAW,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;gBACpC,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC;YACvC,MAAM,OAAO,GAAG,IAAA,6BAAe,EAAC,MAAM,CAAC,CAAC;YACxC,MAAM,iBAAiB,GAAwB,EAAE,CAAC;YAElD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;gBAC1B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC1B,iBAAiB,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;gBACxC,CAAC;YACH,CAAC;YAED,IAAI,CAAC,kBAAkB,GAAG,iBAAiB,CAAC;YAC5C,OAAO,IAAI,CAAC,kBAAkB,CAAC;QACjC,CAAC;KACF;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AArEW,QAAA,qBAAqB,yBAqEhC"}

package/dist/base/repositories/operators/filter.d.ts

@@ -2,154 +2,49 @@ import { TTableObject, TTableSchemaWithId } from '../../../base/models';
 import { BaseHelper } from '@venizia/ignis-helpers';
 import { type SQL } from 'drizzle-orm';
 import { TDrizzleQueryOptions, TFields, TFilter, TInclusion, TRelationConfig, TWhere } from '../common';
-/**
- * Converts filter objects into Drizzle ORM query options.
- *
- * The FilterBuilder handles:
- * - Where clause conversion with support for operators and JSON paths
- * - Field selection (columns)
- * - Ordering/sorting with JSON path support
- * - Relation inclusion with nested filtering
- * - Hidden property exclusion
- * - Default filter merging
- *
- * @example
- * ```typescript
- * const builder = new FilterBuilder();
- *
- * // Build query options from filter
- * const options = builder.build({
- *   tableName: 'users',
- *   schema: UserSchema,
- *   filter: {
- *     where: { status: 'active', age: { gte: 18 } },
- *     order: ['createdAt DESC'],
- *     limit: 10
- *   }
- * });
- * ```
- */
+/** Converts filter objects into Drizzle ORM query options (where, order, columns, relations). */
 export declare class FilterBuilder extends BaseHelper {
-    /** Creates a new FilterBuilder instance. */
     constructor();
-    /**
-     * Merges a default filter with a user-provided filter.
-     *
-     * **Merge Strategy:**
-     * - `where`: Deep merge (user values override matching keys)
-     * - All other fields: User completely replaces default (if provided)
-     *
-     * @template T - The entity type
-     * @param opts - Merge options
-     * @param opts.defaultFilter - The default filter to apply
-     * @param opts.userFilter - The user-provided filter
-     * @returns The merged filter
-     *
-     * @example
-     * ```typescript
-     * const merged = builder.mergeFilter({
-     *   defaultFilter: { where: { isDeleted: false }, limit: 100 },
-     *   userFilter: { where: { status: 'active' }, limit: 10 }
-     * });
-     * // Result: { where: { isDeleted: false, status: 'active' }, limit: 10 }
-     * ```
-     */
+    /** Merges default filter with user filter. Where is deep-merged; other fields user-wins. */
     mergeFilter<T = any>(opts: {
         defaultFilter?: TFilter<T>;
         userFilter?: TFilter<T>;
     }): TFilter<T>;
-    /**
-     * Resolves hidden properties for a schema from MetadataRegistry.
-     *
-     * @param opts - Options containing the schema
-     * @returns Set of property names that should be hidden
-     */
+    /** Resolves hidden properties for a schema from MetadataRegistry. */
     resolveHiddenProperties(opts: {
         schema: TTableSchemaWithId;
     }): Set<string>;
-    /**
-     * Resolves default filter for a schema from MetadataRegistry.
-     *
-     * @param opts - Options containing the schema
-     * @returns The default filter or undefined if not configured
-     */
+    /** Resolves default filter for a schema from MetadataRegistry. */
     resolveDefaultFilter(opts: {
         schema: TTableSchemaWithId;
     }): TFilter | undefined;
-    /**
-     * Resolves relation configurations for a schema from MetadataRegistry.
-     *
-     * @param opts - Options containing the schema
-     * @returns Record mapping relation names to their configurations
-     */
+    /** Resolves relation configurations for a schema from MetadataRegistry. */
     resolveRelations(opts: {
         schema: TTableSchemaWithId;
     }): Record<string, TRelationConfig>;
-    /**
-     * Builds Drizzle query options from a filter object.
-     *
-     * @template Schema - The table schema type
-     * @param opts - Build options
-     * @param opts.tableName - Name of the table for error messages
-     * @param opts.schema - The Drizzle table schema
-     * @param opts.filter - The filter to convert
-     * @returns Drizzle-compatible query options
-     */
+    /** Builds Drizzle query options from a filter object. */
     build<Schema extends TTableSchemaWithId>(opts: {
         tableName: string;
         schema: Schema;
         filter: TFilter<TTableObject<Schema>>;
     }): TDrizzleQueryOptions;
-    /**
-     * Converts fields selection to Drizzle columns format.
-     *
-     * @param opts - Options containing fields selection
-     * @returns Record of column names to boolean (true = include)
-     */
+    /** Converts fields selection to Drizzle columns format. */
     toColumns(opts: {
         fields: TFields;
     }): Record<string, boolean>;
-    /**
-     * Converts a where clause to a Drizzle SQL condition.
-     * Supports regular columns, JSON paths, operators, and logical groups (AND/OR).
-     *
-     * @template Schema - The table schema type
-     * @param opts - Conversion options
-     * @param opts.tableName - Name of the table for error messages
-     * @param opts.schema - The Drizzle table schema
-     * @param opts.where - The where clause to convert
-     * @returns SQL condition or undefined if no conditions
-     */
+    /** Converts a where clause to a Drizzle SQL condition (supports operators, JSON paths, AND/OR). */
     toWhere<Schema extends TTableSchemaWithId>(opts: {
         tableName: string;
         schema: Schema;
         where: TWhere<TTableObject<Schema>>;
     }): SQL | undefined;
-    /**
-     * Converts an order clause to Drizzle SQL order expressions.
-     * Supports regular columns and JSON paths.
-     *
-     * @template Schema - The table schema type
-     * @param opts - Conversion options
-     * @param opts.tableName - Name of the table for error messages
-     * @param opts.schema - The Drizzle table schema
-     * @param opts.order - Array of order strings (e.g., ['createdAt DESC', 'name ASC'])
-     * @returns Array of SQL order expressions
-     */
+    /** Converts order strings to Drizzle SQL order expressions (supports JSON paths). */
     toOrderBy<Schema extends TTableSchemaWithId>(opts: {
         tableName: string;
         schema: Schema;
         order: string[];
     }): SQL[];
-    /**
-     * Converts an include clause to Drizzle 'with' options for relation loading.
-     * Handles nested filtering, default filter application, and hidden property exclusion.
-     *
-     * @param opts - Conversion options
-     * @param opts.include - Array of inclusion configurations
-     * @param opts.relations - Map of relation names to their configurations
-     * @returns Record mapping relation names to query options or true
-     */
+    /** Converts include clause to Drizzle 'with' options with nested filtering and hidden prop exclusion. */
     toInclude(opts: {
         include: TInclusion[];
         relations: {