@persei/perseed-api 5.0.18 → 5.0.20

package/dist/ecosystem-container-widget.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ecosystem-container-widget.cjs","sources":["../../src/v2/modules/ecosystem/container-widget/container-widget.helper.ts"],"sourcesContent":["import { getPeriodStart, subtractPeriods, toCalendar } from '../../global/dates/dates.helper'\nimport { getWeekStart } from '../../global/locale/locale.helper'\nimport { type RelativePeriodConfig, type TrendWindow, type TrendWindowConfig } from './container-widget.schema'\n\n/**\n * Trend-widget time windows: the `value`/`from`/`to` → concrete-window resolution shared by the trend\n * widget (front, viewer-local) and the health-data time-range filter (backend, UTC). Built on the\n * generic calendar primitives of `global/dates` (which take the week start as a plain number) and the\n * locale week-start resolver of `global/locale`, so the trend-specific rules live here in one place.\n *\n * The `utc` flag is forwarded to the primitives: `false` (default) uses the ambient local calendar\n * (the front, viewer's timezone); `true` uses UTC (the backend). Both callers produce the exact same\n * window for the same inputs and timezone.\n */\n\n/**\n * Resolves a `from`/`to` range into a concrete, calendar-aligned window. `fromValue` and `toValue`\n * are inclusive bucket offsets (\"N units ago\"), so the window covers the buckets from `toValue`-ago\n * up to `fromValue`-ago and spans `fromValue − toValue + 1` buckets:\n *\n *   - `start` (inclusive) = `getPeriodStart(now − fromValue·unit)` — start of the oldest bucket.\n *   - `end`   (exclusive) = `now` when `toValue = 0` (the current, in-progress bucket is included,\n *     up to now); otherwise `getPeriodStart(now − (toValue − 1)·unit)` — the start of the bucket\n *     just after the newest included one, which drops the current bucket.\n *\n * Example (unit = week, weekStart = 1 Monday, now = Tue 2026-07-07):\n *   from 2, to 0 → [Mon 22 Jun, now)            (3 weeks including the current one)\n *   from 3, to 1 → [Mon 15 Jun, Mon 06 Jul)     (3 complete weeks, current one excluded)\n */\nexport function resolveTrendWindow(\n  nowMs: number,\n  config: TrendWindowConfig,\n  weekStart: number = getWeekStart(),\n  utc = false,\n): TrendWindow {\n  const { fromValue, unit } = config\n  const toValue = config.toValue ?? 0\n  return {\n    start: getPeriodStart(subtractPeriods(nowMs, fromValue, unit, utc), unit, weekStart, utc),\n    end: toValue === 0 ? nowMs : getPeriodStart(subtractPeriods(nowMs, toValue - 1, unit, utc), unit, weekStart, utc),\n  }\n}\n\n/**\n * Resolves a count-based relative period into a concrete window — the single source of truth for the\n * `value` → from/to mapping shared by every consumer (backend health-data filter, front trend widget),\n * so the \"current period counts as one of the N\" rule is defined exactly once:\n *   - including it → `from = value - 1`, `to = 0` (buckets `value-1`…0 ago, ending now);\n *   - excluding it → `from = value`, `to = 1` (`value` complete buckets before the current one).\n */\nexport function resolveRelativePeriod(\n  nowMs: number,\n  { value, unit, excludeCurrentPeriod = false }: RelativePeriodConfig,\n  weekStart: number = getWeekStart(),\n  utc = false,\n): TrendWindow {\n  return resolveTrendWindow(\n    nowMs,\n    { fromValue: excludeCurrentPeriod ? value : value - 1, toValue: excludeCurrentPeriod ? 1 : 0, unit },\n    weekStart,\n    utc,\n  )\n}\n\n/**\n * Resolves a count-based relative period into a formatted date range, keeping the whole calculation\n * (from/to mapping + the day-level rule + formatting) in one shared place:\n *   - `daily`: date-only `YYYY-MM-DD`; when excluding the current period the inclusive end becomes the\n *     last completed calendar day (the day before the current period's start).\n *   - `discrete`: ISO-8601, with the exclusive upper bound used verbatim.\n */\nexport function resolveRelativeDateRange(\n  nowMs: number,\n  config: RelativePeriodConfig,\n  format: 'daily' | 'discrete',\n  weekStart: number = getWeekStart(),\n  utc = false,\n): { start_date: string; end_date: string } {\n  const { start, end } = resolveRelativePeriod(nowMs, config, weekStart, utc)\n  const startDate = toCalendar(start, utc)\n  if (format === 'discrete') {\n    return { start_date: startDate.toISOString(), end_date: toCalendar(end, utc).toISOString() }\n  }\n  const endDate = config.excludeCurrentPeriod ? toCalendar(end, utc).subtract(1, 'day') : toCalendar(end, utc)\n  return { start_date: startDate.format('YYYY-MM-DD'), end_date: endDate.format('YYYY-MM-DD') }\n}\n"],"names":["getWeekStart","getPeriodStart","subtractPeriods","toCalendar"],"mappings":";;;;AA6BO,SAAS,mBACd,OACA,QACA,YAAoBA,aAAAA,aAAA,GACpB,MAAM,OACO;AACb,QAAM,EAAE,WAAW,KAAA,IAAS;AAC5B,QAAM,UAAU,OAAO,WAAW;AAClC,SAAO;AAAA,IACL,OAAOC,YAAAA,eAAeC,4BAAgB,OAAO,WAAW,MAAM,GAAG,GAAG,MAAM,WAAW,GAAG;AAAA,IACxF,KAAK,YAAY,IAAI,QAAQD,YAAAA,eAAeC,YAAAA,gBAAgB,OAAO,UAAU,GAAG,MAAM,GAAG,GAAG,MAAM,WAAW,GAAG;AAAA,EAAA;AAEpH;AASO,SAAS,sBACd,OACA,EAAE,OAAO,MAAM,uBAAuB,MAAA,GACtC,YAAoBF,aAAAA,gBACpB,MAAM,OACO;AACb,SAAO;AAAA,IACL;AAAA,IACA,EAAE,WAAW,uBAAuB,QAAQ,QAAQ,GAAG,SAAS,uBAAuB,IAAI,GAAG,KAAA;AAAA,IAC9F;AAAA,IACA;AAAA,EAAA;AAEJ;AASO,SAAS,yBACd,OACA,QACA,QACA,YAAoBA,0BAAA,GACpB,MAAM,OACoC;AAC1C,QAAM,EAAE,OAAO,QAAQ,sBAAsB,OAAO,QAAQ,WAAW,GAAG;AAC1E,QAAM,YAAYG,YAAAA,WAAW,OAAO,GAAG;AACvC,MAAI,WAAW,YAAY;AACzB,WAAO,EAAE,YAAY,UAAU,eAAe,UAAUA,YAAAA,WAAW,KAAK,GAAG,EAAE,cAAY;AAAA,EAC3F;AACA,QAAM,UAAU,OAAO,uBAAuBA,YAAAA,WAAW,KAAK,GAAG,EAAE,SAAS,GAAG,KAAK,IAAIA,YAAAA,WAAW,KAAK,GAAG;AAC3G,SAAO,EAAE,YAAY,UAAU,OAAO,YAAY,GAAG,UAAU,QAAQ,OAAO,YAAY,EAAA;AAC5F;;;;"}
+{"version":3,"file":"ecosystem-container-widget.cjs","sources":["../../src/v2/modules/ecosystem/container-widget/container-widget.helper.ts"],"sourcesContent":["import { getPeriodStart, subtractPeriods, toCalendar } from '../../global/dates/dates.helper'\nimport { getWeekStart } from '../../global/locale/locale.helper'\nimport { type RelativePeriodConfig, type TrendWindow, type TrendWindowConfig } from './container-widget.schema'\n\n/**\n * Trend-widget time windows: the `value`/`from`/`to` → concrete-window resolution shared by the trend\n * widget (front, viewer-local) and the health-data time-range filter (backend, UTC). Built on the\n * generic calendar primitives of `global/dates` (which take the week start as a plain number) and the\n * locale week-start resolver of `global/locale`, so the trend-specific rules live here in one place.\n *\n * The `utc` flag is forwarded to the primitives: `false` (default) uses the ambient local calendar\n * (the front, viewer's timezone); `true` uses UTC (the backend). Both callers produce the exact same\n * window for the same inputs and timezone.\n */\n\n/**\n * Resolves a `from`/`to` range into a concrete, calendar-aligned window. `fromValue` and `toValue`\n * are inclusive bucket offsets (\"N units ago\"), so the window covers the **complete** buckets from\n * `toValue`-ago up to `fromValue`-ago (both ends inclusive) and spans `fromValue − toValue + 1`\n * buckets:\n *\n *   - `start` (inclusive) = `getPeriodStart(now − fromValue·unit)` — start of the oldest bucket.\n *   - `end`   (exclusive ms bound) = `getPeriodStart(now − (toValue − 1)·unit)` — the start of the\n *     bucket just after the newest included one, i.e. the end of the `toValue` bucket. When\n *     `toValue = 0` this is the start of the next bucket, so the current (in-progress) bucket is\n *     included in full — the window has no `now` cap, both extremes are complete buckets.\n *\n * Example (unit = week, weekStart = 1 Monday, now = Tue 2026-07-07):\n *   from 2, to 0 → [Mon 22 Jun, Mon 13 Jul)     (3 weeks, the current one included in full)\n *   from 3, to 1 → [Mon 15 Jun, Mon 06 Jul)     (3 complete weeks, the current one excluded)\n */\nexport function resolveTrendWindow(\n  nowMs: number,\n  config: TrendWindowConfig,\n  weekStart: number = getWeekStart(),\n  utc = false,\n): TrendWindow {\n  const { fromValue, unit } = config\n  const toValue = config.toValue ?? 0\n  return {\n    start: getPeriodStart(subtractPeriods(nowMs, fromValue, unit, utc), unit, weekStart, utc),\n    end: getPeriodStart(subtractPeriods(nowMs, toValue - 1, unit, utc), unit, weekStart, utc),\n  }\n}\n\n/**\n * Resolves a count-based relative period into a concrete window — the single source of truth for the\n * `value` → from/to mapping shared by every consumer (backend health-data filter, front trend widget),\n * so the \"current period counts as one of the N\" rule is defined exactly once:\n *   - including it → `from = value - 1`, `to = 0` (buckets `value-1`…0 ago, ending now);\n *   - excluding it → `from = value`, `to = 1` (`value` complete buckets before the current one).\n */\nexport function resolveRelativePeriod(\n  nowMs: number,\n  { value, unit, excludeCurrentPeriod = false }: RelativePeriodConfig,\n  weekStart: number = getWeekStart(),\n  utc = false,\n): TrendWindow {\n  return resolveTrendWindow(\n    nowMs,\n    { fromValue: excludeCurrentPeriod ? value : value - 1, toValue: excludeCurrentPeriod ? 1 : 0, unit },\n    weekStart,\n    utc,\n  )\n}\n\n/**\n * Resolves a count-based relative period into a formatted date range for the backend health-data\n * query, keeping the whole calculation (from/to mapping + the day-level rule + formatting) in one\n * shared place:\n *   - `daily`: date-only `YYYY-MM-DD`; when excluding the current period the inclusive end becomes the\n *     last completed calendar day (the day before the current period's start).\n *   - `discrete`: ISO-8601.\n *\n * Unlike `resolveTrendWindow` (which now covers the current bucket in full for the front display), the\n * query end is **capped at `now`**: a data query must never reach past the present into the rest of an\n * in-progress bucket, so `to = 0` yields \"up to now\", not \"up to the end of the current bucket\".\n */\nexport function resolveRelativeDateRange(\n  nowMs: number,\n  config: RelativePeriodConfig,\n  format: 'daily' | 'discrete',\n  weekStart: number = getWeekStart(),\n  utc = false,\n): { start_date: string; end_date: string } {\n  const { start, end } = resolveRelativePeriod(nowMs, config, weekStart, utc)\n  const cappedEnd = Math.min(end, nowMs)\n  const startDate = toCalendar(start, utc)\n  if (format === 'discrete') {\n    return { start_date: startDate.toISOString(), end_date: toCalendar(cappedEnd, utc).toISOString() }\n  }\n  const endDate = config.excludeCurrentPeriod ? toCalendar(end, utc).subtract(1, 'day') : toCalendar(cappedEnd, utc)\n  return { start_date: startDate.format('YYYY-MM-DD'), end_date: endDate.format('YYYY-MM-DD') }\n}\n"],"names":["getWeekStart","getPeriodStart","subtractPeriods","toCalendar"],"mappings":";;;;AA+BO,SAAS,mBACd,OACA,QACA,YAAoBA,aAAAA,aAAA,GACpB,MAAM,OACO;AACb,QAAM,EAAE,WAAW,KAAA,IAAS;AAC5B,QAAM,UAAU,OAAO,WAAW;AAClC,SAAO;AAAA,IACL,OAAOC,YAAAA,eAAeC,4BAAgB,OAAO,WAAW,MAAM,GAAG,GAAG,MAAM,WAAW,GAAG;AAAA,IACxF,KAAKD,YAAAA,eAAeC,4BAAgB,OAAO,UAAU,GAAG,MAAM,GAAG,GAAG,MAAM,WAAW,GAAG;AAAA,EAAA;AAE5F;AASO,SAAS,sBACd,OACA,EAAE,OAAO,MAAM,uBAAuB,MAAA,GACtC,YAAoBF,aAAAA,gBACpB,MAAM,OACO;AACb,SAAO;AAAA,IACL;AAAA,IACA,EAAE,WAAW,uBAAuB,QAAQ,QAAQ,GAAG,SAAS,uBAAuB,IAAI,GAAG,KAAA;AAAA,IAC9F;AAAA,IACA;AAAA,EAAA;AAEJ;AAcO,SAAS,yBACd,OACA,QACA,QACA,YAAoBA,0BAAA,GACpB,MAAM,OACoC;AAC1C,QAAM,EAAE,OAAO,QAAQ,sBAAsB,OAAO,QAAQ,WAAW,GAAG;AAC1E,QAAM,YAAY,KAAK,IAAI,KAAK,KAAK;AACrC,QAAM,YAAYG,YAAAA,WAAW,OAAO,GAAG;AACvC,MAAI,WAAW,YAAY;AACzB,WAAO,EAAE,YAAY,UAAU,eAAe,UAAUA,YAAAA,WAAW,WAAW,GAAG,EAAE,cAAY;AAAA,EACjG;AACA,QAAM,UAAU,OAAO,uBAAuBA,YAAAA,WAAW,KAAK,GAAG,EAAE,SAAS,GAAG,KAAK,IAAIA,YAAAA,WAAW,WAAW,GAAG;AACjH,SAAO,EAAE,YAAY,UAAU,OAAO,YAAY,GAAG,UAAU,QAAQ,OAAO,YAAY,EAAA;AAC5F;;;;"}

package/dist/ecosystem-container-widget.mjs

@@ -5,7 +5,7 @@ function resolveTrendWindow(nowMs, config, weekStart = getWeekStart(), utc = fal
   const toValue = config.toValue ?? 0;
   return {
     start: getPeriodStart(subtractPeriods(nowMs, fromValue, unit, utc), unit, weekStart, utc),
-    end: toValue === 0 ? nowMs : getPeriodStart(subtractPeriods(nowMs, toValue - 1, unit, utc), unit, weekStart, utc)
+    end: getPeriodStart(subtractPeriods(nowMs, toValue - 1, unit, utc), unit, weekStart, utc)
   };
 }
 function resolveRelativePeriod(nowMs, { value, unit, excludeCurrentPeriod = false }, weekStart = getWeekStart(), utc = false) {
@@ -18,11 +18,12 @@ function resolveRelativePeriod(nowMs, { value, unit, excludeCurrentPeriod = fals
 }
 function resolveRelativeDateRange(nowMs, config, format, weekStart = getWeekStart(), utc = false) {
   const { start, end } = resolveRelativePeriod(nowMs, config, weekStart, utc);
+  const cappedEnd = Math.min(end, nowMs);
   const startDate = toCalendar(start, utc);
   if (format === "discrete") {
-    return { start_date: startDate.toISOString(), end_date: toCalendar(end, utc).toISOString() };
+    return { start_date: startDate.toISOString(), end_date: toCalendar(cappedEnd, utc).toISOString() };
   }
-  const endDate = config.excludeCurrentPeriod ? toCalendar(end, utc).subtract(1, "day") : toCalendar(end, utc);
+  const endDate = config.excludeCurrentPeriod ? toCalendar(end, utc).subtract(1, "day") : toCalendar(cappedEnd, utc);
   return { start_date: startDate.format("YYYY-MM-DD"), end_date: endDate.format("YYYY-MM-DD") };
 }
 export {

package/dist/ecosystem-container-widget.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ecosystem-container-widget.mjs","sources":["../../src/v2/modules/ecosystem/container-widget/container-widget.helper.ts"],"sourcesContent":["import { getPeriodStart, subtractPeriods, toCalendar } from '../../global/dates/dates.helper'\nimport { getWeekStart } from '../../global/locale/locale.helper'\nimport { type RelativePeriodConfig, type TrendWindow, type TrendWindowConfig } from './container-widget.schema'\n\n/**\n * Trend-widget time windows: the `value`/`from`/`to` → concrete-window resolution shared by the trend\n * widget (front, viewer-local) and the health-data time-range filter (backend, UTC). Built on the\n * generic calendar primitives of `global/dates` (which take the week start as a plain number) and the\n * locale week-start resolver of `global/locale`, so the trend-specific rules live here in one place.\n *\n * The `utc` flag is forwarded to the primitives: `false` (default) uses the ambient local calendar\n * (the front, viewer's timezone); `true` uses UTC (the backend). Both callers produce the exact same\n * window for the same inputs and timezone.\n */\n\n/**\n * Resolves a `from`/`to` range into a concrete, calendar-aligned window. `fromValue` and `toValue`\n * are inclusive bucket offsets (\"N units ago\"), so the window covers the buckets from `toValue`-ago\n * up to `fromValue`-ago and spans `fromValue − toValue + 1` buckets:\n *\n *   - `start` (inclusive) = `getPeriodStart(now − fromValue·unit)` — start of the oldest bucket.\n *   - `end`   (exclusive) = `now` when `toValue = 0` (the current, in-progress bucket is included,\n *     up to now); otherwise `getPeriodStart(now − (toValue − 1)·unit)` — the start of the bucket\n *     just after the newest included one, which drops the current bucket.\n *\n * Example (unit = week, weekStart = 1 Monday, now = Tue 2026-07-07):\n *   from 2, to 0 → [Mon 22 Jun, now)            (3 weeks including the current one)\n *   from 3, to 1 → [Mon 15 Jun, Mon 06 Jul)     (3 complete weeks, current one excluded)\n */\nexport function resolveTrendWindow(\n  nowMs: number,\n  config: TrendWindowConfig,\n  weekStart: number = getWeekStart(),\n  utc = false,\n): TrendWindow {\n  const { fromValue, unit } = config\n  const toValue = config.toValue ?? 0\n  return {\n    start: getPeriodStart(subtractPeriods(nowMs, fromValue, unit, utc), unit, weekStart, utc),\n    end: toValue === 0 ? nowMs : getPeriodStart(subtractPeriods(nowMs, toValue - 1, unit, utc), unit, weekStart, utc),\n  }\n}\n\n/**\n * Resolves a count-based relative period into a concrete window — the single source of truth for the\n * `value` → from/to mapping shared by every consumer (backend health-data filter, front trend widget),\n * so the \"current period counts as one of the N\" rule is defined exactly once:\n *   - including it → `from = value - 1`, `to = 0` (buckets `value-1`…0 ago, ending now);\n *   - excluding it → `from = value`, `to = 1` (`value` complete buckets before the current one).\n */\nexport function resolveRelativePeriod(\n  nowMs: number,\n  { value, unit, excludeCurrentPeriod = false }: RelativePeriodConfig,\n  weekStart: number = getWeekStart(),\n  utc = false,\n): TrendWindow {\n  return resolveTrendWindow(\n    nowMs,\n    { fromValue: excludeCurrentPeriod ? value : value - 1, toValue: excludeCurrentPeriod ? 1 : 0, unit },\n    weekStart,\n    utc,\n  )\n}\n\n/**\n * Resolves a count-based relative period into a formatted date range, keeping the whole calculation\n * (from/to mapping + the day-level rule + formatting) in one shared place:\n *   - `daily`: date-only `YYYY-MM-DD`; when excluding the current period the inclusive end becomes the\n *     last completed calendar day (the day before the current period's start).\n *   - `discrete`: ISO-8601, with the exclusive upper bound used verbatim.\n */\nexport function resolveRelativeDateRange(\n  nowMs: number,\n  config: RelativePeriodConfig,\n  format: 'daily' | 'discrete',\n  weekStart: number = getWeekStart(),\n  utc = false,\n): { start_date: string; end_date: string } {\n  const { start, end } = resolveRelativePeriod(nowMs, config, weekStart, utc)\n  const startDate = toCalendar(start, utc)\n  if (format === 'discrete') {\n    return { start_date: startDate.toISOString(), end_date: toCalendar(end, utc).toISOString() }\n  }\n  const endDate = config.excludeCurrentPeriod ? toCalendar(end, utc).subtract(1, 'day') : toCalendar(end, utc)\n  return { start_date: startDate.format('YYYY-MM-DD'), end_date: endDate.format('YYYY-MM-DD') }\n}\n"],"names":[],"mappings":";;AA6BO,SAAS,mBACd,OACA,QACA,YAAoB,aAAA,GACpB,MAAM,OACO;AACb,QAAM,EAAE,WAAW,KAAA,IAAS;AAC5B,QAAM,UAAU,OAAO,WAAW;AAClC,SAAO;AAAA,IACL,OAAO,eAAe,gBAAgB,OAAO,WAAW,MAAM,GAAG,GAAG,MAAM,WAAW,GAAG;AAAA,IACxF,KAAK,YAAY,IAAI,QAAQ,eAAe,gBAAgB,OAAO,UAAU,GAAG,MAAM,GAAG,GAAG,MAAM,WAAW,GAAG;AAAA,EAAA;AAEpH;AASO,SAAS,sBACd,OACA,EAAE,OAAO,MAAM,uBAAuB,MAAA,GACtC,YAAoB,gBACpB,MAAM,OACO;AACb,SAAO;AAAA,IACL;AAAA,IACA,EAAE,WAAW,uBAAuB,QAAQ,QAAQ,GAAG,SAAS,uBAAuB,IAAI,GAAG,KAAA;AAAA,IAC9F;AAAA,IACA;AAAA,EAAA;AAEJ;AASO,SAAS,yBACd,OACA,QACA,QACA,YAAoB,aAAA,GACpB,MAAM,OACoC;AAC1C,QAAM,EAAE,OAAO,QAAQ,sBAAsB,OAAO,QAAQ,WAAW,GAAG;AAC1E,QAAM,YAAY,WAAW,OAAO,GAAG;AACvC,MAAI,WAAW,YAAY;AACzB,WAAO,EAAE,YAAY,UAAU,eAAe,UAAU,WAAW,KAAK,GAAG,EAAE,cAAY;AAAA,EAC3F;AACA,QAAM,UAAU,OAAO,uBAAuB,WAAW,KAAK,GAAG,EAAE,SAAS,GAAG,KAAK,IAAI,WAAW,KAAK,GAAG;AAC3G,SAAO,EAAE,YAAY,UAAU,OAAO,YAAY,GAAG,UAAU,QAAQ,OAAO,YAAY,EAAA;AAC5F;"}
+{"version":3,"file":"ecosystem-container-widget.mjs","sources":["../../src/v2/modules/ecosystem/container-widget/container-widget.helper.ts"],"sourcesContent":["import { getPeriodStart, subtractPeriods, toCalendar } from '../../global/dates/dates.helper'\nimport { getWeekStart } from '../../global/locale/locale.helper'\nimport { type RelativePeriodConfig, type TrendWindow, type TrendWindowConfig } from './container-widget.schema'\n\n/**\n * Trend-widget time windows: the `value`/`from`/`to` → concrete-window resolution shared by the trend\n * widget (front, viewer-local) and the health-data time-range filter (backend, UTC). Built on the\n * generic calendar primitives of `global/dates` (which take the week start as a plain number) and the\n * locale week-start resolver of `global/locale`, so the trend-specific rules live here in one place.\n *\n * The `utc` flag is forwarded to the primitives: `false` (default) uses the ambient local calendar\n * (the front, viewer's timezone); `true` uses UTC (the backend). Both callers produce the exact same\n * window for the same inputs and timezone.\n */\n\n/**\n * Resolves a `from`/`to` range into a concrete, calendar-aligned window. `fromValue` and `toValue`\n * are inclusive bucket offsets (\"N units ago\"), so the window covers the **complete** buckets from\n * `toValue`-ago up to `fromValue`-ago (both ends inclusive) and spans `fromValue − toValue + 1`\n * buckets:\n *\n *   - `start` (inclusive) = `getPeriodStart(now − fromValue·unit)` — start of the oldest bucket.\n *   - `end`   (exclusive ms bound) = `getPeriodStart(now − (toValue − 1)·unit)` — the start of the\n *     bucket just after the newest included one, i.e. the end of the `toValue` bucket. When\n *     `toValue = 0` this is the start of the next bucket, so the current (in-progress) bucket is\n *     included in full — the window has no `now` cap, both extremes are complete buckets.\n *\n * Example (unit = week, weekStart = 1 Monday, now = Tue 2026-07-07):\n *   from 2, to 0 → [Mon 22 Jun, Mon 13 Jul)     (3 weeks, the current one included in full)\n *   from 3, to 1 → [Mon 15 Jun, Mon 06 Jul)     (3 complete weeks, the current one excluded)\n */\nexport function resolveTrendWindow(\n  nowMs: number,\n  config: TrendWindowConfig,\n  weekStart: number = getWeekStart(),\n  utc = false,\n): TrendWindow {\n  const { fromValue, unit } = config\n  const toValue = config.toValue ?? 0\n  return {\n    start: getPeriodStart(subtractPeriods(nowMs, fromValue, unit, utc), unit, weekStart, utc),\n    end: getPeriodStart(subtractPeriods(nowMs, toValue - 1, unit, utc), unit, weekStart, utc),\n  }\n}\n\n/**\n * Resolves a count-based relative period into a concrete window — the single source of truth for the\n * `value` → from/to mapping shared by every consumer (backend health-data filter, front trend widget),\n * so the \"current period counts as one of the N\" rule is defined exactly once:\n *   - including it → `from = value - 1`, `to = 0` (buckets `value-1`…0 ago, ending now);\n *   - excluding it → `from = value`, `to = 1` (`value` complete buckets before the current one).\n */\nexport function resolveRelativePeriod(\n  nowMs: number,\n  { value, unit, excludeCurrentPeriod = false }: RelativePeriodConfig,\n  weekStart: number = getWeekStart(),\n  utc = false,\n): TrendWindow {\n  return resolveTrendWindow(\n    nowMs,\n    { fromValue: excludeCurrentPeriod ? value : value - 1, toValue: excludeCurrentPeriod ? 1 : 0, unit },\n    weekStart,\n    utc,\n  )\n}\n\n/**\n * Resolves a count-based relative period into a formatted date range for the backend health-data\n * query, keeping the whole calculation (from/to mapping + the day-level rule + formatting) in one\n * shared place:\n *   - `daily`: date-only `YYYY-MM-DD`; when excluding the current period the inclusive end becomes the\n *     last completed calendar day (the day before the current period's start).\n *   - `discrete`: ISO-8601.\n *\n * Unlike `resolveTrendWindow` (which now covers the current bucket in full for the front display), the\n * query end is **capped at `now`**: a data query must never reach past the present into the rest of an\n * in-progress bucket, so `to = 0` yields \"up to now\", not \"up to the end of the current bucket\".\n */\nexport function resolveRelativeDateRange(\n  nowMs: number,\n  config: RelativePeriodConfig,\n  format: 'daily' | 'discrete',\n  weekStart: number = getWeekStart(),\n  utc = false,\n): { start_date: string; end_date: string } {\n  const { start, end } = resolveRelativePeriod(nowMs, config, weekStart, utc)\n  const cappedEnd = Math.min(end, nowMs)\n  const startDate = toCalendar(start, utc)\n  if (format === 'discrete') {\n    return { start_date: startDate.toISOString(), end_date: toCalendar(cappedEnd, utc).toISOString() }\n  }\n  const endDate = config.excludeCurrentPeriod ? toCalendar(end, utc).subtract(1, 'day') : toCalendar(cappedEnd, utc)\n  return { start_date: startDate.format('YYYY-MM-DD'), end_date: endDate.format('YYYY-MM-DD') }\n}\n"],"names":[],"mappings":";;AA+BO,SAAS,mBACd,OACA,QACA,YAAoB,aAAA,GACpB,MAAM,OACO;AACb,QAAM,EAAE,WAAW,KAAA,IAAS;AAC5B,QAAM,UAAU,OAAO,WAAW;AAClC,SAAO;AAAA,IACL,OAAO,eAAe,gBAAgB,OAAO,WAAW,MAAM,GAAG,GAAG,MAAM,WAAW,GAAG;AAAA,IACxF,KAAK,eAAe,gBAAgB,OAAO,UAAU,GAAG,MAAM,GAAG,GAAG,MAAM,WAAW,GAAG;AAAA,EAAA;AAE5F;AASO,SAAS,sBACd,OACA,EAAE,OAAO,MAAM,uBAAuB,MAAA,GACtC,YAAoB,gBACpB,MAAM,OACO;AACb,SAAO;AAAA,IACL;AAAA,IACA,EAAE,WAAW,uBAAuB,QAAQ,QAAQ,GAAG,SAAS,uBAAuB,IAAI,GAAG,KAAA;AAAA,IAC9F;AAAA,IACA;AAAA,EAAA;AAEJ;AAcO,SAAS,yBACd,OACA,QACA,QACA,YAAoB,aAAA,GACpB,MAAM,OACoC;AAC1C,QAAM,EAAE,OAAO,QAAQ,sBAAsB,OAAO,QAAQ,WAAW,GAAG;AAC1E,QAAM,YAAY,KAAK,IAAI,KAAK,KAAK;AACrC,QAAM,YAAY,WAAW,OAAO,GAAG;AACvC,MAAI,WAAW,YAAY;AACzB,WAAO,EAAE,YAAY,UAAU,eAAe,UAAU,WAAW,WAAW,GAAG,EAAE,cAAY;AAAA,EACjG;AACA,QAAM,UAAU,OAAO,uBAAuB,WAAW,KAAK,GAAG,EAAE,SAAS,GAAG,KAAK,IAAI,WAAW,WAAW,GAAG;AACjH,SAAO,EAAE,YAAY,UAAU,OAAO,YAAY,GAAG,UAAU,QAAQ,OAAO,YAAY,EAAA;AAC5F;"}

package/dist/lib/src/client/customFetch.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Orval mutator for the generated fetch client (`src/generated/client.ts`).
+ *
+ * Centralizes base URL composition, `Authorization` header injection, and
+ * response decoding/error handling for every generated operation, so
+ * consumers (the `front` repo) can call the generated functions directly
+ * without a bespoke glue layer (see `front/packages/perseed-api-client/src/generatedClient.ts`,
+ * which this replaces — api's owner requested moving this logic here in MR !109).
+ */
+/**
+ * Thrown by {@link customFetch} when the response status is not in the 2xx range. Carries the
+ * HTTP `status` and the parsed error body (when present) so consumers can branch on the failure
+ * without having to re-parse anything (e.g. the front's `isEndpointUnavailable`).
+ */
+export declare class GeneratedClientError extends Error {
+    status: number;
+    body?: unknown;
+    constructor(status: number, body?: unknown);
+}
+export interface ClientRuntimeConfig {
+    /** Absolute base URL of the API, e.g. `https://api.perseed.eu`. */
+    baseUrl: string;
+    /**
+     * Returns the session token to use for the *current* call, or `undefined` if unauthenticated.
+     * A function (not a static token) so the runtime always reads the token in effect at call
+     * time — avoiding a stale-token capture without depending on React or any specific state
+     * management.
+     */
+    getToken?: () => string | undefined;
+}
+/** Configures the base URL and token accessor used by every generated operation. */
+export declare function configureGeneratedClient(cfg: ClientRuntimeConfig): void;
+/**
+ * Mutator invoked by every generated operation in `src/generated/client.ts`. Composes the
+ * absolute URL from the configured base URL, injects `Authorization: Bearer <token>` when a
+ * token is available, performs the request, and decodes the response the same way the previous
+ * front-side `fetchGenerated` did (null body for 204/205/304, JSON otherwise). A non-2xx response
+ * throws a {@link GeneratedClientError} instead of resolving, so callers get a rejected promise
+ * for every failed request.
+ *
+ * `T` here is orval's own per-operation response union (e.g. `listActionsResponse`, shaped as
+ * `{ data, status, headers }` discriminated by `status`), not the bare payload type — orval calls
+ * this mutator as `customFetch<listActionsResponse>(url, init)` and uses its return value
+ * directly as the operation's return value. Confirmed empirically by regenerating the client and
+ * inspecting `src/generated/client.ts`. The cast below is unavoidable: at runtime we only know the
+ * status/data/headers triple, not which member of the union it narrows to — that narrowing is the
+ * server's contract with the generated types, not something this generic transport layer can (or
+ * should) re-verify.
+ */
+export declare function customFetch<T>(url: string, options: RequestInit): Promise<T>;
+//# sourceMappingURL=customFetch.d.ts.map

package/dist/lib/src/client/customFetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customFetch.d.ts","sourceRoot":"","sources":["../../../../src/client/customFetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;gBAEF,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAe3C;AAED,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAA;IACf;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAA;CACpC;AAID,oFAAoF;AACpF,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI,CAEvE;AAWD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAmBlF"}

package/dist/lib/src/client/customFetch.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=customFetch.test.d.ts.map

package/dist/lib/src/client/customFetch.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customFetch.test.d.ts","sourceRoot":"","sources":["../../../../src/client/customFetch.test.ts"],"names":[],"mappings":""}

package/dist/lib/src/client/index.d.ts

@@ -1,2 +1,3 @@
 export * from '../generated/client';
+export * from './customFetch';
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/src/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA"}