@lilaquadrat/studio 12.0.0 → 12.2.0

package/lib/src/helpers/shiftPlanningSchemas.d.ts

@@ -0,0 +1,143 @@
+import type { SchemaObject } from 'ajv';
+export declare const objectSchema: (properties: Record<string, SchemaObject>, required?: string[]) => SchemaObject;
+export declare const objectIdSchema: SchemaObject;
+export declare const instantSchema: SchemaObject;
+/** `enabled` is omitted by clients when false, so it must never be required; omission means false. */
+export declare const policyProperties: {
+    daytime: SchemaObject;
+    nighttime: SchemaObject;
+    maximumConsecutiveWorkingDays: SchemaObject;
+    maximumDailyWorkMinutes: SchemaObject;
+    minimumRest: SchemaObject;
+    breaks: SchemaObject;
+    absenceEnforcement: {
+        type: string;
+    };
+};
+export declare const policySchema: SchemaObject;
+export declare const structureConditionProperties: {
+    structure: SchemaObject;
+    constraint: {
+        enum: string[];
+    };
+    grade: {
+        enum: string[];
+    };
+    operator: {
+        enum: string[];
+    };
+    value: {
+        anyOf: ({
+            type: string;
+            maxLength: number;
+        } | {
+            type: string;
+            maxLength?: undefined;
+        })[];
+    };
+};
+export declare const structureConditionSchema: SchemaObject;
+export declare const areaProperties: {
+    id: SchemaObject;
+    name: SchemaObject;
+    description: SchemaObject;
+    location: SchemaObject;
+    address: SchemaObject;
+    structures: SchemaObject;
+};
+export declare const planningDateSchema: SchemaObject;
+export declare const dayAreaProperties: {
+    area: SchemaObject;
+};
+export declare const dayProperties: {
+    date: SchemaObject;
+    name: SchemaObject;
+    areas: {
+        type: string;
+        maxItems: number;
+        items: SchemaObject;
+    };
+};
+export declare const planWorkAreaProperties: {
+    area: SchemaObject;
+    categoryIds: {
+        type: string;
+        maxItems: number;
+        items: SchemaObject;
+    };
+};
+export declare const workAreaCategoriesSchema: SchemaObject;
+/** Same states the list participant views offer; `unchecked` is stored but not offered by the UI. */
+export declare const participantStates: string[];
+export declare const participantStateSchema: SchemaObject;
+export declare const workHoursSchema: SchemaObject;
+export declare const planProperties: {
+    name: SchemaObject;
+    timeZone: SchemaObject;
+    settingsOverrides: SchemaObject;
+    workAreaCategories: SchemaObject;
+    defaultParticipantState: {
+        anyOf: SchemaObject[];
+    };
+    workHours: SchemaObject;
+};
+export declare const planInputProperties: {
+    list: SchemaObject;
+    name: SchemaObject;
+    timeZone: SchemaObject;
+    settingsOverrides: SchemaObject;
+    workAreaCategories: SchemaObject;
+    defaultParticipantState: {
+        anyOf: SchemaObject[];
+    };
+    workHours: SchemaObject;
+};
+export declare const scopeProperties: {
+    company: SchemaObject;
+    project: SchemaObject;
+    list: SchemaObject;
+};
+export declare const shiftProperties: {
+    area: SchemaObject;
+    day: SchemaObject;
+    title: SchemaObject;
+    start: SchemaObject;
+    end: SchemaObject;
+};
+export declare const shiftStaffingProperties: {
+    structures: SchemaObject;
+    requiredPeople: SchemaObject;
+    matchingPeople: SchemaObject;
+};
+export declare const breakSchema: SchemaObject;
+export declare const assignmentProperties: {
+    participant: SchemaObject;
+    breaks: {
+        type: string;
+        maxItems: number;
+        items: SchemaObject;
+    };
+};
+export declare const assignmentInputSchema: {
+    type: string;
+    maxItems: number;
+    items: SchemaObject;
+};
+export declare const assignmentSchema: {
+    type: string;
+    maxItems: number;
+    items: SchemaObject;
+};
+export declare const absenceProperties: {
+    customer: SchemaObject;
+    type: {
+        enum: string[];
+    };
+    start: SchemaObject;
+    end: SchemaObject;
+};
+export declare const filterProperties: {
+    from: SchemaObject;
+    to: SchemaObject;
+    site: SchemaObject;
+};

package/lib/src/helpers/shiftPlanningSchemas.js

@@ -0,0 +1,87 @@
+export const objectSchema = (properties, required = Object.keys(properties)) => ({
+    type: 'object', properties, required, additionalProperties: false,
+});
+const text = (maxLength, minLength = 0) => ({ type: 'string', minLength, maxLength });
+const integer = (minimum, maximum) => ({ type: 'integer', minimum, maximum });
+export const objectIdSchema = { shiftPlanningObjectId: true };
+export const instantSchema = {
+    type: 'string', format: 'date-time', maxLength: 40,
+    pattern: '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?(?:Z|[+-]\\d{2}:\\d{2})$',
+};
+const clockSchema = { type: 'string', pattern: '^(?:[01]\\d|2[0-3]):[0-5]\\d$' };
+const clockPeriod = objectSchema({ start: clockSchema, end: clockSchema });
+/** `enabled` is omitted by clients when false, so it must never be required; omission means false. */
+export const policyProperties = {
+    daytime: clockPeriod,
+    nighttime: clockPeriod,
+    maximumConsecutiveWorkingDays: objectSchema({ enabled: { type: 'boolean' }, days: integer(1, 366) }, ['days']),
+    maximumDailyWorkMinutes: objectSchema({ enabled: { type: 'boolean' }, minutes: integer(1, 1440) }, ['minutes']),
+    minimumRest: objectSchema({ enabled: { type: 'boolean' }, minutes: integer(0, 10080) }, []),
+    breaks: objectSchema({
+        enabled: { type: 'boolean' }, maximumContinuousWorkMinutes: integer(1, 10080),
+        minimumQualifyingBreakMinutes: integer(1, 1440),
+        requirements: { type: 'array', maxItems: 10, items: objectSchema({
+                afterWorkMinutes: integer(1, 10080), minimumTotalBreakMinutes: integer(1, 1440),
+            }) },
+    }, ['maximumContinuousWorkMinutes', 'minimumQualifyingBreakMinutes', 'requirements']),
+    absenceEnforcement: { type: 'boolean' },
+};
+export const policySchema = objectSchema(policyProperties, Object.keys(policyProperties).filter((key) => key !== 'absenceEnforcement'));
+const addressProperties = Object.fromEntries(['street', 'streetNumber', 'zipcode', 'city', 'country_name', 'addressAddition'].map((key) => [key, text(250)]));
+addressProperties.country = { type: 'string', pattern: '^[A-Za-z]{2}$' };
+addressProperties.osm_id = { type: 'number' };
+export const structureConditionProperties = {
+    structure: text(24, 1),
+    constraint: { enum: ['required', 'forbidden'] },
+    grade: { enum: ['very-positive', 'positive', 'negative', 'very-negative'] },
+    operator: { enum: ['lt', 'lte', 'eq', 'gt', 'gte'] },
+    value: { anyOf: [{ type: 'string', maxLength: 250 }, { type: 'number' }, { type: 'boolean' }] },
+};
+export const structureConditionSchema = objectSchema(structureConditionProperties, ['structure']);
+const structuresSchema = { type: 'array', maxItems: 100, items: structureConditionSchema };
+export const areaProperties = {
+    id: text(100, 1), name: text(100, 1), description: text(2500), location: text(250), address: objectSchema(addressProperties, []),
+    structures: structuresSchema,
+};
+export const planningDateSchema = { type: 'string', format: 'date', pattern: '^\\d{4}-\\d{2}-\\d{2}$' };
+export const dayAreaProperties = { area: objectIdSchema };
+export const dayProperties = {
+    date: planningDateSchema,
+    name: text(100, 1),
+    areas: { type: 'array', maxItems: 100, items: objectSchema(dayAreaProperties, ['area']) },
+};
+export const planWorkAreaProperties = { area: objectIdSchema, categoryIds: { type: 'array', maxItems: 10, items: objectIdSchema } };
+export const workAreaCategoriesSchema = { type: 'array', maxItems: 200, items: objectSchema(planWorkAreaProperties, ['area']) };
+/** Same states the list participant views offer; `unchecked` is stored but not offered by the UI. */
+export const participantStates = ['unchecked', 'paid', 'notuseful', 'confirmed', 'enlisted', 'reserved', 'waiting', 'blocked', 'finalized', 'canceled'];
+export const participantStateSchema = { enum: participantStates };
+export const workHoursSchema = objectSchema({ start: integer(0, 23), end: integer(1, 24) });
+export const planProperties = {
+    name: text(100, 1), timeZone: text(100, 1),
+    settingsOverrides: objectSchema(policyProperties, []),
+    workAreaCategories: workAreaCategoriesSchema,
+    defaultParticipantState: { anyOf: [participantStateSchema, { type: 'null' }] },
+    workHours: workHoursSchema,
+};
+export const planInputProperties = { ...planProperties, list: objectIdSchema };
+export const scopeProperties = { company: text(200, 1), project: text(200, 1), list: objectIdSchema };
+export const shiftProperties = {
+    area: objectIdSchema,
+    day: objectIdSchema,
+    title: text(100, 1), start: instantSchema, end: instantSchema,
+};
+export const shiftStaffingProperties = {
+    structures: structuresSchema,
+    requiredPeople: integer(0, 1000),
+    matchingPeople: integer(0, 1000),
+};
+export const breakSchema = objectSchema({ start: instantSchema, end: instantSchema });
+export const assignmentProperties = {
+    participant: objectIdSchema,
+    breaks: { type: 'array', maxItems: 20, items: breakSchema },
+};
+export const assignmentInputSchema = { type: 'array', maxItems: 100, items: objectSchema(assignmentProperties, ['participant']) };
+export const assignmentSchema = { type: 'array', maxItems: 100, items: objectSchema({ ...assignmentProperties, customer: objectIdSchema }) };
+export const absenceProperties = { customer: objectIdSchema, type: { enum: ['vacation', 'sickness'] }, start: instantSchema, end: instantSchema };
+export const filterProperties = { from: instantSchema, to: instantSchema, site: integer(1, Number.MAX_SAFE_INTEGER) };
+//# sourceMappingURL=shiftPlanningSchemas.js.map

package/lib/src/helpers/shiftPlanningSchemas.js.map

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

package/lib/src/helpers/shiftPlanningTime.d.ts

@@ -0,0 +1,24 @@
+import type { Shift, ShiftAssignment, ShiftPlanningPolicy, ShiftPlanningPolicyOverrides, ShiftWorkingTime } from '@lilaquadrat/interfaces';
+export declare const minuteMilliseconds = 60000;
+export declare const maximumShiftMilliseconds: number;
+export declare function planningValidation(path: string, message: string): never;
+export declare function normalizeInstant(value: string): string;
+export declare function normalizeDate(value: string): string;
+export declare function interval(start: string, end: string): {
+    start: string;
+    end: string;
+};
+export declare function localFormatter(timeZone: string): Intl.DateTimeFormat;
+export declare function localDate(instant: string, timeZone: string): string;
+export declare function previousDate(date: string): string;
+export declare function validatePolicy(policy?: ShiftPlanningPolicyOverrides): void;
+export declare function effectivePolicy(company: ShiftPlanningPolicy | undefined, overrides: ShiftPlanningPolicyOverrides): ShiftPlanningPolicy | null;
+export declare function normalizeBreaks(shift: Pick<Shift, 'start' | 'end'>, assignment: ShiftAssignment): ShiftAssignment;
+export declare function workSegments(shift: Pick<Shift, 'start' | 'end'>, assignment: ShiftAssignment): Array<[number, number]>;
+/** Local clock boundaries classify work, while UTC elapsed minutes prevent DST from inventing or losing time. */
+export declare function calculateWorkingTime(shift: Shift, assignment: ShiftAssignment, timeZone: string, policy: ShiftPlanningPolicy): ShiftWorkingTime;
+export declare function workedDates(shift: Shift, assignment: ShiftAssignment, timeZone: string): Set<string>;
+/** Break-excluded work minutes keyed by local calendar date; UTC stepping keeps DST from inventing or losing time. */
+export declare function workedMinutesByDate(shift: Shift, assignment: ShiftAssignment, timeZone: string): Map<string, number>;
+/** Short interruptions reduce net work, but cannot satisfy break rights or reset uninterrupted working time. */
+export declare function breakViolation(shift: Shift, assignment: ShiftAssignment, policy: ShiftPlanningPolicy): boolean;

package/lib/src/helpers/shiftPlanningTime.js

@@ -0,0 +1,191 @@
+import ImmutableError from '../classes/errors/Immutable.error.js';
+export const minuteMilliseconds = 60000;
+export const maximumShiftMilliseconds = 7 * 24 * 60 * minuteMilliseconds;
+export function planningValidation(path, message) {
+    throw new ImmutableError('VALIDATION_FAILED', [{
+            instancePath: path, schemaPath: '#/shiftPlanning', keyword: 'shiftPlanning', params: {}, message,
+        }]);
+}
+export function normalizeInstant(value) {
+    const instant = Date.parse(value);
+    if (!Number.isFinite(instant))
+        planningValidation('', 'must be a valid instant');
+    const normalized = new Date(instant).toISOString();
+    if (!/^\d{4}-/.test(normalized))
+        planningValidation('', 'must normalize to a four-digit ISO year');
+    return normalized;
+}
+export function normalizeDate(value) {
+    const instant = new Date(`${value}T00:00:00Z`);
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(value) || Number.isNaN(instant.getTime())
+        || instant.toISOString().slice(0, 10) !== value)
+        planningValidation('/date', 'must be a valid date');
+    return value;
+}
+export function interval(start, end) {
+    const result = { start: normalizeInstant(start), end: normalizeInstant(end) };
+    if (result.end <= result.start)
+        planningValidation('/end', 'must be after start');
+    return result;
+}
+export function localFormatter(timeZone) {
+    try {
+        return new Intl.DateTimeFormat('en-GB', {
+            timeZone, year: 'numeric', month: '2-digit', day: '2-digit',
+            hour: '2-digit', minute: '2-digit', hourCycle: 'h23',
+        });
+    }
+    catch {
+        return planningValidation('/timeZone', 'must be a valid IANA time zone');
+    }
+}
+function localParts(formatter, instant) {
+    const parts = Object.fromEntries(formatter.formatToParts(instant).map((part) => [part.type, part.value]));
+    return { date: `${parts.year.padStart(4, '0')}-${parts.month}-${parts.day}`, clock: `${parts.hour}:${parts.minute}` };
+}
+export function localDate(instant, timeZone) {
+    return localParts(localFormatter(timeZone), Date.parse(instant)).date;
+}
+export function previousDate(date) {
+    const instant = new Date(`${date}T12:00:00Z`);
+    instant.setUTCDate(instant.getUTCDate() - 1);
+    return instant.toISOString().slice(0, 10);
+}
+export function validatePolicy(policy = {}) {
+    if (policy.daytime && policy.nighttime) {
+        if (policy.daytime.start === policy.daytime.end
+            || policy.daytime.start !== policy.nighttime.end || policy.daytime.end !== policy.nighttime.start) {
+            planningValidation('/settings', 'daytime and nighttime must partition the day');
+        }
+    }
+    if (policy.breaks) {
+        if (policy.breaks.enabled && !policy.breaks.requirements.length) {
+            planningValidation('/settings/breaks/requirements', 'enabled break rules require thresholds');
+        }
+        let previousWork = 0;
+        let previousBreak = 0;
+        for (const requirement of policy.breaks.requirements) {
+            if (requirement.afterWorkMinutes <= previousWork || requirement.minimumTotalBreakMinutes < previousBreak) {
+                planningValidation('/settings/breaks/requirements', 'thresholds must increase and required breaks must not decrease');
+            }
+            previousWork = requirement.afterWorkMinutes;
+            previousBreak = requirement.minimumTotalBreakMinutes;
+        }
+    }
+}
+export function effectivePolicy(company, overrides) {
+    // Whole groups replace defaults, including false; null signals setup/attention rather than silently disabling rules.
+    const result = { ...company, ...overrides };
+    if (!result.daytime || !result.nighttime || !result.maximumConsecutiveWorkingDays
+        || !result.maximumDailyWorkMinutes || !result.minimumRest || !result.breaks)
+        return null;
+    // Two individually valid groups may be incompatible after inheritance.
+    try {
+        validatePolicy(result);
+    }
+    catch {
+        return null;
+    }
+    // Booleans are omitted when false, so a missing flag is false.
+    return { ...result, absenceEnforcement: result.absenceEnforcement === true };
+}
+export function normalizeBreaks(shift, assignment) {
+    let previousEnd = shift.start;
+    const breaks = assignment.breaks.map((entry) => {
+        const normalized = interval(entry.start, entry.end);
+        if (normalized.start < previousEnd || normalized.end > shift.end) {
+            planningValidation('/assignments/breaks', 'breaks must be ordered, non-overlapping and inside the shift');
+        }
+        previousEnd = normalized.end;
+        return normalized;
+    });
+    return { ...assignment, breaks };
+}
+export function workSegments(shift, assignment) {
+    const segments = [];
+    let cursor = Date.parse(shift.start);
+    for (const entry of assignment.breaks) {
+        const start = Date.parse(entry.start);
+        if (start > cursor)
+            segments.push([cursor, start]);
+        cursor = Date.parse(entry.end);
+    }
+    if (cursor < Date.parse(shift.end))
+        segments.push([cursor, Date.parse(shift.end)]);
+    return segments;
+}
+/** Local clock boundaries classify work, while UTC elapsed minutes prevent DST from inventing or losing time. */
+export function calculateWorkingTime(shift, assignment, timeZone, policy) {
+    const formatter = localFormatter(timeZone);
+    const workingTime = {
+        customer: assignment.customer.toHexString(), daytimeMinutes: 0, nighttimeMinutes: 0,
+        breakMinutes: assignment.breaks.reduce((total, entry) => total + (Date.parse(entry.end) - Date.parse(entry.start)) / minuteMilliseconds, 0),
+    };
+    const daytime = policy.daytime;
+    for (const [start, end] of workSegments(shift, assignment)) {
+        let cursor = start;
+        // Real UTC minutes keep classification correct through both skipped and repeated DST hours.
+        while (cursor < end) {
+            const next = Math.min(end, (Math.floor(cursor / minuteMilliseconds) + 1) * minuteMilliseconds);
+            const local = localParts(formatter, cursor);
+            const isDaytime = daytime.start < daytime.end
+                ? local.clock >= daytime.start && local.clock < daytime.end
+                : local.clock >= daytime.start || local.clock < daytime.end;
+            workingTime[isDaytime ? 'daytimeMinutes' : 'nighttimeMinutes'] += (next - cursor) / minuteMilliseconds;
+            cursor = next;
+        }
+    }
+    return workingTime;
+}
+export function workedDates(shift, assignment, timeZone) {
+    const formatter = localFormatter(timeZone);
+    const result = new Set();
+    for (const [start, end] of workSegments(shift, assignment)) {
+        // A six-hour step cannot skip a calendar date, including across timezone transitions.
+        for (let cursor = start; cursor < end; cursor += 6 * 60 * minuteMilliseconds) {
+            result.add(localParts(formatter, cursor).date);
+        }
+        result.add(localParts(formatter, end - 1).date);
+    }
+    return result;
+}
+/** Break-excluded work minutes keyed by local calendar date; UTC stepping keeps DST from inventing or losing time. */
+export function workedMinutesByDate(shift, assignment, timeZone) {
+    const formatter = localFormatter(timeZone);
+    const result = new Map();
+    for (const [start, end] of workSegments(shift, assignment)) {
+        for (let cursor = start; cursor < end; cursor += minuteMilliseconds) {
+            const next = Math.min(end, cursor + minuteMilliseconds);
+            const date = localParts(formatter, cursor).date;
+            result.set(date, (result.get(date) ?? 0) + (next - cursor) / minuteMilliseconds);
+        }
+    }
+    return result;
+}
+/** Short interruptions reduce net work, but cannot satisfy break rights or reset uninterrupted working time. */
+export function breakViolation(shift, assignment, policy) {
+    if (!policy.breaks.enabled)
+        return false;
+    const requirements = policy.breaks;
+    let cursor = Date.parse(shift.start);
+    let continuous = 0;
+    let maximumContinuous = 0;
+    let qualifyingBreaks = 0;
+    let allBreaks = 0;
+    for (const entry of assignment.breaks) {
+        continuous += (Date.parse(entry.start) - cursor) / minuteMilliseconds;
+        maximumContinuous = Math.max(maximumContinuous, continuous);
+        const duration = (Date.parse(entry.end) - Date.parse(entry.start)) / minuteMilliseconds;
+        allBreaks += duration;
+        if (duration >= requirements.minimumQualifyingBreakMinutes) {
+            qualifyingBreaks += duration;
+            continuous = 0;
+        }
+        cursor = Date.parse(entry.end);
+    }
+    maximumContinuous = Math.max(maximumContinuous, continuous + (Date.parse(shift.end) - cursor) / minuteMilliseconds);
+    const worked = (Date.parse(shift.end) - Date.parse(shift.start)) / minuteMilliseconds - allBreaks;
+    return maximumContinuous > requirements.maximumContinuousWorkMinutes
+        || requirements.requirements.some((entry) => worked > entry.afterWorkMinutes && qualifyingBreaks < entry.minimumTotalBreakMinutes);
+}
+//# sourceMappingURL=shiftPlanningTime.js.map

package/lib/src/helpers/shiftPlanningTime.js.map

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

package/lib/src/helpers/shiftPlanningValidation.d.ts

@@ -0,0 +1,26 @@
+import { Filter } from 'mongodb';
+import type { ShiftAssignment, ShiftAssignmentBreak, ShiftPlanningPage, ShiftPlanningViolation } from '@lilaquadrat/interfaces';
+export declare const planningLimit = 30;
+export declare function assertUniquePlanningIds(values: string[], path: string): void;
+export declare function equalBreaks(left: ShiftAssignmentBreak[], right: ShiftAssignmentBreak[]): boolean;
+export declare function equalAssignment(left: ShiftAssignment, right: ShiftAssignment): boolean;
+/** Input ordering is presentation only; an identical employee allocation must not create audit noise. */
+export declare function equalAssignmentSets(left: ShiftAssignment[], right: ShiftAssignment[]): boolean;
+/** These identity fields are fixed enums/hex IDs; severity and object property order are deliberately excluded. */
+export declare function violationIdentity(violation: ShiftPlanningViolation): string;
+export declare function planningIntervalFilter<T extends {
+    start: string;
+    end: string;
+}>(filters: {
+    from?: string;
+    to?: string;
+}): Filter<T>;
+export declare function planningPagination(filters: {
+    site?: number;
+}): {
+    site: number;
+    limit: number;
+    skip: number;
+};
+export declare function planningSearch(search: string | undefined): string | undefined;
+export declare function planningPage<T>(data: T[], all: number, site: number, limit?: number): ShiftPlanningPage<T>;

package/lib/src/helpers/shiftPlanningValidation.js

@@ -0,0 +1,53 @@
+import ControllerHelper from './ControllerHelper.js';
+import { interval, normalizeInstant, planningValidation } from './shiftPlanningTime.js';
+export const planningLimit = 30;
+export function assertUniquePlanningIds(values, path) {
+    if (new Set(values).size !== values.length)
+        planningValidation(path, 'identities must be unique');
+}
+export function equalBreaks(left, right) {
+    return left.length === right.length && left.every((entry, index) => entry.start === right[index].start && entry.end === right[index].end);
+}
+export function equalAssignment(left, right) {
+    return left.participant.equals(right.participant) && left.customer.equals(right.customer)
+        && equalBreaks(left.breaks, right.breaks);
+}
+/** Input ordering is presentation only; an identical employee allocation must not create audit noise. */
+export function equalAssignmentSets(left, right) {
+    const byParticipant = new Map(right.map((entry) => [entry.participant.toHexString(), entry]));
+    return left.length === right.length && byParticipant.size === right.length
+        && left.every((entry) => {
+            const existing = byParticipant.get(entry.participant.toHexString());
+            return existing !== undefined && equalAssignment(entry, existing);
+        });
+}
+/** These identity fields are fixed enums/hex IDs; severity and object property order are deliberately excluded. */
+export function violationIdentity(violation) {
+    return [violation.customer, violation.shift, violation.rule, violation.relatedShift ?? '', violation.absence ?? ''].join(':');
+}
+export function planningIntervalFilter(filters) {
+    const result = {};
+    if (filters.from)
+        result.end = { $gt: normalizeInstant(filters.from) };
+    if (filters.to)
+        result.start = { $lt: normalizeInstant(filters.to) };
+    if (filters.from && filters.to)
+        interval(filters.from, filters.to);
+    return result;
+}
+export function planningPagination(filters) {
+    const site = filters.site ?? 1;
+    if (!Number.isInteger(site) || site < 1)
+        planningValidation('/site', 'must be a positive integer');
+    const { skip, limit } = ControllerHelper.getLimit(site - 1, planningLimit);
+    return { site, limit, skip };
+}
+export function planningSearch(search) {
+    if (search !== undefined && search.length > 100)
+        planningValidation('/search', 'must be at most 100 characters');
+    return search;
+}
+export function planningPage(data, all, site, limit = planningLimit) {
+    return { data, all, count: data.length, sites: ControllerHelper.getSites(site, limit, all, data.length) };
+}
+//# sourceMappingURL=shiftPlanningValidation.js.map

package/lib/src/helpers/shiftPlanningValidation.js.map

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

package/lib/src/helpers/structureMatch.d.ts

@@ -0,0 +1,15 @@
+import type { ListParticipantMatch, StructureCondition, WithStructures } from '@lilaquadrat/interfaces';
+/** Shift and list participants both carry s-* answers, their own structures and the customer's. */
+export interface ScorableParticipant extends WithStructures {
+    user?: WithStructures;
+}
+/**
+ * A participant's structures carry the resolved definitions they answered with, for both the
+ * list and the customer model. `condition.structure` is a structure `_id`; the answer lives
+ * under the definition's `id` on the participant or, for customer structures, on the user.
+ *
+ * Constraints are checked before grades and only determine the state: a missing required or a
+ * present forbidden marks the participant unfit. The score is computed separately from the
+ * grades alone, starting at zero and clamped to [-10, 10].
+ */
+export declare function structureScore(conditions: StructureCondition[] | undefined, participant: ScorableParticipant): ListParticipantMatch;

package/lib/src/helpers/structureMatch.js

@@ -0,0 +1,70 @@
+function definitionsOf(participant) {
+    const definitions = new Map();
+    const sources = [participant.structures, participant.user?.structures];
+    for (const source of sources) {
+        for (const structure of source ?? []) {
+            if (structure._id !== undefined)
+                definitions.set(structure._id.toString(), structure);
+        }
+    }
+    return definitions;
+}
+/** Bounds of the preference score; grades are their own thing and never affect the constraint state. */
+const SCORE_MIN = -10;
+const SCORE_MAX = 10;
+/** Graded conditions add their weight when met. */
+const gradeWeights = {
+    'very-positive': 2, 'positive': 1, 'negative': -1, 'very-negative': -2,
+};
+/** Number conditions compare the answer against `value`; a non-numeric answer never matches. */
+function numberMet(operator, answer, value) {
+    const left = Number(answer);
+    if (Number.isNaN(left))
+        return false;
+    if (operator === 'lt')
+        return left < value;
+    if (operator === 'lte')
+        return left <= value;
+    if (operator === 'gt')
+        return left > value;
+    if (operator === 'gte')
+        return left >= value;
+    return left === value;
+}
+/**
+ * A participant's structures carry the resolved definitions they answered with, for both the
+ * list and the customer model. `condition.structure` is a structure `_id`; the answer lives
+ * under the definition's `id` on the participant or, for customer structures, on the user.
+ *
+ * Constraints are checked before grades and only determine the state: a missing required or a
+ * present forbidden marks the participant unfit. The score is computed separately from the
+ * grades alone, starting at zero and clamped to [-10, 10].
+ */
+export function structureScore(conditions, participant) {
+    const definitions = definitionsOf(participant);
+    const answers = participant;
+    const userAnswers = participant.user;
+    const total = conditions?.length ?? 0;
+    let state = 'fulfilled';
+    let score = 0;
+    let matched = 0;
+    for (const condition of conditions ?? []) {
+        const structure = definitions.get(condition.structure);
+        const answer = structure === undefined
+            ? undefined
+            : answers[structure.id] !== undefined ? answers[structure.id] : userAnswers?.[structure.id];
+        const met = structure?.type === 'number' && condition.operator !== undefined && typeof condition.value === 'number'
+            ? numberMet(condition.operator, answer, condition.value)
+            : condition.value !== undefined ? answer === condition.value : Boolean(answer);
+        if (met)
+            matched += 1;
+        if (condition.constraint === 'required' && !met)
+            state = 'unfit';
+        else if (condition.constraint === 'forbidden' && met)
+            state = 'unfit';
+        if (condition.grade !== undefined && met)
+            score += gradeWeights[condition.grade];
+    }
+    return { state, score: Math.max(SCORE_MIN, Math.min(SCORE_MAX, score)), matched, total };
+}
+//# sourceMappingURL=structureMatch.js.map