import { DyFM_DBSort } from '@futdevpro/fsm-dynamo';

/**
 * BFR-OVERSEER-008 — opcionalis query-szukites a list-lekerdezokhoz (projection / limit / sort).
 *
 * A `DyNTS_DBService.find()` es a `DyNTS_DataService.findDataList()` opcionalis 3. parametere.
 * A szukites DB-szinten tortenik (mongoose `.select()/.sort()/.limit()`), igy a nagy mezok
 * (pl. tobb-MB-s blob property-k) BE SEM toltodnek a heap-be — ez a mert Overseer
 * event-loop-block (nagy-archiv full-betoltes) gyoker-fixenek enablere.
 *
 * FONTOS viselkedesi reszlet: ha options van megadva es a hivo nem ker `findDeleted`-et,
 * a soft-delete szures QUERY-szintre kerul (`_deleted: { $ne: true }`) a memoriabeli
 * post-filter helyett — limit mellett a post-filter hibas darabszamot adna, projekcio
 * mellett (ha a `_deleted` nincs projektalva) hibasan atengedne a torolt dokumentumokat.
 */
export interface DyNTS_DBQueryOptions<T> {
  /**
   * Mongoose select-projekcio — pl. `{ version: 1, timestamp: 1 }` (include-lista)
   * vagy `'-cdpReport'` (exclude-string). Ha nincs megadva, a teljes dokumentum jon.
   */
  projection?: { [K in keyof T]?: 0 | 1 } | string;

  /**
   * Max visszaadott dokumentum-szam (mongoose `.limit()`). Sort-tal egyutt hasznald,
   * kulonben a "melyik N" nem-determinisztikus.
   */
  limit?: number;

  /**
   * Rendezes (mongoose `.sort()`) — pl. `{ __created: -1 }` a legfrissebbek elore.
   */
  sort?: DyFM_DBSort<T>;
}