iobroker.time-tracker 0.2.0

package/build/lib/adapter/commands.js

@@ -0,0 +1,160 @@
+"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 commands_exports = {};
+__export(commands_exports, {
+  handleCommand: () => handleCommand,
+  punchEmployee: () => punchEmployee
+});
+module.exports = __toCommonJS(commands_exports);
+var import_errors = require("../errors");
+var import_punch = require("../domain/punch");
+var import_time = require("../util/time");
+var import_states = require("./states");
+function parsePeriod(value) {
+  const monthMatch = /^(\d{4})-(\d{1,2})$/.exec(value.trim());
+  if (monthMatch) {
+    const month = Number(monthMatch[2]);
+    if (month < 1 || month > 12) {
+      throw new import_errors.ValidationError(`month must be between 1 and 12 (got ${value})`);
+    }
+    return { year: Number(monthMatch[1]), month };
+  }
+  const yearMatch = /^(\d{4})$/.exec(value.trim());
+  if (yearMatch) {
+    return { year: Number(yearMatch[1]), month: null };
+  }
+  throw new import_errors.ValidationError(`expected YYYY-MM or YYYY (got "${value}")`);
+}
+function targetUser(deps) {
+  var _a;
+  const configured = Number((_a = deps.settings.get("command_punch_user_id")) != null ? _a : Number.NaN);
+  const explicit = Number.isInteger(configured) ? deps.users.findById(configured) : null;
+  if (explicit) {
+    return explicit;
+  }
+  const candidates = deps.users.list();
+  if (candidates.length === 1) {
+    return candidates[0];
+  }
+  if (candidates.length === 0) {
+    throw new import_errors.ValidationError("no employee exists yet");
+  }
+  throw new import_errors.ValidationError("several employees exist - set command_punch_user_id or write users.<id> commands");
+}
+function punchEmployee(deps, input) {
+  var _a, _b, _c;
+  const target = deps.users.findById(input.userId);
+  if (!target) {
+    throw new import_errors.ValidationError(`employee ${input.userId} does not exist`);
+  }
+  if (!target.isActive) {
+    throw new import_errors.ValidationError(`${target.displayName} is deactivated, no punch was written`);
+  }
+  const now = (_a = deps.now) != null ? _a : (() => Math.floor(Date.now() / 1e3));
+  const timestamp = (_b = input.now) != null ? _b : now();
+  const quickRound = input.quick === true ? deps.settings.getNumber("quick_round_minutes", 0) : 0;
+  const tsUtc = quickRound > 0 ? (0, import_punch.roundToStep)(timestamp, quickRound, target.timezone) : timestamp;
+  const today = (0, import_time.localDate)(tsUtc, target.timezone);
+  const existing = deps.entries.listByDate(target.id, today).map((entry) => ({ id: entry.id, tsUtc: entry.tsUtc, syncState: entry.syncState }));
+  const direction = (0, import_punch.nextDirection)((0, import_punch.buildDayPunches)(existing));
+  const stored = deps.entries.insert({
+    userId: target.id,
+    tsUtc,
+    timeZone: target.timezone,
+    source: "api",
+    direction,
+    note: (_c = input.note) != null ? _c : null,
+    now: timestamp
+  });
+  const day = deps.aggregation.recalculateDay(target.id, stored.entry.localDate, { now: timestamp });
+  return {
+    ok: true,
+    message: `${target.displayName} punched ${direction} (${day.workedMin} min today, open: ${day.hasOpenEntry})`,
+    recalculated: [stored.entry.localDate]
+  };
+}
+function handleCommand(deps, id, value) {
+  var _a;
+  const now = (_a = deps.now) != null ? _a : (() => Math.floor(Date.now() / 1e3));
+  const timestamp = now();
+  if (id === import_states.COMMAND_IDS.closeMonth || id === import_states.COMMAND_IDS.recalc) {
+    const period = parsePeriod(String(value != null ? value : ""));
+    const target = targetUser(deps);
+    if (id === import_states.COMMAND_IDS.recalc) {
+      if (period.month === null) {
+        deps.aggregation.recalculateYear(target.id, period.year, { now: timestamp });
+        return { ok: true, message: `year ${period.year} recalculated`, recalculated: [] };
+      }
+      deps.aggregation.recalculateMonth(target.id, period.year, period.month, { now: timestamp });
+      return {
+        ok: true,
+        message: `month ${period.year}-${String(period.month).padStart(2, "0")} recalculated`,
+        recalculated: []
+      };
+    }
+    if (period.month === null) {
+      throw new import_errors.ValidationError("closing a month needs YYYY-MM");
+    }
+    const closed = deps.closing.closeMonth({
+      userId: target.id,
+      year: period.year,
+      month: period.month,
+      actorId: 0,
+      now: timestamp
+    });
+    return {
+      ok: true,
+      message: `month ${period.year}-${String(period.month).padStart(2, "0")} closed for ${target.displayName} (balance ${closed.month.balanceMin} min, overtime ${closed.month.overtimeMin} min)`,
+      recalculated: []
+    };
+  }
+  if (id === import_states.COMMAND_IDS.punch || id === import_states.COMMAND_IDS.quickPunch) {
+    if (value !== true) {
+      return { ok: false, message: "ignored (buttons act on true)", recalculated: [] };
+    }
+    const target = targetUser(deps);
+    return punchEmployee(deps, {
+      userId: target.id,
+      quick: id === import_states.COMMAND_IDS.quickPunch,
+      note: "command.punch",
+      now: timestamp
+    });
+  }
+  if (id === import_states.COMMAND_IDS.backup) {
+    if (value !== true) {
+      return { ok: false, message: "ignored (buttons act on true)", recalculated: [] };
+    }
+    if (!deps.backup) {
+      throw new import_errors.ValidationError("this instance has no backup service");
+    }
+    const created = deps.backup.create({ actorId: 0, reason: "command state" });
+    return {
+      ok: true,
+      message: `backup ${created.backup.name} written (${created.backup.sizeBytes} bytes, ${created.backup.entries} punches), ${created.removed.length} old file(s) removed`,
+      recalculated: []
+    };
+  }
+  throw new import_errors.ValidationError(`unknown command state ${id}`);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  handleCommand,
+  punchEmployee
+});
+//# sourceMappingURL=commands.js.map

package/build/lib/adapter/commands.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/adapter/commands.ts"],
+  "sourcesContent": ["/**\n * Command states of the adapter.\n *\n * The adapter reacts to the states below, so a script, a dashboard or another adapter can punch, close a month\n * or trigger a recalculation without the REST API. Commands are triggered from inside ioBroker, not from a\n * browser, so no session is involved; the audit trail records them with `actorId: 0` (system).\n */\n\nimport type { Db } from \"../db/database\";\nimport type { EntriesRepository } from \"../db/repositories/entries\";\nimport type { SettingsRepository } from \"../db/repositories/settings\";\nimport type { UsersRepository } from \"../db/repositories/users\";\nimport type { AggregationService } from \"../services/aggregation\";\nimport type { ClosingService } from \"../services/closing\";\nimport type { BackupService } from \"../services/backup\";\nimport { ValidationError } from \"../errors\";\nimport { buildDayPunches, nextDirection, roundToStep, type PunchEntry } from \"../domain/punch\";\nimport { localDate as resolveLocalDate } from \"../util/time\";\nimport { COMMAND_IDS } from \"./states\";\n\n/** Data sources of the command handler. */\nexport interface CommandDeps {\n\t/** Open database handle */\n\tdb: Db;\n\t/** Punch storage */\n\tentries: EntriesRepository;\n\t/** User storage */\n\tusers: UsersRepository;\n\t/** Instance settings (quick rounding, target employee) */\n\tsettings: SettingsRepository;\n\t/** Aggregation service */\n\taggregation: Pick<AggregationService, \"recalculateDay\" | \"recalculateMonth\" | \"recalculateYear\">;\n\t/** Closing service (month close) */\n\tclosing: Pick<ClosingService, \"closeMonth\">;\n\t/** Backup service (button `commands.backup`), optional */\n\tbackup?: Pick<BackupService, \"create\">;\n\t/** Instant source, defaults to the system clock */\n\tnow?: () => number;\n}\n\n/** Result of a command. */\nexport interface CommandResult {\n\t/** True when the command was executed */\n\tok: boolean;\n\t/** Human readable summary for the log */\n\tmessage: string;\n\t/** Local dates that were recalculated */\n\trecalculated: string[];\n}\n\n/** A period taken from a command value. */\ninterface Period {\n\t/** Four digit year */\n\tyear: number;\n\t/** Month (1 to 12) or `null` for a whole year */\n\tmonth: number | null;\n}\n\n/**\n * Parses a period string.\n *\n * @param value - `YYYY-MM` or `YYYY`\n * @returns the parsed period\n */\nfunction parsePeriod(value: string): Period {\n\tconst monthMatch = /^(\\d{4})-(\\d{1,2})$/.exec(value.trim());\n\tif (monthMatch) {\n\t\tconst month = Number(monthMatch[2]);\n\t\tif (month < 1 || month > 12) {\n\t\t\tthrow new ValidationError(`month must be between 1 and 12 (got ${value})`);\n\t\t}\n\t\treturn { year: Number(monthMatch[1]), month };\n\t}\n\n\tconst yearMatch = /^(\\d{4})$/.exec(value.trim());\n\tif (yearMatch) {\n\t\treturn { year: Number(yearMatch[1]), month: null };\n\t}\n\tthrow new ValidationError(`expected YYYY-MM or YYYY (got \"${value}\")`);\n}\n\n/**\n * Resolves the employee a command applies to: the only one, or the configured one.\n *\n * @param deps - data sources\n * @returns the employee\n */\nfunction targetUser(deps: CommandDeps): { id: number; displayName: string; timezone: string } {\n\tconst configured = Number(deps.settings.get(\"command_punch_user_id\") ?? Number.NaN);\n\tconst explicit = Number.isInteger(configured) ? deps.users.findById(configured) : null;\n\tif (explicit) {\n\t\treturn explicit;\n\t}\n\n\tconst candidates = deps.users.list();\n\tif (candidates.length === 1) {\n\t\treturn candidates[0];\n\t}\n\tif (candidates.length === 0) {\n\t\tthrow new ValidationError(\"no employee exists yet\");\n\t}\n\tthrow new ValidationError(\"several employees exist - set command_punch_user_id or write users.<id> commands\");\n}\n\n/** Data a punch needs: where to write, how to round and how to recalculate. */\nexport type PunchDeps = Pick<CommandDeps, \"entries\" | \"users\" | \"settings\" | \"aggregation\" | \"now\">;\n\n/**\n * Punches in or out for one employee.\n *\n * This is the single punch path of the adapter: the `commands.punch` button, a trigger rule and a `sendTo`\n * message all end up here, so direction, rounding, note and recalculation behave the same everywhere.\n *\n * @param deps - data sources\n * @param input - employee, rounding and note\n * @param input.userId - employee the punch belongs to\n * @param input.quick - true to round the instant with the configured quick rounding\n * @param input.note - note stored with the punch\n * @param input.now - instant of the punch, defaults to the system clock\n * @returns result of the punch\n */\nexport function punchEmployee(\n\tdeps: PunchDeps,\n\tinput: { userId: number; quick?: boolean; note?: string; now?: number },\n): CommandResult {\n\tconst target = deps.users.findById(input.userId);\n\tif (!target) {\n\t\tthrow new ValidationError(`employee ${input.userId} does not exist`);\n\t}\n\tif (!target.isActive) {\n\t\tthrow new ValidationError(`${target.displayName} is deactivated, no punch was written`);\n\t}\n\n\tconst now = deps.now ?? (() => Math.floor(Date.now() / 1000));\n\tconst timestamp = input.now ?? now();\n\tconst quickRound = input.quick === true ? deps.settings.getNumber(\"quick_round_minutes\", 0) : 0;\n\tconst tsUtc = quickRound > 0 ? roundToStep(timestamp, quickRound, target.timezone) : timestamp;\n\tconst today = resolveLocalDate(tsUtc, target.timezone);\n\n\tconst existing: PunchEntry[] = deps.entries\n\t\t.listByDate(target.id, today)\n\t\t.map(entry => ({ id: entry.id, tsUtc: entry.tsUtc, syncState: entry.syncState }));\n\tconst direction = nextDirection(buildDayPunches(existing));\n\n\tconst stored = deps.entries.insert({\n\t\tuserId: target.id,\n\t\ttsUtc,\n\t\ttimeZone: target.timezone,\n\t\tsource: \"api\",\n\t\tdirection,\n\t\tnote: input.note ?? null,\n\t\tnow: timestamp,\n\t});\n\tconst day = deps.aggregation.recalculateDay(target.id, stored.entry.localDate, { now: timestamp });\n\n\treturn {\n\t\tok: true,\n\t\tmessage: `${target.displayName} punched ${direction} (${day.workedMin} min today, open: ${day.hasOpenEntry})`,\n\t\trecalculated: [stored.entry.localDate],\n\t};\n}\n\n/**\n * Handles a command state.\n *\n * @param deps - data sources\n * @param id - state id that was written (without the instance prefix)\n * @param value - value that was written\n * @returns result of the command\n */\nexport function handleCommand(deps: CommandDeps, id: string, value: ioBroker.StateValue): CommandResult {\n\tconst now = deps.now ?? (() => Math.floor(Date.now() / 1000));\n\tconst timestamp = now();\n\n\tif (id === COMMAND_IDS.closeMonth || id === COMMAND_IDS.recalc) {\n\t\tconst period = parsePeriod(String(value ?? \"\"));\n\t\tconst target = targetUser(deps);\n\n\t\tif (id === COMMAND_IDS.recalc) {\n\t\t\tif (period.month === null) {\n\t\t\t\tdeps.aggregation.recalculateYear(target.id, period.year, { now: timestamp });\n\t\t\t\treturn { ok: true, message: `year ${period.year} recalculated`, recalculated: [] };\n\t\t\t}\n\t\t\tdeps.aggregation.recalculateMonth(target.id, period.year, period.month, { now: timestamp });\n\t\t\treturn {\n\t\t\t\tok: true,\n\t\t\t\tmessage: `month ${period.year}-${String(period.month).padStart(2, \"0\")} recalculated`,\n\t\t\t\trecalculated: [],\n\t\t\t};\n\t\t}\n\n\t\tif (period.month === null) {\n\t\t\tthrow new ValidationError(\"closing a month needs YYYY-MM\");\n\t\t}\n\t\tconst closed = deps.closing.closeMonth({\n\t\t\tuserId: target.id,\n\t\t\tyear: period.year,\n\t\t\tmonth: period.month,\n\t\t\tactorId: 0,\n\t\t\tnow: timestamp,\n\t\t});\n\t\treturn {\n\t\t\tok: true,\n\t\t\tmessage: `month ${period.year}-${String(period.month).padStart(2, \"0\")} closed for ${target.displayName} (balance ${closed.month.balanceMin} min, overtime ${closed.month.overtimeMin} min)`,\n\t\t\trecalculated: [],\n\t\t};\n\t}\n\n\tif (id === COMMAND_IDS.punch || id === COMMAND_IDS.quickPunch) {\n\t\tif (value !== true) {\n\t\t\t// buttons only act on `true`\n\t\t\treturn { ok: false, message: \"ignored (buttons act on true)\", recalculated: [] };\n\t\t}\n\n\t\tconst target = targetUser(deps);\n\t\treturn punchEmployee(deps, {\n\t\t\tuserId: target.id,\n\t\t\tquick: id === COMMAND_IDS.quickPunch,\n\t\t\tnote: \"command.punch\",\n\t\t\tnow: timestamp,\n\t\t});\n\t}\n\n\tif (id === COMMAND_IDS.backup) {\n\t\tif (value !== true) {\n\t\t\t// buttons only act on `true`\n\t\t\treturn { ok: false, message: \"ignored (buttons act on true)\", recalculated: [] };\n\t\t}\n\t\tif (!deps.backup) {\n\t\t\tthrow new ValidationError(\"this instance has no backup service\");\n\t\t}\n\n\t\tconst created = deps.backup.create({ actorId: 0, reason: \"command state\" });\n\t\treturn {\n\t\t\tok: true,\n\t\t\tmessage: `backup ${created.backup.name} written (${created.backup.sizeBytes} bytes, ${created.backup.entries} punches), ${created.removed.length} old file(s) removed`,\n\t\t\trecalculated: [],\n\t\t};\n\t}\n\n\tthrow new ValidationError(`unknown command state ${id}`);\n}\n"],
+  "mappings": "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",
+  "names": ["resolveLocalDate"]
+}

package/build/lib/adapter/messages.js

@@ -0,0 +1,207 @@
+"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 messages_exports = {};
+__export(messages_exports, {
+  handleMessage: () => handleMessage
+});
+module.exports = __toCommonJS(messages_exports);
+var import_errors = require("../errors");
+var import_pdf = require("../reports/pdf");
+var import_labels = require("../reports/labels");
+var import_types = require("../reports/types");
+var import_xls = require("../reports/xls");
+var import_time = require("../util/time");
+var import_commands = require("./commands");
+var import_presence = require("./presence");
+var import_states = require("./states");
+var import_triggers = require("./triggers");
+function textField(payload, field) {
+  const value = payload[field];
+  if (value === void 0 || value === null) {
+    return null;
+  }
+  if (typeof value === "number" || typeof value === "boolean") {
+    return String(value);
+  }
+  if (typeof value !== "string") {
+    throw new import_errors.ValidationError(`${field} must be a string (got ${typeof value})`);
+  }
+  return value.trim() || null;
+}
+function booleanField(payload, field) {
+  const value = payload[field];
+  if (value === void 0 || value === null) {
+    return null;
+  }
+  if (typeof value === "boolean") {
+    return value;
+  }
+  if (typeof value === "number") {
+    return value !== 0;
+  }
+  if (typeof value === "string") {
+    const normalized = value.trim().toLowerCase();
+    if (["true", "1", "yes", "on"].includes(normalized)) {
+      return true;
+    }
+    if (["false", "0", "no", "off", ""].includes(normalized)) {
+      return false;
+    }
+  }
+  throw new import_errors.ValidationError(`${field} must be a boolean (got ${JSON.stringify(value)})`);
+}
+function targetUser(payload, users) {
+  var _a;
+  const raw = (_a = payload.user) != null ? _a : payload.userId;
+  if (raw === void 0 || raw === null || raw === "") {
+    throw new import_errors.ValidationError("user is required: pass a user id, a login or the shown name");
+  }
+  const asText = typeof raw === "string" || typeof raw === "number" ? String(raw) : JSON.stringify(raw);
+  const user = (0, import_triggers.resolveTriggerUser)(typeof raw === "number" ? raw : asText, users);
+  if (!user) {
+    throw new import_errors.ValidationError(`no employee matches ${asText}`);
+  }
+  return user;
+}
+function statementInput(deps, user, year, month) {
+  var _a, _b;
+  const timestamp = ((_a = deps.now) != null ? _a : (() => Math.floor(Date.now() / 1e3)))();
+  const prefix = `${year}-${String(month).padStart(2, "0")}`;
+  const first = `${prefix}-01`;
+  const lastDay = new Date(Date.UTC(year, month, 0)).getUTCDate();
+  const last = `${prefix}-${String(lastDay).padStart(2, "0")}`;
+  deps.aggregation.recalculateRange(user.id, first, last, { now: timestamp });
+  const { labels, language } = (0, import_labels.reportLabels)(user.locale);
+  return {
+    user: { displayName: user.displayName, login: user.login, timezone: user.timezone },
+    labels,
+    language,
+    locale: user.locale || "en",
+    year,
+    month,
+    days: deps.aggregation.days(user.id, first, last),
+    absences: deps.absences.withTypesInRange(user.id, first, last).map((absence) => ({
+      typeCode: absence.typeCode,
+      typeName: absence.typeName,
+      dateFrom: absence.dateFrom,
+      dateTo: absence.dateTo,
+      dayPortion: absence.dayPortion,
+      hours: absence.hours
+    })),
+    generatedAt: timestamp,
+    generator: `time-tracker ${(_b = deps.version) != null ? _b : ""}`.trim()
+  };
+}
+async function handleMessage(deps, command, payload) {
+  var _a, _b, _c, _d, _e;
+  const body = payload != null ? payload : {};
+  const now = (_a = deps.now) != null ? _a : (() => Math.floor(Date.now() / 1e3));
+  if (command === "punch") {
+    const user = targetUser(body, deps.users);
+    const result = (0, import_commands.punchEmployee)(
+      { entries: deps.entries, users: deps.users, settings: deps.settings, aggregation: deps.aggregation },
+      {
+        userId: user.id,
+        quick: booleanField(body, "quick") === true,
+        note: (_b = textField(body, "note")) != null ? _b : "sendTo.punch",
+        now: now()
+      }
+    );
+    return { ok: true, message: result.message, data: { userId: user.id, message: result.message } };
+  }
+  if (command === "present") {
+    const user = targetUser(body, deps.users);
+    const desired = booleanField(body, "present");
+    if (desired === null) {
+      throw new import_errors.ValidationError("present is required: pass true or false");
+    }
+    const result = (0, import_presence.handlePresenceState)(
+      { entries: deps.entries, users: deps.users, aggregation: deps.aggregation, now },
+      `users.${user.id}.present`,
+      desired
+    );
+    return {
+      ok: result.ok,
+      message: result.message,
+      data: { userId: user.id, present: result.present, changed: result.changed }
+    };
+  }
+  if (command === "status") {
+    const user = targetUser(body, deps.users);
+    const snapshot = (0, import_states.readUserSnapshot)({
+      aggregation: deps.aggregation,
+      users: deps.users,
+      sync: deps.sync,
+      userId: user.id,
+      now: now()
+    });
+    if (!snapshot) {
+      throw new import_errors.ValidationError(`employee ${user.id} disappeared`);
+    }
+    return { ok: true, message: `figures of ${user.displayName}`, data: { ...snapshot } };
+  }
+  if (command === "report") {
+    const user = targetUser(body, deps.users);
+    const format = ((_c = textField(body, "format")) != null ? _c : "pdf").toLowerCase();
+    if (format !== "pdf" && format !== "xlsx") {
+      throw new import_errors.ValidationError(`format must be pdf or xlsx (got ${format})`);
+    }
+    const period = (_d = textField(body, "period")) != null ? _d : (0, import_time.localDate)(now(), user.timezone).slice(0, 7);
+    const match = /^(\d{4})-(\d{2})$/.exec(period);
+    if (!match) {
+      throw new import_errors.ValidationError(`period must be YYYY-MM (got "${period}")`);
+    }
+    const year = Number(match[1]);
+    const month = Number(match[2]);
+    if (month < 1 || month > 12) {
+      throw new import_errors.ValidationError(`month must be between 1 and 12 (got ${month})`);
+    }
+    const input = statementInput(deps, user, year, month);
+    const file = format === "pdf" ? await (0, import_pdf.buildMonthStatement)({ ...input, fontPath: (_e = deps.settings.get("report_font_path")) != null ? _e : "" }) : await (0, import_xls.buildMonthReport)(input);
+    const fileName = (0, import_types.reportFileName)(user.login, year, month, format === "pdf" ? "pdf" : "xlsx");
+    return {
+      ok: true,
+      message: `${fileName} (${file.length} bytes)`,
+      data: {
+        userId: user.id,
+        fileName,
+        mimeType: format === "pdf" ? "application/pdf" : "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+        bytes: file.length,
+        base64: file.toString("base64")
+      }
+    };
+  }
+  if (command === "backup") {
+    if (!deps.backup) {
+      throw new import_errors.ValidationError("this instance has no backup service");
+    }
+    const created = deps.backup.create({ actorId: 0, reason: "sendTo" });
+    return {
+      ok: true,
+      message: `backup ${created.backup.name} written (${created.backup.sizeBytes} bytes)`,
+      data: { name: created.backup.name, sizeBytes: created.backup.sizeBytes, removed: created.removed }
+    };
+  }
+  throw new import_errors.ValidationError(`unknown command "${command}": use punch, present, status, report or backup`);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  handleMessage
+});
+//# sourceMappingURL=messages.js.map

package/build/lib/adapter/messages.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/adapter/messages.ts"],
+  "sourcesContent": ["/**\n * Messages of the adapter (`sendTo`).\n *\n * A script adapter, Blockly or another adapter can drive the time tracking without HTTP and without a session:\n * `sendTo(\"time-tracker.0\", \"punch\", { user: \"anna\" }, callback)`. Every command answers with an object, so the\n * caller can react on the outcome.\n *\n * | Command   | Payload                                   | Answer                                |\n * | --------- | ----------------------------------------- | ------------------------------------- |\n * | `punch`   | `{ user, quick?, note? }`                 | `{ userId, message }`                 |\n * | `present` | `{ user, present }`                       | `{ userId, present, changed }`        |\n * | `status`  | `{ user }`                                | figures of the employee               |\n * | `report`  | `{ user, period?, format? }`              | `{ fileName, mimeType, base64 }`      |\n * | `backup`  | \u2014                                         | `{ name, sizeBytes }`                 |\n *\n * `user` is a user id, a login or the shown name \u2014 the same resolution the trigger rules use.\n */\n\nimport type { AbsencesRepository } from \"../db/repositories/absences\";\nimport type { EntriesRepository } from \"../db/repositories/entries\";\nimport type { SettingsRepository } from \"../db/repositories/settings\";\nimport type { UserRecord, UsersRepository } from \"../db/repositories/users\";\nimport type { AggregationService } from \"../services/aggregation\";\nimport type { BackupService } from \"../services/backup\";\nimport type { SyncService } from \"../services/sync\";\nimport { ValidationError } from \"../errors\";\nimport { buildMonthStatement } from \"../reports/pdf\";\nimport { reportLabels } from \"../reports/labels\";\nimport { reportFileName, type ReportInput } from \"../reports/types\";\nimport { buildMonthReport } from \"../reports/xls\";\nimport { localDate } from \"../util/time\";\nimport { punchEmployee } from \"./commands\";\nimport { handlePresenceState } from \"./presence\";\nimport { readUserSnapshot } from \"./states\";\nimport { resolveTriggerUser } from \"./triggers\";\n\n/** Data a message needs. */\nexport interface MessageDeps {\n\t/** User storage */\n\tusers: UsersRepository;\n\t/** Punch storage */\n\tentries: EntriesRepository;\n\t/** Absences (the monthly statement shows them) */\n\tabsences: AbsencesRepository;\n\t/** Instance settings (quick rounding, font of the statements) */\n\tsettings: SettingsRepository;\n\t/** Aggregation service */\n\taggregation: AggregationService;\n\t/** Synchronisation service (open conflicts) */\n\tsync: SyncService;\n\t/** Backup service, optional: without it the command is refused */\n\tbackup?: Pick<BackupService, \"create\">;\n\t/** Version printed into a generated statement */\n\tversion?: string;\n\t/** Instant source, defaults to the system clock */\n\tnow?: () => number;\n}\n\n/** Answer of a message. */\nexport interface MessageResult {\n\t/** True when the command ran */\n\tok: boolean;\n\t/** Human readable summary */\n\tmessage: string;\n\t/** Command specific answer for the caller of `sendTo` */\n\tdata?: Record<string, unknown>;\n}\n\n/**\n * Reads a text field of a message payload.\n *\n * @param payload - payload of the message\n * @param field - field name\n * @returns the trimmed text or `null`\n */\nfunction textField(payload: Record<string, unknown>, field: string): string | null {\n\tconst value = payload[field];\n\tif (value === undefined || value === null) {\n\t\treturn null;\n\t}\n\tif (typeof value === \"number\" || typeof value === \"boolean\") {\n\t\treturn String(value);\n\t}\n\tif (typeof value !== \"string\") {\n\t\tthrow new ValidationError(`${field} must be a string (got ${typeof value})`);\n\t}\n\treturn value.trim() || null;\n}\n\n/**\n * Reads a boolean field of a message payload.\n *\n * @param payload - payload of the message\n * @param field - field name\n * @returns the boolean, or `null` when the field is missing\n */\nfunction booleanField(payload: Record<string, unknown>, field: string): boolean | null {\n\tconst value = payload[field];\n\tif (value === undefined || value === null) {\n\t\treturn null;\n\t}\n\tif (typeof value === \"boolean\") {\n\t\treturn value;\n\t}\n\tif (typeof value === \"number\") {\n\t\treturn value !== 0;\n\t}\n\tif (typeof value === \"string\") {\n\t\tconst normalized = value.trim().toLowerCase();\n\t\tif ([\"true\", \"1\", \"yes\", \"on\"].includes(normalized)) {\n\t\t\treturn true;\n\t\t}\n\t\tif ([\"false\", \"0\", \"no\", \"off\", \"\"].includes(normalized)) {\n\t\t\treturn false;\n\t\t}\n\t}\n\tthrow new ValidationError(`${field} must be a boolean (got ${JSON.stringify(value)})`);\n}\n\n/**\n * Resolves the employee a message names.\n *\n * @param payload - payload of the message\n * @param users - user storage\n * @returns the employee\n */\nfunction targetUser(payload: Record<string, unknown>, users: UsersRepository): UserRecord {\n\tconst raw = payload.user ?? payload.userId;\n\tif (raw === undefined || raw === null || raw === \"\") {\n\t\tthrow new ValidationError(\"user is required: pass a user id, a login or the shown name\");\n\t}\n\t// a value of another type cannot name an employee; it is only reported back\n\tconst asText = typeof raw === \"string\" || typeof raw === \"number\" ? String(raw) : JSON.stringify(raw);\n\tconst user = resolveTriggerUser(typeof raw === \"number\" ? raw : asText, users);\n\tif (!user) {\n\t\tthrow new ValidationError(`no employee matches ${asText}`);\n\t}\n\treturn user;\n}\n\n/**\n * Builds the input of a monthly statement.\n *\n * @param deps - data sources\n * @param user - employee the statement belongs to\n * @param year - four digit year\n * @param month - month, 1 to 12\n * @returns the report input including the generator line\n */\nfunction statementInput(\n\tdeps: MessageDeps,\n\tuser: UserRecord,\n\tyear: number,\n\tmonth: number,\n): ReportInput & { generator: string } {\n\tconst timestamp = (deps.now ?? (() => Math.floor(Date.now() / 1000)))();\n\tconst prefix = `${year}-${String(month).padStart(2, \"0\")}`;\n\tconst first = `${prefix}-01`;\n\tconst lastDay = new Date(Date.UTC(year, month, 0)).getUTCDate();\n\tconst last = `${prefix}-${String(lastDay).padStart(2, \"0\")}`;\n\t// a statement has to show the current state of the month, so the range is recalculated first\n\tdeps.aggregation.recalculateRange(user.id, first, last, { now: timestamp });\n\tconst { labels, language } = reportLabels(user.locale);\n\n\treturn {\n\t\tuser: { displayName: user.displayName, login: user.login, timezone: user.timezone },\n\t\tlabels,\n\t\tlanguage,\n\t\tlocale: user.locale || \"en\",\n\t\tyear,\n\t\tmonth,\n\t\tdays: deps.aggregation.days(user.id, first, last),\n\t\tabsences: deps.absences.withTypesInRange(user.id, first, last).map(absence => ({\n\t\t\ttypeCode: absence.typeCode,\n\t\t\ttypeName: absence.typeName,\n\t\t\tdateFrom: absence.dateFrom,\n\t\t\tdateTo: absence.dateTo,\n\t\t\tdayPortion: absence.dayPortion,\n\t\t\thours: absence.hours,\n\t\t})),\n\t\tgeneratedAt: timestamp,\n\t\tgenerator: `time-tracker ${deps.version ?? \"\"}`.trim(),\n\t};\n}\n\n/**\n * Applies a message of a script, a Blockly block or another adapter.\n *\n * @param deps - data sources\n * @param command - name of the command\n * @param payload - payload of the message\n * @returns the answer for the caller\n */\nexport async function handleMessage(deps: MessageDeps, command: string, payload: unknown): Promise<MessageResult> {\n\tconst body = (payload ?? {}) as Record<string, unknown>;\n\tconst now = deps.now ?? (() => Math.floor(Date.now() / 1000));\n\n\tif (command === \"punch\") {\n\t\tconst user = targetUser(body, deps.users);\n\t\tconst result = punchEmployee(\n\t\t\t{ entries: deps.entries, users: deps.users, settings: deps.settings, aggregation: deps.aggregation },\n\t\t\t{\n\t\t\t\tuserId: user.id,\n\t\t\t\tquick: booleanField(body, \"quick\") === true,\n\t\t\t\tnote: textField(body, \"note\") ?? \"sendTo.punch\",\n\t\t\t\tnow: now(),\n\t\t\t},\n\t\t);\n\t\treturn { ok: true, message: result.message, data: { userId: user.id, message: result.message } };\n\t}\n\n\tif (command === \"present\") {\n\t\tconst user = targetUser(body, deps.users);\n\t\tconst desired = booleanField(body, \"present\");\n\t\tif (desired === null) {\n\t\t\tthrow new ValidationError(\"present is required: pass true or false\");\n\t\t}\n\t\tconst result = handlePresenceState(\n\t\t\t{ entries: deps.entries, users: deps.users, aggregation: deps.aggregation, now },\n\t\t\t`users.${user.id}.present`,\n\t\t\tdesired,\n\t\t);\n\t\treturn {\n\t\t\tok: result.ok,\n\t\t\tmessage: result.message,\n\t\t\tdata: { userId: user.id, present: result.present, changed: result.changed },\n\t\t};\n\t}\n\n\tif (command === \"status\") {\n\t\tconst user = targetUser(body, deps.users);\n\t\tconst snapshot = readUserSnapshot({\n\t\t\taggregation: deps.aggregation,\n\t\t\tusers: deps.users,\n\t\t\tsync: deps.sync,\n\t\t\tuserId: user.id,\n\t\t\tnow: now(),\n\t\t});\n\t\tif (!snapshot) {\n\t\t\tthrow new ValidationError(`employee ${user.id} disappeared`);\n\t\t}\n\t\treturn { ok: true, message: `figures of ${user.displayName}`, data: { ...snapshot } };\n\t}\n\n\tif (command === \"report\") {\n\t\tconst user = targetUser(body, deps.users);\n\t\tconst format = (textField(body, \"format\") ?? \"pdf\").toLowerCase();\n\t\tif (format !== \"pdf\" && format !== \"xlsx\") {\n\t\t\tthrow new ValidationError(`format must be pdf or xlsx (got ${format})`);\n\t\t}\n\t\tconst period = textField(body, \"period\") ?? localDate(now(), user.timezone).slice(0, 7);\n\t\tconst match = /^(\\d{4})-(\\d{2})$/.exec(period);\n\t\tif (!match) {\n\t\t\tthrow new ValidationError(`period must be YYYY-MM (got \"${period}\")`);\n\t\t}\n\t\tconst year = Number(match[1]);\n\t\tconst month = Number(match[2]);\n\t\tif (month < 1 || month > 12) {\n\t\t\tthrow new ValidationError(`month must be between 1 and 12 (got ${month})`);\n\t\t}\n\n\t\tconst input = statementInput(deps, user, year, month);\n\t\tconst file =\n\t\t\tformat === \"pdf\"\n\t\t\t\t? await buildMonthStatement({ ...input, fontPath: deps.settings.get(\"report_font_path\") ?? \"\" })\n\t\t\t\t: await buildMonthReport(input);\n\t\tconst fileName = reportFileName(user.login, year, month, format === \"pdf\" ? \"pdf\" : \"xlsx\");\n\n\t\treturn {\n\t\t\tok: true,\n\t\t\tmessage: `${fileName} (${file.length} bytes)`,\n\t\t\tdata: {\n\t\t\t\tuserId: user.id,\n\t\t\t\tfileName,\n\t\t\t\tmimeType:\n\t\t\t\t\tformat === \"pdf\"\n\t\t\t\t\t\t? \"application/pdf\"\n\t\t\t\t\t\t: \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\",\n\t\t\t\tbytes: file.length,\n\t\t\t\tbase64: file.toString(\"base64\"),\n\t\t\t},\n\t\t};\n\t}\n\n\tif (command === \"backup\") {\n\t\tif (!deps.backup) {\n\t\t\tthrow new ValidationError(\"this instance has no backup service\");\n\t\t}\n\t\tconst created = deps.backup.create({ actorId: 0, reason: \"sendTo\" });\n\t\treturn {\n\t\t\tok: true,\n\t\t\tmessage: `backup ${created.backup.name} written (${created.backup.sizeBytes} bytes)`,\n\t\t\tdata: { name: created.backup.name, sizeBytes: created.backup.sizeBytes, removed: created.removed },\n\t\t};\n\t}\n\n\tthrow new ValidationError(`unknown command \"${command}\": use punch, present, status, report or backup`);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/build/lib/adapter/presence.js

@@ -0,0 +1,129 @@
+"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 presence_exports = {};
+__export(presence_exports, {
+  PRESENCE_SUFFIX: () => PRESENCE_SUFFIX,
+  handlePresenceState: () => handlePresenceState,
+  parsePresenceStateId: () => parsePresenceStateId,
+  readPresenceValue: () => readPresenceValue
+});
+module.exports = __toCommonJS(presence_exports);
+var import_punch = require("../domain/punch");
+var import_time = require("../util/time");
+const PRESENCE_SUFFIX = "present";
+function parsePresenceStateId(localId) {
+  const match = /^users\.(\d+)\.present$/.exec(localId.trim());
+  return match ? Number(match[1]) : null;
+}
+function readPresenceValue(value) {
+  if (typeof value === "boolean") {
+    return value;
+  }
+  if (typeof value === "number") {
+    return value === 1 ? true : value === 0 ? false : null;
+  }
+  if (typeof value === "string") {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "true" || normalized === "1" || normalized === "on") {
+      return true;
+    }
+    if (normalized === "false" || normalized === "0" || normalized === "off" || normalized === "") {
+      return false;
+    }
+  }
+  return null;
+}
+function handlePresenceState(deps, localId, value) {
+  var _a;
+  const userId = parsePresenceStateId(localId);
+  if (userId === null) {
+    return {
+      ok: false,
+      message: `"${localId}" is not a presence state`,
+      userId: null,
+      present: false,
+      changed: false
+    };
+  }
+  const desired = readPresenceValue(value);
+  if (desired === null) {
+    return {
+      ok: false,
+      message: `write true or false (got ${JSON.stringify(value)})`,
+      userId,
+      present: false,
+      changed: false
+    };
+  }
+  const user = deps.users.findById(userId);
+  if (!user) {
+    return { ok: false, message: `employee ${userId} does not exist`, userId, present: false, changed: false };
+  }
+  if (!user.isActive) {
+    return {
+      ok: false,
+      message: `${user.displayName} is deactivated, no punch was written`,
+      userId,
+      present: false,
+      changed: false
+    };
+  }
+  const now = (_a = deps.now) != null ? _a : (() => Math.floor(Date.now() / 1e3));
+  const timestamp = now();
+  const today = (0, import_time.localDate)(timestamp, user.timezone);
+  const existing = deps.entries.listByDate(user.id, today).map((entry) => ({ id: entry.id, tsUtc: entry.tsUtc, syncState: entry.syncState }));
+  const present = (0, import_punch.nextDirection)((0, import_punch.buildDayPunches)(existing)) === "out";
+  if (present === desired) {
+    return {
+      ok: true,
+      message: `${user.displayName} is already ${desired ? "present" : "absent"} (no punch written)`,
+      userId: user.id,
+      present: desired,
+      changed: false,
+      localDate: today
+    };
+  }
+  const direction = desired ? "in" : "out";
+  const stored = deps.entries.insert({
+    userId: user.id,
+    tsUtc: timestamp,
+    timeZone: user.timezone,
+    source: "api",
+    direction,
+    note: "state.present",
+    now: timestamp
+  });
+  const day = deps.aggregation.recalculateDay(user.id, stored.entry.localDate, { now: timestamp });
+  return {
+    ok: true,
+    message: `${user.displayName} punched ${direction} from the presence state (${day.workedMin} min today, present: ${day.hasOpenEntry})`,
+    userId: user.id,
+    present: day.hasOpenEntry,
+    changed: true,
+    localDate: stored.entry.localDate
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PRESENCE_SUFFIX,
+  handlePresenceState,
+  parsePresenceStateId,
+  readPresenceValue
+});
+//# sourceMappingURL=presence.js.map

package/build/lib/adapter/presence.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/adapter/presence.ts"],
+  "sourcesContent": ["/**\n * Presence state of an employee (`users.<userId>.present`).\n *\n * `present` is the writable twin of `users.<userId>.hasOpenEntry`: writing `true` opens an entry \u2014 paid working\n * time starts \u2014 and writing `false` closes it. A fingerprint reader, an RFID bridge, a dashboard or a plain script\n * can therefore tell the adapter that somebody arrived or left, without speaking to the REST API.\n *\n * The write is idempotent: `true` while the day is already open does not create a second punch, so a reader that\n * fires twice is harmless. Punches written this way are recorded like any other one (`source: \"api\"`, note\n * `state.present`), so they appear in the entry list and in the audit trail, just like `commands.*`.\n */\n\nimport type { EntriesRepository } from \"../db/repositories/entries\";\nimport type { UsersRepository } from \"../db/repositories/users\";\nimport type { AggregationService } from \"../services/aggregation\";\nimport { buildDayPunches, nextDirection, type PunchEntry } from \"../domain/punch\";\nimport { localDate as resolveLocalDate } from \"../util/time\";\n\n/** Suffix of the writable presence state. */\nexport const PRESENCE_SUFFIX = \"present\";\n\n/** Data sources of the presence handler. */\nexport interface PresenceDeps {\n\t/** Punch storage */\n\tentries: EntriesRepository;\n\t/** User storage */\n\tusers: UsersRepository;\n\t/** Aggregation service */\n\taggregation: Pick<AggregationService, \"recalculateDay\">;\n\t/** Instant source, defaults to the system clock */\n\tnow?: () => number;\n}\n\n/** Result of a write on a presence state. */\nexport interface PresenceResult {\n\t/** True when the write was understood, even when nothing changed */\n\tok: boolean;\n\t/** Human readable summary for the log */\n\tmessage: string;\n\t/** Employee the write was meant for, `null` when the id was not a presence state */\n\tuserId: number | null;\n\t/** Whether the employee is present after the write */\n\tpresent: boolean;\n\t/** True when a punch was written */\n\tchanged: boolean;\n\t/** Local date the punch belongs to */\n\tlocalDate?: string;\n}\n\n/**\n * Reads the employee id from a presence state id.\n *\n * @param localId - state id without the instance prefix\n * @returns the employee id, or `null` when the id is not a presence state\n */\nexport function parsePresenceStateId(localId: string): number | null {\n\tconst match = /^users\\.(\\d+)\\.present$/.exec(localId.trim());\n\treturn match ? Number(match[1]) : null;\n}\n\n/**\n * Reads a boolean from a written state value.\n *\n * Dashboards and script adapters deliver `true`, `\"true\"`, `1` or `\"1\"` \u2014 and the opposites.\n *\n * @param value - value that was written\n * @returns the boolean, or `null` when the value is not boolean-like\n */\nexport function readPresenceValue(value: ioBroker.StateValue): boolean | null {\n\tif (typeof value === \"boolean\") {\n\t\treturn value;\n\t}\n\tif (typeof value === \"number\") {\n\t\treturn value === 1 ? true : value === 0 ? false : null;\n\t}\n\tif (typeof value === \"string\") {\n\t\tconst normalized = value.trim().toLowerCase();\n\t\tif (normalized === \"true\" || normalized === \"1\" || normalized === \"on\") {\n\t\t\treturn true;\n\t\t}\n\t\tif (normalized === \"false\" || normalized === \"0\" || normalized === \"off\" || normalized === \"\") {\n\t\t\treturn false;\n\t\t}\n\t}\n\treturn null;\n}\n\n/**\n * Applies a write on `users.<id>.present`.\n *\n * @param deps - data sources\n * @param localId - state id without the instance prefix\n * @param value - value that was written\n * @returns what happened, so the caller can log it and republish the figures\n */\nexport function handlePresenceState(deps: PresenceDeps, localId: string, value: ioBroker.StateValue): PresenceResult {\n\tconst userId = parsePresenceStateId(localId);\n\tif (userId === null) {\n\t\treturn {\n\t\t\tok: false,\n\t\t\tmessage: `\"${localId}\" is not a presence state`,\n\t\t\tuserId: null,\n\t\t\tpresent: false,\n\t\t\tchanged: false,\n\t\t};\n\t}\n\n\tconst desired = readPresenceValue(value);\n\tif (desired === null) {\n\t\treturn {\n\t\t\tok: false,\n\t\t\tmessage: `write true or false (got ${JSON.stringify(value)})`,\n\t\t\tuserId,\n\t\t\tpresent: false,\n\t\t\tchanged: false,\n\t\t};\n\t}\n\n\tconst user = deps.users.findById(userId);\n\tif (!user) {\n\t\treturn { ok: false, message: `employee ${userId} does not exist`, userId, present: false, changed: false };\n\t}\n\tif (!user.isActive) {\n\t\treturn {\n\t\t\tok: false,\n\t\t\tmessage: `${user.displayName} is deactivated, no punch was written`,\n\t\t\tuserId,\n\t\t\tpresent: false,\n\t\t\tchanged: false,\n\t\t};\n\t}\n\n\tconst now = deps.now ?? (() => Math.floor(Date.now() / 1000));\n\tconst timestamp = now();\n\tconst today = resolveLocalDate(timestamp, user.timezone);\n\tconst existing: PunchEntry[] = deps.entries\n\t\t.listByDate(user.id, today)\n\t\t.map(entry => ({ id: entry.id, tsUtc: entry.tsUtc, syncState: entry.syncState }));\n\tconst present = nextDirection(buildDayPunches(existing)) === \"out\";\n\n\tif (present === desired) {\n\t\t// the reader fired twice, the dashboard was refreshed or a script repeats itself: nothing to store\n\t\treturn {\n\t\t\tok: true,\n\t\t\tmessage: `${user.displayName} is already ${desired ? \"present\" : \"absent\"} (no punch written)`,\n\t\t\tuserId: user.id,\n\t\t\tpresent: desired,\n\t\t\tchanged: false,\n\t\t\tlocalDate: today,\n\t\t};\n\t}\n\n\tconst direction = desired ? \"in\" : \"out\";\n\tconst stored = deps.entries.insert({\n\t\tuserId: user.id,\n\t\ttsUtc: timestamp,\n\t\ttimeZone: user.timezone,\n\t\tsource: \"api\",\n\t\tdirection,\n\t\tnote: \"state.present\",\n\t\tnow: timestamp,\n\t});\n\tconst day = deps.aggregation.recalculateDay(user.id, stored.entry.localDate, { now: timestamp });\n\n\treturn {\n\t\tok: true,\n\t\tmessage: `${user.displayName} punched ${direction} from the presence state (${day.workedMin} min today, present: ${day.hasOpenEntry})`,\n\t\tuserId: user.id,\n\t\tpresent: day.hasOpenEntry,\n\t\tchanged: true,\n\t\tlocalDate: stored.entry.localDate,\n\t};\n}\n"],
+  "mappings": "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",
+  "names": ["resolveLocalDate"]
+}