@open-mercato/core 0.7.1-develop.7178.1.ab93fbaf4e → 0.7.1-develop.7180.1.9717fbbb43

package/dist/modules/staff/lib/time-tracking/settingKeys.js

@@ -0,0 +1,214 @@
+import { z } from "zod";
+import { extensionPoints } from "@open-mercato/core/modules/staff/extension-points";
+import { BUILT_IN_STRATEGY_PRIORITY, createStrategyRegistry } from "./registries/registry.js";
+import { DEFAULT_ROUNDING_SETTINGS } from "./rounding.js";
+const TIME_TRACKING_SETTING_KEY_REGISTRY_ID = extensionPoints.hosts.settingKeyRegistry.spotId;
+const TIME_TRACKING_ROUNDING_GROUP = "rounding";
+const TIME_TRACKING_DEFAULTS_GROUP = "defaults";
+const TIME_TRACKING_TARGETS_GROUP = "targets";
+const TIME_TRACKING_WARNINGS_GROUP = "warnings";
+const TIME_TRACKING_ACCESS_GROUP = "access";
+const DEFAULT_ASSIGNMENT_GRACE_DAYS = 14;
+const MAX_ASSIGNMENT_GRACE_DAYS = 365;
+const timeTrackingRoundingUnitMinutesSchema = z.union([
+  z.literal(0),
+  z.literal(5),
+  z.literal(10),
+  z.literal(15)
+]);
+const timeTrackingRoundingDirectionSchema = z.enum(["up", "nearest"]);
+const registry = createStrategyRegistry(
+  TIME_TRACKING_SETTING_KEY_REGISTRY_ID
+);
+const builtInIds = /* @__PURE__ */ new Set();
+function timeTrackingSettingStorageName(group, key) {
+  return `${group}.${key}`;
+}
+function registerKey(input, builtIn) {
+  const group = input.group.trim();
+  const key = input.key.trim();
+  if (!group || !key) {
+    throw new Error("[internal] a time-tracking setting key requires a non-empty group and key");
+  }
+  const id = timeTrackingSettingStorageName(group, key);
+  if (!builtIn && builtInIds.has(id)) {
+    throw new Error(`[internal] ${id} is a built-in time-tracking setting key and cannot be replaced`);
+  }
+  const parsed = input.schema.safeParse(input.default);
+  if (!parsed.success) {
+    throw new Error(`[internal] the default for the time-tracking setting key ${id} fails its own schema`);
+  }
+  const definition = { ...input, group, key, id, builtIn };
+  if (builtIn) {
+    registry.registerBuiltIn(definition);
+    return () => {
+    };
+  }
+  return registry.register(definition);
+}
+function registerTimeTrackingSettingKey(input) {
+  return registerKey(input, false);
+}
+function listTimeTrackingSettingKeys() {
+  return registry.list();
+}
+function getTimeTrackingSettingKey(id) {
+  return registry.get(id);
+}
+function timeTrackingSettingKeyIds() {
+  return registry.ids();
+}
+function contributedTimeTrackingSettingKeys() {
+  return registry.list().filter((entry) => !entry.builtIn);
+}
+function timeTrackingSettingGroups() {
+  const groups = [];
+  for (const entry of registry.list()) {
+    if (!groups.includes(entry.group)) groups.push(entry.group);
+  }
+  return groups;
+}
+const BUILT_IN_SETTING_KEYS = [
+  {
+    group: TIME_TRACKING_ROUNDING_GROUP,
+    key: "unitMinutes",
+    schema: timeTrackingRoundingUnitMinutesSchema,
+    default: DEFAULT_ROUNDING_SETTINGS.unitMinutes,
+    labelKey: "staff.time_tracking.settings.rounding.unit",
+    priority: BUILT_IN_STRATEGY_PRIORITY
+  },
+  {
+    group: TIME_TRACKING_ROUNDING_GROUP,
+    key: "direction",
+    schema: timeTrackingRoundingDirectionSchema,
+    default: DEFAULT_ROUNDING_SETTINGS.direction,
+    labelKey: "staff.time_tracking.settings.rounding.direction",
+    priority: BUILT_IN_STRATEGY_PRIORITY
+  },
+  {
+    group: TIME_TRACKING_DEFAULTS_GROUP,
+    key: "billable",
+    schema: z.boolean(),
+    default: true,
+    labelKey: "staff.time_tracking.settings.defaults.billable",
+    priority: BUILT_IN_STRATEGY_PRIORITY
+  },
+  {
+    group: TIME_TRACKING_DEFAULTS_GROUP,
+    key: "chainStartFromPreviousEnd",
+    schema: z.boolean(),
+    default: true,
+    labelKey: "staff.time_tracking.settings.defaults.chainStart",
+    priority: BUILT_IN_STRATEGY_PRIORITY
+  },
+  {
+    group: TIME_TRACKING_TARGETS_GROUP,
+    key: "dailyHours",
+    schema: z.number().min(0).max(24).nullable(),
+    default: 8,
+    labelKey: "staff.time_tracking.settings.targets.dailyHours",
+    priority: BUILT_IN_STRATEGY_PRIORITY
+  },
+  {
+    group: TIME_TRACKING_WARNINGS_GROUP,
+    key: "overlap",
+    schema: z.boolean(),
+    default: true,
+    labelKey: "staff.time_tracking.settings.warnings.overlap",
+    priority: BUILT_IN_STRATEGY_PRIORITY
+  },
+  {
+    group: TIME_TRACKING_WARNINGS_GROUP,
+    key: "runningTimer",
+    schema: z.boolean(),
+    default: true,
+    labelKey: "staff.time_tracking.settings.warnings.runningTimer",
+    priority: BUILT_IN_STRATEGY_PRIORITY
+  },
+  {
+    group: TIME_TRACKING_ACCESS_GROUP,
+    key: "assignmentGraceDays",
+    schema: z.number().int().min(0).max(MAX_ASSIGNMENT_GRACE_DAYS),
+    default: DEFAULT_ASSIGNMENT_GRACE_DAYS,
+    labelKey: "staff.time_tracking.settings.access.graceDays",
+    priority: BUILT_IN_STRATEGY_PRIORITY
+  }
+];
+for (const input of BUILT_IN_SETTING_KEYS) {
+  registerKey(input, true);
+  builtInIds.add(timeTrackingSettingStorageName(input.group, input.key));
+}
+const BUILT_IN_TIME_TRACKING_SETTING_KEY_IDS = Object.freeze(
+  BUILT_IN_SETTING_KEYS.map((input) => timeTrackingSettingStorageName(input.group, input.key))
+);
+function isBuiltInTimeTrackingSettingKey(id) {
+  return builtInIds.has(id);
+}
+function buildTimeTrackingSettingsSchema() {
+  const byGroup = /* @__PURE__ */ new Map();
+  const defaultsByGroup = /* @__PURE__ */ new Map();
+  for (const entry of registry.list()) {
+    const shape2 = byGroup.get(entry.group) ?? {};
+    shape2[entry.key] = entry.schema.optional().default(entry.default);
+    byGroup.set(entry.group, shape2);
+    const defaults = defaultsByGroup.get(entry.group) ?? {};
+    defaults[entry.key] = entry.default;
+    defaultsByGroup.set(entry.group, defaults);
+  }
+  const shape = {};
+  for (const [group, groupShape] of byGroup) {
+    shape[group] = z.object(groupShape).optional().default(defaultsByGroup.get(group) ?? {});
+  }
+  return z.object(shape);
+}
+function buildDefaultTimeTrackingSettings() {
+  const result = {};
+  for (const entry of registry.list()) {
+    const group = result[entry.group] ?? {};
+    group[entry.key] = entry.default;
+    result[entry.group] = group;
+  }
+  return result;
+}
+function readGroup(source, group) {
+  if (!source || typeof source !== "object") return null;
+  const value = source[group];
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  return value;
+}
+function normalizeTimeTrackingSettingsRecord(input) {
+  const result = {};
+  for (const entry of registry.list()) {
+    const group = result[entry.group] ?? {};
+    const raw = readGroup(input, entry.group)?.[entry.key];
+    const parsed = entry.schema.safeParse(raw);
+    group[entry.key] = parsed.success ? parsed.data : entry.default;
+    result[entry.group] = group;
+  }
+  return result;
+}
+export {
+  BUILT_IN_TIME_TRACKING_SETTING_KEY_IDS,
+  DEFAULT_ASSIGNMENT_GRACE_DAYS,
+  MAX_ASSIGNMENT_GRACE_DAYS,
+  TIME_TRACKING_ACCESS_GROUP,
+  TIME_TRACKING_DEFAULTS_GROUP,
+  TIME_TRACKING_ROUNDING_GROUP,
+  TIME_TRACKING_SETTING_KEY_REGISTRY_ID,
+  TIME_TRACKING_TARGETS_GROUP,
+  TIME_TRACKING_WARNINGS_GROUP,
+  buildDefaultTimeTrackingSettings,
+  buildTimeTrackingSettingsSchema,
+  contributedTimeTrackingSettingKeys,
+  getTimeTrackingSettingKey,
+  isBuiltInTimeTrackingSettingKey,
+  listTimeTrackingSettingKeys,
+  normalizeTimeTrackingSettingsRecord,
+  registerTimeTrackingSettingKey,
+  timeTrackingRoundingDirectionSchema,
+  timeTrackingRoundingUnitMinutesSchema,
+  timeTrackingSettingGroups,
+  timeTrackingSettingKeyIds,
+  timeTrackingSettingStorageName
+};
+//# sourceMappingURL=settingKeys.js.map

package/dist/modules/staff/lib/time-tracking/settingKeys.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/staff/lib/time-tracking/settingKeys.ts"],
+  "sourcesContent": ["/**\n * EP-42 \u2014 the time-tracking settings key registry.\n *\n * `TIME_TRACKING_SETTING_KEYS` used to be a frozen array, `normalizeTimeTrackingSettings`\n * a hand-written coercion per key, and `staffTimeTrackingSettingsSchema` a literal\n * `z.object`. All three now read this registry, and the eight keys the module shipped\n * are registered here as built-ins \u2014 so with no contribution the read, the write, the\n * validating schema and the defaults are byte-identical to what they were.\n *\n * Storage is `ModuleConfigService` under module id `staff.time_tracking`, one config\n * row per key, named `<group>.<key>` and scoped by **tenant only** (spec \u00A710: time\n * tracking settings are tenant-global; there is no per-organization override and no\n * per-project override). A contributed key inherits exactly that scope \u2014 it is written\n * with `{ tenantId }` and `organization_id` stays null.\n */\n\nimport { z } from 'zod'\nimport { extensionPoints } from '@open-mercato/core/modules/staff/extension-points'\nimport { BUILT_IN_STRATEGY_PRIORITY, createStrategyRegistry } from './registries/registry'\nimport { DEFAULT_ROUNDING_SETTINGS } from './rounding'\n\nexport const TIME_TRACKING_SETTING_KEY_REGISTRY_ID = extensionPoints.hosts.settingKeyRegistry.spotId\n\nexport const TIME_TRACKING_ROUNDING_GROUP = 'rounding'\nexport const TIME_TRACKING_DEFAULTS_GROUP = 'defaults'\nexport const TIME_TRACKING_TARGETS_GROUP = 'targets'\nexport const TIME_TRACKING_WARNINGS_GROUP = 'warnings'\nexport const TIME_TRACKING_ACCESS_GROUP = 'access'\n\n/**\n * Days past `assigned_end_date` that project access survives (spec D-12). The\n * grace window exists so a consultant rolled off at the end of a month can still\n * log and correct that month's time; `0` ends access the day the assignment ends.\n */\nexport const DEFAULT_ASSIGNMENT_GRACE_DAYS = 14\n\nexport const MAX_ASSIGNMENT_GRACE_DAYS = 365\n\nexport const timeTrackingRoundingUnitMinutesSchema = z.union([\n  z.literal(0),\n  z.literal(5),\n  z.literal(10),\n  z.literal(15),\n])\n\nexport const timeTrackingRoundingDirectionSchema = z.enum(['up', 'nearest'])\n\nexport type TimeTrackingSettingKeyInput = {\n  /** Group the value lives under in the settings object, e.g. `rounding`. */\n  group: string\n  /** Leaf name inside the group, e.g. `unitMinutes`. */\n  key: string\n  /** Validates the stored value; an invalid one falls back to `default`. */\n  schema: z.ZodTypeAny\n  /** Used when the tenant never stored the key and when the stored value no longer validates. */\n  default: unknown\n  /** i18n key for the label a settings section renders. Never a literal \u2014 the module holds no user-facing strings. */\n  labelKey: string\n  /** Higher first in `listTimeTrackingSettingKeys()`; built-ins sit below every contribution. */\n  priority?: number\n}\n\nexport type TimeTrackingSettingKeyDefinition = TimeTrackingSettingKeyInput & {\n  /** `<group>.<key>` \u2014 the `ModuleConfigService` config name. */\n  id: string\n  builtIn: boolean\n}\n\nconst registry = createStrategyRegistry<TimeTrackingSettingKeyDefinition>(\n  TIME_TRACKING_SETTING_KEY_REGISTRY_ID,\n)\n\nconst builtInIds = new Set<string>()\n\nexport function timeTrackingSettingStorageName(group: string, key: string): string {\n  return `${group}.${key}`\n}\n\nfunction registerKey(input: TimeTrackingSettingKeyInput, builtIn: boolean): () => void {\n  const group = input.group.trim()\n  const key = input.key.trim()\n  if (!group || !key) {\n    throw new Error('[internal] a time-tracking setting key requires a non-empty group and key')\n  }\n  const id = timeTrackingSettingStorageName(group, key)\n  if (!builtIn && builtInIds.has(id)) {\n    throw new Error(`[internal] ${id} is a built-in time-tracking setting key and cannot be replaced`)\n  }\n  const parsed = input.schema.safeParse(input.default)\n  if (!parsed.success) {\n    throw new Error(`[internal] the default for the time-tracking setting key ${id} fails its own schema`)\n  }\n  const definition = { ...input, group, key, id, builtIn }\n  if (builtIn) {\n    registry.registerBuiltIn(definition)\n    return () => {}\n  }\n  return registry.register(definition)\n}\n\n/**\n * Contribute a tenant-scoped time-tracking setting key. Pair it with a widget on the\n * `staff.time_tracking.settings:sections` injection spot (EP-26) to render it: the spot\n * context carries `values` for every contributed key and a `setValue(id, value)` that\n * writes into the page draft, so the page's own Save round-trips the contribution.\n */\nexport function registerTimeTrackingSettingKey(input: TimeTrackingSettingKeyInput): () => void {\n  return registerKey(input, false)\n}\n\nexport function listTimeTrackingSettingKeys(): TimeTrackingSettingKeyDefinition[] {\n  return registry.list()\n}\n\nexport function getTimeTrackingSettingKey(id: string | null | undefined): TimeTrackingSettingKeyDefinition | null {\n  return registry.get(id)\n}\n\nexport function timeTrackingSettingKeyIds(): string[] {\n  return registry.ids()\n}\n\n/** The contributed keys only \u2014 the eight built-ins are rendered by the settings page's own form. */\nexport function contributedTimeTrackingSettingKeys(): TimeTrackingSettingKeyDefinition[] {\n  return registry.list().filter((entry) => !entry.builtIn)\n}\n\nexport function timeTrackingSettingGroups(): string[] {\n  const groups: string[] = []\n  for (const entry of registry.list()) {\n    if (!groups.includes(entry.group)) groups.push(entry.group)\n  }\n  return groups\n}\n\nconst BUILT_IN_SETTING_KEYS: readonly TimeTrackingSettingKeyInput[] = [\n  {\n    group: TIME_TRACKING_ROUNDING_GROUP,\n    key: 'unitMinutes',\n    schema: timeTrackingRoundingUnitMinutesSchema,\n    default: DEFAULT_ROUNDING_SETTINGS.unitMinutes,\n    labelKey: 'staff.time_tracking.settings.rounding.unit',\n    priority: BUILT_IN_STRATEGY_PRIORITY,\n  },\n  {\n    group: TIME_TRACKING_ROUNDING_GROUP,\n    key: 'direction',\n    schema: timeTrackingRoundingDirectionSchema,\n    default: DEFAULT_ROUNDING_SETTINGS.direction,\n    labelKey: 'staff.time_tracking.settings.rounding.direction',\n    priority: BUILT_IN_STRATEGY_PRIORITY,\n  },\n  {\n    group: TIME_TRACKING_DEFAULTS_GROUP,\n    key: 'billable',\n    schema: z.boolean(),\n    default: true,\n    labelKey: 'staff.time_tracking.settings.defaults.billable',\n    priority: BUILT_IN_STRATEGY_PRIORITY,\n  },\n  {\n    group: TIME_TRACKING_DEFAULTS_GROUP,\n    key: 'chainStartFromPreviousEnd',\n    schema: z.boolean(),\n    default: true,\n    labelKey: 'staff.time_tracking.settings.defaults.chainStart',\n    priority: BUILT_IN_STRATEGY_PRIORITY,\n  },\n  {\n    group: TIME_TRACKING_TARGETS_GROUP,\n    key: 'dailyHours',\n    schema: z.number().min(0).max(24).nullable(),\n    default: 8,\n    labelKey: 'staff.time_tracking.settings.targets.dailyHours',\n    priority: BUILT_IN_STRATEGY_PRIORITY,\n  },\n  {\n    group: TIME_TRACKING_WARNINGS_GROUP,\n    key: 'overlap',\n    schema: z.boolean(),\n    default: true,\n    labelKey: 'staff.time_tracking.settings.warnings.overlap',\n    priority: BUILT_IN_STRATEGY_PRIORITY,\n  },\n  {\n    group: TIME_TRACKING_WARNINGS_GROUP,\n    key: 'runningTimer',\n    schema: z.boolean(),\n    default: true,\n    labelKey: 'staff.time_tracking.settings.warnings.runningTimer',\n    priority: BUILT_IN_STRATEGY_PRIORITY,\n  },\n  {\n    group: TIME_TRACKING_ACCESS_GROUP,\n    key: 'assignmentGraceDays',\n    schema: z.number().int().min(0).max(MAX_ASSIGNMENT_GRACE_DAYS),\n    default: DEFAULT_ASSIGNMENT_GRACE_DAYS,\n    labelKey: 'staff.time_tracking.settings.access.graceDays',\n    priority: BUILT_IN_STRATEGY_PRIORITY,\n  },\n]\n\nfor (const input of BUILT_IN_SETTING_KEYS) {\n  registerKey(input, true)\n  builtInIds.add(timeTrackingSettingStorageName(input.group, input.key))\n}\n\nexport const BUILT_IN_TIME_TRACKING_SETTING_KEY_IDS: readonly string[] = Object.freeze(\n  BUILT_IN_SETTING_KEYS.map((input) => timeTrackingSettingStorageName(input.group, input.key)),\n)\n\nexport function isBuiltInTimeTrackingSettingKey(id: string): boolean {\n  return builtInIds.has(id)\n}\n\nexport type TimeTrackingSettingsRecord = Record<string, Record<string, unknown>>\n\n/**\n * The validating schema the settings route parses against, rebuilt per call so a key\n * registered after this module first loaded still validates (the same reason EP-35's\n * export-format enum is an OpenAPI getter).\n */\nexport function buildTimeTrackingSettingsSchema(): z.ZodObject<Record<string, z.ZodTypeAny>> {\n  const byGroup = new Map<string, Record<string, z.ZodTypeAny>>()\n  const defaultsByGroup = new Map<string, Record<string, unknown>>()\n  for (const entry of registry.list()) {\n    const shape = byGroup.get(entry.group) ?? {}\n    shape[entry.key] = entry.schema.optional().default(entry.default)\n    byGroup.set(entry.group, shape)\n    const defaults = defaultsByGroup.get(entry.group) ?? {}\n    defaults[entry.key] = entry.default\n    defaultsByGroup.set(entry.group, defaults)\n  }\n  const shape: Record<string, z.ZodTypeAny> = {}\n  for (const [group, groupShape] of byGroup) {\n    shape[group] = z.object(groupShape).optional().default(defaultsByGroup.get(group) ?? {})\n  }\n  return z.object(shape)\n}\n\n/** The canonical settings object with every registered key at its registered default. */\nexport function buildDefaultTimeTrackingSettings(): TimeTrackingSettingsRecord {\n  const result: TimeTrackingSettingsRecord = {}\n  for (const entry of registry.list()) {\n    const group = result[entry.group] ?? {}\n    group[entry.key] = entry.default\n    result[entry.group] = group\n  }\n  return result\n}\n\nfunction readGroup(source: unknown, group: string): Record<string, unknown> | null {\n  if (!source || typeof source !== 'object') return null\n  const value = (source as Record<string, unknown>)[group]\n  if (!value || typeof value !== 'object' || Array.isArray(value)) return null\n  return value as Record<string, unknown>\n}\n\n/**\n * Coerce an arbitrary (possibly partial or malformed) settings shape into the canonical\n * one: every registered key present, every absent or invalid value replaced by the\n * registered default.\n */\nexport function normalizeTimeTrackingSettingsRecord(input: unknown): TimeTrackingSettingsRecord {\n  const result: TimeTrackingSettingsRecord = {}\n  for (const entry of registry.list()) {\n    const group = result[entry.group] ?? {}\n    const raw = readGroup(input, entry.group)?.[entry.key]\n    const parsed = entry.schema.safeParse(raw)\n    group[entry.key] = parsed.success ? parsed.data : entry.default\n    result[entry.group] = group\n  }\n  return result\n}\n"],
+  "mappings": "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",
+  "names": ["shape"]
+}

package/dist/modules/staff/lib/time-tracking/settings.js

@@ -0,0 +1,87 @@
+import {
+  DEFAULT_ASSIGNMENT_GRACE_DAYS,
+  MAX_ASSIGNMENT_GRACE_DAYS,
+  buildDefaultTimeTrackingSettings,
+  listTimeTrackingSettingKeys,
+  normalizeTimeTrackingSettingsRecord,
+  registerTimeTrackingSettingKey,
+  timeTrackingSettingKeyIds
+} from "./settingKeys.js";
+const STAFF_TIME_TRACKING_MODULE_ID = "staff.time_tracking";
+const TIME_TRACKING_ROUNDING_UNIT_MINUTES_KEY = "rounding.unitMinutes";
+const TIME_TRACKING_ROUNDING_DIRECTION_KEY = "rounding.direction";
+const TIME_TRACKING_DEFAULTS_BILLABLE_KEY = "defaults.billable";
+const TIME_TRACKING_DEFAULTS_CHAIN_START_KEY = "defaults.chainStartFromPreviousEnd";
+const TIME_TRACKING_TARGETS_DAILY_HOURS_KEY = "targets.dailyHours";
+const TIME_TRACKING_WARNINGS_OVERLAP_KEY = "warnings.overlap";
+const TIME_TRACKING_WARNINGS_RUNNING_TIMER_KEY = "warnings.runningTimer";
+const TIME_TRACKING_ACCESS_ASSIGNMENT_GRACE_DAYS_KEY = "access.assignmentGraceDays";
+const TIME_TRACKING_SETTING_KEYS = [
+  TIME_TRACKING_ROUNDING_UNIT_MINUTES_KEY,
+  TIME_TRACKING_ROUNDING_DIRECTION_KEY,
+  TIME_TRACKING_DEFAULTS_BILLABLE_KEY,
+  TIME_TRACKING_DEFAULTS_CHAIN_START_KEY,
+  TIME_TRACKING_TARGETS_DAILY_HOURS_KEY,
+  TIME_TRACKING_WARNINGS_OVERLAP_KEY,
+  TIME_TRACKING_WARNINGS_RUNNING_TIMER_KEY,
+  TIME_TRACKING_ACCESS_ASSIGNMENT_GRACE_DAYS_KEY
+];
+const DEFAULT_TIME_TRACKING_SETTINGS = buildDefaultTimeTrackingSettings();
+function normalizeTimeTrackingSettings(input) {
+  return normalizeTimeTrackingSettingsRecord(input);
+}
+function readTimeTrackingSettingValue(settings, id) {
+  const separator = id.indexOf(".");
+  if (separator <= 0) return void 0;
+  const group = settings[id.slice(0, separator)];
+  if (!group || typeof group !== "object") return void 0;
+  return group[id.slice(separator + 1)];
+}
+async function readTimeTrackingSettings(configService, scope) {
+  const configScope = { tenantId: scope.tenantId };
+  const stored = {};
+  for (const entry of listTimeTrackingSettingKeys()) {
+    const record = await configService.getRecord(STAFF_TIME_TRACKING_MODULE_ID, entry.id, configScope);
+    if (!record) continue;
+    const group = stored[entry.group] ?? {};
+    group[entry.key] = record.value;
+    stored[entry.group] = group;
+  }
+  return normalizeTimeTrackingSettings(stored);
+}
+async function writeTimeTrackingSettings(configService, scope, input) {
+  const settings = normalizeTimeTrackingSettings(input);
+  const configScope = { tenantId: scope.tenantId };
+  for (const entry of listTimeTrackingSettingKeys()) {
+    await configService.setValue(
+      STAFF_TIME_TRACKING_MODULE_ID,
+      entry.id,
+      readTimeTrackingSettingValue(settings, entry.id),
+      configScope
+    );
+  }
+  return settings;
+}
+export {
+  DEFAULT_ASSIGNMENT_GRACE_DAYS,
+  DEFAULT_TIME_TRACKING_SETTINGS,
+  MAX_ASSIGNMENT_GRACE_DAYS,
+  STAFF_TIME_TRACKING_MODULE_ID,
+  TIME_TRACKING_ACCESS_ASSIGNMENT_GRACE_DAYS_KEY,
+  TIME_TRACKING_DEFAULTS_BILLABLE_KEY,
+  TIME_TRACKING_DEFAULTS_CHAIN_START_KEY,
+  TIME_TRACKING_ROUNDING_DIRECTION_KEY,
+  TIME_TRACKING_ROUNDING_UNIT_MINUTES_KEY,
+  TIME_TRACKING_SETTING_KEYS,
+  TIME_TRACKING_TARGETS_DAILY_HOURS_KEY,
+  TIME_TRACKING_WARNINGS_OVERLAP_KEY,
+  TIME_TRACKING_WARNINGS_RUNNING_TIMER_KEY,
+  listTimeTrackingSettingKeys,
+  normalizeTimeTrackingSettings,
+  readTimeTrackingSettingValue,
+  readTimeTrackingSettings,
+  registerTimeTrackingSettingKey,
+  timeTrackingSettingKeyIds,
+  writeTimeTrackingSettings
+};
+//# sourceMappingURL=settings.js.map

package/dist/modules/staff/lib/time-tracking/settings.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/staff/lib/time-tracking/settings.ts"],
+  "sourcesContent": ["import type { ModuleConfigService } from '@open-mercato/core/modules/configs/lib/module-config-service'\nimport type { StaffTimeTrackingSettingsInput } from '../../data/validators'\nimport {\n  type RoundingDirection,\n  type RoundingSettings,\n  type RoundingUnitMinutes,\n} from './rounding'\nimport {\n  DEFAULT_ASSIGNMENT_GRACE_DAYS,\n  MAX_ASSIGNMENT_GRACE_DAYS,\n  buildDefaultTimeTrackingSettings,\n  listTimeTrackingSettingKeys,\n  normalizeTimeTrackingSettingsRecord,\n  registerTimeTrackingSettingKey,\n  timeTrackingSettingKeyIds,\n  type TimeTrackingSettingKeyDefinition,\n  type TimeTrackingSettingKeyInput,\n  type TimeTrackingSettingsRecord,\n} from './settingKeys'\n\nexport type { RoundingDirection, RoundingSettings, RoundingUnitMinutes }\nexport type { TimeTrackingSettingKeyDefinition, TimeTrackingSettingKeyInput, TimeTrackingSettingsRecord }\nexport { DEFAULT_ASSIGNMENT_GRACE_DAYS, MAX_ASSIGNMENT_GRACE_DAYS, registerTimeTrackingSettingKey }\n\nexport const STAFF_TIME_TRACKING_MODULE_ID = 'staff.time_tracking'\n\nexport const TIME_TRACKING_ROUNDING_UNIT_MINUTES_KEY = 'rounding.unitMinutes'\nexport const TIME_TRACKING_ROUNDING_DIRECTION_KEY = 'rounding.direction'\nexport const TIME_TRACKING_DEFAULTS_BILLABLE_KEY = 'defaults.billable'\nexport const TIME_TRACKING_DEFAULTS_CHAIN_START_KEY = 'defaults.chainStartFromPreviousEnd'\nexport const TIME_TRACKING_TARGETS_DAILY_HOURS_KEY = 'targets.dailyHours'\nexport const TIME_TRACKING_WARNINGS_OVERLAP_KEY = 'warnings.overlap'\nexport const TIME_TRACKING_WARNINGS_RUNNING_TIMER_KEY = 'warnings.runningTimer'\nexport const TIME_TRACKING_ACCESS_ASSIGNMENT_GRACE_DAYS_KEY = 'access.assignmentGraceDays'\n\n/**\n * The eight keys the module shipped. FROZEN \u2014 a stored config row is named after one\n * of these, so none may be renamed or removed. The list is no longer the whole truth:\n * `timeTrackingSettingKeyIds()` returns these plus every contributed key (EP-42).\n */\nexport const TIME_TRACKING_SETTING_KEYS = [\n  TIME_TRACKING_ROUNDING_UNIT_MINUTES_KEY,\n  TIME_TRACKING_ROUNDING_DIRECTION_KEY,\n  TIME_TRACKING_DEFAULTS_BILLABLE_KEY,\n  TIME_TRACKING_DEFAULTS_CHAIN_START_KEY,\n  TIME_TRACKING_TARGETS_DAILY_HOURS_KEY,\n  TIME_TRACKING_WARNINGS_OVERLAP_KEY,\n  TIME_TRACKING_WARNINGS_RUNNING_TIMER_KEY,\n  TIME_TRACKING_ACCESS_ASSIGNMENT_GRACE_DAYS_KEY,\n] as const\n\nexport type TimeTrackingSettingKey = (typeof TIME_TRACKING_SETTING_KEYS)[number]\n\nexport type TimeTrackingEntryDefaults = {\n  billable: boolean\n  chainStartFromPreviousEnd: boolean\n}\n\nexport type TimeTrackingTargets = {\n  dailyHours: number | null\n}\n\nexport type TimeTrackingWarnings = {\n  overlap: boolean\n  runningTimer: boolean\n}\n\nexport type TimeTrackingAccess = {\n  assignmentGraceDays: number\n}\n\nexport type TimeTrackingBuiltInSettings = {\n  rounding: RoundingSettings\n  defaults: TimeTrackingEntryDefaults\n  targets: TimeTrackingTargets\n  warnings: TimeTrackingWarnings\n  access: TimeTrackingAccess\n}\n\n/**\n * The five built-in groups stay statically typed; a contributed group or key reaches\n * a caller through the index signature and is read with `readTimeTrackingSettingValue`.\n */\nexport type TimeTrackingSettings = TimeTrackingBuiltInSettings & TimeTrackingSettingsRecord\n\n/**\n * Settings are global per tenant (spec \u00A710 fixes them there \u2014 no per-project or\n * per-customer override), so the scope carries the tenant only and MUST be\n * derived from the authenticated context, never from request input. A contributed\n * key inherits exactly that scope.\n */\nexport type TimeTrackingSettingsScope = {\n  tenantId: string\n}\n\nexport const DEFAULT_TIME_TRACKING_SETTINGS: TimeTrackingSettings =\n  buildDefaultTimeTrackingSettings() as TimeTrackingSettings\n\n/**\n * Coerce an arbitrary (possibly partial or malformed) settings shape into the\n * canonical one, filling every absent or invalid value from the registered defaults.\n */\nexport function normalizeTimeTrackingSettings(\n  input: Partial<TimeTrackingBuiltInSettings> | TimeTrackingSettingsRecord | StaffTimeTrackingSettingsInput | null | undefined,\n): TimeTrackingSettings {\n  return normalizeTimeTrackingSettingsRecord(input) as TimeTrackingSettings\n}\n\n/** Reads one registered key out of a normalized settings object by its `<group>.<key>` id. */\nexport function readTimeTrackingSettingValue(\n  settings: TimeTrackingSettings,\n  id: string,\n): unknown {\n  const separator = id.indexOf('.')\n  if (separator <= 0) return undefined\n  const group = settings[id.slice(0, separator)]\n  if (!group || typeof group !== 'object') return undefined\n  return (group as Record<string, unknown>)[id.slice(separator + 1)]\n}\n\nexport { listTimeTrackingSettingKeys, timeTrackingSettingKeyIds }\n\n/**\n * Resolve the tenant's time tracking settings. Absent keys (and keys holding a\n * value the schema no longer accepts) fall back to the registered default, so a\n * tenant that never opened the settings screen still reads a complete record.\n */\nexport async function readTimeTrackingSettings(\n  configService: ModuleConfigService,\n  scope: TimeTrackingSettingsScope,\n): Promise<TimeTrackingSettings> {\n  const configScope = { tenantId: scope.tenantId }\n  // `getRecord` rather than `getValue` so an explicitly stored `null`\n  // (`targets.dailyHours` = \"no daily target\") stays distinguishable from an\n  // absent row, which must fall back to the default.\n  const stored: TimeTrackingSettingsRecord = {}\n  for (const entry of listTimeTrackingSettingKeys()) {\n    const record = await configService.getRecord(STAFF_TIME_TRACKING_MODULE_ID, entry.id, configScope)\n    if (!record) continue\n    const group = stored[entry.group] ?? {}\n    group[entry.key] = record.value\n    stored[entry.group] = group\n  }\n  return normalizeTimeTrackingSettings(stored)\n}\n\n/**\n * Persist the tenant's time tracking settings and return the stored shape.\n */\nexport async function writeTimeTrackingSettings(\n  configService: ModuleConfigService,\n  scope: TimeTrackingSettingsScope,\n  input: Partial<TimeTrackingBuiltInSettings> | TimeTrackingSettingsRecord | StaffTimeTrackingSettingsInput,\n): Promise<TimeTrackingSettings> {\n  const settings = normalizeTimeTrackingSettings(input)\n  const configScope = { tenantId: scope.tenantId }\n\n  for (const entry of listTimeTrackingSettingKeys()) {\n    await configService.setValue(\n      STAFF_TIME_TRACKING_MODULE_ID,\n      entry.id,\n      readTimeTrackingSettingValue(settings, entry.id),\n      configScope,\n    )\n  }\n\n  return settings\n}\n"],
+  "mappings": "AAOA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AAMA,MAAM,gCAAgC;AAEtC,MAAM,0CAA0C;AAChD,MAAM,uCAAuC;AAC7C,MAAM,sCAAsC;AAC5C,MAAM,yCAAyC;AAC/C,MAAM,wCAAwC;AAC9C,MAAM,qCAAqC;AAC3C,MAAM,2CAA2C;AACjD,MAAM,iDAAiD;AAOvD,MAAM,6BAA6B;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AA8CO,MAAM,iCACX,iCAAiC;AAM5B,SAAS,8BACd,OACsB;AACtB,SAAO,oCAAoC,KAAK;AAClD;AAGO,SAAS,6BACd,UACA,IACS;AACT,QAAM,YAAY,GAAG,QAAQ,GAAG;AAChC,MAAI,aAAa,EAAG,QAAO;AAC3B,QAAM,QAAQ,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAC7C,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,SAAQ,MAAkC,GAAG,MAAM,YAAY,CAAC,CAAC;AACnE;AASA,eAAsB,yBACpB,eACA,OAC+B;AAC/B,QAAM,cAAc,EAAE,UAAU,MAAM,SAAS;AAI/C,QAAM,SAAqC,CAAC;AAC5C,aAAW,SAAS,4BAA4B,GAAG;AACjD,UAAM,SAAS,MAAM,cAAc,UAAU,+BAA+B,MAAM,IAAI,WAAW;AACjG,QAAI,CAAC,OAAQ;AACb,UAAM,QAAQ,OAAO,MAAM,KAAK,KAAK,CAAC;AACtC,UAAM,MAAM,GAAG,IAAI,OAAO;AAC1B,WAAO,MAAM,KAAK,IAAI;AAAA,EACxB;AACA,SAAO,8BAA8B,MAAM;AAC7C;AAKA,eAAsB,0BACpB,eACA,OACA,OAC+B;AAC/B,QAAM,WAAW,8BAA8B,KAAK;AACpD,QAAM,cAAc,EAAE,UAAU,MAAM,SAAS;AAE/C,aAAW,SAAS,4BAA4B,GAAG;AACjD,UAAM,cAAc;AAAA,MAClB;AAAA,MACA,MAAM;AAAA,MACN,6BAA6B,UAAU,MAAM,EAAE;AAAA,MAC/C;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;",
+  "names": []
+}

package/dist/modules/staff/lib/time-tracking/sqlInClause.js

@@ -0,0 +1,9 @@
+function buildSqlInClause(column, values) {
+  if (values.length === 0) return { sql: `${column} IN (NULL)`, params: [] };
+  const placeholders = values.map(() => "?").join(", ");
+  return { sql: `${column} IN (${placeholders})`, params: [...values] };
+}
+export {
+  buildSqlInClause
+};
+//# sourceMappingURL=sqlInClause.js.map

package/dist/modules/staff/lib/time-tracking/sqlInClause.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/staff/lib/time-tracking/sqlInClause.ts"],
+  "sourcesContent": ["/**\n * Renders an id list into a raw-SQL `IN` clause with one placeholder per member.\n *\n * MikroORM does not bind parameters at the driver level: `AbstractSqlConnection.execute`\n * calls `platform.formatQuery`, which interpolates each value through\n * `BasePostgreSqlPlatform.escape`, and that renders a JavaScript array as a bare\n * comma-separated list. `column = ANY(?)` therefore reaches PostgreSQL as\n * `= ANY('a', 'b')` \u2014 or, for a single-element array, as the bare scalar, which fails\n * with `malformed array literal`. The dashboards aggregation builder hit the same wall\n * (#4669) and settled on one placeholder per member; this is that same fix, shared by\n * the time-tracking raw queries.\n *\n * An empty list yields `IN (NULL)` rather than a dropped clause: a caller that narrowed\n * to nothing must select nothing, never silently widen to every row.\n */\nexport type SqlInClause = { sql: string; params: unknown[] }\n\nexport function buildSqlInClause(column: string, values: readonly string[]): SqlInClause {\n  if (values.length === 0) return { sql: `${column} IN (NULL)`, params: [] }\n  const placeholders = values.map(() => '?').join(', ')\n  return { sql: `${column} IN (${placeholders})`, params: [...values] }\n}\n"],
+  "mappings": "AAiBO,SAAS,iBAAiB,QAAgB,QAAwC;AACvF,MAAI,OAAO,WAAW,EAAG,QAAO,EAAE,KAAK,GAAG,MAAM,cAAc,QAAQ,CAAC,EAAE;AACzE,QAAM,eAAe,OAAO,IAAI,MAAM,GAAG,EAAE,KAAK,IAAI;AACpD,SAAO,EAAE,KAAK,GAAG,MAAM,QAAQ,YAAY,KAAK,QAAQ,CAAC,GAAG,MAAM,EAAE;AACtE;",
+  "names": []
+}

package/dist/modules/staff/lib/time-tracking/timeEntrySources.js

@@ -0,0 +1,48 @@
+import { extensionPoints } from "@open-mercato/core/modules/staff/extension-points";
+import { createStrategyRegistry, BUILT_IN_STRATEGY_PRIORITY } from "./registries/registry.js";
+const BUILT_IN_TIME_ENTRY_SOURCE_IDS = ["manual", "timer", "kiosk", "mobile"];
+const TIME_ENTRY_SOURCE_REGISTRY_ID = extensionPoints.hosts.timeEntrySourceRegistry.spotId;
+const DEFAULT_TIME_ENTRY_SOURCE = "manual";
+const registry = createStrategyRegistry(TIME_ENTRY_SOURCE_REGISTRY_ID);
+function registerTimeEntrySource(source) {
+  return registry.register(source);
+}
+function listTimeEntrySources() {
+  return registry.list();
+}
+function getTimeEntrySource(id) {
+  return registry.get(id);
+}
+function hasTimeEntrySource(id) {
+  return registry.has(id);
+}
+function timeEntrySourceIds() {
+  const builtIn = BUILT_IN_TIME_ENTRY_SOURCE_IDS.filter((id) => registry.has(id));
+  const contributed = registry.ids().filter((id) => !builtIn.includes(id));
+  return [...builtIn, ...contributed];
+}
+function normalizeTimeEntrySource(value) {
+  if (typeof value === "string" && registry.has(value)) return value;
+  return DEFAULT_TIME_ENTRY_SOURCE;
+}
+const builtInSources = [
+  { id: "manual", labelKey: "staff.time_tracking.entries.source.manual", icon: "PenLine", editable: true },
+  { id: "timer", labelKey: "staff.time_tracking.entries.source.timer", icon: "Timer", editable: true },
+  { id: "kiosk", labelKey: "staff.time_tracking.entries.source.kiosk", icon: "Monitor", editable: false },
+  { id: "mobile", labelKey: "staff.time_tracking.entries.source.mobile", icon: "Smartphone", editable: true }
+];
+for (const source of builtInSources) {
+  registry.registerBuiltIn({ ...source, priority: BUILT_IN_STRATEGY_PRIORITY });
+}
+export {
+  BUILT_IN_TIME_ENTRY_SOURCE_IDS,
+  DEFAULT_TIME_ENTRY_SOURCE,
+  TIME_ENTRY_SOURCE_REGISTRY_ID,
+  getTimeEntrySource,
+  hasTimeEntrySource,
+  listTimeEntrySources,
+  normalizeTimeEntrySource,
+  registerTimeEntrySource,
+  timeEntrySourceIds
+};
+//# sourceMappingURL=timeEntrySources.js.map

package/dist/modules/staff/lib/time-tracking/timeEntrySources.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/modules/staff/lib/time-tracking/timeEntrySources.ts"],
+  "sourcesContent": ["/**\n * EP-37 \u2014 the time-entry source registry.\n *\n * `staff_time_entries.source` used to be a four-value database enum, which made\n * every import integration a core patch. It is now a plain text column whose\n * accepted values are this registry, so a `jira`, `toggl` or `badge-terminal`\n * source ships with its contributing module.\n *\n * `editable` is the flag the entry screens read: a source the user may still\n * hand-correct (`manual`) versus one whose numbers belong to the system that\n * produced them. It is advisory metadata, not an authorization decision \u2014 the\n * lock rules stay with `locked_report_id` and the ACL features.\n */\n\nimport { extensionPoints } from '@open-mercato/core/modules/staff/extension-points'\nimport { createStrategyRegistry, BUILT_IN_STRATEGY_PRIORITY } from './registries/registry'\n\nexport const BUILT_IN_TIME_ENTRY_SOURCE_IDS = ['manual', 'timer', 'kiosk', 'mobile'] as const\n\nexport type BuiltInTimeEntrySource = (typeof BUILT_IN_TIME_ENTRY_SOURCE_IDS)[number]\n\n/**\n * Widened from the original four-value union so a contributed id is assignable.\n * The union arm keeps the four built-ins as completions.\n */\nexport type TimeEntrySource = BuiltInTimeEntrySource | (string & {})\n\nexport type TimeEntrySourceDefinition = {\n  id: string\n  labelKey: string\n  /** Lucide icon name the entry screens may render beside the row. */\n  icon: string\n  editable: boolean\n  priority?: number\n}\n\nexport const TIME_ENTRY_SOURCE_REGISTRY_ID = extensionPoints.hosts.timeEntrySourceRegistry.spotId\n\nexport const DEFAULT_TIME_ENTRY_SOURCE: BuiltInTimeEntrySource = 'manual'\n\nconst registry = createStrategyRegistry<TimeEntrySourceDefinition>(TIME_ENTRY_SOURCE_REGISTRY_ID)\n\nexport function registerTimeEntrySource(source: TimeEntrySourceDefinition): () => void {\n  return registry.register(source)\n}\n\nexport function listTimeEntrySources(): TimeEntrySourceDefinition[] {\n  return registry.list()\n}\n\nexport function getTimeEntrySource(id: string | null | undefined): TimeEntrySourceDefinition | null {\n  return registry.get(id)\n}\n\nexport function hasTimeEntrySource(id: string | null | undefined): boolean {\n  return registry.has(id)\n}\n\n/** Built-ins first, in the order the module shipped them, then contributions. */\nexport function timeEntrySourceIds(): string[] {\n  const builtIn = BUILT_IN_TIME_ENTRY_SOURCE_IDS.filter((id) => registry.has(id))\n  const contributed = registry.ids().filter((id) => !builtIn.includes(id as BuiltInTimeEntrySource))\n  return [...builtIn, ...contributed]\n}\n\n/**\n * The write-path guard the dropped database check constraint used to provide.\n * An unknown id falls back to `manual` rather than rejecting the write, matching\n * the column default the enum carried.\n */\nexport function normalizeTimeEntrySource(value: unknown): TimeEntrySource {\n  if (typeof value === 'string' && registry.has(value)) return value\n  return DEFAULT_TIME_ENTRY_SOURCE\n}\n\nconst builtInSources: readonly Omit<TimeEntrySourceDefinition, 'priority'>[] = [\n  { id: 'manual', labelKey: 'staff.time_tracking.entries.source.manual', icon: 'PenLine', editable: true },\n  { id: 'timer', labelKey: 'staff.time_tracking.entries.source.timer', icon: 'Timer', editable: true },\n  { id: 'kiosk', labelKey: 'staff.time_tracking.entries.source.kiosk', icon: 'Monitor', editable: false },\n  { id: 'mobile', labelKey: 'staff.time_tracking.entries.source.mobile', icon: 'Smartphone', editable: true },\n]\n\nfor (const source of builtInSources) {\n  registry.registerBuiltIn({ ...source, priority: BUILT_IN_STRATEGY_PRIORITY })\n}\n"],
+  "mappings": "AAcA,SAAS,uBAAuB;AAChC,SAAS,wBAAwB,kCAAkC;AAE5D,MAAM,iCAAiC,CAAC,UAAU,SAAS,SAAS,QAAQ;AAmB5E,MAAM,gCAAgC,gBAAgB,MAAM,wBAAwB;AAEpF,MAAM,4BAAoD;AAEjE,MAAM,WAAW,uBAAkD,6BAA6B;AAEzF,SAAS,wBAAwB,QAA+C;AACrF,SAAO,SAAS,SAAS,MAAM;AACjC;AAEO,SAAS,uBAAoD;AAClE,SAAO,SAAS,KAAK;AACvB;AAEO,SAAS,mBAAmB,IAAiE;AAClG,SAAO,SAAS,IAAI,EAAE;AACxB;AAEO,SAAS,mBAAmB,IAAwC;AACzE,SAAO,SAAS,IAAI,EAAE;AACxB;AAGO,SAAS,qBAA+B;AAC7C,QAAM,UAAU,+BAA+B,OAAO,CAAC,OAAO,SAAS,IAAI,EAAE,CAAC;AAC9E,QAAM,cAAc,SAAS,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,SAAS,EAA4B,CAAC;AACjG,SAAO,CAAC,GAAG,SAAS,GAAG,WAAW;AACpC;AAOO,SAAS,yBAAyB,OAAiC;AACxE,MAAI,OAAO,UAAU,YAAY,SAAS,IAAI,KAAK,EAAG,QAAO;AAC7D,SAAO;AACT;AAEA,MAAM,iBAAyE;AAAA,EAC7E,EAAE,IAAI,UAAU,UAAU,6CAA6C,MAAM,WAAW,UAAU,KAAK;AAAA,EACvG,EAAE,IAAI,SAAS,UAAU,4CAA4C,MAAM,SAAS,UAAU,KAAK;AAAA,EACnG,EAAE,IAAI,SAAS,UAAU,4CAA4C,MAAM,WAAW,UAAU,MAAM;AAAA,EACtG,EAAE,IAAI,UAAU,UAAU,6CAA6C,MAAM,cAAc,UAAU,KAAK;AAC5G;AAEA,WAAW,UAAU,gBAAgB;AACnC,WAAS,gBAAgB,EAAE,GAAG,QAAQ,UAAU,2BAA2B,CAAC;AAC9E;",
+  "names": []
+}