@venizia/ignis-docs 0.2.0 → 0.2.1-1

package/content/references/base/repositories/mixins.md

@@ -7,8 +7,15 @@ lastUpdated: 2026-07-06
 
 # Repository Mixins <Badge type="danger" text="removed" />
 
+`FieldsVisibilityMixin` and `DefaultFilterMixin` were removed from IGNIS - this page is a tombstone documenting where their behavior lives now. For the current repository hierarchy, start with the [Repositories overview](/references/base/repositories/).
+
+**Files:**
+
+- [`packages/core-server/src/base/repositories/core/abstract.ts`](https://github.com/VENIZIA-AI/ignis/blob/main/packages/core-server/src/base/repositories/core/abstract.ts) - `AbstractRepository` - `hiddenFields`/`defaultWhere`/`defaultLimit` getters
+- [`packages/core-server/src/connectors/postgres/repositories/core/base.ts`](https://github.com/VENIZIA-AI/ignis/blob/main/packages/core-server/src/connectors/postgres/repositories/core/base.ts) - `RelationalBaseRepository` (alias `PostgresBaseRepository`) - `getHiddenProperties`, `getVisibleProperties`, `getDefaultFilter`, `applyDefaultFilter`
+
 > [!WARNING] Removed
-> `FieldsVisibilityMixin` and `DefaultFilterMixin` have been **removed** from IGNIS. They are no longer exported and must not be imported or composed in new code. This page remains as a tombstone documenting where the equivalent behavior now lives.
+> `FieldsVisibilityMixin` and `DefaultFilterMixin` are no longer exported and must not be imported or composed in new code.
 
 ## What They Were
 
@@ -21,12 +28,10 @@ Before the connectors restructure, `AbstractRepository` composed two mixins onto
 
 ## Where the Behavior Lives Now
 
-The functionality was not dropped - it was folded directly into the repository hierarchy.
+IGNIS didn't drop the functionality - it folded it directly into the repository hierarchy.
 
 ### Engine-neutral: `AbstractRepository`
 
-**File:** `packages/core/src/base/repositories/core/abstract.ts`
-
 `AbstractRepository` resolves `@model` settings by class (Reflect target) via `MetadataRegistry` and exposes them as protected getters, memoized after first access:
 
 ```typescript
@@ -36,9 +41,7 @@ protected get defaultWhere(): TWhere | undefined;           // settings.defaultF
 protected get defaultLimit(): number | undefined;           // settings.defaultLimit
 ```
 
-### PostgreSQL: `PostgresBaseRepository`
-
-**File:** `packages/core/src/connectors/postgres/repositories/core/base.ts`
+### PostgreSQL: `RelationalBaseRepository`
 
 Builds on those getters to implement SQL-level column exclusion and full-filter merging for Drizzle:
 
@@ -47,29 +50,29 @@ getHiddenProperties(): Set<string>;                       // memoized Set of hid
 hasHiddenProperties(): boolean;
 getVisibleProperties(): Record<string, any> | undefined;  // memoized Drizzle column-selection map
 
-getDefaultFilter(): TFilter | undefined;                  // full settings.defaultFilter (where/order/limit/...)
+getDefaultFilter(): TFilter | undefined;                  // settings.defaultFilter
 getDefaultLimit(): number | undefined;
 hasDefaultFilter(): boolean;
 applyDefaultFilter(opts: {
   userFilter?: TFilter;
   shouldSkipDefaultFilter?: boolean;
-}): TFilter;                                              // merges via FilterBuilder.mergeFilter
+}): TFilter;                                              // merges via queryDialect.mergeFilter
 ```
 
-Hidden columns are excluded from `select()` and `returning()` calls at query time - the same SQL-level guarantee the mixins provided. The typesense connector implements its own equivalent natively since it is not Drizzle-aware.
+The query builder excludes hidden columns from `select()` and `returning()` calls at query time - the same SQL-level guarantee the mixins provided. The typesense connector implements its own equivalent natively, since it is not Drizzle-aware.
 
 ## Migration
 
 | Old (mixin) | New |
 |-------------|-----|
-| `FieldsVisibilityMixin` -> `getHiddenProperties()` | `PostgresBaseRepository.getHiddenProperties()` |
-| `FieldsVisibilityMixin` -> `getVisibleProperties()` | `PostgresBaseRepository.getVisibleProperties()` |
-| `FieldsVisibilityMixin` -> `hasHiddenProperties()` | `PostgresBaseRepository.hasHiddenProperties()` |
-| `DefaultFilterMixin` -> `getDefaultFilter()` | `PostgresBaseRepository.getDefaultFilter()` |
-| `DefaultFilterMixin` -> `hasDefaultFilter()` | `PostgresBaseRepository.hasDefaultFilter()` |
-| `DefaultFilterMixin` -> `applyDefaultFilter()` | `PostgresBaseRepository.applyDefaultFilter()` |
+| `FieldsVisibilityMixin` -> `getHiddenProperties()` | `RelationalBaseRepository.getHiddenProperties()` |
+| `FieldsVisibilityMixin` -> `getVisibleProperties()` | `RelationalBaseRepository.getVisibleProperties()` |
+| `FieldsVisibilityMixin` -> `hasHiddenProperties()` | `RelationalBaseRepository.hasHiddenProperties()` |
+| `DefaultFilterMixin` -> `getDefaultFilter()` | `RelationalBaseRepository.getDefaultFilter()` |
+| `DefaultFilterMixin` -> `hasDefaultFilter()` | `RelationalBaseRepository.hasDefaultFilter()` |
+| `DefaultFilterMixin` -> `applyDefaultFilter()` | `RelationalBaseRepository.applyDefaultFilter()` |
 
-If you extended `DefaultCRUDRepository` (or any class in the PostgreSQL hierarchy), no change is needed - these methods have always been available on your repository instances; only the internal composition changed.
+If you extended `DefaultCRUDRepository` (or any class in the PostgreSQL hierarchy), you don't need to change anything - these methods have always been available on your repository instances. Only the internal composition changed.
 
 ## Custom Mixins Still Work
 
@@ -92,8 +95,9 @@ export class ProductRepository extends AuditLogMixin(
 ) {}
 ```
 
-## See Also
+## See also
 
-- [Repository Overview](./index.md) - Current class hierarchy
-- [Advanced Features](./advanced.md) - Hidden properties and default-filter bypass in practice
-- [Default Filter](../filter-system/default-filter.md) - Configuring `@model` default filters
+- [Repositories overview](/references/base/repositories/) - CRUD basics, common tasks
+- [Advanced Features](./advanced) - hidden properties and default-filter bypass in practice
+- [SoftDeletableRepository](./soft-deletable) - concrete default-filter usage (soft delete)
+- [Default Filter](/references/base/filter-system/default-filter) - configuring `@model` default filters