@torrow/sdk-client 0.23.0 → 0.24.0

package/dist/index.js

@@ -12322,7 +12322,11 @@ var CalendarsFacade = class extends TorrowItemFacade {
       signal
     }).then((items) => projectReadList(items, (dto) => projectCalendarItem(dto)));
   }
-  /** Расписание кейсов календаря — `PUT /api/v1/calendars/{id}/timetable`. */
+  /**
+   * Исходное расписание кейсов календаря — `PUT /api/v1/calendars/{id}/timetable`.
+   * После чтения нужных серверных страниц повторы явно разворачивает `expandRecurringTimetableCases`;
+   * права на исходные строки проверяет сервер.
+   */
   getTimetable(calendarId, body, options) {
     const { signal, ...queryOpts } = options ?? {};
     return this.http.requestJson({
@@ -12533,6 +12537,24 @@ function normalizeCaseActionRidsForWrite(body, path) {
 }
 
 // ../../src/resources/cases/types.ts
+var AvailabilityTimeValues = /* @__PURE__ */ ((AvailabilityTimeValues2) => {
+  AvailabilityTimeValues2["Unknown"] = "UnknownSystemAvailabilityTime";
+  AvailabilityTimeValues2["Free"] = "Free";
+  AvailabilityTimeValues2["Busy"] = "Busy";
+  return AvailabilityTimeValues2;
+})(AvailabilityTimeValues || {});
+var CaseParticipantTypeValues = /* @__PURE__ */ ((CaseParticipantTypeValues2) => {
+  CaseParticipantTypeValues2["Unknown"] = "UnknownCaseParticipantType";
+  CaseParticipantTypeValues2["Consumer"] = "Consumer";
+  CaseParticipantTypeValues2["Executor"] = "Executor";
+  CaseParticipantTypeValues2["Escort"] = "Escort";
+  return CaseParticipantTypeValues2;
+})(CaseParticipantTypeValues || {});
+var ShowCaseInTimetableTypeValues = /* @__PURE__ */ ((ShowCaseInTimetableTypeValues2) => {
+  ShowCaseInTimetableTypeValues2["All"] = "All";
+  ShowCaseInTimetableTypeValues2["ExcludeUser"] = "ExcludeUser";
+  return ShowCaseInTimetableTypeValues2;
+})(ShowCaseInTimetableTypeValues || {});
 var CaseStateValues = {
   Unknown: "UnknownCaseState",
   Verifying: "Verifying",
@@ -13492,7 +13514,11 @@ var ContactsFacade = class extends TorrowItemFacade {
       signal
     }).then((items) => projectReadList(items, (dto) => projectContactItem(dto)));
   }
-  /** Расписание по контакту (профиль/исполнитель) — `PUT /api/v1/contacts/{id}/timetable`. */
+  /**
+   * Исходное расписание по контакту (профиль/исполнитель) — `PUT /api/v1/contacts/{id}/timetable`.
+   * После чтения нужных серверных страниц повторы явно разворачивает `expandRecurringTimetableCases`;
+   * права на исходные строки проверяет сервер.
+   */
   getTimetable(contactId, body, options) {
     const { signal, ...queryOpts } = options ?? {};
     return this.http.requestJson({
@@ -15095,6 +15121,8 @@ var ResourcesFacade = class extends TorrowItemFacade {
   }
   /**
    * Расписание заказов, привязанных к **ресурсу** — `PUT /api/v1/resources/{id}/timetable`.
+   * Возвращает исходные строки сервера. Повторы разворачивает отдельный
+   * `expandRecurringTimetableCases` после загрузки нужных страниц; права проверяет сервер.
    */
   getTimetable(resourceId, body, options) {
     const { signal, ...queryOpts } = options ?? {};
@@ -15801,6 +15829,8 @@ var ServicesFacade = class extends TorrowItemFacade {
   /**
    * События/заказы и занятость услуги — `PUT /api/v1/services/{serviceId}/timetable`.
    * Не вычисляет свободные слоты записи: для них используй `getCheckInSchedule` с `type: "FreeTimeSlots"`.
+   * Возвращает исходные `TimetableCase[]`; серверный `take/skip` не считает виртуальные появления.
+   * После чтения нужных страниц вызови `expandRecurringTimetableCases` явно; доступ проверяет сервер.
    */
   getTimetable(serviceId, body, options) {
     const { signal, ...queryOpts } = options ?? {};
@@ -17397,6 +17427,8 @@ var LoyaltyCardsFacade = class extends TorrowItemCoreFacade {
   /**
    * Расписание по карте — `PUT /api/v1/loyaltycards/{torrowId}/timetable`.
    * В torrow-apps: `LoyaltyCardClient.getTimetable`.
+   * Возвращает исходные строки сервера; после чтения нужных страниц повторы явно
+   * разворачивает `expandRecurringTimetableCases`. Права на исходные строки проверяет сервер.
    */
   getTimetable(torrowId, body, options) {
     const { signal, ...queryOpts } = options ?? {};
@@ -17474,6 +17506,38 @@ var UserSettingsFacade = class {
     });
     return { settings: parseOpaqueJsonSettings(dto.settings) };
   }
+  /**
+   * Читает проверенную IANA-зону текущего пользователя из `settings.place.timeZone`.
+   * Отсутствующая, повреждённая или не поддержанная средой зона даёт `null`.
+   * Ошибки GET и отмена запроса сохраняются; зона процесса не используется.
+   */
+  async getTimeZone(options) {
+    const { settings } = await this.get(options);
+    if (settings === null || settings === void 0 || typeof settings !== "object" || Array.isArray(settings)) {
+      return null;
+    }
+    const place = settings.place;
+    if (place === null || typeof place !== "object" || Array.isArray(place)) {
+      return null;
+    }
+    const rawTimeZone = place.timeZone;
+    if (typeof rawTimeZone !== "string") {
+      return null;
+    }
+    const timeZone = rawTimeZone.trim();
+    if (timeZone === "" || /^[+-]/.test(timeZone)) {
+      return null;
+    }
+    try {
+      new Intl.DateTimeFormat("en-US", { timeZone });
+      return timeZone;
+    } catch (error) {
+      if (error instanceof RangeError) {
+        return null;
+      }
+      throw error;
+    }
+  }
   /**
    * `PUT /api/v1/user/settings/update` — принимает JSON в `settings`, на wire уходит string.
    * `null`/`undefined` → `settings: null` в теле.
@@ -17712,7 +17776,11 @@ var UserFacade = class {
       signal: options?.signal
     });
   }
-  /** `PUT /api/v1/user/timetable` */
+  /**
+   * Исходные события текущего пользователя — `PUT /api/v1/user/timetable`.
+   * `take/skip` делят серверные строки; повторы явно разворачивает `expandRecurringTimetableCases`
+   * после чтения нужных страниц. Права на строки определяет сервер.
+   */
   getTimetable(body, query, options) {
     return this.http.requestJson({
       method: "PUT",
@@ -18544,6 +18612,558 @@ var TimetableViewTypeValues = {
   Schedule: 5
 };
 
+// ../../src/resources/common/timetable-cron.ts
+import Cron from "cron-converter";
+var TimetableCronError = class extends Error {
+  /** Машинно читаемая причина локального отказа. */
+  failure;
+  constructor(failure) {
+    super(`Timetable cron: ${failure}`);
+    this.name = "TimetableCronError";
+    this.failure = failure;
+  }
+};
+var MONTH_NAME = /\b(?:JAN|FEB|MAR|APR|MAY|JUN|JUL|AUG|SEP|OCT|NOV|DEC)\b/gi;
+var WEEKDAY_NAME = /\b(?:SUN|MON|TUE|WED|THU|FRI|SAT)\b/gi;
+var NUMERIC_FIELD = new RegExp("^[-0-9*,/]+$");
+function createTimetableCronSeeker(expression, earliestStartMs) {
+  const fields = expression.trim().split(/\s+/);
+  if (fields.length !== 5) {
+    throw new TimetableCronError("UnsupportedSyntax" /* UnsupportedSyntax */);
+  }
+  const normalized = fields.map((field, index) => {
+    if (index === 3) {
+      return field.replace(MONTH_NAME, "1");
+    }
+    if (index === 4) {
+      return field.replace(WEEKDAY_NAME, "1");
+    }
+    return field;
+  });
+  if (normalized.some((field) => !NUMERIC_FIELD.test(field))) {
+    throw new TimetableCronError("UnsupportedSyntax" /* UnsupportedSyntax */);
+  }
+  if (!Number.isFinite(earliestStartMs)) {
+    throw new TimetableCronError("InvalidSchedule" /* InvalidSchedule */);
+  }
+  const floorMs = Math.floor(earliestStartMs / 6e4) * 6e4;
+  const floorDate = new Date(floorMs);
+  if (!Number.isFinite(floorDate.getTime())) {
+    throw new TimetableCronError("InvalidSchedule" /* InvalidSchedule */);
+  }
+  let seeker;
+  try {
+    seeker = new Cron().fromString(expression).schedule(floorDate);
+  } catch {
+    throw new TimetableCronError("InvalidSchedule" /* InvalidSchedule */);
+  }
+  let previousMs = floorMs - 6e4;
+  return {
+    next() {
+      let date2;
+      try {
+        date2 = seeker.next().toJSDate();
+      } catch {
+        throw new TimetableCronError("InvalidSchedule" /* InvalidSchedule */);
+      }
+      if (!(date2 instanceof Date) || !Number.isFinite(date2.getTime()) || date2.getTime() <= previousMs) {
+        throw new TimetableCronError("InvalidSchedule" /* InvalidSchedule */);
+      }
+      previousMs = date2.getTime();
+      return date2;
+    }
+  };
+}
+
+// ../../src/resources/common/timetable-weekly.ts
+var DAY_MS = 864e5;
+function civilOrdinal(year, month, day) {
+  const date2 = /* @__PURE__ */ new Date(0);
+  date2.setUTCFullYear(year, month - 1, day);
+  date2.setUTCHours(0, 0, 0, 0);
+  return date2.getTime();
+}
+function zonedCivilOrdinal(formatter, instant) {
+  const parts = formatter.formatToParts(instant);
+  const year = Number(parts.find((part) => part.type === "year")?.value);
+  const month = Number(parts.find((part) => part.type === "month")?.value);
+  const day = Number(parts.find((part) => part.type === "day")?.value);
+  if (!Number.isSafeInteger(year) || !Number.isSafeInteger(month) || !Number.isSafeInteger(day)) {
+    throw new Error("Invalid calendar date");
+  }
+  return civilOrdinal(year, month, day);
+}
+function isoWeekNumber(ordinal) {
+  const dayOfWeek = (new Date(ordinal).getUTCDay() + 6) % 7;
+  const thursday = ordinal + (3 - dayOfWeek) * DAY_MS;
+  const weekYear = new Date(thursday).getUTCFullYear();
+  const januaryFourth = civilOrdinal(weekYear, 1, 4);
+  const firstWeekMonday = januaryFourth - (new Date(januaryFourth).getUTCDay() + 6) % 7 * DAY_MS;
+  return Math.floor((ordinal - firstWeekMonday) / (7 * DAY_MS)) + 1;
+}
+function safeInteger(value) {
+  const parsed = Number(value);
+  return Number.isSafeInteger(parsed) && parsed >= 0 ? parsed : null;
+}
+function parseWeeklyPredicate(expression) {
+  if (expression === "*") {
+    return () => true;
+  }
+  const wildcardStep = /^\*\/(\d+)$/.exec(expression);
+  if (wildcardStep) {
+    const step = safeInteger(wildcardStep[1]);
+    return step ? (week) => week % step === 0 : null;
+  }
+  const predicates = [];
+  for (const part of expression.split(",")) {
+    const single = /^(\d+)$/.exec(part);
+    if (single) {
+      const number = safeInteger(single[1]);
+      if (number === null) {
+        return null;
+      }
+      predicates.push((week) => week === number);
+      continue;
+    }
+    const range = /^(\d+)-(\d+)(?:\/(\d+))?$/.exec(part);
+    if (range) {
+      const first = safeInteger(range[1]);
+      const last = safeInteger(range[2]);
+      const step = range[3] === void 0 ? null : safeInteger(range[3]);
+      if (first === null || last === null || first > last || range[3] !== void 0 && (!step || step <= 0)) {
+        return null;
+      }
+      predicates.push((week) => week >= first && week <= last && (step === null || week % step === 0));
+      continue;
+    }
+    const fromStep = /^(\d+)\/(\d+)$/.exec(part);
+    if (fromStep) {
+      const first = safeInteger(fromStep[1]);
+      const step = safeInteger(fromStep[2]);
+      if (first === null || !step) {
+        return null;
+      }
+      predicates.push((week) => week >= first && (week - first) % step === 0);
+      continue;
+    }
+    return null;
+  }
+  return (week) => predicates.some((predicate) => predicate(week));
+}
+function createTimetableWeeklyChecker(weeklyCron, firstWeekDate, timeZone) {
+  const predicate = parseWeeklyPredicate(weeklyCron);
+  if (predicate === null || firstWeekDate != null && (!(firstWeekDate instanceof Date) || !Number.isFinite(firstWeekDate.getTime()))) {
+    return null;
+  }
+  const formatter = new Intl.DateTimeFormat("en-US-u-ca-gregory-nu-latn", {
+    timeZone,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit"
+  });
+  const anchorOrdinal = firstWeekDate == null ? null : zonedCivilOrdinal(formatter, firstWeekDate);
+  return (candidateMs) => {
+    const ordinal = zonedCivilOrdinal(formatter, new Date(candidateMs));
+    if (anchorOrdinal !== null) {
+      const daysBetween = Math.abs((ordinal - anchorOrdinal) / DAY_MS);
+      const anchorDay = new Date(anchorOrdinal).getUTCDay();
+      const candidateDay = new Date(ordinal).getUTCDay();
+      const week = Math.floor((daysBetween + anchorDay - candidateDay) / 7) + 1;
+      return predicate(week);
+    }
+    return predicate(isoWeekNumber(ordinal));
+  };
+}
+
+// ../../src/resources/common/timetable-recurring.ts
+var TimetableExpansionKind = /* @__PURE__ */ ((TimetableExpansionKind2) => {
+  TimetableExpansionKind2["StoredCase"] = "stored_case";
+  TimetableExpansionKind2["VirtualOccurrence"] = "virtual_occurrence";
+  TimetableExpansionKind2["UnexpandedSeries"] = "unexpanded_series";
+  return TimetableExpansionKind2;
+})(TimetableExpansionKind || {});
+var TimetableUnexpandedReason = /* @__PURE__ */ ((TimetableUnexpandedReason2) => {
+  TimetableUnexpandedReason2["MissingScheduleRanges"] = "MissingScheduleRanges";
+  TimetableUnexpandedReason2["MissingSeriesId"] = "MissingSeriesId";
+  TimetableUnexpandedReason2["MissingWeeklyTimeZone"] = "MissingWeeklyTimeZone";
+  TimetableUnexpandedReason2["InvalidSeriesDates"] = "InvalidSeriesDates";
+  TimetableUnexpandedReason2["InvalidSchedule"] = "InvalidSchedule";
+  TimetableUnexpandedReason2["UnsupportedCronSyntax"] = "UnsupportedCronSyntax";
+  TimetableUnexpandedReason2["UnsupportedRecurrenceRule"] = "UnsupportedRecurrenceRule";
+  return TimetableUnexpandedReason2;
+})(TimetableUnexpandedReason || {});
+var DEFAULT_MAX_CANDIDATES = 1e4;
+var DEFAULT_MAX_ITERATIONS = 1e5;
+var DEFAULT_MAX_RESULTS = 1e4;
+function sdkError(category) {
+  return new TorrowSdkError({ category, operation: "expandRecurringTimetableCases" });
+}
+function validDate(value) {
+  return value instanceof Date && Number.isFinite(value.getTime());
+}
+function validZone(value) {
+  if (/^[+-]\d{1,2}(?::?\d{2})?$/.test(value)) {
+    return false;
+  }
+  try {
+    new Intl.DateTimeFormat("en", { timeZone: value });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function budget(value, fallback) {
+  if (value === void 0) {
+    return fallback;
+  }
+  if (!Number.isSafeInteger(value) || value <= 0) {
+    throw sdkError("InvalidInput" /* InvalidInput */);
+  }
+  return value;
+}
+function dateKey(source, identity, beginning, ending) {
+  return JSON.stringify([
+    source.timetableId ?? null,
+    identity,
+    beginning?.getTime() ?? null,
+    ending?.getTime() ?? null
+  ]);
+}
+function overlaps(beginning, ending, from, to, strict) {
+  return strict ? beginning >= from && ending <= to : beginning < to && ending > from;
+}
+function expandRecurringTimetableCases(cases, options) {
+  if (!Array.isArray(cases) || !options || !validDate(options.from) || !validDate(options.to)) {
+    throw sdkError("InvalidInput" /* InvalidInput */);
+  }
+  const from = options.from.getTime();
+  const to = options.to.getTime();
+  if (from >= to || options.userTimeZone != null && (typeof options.userTimeZone !== "string" || !validZone(options.userTimeZone))) {
+    throw sdkError("InvalidInput" /* InvalidInput */);
+  }
+  if (options.resolveRecurrenceContext !== void 0 && typeof options.resolveRecurrenceContext !== "function") {
+    throw sdkError("InvalidInput" /* InvalidInput */);
+  }
+  if (options.strictlyInTimeRange !== void 0 && typeof options.strictlyInTimeRange !== "boolean") {
+    throw sdkError("InvalidInput" /* InvalidInput */);
+  }
+  const maxCandidates = budget(options.maxCandidates, DEFAULT_MAX_CANDIDATES);
+  const maxIterations = budget(options.maxIterations, DEFAULT_MAX_ITERATIONS);
+  const maxResults = budget(options.maxResults, DEFAULT_MAX_RESULTS);
+  const entries = [];
+  let candidateCount = 0;
+  let iterationCount = 0;
+  function append(entry) {
+    entries.push(entry);
+  }
+  function unexpanded(source, index, reason) {
+    const identity = source.itemObject?.id || `row:${index}`;
+    append({
+      kind: "unexpanded_series" /* UnexpandedSeries */,
+      source,
+      reason,
+      key: `${dateKey(source, identity, validDate(source.beginDate) ? source.beginDate : null, validDate(source.endDate) ? source.endDate : null)}:${reason}`
+    });
+  }
+  for (const [index, source] of cases.entries()) {
+    let resolveWeeklyZone2 = function() {
+      if (!recurrenceContextResolved) {
+        let context;
+        try {
+          context = options.resolveRecurrenceContext?.(source);
+        } catch {
+          throw sdkError("InvalidInput" /* InvalidInput */);
+        }
+        if (context != null && (typeof context !== "object" || Array.isArray(context))) {
+          throw sdkError("InvalidInput" /* InvalidInput */);
+        }
+        if (context != null && "then" in context && typeof context.then === "function") {
+          throw sdkError("InvalidInput" /* InvalidInput */);
+        }
+        const explicitZone = context?.weeklyTimeZone;
+        if (explicitZone != null && (typeof explicitZone !== "string" || !validZone(explicitZone))) {
+          throw sdkError("InvalidInput" /* InvalidInput */);
+        }
+        seriesWeeklyZone = explicitZone ?? options.userTimeZone ?? null;
+        recurrenceContextResolved = true;
+      }
+      return seriesWeeklyZone;
+    };
+    var resolveWeeklyZone = resolveWeeklyZone2;
+    if (!source || typeof source !== "object") {
+      throw sdkError("InvalidInput" /* InvalidInput */);
+    }
+    const beginDate = validDate(source.beginDate) ? source.beginDate : null;
+    const endDate = validDate(source.endDate) ? source.endDate : null;
+    const sourceId = typeof source.itemObject?.id === "string" && source.itemObject.id.length > 0 ? source.itemObject.id : null;
+    if (!source.schedule || source.groupId) {
+      if (beginDate && endDate && !overlaps(beginDate.getTime(), endDate.getTime(), from, to, !!options.strictlyInTimeRange)) {
+        continue;
+      }
+      append({
+        kind: "stored_case" /* StoredCase */,
+        source,
+        caseId: sourceId,
+        beginDate,
+        endDate,
+        key: dateKey(source, sourceId ?? `row:${index}`, beginDate, endDate)
+      });
+      continue;
+    }
+    if (!sourceId) {
+      unexpanded(source, index, "MissingSeriesId" /* MissingSeriesId */);
+      continue;
+    }
+    if (!beginDate || !endDate || endDate.getTime() <= beginDate.getTime()) {
+      unexpanded(source, index, "InvalidSeriesDates" /* InvalidSeriesDates */);
+      continue;
+    }
+    const ranges = source.schedule.scheduleRanges;
+    if (ranges == null || Array.isArray(ranges) && ranges.length === 0) {
+      unexpanded(source, index, "MissingScheduleRanges" /* MissingScheduleRanges */);
+      continue;
+    }
+    if (!Array.isArray(ranges)) {
+      unexpanded(source, index, "InvalidSchedule" /* InvalidSchedule */);
+      continue;
+    }
+    const exceptions = source.schedule.scheduleRangeExceptions;
+    if (exceptions != null && (typeof exceptions !== "object" || Array.isArray(exceptions))) {
+      unexpanded(source, index, "InvalidSchedule" /* InvalidSchedule */);
+      continue;
+    }
+    const rawExcluded = exceptions?.excludedTimeRanges;
+    const rawReplaced = exceptions?.replacedTimeRanges;
+    if (rawExcluded != null && !Array.isArray(rawExcluded) || rawReplaced != null && !Array.isArray(rawReplaced)) {
+      unexpanded(source, index, "InvalidSchedule" /* InvalidSchedule */);
+      continue;
+    }
+    const excludedRanges = [];
+    const replacedRanges = [];
+    let invalidException = false;
+    for (const excluded of rawExcluded ?? []) {
+      if (!excluded || !validDate(excluded.begin) || !validDate(excluded.end)) {
+        invalidException = true;
+        break;
+      }
+      const excludeBegin = excluded.begin.getTime();
+      const excludeEnd = excluded.end.getTime();
+      if (excludeEnd < excludeBegin) {
+        invalidException = true;
+        break;
+      }
+      excludedRanges.push({ begin: excludeBegin, end: excludeEnd });
+    }
+    for (const replaced of rawReplaced ?? []) {
+      if (!replaced || !validDate(replaced.begin) || !validDate(replaced.end)) {
+        invalidException = true;
+        break;
+      }
+      replacedRanges.push({ begin: replaced.begin.getTime(), end: replaced.end.getTime() });
+    }
+    if (invalidException) {
+      unexpanded(source, index, "InvalidSchedule" /* InvalidSchedule */);
+      continue;
+    }
+    const replacementStarts = /* @__PURE__ */ new Map();
+    for (let replacementIndex = replacedRanges.length - 1; replacementIndex >= 0; replacementIndex -= 1) {
+      const replacement = replacedRanges[replacementIndex];
+      replacementStarts.set(replacement.begin, replacementStarts.get(replacement.end) ?? replacement.end);
+    }
+    const seriesEntries = [];
+    let seriesReason = null;
+    let seriesWeeklyZone = null;
+    let recurrenceContextResolved = false;
+    for (const range of ranges) {
+      if (!range || typeof range !== "object") {
+        seriesReason = "InvalidSchedule" /* InvalidSchedule */;
+        break;
+      }
+      const beginning = validDate(range.beginning) ? range.beginning.getTime() : Number.NaN;
+      const ending = validDate(range.ending) ? range.ending.getTime() : Number.NaN;
+      const duration = ending - beginning;
+      if (!Number.isFinite(duration) || duration <= 0) {
+        seriesReason = "InvalidSchedule" /* InvalidSchedule */;
+        break;
+      }
+      const recurrence = range.recurringConditions;
+      const cronExpression = recurrence?.cron;
+      const hasCron = cronExpression != null;
+      if (hasCron && (typeof cronExpression !== "string" || cronExpression.trim().length === 0)) {
+        seriesReason = "InvalidSchedule" /* InvalidSchedule */;
+        break;
+      }
+      const lower = recurrence?.beginDate == null ? beginning : validDate(recurrence.beginDate) ? recurrence.beginDate.getTime() : Number.NaN;
+      const upper = recurrence?.endDate == null ? Number.POSITIVE_INFINITY : validDate(recurrence.endDate) ? recurrence.endDate.getTime() : Number.NaN;
+      if (!Number.isFinite(lower) || Number.isNaN(upper) || lower > upper) {
+        seriesReason = "InvalidSchedule" /* InvalidSchedule */;
+        break;
+      }
+      const repeatSeconds = recurrence?.repeatInterval;
+      const repeating = hasCron || repeatSeconds != null;
+      const step = !hasCron && repeatSeconds != null ? repeatSeconds * 1e3 : 0;
+      if (!hasCron && repeating && (!Number.isSafeInteger(repeatSeconds) || repeatSeconds <= 0 || !Number.isSafeInteger(step))) {
+        seriesReason = "InvalidSchedule" /* InvalidSchedule */;
+        break;
+      }
+      if (recurrence?.remainingCount != null && (!Number.isSafeInteger(recurrence.remainingCount) || recurrence.remainingCount < -1)) {
+        seriesReason = "InvalidSchedule" /* InvalidSchedule */;
+        break;
+      }
+      const earliestOverlap = options.strictlyInTimeRange ? from : from - duration + 1;
+      let searchFrom = earliestOverlap;
+      let searchUntil = to;
+      for (const [originalStart, finalStart] of replacementStarts) {
+        if (overlaps(finalStart, finalStart + duration, from, to, !!options.strictlyInTimeRange)) {
+          searchFrom = Math.min(searchFrom, originalStart);
+          searchUntil = Math.max(searchUntil, originalStart + 1);
+        }
+      }
+      const firstAllowed = hasCron ? Math.max(lower, searchFrom) : Math.max(beginning, lower, searchFrom);
+      const firstIndex = !hasCron && repeating ? Math.max(0, Math.ceil((firstAllowed - beginning) / step)) : 0;
+      let cronSeeker = null;
+      if (hasCron) {
+        try {
+          cronSeeker = createTimetableCronSeeker(cronExpression, firstAllowed);
+        } catch (error) {
+          seriesReason = error instanceof TimetableCronError && error.failure === "UnsupportedSyntax" /* UnsupportedSyntax */ ? "UnsupportedCronSyntax" /* UnsupportedCronSyntax */ : "InvalidSchedule" /* InvalidSchedule */;
+          break;
+        }
+      }
+      let weeklyChecker = null;
+      if (recurrence?.weeklyCron != null) {
+        if (typeof recurrence.weeklyCron !== "string") {
+          seriesReason = "InvalidSchedule" /* InvalidSchedule */;
+          break;
+        }
+        const weeklyZone = resolveWeeklyZone2();
+        if (weeklyZone === null) {
+          seriesReason = "MissingWeeklyTimeZone" /* MissingWeeklyTimeZone */;
+          break;
+        }
+        weeklyChecker = createTimetableWeeklyChecker(recurrence.weeklyCron, recurrence.firstWeekDate, weeklyZone);
+        if (weeklyChecker === null) {
+          seriesReason = "InvalidSchedule" /* InvalidSchedule */;
+          break;
+        }
+      }
+      if (recurrence?.remainingCount === 0) {
+        continue;
+      }
+      let visibleCount = 0;
+      for (let occurrenceIndex = firstIndex; !repeating || occurrenceIndex <= Number.MAX_SAFE_INTEGER; occurrenceIndex += 1) {
+        let start;
+        if (cronSeeker) {
+          try {
+            start = cronSeeker.next().getTime();
+          } catch {
+            seriesReason = "InvalidSchedule" /* InvalidSchedule */;
+            break;
+          }
+        } else {
+          start = repeating ? beginning + occurrenceIndex * step : beginning;
+        }
+        if (!Number.isFinite(start) || start > upper || start >= searchUntil) {
+          break;
+        }
+        iterationCount += 1;
+        if (iterationCount > maxIterations) {
+          throw sdkError("UnsupportedOperation" /* UnsupportedOperation */);
+        }
+        candidateCount += 1;
+        if (candidateCount > maxCandidates) {
+          throw sdkError("UnsupportedOperation" /* UnsupportedOperation */);
+        }
+        const finish = start + duration;
+        if (!validDate(new Date(finish))) {
+          seriesReason = "InvalidSchedule" /* InvalidSchedule */;
+          break;
+        }
+        let matchesWeekly = true;
+        if (weeklyChecker) {
+          try {
+            matchesWeekly = weeklyChecker(start);
+          } catch {
+            seriesReason = "InvalidSchedule" /* InvalidSchedule */;
+            break;
+          }
+        }
+        const isExcluded = excludedRanges.some((excluded) => excluded.begin <= start && excluded.end >= finish);
+        const finalStart = replacementStarts.get(start) ?? start;
+        const finalFinish = finalStart + duration;
+        if (!validDate(new Date(finalFinish))) {
+          seriesReason = "InvalidSchedule" /* InvalidSchedule */;
+          break;
+        }
+        if (start >= lower && matchesWeekly && !isExcluded && overlaps(finalStart, finalFinish, from, to, !!options.strictlyInTimeRange)) {
+          seriesEntries.push({
+            kind: "virtual_occurrence" /* VirtualOccurrence */,
+            source,
+            seriesId: sourceId,
+            beginDate: new Date(finalStart),
+            endDate: new Date(finalFinish),
+            key: dateKey(source, sourceId, new Date(finalStart), new Date(finalFinish))
+          });
+          visibleCount += 1;
+          if (recurrence?.remainingCount != null && recurrence.remainingCount >= 0 && visibleCount >= recurrence.remainingCount) {
+            break;
+          }
+        }
+        if (!repeating) {
+          break;
+        }
+      }
+      if (seriesReason) {
+        break;
+      }
+    }
+    if (seriesReason) {
+      unexpanded(source, index, seriesReason);
+      continue;
+    }
+    for (const entry of seriesEntries) {
+      append(entry);
+    }
+  }
+  const storedDescendants = /* @__PURE__ */ new Set();
+  for (const entry of entries) {
+    if (entry.kind === "stored_case" /* StoredCase */ && typeof entry.source.groupId === "string" && entry.source.groupId.length > 0 && entry.beginDate && entry.endDate) {
+      storedDescendants.add(JSON.stringify([entry.source.groupId, entry.beginDate.getTime(), entry.endDate.getTime()]));
+    }
+  }
+  const seenOccurrences = /* @__PURE__ */ new Set();
+  const result = entries.filter((entry) => {
+    if (entry.kind === "virtual_occurrence" /* VirtualOccurrence */) {
+      const replacementKey = JSON.stringify([entry.seriesId, entry.beginDate.getTime(), entry.endDate.getTime()]);
+      if (storedDescendants.has(replacementKey)) {
+        return false;
+      }
+    }
+    if (entry.kind === "unexpanded_series" /* UnexpandedSeries */ || entry.kind === "stored_case" /* StoredCase */ && !entry.caseId) {
+      return true;
+    }
+    const occurrenceKey = `${entry.kind}:${entry.key}`;
+    if (seenOccurrences.has(occurrenceKey)) {
+      return false;
+    }
+    seenOccurrences.add(occurrenceKey);
+    return true;
+  });
+  if (result.length > maxResults) {
+    throw sdkError("UnsupportedOperation" /* UnsupportedOperation */);
+  }
+  result.sort((left, right) => {
+    const leftStart = left.kind === "unexpanded_series" /* UnexpandedSeries */ ? left.source.beginDate : left.beginDate;
+    const rightStart = right.kind === "unexpanded_series" /* UnexpandedSeries */ ? right.source.beginDate : right.beginDate;
+    const timeDifference = (validDate(leftStart) ? leftStart.getTime() : Number.POSITIVE_INFINITY) - (validDate(rightStart) ? rightStart.getTime() : Number.POSITIVE_INFINITY);
+    if (timeDifference) {
+      return timeDifference;
+    }
+    return left.key < right.key ? -1 : left.key > right.key ? 1 : 0;
+  });
+  return result;
+}
+
 // ../../src/resources/contexts/context-icon-preset-paths.ts
 var CONTEXT_ICON_PRESET_PATHS = {
   anchor: "M35.4783 29.6467C30.6084 24.7768 26.629 15.4085 26.586 15.307C26.585 15.3045 26.5825 15.3015 26.5825 15.3015C26.5594 15.2485 26.527 15.2036 26.4889 15.1626C26.4775 15.1501 26.4645 15.1401 26.4515 15.129C26.4195 15.1006 26.3845 15.0771 26.3465 15.058C26.331 15.0505 26.317 15.042 26.301 15.0361C26.2465 15.0155 26.19 15.0011 26.13 15.0005H26.1265H26.125L26.1215 15.001C25.9914 14.9915 25.8714 15.0495 25.78 15.141C25.776 15.145 25.772 15.148 25.768 15.152C25.7279 15.195 25.6924 15.2425 25.668 15.2975L25.6644 15.3055C25.561 15.536 21.6095 24.3088 16.7716 29.1467C16.6441 29.2742 16.5951 29.4602 16.6431 29.6337C16.6911 29.8072 16.8291 29.9417 17.0037 29.9852C20.5716 30.8772 20.6245 37.3121 20.6251 37.5006C20.6256 37.7765 20.8495 37.9995 21.125 37.9995C21.401 37.999 21.6251 37.7761 21.6251 37.5C21.6251 37.4495 21.5811 30.7692 18.0356 29.2767C21.4051 25.6693 24.22 20.5154 25.6249 17.707V27.0508C24.4854 27.2833 23.625 28.2928 23.625 29.5002C23.625 30.8787 24.7465 32.0002 26.125 32.0002C27.5035 32.0002 28.6249 30.8787 28.6249 29.5002C28.6249 28.2928 27.7644 27.2833 26.625 27.0508V17.8115C28.0315 20.7629 30.8454 26.1428 34.2113 29.7717C30.6684 31.2087 30.6249 37.4546 30.6249 37.5C30.6249 37.776 30.8483 37.999 31.1238 37.9995C31.3998 37.9995 31.6239 37.7765 31.6249 37.501C31.6253 37.3331 31.6814 31.3761 35.2463 30.4852C35.4208 30.4417 35.5588 30.3072 35.6068 30.1337C35.6547 29.9602 35.6058 29.7742 35.4783 29.6467ZM27.6249 29.5002C27.6249 30.3272 26.9519 31.0002 26.125 31.0002C25.298 31.0002 24.625 30.3272 24.625 29.5002C24.625 28.6733 25.298 28.0003 26.125 28.0003C26.9519 28.0003 27.6249 28.6733 27.6249 29.5002ZM32.1248 37.0001H20.1251C19.8491 37.0001 19.6251 37.2241 19.6251 37.5V38.5C19.6251 38.776 19.8491 39 20.1251 39C20.4011 39 20.6251 38.776 20.6251 38.5V38.0001H31.6248V38.5C31.6248 38.776 31.8488 39 32.1248 39C32.4007 39 32.6247 38.776 32.6247 38.5V37.5C32.6248 37.2241 32.4008 37.0001 32.1248 37.0001Z",
@@ -19711,11 +20331,13 @@ export {
   AuthScopeValues,
   AuthSessionEffectStep,
   AuthSessionErrorReason,
+  AvailabilityTimeValues,
   AvailableResourcesValues,
   BehaviorSettingsEffectStep,
   BlockReasonsFacade,
   CalendarViewTypeValues,
   CalendarsFacade,
+  CaseParticipantTypeValues,
   CaseStateValues,
   CaseTypeValues,
   CasesFacade,
@@ -19793,11 +20415,14 @@ export {
   SessionDurationTypeValues,
   SessionPrecisionTypeValues,
   ShortUrlFacade,
+  ShowCaseInTimetableTypeValues,
   StateManagementTypeValues,
   ThesaurusFacade,
   TimeSelectionTypeValues,
   TimeSplitTypeValues,
   TimeStepUiModeValues,
+  TimetableExpansionKind,
+  TimetableUnexpandedReason,
   TimetableViewTypeValues,
   TokenStatusValueList,
   TokenStatusValues,
@@ -19828,6 +20453,7 @@ export {
   createOrder,
   createServiceSessionDurationProperties,
   expandBookingWizardSteps,
+  expandRecurringTimetableCases,
   generateRid,
   generateServiceResourceGroupId,
   generateTorrowId,