iobroker.time-tracker 0.2.0

package/build/lib/db/repositories/absences.js

@@ -0,0 +1,432 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var absences_exports = {};
+__export(absences_exports, {
+  UnknownAbsenceTypeError: () => UnknownAbsenceTypeError,
+  createAbsencesRepository: () => createAbsencesRepository,
+  mapAbsenceRow: () => mapAbsenceRow,
+  mapAbsenceTypeRow: () => mapAbsenceTypeRow
+});
+module.exports = __toCommonJS(absences_exports);
+var import_time = require("../../util/time");
+var import_errors = require("../../errors");
+var import_audit = require("./audit");
+class UnknownAbsenceTypeError extends Error {
+  /**
+   * Creates the error.
+   *
+   * @param reference - id or code that could not be resolved
+   */
+  constructor(reference) {
+    super(`unknown absence type "${reference}"`);
+    this.reference = reference;
+    this.name = "UnknownAbsenceTypeError";
+  }
+}
+const TYPE_COLUMNS = "id, user_id, code, name, paid, factor, reduce_vacation, is_active";
+const ABSENCE_COLUMNS = `id, user_id, type_id, date_from, date_to, day_portion, hours, status, note,
+	created_at, created_by`;
+const AUDITED_FIELDS = ["typeId", "dateFrom", "dateTo", "dayPortion", "hours", "note"];
+function mapAbsenceTypeRow(row) {
+  return {
+    id: row.id,
+    userId: row.user_id,
+    code: row.code,
+    name: row.name,
+    paid: row.paid !== 0,
+    factor: row.factor,
+    reduceVacation: row.reduce_vacation !== 0,
+    isActive: row.is_active !== 0
+  };
+}
+function mapAbsenceRow(row) {
+  return {
+    id: row.id,
+    userId: row.user_id,
+    typeId: row.type_id,
+    dateFrom: row.date_from,
+    dateTo: row.date_to,
+    dayPortion: row.day_portion,
+    hours: row.hours,
+    status: row.status,
+    note: row.note,
+    createdAt: row.created_at,
+    createdBy: row.created_by
+  };
+}
+function requireDate(value, label) {
+  const trimmed = value.trim();
+  if (!(0, import_time.isDateString)(trimmed)) {
+    throw new import_errors.ValidationError(`${label} "${value}" is not a date (YYYY-MM-DD)`);
+  }
+  return trimmed;
+}
+function requireDayPortion(value) {
+  if (!Number.isFinite(value) || value <= 0 || value > 1) {
+    throw new import_errors.ValidationError(`dayPortion must be greater than 0 and at most 1 (got ${value})`);
+  }
+  return value;
+}
+function createAbsencesRepository(db) {
+  const selectTypeById = db.prepare(`SELECT ${TYPE_COLUMNS} FROM absence_types WHERE id = ?`);
+  const selectTypeUserCode = db.prepare(`SELECT ${TYPE_COLUMNS} FROM absence_types WHERE code = ? AND user_id = ?`);
+  const selectTypeGlobalCode = db.prepare(
+    `SELECT ${TYPE_COLUMNS} FROM absence_types WHERE code = ? AND user_id IS NULL`
+  );
+  const selectAbsenceById = db.prepare(`SELECT ${ABSENCE_COLUMNS} FROM absences WHERE id = ?`);
+  const selectByUser = db.prepare(
+    `SELECT ${ABSENCE_COLUMNS} FROM absences
+		 WHERE user_id = ? AND date_to >= ? AND date_from <= ?
+		 ORDER BY date_from, date_to, id`
+  );
+  const selectWithTypes = db.prepare(
+    `SELECT a.id, a.user_id, a.type_id, a.date_from, a.date_to, a.day_portion, a.hours, a.status, a.note,
+		        a.created_at, a.created_by,
+		        t.code AS type_code, t.name AS type_name, t.paid AS type_paid, t.factor AS type_factor,
+		        t.reduce_vacation AS type_reduce_vacation
+		 FROM absences a JOIN absence_types t ON t.id = a.type_id
+		 WHERE a.user_id = ? AND a.date_to >= ? AND a.date_from <= ?
+		 ORDER BY a.date_from, a.date_to, a.id`
+  );
+  const insertAbsence = db.prepare(
+    `INSERT INTO absences
+		 (user_id, type_id, date_from, date_to, day_portion, hours, status, note, created_at, created_by)
+		 VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`
+  );
+  const updateAbsence = db.prepare(
+    `UPDATE absences SET type_id = ?, date_from = ?, date_to = ?, day_portion = ?, hours = ?, note = ?
+		 WHERE id = ?`
+  );
+  const updateStatusStatement = db.prepare("UPDATE absences SET status = ? WHERE id = ?");
+  const deleteAbsence = db.prepare("DELETE FROM absences WHERE id = ?");
+  const insertType = db.prepare(
+    `INSERT INTO absence_types (user_id, code, name, paid, factor, reduce_vacation, is_active)
+		 VALUES (?, ?, ?, ?, ?, ?, ?)`
+  );
+  const updateType = db.prepare(
+    `UPDATE absence_types SET name = ?, paid = ?, factor = ?, reduce_vacation = ?, is_active = ? WHERE id = ?`
+  );
+  const read = (id) => {
+    const row = selectAbsenceById.get(id);
+    return row ? mapAbsenceRow(row) : null;
+  };
+  const resolveType = (reference, userId) => {
+    if (typeof reference === "number") {
+      const row = selectTypeById.get(reference);
+      return row ? mapAbsenceTypeRow(row) : null;
+    }
+    if (userId != null) {
+      const own = selectTypeUserCode.get(reference, userId);
+      if (own) {
+        return mapAbsenceTypeRow(own);
+      }
+    }
+    const global = selectTypeGlobalCode.get(reference);
+    return global ? mapAbsenceTypeRow(global) : null;
+  };
+  const requireType = (input) => {
+    var _a;
+    const reference = (_a = input.typeId) != null ? _a : input.typeCode;
+    if (reference === void 0) {
+      throw new UnknownAbsenceTypeError("(none)");
+    }
+    const type = resolveType(reference, input.userId);
+    if (!type) {
+      throw new UnknownAbsenceTypeError(reference);
+    }
+    return type;
+  };
+  return {
+    types(options) {
+      var _a;
+      const activeOnly = (options == null ? void 0 : options.includeInactive) === true ? "" : " AND is_active = 1";
+      const userId = (_a = options == null ? void 0 : options.userId) != null ? _a : null;
+      const rows = db.prepare(
+        `SELECT ${TYPE_COLUMNS} FROM absence_types
+					 WHERE (user_id IS NULL OR user_id = ?)${activeOnly}
+					 ORDER BY code, id`
+      ).all(userId);
+      return rows.map(mapAbsenceTypeRow);
+    },
+    findType(reference, userId) {
+      return resolveType(reference, userId);
+    },
+    upsertType(input) {
+      var _a, _b, _c, _d, _e, _f, _g;
+      const userId = (_a = input.userId) != null ? _a : null;
+      const code = input.code.trim().toUpperCase();
+      if (!/^[A-Za-z0-9_-]{1,8}$/.test(code)) {
+        throw new import_errors.ValidationError(`code must be 1 to 8 letters, digits, "-" or "_" (got "${input.code}")`);
+      }
+      const name = input.name.trim();
+      if (!name) {
+        throw new import_errors.ValidationError("name is required");
+      }
+      const factor = (_b = input.factor) != null ? _b : 100;
+      if (!Number.isInteger(factor) || factor < 0 || factor > 100) {
+        throw new import_errors.ValidationError(`factor must be a whole number between 0 and 100 (got ${input.factor})`);
+      }
+      const paid = (_c = input.paid) != null ? _c : true;
+      const reduceVacation = (_d = input.reduceVacation) != null ? _d : false;
+      const isActive = (_e = input.isActive) != null ? _e : true;
+      const now = (_f = input.now) != null ? _f : Math.floor(Date.now() / 1e3);
+      const existing = resolveType(code, userId);
+      let typeId = (_g = existing == null ? void 0 : existing.id) != null ? _g : 0;
+      const run = db.transaction(() => {
+        var _a2;
+        if (existing) {
+          updateType.run(name, paid ? 1 : 0, factor, reduceVacation ? 1 : 0, isActive ? 1 : 0, existing.id);
+        } else {
+          const result = insertType.run(
+            userId,
+            code,
+            name,
+            paid ? 1 : 0,
+            factor,
+            reduceVacation ? 1 : 0,
+            isActive ? 1 : 0
+          );
+          typeId = Number(result.lastInsertRowid);
+        }
+        (0, import_audit.writeAuditLog)(db, {
+          atUtc: now,
+          actorId: input.actorId,
+          ip: (_a2 = input.actorIp) != null ? _a2 : null,
+          action: existing ? "absence_type.update" : "absence_type.create",
+          entity: "absence_types",
+          entityId: typeId,
+          detail: { code, userId, name, paid, factor, reduceVacation, isActive }
+        });
+      });
+      run();
+      const type = existing ? { ...existing, name, paid, factor, reduceVacation, isActive } : {
+        id: typeId,
+        userId,
+        code,
+        name,
+        paid,
+        factor,
+        reduceVacation,
+        isActive
+      };
+      return { type, created: existing === null };
+    },
+    findById: read,
+    create(input) {
+      var _a, _b, _c, _d;
+      const type = requireType(input);
+      const dateFrom = requireDate(input.dateFrom, "dateFrom");
+      const dateTo = requireDate((_a = input.dateTo) != null ? _a : dateFrom, "dateTo");
+      if (dateFrom > dateTo) {
+        throw new import_errors.ValidationError(`dateFrom (${dateFrom}) must not be after dateTo (${dateTo})`);
+      }
+      const dayPortion = requireDayPortion((_b = input.dayPortion) != null ? _b : 1);
+      const status = (_c = input.status) != null ? _c : "planned";
+      const now = (_d = input.now) != null ? _d : Math.floor(Date.now() / 1e3);
+      let absenceId = 0;
+      const run = db.transaction(() => {
+        var _a2, _b2, _c2;
+        const result = insertAbsence.run(
+          input.userId,
+          type.id,
+          dateFrom,
+          dateTo,
+          dayPortion,
+          (_a2 = input.hours) != null ? _a2 : null,
+          status,
+          (_b2 = input.note) != null ? _b2 : null,
+          now,
+          input.actorId
+        );
+        absenceId = Number(result.lastInsertRowid);
+        (0, import_audit.writeAuditLog)(db, {
+          atUtc: now,
+          actorId: input.actorId,
+          action: "absence.create",
+          entity: "absence",
+          entityId: absenceId,
+          detail: {
+            userId: input.userId,
+            typeCode: type.code,
+            dateFrom,
+            dateTo,
+            dayPortion,
+            status
+          },
+          ip: (_c2 = input.actorIp) != null ? _c2 : null
+        });
+      });
+      run();
+      const created = read(absenceId);
+      if (!created) {
+        throw new Error(`absence ${absenceId} disappeared right after creation`);
+      }
+      return created;
+    },
+    update(input) {
+      var _a, _b;
+      const current = read(input.id);
+      if (!current) {
+        throw new import_errors.NotFoundError(`absence ${input.id} not found`);
+      }
+      const type = input.patch.typeId === void 0 && input.patch.typeCode === void 0 ? null : requireType({ ...input.patch, userId: current.userId });
+      const next = {
+        ...current,
+        typeId: (_a = type == null ? void 0 : type.id) != null ? _a : current.typeId,
+        dateFrom: input.patch.dateFrom ? requireDate(input.patch.dateFrom, "dateFrom") : current.dateFrom,
+        dateTo: input.patch.dateTo ? requireDate(input.patch.dateTo, "dateTo") : current.dateTo,
+        dayPortion: input.patch.dayPortion === void 0 ? current.dayPortion : requireDayPortion(input.patch.dayPortion),
+        hours: input.patch.hours === void 0 ? current.hours : input.patch.hours,
+        note: input.patch.note === void 0 ? current.note : input.patch.note
+      };
+      if (next.dateFrom > next.dateTo) {
+        throw new import_errors.ValidationError(`dateFrom (${next.dateFrom}) must not be after dateTo (${next.dateTo})`);
+      }
+      const changes = (0, import_audit.diffFields)(
+        current,
+        next,
+        AUDITED_FIELDS
+      );
+      if (Object.keys(changes).length === 0) {
+        return current;
+      }
+      const now = (_b = input.now) != null ? _b : Math.floor(Date.now() / 1e3);
+      const run = db.transaction(() => {
+        var _a2, _b2;
+        updateAbsence.run(
+          next.typeId,
+          next.dateFrom,
+          next.dateTo,
+          next.dayPortion,
+          next.hours,
+          next.note,
+          input.id
+        );
+        (0, import_audit.writeAuditLog)(db, {
+          atUtc: now,
+          actorId: input.actorId,
+          action: "absence.update",
+          entity: "absence",
+          entityId: input.id,
+          detail: { changes, reason: (_a2 = input.reason) != null ? _a2 : null },
+          ip: (_b2 = input.actorIp) != null ? _b2 : null
+        });
+      });
+      run();
+      const updated = read(input.id);
+      if (!updated) {
+        throw new Error(`absence ${input.id} disappeared right after the update`);
+      }
+      return updated;
+    },
+    setStatus(input) {
+      var _a;
+      const current = read(input.id);
+      if (!current) {
+        throw new import_errors.NotFoundError(`absence ${input.id} not found`);
+      }
+      if (current.status === input.status) {
+        return current;
+      }
+      const now = (_a = input.now) != null ? _a : Math.floor(Date.now() / 1e3);
+      const run = db.transaction(() => {
+        var _a2;
+        updateStatusStatement.run(input.status, input.id);
+        (0, import_audit.writeAuditLog)(db, {
+          atUtc: now,
+          actorId: input.actorId,
+          action: "absence.status",
+          entity: "absence",
+          entityId: input.id,
+          detail: { changes: { status: { old: current.status, new: input.status } } },
+          ip: (_a2 = input.actorIp) != null ? _a2 : null
+        });
+      });
+      run();
+      const updated = read(input.id);
+      if (!updated) {
+        throw new Error(`absence ${input.id} disappeared right after the status change`);
+      }
+      return updated;
+    },
+    remove(input) {
+      var _a;
+      const current = read(input.id);
+      if (!current) {
+        return false;
+      }
+      const now = (_a = input.now) != null ? _a : Math.floor(Date.now() / 1e3);
+      const run = db.transaction(() => {
+        var _a2;
+        deleteAbsence.run(input.id);
+        (0, import_audit.writeAuditLog)(db, {
+          atUtc: now,
+          actorId: input.actorId,
+          action: "absence.delete",
+          entity: "absence",
+          entityId: input.id,
+          detail: {
+            userId: current.userId,
+            dateFrom: current.dateFrom,
+            dateTo: current.dateTo,
+            status: current.status
+          },
+          ip: (_a2 = input.actorIp) != null ? _a2 : null
+        });
+      });
+      run();
+      return true;
+    },
+    listByUser(userId, options) {
+      var _a, _b;
+      const from = (_a = options == null ? void 0 : options.from) != null ? _a : (options == null ? void 0 : options.year) === void 0 ? "0000-01-01" : `${options.year}-01-01`;
+      const to = (_b = options == null ? void 0 : options.to) != null ? _b : (options == null ? void 0 : options.year) === void 0 ? "9999-12-31" : `${options.year}-12-31`;
+      const rows = selectByUser.all(userId, from, to);
+      return rows.map(mapAbsenceRow);
+    },
+    forDate(userId, date) {
+      const day = requireDate(date, "date");
+      const rows = selectByUser.all(userId, day, day);
+      return rows.map(mapAbsenceRow);
+    },
+    withTypesInRange(userId, from, to) {
+      const rows = selectWithTypes.all(
+        userId,
+        requireDate(from, "from"),
+        requireDate(to, "to")
+      );
+      return rows.map((row) => ({
+        ...mapAbsenceRow(row),
+        typeCode: row.type_code,
+        typeName: row.type_name,
+        paid: row.type_paid !== 0,
+        factor: row.type_factor,
+        reduceVacation: row.type_reduce_vacation !== 0
+      }));
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  UnknownAbsenceTypeError,
+  createAbsencesRepository,
+  mapAbsenceRow,
+  mapAbsenceTypeRow
+});
+//# sourceMappingURL=absences.js.map

package/build/lib/db/repositories/absences.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/lib/db/repositories/absences.ts"],
+  "sourcesContent": ["/**\n * Absence repository (`absence_types`, `absences`).\n *\n * An absence is a date range plus a day portion, so half days and multi-day absences share one\n * representation. The status separates requested (`planned`) from booked (`taken`) absences; the\n * vacation balance reports used and planned days separately.\n */\n\nimport type { Db } from \"../database\";\nimport { isDateString } from \"../../util/time\";\nimport { NotFoundError, ValidationError } from \"../../errors\";\nimport { diffFields, writeAuditLog } from \"./audit\";\n\n/** Status of an absence: requested/planned or already taken. */\nexport type AbsenceStatus = \"taken\" | \"planned\";\n\n/** An absence type (global when `userId` is `null`, otherwise user specific). */\nexport interface AbsenceTypeRecord {\n\t/** Primary key */\n\tid: number;\n\t/** Owner, `null` for the global types */\n\tuserId: number | null;\n\t/** Short code, e.g. `F` for vacation */\n\tcode: string;\n\t/** Display name */\n\tname: string;\n\t/** True when the absence is paid */\n\tpaid: boolean;\n\t/** Percentage of the working time credited (100 = fully credited) */\n\tfactor: number;\n\t/** True for vacation, which reduces the vacation balance */\n\treduceVacation: boolean;\n\t/** Inactive types are hidden but keep their history */\n\tisActive: boolean;\n}\n\n/** Input for creating or updating an absence type. */\nexport interface UpsertAbsenceTypeInput {\n\t/** Owner, `null` (default) for the global types */\n\tuserId?: number | null;\n\t/** Short code, e.g. `F` for vacation */\n\tcode: string;\n\t/** Display name */\n\tname: string;\n\t/** True when the absence is paid, defaults to `true` */\n\tpaid?: boolean;\n\t/** Percentage of the working time credited (defaults to `100`) */\n\tfactor?: number;\n\t/** True for vacation, which reduces the vacation balance, defaults to `false` */\n\treduceVacation?: boolean;\n\t/** False hides the type but keeps its history, defaults to `true` */\n\tisActive?: boolean;\n\t/** Who creates or changes the type */\n\tactorId: number;\n\t/** Client IP address of the actor */\n\tactorIp?: string | null;\n\t/** Instant of the change, defaults to now */\n\tnow?: number;\n}\n\n/** An absence as stored in the database. */\nexport interface AbsenceRecord {\n\t/** Primary key */\n\tid: number;\n\t/** Employee the absence belongs to */\n\tuserId: number;\n\t/** Absence type */\n\ttypeId: number;\n\t/** First day, local date `YYYY-MM-DD` */\n\tdateFrom: string;\n\t/** Last day, local date `YYYY-MM-DD` */\n\tdateTo: string;\n\t/** Portion of each day (1 = whole day, 0.5 = half day) */\n\tdayPortion: number;\n\t/** Hours of a partial day absence, informational only */\n\thours: number | null;\n\t/** Requested or already taken */\n\tstatus: AbsenceStatus;\n\t/** Free-form note */\n\tnote: string | null;\n\t/** Instant of creation, UTC epoch seconds */\n\tcreatedAt: number;\n\t/** Who created the absence */\n\tcreatedBy: number | null;\n}\n\n/** An absence together with its type (input for the calculation service). */\nexport interface AbsenceWithType extends AbsenceRecord {\n\t/** Short code of the type, e.g. `F` */\n\ttypeCode: string;\n\t/** Display name of the type */\n\ttypeName: string;\n\t/** True when the absence is paid */\n\tpaid: boolean;\n\t/** Percentage of the working time credited */\n\tfactor: number;\n\t/** True for vacation, which reduces the vacation balance */\n\treduceVacation: boolean;\n}\n\n/** Input for creating an absence. */\nexport interface CreateAbsenceInput {\n\t/** Employee the absence belongs to */\n\tuserId: number;\n\t/** Absence type by id (alternative to `typeCode`) */\n\ttypeId?: number;\n\t/** Absence type by code, user specific types win over the global ones */\n\ttypeCode?: string;\n\t/** First day, local date `YYYY-MM-DD` */\n\tdateFrom: string;\n\t/** Last day, defaults to `dateFrom` */\n\tdateTo?: string;\n\t/** Portion of each day, default 1 */\n\tdayPortion?: number;\n\t/** Hours of a partial day absence */\n\thours?: number | null;\n\t/** Status, default `planned` (a request that still needs approval) */\n\tstatus?: AbsenceStatus;\n\t/** Free-form note */\n\tnote?: string | null;\n\t/** Who creates the absence */\n\tactorId: number;\n\t/** Client IP address of the actor */\n\tactorIp?: string | null;\n\t/** Instant of creation, defaults to now */\n\tnow?: number;\n}\n\n/** Input for changing an absence. */\nexport interface UpdateAbsenceInput {\n\t/** Id of the changed absence */\n\tid: number;\n\t/** Fields to change */\n\tpatch: {\n\t\ttypeId?: number;\n\t\ttypeCode?: string;\n\t\tdateFrom?: string;\n\t\tdateTo?: string;\n\t\tdayPortion?: number;\n\t\thours?: number | null;\n\t\tnote?: string | null;\n\t};\n\t/** Reason of the change (recorded in the audit trail) */\n\treason?: string | null;\n\t/** Who performs the change */\n\tactorId: number;\n\t/** Client IP address of the actor */\n\tactorIp?: string | null;\n\t/** Instant of the change, defaults to now */\n\tnow?: number;\n}\n\n/** Thrown when an absence type cannot be resolved. */\nexport class UnknownAbsenceTypeError extends Error {\n\t/**\n\t * Creates the error.\n\t *\n\t * @param reference - id or code that could not be resolved\n\t */\n\tconstructor(public readonly reference: string | number) {\n\t\tsuper(`unknown absence type \"${reference}\"`);\n\t\tthis.name = \"UnknownAbsenceTypeError\";\n\t}\n}\n\n/** Absence storage operations. */\nexport interface AbsencesRepository {\n\t/** Absence types of a user, including the global ones */\n\ttypes(options?: { userId?: number | null; includeInactive?: boolean }): AbsenceTypeRecord[];\n\t/** Resolves a type by id or code, user specific types win over the global ones */\n\tfindType(reference: number | string, userId?: number | null): AbsenceTypeRecord | null;\n\t/** Creates an absence type or updates the existing one with the same code */\n\tupsertType(input: UpsertAbsenceTypeInput): { type: AbsenceTypeRecord; created: boolean };\n\t/** Reads an absence by id */\n\tfindById(id: number): AbsenceRecord | null;\n\t/** Creates an absence and audits it */\n\tcreate(input: CreateAbsenceInput): AbsenceRecord;\n\t/** Changes an absence and audits the changed fields */\n\tupdate(input: UpdateAbsenceInput): AbsenceRecord;\n\t/** Moves an absence between `planned` and `taken` */\n\tsetStatus(input: {\n\t\tid: number;\n\t\tstatus: AbsenceStatus;\n\t\tactorId: number;\n\t\tactorIp?: string | null;\n\t\tnow?: number;\n\t}): AbsenceRecord;\n\t/** Deletes an absence by id */\n\tremove(input: { id: number; actorId: number; actorIp?: string | null; now?: number }): boolean;\n\t/** Absences of one user within an optional period, sorted by start date */\n\tlistByUser(userId: number, options?: { from?: string; to?: string; year?: number }): AbsenceRecord[];\n\t/** Absences overlapping a date, sorted by start date */\n\tforDate(userId: number, date: string): AbsenceRecord[];\n\t/** Absences overlapping a range, including their type information */\n\twithTypesInRange(userId: number, from: string, to: string): AbsenceWithType[];\n}\n\ninterface AbsenceTypeRow {\n\tid: number;\n\tuser_id: number | null;\n\tcode: string;\n\tname: string;\n\tpaid: number;\n\tfactor: number;\n\treduce_vacation: number;\n\tis_active: number;\n}\n\ninterface AbsenceRow {\n\tid: number;\n\tuser_id: number;\n\ttype_id: number;\n\tdate_from: string;\n\tdate_to: string;\n\tday_portion: number;\n\thours: number | null;\n\tstatus: AbsenceStatus;\n\tnote: string | null;\n\tcreated_at: number;\n\tcreated_by: number | null;\n}\n\ninterface AbsenceWithTypeRow extends AbsenceRow {\n\ttype_code: string;\n\ttype_name: string;\n\ttype_paid: number;\n\ttype_factor: number;\n\ttype_reduce_vacation: number;\n}\n\nconst TYPE_COLUMNS = \"id, user_id, code, name, paid, factor, reduce_vacation, is_active\";\nconst ABSENCE_COLUMNS = `id, user_id, type_id, date_from, date_to, day_portion, hours, status, note,\n\\tcreated_at, created_by`;\n\n/** Field names of an absence that are compared for the audit trail. */\nconst AUDITED_FIELDS: (keyof AbsenceRecord)[] = [\"typeId\", \"dateFrom\", \"dateTo\", \"dayPortion\", \"hours\", \"note\"];\n\n/**\n * Maps a database row to an absence type record.\n *\n * @param row - raw database row\n * @returns absence type record\n */\nexport function mapAbsenceTypeRow(row: AbsenceTypeRow): AbsenceTypeRecord {\n\treturn {\n\t\tid: row.id,\n\t\tuserId: row.user_id,\n\t\tcode: row.code,\n\t\tname: row.name,\n\t\tpaid: row.paid !== 0,\n\t\tfactor: row.factor,\n\t\treduceVacation: row.reduce_vacation !== 0,\n\t\tisActive: row.is_active !== 0,\n\t};\n}\n\n/**\n * Maps a database row to an absence record.\n *\n * @param row - raw database row\n * @returns absence record\n */\nexport function mapAbsenceRow(row: AbsenceRow): AbsenceRecord {\n\treturn {\n\t\tid: row.id,\n\t\tuserId: row.user_id,\n\t\ttypeId: row.type_id,\n\t\tdateFrom: row.date_from,\n\t\tdateTo: row.date_to,\n\t\tdayPortion: row.day_portion,\n\t\thours: row.hours,\n\t\tstatus: row.status,\n\t\tnote: row.note,\n\t\tcreatedAt: row.created_at,\n\t\tcreatedBy: row.created_by,\n\t};\n}\n\n/**\n * Checks and normalises a calendar date.\n *\n * @param value - date to validate\n * @param label - field name used in the error message\n * @returns the validated date\n */\nfunction requireDate(value: string, label: string): string {\n\tconst trimmed = value.trim();\n\tif (!isDateString(trimmed)) {\n\t\tthrow new ValidationError(`${label} \"${value}\" is not a date (YYYY-MM-DD)`);\n\t}\n\treturn trimmed;\n}\n\n/**\n * Validates the day portion of an absence.\n *\n * @param value - raw day portion\n * @returns the validated day portion\n */\nfunction requireDayPortion(value: number): number {\n\tif (!Number.isFinite(value) || value <= 0 || value > 1) {\n\t\tthrow new ValidationError(`dayPortion must be greater than 0 and at most 1 (got ${value})`);\n\t}\n\treturn value;\n}\n\n/**\n * Creates the absence repository.\n *\n * @param db - open database handle\n * @returns repository instance\n */\nexport function createAbsencesRepository(db: Db): AbsencesRepository {\n\tconst selectTypeById = db.prepare(`SELECT ${TYPE_COLUMNS} FROM absence_types WHERE id = ?`);\n\tconst selectTypeUserCode = db.prepare(`SELECT ${TYPE_COLUMNS} FROM absence_types WHERE code = ? AND user_id = ?`);\n\tconst selectTypeGlobalCode = db.prepare(\n\t\t`SELECT ${TYPE_COLUMNS} FROM absence_types WHERE code = ? AND user_id IS NULL`,\n\t);\n\tconst selectAbsenceById = db.prepare(`SELECT ${ABSENCE_COLUMNS} FROM absences WHERE id = ?`);\n\tconst selectByUser = db.prepare(\n\t\t`SELECT ${ABSENCE_COLUMNS} FROM absences\n\t\t WHERE user_id = ? AND date_to >= ? AND date_from <= ?\n\t\t ORDER BY date_from, date_to, id`,\n\t);\n\tconst selectWithTypes = db.prepare(\n\t\t`SELECT a.id, a.user_id, a.type_id, a.date_from, a.date_to, a.day_portion, a.hours, a.status, a.note,\n\t\t        a.created_at, a.created_by,\n\t\t        t.code AS type_code, t.name AS type_name, t.paid AS type_paid, t.factor AS type_factor,\n\t\t        t.reduce_vacation AS type_reduce_vacation\n\t\t FROM absences a JOIN absence_types t ON t.id = a.type_id\n\t\t WHERE a.user_id = ? AND a.date_to >= ? AND a.date_from <= ?\n\t\t ORDER BY a.date_from, a.date_to, a.id`,\n\t);\n\tconst insertAbsence = db.prepare(\n\t\t`INSERT INTO absences\n\t\t (user_id, type_id, date_from, date_to, day_portion, hours, status, note, created_at, created_by)\n\t\t VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n\t);\n\tconst updateAbsence = db.prepare(\n\t\t`UPDATE absences SET type_id = ?, date_from = ?, date_to = ?, day_portion = ?, hours = ?, note = ?\n\t\t WHERE id = ?`,\n\t);\n\tconst updateStatusStatement = db.prepare(\"UPDATE absences SET status = ? WHERE id = ?\");\n\tconst deleteAbsence = db.prepare(\"DELETE FROM absences WHERE id = ?\");\n\tconst insertType = db.prepare(\n\t\t`INSERT INTO absence_types (user_id, code, name, paid, factor, reduce_vacation, is_active)\n\t\t VALUES (?, ?, ?, ?, ?, ?, ?)`,\n\t);\n\tconst updateType = db.prepare(\n\t\t`UPDATE absence_types SET name = ?, paid = ?, factor = ?, reduce_vacation = ?, is_active = ? WHERE id = ?`,\n\t);\n\n\tconst read = (id: number): AbsenceRecord | null => {\n\t\tconst row = selectAbsenceById.get(id) as AbsenceRow | undefined;\n\t\treturn row ? mapAbsenceRow(row) : null;\n\t};\n\n\t/**\n\t * Resolves a type by id or code (user specific types win over the global ones).\n\t *\n\t * @param reference - id or code\n\t * @param userId - owner used to prefer user specific types\n\t * @returns type record or `null`\n\t */\n\tconst resolveType = (reference: number | string, userId?: number | null): AbsenceTypeRecord | null => {\n\t\tif (typeof reference === \"number\") {\n\t\t\tconst row = selectTypeById.get(reference) as AbsenceTypeRow | undefined;\n\t\t\treturn row ? mapAbsenceTypeRow(row) : null;\n\t\t}\n\t\tif (userId != null) {\n\t\t\tconst own = selectTypeUserCode.get(reference, userId) as AbsenceTypeRow | undefined;\n\t\t\tif (own) {\n\t\t\t\treturn mapAbsenceTypeRow(own);\n\t\t\t}\n\t\t}\n\t\tconst global = selectTypeGlobalCode.get(reference) as AbsenceTypeRow | undefined;\n\t\treturn global ? mapAbsenceTypeRow(global) : null;\n\t};\n\n\t/**\n\t * Resolves a type or throws when it cannot be found.\n\t *\n\t * @param input - type reference and owner\n\t * @param input.typeId - type id (alternative to `input.typeCode`)\n\t * @param input.typeCode - type code (alternative to `input.typeId`)\n\t * @param input.userId - owner used to prefer user specific types\n\t * @returns resolved type\n\t */\n\tconst requireType = (input: { typeId?: number; typeCode?: string; userId: number }): AbsenceTypeRecord => {\n\t\tconst reference = input.typeId ?? input.typeCode;\n\t\tif (reference === undefined) {\n\t\t\tthrow new UnknownAbsenceTypeError(\"(none)\");\n\t\t}\n\t\tconst type = resolveType(reference, input.userId);\n\t\tif (!type) {\n\t\t\tthrow new UnknownAbsenceTypeError(reference);\n\t\t}\n\t\treturn type;\n\t};\n\n\treturn {\n\t\ttypes(options?: { userId?: number | null; includeInactive?: boolean }): AbsenceTypeRecord[] {\n\t\t\tconst activeOnly = options?.includeInactive === true ? \"\" : \" AND is_active = 1\";\n\t\t\tconst userId = options?.userId ?? null;\n\t\t\tconst rows = db\n\t\t\t\t.prepare(\n\t\t\t\t\t`SELECT ${TYPE_COLUMNS} FROM absence_types\n\t\t\t\t\t WHERE (user_id IS NULL OR user_id = ?)${activeOnly}\n\t\t\t\t\t ORDER BY code, id`,\n\t\t\t\t)\n\t\t\t\t.all(userId) as AbsenceTypeRow[];\n\t\t\treturn rows.map(mapAbsenceTypeRow);\n\t\t},\n\n\t\tfindType(reference: number | string, userId?: number | null): AbsenceTypeRecord | null {\n\t\t\treturn resolveType(reference, userId);\n\t\t},\n\n\t\tupsertType(input: UpsertAbsenceTypeInput): { type: AbsenceTypeRecord; created: boolean } {\n\t\t\tconst userId = input.userId ?? null;\n\t\t\tconst code = input.code.trim().toUpperCase();\n\t\t\tif (!/^[A-Za-z0-9_-]{1,8}$/.test(code)) {\n\t\t\t\tthrow new ValidationError(`code must be 1 to 8 letters, digits, \"-\" or \"_\" (got \"${input.code}\")`);\n\t\t\t}\n\t\t\tconst name = input.name.trim();\n\t\t\tif (!name) {\n\t\t\t\tthrow new ValidationError(\"name is required\");\n\t\t\t}\n\t\t\tconst factor = input.factor ?? 100;\n\t\t\tif (!Number.isInteger(factor) || factor < 0 || factor > 100) {\n\t\t\t\tthrow new ValidationError(`factor must be a whole number between 0 and 100 (got ${input.factor})`);\n\t\t\t}\n\t\t\tconst paid = input.paid ?? true;\n\t\t\tconst reduceVacation = input.reduceVacation ?? false;\n\t\t\tconst isActive = input.isActive ?? true;\n\t\t\tconst now = input.now ?? Math.floor(Date.now() / 1000);\n\n\t\t\tconst existing = resolveType(code, userId);\n\t\t\tlet typeId = existing?.id ?? 0;\n\n\t\t\tconst run = db.transaction((): void => {\n\t\t\t\tif (existing) {\n\t\t\t\t\tupdateType.run(name, paid ? 1 : 0, factor, reduceVacation ? 1 : 0, isActive ? 1 : 0, existing.id);\n\t\t\t\t} else {\n\t\t\t\t\tconst result = insertType.run(\n\t\t\t\t\t\tuserId,\n\t\t\t\t\t\tcode,\n\t\t\t\t\t\tname,\n\t\t\t\t\t\tpaid ? 1 : 0,\n\t\t\t\t\t\tfactor,\n\t\t\t\t\t\treduceVacation ? 1 : 0,\n\t\t\t\t\t\tisActive ? 1 : 0,\n\t\t\t\t\t);\n\t\t\t\t\ttypeId = Number(result.lastInsertRowid);\n\t\t\t\t}\n\n\t\t\t\twriteAuditLog(db, {\n\t\t\t\t\tatUtc: now,\n\t\t\t\t\tactorId: input.actorId,\n\t\t\t\t\tip: input.actorIp ?? null,\n\t\t\t\t\taction: existing ? \"absence_type.update\" : \"absence_type.create\",\n\t\t\t\t\tentity: \"absence_types\",\n\t\t\t\t\tentityId: typeId,\n\t\t\t\t\tdetail: { code, userId, name, paid, factor, reduceVacation, isActive },\n\t\t\t\t});\n\t\t\t});\n\t\t\trun();\n\n\t\t\tconst type = existing\n\t\t\t\t? { ...existing, name, paid, factor, reduceVacation, isActive }\n\t\t\t\t: {\n\t\t\t\t\t\tid: typeId,\n\t\t\t\t\t\tuserId,\n\t\t\t\t\t\tcode,\n\t\t\t\t\t\tname,\n\t\t\t\t\t\tpaid,\n\t\t\t\t\t\tfactor,\n\t\t\t\t\t\treduceVacation,\n\t\t\t\t\t\tisActive,\n\t\t\t\t\t};\n\t\t\treturn { type, created: existing === null };\n\t\t},\n\n\t\tfindById: read,\n\n\t\tcreate(input: CreateAbsenceInput): AbsenceRecord {\n\t\t\tconst type = requireType(input);\n\t\t\tconst dateFrom = requireDate(input.dateFrom, \"dateFrom\");\n\t\t\tconst dateTo = requireDate(input.dateTo ?? dateFrom, \"dateTo\");\n\t\t\tif (dateFrom > dateTo) {\n\t\t\t\tthrow new ValidationError(`dateFrom (${dateFrom}) must not be after dateTo (${dateTo})`);\n\t\t\t}\n\t\t\tconst dayPortion = requireDayPortion(input.dayPortion ?? 1);\n\t\t\tconst status: AbsenceStatus = input.status ?? \"planned\";\n\t\t\tconst now = input.now ?? Math.floor(Date.now() / 1000);\n\n\t\t\tlet absenceId = 0;\n\t\t\tconst run = db.transaction((): void => {\n\t\t\t\tconst result = insertAbsence.run(\n\t\t\t\t\tinput.userId,\n\t\t\t\t\ttype.id,\n\t\t\t\t\tdateFrom,\n\t\t\t\t\tdateTo,\n\t\t\t\t\tdayPortion,\n\t\t\t\t\tinput.hours ?? null,\n\t\t\t\t\tstatus,\n\t\t\t\t\tinput.note ?? null,\n\t\t\t\t\tnow,\n\t\t\t\t\tinput.actorId,\n\t\t\t\t);\n\t\t\t\tabsenceId = Number(result.lastInsertRowid);\n\t\t\t\twriteAuditLog(db, {\n\t\t\t\t\tatUtc: now,\n\t\t\t\t\tactorId: input.actorId,\n\t\t\t\t\taction: \"absence.create\",\n\t\t\t\t\tentity: \"absence\",\n\t\t\t\t\tentityId: absenceId,\n\t\t\t\t\tdetail: {\n\t\t\t\t\t\tuserId: input.userId,\n\t\t\t\t\t\ttypeCode: type.code,\n\t\t\t\t\t\tdateFrom,\n\t\t\t\t\t\tdateTo,\n\t\t\t\t\t\tdayPortion,\n\t\t\t\t\t\tstatus,\n\t\t\t\t\t},\n\t\t\t\t\tip: input.actorIp ?? null,\n\t\t\t\t});\n\t\t\t});\n\t\t\trun();\n\n\t\t\tconst created = read(absenceId);\n\t\t\tif (!created) {\n\t\t\t\tthrow new Error(`absence ${absenceId} disappeared right after creation`);\n\t\t\t}\n\t\t\treturn created;\n\t\t},\n\n\t\tupdate(input: UpdateAbsenceInput): AbsenceRecord {\n\t\t\tconst current = read(input.id);\n\t\t\tif (!current) {\n\t\t\t\tthrow new NotFoundError(`absence ${input.id} not found`);\n\t\t\t}\n\n\t\t\tconst type =\n\t\t\t\tinput.patch.typeId === undefined && input.patch.typeCode === undefined\n\t\t\t\t\t? null\n\t\t\t\t\t: requireType({ ...input.patch, userId: current.userId });\n\t\t\tconst next: AbsenceRecord = {\n\t\t\t\t...current,\n\t\t\t\ttypeId: type?.id ?? current.typeId,\n\t\t\t\tdateFrom: input.patch.dateFrom ? requireDate(input.patch.dateFrom, \"dateFrom\") : current.dateFrom,\n\t\t\t\tdateTo: input.patch.dateTo ? requireDate(input.patch.dateTo, \"dateTo\") : current.dateTo,\n\t\t\t\tdayPortion:\n\t\t\t\t\tinput.patch.dayPortion === undefined\n\t\t\t\t\t\t? current.dayPortion\n\t\t\t\t\t\t: requireDayPortion(input.patch.dayPortion),\n\t\t\t\thours: input.patch.hours === undefined ? current.hours : input.patch.hours,\n\t\t\t\tnote: input.patch.note === undefined ? current.note : input.patch.note,\n\t\t\t};\n\t\t\tif (next.dateFrom > next.dateTo) {\n\t\t\t\tthrow new ValidationError(`dateFrom (${next.dateFrom}) must not be after dateTo (${next.dateTo})`);\n\t\t\t}\n\n\t\t\tconst changes = diffFields(\n\t\t\t\tcurrent as unknown as Record<string, unknown>,\n\t\t\t\tnext as unknown as Record<string, unknown>,\n\t\t\t\tAUDITED_FIELDS as unknown as (keyof Record<string, unknown>)[],\n\t\t\t);\n\t\t\tif (Object.keys(changes).length === 0) {\n\t\t\t\treturn current;\n\t\t\t}\n\n\t\t\tconst now = input.now ?? Math.floor(Date.now() / 1000);\n\t\t\tconst run = db.transaction((): void => {\n\t\t\t\tupdateAbsence.run(\n\t\t\t\t\tnext.typeId,\n\t\t\t\t\tnext.dateFrom,\n\t\t\t\t\tnext.dateTo,\n\t\t\t\t\tnext.dayPortion,\n\t\t\t\t\tnext.hours,\n\t\t\t\t\tnext.note,\n\t\t\t\t\tinput.id,\n\t\t\t\t);\n\t\t\t\twriteAuditLog(db, {\n\t\t\t\t\tatUtc: now,\n\t\t\t\t\tactorId: input.actorId,\n\t\t\t\t\taction: \"absence.update\",\n\t\t\t\t\tentity: \"absence\",\n\t\t\t\t\tentityId: input.id,\n\t\t\t\t\tdetail: { changes, reason: input.reason ?? null },\n\t\t\t\t\tip: input.actorIp ?? null,\n\t\t\t\t});\n\t\t\t});\n\t\t\trun();\n\n\t\t\tconst updated = read(input.id);\n\t\t\tif (!updated) {\n\t\t\t\tthrow new Error(`absence ${input.id} disappeared right after the update`);\n\t\t\t}\n\t\t\treturn updated;\n\t\t},\n\n\t\tsetStatus(input: {\n\t\t\tid: number;\n\t\t\tstatus: AbsenceStatus;\n\t\t\tactorId: number;\n\t\t\tactorIp?: string | null;\n\t\t\tnow?: number;\n\t\t}): AbsenceRecord {\n\t\t\tconst current = read(input.id);\n\t\t\tif (!current) {\n\t\t\t\tthrow new NotFoundError(`absence ${input.id} not found`);\n\t\t\t}\n\t\t\tif (current.status === input.status) {\n\t\t\t\treturn current;\n\t\t\t}\n\n\t\t\tconst now = input.now ?? Math.floor(Date.now() / 1000);\n\t\t\tconst run = db.transaction((): void => {\n\t\t\t\tupdateStatusStatement.run(input.status, input.id);\n\t\t\t\twriteAuditLog(db, {\n\t\t\t\t\tatUtc: now,\n\t\t\t\t\tactorId: input.actorId,\n\t\t\t\t\taction: \"absence.status\",\n\t\t\t\t\tentity: \"absence\",\n\t\t\t\t\tentityId: input.id,\n\t\t\t\t\tdetail: { changes: { status: { old: current.status, new: input.status } } },\n\t\t\t\t\tip: input.actorIp ?? null,\n\t\t\t\t});\n\t\t\t});\n\t\t\trun();\n\n\t\t\tconst updated = read(input.id);\n\t\t\tif (!updated) {\n\t\t\t\tthrow new Error(`absence ${input.id} disappeared right after the status change`);\n\t\t\t}\n\t\t\treturn updated;\n\t\t},\n\n\t\tremove(input: { id: number; actorId: number; actorIp?: string | null; now?: number }): boolean {\n\t\t\tconst current = read(input.id);\n\t\t\tif (!current) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\tconst now = input.now ?? Math.floor(Date.now() / 1000);\n\n\t\t\tconst run = db.transaction((): void => {\n\t\t\t\tdeleteAbsence.run(input.id);\n\t\t\t\twriteAuditLog(db, {\n\t\t\t\t\tatUtc: now,\n\t\t\t\t\tactorId: input.actorId,\n\t\t\t\t\taction: \"absence.delete\",\n\t\t\t\t\tentity: \"absence\",\n\t\t\t\t\tentityId: input.id,\n\t\t\t\t\tdetail: {\n\t\t\t\t\t\tuserId: current.userId,\n\t\t\t\t\t\tdateFrom: current.dateFrom,\n\t\t\t\t\t\tdateTo: current.dateTo,\n\t\t\t\t\t\tstatus: current.status,\n\t\t\t\t\t},\n\t\t\t\t\tip: input.actorIp ?? null,\n\t\t\t\t});\n\t\t\t});\n\t\t\trun();\n\t\t\treturn true;\n\t\t},\n\n\t\tlistByUser(userId: number, options?: { from?: string; to?: string; year?: number }): AbsenceRecord[] {\n\t\t\tconst from = options?.from ?? (options?.year === undefined ? \"0000-01-01\" : `${options.year}-01-01`);\n\t\t\tconst to = options?.to ?? (options?.year === undefined ? \"9999-12-31\" : `${options.year}-12-31`);\n\t\t\tconst rows = selectByUser.all(userId, from, to) as AbsenceRow[];\n\t\t\treturn rows.map(mapAbsenceRow);\n\t\t},\n\n\t\tforDate(userId: number, date: string): AbsenceRecord[] {\n\t\t\tconst day = requireDate(date, \"date\");\n\t\t\tconst rows = selectByUser.all(userId, day, day) as AbsenceRow[];\n\t\t\treturn rows.map(mapAbsenceRow);\n\t\t},\n\n\t\twithTypesInRange(userId: number, from: string, to: string): AbsenceWithType[] {\n\t\t\tconst rows = selectWithTypes.all(\n\t\t\t\tuserId,\n\t\t\t\trequireDate(from, \"from\"),\n\t\t\t\trequireDate(to, \"to\"),\n\t\t\t) as AbsenceWithTypeRow[];\n\t\t\treturn rows.map(row => ({\n\t\t\t\t...mapAbsenceRow(row),\n\t\t\t\ttypeCode: row.type_code,\n\t\t\t\ttypeName: row.type_name,\n\t\t\t\tpaid: row.type_paid !== 0,\n\t\t\t\tfactor: row.type_factor,\n\t\t\t\treduceVacation: row.type_reduce_vacation !== 0,\n\t\t\t}));\n\t\t},\n\t};\n}\n"],
+  "mappings": "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",
+  "names": ["_a", "_b", "_c"]
+}

package/build/lib/db/repositories/audit.js

@@ -0,0 +1,90 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var audit_exports = {};
+__export(audit_exports, {
+  diffFields: () => diffFields,
+  readTimeEntryAudit: () => readTimeEntryAudit,
+  writeAuditLog: () => writeAuditLog,
+  writeTimeEntryAudit: () => writeTimeEntryAudit
+});
+module.exports = __toCommonJS(audit_exports);
+function diffFields(before, after, fields) {
+  const changes = {};
+  for (const field of fields) {
+    if (before[field] !== after[field]) {
+      changes[String(field)] = { old: before[field], new: after[field] };
+    }
+  }
+  return changes;
+}
+function writeAuditLog(db, input) {
+  var _a, _b, _c, _d;
+  const result = db.prepare(
+    `INSERT INTO audit_log (at_utc, actor_id, action, entity, entity_id, detail, ip)
+			 VALUES (?, ?, ?, ?, ?, ?, ?)`
+  ).run(
+    (_a = input.atUtc) != null ? _a : Math.floor(Date.now() / 1e3),
+    (_b = input.actorId) != null ? _b : null,
+    input.action,
+    (_c = input.entity) != null ? _c : null,
+    input.entityId == null ? null : String(input.entityId),
+    input.detail === void 0 ? null : JSON.stringify(input.detail),
+    (_d = input.ip) != null ? _d : null
+  );
+  return Number(result.lastInsertRowid);
+}
+function writeTimeEntryAudit(db, input) {
+  var _a, _b, _c, _d, _e, _f;
+  const result = db.prepare(
+    `INSERT INTO time_entry_audit
+			 (entry_id, user_id, action, changes, old_ts_utc, new_ts_utc, revision, reason, actor_id, actor_ip, at_utc)
+			 VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`
+  ).run(
+    input.entryId,
+    input.userId,
+    input.action,
+    input.changes ? JSON.stringify(input.changes) : null,
+    (_a = input.oldTsUtc) != null ? _a : null,
+    (_b = input.newTsUtc) != null ? _b : null,
+    (_c = input.revision) != null ? _c : null,
+    (_d = input.reason) != null ? _d : null,
+    input.actorId,
+    (_e = input.actorIp) != null ? _e : null,
+    (_f = input.atUtc) != null ? _f : Math.floor(Date.now() / 1e3)
+  );
+  return Number(result.lastInsertRowid);
+}
+function readTimeEntryAudit(db, entryId) {
+  const rows = db.prepare(
+    `SELECT id, action, changes, revision, reason, actor_id AS actorId, at_utc AS atUtc
+			 FROM time_entry_audit WHERE entry_id = ? ORDER BY id DESC`
+  ).all(entryId);
+  return rows.map((row) => ({
+    ...row,
+    changes: row.changes ? JSON.parse(row.changes) : null
+  }));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  diffFields,
+  readTimeEntryAudit,
+  writeAuditLog,
+  writeTimeEntryAudit
+});
+//# sourceMappingURL=audit.js.map

package/build/lib/db/repositories/audit.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/lib/db/repositories/audit.ts"],
+  "sourcesContent": ["/**\n * Audit trail helpers: every change of a punch and every administrative action is recorded append-only.\n */\n\nimport type { Db } from \"../database\";\n\n/** A single change of one field. */\nexport interface FieldChange {\n\t/** Value before the change */\n\told: unknown;\n\t/** Value after the change */\n\tnew: unknown;\n}\n\n/**\n * Compares the old and the new value of every field and collects the differences.\n *\n * @param before - record before the change\n * @param after - record after the change\n * @param fields - field names to compare\n * @returns changed fields, empty when nothing changed\n */\nexport function diffFields<T extends Record<string, unknown>>(\n\tbefore: T,\n\tafter: T,\n\tfields: (keyof T)[],\n): Record<string, FieldChange> {\n\tconst changes: Record<string, FieldChange> = {};\n\tfor (const field of fields) {\n\t\tif (before[field] !== after[field]) {\n\t\t\tchanges[String(field)] = { old: before[field], new: after[field] };\n\t\t}\n\t}\n\treturn changes;\n}\n\n/** Input for a generic audit log entry. */\nexport interface AuditLogInput {\n\t/** Actor user id, `null` for system actions (import, scheduled jobs) */\n\tactorId?: number | null;\n\t/** Short action key, e.g. `entry.update`, `settings.set` */\n\taction: string;\n\t/** Affected entity, e.g. `time_entry`, `user` */\n\tentity?: string | null;\n\t/** Id of the affected entity */\n\tentityId?: string | number | null;\n\t/** Free-form detail (serialised as JSON) */\n\tdetail?: unknown;\n\t/** Client IP address */\n\tip?: string | null;\n\t/** Instant of the action, defaults to now */\n\tatUtc?: number;\n}\n\n/** Input for a punch audit entry. */\nexport interface TimeEntryAuditInput {\n\t/** Punch id, `null` when the punch was deleted */\n\tentryId: number | null;\n\t/** Owner of the punch */\n\tuserId: number;\n\t/** Kind of change */\n\taction: \"create\" | \"update\" | \"delete\";\n\t/** Changed fields (serialised as JSON) */\n\tchanges?: Record<string, FieldChange> | null;\n\t/** Timestamp before the change */\n\toldTsUtc?: number | null;\n\t/** Timestamp after the change */\n\tnewTsUtc?: number | null;\n\t/** Revision after the change */\n\trevision?: number | null;\n\t/** Mandatory reason for administrative corrections */\n\treason?: string | null;\n\t/** Who performed the change */\n\tactorId: number;\n\t/** Client IP address */\n\tactorIp?: string | null;\n\t/** Instant of the change, defaults to now */\n\tatUtc?: number;\n}\n\n/**\n * Writes an entry to the generic audit log.\n *\n * @param db - open database handle\n * @param input - audit information\n * @returns id of the created audit row\n */\nexport function writeAuditLog(db: Db, input: AuditLogInput): number {\n\tconst result = db\n\t\t.prepare(\n\t\t\t`INSERT INTO audit_log (at_utc, actor_id, action, entity, entity_id, detail, ip)\n\t\t\t VALUES (?, ?, ?, ?, ?, ?, ?)`,\n\t\t)\n\t\t.run(\n\t\t\tinput.atUtc ?? Math.floor(Date.now() / 1000),\n\t\t\tinput.actorId ?? null,\n\t\t\tinput.action,\n\t\t\tinput.entity ?? null,\n\t\t\tinput.entityId == null ? null : String(input.entityId),\n\t\t\tinput.detail === undefined ? null : JSON.stringify(input.detail),\n\t\t\tinput.ip ?? null,\n\t\t);\n\treturn Number(result.lastInsertRowid);\n}\n\n/**\n * Writes an entry to the punch audit trail (append-only).\n *\n * @param db - open database handle\n * @param input - punch audit information\n * @returns id of the created audit row\n */\nexport function writeTimeEntryAudit(db: Db, input: TimeEntryAuditInput): number {\n\tconst result = db\n\t\t.prepare(\n\t\t\t`INSERT INTO time_entry_audit\n\t\t\t (entry_id, user_id, action, changes, old_ts_utc, new_ts_utc, revision, reason, actor_id, actor_ip, at_utc)\n\t\t\t VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n\t\t)\n\t\t.run(\n\t\t\tinput.entryId,\n\t\t\tinput.userId,\n\t\t\tinput.action,\n\t\t\tinput.changes ? JSON.stringify(input.changes) : null,\n\t\t\tinput.oldTsUtc ?? null,\n\t\t\tinput.newTsUtc ?? null,\n\t\t\tinput.revision ?? null,\n\t\t\tinput.reason ?? null,\n\t\t\tinput.actorId,\n\t\t\tinput.actorIp ?? null,\n\t\t\tinput.atUtc ?? Math.floor(Date.now() / 1000),\n\t\t);\n\treturn Number(result.lastInsertRowid);\n}\n\n/**\n * Reads the audit trail of one punch (newest first).\n *\n * @param db - open database handle\n * @param entryId - punch id\n * @returns audit rows with parsed `changes`\n */\nexport function readTimeEntryAudit(\n\tdb: Db,\n\tentryId: number,\n): {\n\tid: number;\n\taction: string;\n\tchanges: Record<string, FieldChange> | null;\n\trevision: number | null;\n\treason: string | null;\n\tactorId: number;\n\tatUtc: number;\n}[] {\n\tconst rows = db\n\t\t.prepare(\n\t\t\t`SELECT id, action, changes, revision, reason, actor_id AS actorId, at_utc AS atUtc\n\t\t\t FROM time_entry_audit WHERE entry_id = ? ORDER BY id DESC`,\n\t\t)\n\t\t.all(entryId) as {\n\t\tid: number;\n\t\taction: string;\n\t\tchanges: string | null;\n\t\trevision: number | null;\n\t\treason: string | null;\n\t\tactorId: number;\n\t\tatUtc: number;\n\t}[];\n\n\treturn rows.map(row => ({\n\t\t...row,\n\t\tchanges: row.changes ? (JSON.parse(row.changes) as Record<string, FieldChange>) : null,\n\t}));\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAsBO,SAAS,WACf,QACA,OACA,QAC8B;AAC9B,QAAM,UAAuC,CAAC;AAC9C,aAAW,SAAS,QAAQ;AAC3B,QAAI,OAAO,KAAK,MAAM,MAAM,KAAK,GAAG;AACnC,cAAQ,OAAO,KAAK,CAAC,IAAI,EAAE,KAAK,OAAO,KAAK,GAAG,KAAK,MAAM,KAAK,EAAE;AAAA,IAClE;AAAA,EACD;AACA,SAAO;AACR;AAqDO,SAAS,cAAc,IAAQ,OAA8B;AAvFpE;AAwFC,QAAM,SAAS,GACb;AAAA,IACA;AAAA;AAAA,EAED,EACC;AAAA,KACA,WAAM,UAAN,YAAe,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI;AAAA,KAC3C,WAAM,YAAN,YAAiB;AAAA,IACjB,MAAM;AAAA,KACN,WAAM,WAAN,YAAgB;AAAA,IAChB,MAAM,YAAY,OAAO,OAAO,OAAO,MAAM,QAAQ;AAAA,IACrD,MAAM,WAAW,SAAY,OAAO,KAAK,UAAU,MAAM,MAAM;AAAA,KAC/D,WAAM,OAAN,YAAY;AAAA,EACb;AACD,SAAO,OAAO,OAAO,eAAe;AACrC;AASO,SAAS,oBAAoB,IAAQ,OAAoC;AAhHhF;AAiHC,QAAM,SAAS,GACb;AAAA,IACA;AAAA;AAAA;AAAA,EAGD,EACC;AAAA,IACA,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM,UAAU,KAAK,UAAU,MAAM,OAAO,IAAI;AAAA,KAChD,WAAM,aAAN,YAAkB;AAAA,KAClB,WAAM,aAAN,YAAkB;AAAA,KAClB,WAAM,aAAN,YAAkB;AAAA,KAClB,WAAM,WAAN,YAAgB;AAAA,IAChB,MAAM;AAAA,KACN,WAAM,YAAN,YAAiB;AAAA,KACjB,WAAM,UAAN,YAAe,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI;AAAA,EAC5C;AACD,SAAO,OAAO,OAAO,eAAe;AACrC;AASO,SAAS,mBACf,IACA,SASG;AACH,QAAM,OAAO,GACX;AAAA,IACA;AAAA;AAAA,EAED,EACC,IAAI,OAAO;AAUb,SAAO,KAAK,IAAI,UAAQ;AAAA,IACvB,GAAG;AAAA,IACH,SAAS,IAAI,UAAW,KAAK,MAAM,IAAI,OAAO,IAAoC;AAAA,EACnF,EAAE;AACH;",
+  "names": []
+}