@lilaquadrat/studio 12.1.0 → 12.2.0

package/lib/src/services/employeeAbsences.service.js

@@ -0,0 +1,57 @@
+import Immutable from '../Immutable.class.js';
+import ImmutableError from '../classes/errors/Immutable.error.js';
+import AbsenceModel from '../models/employeeAbsence.model.js';
+import CustomersService from './customers.service.js';
+import { interval, planningValidation } from '../helpers/shiftPlanningTime.js';
+import { planningIntervalFilter, planningPage, planningPagination } from '../helpers/shiftPlanningValidation.js';
+/** Absences follow the person across employee lists and departments; a project-local absence would miss conflicts. */
+export class EmployeeAbsencesService extends Immutable {
+    constructor() {
+        super(...arguments);
+        this.model = AbsenceModel;
+    }
+    async normalizedInput(input, options) {
+        if (!(await CustomersService.peopleForPlanning([input.customer], options.company)).length) {
+            planningValidation('/customer', 'must identify a person in this company');
+        }
+        return { ...input, ...interval(input.start, input.end) };
+    }
+    /** Recording sickness must succeed even if existing shifts need planner attention afterward. */
+    async createAbsence(input, options) {
+        const normalized = await this.normalizedInput(input, options);
+        const created = await this.create({ ...normalized, company: options.company, project: options.project }, options.user, options.app);
+        return (await this.singleAbsence(created._id, options));
+    }
+    async singleAbsence(absence, options) {
+        return this.model.db.findOne({ _id: absence, company: options.company, project: options.project });
+    }
+    async changeAbsence(absence, input, options) {
+        if (!await this.singleAbsence(absence, options))
+            throw new ImmutableError('EMPLOYEE_ABSENCE_NOT_FOUND');
+        const normalized = await this.normalizedInput(input, options);
+        await this.immutable({ _id: absence, company: options.company, project: options.project }, normalized, options.user, 'change', options.app);
+        return (await this.singleAbsence(absence, options));
+    }
+    async removeAbsence(absence, options) {
+        if (!await this.singleAbsence(absence, options))
+            throw new ImmutableError('EMPLOYEE_ABSENCE_NOT_FOUND');
+        await this.delete(absence, options.user, options.app);
+    }
+    async listAbsences(filters, options) {
+        const query = { company: options.company, project: options.project, ...planningIntervalFilter(filters) };
+        if (filters.customer)
+            query.customer = filters.customer;
+        const { site, limit, skip } = planningPagination(filters);
+        const all = await this.model.db.countDocuments(query);
+        const documents = await this.model.db.find(query).sort({ start: 1, _id: 1 }).skip(skip).limit(limit).toArray();
+        return planningPage(documents, all, site, limit);
+    }
+    /** Scheduling checks need company-wide periods; response projections never reveal their private absence type. */
+    async absencesForPlanning(customers, from, to, options) {
+        return this.model.db.find({ company: options.company, project: options.project, customer: { $in: customers },
+            ...planningIntervalFilter({ from, to }),
+        }).toArray();
+    }
+}
+export default new EmployeeAbsencesService();
+//# sourceMappingURL=employeeAbsences.service.js.map

package/lib/src/services/employeeAbsences.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"employeeAbsences.service.js","sourceRoot":"","sources":["../../../src/services/employeeAbsences.service.ts"],"names":[],"mappings":"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"}

package/lib/src/services/history.service.d.ts

@@ -1,5 +1,7 @@
 import { Filter, ObjectId, OrderedBulkOperation, UnorderedBulkOperation, Document } from 'mongodb';
 import { HistoryReason, History, BasicData, Options } from '@lilaquadrat/interfaces';
+import { HistorySeenKey } from './historySeen.service.js';
+type HistoryTenantUser = Pick<HistorySeenKey, 'user' | 'company' | 'project'>;
 declare class HistoryService {
     model: import("../classes/modelv2.class.js").default<History, string>;
     /**
@@ -36,6 +38,19 @@ declare class HistoryService {
         countQuery: Filter<History>;
         aggregation: any[];
     };
+    /**
+     * the snapshot of one history entry together with the snapshot of the version before it, so the
+     * changes can be shown. the first version (0, the creation) has no previous one.
+     * the extra filter keeps callers with a narrower permission inside their scope, e.g. a single list.
+     */
+    entryWithPrevious(company: string, project: string | undefined, historyId: ObjectId, scopeFilter?: Filter<History>): Promise<{
+        current: import("mongodb").WithId<History>;
+        previous: import("mongodb").WithId<History> | null;
+    } | null>;
+    /** the whole model of a tenant is the watched scope, entities with a parent use their own scope instead */
+    private modelSeenKey;
+    unreadCount(options: HistoryTenantUser, model: string): Promise<number>;
+    markSeen(options: HistoryTenantUser, model: string): Promise<ObjectId | null>;
     export(options: Options & {
         model?: string;
     }): Promise<import("mongodb").WithId<History>[]>;

package/lib/src/services/history.service.js

@@ -4,6 +4,7 @@ import partialAggregation from '../aggegations/partial.aggregation.js';
 import { HistoryModel } from '../../models.js';
 import HistoryError from '../classes/errors/History.error.js';
 import genericDataAggregation from '../aggegations/genericData.aggregation.js';
+import HistorySeenService from './historySeen.service.js';
 class HistoryService {
     constructor() {
         this.model = HistoryModel;
@@ -245,6 +246,41 @@ class HistoryService {
             aggregation,
         };
     }
+    /**
+     * the snapshot of one history entry together with the snapshot of the version before it, so the
+     * changes can be shown. the first version (0, the creation) has no previous one.
+     * the extra filter keeps callers with a narrower permission inside their scope, e.g. a single list.
+     */
+    async entryWithPrevious(company, project, historyId, scopeFilter = {}) {
+        const tenant = { company, project: project ?? null };
+        const current = await this.model.db.findOne({ ...scopeFilter, ...tenant, _id: historyId });
+        if (!current)
+            return null;
+        const previous = current.history.version > 0
+            ? await this.model.db.findOne({
+                ...tenant,
+                'history.parent': current.history.parent,
+                'history.version': current.history.version - 1,
+            })
+            : null;
+        return { current, previous };
+    }
+    /** the whole model of a tenant is the watched scope, entities with a parent use their own scope instead */
+    modelSeenKey(options, model) {
+        return {
+            user: options.user,
+            company: options.company,
+            project: options.project,
+            model,
+            scope: model,
+        };
+    }
+    unreadCount(options, model) {
+        return HistorySeenService.unreadCount(this.modelSeenKey(options, model), {});
+    }
+    markSeen(options, model) {
+        return HistorySeenService.markSeen(this.modelSeenKey(options, model), {});
+    }
     export(options) {
         return this.model.db.find({ company: options.company, project: options.project, 'history.model': options.model }).toArray();
     }

package/lib/src/services/history.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"history.service.js","sourceRoot":"","sources":["../../../src/services/history.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"history.service.js","sourceRoot":"","sources":["../../../src/services/history.service.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,QAAQ,GACT,MAAM,SAAS,CAAC;AACjB,OAAO,oBAAoB,MAAM,yCAAyC,CAAC;AAC3E,OAAO,kBAAkB,MAAM,uCAAuC,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,YAAY,MAAM,oCAAoC,CAAC;AAE9D,OAAO,sBAAsB,MAAM,2CAA2C,CAAC;AAC/E,OAAO,kBAAsC,MAAM,0BAA0B,CAAC;AAI9E,MAAM,cAAc;IAApB;QAEE,UAAK,GAAG,YAAY,CAAC;IAubvB,CAAC;IArbC;;;;;OAKG;IACK,UAAU;QAEhB,OAAO;YACL;gBACE,OAAO,EAAE;oBACP,IAAI,EAAE,IAAI;oBACV,EAAE,EAAE,UAAU;oBACd,GAAG,EAAE;wBACH,MAAM,EAAE,eAAe;wBACvB,GAAG,EAAE,cAAc;wBACnB,OAAO,EAAE,UAAU;wBACnB,MAAM,EAAE,iBAAiB;qBAC1B;oBACD,QAAQ,EAAE;wBACR;4BACE,MAAM,EAAE;gCACN,KAAK,EAAE;oCACL,IAAI,EAAE;wCACJ,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE;wCAC5B,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE;qCAChC;iCACF;6BACF;yBACF;wBACD;4BACE,QAAQ,EAAE;gCACR,OAAO,EAAE,CAAC;gCACV,QAAQ,EAAE,CAAC;6BACZ;yBACF;wBACD;4BACE,UAAU,EAAE;gCACV,IAAI,EAAE,WAAW;gCACjB,QAAQ,EAAE;oCACR;wCACE,MAAM,EAAE;4CACN,KAAK,EAAE;gDACL,IAAI,EAAE;oDACJ,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE;oDAC/B,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE;oDAClC;wDACE,GAAG,EAAE;4DACH;gEACE,KAAK,EAAE;oEACL,OAAO,EAAE;wEACP,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE;wEACrC,EAAE,EAAE,SAAS;wEACb,IAAI,EAAE;4EACJ,IAAI,EAAE;gFACJ,EAAE,GAAG,EAAE,CAAC,mBAAmB,EAAE,UAAU,CAAC,EAAE;gFAC1C,EAAE,GAAG,EAAE,CAAC,eAAe,EAAE,OAAO,CAAC,EAAE;6EACpC;yEACF;qEACF;iEACF;6DACF;4DACD,CAAC;yDACF;qDACF;iDACF;6CACF;yCACF;qCACF;oCACD;wCACE,QAAQ,EAAE;4CACR,OAAO,EAAE,CAAC;4CACV,QAAQ,EAAE,OAAO;yCAClB;qCACF;iCACF;6BACF;yBACF;wBACD;4BACE,QAAQ,EAAE;gCACR,OAAO,EAAE,CAAC;gCACV,QAAQ,EAAE,CAAC;gCACX,GAAG,EAAE,CAAC;6BACP;yBACF;wBACD,EAAE,MAAM,EAAE,CAAC,EAAE;qBACd;iBACF;aACF;YACD;gBACE,OAAO,EAAE;oBACP,IAAI,EAAE,WAAW;oBACjB,0BAA0B,EAAE,IAAI;iBACjC;aACF;YACD;gBACE,UAAU,EAAE;oBACV,cAAc,EAAE;wBACd,OAAO,EAAE;4BACP,EAAE,OAAO,EAAE,CAAC,oBAAoB,EAAE,IAAI,EAAE,mBAAmB,CAAC,EAAE;4BAC9D,eAAe;yBAChB;qBACF;iBACF;aACF;SACF,CAAC;IAEJ,CAAC;IA6BD,MAAM,CACJ,IAAkB,EAClB,IAAY,EACZ,MAAqB,EACrB,GAAW,EACX,SAAiB,EACjB,qBAAmE,EACnE,UAAyB,EACzB,IAAoD,EACpD,MAAqC;QAGrC,MAAM,SAAS,GAA2B;YACxC,GAAG,IAAI;YACP,GAAG,EAAE,IAAI,QAAQ,EAAE;YACnB,OAAO,EAAE;gBACP,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAiB;gBACxC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,MAAgB;gBACtC,MAAM,EAAE,IAAI,CAAC,GAAe;gBAC5B,IAAI,EAAE,IAAI,IAAI,EAAE;gBAChB,IAAI;gBACJ,MAAM;gBACN,GAAG;gBACH,KAAK,EAAE,SAAS;aACjB;SACF,CAAC;QAEF,sEAAsE;QACtE,IAAI,MAAM;YAAE,SAAS,CAAC,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;QAE9C,IAAI,qBAAqB,EAAE,CAAC;YAE1B,SAAS,CAAC,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC;QAE1D,CAAC;QAED,IAAI,MAAM,KAAK,MAAM,IAAI,UAAU,EAAE,CAAC;YAEpC,SAAS,CAAC,OAAO,CAAC,aAAa,GAAG,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC;YAC9D,SAAS,CAAC,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC;QAEhD,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,CAAC;YAE9C,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACtD,MAAM,IAAI,YAAY,CAAC,mBAAmB,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAEtF,CAAC;QAED,OAAO,IAAI;YACT,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;YACxB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAEzC,CAAC;IAED,KAAK,CAAC,IAAI,CACR,OAAe,EACf,OAA2B,EAC3B,KAAa,EACb,EAAsB,EACtB,MAAsB,EACtB,GAAY,EACZ,IAAa,EACb,KAAc,EACd,IAAa;QAGb,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAEpG,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAEnE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC;aAC5D,OAAO,EAAE,CAAC;QAEb,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IAE3C,CAAC;IAED,KAAK,CAAC,eAAe,CAAqB,OAA4D;QAEpG,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAEnE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,CAAI,OAAO,CAAC,WAAW,CAAC;aAC/D,OAAO,EAAE,CAAC;QAEb,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IAE3C,CAAC;IAED,KAAK,CAAC,UAAU,CACd,OAAe,EACf,OAA2B,EAC3B,UAAoB,EACpB,KAAa,EACb,MAAsB,EACtB,GAAY,EACZ,IAAa,EACb,KAAc,EACd,IAAa;QAGb,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAE5G,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAEnE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC;aAC5D,OAAO,EAAE,CAAC;QAEb,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IAE3C,CAAC;IAED,KAAK,CAAC,MAAM,CACV,OAAe,EACf,OAA2B,EAC3B,EAAU,EACV,OAAe;QAIf,MAAM,WAAW,GAAa,CAAC;gBAC7B,MAAM,EAAE;oBACN,OAAO;oBACP,OAAO;oBACP,EAAE;oBACF,iBAAiB,EAAE,OAAO;iBAC3B;aACF,CAAC,CAAC;QAEH,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,EAAE,GAAG,kBAAkB,EAAE,GAAG,oBAAoB,CAAC,CAAC;QAEvF,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE;aAClD,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjC,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,OAAe,EACf,OAA2B,EAC3B,EAAY;QAGZ,MAAM,WAAW,GAAa,CAAC;gBAC7B,MAAM,EAAE;oBACN,OAAO;oBACP,OAAO;oBACP,GAAG,EAAE,EAAE;iBACR;aACF,CAAC,CAAC;QAEH,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAEvC,WAAW,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,CAAC;QAExC,WAAW,CAAC,IAAI,CAAC,GAAG,oBAAoB,CAAC,CAAC;QAE1C,WAAW,CAAC,IAAI,CAAC,GAAG,sBAAsB,CAAC,CAAC;QAE5C,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE;aAClD,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjC,CAAC;IAED,WAAW,CACT,OAAe,EACf,OAA2B,EAC3B,KAAa,EACb,aAA4C,EAC5C,MAAsB,EACtB,GAAY,EACZ,UAAoB,EACpB,IAAa,EACb,KAAc,EACd,IAAa;QAGb,MAAM,UAAU,GAAoB;YAClC,OAAO;YACP,eAAe,EAAE,KAAK;SACvB,CAAC;QAEF,IAAI,OAAO;YAAE,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;QAE1C,IAAI,MAAM;YAAE,UAAU,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC;QAElD,IAAI,GAAG;YAAE,UAAU,CAAC,aAAa,CAAC,GAAG,GAAG,CAAC;QAEzC,IAAI,aAAa,EAAE,CAAC;YAElB,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;gBAEtC,UAAU,CAAC,gBAAgB,CAAC,GAAG,aAAa,CAAC;YAE/C,CAAC;iBAAM,CAAC;gBAEN,UAAU,CAAC,EAAE,GAAG,aAAuB,CAAC;YAE1C,CAAC;QAEH,CAAC;QAEL,MAAM,WAAW,GAAU;YACrB;gBACE,MAAM,EAAE,EAAE,GAAG,UAAU,EAAE;aAC1B;YACD;gBACE,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,IAAI,CAAC,CAAC,EAAE;aAC3B;YACD;gBACE,KAAK,EAAE,IAAI;aACZ;YACD;gBACE,MAAM,EAAE,KAAK;aACd;SACF,CAAC;QAEF,MAAM,MAAM,GAAa,IAAI,CAAC,UAAU,EAAE,CAAC;QAE3C,IAAI,UAAU,EAAE,CAAC;YAEf,MAAM,CAAC,IAAI,CAAC;gBACV,QAAQ,EAAE;oBACR,OAAO,EAAE,CAAC;oBACV,EAAE,EAAE,CAAC;oBACL,OAAO,EAAE,CAAC;oBACV,OAAO,EAAE,CAAC;iBACX;aACF,CAAC,CAAC;QAEL,CAAC;QAED,WAAW,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QAE5B,OAAO;YACL,UAAU;YACV,WAAW;SACZ,CAAC;IAEJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,iBAAiB,CACrB,OAAe,EACf,OAA2B,EAC3B,SAAmB,EACnB,cAA+B,EAAE;QAGjC,MAAM,MAAM,GAAoB,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,CAAC;QACtE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,GAAG,WAAW,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QAE3F,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAE1B,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,GAAG,CAAC;YAC1C,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC;gBAC5B,GAAG,MAAM;gBACT,gBAAgB,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM;gBACxC,iBAAiB,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,GAAG,CAAC;aAC/C,CAAC;YACF,CAAC,CAAC,IAAI,CAAC;QAET,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAE/B,CAAC;IAED,2GAA2G;IACnG,YAAY,CAAC,OAA0B,EAAE,KAAa;QAE5D,OAAO;YACL,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,KAAK;YACL,KAAK,EAAE,KAAK;SACb,CAAC;IAEJ,CAAC;IAED,WAAW,CAAC,OAA0B,EAAE,KAAa;QAEnD,OAAO,kBAAkB,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IAE/E,CAAC;IAED,QAAQ,CAAC,OAA0B,EAAE,KAAa;QAEhD,OAAO,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IAE5E,CAAC;IAED,MAAM,CAAC,OAAqC;QAE1C,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAE9H,CAAC;CAEF;AACD,eAAe,IAAI,cAAc,EAAE,CAAC"}

package/lib/src/services/historySeen.service.d.ts

@@ -0,0 +1,32 @@
+import { Filter, ObjectId } from 'mongodb';
+import { History } from '@lilaquadrat/interfaces';
+export interface HistorySeenKey {
+    user: string;
+    company: string;
+    project?: string;
+    model: string;
+    scope: string;
+}
+declare class HistorySeenService {
+    /** bounds the cost of counting a long unseen history, callers display anything at the limit as "limit+" */
+    readonly countLimit = 100;
+    /**
+     * restricts the history to the watched scope. tenant and model keys are applied last
+     * so a caller supplied filter can never widen the query beyond the key.
+     */
+    private historyFilter;
+    private markerKey;
+    /**
+     * number of history entries newer than the marker of the user, up to countLimit.
+     * entries written by the user themselves are not news to them. without a marker everything is unread.
+     */
+    unreadCount(key: HistorySeenKey, scopeFilter: Filter<History>): Promise<number>;
+    /**
+     * moves the marker to the newest history entry that exists right now. resolved on the server so
+     * entries written between loading the screen and calling this are not marked as seen by accident.
+     * the marker only ever moves forward.
+     */
+    markSeen(key: HistorySeenKey, scopeFilter: Filter<History>): Promise<ObjectId | null>;
+}
+declare const _default: HistorySeenService;
+export default _default;

package/lib/src/services/historySeen.service.js

@@ -0,0 +1,66 @@
+import HistoryModel from '../models/history.model.js';
+import HistorySeenModel from '../models/historySeen.model.js';
+class HistorySeenService {
+    constructor() {
+        /** bounds the cost of counting a long unseen history, callers display anything at the limit as "limit+" */
+        this.countLimit = 100;
+    }
+    /**
+     * restricts the history to the watched scope. tenant and model keys are applied last
+     * so a caller supplied filter can never widen the query beyond the key.
+     */
+    historyFilter(key, scopeFilter) {
+        const filter = {
+            ...scopeFilter,
+            company: key.company,
+            'history.model': key.model,
+        };
+        if (key.project)
+            filter.project = key.project;
+        return filter;
+    }
+    markerKey(key) {
+        const markerKey = {
+            user: key.user,
+            company: key.company,
+            model: key.model,
+            scope: key.scope,
+        };
+        if (key.project)
+            markerKey.project = key.project;
+        return markerKey;
+    }
+    /**
+     * number of history entries newer than the marker of the user, up to countLimit.
+     * entries written by the user themselves are not news to them. without a marker everything is unread.
+     */
+    async unreadCount(key, scopeFilter) {
+        const marker = await HistorySeenModel.db.findOne(this.markerKey(key), { projection: { lastSeenId: 1 } });
+        const filter = this.historyFilter(key, scopeFilter);
+        filter['history.user'] = { $ne: key.user };
+        if (marker?.lastSeenId)
+            filter._id = { $gt: marker.lastSeenId };
+        return HistoryModel.db.countDocuments(filter, { limit: this.countLimit });
+    }
+    /**
+     * moves the marker to the newest history entry that exists right now. resolved on the server so
+     * entries written between loading the screen and calling this are not marked as seen by accident.
+     * the marker only ever moves forward.
+     */
+    async markSeen(key, scopeFilter) {
+        const [newest] = await HistoryModel.db
+            .find(this.historyFilter(key, scopeFilter), { projection: { _id: 1 } })
+            .sort({ _id: -1 })
+            .limit(1)
+            .toArray();
+        if (!newest)
+            return null;
+        await HistorySeenModel.db.updateOne(this.markerKey(key), {
+            $max: { lastSeenId: newest._id },
+            $set: { seenAt: new Date() },
+        }, { upsert: true });
+        return newest._id;
+    }
+}
+export default new HistorySeenService();
+//# sourceMappingURL=historySeen.service.js.map

package/lib/src/services/historySeen.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"historySeen.service.js","sourceRoot":"","sources":["../../../src/services/historySeen.service.ts"],"names":[],"mappings":"AAEA,OAAO,YAAY,MAAM,4BAA4B,CAAC;AACtD,OAAO,gBAAgB,MAAM,gCAAgC,CAAC;AAU9D,MAAM,kBAAkB;IAAxB;QAEE,2GAA2G;QAClG,eAAU,GAAG,GAAG,CAAC;IAgF5B,CAAC;IA9EC;;;OAGG;IACK,aAAa,CAAC,GAAmB,EAAE,WAA4B;QAErE,MAAM,MAAM,GAAoB;YAC9B,GAAG,WAAW;YACd,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,eAAe,EAAE,GAAG,CAAC,KAAK;SAC3B,CAAC;QAEF,IAAI,GAAG,CAAC,OAAO;YAAE,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAE9C,OAAO,MAAM,CAAC;IAEhB,CAAC;IAEO,SAAS,CAAC,GAAmB;QAEnC,MAAM,SAAS,GAAwB;YACrC,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,KAAK,EAAE,GAAG,CAAC,KAAK;SACjB,CAAC;QAEF,IAAI,GAAG,CAAC,OAAO;YAAE,SAAS,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAEjD,OAAO,SAAS,CAAC;IAEnB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CAAC,GAAmB,EAAE,WAA4B;QAEjE,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACzG,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAEpD,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;QAE3C,IAAI,MAAM,EAAE,UAAU;YAAE,MAAM,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;QAEhE,OAAO,YAAY,CAAC,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAE5E,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CAAC,GAAmB,EAAE,WAA4B;QAE9D,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,YAAY,CAAC,EAAE;aACnC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;aACtE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;aACjB,KAAK,CAAC,CAAC,CAAC;aACR,OAAO,EAAE,CAAC;QAEb,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,MAAM,gBAAgB,CAAC,EAAE,CAAC,SAAS,CACjC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EACnB;YACE,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,GAAG,EAAE;YAChC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,IAAI,EAAE,EAAE;SAC7B,EACD,EAAE,MAAM,EAAE,IAAI,EAAE,CACjB,CAAC;QAEF,OAAO,MAAM,CAAC,GAAG,CAAC;IAEpB,CAAC;CAEF;AAED,eAAe,IAAI,kBAAkB,EAAE,CAAC"}

package/lib/src/services/listParticipants.service.d.ts

@@ -1,9 +1,25 @@
-import { ObjectId, UnorderedBulkOperation, WithId } from 'mongodb';
+import { ObjectId, UnorderedBulkOperation, UpdateResult, WithId } from 'mongodb';
 import Immutable from '../Immutable.class.js';
-import { Agreement, AgreementResponse, BasicData, CustomerPersonWithEmail, EmailsContent, History, HistoryReason, HistoryWithType, List, ListParticipants, ListParticipantWithCustomerAndPayment, ObjectIdString, Options, SkipLimitSort, UserAppWithOptions } from '@lilaquadrat/interfaces';
+import { Agreement, AgreementResponse, BasicData, CustomerPersonWithEmail, EmailsContent, History, HistoryReason, HistoryWithType, List, ListParticipants, ListParticipantWithCustomerAndPayment, ObjectIdString, Options, SkipLimitSort, Structure, StructureCondition, UserAppWithOptions } from '@lilaquadrat/interfaces';
 import { ValidateFunction } from 'ajv';
 export declare class ListParticipantsService extends Immutable<ListParticipants> {
     model: import("../classes/modelv2.class.js").default<ListParticipants, string>;
+    singleForPlanning(list: ObjectId, participant: ObjectId, options: Required<UserAppWithOptions>): Promise<WithId<ListParticipants> | null>;
+    /** Reports retain unavailable entries; the scheduling layer applies eligibility only to new assignments. */
+    participantsForPlanning(participants: ObjectId[], company: string): Promise<WithId<ListParticipants>[]>;
+    /** Attaches each participant's answers, their list definitions and the customer's to the entry. */
+    private resolveParticipantDetails;
+    /** Same entries as participantsForPlanning, resolved with their structure answers and definitions for reporting. */
+    participantsForPlanningWithDetails(participants: ObjectId[], company: string): Promise<ListParticipantWithCustomerAndPayment[]>;
+    /**
+     * Candidates for a list, resolved and scored against a shift's conditions, ordered best-first.
+     * The ordering happens here so pagination ranks the whole candidate set instead of a single page.
+     */
+    planningParticipants(list: ObjectId, conditions: StructureCondition[] | undefined, categories: ObjectId[] | undefined, state: ListParticipants['state'][] | undefined, search: string | undefined, options: Required<UserAppWithOptions> & SkipLimitSort): Promise<{
+        all: number;
+        data: ListParticipantWithCustomerAndPayment[];
+        count: number;
+    }>;
     customerLookup: ({
         $lookup: {
             from: string;
@@ -11,7 +27,78 @@ export declare class ListParticipantsService extends Immutable<ListParticipants>
             let: {
                 userid: string;
             };
-            pipeline: {
+            pipeline: ({
+                $addFields: {
+                    structureIds: {
+                        $reduce: {
+                            input: {
+                                $objectToArray: string;
+                            };
+                            initialValue: never[];
+                            in: {
+                                $cond: {
+                                    if: {
+                                        $eq: (string | {
+                                            $substrCP: (string | number)[];
+                                        })[];
+                                    };
+                                    then: {
+                                        $concatArrays: (string | string[])[];
+                                    };
+                                    else: string;
+                                };
+                            };
+                        };
+                    };
+                };
+                $lookup?: undefined;
+                $project?: undefined;
+            } | {
+                $lookup: {
+                    from: string;
+                    let: {
+                        structureIds: string;
+                        company: string;
+                        project: string;
+                    };
+                    pipeline: ({
+                        $match: {
+                            $expr: {
+                                $and: ({
+                                    $eq: (string | {
+                                        $type: string;
+                                    })[];
+                                    $in?: undefined;
+                                } | {
+                                    $in: string[];
+                                    $eq?: undefined;
+                                })[];
+                            };
+                        };
+                        $project?: undefined;
+                    } | {
+                        $project: {
+                            _id: number;
+                            id: number;
+                            type: number;
+                            question: number;
+                            description: number;
+                            options: number;
+                            multiple: number;
+                        };
+                        $match?: undefined;
+                    })[];
+                    as: string;
+                };
+                $addFields?: undefined;
+                $project?: undefined;
+            } | {
+                $project: {
+                    structureIds: number;
+                };
+                $addFields?: undefined;
+                $lookup?: undefined;
+            } | {
                 $match: {
                     $and: {
                         $expr: {
@@ -19,7 +106,7 @@ export declare class ListParticipantsService extends Immutable<ListParticipants>
                         };
                     }[];
                 };
-            }[];
+            })[];
         };
         $unwind?: undefined;
         $addFields?: undefined;
@@ -35,12 +122,46 @@ export declare class ListParticipantsService extends Immutable<ListParticipants>
     } | {
         $addFields: {
             user: {
-                name: {
-                    $concat: string[];
-                };
-                email: string;
-                id: string;
-                _id: string;
+                $mergeObjects: ({
+                    name: {
+                        $concat: string[];
+                    };
+                    email: string;
+                    id: string;
+                    _id: string;
+                    $arrayToObject?: undefined;
+                    structures?: undefined;
+                } | {
+                    $arrayToObject: {
+                        $filter: {
+                            input: {
+                                $objectToArray: {
+                                    $ifNull: {}[];
+                                };
+                            };
+                            as: string;
+                            cond: {
+                                $eq: (string | {
+                                    $substrCP: (string | number)[];
+                                })[];
+                            };
+                        };
+                    };
+                    name?: undefined;
+                    email?: undefined;
+                    id?: undefined;
+                    _id?: undefined;
+                    structures?: undefined;
+                } | {
+                    structures: {
+                        $ifNull: (string | never[])[];
+                    };
+                    name?: undefined;
+                    email?: undefined;
+                    id?: undefined;
+                    _id?: undefined;
+                    $arrayToObject?: undefined;
+                })[];
             };
         };
         $lookup?: undefined;
@@ -157,7 +278,7 @@ export declare class ListParticipantsService extends Immutable<ListParticipants>
      * get state of the provided account for this list
      */
     stateForAccount(list: ObjectId, account: string, options: Required<UserAppWithOptions>): Promise<ListParticipants>;
-    updateAfterCheck(useful: boolean, explanation: string | undefined, partiticpantInternalId: ObjectId, listInternalId: ObjectId, options: Required<UserAppWithOptions>): Promise<import("mongodb").UpdateResult<import("bson").Document>>;
+    updateAfterCheck(useful: boolean, explanation: string | undefined, partiticpantInternalId: ObjectId, listInternalId: ObjectId, options: Required<UserAppWithOptions>): Promise<UpdateResult<import("bson").Document>>;
     private getValidatorForStructures;
     createParticipantsObject(list: ObjectId, mode: List['mode'], user: ObjectId, state: ListParticipants['state'], message: string | undefined, category: string | undefined, payment: ObjectId | undefined, structureInput: Record<string, string | boolean | number> | undefined, agreements: AgreementResponse[], options: Required<UserAppWithOptions>): ListParticipants;
     /**
@@ -210,7 +331,8 @@ export declare class ListParticipantsService extends Immutable<ListParticipants>
      * values are validated against the project's listsParticipants structures, no email is sent.
      */
     membersStructures(list: ObjectId, account: string, structureInput: Record<string, string | boolean | number | string[]>, options: Required<UserAppWithOptions>): Promise<WithId<ListParticipants> | null>;
-    note(list: ObjectId, participationId: ObjectId, note: ListParticipants['note'] | undefined, options: Required<UserAppWithOptions>): Promise<import("mongodb").UpdateResult<import("bson").Document>>;
+    updateStructures(list: ObjectId, participationId: ObjectId, structures: Record<string, string | boolean | number | string[]>, options: Required<UserAppWithOptions>): Promise<UpdateResult>;
+    note(list: ObjectId, participationId: ObjectId, note: ListParticipants['note'] | undefined, options: Required<UserAppWithOptions>): Promise<UpdateResult<import("bson").Document>>;
     participantInList(list: ObjectId, user: ObjectId, options: Required<UserAppWithOptions>): Promise<boolean>;
     singleWithoutLookup(list: ObjectId, user: ObjectId, options: Required<UserAppWithOptions>): Promise<WithId<ListParticipants> | null>;
     viaPayment(listId: ObjectId, paymentId: ObjectId, options: Required<UserAppWithOptions>): Promise<ListParticipantWithCustomerAndPayment>;
@@ -230,6 +352,15 @@ export declare class ListParticipantsService extends Immutable<ListParticipants>
         data: HistoryWithType<ListParticipants>[];
         count: number;
     }>;
+    /** a history entry of this list and the version before it, with the structures that name the custom fields */
+    historyEntry(list: ObjectId, historyId: ObjectId, options: Required<UserAppWithOptions>): Promise<{
+        structures: WithId<Structure>[];
+        current: WithId<History>;
+        previous: WithId<History> | null;
+    } | null>;
+    private historySeenKey;
+    historyUnreadCount(list: ObjectId, options: Required<UserAppWithOptions>): Promise<number>;
+    markHistorySeen(list: ObjectId, options: Required<UserAppWithOptions>): Promise<ObjectId | null>;
     agreementsMissing(listAgreements: Agreement[], providedAgreements: AgreementResponse[]): string[];
     listParticipants(list: ObjectId, state: ListParticipants['state'][] | undefined, category: string[] | undefined, lastname: string | undefined, options: UserAppWithOptions & SkipLimitSort): Promise<{
         all: number;