itlab-internal-services 2.16.21 → 2.16.23

package/dist/classes/entity-map.class.d.ts

@@ -9,7 +9,7 @@ export declare class EntityMap<T extends {
      * @param map Map of id -> user/account object
      * @returns user/account object
      */
-    get(id: string): T;
+    get(id: string): T | undefined;
     /**
      * Maps an array of IDs to user/account objects using a user/account Map.
      * Filters out any IDs that don’t have a corresponding entity.

package/dist/classes/entity-map.class.js

@@ -24,7 +24,8 @@ class EntityMap {
     getMultiple(ids) {
         if (!ids || ids.length === 0)
             return [];
-        return ids.map((id) => this.map.get(id)).filter(Boolean);
+        const entities = ids.map((id) => this.map.get(id));
+        return entities.filter(Boolean);
     }
 }
 exports.EntityMap = EntityMap;

package/dist/hub-resource.enum.d.ts

@@ -21,11 +21,11 @@ export declare enum HubResource {
     NEWSROOM_NEWS = "newsroom-news",
     EVENTS_EVENT = "events-event",
     HACKSCHOOL_COURSE = "hackschool-course",
-    HACKSCHOOL_THREAD = "hackschool-thread",
     HACKSCHOOL_DOC = "hackschool-doc",
     DEMO_HIVE_DEMO = "demo-hive-demo",
     TECH_RADAR_BLIP = "tech-radar-blip",
     TECH_RADAR_EDITION = "tech-radar-edition",
+    TECH_RADAR_TECH_SCOUT = "tech-radar-tech-scout",
     PODCASTS_EPISODE = "podcasts-podcast",
     BOOKS_BOOK = "books-book",
     TEAM_MEMBER = "team-member",

package/dist/hub-resource.enum.js

@@ -25,11 +25,11 @@ var HubResource;
     HubResource["NEWSROOM_NEWS"] = "newsroom-news";
     HubResource["EVENTS_EVENT"] = "events-event";
     HubResource["HACKSCHOOL_COURSE"] = "hackschool-course";
-    HubResource["HACKSCHOOL_THREAD"] = "hackschool-thread";
     HubResource["HACKSCHOOL_DOC"] = "hackschool-doc";
     HubResource["DEMO_HIVE_DEMO"] = "demo-hive-demo";
     HubResource["TECH_RADAR_BLIP"] = "tech-radar-blip";
     HubResource["TECH_RADAR_EDITION"] = "tech-radar-edition";
+    HubResource["TECH_RADAR_TECH_SCOUT"] = "tech-radar-tech-scout";
     HubResource["PODCASTS_EPISODE"] = "podcasts-podcast";
     HubResource["BOOKS_BOOK"] = "books-book";
     HubResource["TEAM_MEMBER"] = "team-member";
@@ -54,11 +54,11 @@ exports.HUB_RESOURCES = [
     HubResource.NEWSROOM_NEWS,
     HubResource.EVENTS_EVENT,
     HubResource.HACKSCHOOL_COURSE,
-    HubResource.HACKSCHOOL_THREAD,
     HubResource.HACKSCHOOL_DOC,
     HubResource.DEMO_HIVE_DEMO,
     HubResource.TECH_RADAR_BLIP,
     HubResource.TECH_RADAR_EDITION,
+    HubResource.TECH_RADAR_TECH_SCOUT,
     HubResource.PODCASTS_EPISODE,
     HubResource.BOOKS_BOOK,
     HubResource.TEAM_MEMBER,

package/dist/modules/services/base-http.service.js

@@ -106,9 +106,10 @@ class BaseHttpService {
         if (ids && Array.isArray(ids)) {
             if (ids.length === 0)
                 return [];
-            if (ids.length > 50) {
+            const uniqueIds = new Set(ids);
+            if (uniqueIds.size > 50) {
                 // Parallelize requests for each chunk; flatten the results into one array.
-                const batchPromises = (0, itlab_functions_1.createChunks)(ids, 50).map((chunk) => {
+                const batchPromises = (0, itlab_functions_1.createChunks)(Array.from(uniqueIds), 50).map((chunk) => {
                     const chunkConfig = Object.assign({}, config);
                     chunkConfig.params.ids = chunk;
                     return this.fetchResourceCollectionBatch(endpoint, chunkConfig);

package/dist/modules/services/providers/hackschool/hackschool.service.d.ts

@@ -1,10 +1,9 @@
 import { ConfigService } from '@nestjs/config';
-import { LabHackschoolCourse, LabHackschoolDoc, LabHackschoolThread } from 'itlab-functions';
+import { LabHackschoolCourse, LabHackschoolDoc } from 'itlab-functions';
 import { AuthenticationModuleOptions } from '../../../authentication';
 import { BaseHttpService } from '../../base-http.service';
 import { FetchCourseOptionsDtoV1 } from './fetch-course-options.dto.v1.type';
 import { FetchDocOptionsDtoV1 } from './fetch-doc-options.dto.v1.type';
-import { FetchThreadOptionsDtoV1 } from './fetch-thread-options.dto.v1.type';
 /**
  * HackschoolService
  *
@@ -48,27 +47,6 @@ export declare class HackschoolService extends BaseHttpService {
      * @returns {Promise<LabHackschoolCourse[]>} Resolves to a list of courses, or an empty array if none found.
      */
     fetchCourseCollectionV1(options?: FetchCourseOptionsDtoV1): Promise<LabHackschoolCourse[]>;
-    /**
-     * Retrieves a single thread entry by its MongoDB identifier.
-     *
-     * This method gracefully handles downstream failures by logging
-     * and returning `undefined` instead of throwing.
-     *
-     * @param {string} threadId - Unique MongoDB identifier of the thread.
-     * @param {FetchThreadOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
-     * @returns {Promise<LabHackschoolThread | undefined>} Resolves to an Thread or `undefined` on failure.
-     */
-    fetchThreadV1(threadId: string, options?: FetchThreadOptionsDtoV1): Promise<LabHackschoolThread | undefined>;
-    /**
-     * Retrieves a collection of thread entries.
-     *
-     * Useful for batch lookups or paginated listings.
-     * Returns an empty array if the downstream service call fails.
-     *
-     * @param {FetchThreadOptionsDtoV1} [options] - Optional filter options for narrowing results.
-     * @returns {Promise<LabHackschoolThread[]>} Resolves to a list of threads, or an empty array if none found.
-     */
-    fetchThreadCollectionV1(options?: FetchThreadOptionsDtoV1): Promise<LabHackschoolThread[]>;
     /**
      * Retrieves a single doc entry by its MongoDB identifier.
      *

package/dist/modules/services/providers/hackschool/hackschool.service.js

@@ -71,34 +71,6 @@ let HackschoolService = class HackschoolService extends base_http_service_1.Base
         return this.fetchResourceCollection(`v1/internal/courses`, { params: options });
     }
     // ─────────────────────────────────────────────────────────────
-    // Thread Resource Methods
-    // ─────────────────────────────────────────────────────────────
-    /**
-     * Retrieves a single thread entry by its MongoDB identifier.
-     *
-     * This method gracefully handles downstream failures by logging
-     * and returning `undefined` instead of throwing.
-     *
-     * @param {string} threadId - Unique MongoDB identifier of the thread.
-     * @param {FetchThreadOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
-     * @returns {Promise<LabHackschoolThread | undefined>} Resolves to an Thread or `undefined` on failure.
-     */
-    async fetchThreadV1(threadId, options) {
-        return this.fetchResource(`v1/internal/thread/${threadId}`, { params: options });
-    }
-    /**
-     * Retrieves a collection of thread entries.
-     *
-     * Useful for batch lookups or paginated listings.
-     * Returns an empty array if the downstream service call fails.
-     *
-     * @param {FetchThreadOptionsDtoV1} [options] - Optional filter options for narrowing results.
-     * @returns {Promise<LabHackschoolThread[]>} Resolves to a list of threads, or an empty array if none found.
-     */
-    async fetchThreadCollectionV1(options) {
-        return this.fetchResourceCollection(`v1/internal/threads`, { params: options });
-    }
-    // ─────────────────────────────────────────────────────────────
     // Doc Resource Methods
     // ─────────────────────────────────────────────────────────────
     /**

package/dist/modules/services/providers/hackschool/index.d.ts

@@ -1,2 +1,3 @@
+export * from './fetch-course-options.dto.v1.type';
 export * from './fetch-doc-options.dto.v1.type';
 export * from './hackschool.service';

package/dist/modules/services/providers/hackschool/index.js

@@ -14,5 +14,6 @@ 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("./fetch-course-options.dto.v1.type"), exports);
 __exportStar(require("./fetch-doc-options.dto.v1.type"), exports);
 __exportStar(require("./hackschool.service"), exports);

package/dist/modules/services/providers/mail/dtos/event-user-cancellation-mail.dto.v1.d.ts

@@ -1,18 +1,26 @@
-import { MailRecipient } from '../models';
+import { MailAttachment, MailRecipient } from '../models';
 /**
  * Payload for sending a cancellation notification for an event.
  */
 export type EventUserCancellationMailDtoV1 = {
     recipient: MailRecipient;
     /**
-     * Mode of participation (e.g., in person, online).
+     * Optional attachments
      */
-    participation?: string;
+    attachments?: MailAttachment[];
+    /**
+     * Mode of participation (e.g., vor Ort, Online).
+     */
+    participation: string;
     /**
      * Title of the event that has been cancelled.
      * @example "Meetup"
      */
     title: string;
+    /**
+     * Series of the event.
+     */
+    series: string;
     /**
      * Human-readable date and time string of the event.
      * @example "17. April 2000 17:04–20:00 Uhr"

package/dist/modules/services/providers/mail/dtos/event-user-registration-mail.dto.v1.d.ts

@@ -9,17 +9,29 @@ export type EventUserRegistrationMailDtoV1 = {
      */
     attachments?: MailAttachment[];
     /**
-     * Mode of participation (e.g., in person, online).
+     * Mode of participation (e.g., vor Ort, Online).
      */
-    participation?: string;
+    participation: string;
     /**
      * Title of the event.
      */
     title: string;
+    /**
+     * Summary of the event.
+     */
+    summary: string;
+    /**
+     * Series of the event.
+     */
+    series: string;
     /**
      * Date and time string describing the event.
      */
     dateString: string;
+    /**
+     * URL to join the event online
+     */
+    meetingUrl?: string;
     /**
      * URL linking to the event on the public hub.
      */

package/dist/modules/services/providers/tech-radar/fetch-tech-scout-options.dto.v1.type.d.ts

@@ -0,0 +1,22 @@
+import { BaseFetchOptions, DraftedFetchOptions, TimestampsFetchOptions } from '../../../../classes';
+/**
+ * FetchTechScoutOptionsDtoV1
+ *
+ * Data Transfer Object for querying tech scout collections.
+ * Inherits timestamp filtering fields and extends them with
+ * tech-scout-specific query parameters.
+ */
+export type FetchTechScoutOptionsDtoV1 = BaseFetchOptions & TimestampsFetchOptions & DraftedFetchOptions & {
+    includeAccount?: boolean;
+    includeEditionIds?: boolean;
+    includeEditions?: boolean;
+    includeBlipIds?: boolean;
+    includeBlips?: boolean;
+    isActive?: boolean;
+    accountId?: string;
+    accountIds?: string[];
+    department?: string;
+    departments?: string[];
+    role?: string;
+    roles?: string[];
+};

package/dist/modules/services/providers/tech-radar/index.d.ts

@@ -1,3 +1,4 @@
 export * from './fetch-blip-options.dto.v1.type';
-export * from './fetch-edition-options.dto.v1.type copy';
+export * from './fetch-edition-options.dto.v1.type';
+export * from './fetch-tech-scout-options.dto.v1.type';
 export * from './tech-radar.service';

package/dist/modules/services/providers/tech-radar/index.js

@@ -15,5 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./fetch-blip-options.dto.v1.type"), exports);
-__exportStar(require("./fetch-edition-options.dto.v1.type copy"), exports);
+__exportStar(require("./fetch-edition-options.dto.v1.type"), exports);
+__exportStar(require("./fetch-tech-scout-options.dto.v1.type"), exports);
 __exportStar(require("./tech-radar.service"), exports);

package/dist/modules/services/providers/tech-radar/tech-radar.service.d.ts

@@ -1,9 +1,10 @@
 import { ConfigService } from '@nestjs/config';
-import { LabTechRadarBlip, LabTechRadarEdition } from 'itlab-functions';
+import { LabTechRadarBlip, LabTechRadarEdition, LabTechRadarTechScout } from 'itlab-functions';
 import { AuthenticationModuleOptions } from '../../../authentication';
 import { BaseHttpService } from '../../base-http.service';
 import { FetchBlipOptionsDtoV1 } from './fetch-blip-options.dto.v1.type';
-import { FetchEditionOptionsDtoV1 } from './fetch-edition-options.dto.v1.type copy';
+import { FetchEditionOptionsDtoV1 } from './fetch-edition-options.dto.v1.type';
+import { FetchTechScoutOptionsDtoV1 } from './fetch-tech-scout-options.dto.v1.type';
 /**
  * TechRadarService
  *
@@ -68,4 +69,25 @@ export declare class TechRadarService extends BaseHttpService {
      * @returns {Promise<LabTechRadarEdition[]>} Resolves to a list of editions, or an empty array if none found.
      */
     fetchEditionCollectionV1(options?: FetchEditionOptionsDtoV1): Promise<LabTechRadarEdition[]>;
+    /**
+     * Retrieves a single tech scout entry by its MongoDB identifier.
+     *
+     * This method gracefully handles downstream failures by logging
+     * and returning `undefined` instead of throwing.
+     *
+     * @param {string} techScoutId - Unique MongoDB identifier of the tech scout.
+     * @param {FetchTechScoutOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
+     * @returns {Promise<LabTechRadarTechScout | undefined>} Resolves to an Tech Scout or `undefined` on failure.
+     */
+    fetchTechScoutV1(techScoutId: string, options?: FetchTechScoutOptionsDtoV1): Promise<LabTechRadarTechScout | undefined>;
+    /**
+     * Retrieves a collection of tech scout entries.
+     *
+     * Useful for batch lookups or paginated listings.
+     * Returns an empty array if the downstream service call fails.
+     *
+     * @param {FetchTechScoutOptionsDtoV1} [options] - Optional filter options for narrowing results.
+     * @returns {Promise<LabTechRadarTechScout[]>} Resolves to a list of tech scouts, or an empty array if none found.
+     */
+    fetchTechScoutCollectionV1(options?: FetchTechScoutOptionsDtoV1): Promise<LabTechRadarTechScout[]>;
 }

package/dist/modules/services/providers/tech-radar/tech-radar.service.js

@@ -98,6 +98,34 @@ let TechRadarService = class TechRadarService extends base_http_service_1.BaseHt
     async fetchEditionCollectionV1(options) {
         return this.fetchResourceCollection(`v1/internal/editions`, { params: options });
     }
+    // ─────────────────────────────────────────────────────────────
+    // Tech Scout Resource Methods
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Retrieves a single tech scout entry by its MongoDB identifier.
+     *
+     * This method gracefully handles downstream failures by logging
+     * and returning `undefined` instead of throwing.
+     *
+     * @param {string} techScoutId - Unique MongoDB identifier of the tech scout.
+     * @param {FetchTechScoutOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
+     * @returns {Promise<LabTechRadarTechScout | undefined>} Resolves to an Tech Scout or `undefined` on failure.
+     */
+    async fetchTechScoutV1(techScoutId, options) {
+        return this.fetchResource(`v1/internal/tech-scout/${techScoutId}`, { params: options });
+    }
+    /**
+     * Retrieves a collection of tech scout entries.
+     *
+     * Useful for batch lookups or paginated listings.
+     * Returns an empty array if the downstream service call fails.
+     *
+     * @param {FetchTechScoutOptionsDtoV1} [options] - Optional filter options for narrowing results.
+     * @returns {Promise<LabTechRadarTechScout[]>} Resolves to a list of tech scouts, or an empty array if none found.
+     */
+    async fetchTechScoutCollectionV1(options) {
+        return this.fetchResourceCollection(`v1/internal/tech-scouts`, { params: options });
+    }
 };
 exports.TechRadarService = TechRadarService;
 exports.TechRadarService = TechRadarService = __decorate([

package/dist/pipes/queries/mongo-ids.pipe.js

@@ -5,6 +5,7 @@ exports.ApiMongoIdsQuery = ApiMongoIdsQuery;
 const common_1 = require("@nestjs/common");
 const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
+const transform_1 = require("../../transform");
 /**
  * ParseMongoIdsPipe
  *
@@ -23,13 +24,10 @@ class ParseMongoIdsPipe {
      * @returns {string[]} - Array of valid MongoDB IDs; returns empty array if input is invalid.
      */
     transform(value) {
-        if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
-            value = Object.values(value);
-        }
-        if (!Array.isArray(value))
+        const array = (0, transform_1.arrayTransform)(value, { unique: true });
+        if (!array)
             return undefined;
-        const mongoIds = value.filter((v) => (0, class_validator_1.isMongoId)(v)).map((v) => String(v));
-        return Array.from(new Set(mongoIds));
+        return array.filter((v) => (0, class_validator_1.isMongoId)(v)).map((v) => String(v));
     }
 }
 /**

package/dist/transform/array.transform.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Options for ArrayTransform decorator.
+ */
+type ArrayTransformOptions = {
+    unique?: boolean;
+};
+/**
+ * function to normalize and sanitize an array of any.
+ * Applies deduplication as configured.
+ *
+ * @param {any} value - Value to transform
+ * @param {ArrayTransformOptions} opts - Transformation configuration.
+ * @returns {any[]} - Transforms a property into a cleaned array.
+ */
+export declare function arrayTransform(value: any, opts?: ArrayTransformOptions): any[] | undefined;
+/**
+ * Property decorator to normalize and sanitize an array of any.
+ * Applies deduplication as configured.
+ *
+ * @param {ArrayTransformOptions} opts - Transformation configuration.
+ * @returns {PropertyDecorator} - Transforms a property into a cleaned array.
+ */
+export declare function ArrayTransform(opts?: ArrayTransformOptions): PropertyDecorator;
+export {};

package/dist/transform/array.transform.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.arrayTransform = arrayTransform;
+exports.ArrayTransform = ArrayTransform;
+const class_transformer_1 = require("class-transformer");
+/**
+ * function to normalize and sanitize an array of any.
+ * Applies deduplication as configured.
+ *
+ * @param {any} value - Value to transform
+ * @param {ArrayTransformOptions} opts - Transformation configuration.
+ * @returns {any[]} - Transforms a property into a cleaned array.
+ */
+function arrayTransform(value, opts = {}) {
+    if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+        value = Object.values(value);
+    }
+    if (!Array.isArray(value))
+        return undefined;
+    if (!opts.unique)
+        return value;
+    return Array.from(new Set(value));
+}
+/**
+ * Property decorator to normalize and sanitize an array of any.
+ * Applies deduplication as configured.
+ *
+ * @param {ArrayTransformOptions} opts - Transformation configuration.
+ * @returns {PropertyDecorator} - Transforms a property into a cleaned array.
+ */
+function ArrayTransform(opts = {}) {
+    return (0, class_transformer_1.Transform)(({ value }) => {
+        return arrayTransform(value, opts);
+    });
+}

package/dist/transform/index.d.ts

@@ -1,3 +1,4 @@
+export * from './array.transform';
 export * from './boolean.transform';
 export * from './image-url.transform';
 export * from './mongo-id.transform';

package/dist/transform/index.js

@@ -14,6 +14,7 @@ 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("./array.transform"), exports);
 __exportStar(require("./boolean.transform"), exports);
 __exportStar(require("./image-url.transform"), exports);
 __exportStar(require("./mongo-id.transform"), exports);

package/dist/transform/mongo-ids.transform.js

@@ -3,17 +3,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MongoIdsTransform = MongoIdsTransform;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const array_transform_1 = require("./array.transform");
 /**
  * @returns {PropertyDecorator} - Transforms a property to a boolean.
  */
 function MongoIdsTransform() {
     return (0, class_transformer_1.Transform)(({ value }) => {
-        if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
-            value = Object.values(value);
-        }
-        if (!Array.isArray(value))
+        const array = (0, array_transform_1.arrayTransform)(value, { unique: true });
+        if (!array)
             return undefined;
-        const mongoIds = value.filter((v) => (0, class_validator_1.isMongoId)(v)).map((v) => String(v));
-        return Array.from(new Set(mongoIds));
+        return array.filter((v) => (0, class_validator_1.isMongoId)(v)).map((v) => String(v));
     });
 }

package/dist/transform/string-array.transform.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StringArrayTransform = StringArrayTransform;
 const class_transformer_1 = require("class-transformer");
+const array_transform_1 = require("./array.transform");
 /**
  * Property decorator to normalize and sanitize an array of strings.
  * Applies trimming, lowercasing, and deduplication as configured.
@@ -11,12 +12,10 @@ const class_transformer_1 = require("class-transformer");
  */
 function StringArrayTransform(opts = {}) {
     return (0, class_transformer_1.Transform)(({ value }) => {
-        if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
-            value = Object.values(value);
-        }
-        if (!Array.isArray(value))
+        const array = (0, array_transform_1.arrayTransform)(value, opts);
+        if (!array)
             return undefined;
-        const transformedValue = value.map((value) => {
+        return array.map((value) => {
             let str = String(value);
             if (opts.trim)
                 str = str.trim();
@@ -24,8 +23,5 @@ function StringArrayTransform(opts = {}) {
                 str = str.toLowerCase();
             return str;
         });
-        if (!opts.unique)
-            return transformedValue;
-        return Array.from(new Set(transformedValue));
     });
 }

package/package.json

@@ -4,7 +4,7 @@
     "name": "Timo Scheuermann",
     "email": "timo.scheuermann@sv-informatik.de"
   },
-  "version": "2.16.21",
+  "version": "2.16.23",
   "type": "commonjs",
   "files": [
     "dist"
@@ -35,7 +35,7 @@
     "cache-manager": "^7.2.4",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.2",
-    "itlab-functions": "^1.0.10",
+    "itlab-functions": "^1.0.13",
     "mongoose": "^8.19.2",
     "rxjs": "^7.8.2"
   },

package/dist/modules/services/providers/hackschool/fetch-thread-options.dto.v1.type.d.ts

@@ -1,18 +0,0 @@
-import { BaseFetchOptions, CommentsFetchOptions, ContentFetchOptions, ViewedByFetchOptions } from '../../../../classes';
-/**
- * FetchThreadOptionsDtoV1
- *
- * Data Transfer Object for querying thread collections.
- * Inherits timestamp filtering fields and extends them with
- * thread-specific query parameters.
- */
-export type FetchThreadOptionsDtoV1 = BaseFetchOptions & ContentFetchOptions & ViewedByFetchOptions & CommentsFetchOptions & {
-    includeAuthor?: boolean;
-    isClosed?: boolean;
-    tag?: string;
-    tags?: string[];
-    authorId?: string;
-    authorIds?: string[];
-    timestampMin?: number;
-    timestampMax?: number;
-};