@persei/perseed-api 5.0.23 → 5.0.25

package/dist/dates.helper-CDM5aEJG.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"dates.helper-CDM5aEJG.cjs","sources":["../../src/v2/modules/global/dates/dates.helper.ts"],"sourcesContent":["import dayjs from 'dayjs'\nimport utcPlugin from 'dayjs/plugin/utc'\nimport type { PeriodUnit } from './dates.schema'\n\n/**\n * Generic calendar primitives — period alignment and whole-period arithmetic. Built on `dayjs`\n * (already used by every consumer), so calendar arithmetic and month-end clamping come for free.\n *\n * These functions are locale-agnostic: the week start is always an injected number (1 = Monday …\n * 7 = Sunday), never derived here. Callers that need a locale-aware week start resolve it with\n * `global/locale`'s `getWeekStart(locale)` and pass the result in. That keeps this module free of\n * any dependency on other v2 modules.\n *\n * The `utc` flag selects the calendar the alignment runs in: `false` (default) uses the ambient\n * local calendar (a viewer's timezone); `true` uses UTC (the backend). Everything else is shared.\n */\n\ndayjs.extend(utcPlugin)\n\n// ISO Monday — the week start assumed when the caller doesn't inject a locale-derived one. Matches\n// DEFAULT_LOCALE (es-ES), whose week also starts on Monday.\nexport const DEFAULT_WEEK_START = 1\n\n// Builds the dayjs instance in the requested calendar (UTC or ambient local).\nexport function toCalendar(ms: number, utc: boolean): dayjs.Dayjs {\n  return utc ? dayjs.utc(ms) : dayjs(ms)\n}\n\n// dayjs `.day()` is 0 = Sunday … 6 = Saturday; convert to ISO 1 = Monday … 7 = Sunday.\nfunction isoWeekday(d: dayjs.Dayjs): number {\n  const day = d.day()\n  return day === 0 ? 7 : day\n}\n\n/**\n * Aligns an instant to the start of the calendar period it falls in:\n * weeks → the injected first weekday at midnight, months → the 1st at midnight,\n * days → midnight, hours → the start of the hour. `utc` runs the alignment in UTC.\n */\nexport function getPeriodStart(\n  ms: number,\n  unit: PeriodUnit,\n  weekStart: number = DEFAULT_WEEK_START,\n  utc = false,\n): number {\n  const d = toCalendar(ms, utc)\n  if (unit === 'week') {\n    // Not `startOf('week')`: that follows the dayjs locale, but the week start here is caller-driven.\n    const diff = (isoWeekday(d) - weekStart + 7) % 7\n    return d.subtract(diff, 'day').startOf('day').valueOf()\n  }\n  return d.startOf(unit).valueOf()\n}\n\n/**\n * Subtracts `value` whole calendar periods from an instant, without aligning. Month subtraction\n * clamps to the last day of the target month (e.g. 31 Mar − 1 month → 28 Feb), which dayjs does\n * natively. `utc` runs the arithmetic in UTC.\n */\nexport function subtractPeriods(ms: number, value: number, unit: PeriodUnit, utc = false): number {\n  return toCalendar(ms, utc).subtract(value, unit).valueOf()\n}\n"],"names":[],"mappings":";;;AAiBA,MAAM,OAAO,SAAS;AAIf,MAAM,qBAAqB;AAG3B,SAAS,WAAW,IAAY,KAA2B;AAChE,SAAO,MAAM,MAAM,IAAI,EAAE,IAAI,MAAM,EAAE;AACvC;AAGA,SAAS,WAAW,GAAwB;AAC1C,QAAM,MAAM,EAAE,IAAA;AACd,SAAO,QAAQ,IAAI,IAAI;AACzB;AAOO,SAAS,eACd,IACA,MACA,YAAoB,oBACpB,MAAM,OACE;AACR,QAAM,IAAI,WAAW,IAAI,GAAG;AAC5B,MAAI,SAAS,QAAQ;AAEnB,UAAM,QAAQ,WAAW,CAAC,IAAI,YAAY,KAAK;AAC/C,WAAO,EAAE,SAAS,MAAM,KAAK,EAAE,QAAQ,KAAK,EAAE,QAAA;AAAA,EAChD;AACA,SAAO,EAAE,QAAQ,IAAI,EAAE,QAAA;AACzB;AAOO,SAAS,gBAAgB,IAAY,OAAe,MAAkB,MAAM,OAAe;AAChG,SAAO,WAAW,IAAI,GAAG,EAAE,SAAS,OAAO,IAAI,EAAE,QAAA;AACnD;;;;"}
+{"version":3,"file":"dates.helper-CDM5aEJG.cjs","sources":["../../src/v2/modules/global/dates/dates.helper/dates.helper.ts"],"sourcesContent":["import dayjs from 'dayjs'\nimport utcPlugin from 'dayjs/plugin/utc'\nimport type { PeriodUnit } from '../dates.schema'\n\n/**\n * Generic calendar primitives — period alignment and whole-period arithmetic. Built on `dayjs`\n * (already used by every consumer), so calendar arithmetic and month-end clamping come for free.\n *\n * These functions are locale-agnostic: the week start is always an injected number (1 = Monday …\n * 7 = Sunday), never derived here. Callers that need a locale-aware week start resolve it with\n * `global/locale`'s `getWeekStart(locale)` and pass the result in. That keeps this module free of\n * any dependency on other v2 modules.\n *\n * The `utc` flag selects the calendar the alignment runs in: `false` (default) uses the ambient\n * local calendar (a viewer's timezone); `true` uses UTC (the backend). Everything else is shared.\n */\n\ndayjs.extend(utcPlugin)\n\n// ISO Monday — the week start assumed when the caller doesn't inject a locale-derived one. Matches\n// DEFAULT_LOCALE (es-ES), whose week also starts on Monday.\nexport const DEFAULT_WEEK_START = 1\n\n// Builds the dayjs instance in the requested calendar (UTC or ambient local).\nexport function toCalendar(ms: number, utc: boolean): dayjs.Dayjs {\n  return utc ? dayjs.utc(ms) : dayjs(ms)\n}\n\n// dayjs `.day()` is 0 = Sunday … 6 = Saturday; convert to ISO 1 = Monday … 7 = Sunday.\nfunction isoWeekday(d: dayjs.Dayjs): number {\n  const day = d.day()\n  return day === 0 ? 7 : day\n}\n\n/**\n * Aligns an instant to the start of the calendar period it falls in:\n * weeks → the injected first weekday at midnight, months → the 1st at midnight,\n * days → midnight, hours → the start of the hour. `utc` runs the alignment in UTC.\n */\nexport function getPeriodStart(\n  ms: number,\n  unit: PeriodUnit,\n  weekStart: number = DEFAULT_WEEK_START,\n  utc = false,\n): number {\n  const d = toCalendar(ms, utc)\n  if (unit === 'week') {\n    // Not `startOf('week')`: that follows the dayjs locale, but the week start here is caller-driven.\n    const diff = (isoWeekday(d) - weekStart + 7) % 7\n    return d.subtract(diff, 'day').startOf('day').valueOf()\n  }\n  return d.startOf(unit).valueOf()\n}\n\n/**\n * Subtracts `value` whole calendar periods from an instant, without aligning. Month subtraction\n * clamps to the last day of the target month (e.g. 31 Mar − 1 month → 28 Feb), which dayjs does\n * natively. `utc` runs the arithmetic in UTC.\n */\nexport function subtractPeriods(ms: number, value: number, unit: PeriodUnit, utc = false): number {\n  return toCalendar(ms, utc).subtract(value, unit).valueOf()\n}\n"],"names":[],"mappings":";;;AAiBA,MAAM,OAAO,SAAS;AAIf,MAAM,qBAAqB;AAG3B,SAAS,WAAW,IAAY,KAA2B;AAChE,SAAO,MAAM,MAAM,IAAI,EAAE,IAAI,MAAM,EAAE;AACvC;AAGA,SAAS,WAAW,GAAwB;AAC1C,QAAM,MAAM,EAAE,IAAA;AACd,SAAO,QAAQ,IAAI,IAAI;AACzB;AAOO,SAAS,eACd,IACA,MACA,YAAoB,oBACpB,MAAM,OACE;AACR,QAAM,IAAI,WAAW,IAAI,GAAG;AAC5B,MAAI,SAAS,QAAQ;AAEnB,UAAM,QAAQ,WAAW,CAAC,IAAI,YAAY,KAAK;AAC/C,WAAO,EAAE,SAAS,MAAM,KAAK,EAAE,QAAQ,KAAK,EAAE,QAAA;AAAA,EAChD;AACA,SAAO,EAAE,QAAQ,IAAI,EAAE,QAAA;AACzB;AAOO,SAAS,gBAAgB,IAAY,OAAe,MAAkB,MAAM,OAAe;AAChG,SAAO,WAAW,IAAI,GAAG,EAAE,SAAS,OAAO,IAAI,EAAE,QAAA;AACnD;;;;"}

package/dist/dates.helper-XRCJ_UAQ.js.map

@@ -1 +1 @@
-{"version":3,"file":"dates.helper-XRCJ_UAQ.js","sources":["../../src/v2/modules/global/dates/dates.helper.ts"],"sourcesContent":["import dayjs from 'dayjs'\nimport utcPlugin from 'dayjs/plugin/utc'\nimport type { PeriodUnit } from './dates.schema'\n\n/**\n * Generic calendar primitives — period alignment and whole-period arithmetic. Built on `dayjs`\n * (already used by every consumer), so calendar arithmetic and month-end clamping come for free.\n *\n * These functions are locale-agnostic: the week start is always an injected number (1 = Monday …\n * 7 = Sunday), never derived here. Callers that need a locale-aware week start resolve it with\n * `global/locale`'s `getWeekStart(locale)` and pass the result in. That keeps this module free of\n * any dependency on other v2 modules.\n *\n * The `utc` flag selects the calendar the alignment runs in: `false` (default) uses the ambient\n * local calendar (a viewer's timezone); `true` uses UTC (the backend). Everything else is shared.\n */\n\ndayjs.extend(utcPlugin)\n\n// ISO Monday — the week start assumed when the caller doesn't inject a locale-derived one. Matches\n// DEFAULT_LOCALE (es-ES), whose week also starts on Monday.\nexport const DEFAULT_WEEK_START = 1\n\n// Builds the dayjs instance in the requested calendar (UTC or ambient local).\nexport function toCalendar(ms: number, utc: boolean): dayjs.Dayjs {\n  return utc ? dayjs.utc(ms) : dayjs(ms)\n}\n\n// dayjs `.day()` is 0 = Sunday … 6 = Saturday; convert to ISO 1 = Monday … 7 = Sunday.\nfunction isoWeekday(d: dayjs.Dayjs): number {\n  const day = d.day()\n  return day === 0 ? 7 : day\n}\n\n/**\n * Aligns an instant to the start of the calendar period it falls in:\n * weeks → the injected first weekday at midnight, months → the 1st at midnight,\n * days → midnight, hours → the start of the hour. `utc` runs the alignment in UTC.\n */\nexport function getPeriodStart(\n  ms: number,\n  unit: PeriodUnit,\n  weekStart: number = DEFAULT_WEEK_START,\n  utc = false,\n): number {\n  const d = toCalendar(ms, utc)\n  if (unit === 'week') {\n    // Not `startOf('week')`: that follows the dayjs locale, but the week start here is caller-driven.\n    const diff = (isoWeekday(d) - weekStart + 7) % 7\n    return d.subtract(diff, 'day').startOf('day').valueOf()\n  }\n  return d.startOf(unit).valueOf()\n}\n\n/**\n * Subtracts `value` whole calendar periods from an instant, without aligning. Month subtraction\n * clamps to the last day of the target month (e.g. 31 Mar − 1 month → 28 Feb), which dayjs does\n * natively. `utc` runs the arithmetic in UTC.\n */\nexport function subtractPeriods(ms: number, value: number, unit: PeriodUnit, utc = false): number {\n  return toCalendar(ms, utc).subtract(value, unit).valueOf()\n}\n"],"names":[],"mappings":";;AAiBA,MAAM,OAAO,SAAS;AAIf,MAAM,qBAAqB;AAG3B,SAAS,WAAW,IAAY,KAA2B;AAChE,SAAO,MAAM,MAAM,IAAI,EAAE,IAAI,MAAM,EAAE;AACvC;AAGA,SAAS,WAAW,GAAwB;AAC1C,QAAM,MAAM,EAAE,IAAA;AACd,SAAO,QAAQ,IAAI,IAAI;AACzB;AAOO,SAAS,eACd,IACA,MACA,YAAoB,oBACpB,MAAM,OACE;AACR,QAAM,IAAI,WAAW,IAAI,GAAG;AAC5B,MAAI,SAAS,QAAQ;AAEnB,UAAM,QAAQ,WAAW,CAAC,IAAI,YAAY,KAAK;AAC/C,WAAO,EAAE,SAAS,MAAM,KAAK,EAAE,QAAQ,KAAK,EAAE,QAAA;AAAA,EAChD;AACA,SAAO,EAAE,QAAQ,IAAI,EAAE,QAAA;AACzB;AAOO,SAAS,gBAAgB,IAAY,OAAe,MAAkB,MAAM,OAAe;AAChG,SAAO,WAAW,IAAI,GAAG,EAAE,SAAS,OAAO,IAAI,EAAE,QAAA;AACnD;"}
+{"version":3,"file":"dates.helper-XRCJ_UAQ.js","sources":["../../src/v2/modules/global/dates/dates.helper/dates.helper.ts"],"sourcesContent":["import dayjs from 'dayjs'\nimport utcPlugin from 'dayjs/plugin/utc'\nimport type { PeriodUnit } from '../dates.schema'\n\n/**\n * Generic calendar primitives — period alignment and whole-period arithmetic. Built on `dayjs`\n * (already used by every consumer), so calendar arithmetic and month-end clamping come for free.\n *\n * These functions are locale-agnostic: the week start is always an injected number (1 = Monday …\n * 7 = Sunday), never derived here. Callers that need a locale-aware week start resolve it with\n * `global/locale`'s `getWeekStart(locale)` and pass the result in. That keeps this module free of\n * any dependency on other v2 modules.\n *\n * The `utc` flag selects the calendar the alignment runs in: `false` (default) uses the ambient\n * local calendar (a viewer's timezone); `true` uses UTC (the backend). Everything else is shared.\n */\n\ndayjs.extend(utcPlugin)\n\n// ISO Monday — the week start assumed when the caller doesn't inject a locale-derived one. Matches\n// DEFAULT_LOCALE (es-ES), whose week also starts on Monday.\nexport const DEFAULT_WEEK_START = 1\n\n// Builds the dayjs instance in the requested calendar (UTC or ambient local).\nexport function toCalendar(ms: number, utc: boolean): dayjs.Dayjs {\n  return utc ? dayjs.utc(ms) : dayjs(ms)\n}\n\n// dayjs `.day()` is 0 = Sunday … 6 = Saturday; convert to ISO 1 = Monday … 7 = Sunday.\nfunction isoWeekday(d: dayjs.Dayjs): number {\n  const day = d.day()\n  return day === 0 ? 7 : day\n}\n\n/**\n * Aligns an instant to the start of the calendar period it falls in:\n * weeks → the injected first weekday at midnight, months → the 1st at midnight,\n * days → midnight, hours → the start of the hour. `utc` runs the alignment in UTC.\n */\nexport function getPeriodStart(\n  ms: number,\n  unit: PeriodUnit,\n  weekStart: number = DEFAULT_WEEK_START,\n  utc = false,\n): number {\n  const d = toCalendar(ms, utc)\n  if (unit === 'week') {\n    // Not `startOf('week')`: that follows the dayjs locale, but the week start here is caller-driven.\n    const diff = (isoWeekday(d) - weekStart + 7) % 7\n    return d.subtract(diff, 'day').startOf('day').valueOf()\n  }\n  return d.startOf(unit).valueOf()\n}\n\n/**\n * Subtracts `value` whole calendar periods from an instant, without aligning. Month subtraction\n * clamps to the last day of the target month (e.g. 31 Mar − 1 month → 28 Feb), which dayjs does\n * natively. `utc` runs the arithmetic in UTC.\n */\nexport function subtractPeriods(ms: number, value: number, unit: PeriodUnit, utc = false): number {\n  return toCalendar(ms, utc).subtract(value, unit).valueOf()\n}\n"],"names":[],"mappings":";;AAiBA,MAAM,OAAO,SAAS;AAIf,MAAM,qBAAqB;AAG3B,SAAS,WAAW,IAAY,KAA2B;AAChE,SAAO,MAAM,MAAM,IAAI,EAAE,IAAI,MAAM,EAAE;AACvC;AAGA,SAAS,WAAW,GAAwB;AAC1C,QAAM,MAAM,EAAE,IAAA;AACd,SAAO,QAAQ,IAAI,IAAI;AACzB;AAOO,SAAS,eACd,IACA,MACA,YAAoB,oBACpB,MAAM,OACE;AACR,QAAM,IAAI,WAAW,IAAI,GAAG;AAC5B,MAAI,SAAS,QAAQ;AAEnB,UAAM,QAAQ,WAAW,CAAC,IAAI,YAAY,KAAK;AAC/C,WAAO,EAAE,SAAS,MAAM,KAAK,EAAE,QAAQ,KAAK,EAAE,QAAA;AAAA,EAChD;AACA,SAAO,EAAE,QAAQ,IAAI,EAAE,QAAA;AACzB;AAOO,SAAS,gBAAgB,IAAY,OAAe,MAAkB,MAAM,OAAe;AAChG,SAAO,WAAW,IAAI,GAAG,EAAE,SAAS,OAAO,IAAI,EAAE,QAAA;AACnD;"}

package/dist/dates.schema-BqkBcmM6.js

@@ -0,0 +1,18 @@
+import { Type } from "typebox";
+const API_DATETIME_ACCEPTED_NOTE = "Only this spelling is accepted: `T` as the separator (a space is a 400) and an offset with minutes, either `Z` or `±HH:MM` (`+01` and `+0100` are a 400). A lowercase `t`/`z` and a fractional second are fine";
+const API_DATETIME_EXAMPLE = "2026-01-15T10:30:00Z";
+const EMITTED_DATETIME_NOTE = "Emitted as ISO-8601 in UTC";
+const apiDateTime = Type.Codec(Type.String({ format: "date-time" })).Decode((value) => {
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) {
+    throw new Error(`Invalid date-time: ${value}`);
+  }
+  return date;
+}).Encode((date) => date.toISOString());
+export {
+  API_DATETIME_ACCEPTED_NOTE as A,
+  EMITTED_DATETIME_NOTE as E,
+  API_DATETIME_EXAMPLE as a,
+  apiDateTime as b
+};
+//# sourceMappingURL=dates.schema-BqkBcmM6.js.map

package/dist/dates.schema-BqkBcmM6.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.schema-BqkBcmM6.js","sources":["../../src/v2/modules/global/dates/dates.schema.ts"],"sourcesContent":["import { Type } from 'typebox'\n\n/**\n * Generic calendar unit shared by the date primitives. Pure type — the calendar arithmetic that\n * consumes it lives in `dates.helper.ts`. Domain modules that need a narrower alias (e.g. the trend\n * widget's `TrendWindowUnit`) build it on top of this one, so the set of units is defined once here.\n */\nexport type PeriodUnit = 'hour' | 'day' | 'week' | 'month'\n\n/**\n * Datetimes a request carries are declared with `format: 'date-time'` (RFC 3339): a date and a time\n * separated by `T`, an optional fraction, and a mandatory offset (`Z` or `±HH:MM`). The offset names\n * the instant; the service converts it to UTC for the column.\n *\n * The format is TypeBox's, not `ajv-formats`': routes compile through `TypeBoxValidatorCompiler`\n * (`app.ts`), and `ajv-formats` only validates the v1/Objection layer. Which one runs matters,\n * because TypeBox's is the stricter of the two and the difference is visible from outside:\n *\n * - It splits the value on `/T/i` alone, so `T`/`t` is the only separator — a space is a 400.\n * - Its offset is `(?:Z|([+-])(\\d\\d):(\\d\\d))?`, so the minutes are not optional: `+01` is a 400,\n *   and so is `+0100` without the colon. That is what keeps `dayjs.utc()` from ever seeing an\n *   hour-only offset, which it cannot read — it would fall back to parsing the value as a bare wall\n *   clock and drop the offset, storing an instant an hour off with no error.\n * - It bounds the offset to `±23:59` (`tzH > 23 || tzM > 59`), so `+99:99` is a 400, and it checks\n *   the calendar (`IsDate`, leap years included), so `2026-02-31T00:00:00Z` is a 400 before any\n *   handler runs. The bound is RFC 3339's and not the tz database's, so it also takes offsets no\n *   zone uses (`-14:00`, `+23:59`) — each still names one unambiguous instant, so what gets stored\n *   is right.\n *\n * A `pattern` alongside the format would be dead weight: everything one could reasonably spell in it\n * is already a subset of what the format checks, and a stricter one drifts silently the day either\n * side changes. This was tried and removed (persei/tasks#294).\n *\n * This is that contract in one sentence, for the description of a request field: what the format\n * takes and, just as important, the two near-miss spellings a client is likely to try.\n */\nexport const API_DATETIME_ACCEPTED_NOTE =\n  'Only this spelling is accepted: `T` as the separator (a space is a 400) and an offset with minutes, either `Z` or `±HH:MM` (`+01` and `+0100` are a 400). A lowercase `t`/`z` and a fractional second are fine'\n\n/** An RFC 3339 datetime, for schema examples and API documentation. */\nexport const API_DATETIME_EXAMPLE = '2026-01-15T10:30:00Z'\n\n/**\n * What a datetime *coming out* of the API looks like, for the description of a response field.\n *\n * The outbound shape is narrower than the inbound one and no pattern states it: datetimes leave the\n * column as `Date` and are serialised by `fast-json-stringify` with `.toISOString()`, so the schema\n * never validates what is emitted. Saying it in the description is what puts it in the published\n * spec, which is where a client reads the contract from.\n */\nexport const EMITTED_DATETIME_NOTE = 'Emitted as ISO-8601 in UTC'\n\n/**\n * An RFC 3339 datetime a request carries, decoded to a `Date` at the HTTP boundary.\n *\n * Declaring a request field with this instead of `Type.String({ format: 'date-time' })` is what\n * moves the string→instant conversion out of the services: the handler receives a `Date`, hands it\n * to the model, and `BaseModel.$parseJson` (`datesToString` → `getMySQLDateTime`) writes the UTC\n * string the column takes. No service has to know a date format.\n *\n * The decode runs in the validator compiler (`decodingValidatorCompiler`), after validation — see\n * `decoding-validator.helper.ts` for why that is the only place it can run. What this type contributes is the\n * declaration: a schema that carries it is a schema whose datetimes arrive decoded.\n *\n * `Type.Codec` and not `Type.Transform`: this is `typebox`, where the codec combinator carries that\n * name. The wrapped type is the same `format: 'date-time'` as before, so what the route accepts and\n * rejects does not move — see `API_DATETIME_ACCEPTED_NOTE` for the contract that stays put.\n *\n * `Encode` exists for completeness and does not run on the way out: responses are serialised by\n * `fast-json-stringify`, which knows nothing about codecs. Datetimes leave as ISO-8601 because they\n * come out of the pool as `Date` and get `.toISOString()`d there, not because of this. In this\n * architecture the codec is effectively one-way.\n */\nexport const apiDateTime = Type.Codec(Type.String({ format: 'date-time' }))\n  .Decode((value) => {\n    const date = new Date(value)\n    // `format: 'date-time'` accepts a leap second (`:60`), which RFC 3339 allows and `Date` does\n    // not: `new Date('2026-01-15T23:59:60Z')` is an `Invalid Date`. Rejecting it here answers 400\n    // like any other malformed datetime, instead of letting the invalid instant reach the model and\n    // fail there as a 500.\n    if (Number.isNaN(date.getTime())) {\n      throw new Error(`Invalid date-time: ${value}`)\n    }\n    return date\n  })\n  .Encode((date) => date.toISOString())\n"],"names":[],"mappings":";AAoCO,MAAM,6BACX;AAGK,MAAM,uBAAuB;AAU7B,MAAM,wBAAwB;AAuB9B,MAAM,cAAc,KAAK,MAAM,KAAK,OAAO,EAAE,QAAQ,aAAa,CAAC,EACvE,OAAO,CAAC,UAAU;AACjB,QAAM,OAAO,IAAI,KAAK,KAAK;AAK3B,MAAI,OAAO,MAAM,KAAK,QAAA,CAAS,GAAG;AAChC,UAAM,IAAI,MAAM,sBAAsB,KAAK,EAAE;AAAA,EAC/C;AACA,SAAO;AACT,CAAC,EACA,OAAO,CAAC,SAAS,KAAK,aAAa;"}

package/dist/dates.schema-npKpToAJ.cjs

@@ -0,0 +1,17 @@
+"use strict";
+const typebox = require("typebox");
+const API_DATETIME_ACCEPTED_NOTE = "Only this spelling is accepted: `T` as the separator (a space is a 400) and an offset with minutes, either `Z` or `±HH:MM` (`+01` and `+0100` are a 400). A lowercase `t`/`z` and a fractional second are fine";
+const API_DATETIME_EXAMPLE = "2026-01-15T10:30:00Z";
+const EMITTED_DATETIME_NOTE = "Emitted as ISO-8601 in UTC";
+const apiDateTime = typebox.Type.Codec(typebox.Type.String({ format: "date-time" })).Decode((value) => {
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) {
+    throw new Error(`Invalid date-time: ${value}`);
+  }
+  return date;
+}).Encode((date) => date.toISOString());
+exports.API_DATETIME_ACCEPTED_NOTE = API_DATETIME_ACCEPTED_NOTE;
+exports.API_DATETIME_EXAMPLE = API_DATETIME_EXAMPLE;
+exports.EMITTED_DATETIME_NOTE = EMITTED_DATETIME_NOTE;
+exports.apiDateTime = apiDateTime;
+//# sourceMappingURL=dates.schema-npKpToAJ.cjs.map

package/dist/dates.schema-npKpToAJ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.schema-npKpToAJ.cjs","sources":["../../src/v2/modules/global/dates/dates.schema.ts"],"sourcesContent":["import { Type } from 'typebox'\n\n/**\n * Generic calendar unit shared by the date primitives. Pure type — the calendar arithmetic that\n * consumes it lives in `dates.helper.ts`. Domain modules that need a narrower alias (e.g. the trend\n * widget's `TrendWindowUnit`) build it on top of this one, so the set of units is defined once here.\n */\nexport type PeriodUnit = 'hour' | 'day' | 'week' | 'month'\n\n/**\n * Datetimes a request carries are declared with `format: 'date-time'` (RFC 3339): a date and a time\n * separated by `T`, an optional fraction, and a mandatory offset (`Z` or `±HH:MM`). The offset names\n * the instant; the service converts it to UTC for the column.\n *\n * The format is TypeBox's, not `ajv-formats`': routes compile through `TypeBoxValidatorCompiler`\n * (`app.ts`), and `ajv-formats` only validates the v1/Objection layer. Which one runs matters,\n * because TypeBox's is the stricter of the two and the difference is visible from outside:\n *\n * - It splits the value on `/T/i` alone, so `T`/`t` is the only separator — a space is a 400.\n * - Its offset is `(?:Z|([+-])(\\d\\d):(\\d\\d))?`, so the minutes are not optional: `+01` is a 400,\n *   and so is `+0100` without the colon. That is what keeps `dayjs.utc()` from ever seeing an\n *   hour-only offset, which it cannot read — it would fall back to parsing the value as a bare wall\n *   clock and drop the offset, storing an instant an hour off with no error.\n * - It bounds the offset to `±23:59` (`tzH > 23 || tzM > 59`), so `+99:99` is a 400, and it checks\n *   the calendar (`IsDate`, leap years included), so `2026-02-31T00:00:00Z` is a 400 before any\n *   handler runs. The bound is RFC 3339's and not the tz database's, so it also takes offsets no\n *   zone uses (`-14:00`, `+23:59`) — each still names one unambiguous instant, so what gets stored\n *   is right.\n *\n * A `pattern` alongside the format would be dead weight: everything one could reasonably spell in it\n * is already a subset of what the format checks, and a stricter one drifts silently the day either\n * side changes. This was tried and removed (persei/tasks#294).\n *\n * This is that contract in one sentence, for the description of a request field: what the format\n * takes and, just as important, the two near-miss spellings a client is likely to try.\n */\nexport const API_DATETIME_ACCEPTED_NOTE =\n  'Only this spelling is accepted: `T` as the separator (a space is a 400) and an offset with minutes, either `Z` or `±HH:MM` (`+01` and `+0100` are a 400). A lowercase `t`/`z` and a fractional second are fine'\n\n/** An RFC 3339 datetime, for schema examples and API documentation. */\nexport const API_DATETIME_EXAMPLE = '2026-01-15T10:30:00Z'\n\n/**\n * What a datetime *coming out* of the API looks like, for the description of a response field.\n *\n * The outbound shape is narrower than the inbound one and no pattern states it: datetimes leave the\n * column as `Date` and are serialised by `fast-json-stringify` with `.toISOString()`, so the schema\n * never validates what is emitted. Saying it in the description is what puts it in the published\n * spec, which is where a client reads the contract from.\n */\nexport const EMITTED_DATETIME_NOTE = 'Emitted as ISO-8601 in UTC'\n\n/**\n * An RFC 3339 datetime a request carries, decoded to a `Date` at the HTTP boundary.\n *\n * Declaring a request field with this instead of `Type.String({ format: 'date-time' })` is what\n * moves the string→instant conversion out of the services: the handler receives a `Date`, hands it\n * to the model, and `BaseModel.$parseJson` (`datesToString` → `getMySQLDateTime`) writes the UTC\n * string the column takes. No service has to know a date format.\n *\n * The decode runs in the validator compiler (`decodingValidatorCompiler`), after validation — see\n * `decoding-validator.helper.ts` for why that is the only place it can run. What this type contributes is the\n * declaration: a schema that carries it is a schema whose datetimes arrive decoded.\n *\n * `Type.Codec` and not `Type.Transform`: this is `typebox`, where the codec combinator carries that\n * name. The wrapped type is the same `format: 'date-time'` as before, so what the route accepts and\n * rejects does not move — see `API_DATETIME_ACCEPTED_NOTE` for the contract that stays put.\n *\n * `Encode` exists for completeness and does not run on the way out: responses are serialised by\n * `fast-json-stringify`, which knows nothing about codecs. Datetimes leave as ISO-8601 because they\n * come out of the pool as `Date` and get `.toISOString()`d there, not because of this. In this\n * architecture the codec is effectively one-way.\n */\nexport const apiDateTime = Type.Codec(Type.String({ format: 'date-time' }))\n  .Decode((value) => {\n    const date = new Date(value)\n    // `format: 'date-time'` accepts a leap second (`:60`), which RFC 3339 allows and `Date` does\n    // not: `new Date('2026-01-15T23:59:60Z')` is an `Invalid Date`. Rejecting it here answers 400\n    // like any other malformed datetime, instead of letting the invalid instant reach the model and\n    // fail there as a 500.\n    if (Number.isNaN(date.getTime())) {\n      throw new Error(`Invalid date-time: ${value}`)\n    }\n    return date\n  })\n  .Encode((date) => date.toISOString())\n"],"names":["Type"],"mappings":";;AAoCO,MAAM,6BACX;AAGK,MAAM,uBAAuB;AAU7B,MAAM,wBAAwB;AAuB9B,MAAM,cAAcA,QAAAA,KAAK,MAAMA,QAAAA,KAAK,OAAO,EAAE,QAAQ,aAAa,CAAC,EACvE,OAAO,CAAC,UAAU;AACjB,QAAM,OAAO,IAAI,KAAK,KAAK;AAK3B,MAAI,OAAO,MAAM,KAAK,QAAA,CAAS,GAAG;AAChC,UAAM,IAAI,MAAM,sBAAsB,KAAK,EAAE;AAAA,EAC/C;AACA,SAAO;AACT,CAAC,EACA,OAAO,CAAC,SAAS,KAAK,aAAa;;;;;"}

package/dist/ecosystem-container-widget.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const dates_helper = require("./dates.helper-CDM5aEJG.cjs");
 const globalLocale = require("./global-locale.cjs");
+const dates_helper = require("./dates.helper-CDM5aEJG.cjs");
 function resolveTrendWindow(nowMs, config, weekStart = globalLocale.getWeekStart(), utc = false) {
   const { fromValue, unit } = config;
   const toValue = config.toValue ?? 0;

package/dist/ecosystem-container-widget.mjs

@@ -1,5 +1,5 @@
-import { t as toCalendar, g as getPeriodStart, s as subtractPeriods } from "./dates.helper-XRCJ_UAQ.js";
 import { getWeekStart } from "./global-locale.mjs";
+import { t as toCalendar, g as getPeriodStart, s as subtractPeriods } from "./dates.helper-XRCJ_UAQ.js";
 function resolveTrendWindow(nowMs, config, weekStart = getWeekStart(), utc = false) {
   const { fromValue, unit } = config;
   const toValue = config.toValue ?? 0;

package/dist/ecosystem-process-log.cjs

@@ -0,0 +1,209 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const typebox = require("typebox");
+const dates_schema = require("./dates.schema-npKpToAJ.cjs");
+const ProcessLogType = {
+  LOG: 0,
+  RESULT: 1,
+  WARNING: -1,
+  ERROR: -2
+};
+const processLogTypeSchema = typebox.Type.Enum(Object.values(ProcessLogType), {
+  title: "ProcessLogType",
+  description: "Severity of the log row (not a layout/kind marker): LOG, RESULT, WARNING or ERROR"
+});
+const ProcessLogCode = {
+  BULK_UPLOAD_BATCH: "bulk_upload_batch",
+  BULK_UPLOAD_SUCCESS: "bulk_upload_success",
+  BULK_UPLOAD_ERROR: "bulk_upload_error",
+  // Trigger engine (#348). Written by `TriggerEngineService` (`action-system` module): one
+  // `TRIGGER_EVALUATION` row per trigger evaluated, one `TRIGGER_ACTION` row per action it ran, and a
+  // `TRIGGER_ERROR` row when a trigger's evaluation throws.
+  TRIGGER_EVALUATION: "trigger_evaluation",
+  TRIGGER_ERROR: "trigger_error",
+  TRIGGER_ACTION: "trigger_action"
+};
+const processLogCodeSchema = typebox.Type.Enum(Object.values(ProcessLogCode), {
+  title: "ProcessLogCode",
+  description: "What kind of event a process_log row records, and what shape its extra_data takes"
+});
+const triggerEvaluationExtraDataSchema = typebox.Type.Object(
+  {
+    source: typebox.Type.String({ description: "What fired the event: a model row or a displayer/form save" }),
+    target: typebox.Type.Optional(
+      typebox.Type.Union([typebox.Type.String(), typebox.Type.Null()], { description: "Model/displayer name the trigger is bound to" })
+    ),
+    operation: typebox.Type.Optional(
+      typebox.Type.Union([typebox.Type.String(), typebox.Type.Null()], { description: "create/update/delete that fired the event" })
+    ),
+    matched: typebox.Type.Boolean({ description: "Whether the trigger conditions matched" }),
+    conditions: typebox.Type.Optional(
+      typebox.Type.Union([typebox.Type.Unknown(), typebox.Type.Null()], {
+        description: "jsonLogic conditions the trigger was configured with"
+      })
+    ),
+    relations: typebox.Type.Optional(
+      typebox.Type.Union([typebox.Type.Unknown(), typebox.Type.Null()], {
+        description: "Relations the trigger declared to load onto `current`"
+      })
+    ),
+    relationsSkipped: typebox.Type.Optional(
+      typebox.Type.Union([typebox.Type.String(), typebox.Type.Null()], {
+        description: "Reason a declared relation could not be loaded, when one was skipped"
+      })
+    )
+  },
+  {
+    title: "TriggerEvaluationExtraData",
+    description: "extra_data of a `trigger_evaluation` row — how a trigger resolved, never the entity data it resolved against",
+    additionalProperties: false
+  }
+);
+const triggerErrorExtraDataSchema = typebox.Type.Object(
+  { error: typebox.Type.String({ description: "String representation of the exception the trigger evaluation threw" }) },
+  { title: "TriggerErrorExtraData", description: "extra_data of a `trigger_error` row", additionalProperties: false }
+);
+const triggerActionExtraDataSchema = typebox.Type.Object(
+  {
+    actionId: typebox.Type.Number({ description: "id of the action row that ran" }),
+    triggerId: typebox.Type.Number({ description: "id of the trigger that ran this action" }),
+    // Needed because the engine is shared: `triggerId` alone is ambiguous, since automatic and
+    // manual triggers are different tables (`automatic_trigger`, `manual_trigger`) with overlapping
+    // id ranges. Paired with `triggerId` this is what a consumer needs to resolve the trigger row.
+    triggerModel: typebox.Type.String({ description: "Table the trigger belongs to (automatic_trigger or manual_trigger)" }),
+    executionOrder: typebox.Type.Number({ description: "Order of this action within the trigger" }),
+    type: typebox.Type.String({ description: "Type of the action (e.g. ApiAction)" }),
+    validation: typebox.Type.Unknown({ description: "Result of validating the action context before running it" }),
+    // `ok`/`output` describe an action that ran; `aborted`/`reason` an action that never did,
+    // because validating its context failed (`resolveActionOutcome`). The two pairs are mutually
+    // exclusive in practice but declared as four optionals rather than a union: `additionalProperties:
+    // false` is what makes this schema worth having, and a row whose outcome keys are undeclared is
+    // one the debugging popup cannot show a reason for — which is exactly the aborted case.
+    ok: typebox.Type.Optional(typebox.Type.Union([typebox.Type.Boolean(), typebox.Type.Null()], { description: "Whether the action call succeeded" })),
+    output: typebox.Type.Optional(
+      typebox.Type.Union([typebox.Type.String(), typebox.Type.Null()], { description: "Failure output, when the action ran and failed" })
+    ),
+    aborted: typebox.Type.Optional(typebox.Type.Boolean({ description: "True when the action never ran" })),
+    reason: typebox.Type.Optional(typebox.Type.String({ description: "Why the action was aborted, e.g. context_validation" }))
+  },
+  { title: "TriggerActionExtraData", description: "extra_data of a `trigger_action` row", additionalProperties: false }
+);
+const processLogTriggerEngineExtraDataSchema = typebox.Type.Union(
+  [
+    typebox.Type.Object({
+      code: typebox.Type.Literal(ProcessLogCode.TRIGGER_EVALUATION),
+      extra_data: triggerEvaluationExtraDataSchema
+    }),
+    typebox.Type.Object({ code: typebox.Type.Literal(ProcessLogCode.TRIGGER_ERROR), extra_data: triggerErrorExtraDataSchema }),
+    typebox.Type.Object({ code: typebox.Type.Literal(ProcessLogCode.TRIGGER_ACTION), extra_data: triggerActionExtraDataSchema })
+  ],
+  {
+    title: "ProcessLogTriggerEngineExtraData",
+    description: "Ties each trigger-engine `code` to the shape its `extra_data` takes"
+  }
+);
+const processLogSchema = typebox.Type.Object(
+  {
+    id: typebox.Type.Number({ description: "Unique identifier of the row" }),
+    project_id: typebox.Type.Optional(
+      typebox.Type.Union([typebox.Type.Number(), typebox.Type.Null()], { description: "Project this row belongs to, when scoped to one" })
+    ),
+    created_user: typebox.Type.Optional(
+      typebox.Type.Union([typebox.Type.Number(), typebox.Type.Null()], {
+        description: "User who caused the row to be written, when a user did"
+      })
+    ),
+    related_model: typebox.Type.Optional(
+      typebox.Type.Union([typebox.Type.String({ maxLength: 255 }), typebox.Type.Null()], { description: "Table/entity kind the row is about" })
+    ),
+    related_id: typebox.Type.Optional(
+      typebox.Type.Union([typebox.Type.String({ maxLength: 255 }), typebox.Type.Null()], {
+        description: "Id of the related entity, as a string"
+      })
+    ),
+    code: typebox.Type.Optional(typebox.Type.Union([processLogCodeSchema, typebox.Type.Null()])),
+    log: typebox.Type.String({ description: "Short human-readable message" }),
+    long_log: typebox.Type.Optional(typebox.Type.Union([typebox.Type.String(), typebox.Type.Null()], { description: "Extended message, when needed" })),
+    extra_data: typebox.Type.Optional(
+      typebox.Type.Union([typebox.Type.Record(typebox.Type.String(), typebox.Type.Unknown()), typebox.Type.Null()], {
+        description: "Structured data specific to `code` — see the per-code schemas for the trigger-engine codes"
+      })
+    ),
+    type: processLogTypeSchema,
+    requires_attention: typebox.Type.Optional(typebox.Type.Boolean({ description: "Whether the row needs a human to review it" })),
+    reviewed: typebox.Type.Optional(typebox.Type.Boolean({ description: "Whether the row has been reviewed" })),
+    reviewed_date: typebox.Type.Optional(
+      typebox.Type.Union([typebox.Type.String(), typebox.Type.Null()], {
+        description: `When the row was reviewed. Null while unreviewed. ${dates_schema.EMITTED_DATETIME_NOTE}`
+      })
+    ),
+    // Correlation to a parent row (#348): a `trigger_action` row's parent is the `trigger_evaluation`
+    // (or `trigger_error`) row of the trigger that ran it, so an action's trace can always be walked
+    // back to the evaluation that triggered it. Optional/nullable because most rows (bulk upload,
+    // the trigger-evaluation row itself) have no parent, and because the column is applied out of
+    // band per ecosystem — see README.md — so it may be entirely absent from a given row's database.
+    parent_id: typebox.Type.Optional(
+      typebox.Type.Union([typebox.Type.Number(), typebox.Type.Null()], {
+        description: "Id of this row's parent process_log row, when it has one"
+      })
+    ),
+    expires_at: typebox.Type.Optional(
+      typebox.Type.Union([typebox.Type.String(), typebox.Type.Null()], {
+        description: `Retention deadline; the row is purged after it, and never expires when null. ${dates_schema.EMITTED_DATETIME_NOTE}`,
+        examples: [dates_schema.API_DATETIME_EXAMPLE]
+      })
+    ),
+    created_at: typebox.Type.Optional(
+      typebox.Type.String({
+        description: `When the row was created. ${dates_schema.EMITTED_DATETIME_NOTE}`,
+        examples: [dates_schema.API_DATETIME_EXAMPLE]
+      })
+    ),
+    mod_time: typebox.Type.Optional(
+      typebox.Type.String({
+        description: `When the row was last modified. ${dates_schema.EMITTED_DATETIME_NOTE}`,
+        examples: [dates_schema.API_DATETIME_EXAMPLE]
+      })
+    )
+  },
+  { title: "ProcessLog", description: "A process_log row" }
+);
+const listProcessLogQuerySchema = typebox.Type.Object(
+  {
+    code: typebox.Type.Optional(processLogCodeSchema),
+    type: typebox.Type.Optional(processLogTypeSchema),
+    related_model: typebox.Type.Optional(typebox.Type.String({ description: "Filter by the related entity kind" })),
+    related_id: typebox.Type.Optional(typebox.Type.String({ description: "Filter by the id of the related entity" })),
+    parent_id: typebox.Type.Optional(typebox.Type.Number({ description: "Filter by the id of the parent process_log row" })),
+    requires_attention: typebox.Type.Optional(typebox.Type.Boolean({ description: "Filter by whether the row needs review" })),
+    reviewed: typebox.Type.Optional(typebox.Type.Boolean({ description: "Filter by whether the row has been reviewed" })),
+    // `apiDateTime`, not a bare string: it carries `format: 'date-time'`, so a malformed value is
+    // rejected by the validator as a 400. A plain `Type.String` accepts anything and hands it to
+    // `getMySQLDateTime(value, true)`, which throws a `PublicApiError` with no `statusCode` — a 500
+    // for what is a bad request. Same type `alert.schema.ts` uses for its datetime fields.
+    created_from: typebox.Type.Optional(
+      typebox.Type.Union([dates_schema.apiDateTime], {
+        description: `Only rows created at or after this instant. ${dates_schema.API_DATETIME_ACCEPTED_NOTE}. ${dates_schema.EMITTED_DATETIME_NOTE}`,
+        examples: [dates_schema.API_DATETIME_EXAMPLE]
+      })
+    ),
+    created_to: typebox.Type.Optional(
+      typebox.Type.Union([dates_schema.apiDateTime], {
+        description: `Only rows created at or before this instant. ${dates_schema.API_DATETIME_ACCEPTED_NOTE}. ${dates_schema.EMITTED_DATETIME_NOTE}`,
+        examples: [dates_schema.API_DATETIME_EXAMPLE]
+      })
+    )
+  },
+  { title: "ListProcessLogQuery", description: "Filters available on the process_log list" }
+);
+exports.ProcessLogCode = ProcessLogCode;
+exports.ProcessLogType = ProcessLogType;
+exports.listProcessLogQuerySchema = listProcessLogQuerySchema;
+exports.processLogCodeSchema = processLogCodeSchema;
+exports.processLogSchema = processLogSchema;
+exports.processLogTriggerEngineExtraDataSchema = processLogTriggerEngineExtraDataSchema;
+exports.processLogTypeSchema = processLogTypeSchema;
+exports.triggerActionExtraDataSchema = triggerActionExtraDataSchema;
+exports.triggerErrorExtraDataSchema = triggerErrorExtraDataSchema;
+exports.triggerEvaluationExtraDataSchema = triggerEvaluationExtraDataSchema;
+//# sourceMappingURL=ecosystem-process-log.cjs.map

package/dist/ecosystem-process-log.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecosystem-process-log.cjs","sources":["../../src/v2/modules/ecosystem/process-log/process-log.schema.ts"],"sourcesContent":["import { Type, Static, StaticDecode } from 'typebox'\n// From the schema file, not the module barrel (`@/modules/global/dates`) that every other consumer\n// imports — the one place where `no-restricted-imports` has to give way, hence the disable.\n//\n// This module has a `lib.ts`, so this file is an entry point of the published `@persei/perseed-api`\n// bundle, which is browser code. The barrel re-exports `dates.middleware`, a `fastify-plugin` that\n// pulls in `@v1/log/debug` and, transitively, the server dependencies behind it; bundling that\n// fails, and it fails naming a transitive JSON file (`ent/reversed.json: Could not parse JSON\n// file`) rather than the import that dragged it in, so the message points nowhere near the cause.\n//\n// `global/dates`'s own `lib.ts` sidesteps the same barrel for the same reason. The alternative —\n// inlining the two description constants — would duplicate the wording the whole API documents its\n// datetimes with, and let this module's copy drift from it silently.\n// eslint-disable-next-line no-restricted-imports\nimport {\n  EMITTED_DATETIME_NOTE,\n  API_DATETIME_EXAMPLE,\n  API_DATETIME_ACCEPTED_NOTE,\n  apiDateTime,\n} from '@/modules/global/dates/dates.schema'\n\n// `process_log` is the ecosystem-wide execution log (see README.md): rows written by the trigger\n// engine, the actions it runs and the v1 bulk upload. This module owns the schema for the whole\n// table, not only the trigger-engine rows — `code` is what tells them apart.\n\n// ── ProcessLogType (severity, NOT layout) ───────────────────────────────\n// Mirrors the v1 enum (`src/schemas/process_log/types.ts`) verbatim: it already ships on the wire\n// (`type` column) and changing its numeric values would be a breaking change for every existing row\n// and consumer. Restated here as a TypeBox schema — not imported from v1 — because `lib.ts` may\n// only export pure TypeBox (see below); v1 has no schema module of its own to import from.\nexport const ProcessLogType = {\n  LOG: 0,\n  RESULT: 1,\n  WARNING: -1,\n  ERROR: -2,\n} as const\nexport const processLogTypeSchema = Type.Enum(Object.values(ProcessLogType), {\n  title: 'ProcessLogType',\n  description: 'Severity of the log row (not a layout/kind marker): LOG, RESULT, WARNING or ERROR',\n})\nexport type ProcessLogType = Static<typeof processLogTypeSchema>\n\n// ── ProcessLogCode ───────────────────────────────────────────────────────\n//\n// Canonical enum now lives HERE (v2), not in `src/schemas/process_log/types.ts` (v1).\n//\n// Why: this module (`process-log`) is the one being extended with the trigger-engine codes as part\n// of #348, it already owns the model/service half of `process_log`, and every v2 consumer that needs\n// a *typed* extra_data contract (this schema file) has to sit next to the code enum it is keyed by.\n// The two v1 importers (`BulkUploadController.ts` and `IntrospectionController.ts`) import it from\n// here rather than from `@v1/schemas`, which keeps one enum instead of two that could drift. v1's\n// `types.ts` deliberately does NOT re-export the value: doing so closes the cycle `@v1/schemas` →\n// this module's barrel → `process-log.model.ts` → `@v1/schemas`, under which the enum resolves to\n// `undefined` at runtime. It keeps an `import type` only, which is erased at compile time.\nexport const ProcessLogCode = {\n  BULK_UPLOAD_BATCH: 'bulk_upload_batch',\n  BULK_UPLOAD_SUCCESS: 'bulk_upload_success',\n  BULK_UPLOAD_ERROR: 'bulk_upload_error',\n  // Trigger engine (#348). Written by `TriggerEngineService` (`action-system` module): one\n  // `TRIGGER_EVALUATION` row per trigger evaluated, one `TRIGGER_ACTION` row per action it ran, and a\n  // `TRIGGER_ERROR` row when a trigger's evaluation throws.\n  TRIGGER_EVALUATION: 'trigger_evaluation',\n  TRIGGER_ERROR: 'trigger_error',\n  TRIGGER_ACTION: 'trigger_action',\n} as const\nexport const processLogCodeSchema = Type.Enum(Object.values(ProcessLogCode), {\n  title: 'ProcessLogCode',\n  description: 'What kind of event a process_log row records, and what shape its extra_data takes',\n})\nexport type ProcessLogCode = Static<typeof processLogCodeSchema>\n\n// ── extra_data shapes, one per trigger-engine code ───────────────────────\n// Bulk upload codes carry no typed extra_data today (nothing writes them yet outside the\n// filter-by-code reads in `BulkUploadController.ts`), so they are left out of the discriminated\n// union below rather than given a placeholder shape that no writer populates.\n\nexport const triggerEvaluationExtraDataSchema = Type.Object(\n  {\n    source: Type.String({ description: 'What fired the event: a model row or a displayer/form save' }),\n    target: Type.Optional(\n      Type.Union([Type.String(), Type.Null()], { description: 'Model/displayer name the trigger is bound to' }),\n    ),\n    operation: Type.Optional(\n      Type.Union([Type.String(), Type.Null()], { description: 'create/update/delete that fired the event' }),\n    ),\n    matched: Type.Boolean({ description: 'Whether the trigger conditions matched' }),\n    conditions: Type.Optional(\n      Type.Union([Type.Unknown(), Type.Null()], {\n        description: 'jsonLogic conditions the trigger was configured with',\n      }),\n    ),\n    relations: Type.Optional(\n      Type.Union([Type.Unknown(), Type.Null()], {\n        description: 'Relations the trigger declared to load onto `current`',\n      }),\n    ),\n    relationsSkipped: Type.Optional(\n      Type.Union([Type.String(), Type.Null()], {\n        description: 'Reason a declared relation could not be loaded, when one was skipped',\n      }),\n    ),\n  },\n  {\n    title: 'TriggerEvaluationExtraData',\n    description:\n      'extra_data of a `trigger_evaluation` row — how a trigger resolved, never the entity data it resolved against',\n    additionalProperties: false,\n  },\n)\nexport type TriggerEvaluationExtraData = Static<typeof triggerEvaluationExtraDataSchema>\n\nexport const triggerErrorExtraDataSchema = Type.Object(\n  { error: Type.String({ description: 'String representation of the exception the trigger evaluation threw' }) },\n  { title: 'TriggerErrorExtraData', description: 'extra_data of a `trigger_error` row', additionalProperties: false },\n)\nexport type TriggerErrorExtraData = Static<typeof triggerErrorExtraDataSchema>\n\nexport const triggerActionExtraDataSchema = Type.Object(\n  {\n    actionId: Type.Number({ description: 'id of the action row that ran' }),\n    triggerId: Type.Number({ description: 'id of the trigger that ran this action' }),\n    // Needed because the engine is shared: `triggerId` alone is ambiguous, since automatic and\n    // manual triggers are different tables (`automatic_trigger`, `manual_trigger`) with overlapping\n    // id ranges. Paired with `triggerId` this is what a consumer needs to resolve the trigger row.\n    triggerModel: Type.String({ description: 'Table the trigger belongs to (automatic_trigger or manual_trigger)' }),\n    executionOrder: Type.Number({ description: 'Order of this action within the trigger' }),\n    type: Type.String({ description: 'Type of the action (e.g. ApiAction)' }),\n    validation: Type.Unknown({ description: 'Result of validating the action context before running it' }),\n    // `ok`/`output` describe an action that ran; `aborted`/`reason` an action that never did,\n    // because validating its context failed (`resolveActionOutcome`). The two pairs are mutually\n    // exclusive in practice but declared as four optionals rather than a union: `additionalProperties:\n    // false` is what makes this schema worth having, and a row whose outcome keys are undeclared is\n    // one the debugging popup cannot show a reason for — which is exactly the aborted case.\n    ok: Type.Optional(Type.Union([Type.Boolean(), Type.Null()], { description: 'Whether the action call succeeded' })),\n    output: Type.Optional(\n      Type.Union([Type.String(), Type.Null()], { description: 'Failure output, when the action ran and failed' }),\n    ),\n    aborted: Type.Optional(Type.Boolean({ description: 'True when the action never ran' })),\n    reason: Type.Optional(Type.String({ description: 'Why the action was aborted, e.g. context_validation' })),\n  },\n  { title: 'TriggerActionExtraData', description: 'extra_data of a `trigger_action` row', additionalProperties: false },\n)\nexport type TriggerActionExtraData = Static<typeof triggerActionExtraDataSchema>\n\n// Discriminated (by `code`) union tying each trigger-engine code to its extra_data shape. Usable\n// both to validate a row being created and to type one being read. Bulk upload codes are\n// deliberately absent (see comment above the individual schemas).\nexport const processLogTriggerEngineExtraDataSchema = Type.Union(\n  [\n    Type.Object({\n      code: Type.Literal(ProcessLogCode.TRIGGER_EVALUATION),\n      extra_data: triggerEvaluationExtraDataSchema,\n    }),\n    Type.Object({ code: Type.Literal(ProcessLogCode.TRIGGER_ERROR), extra_data: triggerErrorExtraDataSchema }),\n    Type.Object({ code: Type.Literal(ProcessLogCode.TRIGGER_ACTION), extra_data: triggerActionExtraDataSchema }),\n  ],\n  {\n    title: 'ProcessLogTriggerEngineExtraData',\n    description: 'Ties each trigger-engine `code` to the shape its `extra_data` takes',\n  },\n)\nexport type ProcessLogTriggerEngineExtraData = Static<typeof processLogTriggerEngineExtraDataSchema>\n\n// ── process_log entity ────────────────────────────────────────────────────\n// Full row shape, for the read side of the (still to be implemented) list endpoint. `extra_data` is\n// left as a free record here — a response schema describes what every row of the table can hold,\n// including the untyped bulk_upload rows, unlike `processLogTriggerEngineExtraDataSchema` above\n// which narrows by `code` for a writer/reader that already knows it is on the trigger-engine path.\nexport const processLogSchema = Type.Object(\n  {\n    id: Type.Number({ description: 'Unique identifier of the row' }),\n    project_id: Type.Optional(\n      Type.Union([Type.Number(), Type.Null()], { description: 'Project this row belongs to, when scoped to one' }),\n    ),\n    created_user: Type.Optional(\n      Type.Union([Type.Number(), Type.Null()], {\n        description: 'User who caused the row to be written, when a user did',\n      }),\n    ),\n    related_model: Type.Optional(\n      Type.Union([Type.String({ maxLength: 255 }), Type.Null()], { description: 'Table/entity kind the row is about' }),\n    ),\n    related_id: Type.Optional(\n      Type.Union([Type.String({ maxLength: 255 }), Type.Null()], {\n        description: 'Id of the related entity, as a string',\n      }),\n    ),\n    code: Type.Optional(Type.Union([processLogCodeSchema, Type.Null()])),\n    log: Type.String({ description: 'Short human-readable message' }),\n    long_log: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: 'Extended message, when needed' })),\n    extra_data: Type.Optional(\n      Type.Union([Type.Record(Type.String(), Type.Unknown()), Type.Null()], {\n        description: 'Structured data specific to `code` — see the per-code schemas for the trigger-engine codes',\n      }),\n    ),\n    type: processLogTypeSchema,\n    requires_attention: Type.Optional(Type.Boolean({ description: 'Whether the row needs a human to review it' })),\n    reviewed: Type.Optional(Type.Boolean({ description: 'Whether the row has been reviewed' })),\n    reviewed_date: Type.Optional(\n      Type.Union([Type.String(), Type.Null()], {\n        description: `When the row was reviewed. Null while unreviewed. ${EMITTED_DATETIME_NOTE}`,\n      }),\n    ),\n    // Correlation to a parent row (#348): a `trigger_action` row's parent is the `trigger_evaluation`\n    // (or `trigger_error`) row of the trigger that ran it, so an action's trace can always be walked\n    // back to the evaluation that triggered it. Optional/nullable because most rows (bulk upload,\n    // the trigger-evaluation row itself) have no parent, and because the column is applied out of\n    // band per ecosystem — see README.md — so it may be entirely absent from a given row's database.\n    parent_id: Type.Optional(\n      Type.Union([Type.Number(), Type.Null()], {\n        description: \"Id of this row's parent process_log row, when it has one\",\n      }),\n    ),\n    expires_at: Type.Optional(\n      Type.Union([Type.String(), Type.Null()], {\n        description: `Retention deadline; the row is purged after it, and never expires when null. ${EMITTED_DATETIME_NOTE}`,\n        examples: [API_DATETIME_EXAMPLE],\n      }),\n    ),\n    created_at: Type.Optional(\n      Type.String({\n        description: `When the row was created. ${EMITTED_DATETIME_NOTE}`,\n        examples: [API_DATETIME_EXAMPLE],\n      }),\n    ),\n    mod_time: Type.Optional(\n      Type.String({\n        description: `When the row was last modified. ${EMITTED_DATETIME_NOTE}`,\n        examples: [API_DATETIME_EXAMPLE],\n      }),\n    ),\n  },\n  { title: 'ProcessLog', description: 'A process_log row' },\n)\nexport type ProcessLogData = Static<typeof processLogSchema>\n\n// ── list query filters ────────────────────────────────────────────────────\n// Filters of the (upcoming) list endpoint, on top of the pagination query — see `alert.schema.ts`\n// `listAlertQuerySchema` for the sibling precedent. Everything is optional: with none of them the\n// endpoint lists everything in scope. Exported for the endpoint (implemented separately) to consume.\nexport const listProcessLogQuerySchema = Type.Object(\n  {\n    code: Type.Optional(processLogCodeSchema),\n    type: Type.Optional(processLogTypeSchema),\n    related_model: Type.Optional(Type.String({ description: 'Filter by the related entity kind' })),\n    related_id: Type.Optional(Type.String({ description: 'Filter by the id of the related entity' })),\n    parent_id: Type.Optional(Type.Number({ description: 'Filter by the id of the parent process_log row' })),\n    requires_attention: Type.Optional(Type.Boolean({ description: 'Filter by whether the row needs review' })),\n    reviewed: Type.Optional(Type.Boolean({ description: 'Filter by whether the row has been reviewed' })),\n    // `apiDateTime`, not a bare string: it carries `format: 'date-time'`, so a malformed value is\n    // rejected by the validator as a 400. A plain `Type.String` accepts anything and hands it to\n    // `getMySQLDateTime(value, true)`, which throws a `PublicApiError` with no `statusCode` — a 500\n    // for what is a bad request. Same type `alert.schema.ts` uses for its datetime fields.\n    created_from: Type.Optional(\n      Type.Union([apiDateTime], {\n        description: `Only rows created at or after this instant. ${API_DATETIME_ACCEPTED_NOTE}. ${EMITTED_DATETIME_NOTE}`,\n        examples: [API_DATETIME_EXAMPLE],\n      }),\n    ),\n    created_to: Type.Optional(\n      Type.Union([apiDateTime], {\n        description: `Only rows created at or before this instant. ${API_DATETIME_ACCEPTED_NOTE}. ${EMITTED_DATETIME_NOTE}`,\n        examples: [API_DATETIME_EXAMPLE],\n      }),\n    ),\n  },\n  { title: 'ListProcessLogQuery', description: 'Filters available on the process_log list' },\n)\n// `StaticDecode`, not `Static`: this type describes what the *handler receives*, and the two date\n// bounds carry `apiDateTime`, so they arrive decoded to a `Date`. `Static` would type them as the\n// strings the client sent and the service would format something it never gets.\nexport type ListProcessLogQuery = StaticDecode<typeof listProcessLogQuerySchema>\n"],"names":["Type","EMITTED_DATETIME_NOTE","API_DATETIME_EXAMPLE","apiDateTime","API_DATETIME_ACCEPTED_NOTE"],"mappings":"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"}

package/dist/ecosystem-process-log.d.ts

@@ -0,0 +1 @@
+export * from './src/v2/modules/ecosystem/process-log/lib'

package/dist/ecosystem-process-log.mjs

@@ -0,0 +1,209 @@
+import { Type } from "typebox";
+import { b as apiDateTime, a as API_DATETIME_EXAMPLE, A as API_DATETIME_ACCEPTED_NOTE, E as EMITTED_DATETIME_NOTE } from "./dates.schema-BqkBcmM6.js";
+const ProcessLogType = {
+  LOG: 0,
+  RESULT: 1,
+  WARNING: -1,
+  ERROR: -2
+};
+const processLogTypeSchema = Type.Enum(Object.values(ProcessLogType), {
+  title: "ProcessLogType",
+  description: "Severity of the log row (not a layout/kind marker): LOG, RESULT, WARNING or ERROR"
+});
+const ProcessLogCode = {
+  BULK_UPLOAD_BATCH: "bulk_upload_batch",
+  BULK_UPLOAD_SUCCESS: "bulk_upload_success",
+  BULK_UPLOAD_ERROR: "bulk_upload_error",
+  // Trigger engine (#348). Written by `TriggerEngineService` (`action-system` module): one
+  // `TRIGGER_EVALUATION` row per trigger evaluated, one `TRIGGER_ACTION` row per action it ran, and a
+  // `TRIGGER_ERROR` row when a trigger's evaluation throws.
+  TRIGGER_EVALUATION: "trigger_evaluation",
+  TRIGGER_ERROR: "trigger_error",
+  TRIGGER_ACTION: "trigger_action"
+};
+const processLogCodeSchema = Type.Enum(Object.values(ProcessLogCode), {
+  title: "ProcessLogCode",
+  description: "What kind of event a process_log row records, and what shape its extra_data takes"
+});
+const triggerEvaluationExtraDataSchema = Type.Object(
+  {
+    source: Type.String({ description: "What fired the event: a model row or a displayer/form save" }),
+    target: Type.Optional(
+      Type.Union([Type.String(), Type.Null()], { description: "Model/displayer name the trigger is bound to" })
+    ),
+    operation: Type.Optional(
+      Type.Union([Type.String(), Type.Null()], { description: "create/update/delete that fired the event" })
+    ),
+    matched: Type.Boolean({ description: "Whether the trigger conditions matched" }),
+    conditions: Type.Optional(
+      Type.Union([Type.Unknown(), Type.Null()], {
+        description: "jsonLogic conditions the trigger was configured with"
+      })
+    ),
+    relations: Type.Optional(
+      Type.Union([Type.Unknown(), Type.Null()], {
+        description: "Relations the trigger declared to load onto `current`"
+      })
+    ),
+    relationsSkipped: Type.Optional(
+      Type.Union([Type.String(), Type.Null()], {
+        description: "Reason a declared relation could not be loaded, when one was skipped"
+      })
+    )
+  },
+  {
+    title: "TriggerEvaluationExtraData",
+    description: "extra_data of a `trigger_evaluation` row — how a trigger resolved, never the entity data it resolved against",
+    additionalProperties: false
+  }
+);
+const triggerErrorExtraDataSchema = Type.Object(
+  { error: Type.String({ description: "String representation of the exception the trigger evaluation threw" }) },
+  { title: "TriggerErrorExtraData", description: "extra_data of a `trigger_error` row", additionalProperties: false }
+);
+const triggerActionExtraDataSchema = Type.Object(
+  {
+    actionId: Type.Number({ description: "id of the action row that ran" }),
+    triggerId: Type.Number({ description: "id of the trigger that ran this action" }),
+    // Needed because the engine is shared: `triggerId` alone is ambiguous, since automatic and
+    // manual triggers are different tables (`automatic_trigger`, `manual_trigger`) with overlapping
+    // id ranges. Paired with `triggerId` this is what a consumer needs to resolve the trigger row.
+    triggerModel: Type.String({ description: "Table the trigger belongs to (automatic_trigger or manual_trigger)" }),
+    executionOrder: Type.Number({ description: "Order of this action within the trigger" }),
+    type: Type.String({ description: "Type of the action (e.g. ApiAction)" }),
+    validation: Type.Unknown({ description: "Result of validating the action context before running it" }),
+    // `ok`/`output` describe an action that ran; `aborted`/`reason` an action that never did,
+    // because validating its context failed (`resolveActionOutcome`). The two pairs are mutually
+    // exclusive in practice but declared as four optionals rather than a union: `additionalProperties:
+    // false` is what makes this schema worth having, and a row whose outcome keys are undeclared is
+    // one the debugging popup cannot show a reason for — which is exactly the aborted case.
+    ok: Type.Optional(Type.Union([Type.Boolean(), Type.Null()], { description: "Whether the action call succeeded" })),
+    output: Type.Optional(
+      Type.Union([Type.String(), Type.Null()], { description: "Failure output, when the action ran and failed" })
+    ),
+    aborted: Type.Optional(Type.Boolean({ description: "True when the action never ran" })),
+    reason: Type.Optional(Type.String({ description: "Why the action was aborted, e.g. context_validation" }))
+  },
+  { title: "TriggerActionExtraData", description: "extra_data of a `trigger_action` row", additionalProperties: false }
+);
+const processLogTriggerEngineExtraDataSchema = Type.Union(
+  [
+    Type.Object({
+      code: Type.Literal(ProcessLogCode.TRIGGER_EVALUATION),
+      extra_data: triggerEvaluationExtraDataSchema
+    }),
+    Type.Object({ code: Type.Literal(ProcessLogCode.TRIGGER_ERROR), extra_data: triggerErrorExtraDataSchema }),
+    Type.Object({ code: Type.Literal(ProcessLogCode.TRIGGER_ACTION), extra_data: triggerActionExtraDataSchema })
+  ],
+  {
+    title: "ProcessLogTriggerEngineExtraData",
+    description: "Ties each trigger-engine `code` to the shape its `extra_data` takes"
+  }
+);
+const processLogSchema = Type.Object(
+  {
+    id: Type.Number({ description: "Unique identifier of the row" }),
+    project_id: Type.Optional(
+      Type.Union([Type.Number(), Type.Null()], { description: "Project this row belongs to, when scoped to one" })
+    ),
+    created_user: Type.Optional(
+      Type.Union([Type.Number(), Type.Null()], {
+        description: "User who caused the row to be written, when a user did"
+      })
+    ),
+    related_model: Type.Optional(
+      Type.Union([Type.String({ maxLength: 255 }), Type.Null()], { description: "Table/entity kind the row is about" })
+    ),
+    related_id: Type.Optional(
+      Type.Union([Type.String({ maxLength: 255 }), Type.Null()], {
+        description: "Id of the related entity, as a string"
+      })
+    ),
+    code: Type.Optional(Type.Union([processLogCodeSchema, Type.Null()])),
+    log: Type.String({ description: "Short human-readable message" }),
+    long_log: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: "Extended message, when needed" })),
+    extra_data: Type.Optional(
+      Type.Union([Type.Record(Type.String(), Type.Unknown()), Type.Null()], {
+        description: "Structured data specific to `code` — see the per-code schemas for the trigger-engine codes"
+      })
+    ),
+    type: processLogTypeSchema,
+    requires_attention: Type.Optional(Type.Boolean({ description: "Whether the row needs a human to review it" })),
+    reviewed: Type.Optional(Type.Boolean({ description: "Whether the row has been reviewed" })),
+    reviewed_date: Type.Optional(
+      Type.Union([Type.String(), Type.Null()], {
+        description: `When the row was reviewed. Null while unreviewed. ${EMITTED_DATETIME_NOTE}`
+      })
+    ),
+    // Correlation to a parent row (#348): a `trigger_action` row's parent is the `trigger_evaluation`
+    // (or `trigger_error`) row of the trigger that ran it, so an action's trace can always be walked
+    // back to the evaluation that triggered it. Optional/nullable because most rows (bulk upload,
+    // the trigger-evaluation row itself) have no parent, and because the column is applied out of
+    // band per ecosystem — see README.md — so it may be entirely absent from a given row's database.
+    parent_id: Type.Optional(
+      Type.Union([Type.Number(), Type.Null()], {
+        description: "Id of this row's parent process_log row, when it has one"
+      })
+    ),
+    expires_at: Type.Optional(
+      Type.Union([Type.String(), Type.Null()], {
+        description: `Retention deadline; the row is purged after it, and never expires when null. ${EMITTED_DATETIME_NOTE}`,
+        examples: [API_DATETIME_EXAMPLE]
+      })
+    ),
+    created_at: Type.Optional(
+      Type.String({
+        description: `When the row was created. ${EMITTED_DATETIME_NOTE}`,
+        examples: [API_DATETIME_EXAMPLE]
+      })
+    ),
+    mod_time: Type.Optional(
+      Type.String({
+        description: `When the row was last modified. ${EMITTED_DATETIME_NOTE}`,
+        examples: [API_DATETIME_EXAMPLE]
+      })
+    )
+  },
+  { title: "ProcessLog", description: "A process_log row" }
+);
+const listProcessLogQuerySchema = Type.Object(
+  {
+    code: Type.Optional(processLogCodeSchema),
+    type: Type.Optional(processLogTypeSchema),
+    related_model: Type.Optional(Type.String({ description: "Filter by the related entity kind" })),
+    related_id: Type.Optional(Type.String({ description: "Filter by the id of the related entity" })),
+    parent_id: Type.Optional(Type.Number({ description: "Filter by the id of the parent process_log row" })),
+    requires_attention: Type.Optional(Type.Boolean({ description: "Filter by whether the row needs review" })),
+    reviewed: Type.Optional(Type.Boolean({ description: "Filter by whether the row has been reviewed" })),
+    // `apiDateTime`, not a bare string: it carries `format: 'date-time'`, so a malformed value is
+    // rejected by the validator as a 400. A plain `Type.String` accepts anything and hands it to
+    // `getMySQLDateTime(value, true)`, which throws a `PublicApiError` with no `statusCode` — a 500
+    // for what is a bad request. Same type `alert.schema.ts` uses for its datetime fields.
+    created_from: Type.Optional(
+      Type.Union([apiDateTime], {
+        description: `Only rows created at or after this instant. ${API_DATETIME_ACCEPTED_NOTE}. ${EMITTED_DATETIME_NOTE}`,
+        examples: [API_DATETIME_EXAMPLE]
+      })
+    ),
+    created_to: Type.Optional(
+      Type.Union([apiDateTime], {
+        description: `Only rows created at or before this instant. ${API_DATETIME_ACCEPTED_NOTE}. ${EMITTED_DATETIME_NOTE}`,
+        examples: [API_DATETIME_EXAMPLE]
+      })
+    )
+  },
+  { title: "ListProcessLogQuery", description: "Filters available on the process_log list" }
+);
+export {
+  ProcessLogCode,
+  ProcessLogType,
+  listProcessLogQuerySchema,
+  processLogCodeSchema,
+  processLogSchema,
+  processLogTriggerEngineExtraDataSchema,
+  processLogTypeSchema,
+  triggerActionExtraDataSchema,
+  triggerErrorExtraDataSchema,
+  triggerEvaluationExtraDataSchema
+};
+//# sourceMappingURL=ecosystem-process-log.mjs.map