@mrtdown/core 2.0.0-alpha.1

package/dist/helpers/computeStartOfDaysWithinInterval.test.js

@@ -0,0 +1,126 @@
+import { describe, expect, test } from 'vitest';
+import { computeStartOfDaysWithinInterval } from './computeStartOfDaysWithinInterval.js';
+import { DateTime } from 'luxon';
+describe('computeStartOfDaysWithinInterval', () => {
+    test('interval that does not transcend days', () => {
+        expect(computeStartOfDaysWithinInterval(DateTime.fromObject({
+            day: 1,
+            month: 4,
+            year: 2025,
+            hour: 12,
+            minute: 30,
+        }), DateTime.fromObject({
+            day: 1,
+            month: 4,
+            year: 2025,
+            hour: 15,
+            minute: 30,
+        }))).toEqual([]);
+    });
+    test('interval that starts from midnight', () => {
+        expect(computeStartOfDaysWithinInterval(DateTime.fromObject({
+            day: 1,
+            month: 4,
+            year: 2025,
+            hour: 0,
+            minute: 0,
+        }), DateTime.fromObject({
+            day: 1,
+            month: 4,
+            year: 2025,
+            hour: 15,
+            minute: 30,
+        }))).toEqual([
+            DateTime.fromObject({
+                day: 1,
+                month: 4,
+                year: 2025,
+                hour: 0,
+                minute: 0,
+            }),
+        ]);
+    });
+    test('interval that ends at midnight', () => {
+        expect(computeStartOfDaysWithinInterval(DateTime.fromObject({
+            day: 1,
+            month: 4,
+            year: 2025,
+            hour: 15,
+            minute: 30,
+        }), DateTime.fromObject({
+            day: 2,
+            month: 4,
+            year: 2025,
+            hour: 0,
+            minute: 0,
+        }))).toEqual([]);
+    });
+    test('interval that transcends 2 days', () => {
+        expect(computeStartOfDaysWithinInterval(DateTime.fromObject({
+            day: 1,
+            month: 4,
+            year: 2025,
+            hour: 18,
+            minute: 30,
+        }), DateTime.fromObject({
+            day: 2,
+            month: 4,
+            year: 2025,
+            hour: 18,
+            minute: 30,
+        }))).toEqual([
+            DateTime.fromObject({
+                day: 2,
+                month: 4,
+                year: 2025,
+                hour: 0,
+                minute: 0,
+            }),
+        ]);
+    });
+    test('interval that transcends more than 2 days', () => {
+        expect(computeStartOfDaysWithinInterval(DateTime.fromObject({
+            day: 1,
+            month: 4,
+            year: 2025,
+            hour: 18,
+            minute: 30,
+        }), DateTime.fromObject({
+            day: 5,
+            month: 4,
+            year: 2025,
+            hour: 4,
+            minute: 30,
+        }))).toEqual([
+            DateTime.fromObject({
+                day: 2,
+                month: 4,
+                year: 2025,
+                hour: 0,
+                minute: 0,
+            }),
+            DateTime.fromObject({
+                day: 3,
+                month: 4,
+                year: 2025,
+                hour: 0,
+                minute: 0,
+            }),
+            DateTime.fromObject({
+                day: 4,
+                month: 4,
+                year: 2025,
+                hour: 0,
+                minute: 0,
+            }),
+            DateTime.fromObject({
+                day: 5,
+                month: 4,
+                year: 2025,
+                hour: 0,
+                minute: 0,
+            }),
+        ]);
+    });
+});
+//# sourceMappingURL=computeStartOfDaysWithinInterval.test.js.map

package/dist/helpers/computeStartOfDaysWithinInterval.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeStartOfDaysWithinInterval.test.js","sourceRoot":"/","sources":["helpers/computeStartOfDaysWithinInterval.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, test } from 'vitest';\n\nimport { computeStartOfDaysWithinInterval } from './computeStartOfDaysWithinInterval.js';\nimport { DateTime } from 'luxon';\n\ndescribe('computeStartOfDaysWithinInterval', () => {\n  test('interval that does not transcend days', () => {\n    expect(\n      computeStartOfDaysWithinInterval(\n        DateTime.fromObject({\n          day: 1,\n          month: 4,\n          year: 2025,\n          hour: 12,\n          minute: 30,\n        }),\n        DateTime.fromObject({\n          day: 1,\n          month: 4,\n          year: 2025,\n          hour: 15,\n          minute: 30,\n        }),\n      ),\n    ).toEqual([] satisfies DateTime[]);\n  });\n\n  test('interval that starts from midnight', () => {\n    expect(\n      computeStartOfDaysWithinInterval(\n        DateTime.fromObject({\n          day: 1,\n          month: 4,\n          year: 2025,\n          hour: 0,\n          minute: 0,\n        }),\n        DateTime.fromObject({\n          day: 1,\n          month: 4,\n          year: 2025,\n          hour: 15,\n          minute: 30,\n        }),\n      ),\n    ).toEqual([\n      DateTime.fromObject({\n        day: 1,\n        month: 4,\n        year: 2025,\n        hour: 0,\n        minute: 0,\n      }),\n    ] satisfies DateTime[]);\n  });\n\n  test('interval that ends at midnight', () => {\n    expect(\n      computeStartOfDaysWithinInterval(\n        DateTime.fromObject({\n          day: 1,\n          month: 4,\n          year: 2025,\n          hour: 15,\n          minute: 30,\n        }),\n        DateTime.fromObject({\n          day: 2,\n          month: 4,\n          year: 2025,\n          hour: 0,\n          minute: 0,\n        }),\n      ),\n    ).toEqual([] satisfies DateTime[]);\n  });\n\n  test('interval that transcends 2 days', () => {\n    expect(\n      computeStartOfDaysWithinInterval(\n        DateTime.fromObject({\n          day: 1,\n          month: 4,\n          year: 2025,\n          hour: 18,\n          minute: 30,\n        }),\n        DateTime.fromObject({\n          day: 2,\n          month: 4,\n          year: 2025,\n          hour: 18,\n          minute: 30,\n        }),\n      ),\n    ).toEqual([\n      DateTime.fromObject({\n        day: 2,\n        month: 4,\n        year: 2025,\n        hour: 0,\n        minute: 0,\n      }),\n    ] satisfies DateTime[]);\n  });\n\n  test('interval that transcends more than 2 days', () => {\n    expect(\n      computeStartOfDaysWithinInterval(\n        DateTime.fromObject({\n          day: 1,\n          month: 4,\n          year: 2025,\n          hour: 18,\n          minute: 30,\n        }),\n        DateTime.fromObject({\n          day: 5,\n          month: 4,\n          year: 2025,\n          hour: 4,\n          minute: 30,\n        }),\n      ),\n    ).toEqual([\n      DateTime.fromObject({\n        day: 2,\n        month: 4,\n        year: 2025,\n        hour: 0,\n        minute: 0,\n      }),\n      DateTime.fromObject({\n        day: 3,\n        month: 4,\n        year: 2025,\n        hour: 0,\n        minute: 0,\n      }),\n      DateTime.fromObject({\n        day: 4,\n        month: 4,\n        year: 2025,\n        hour: 0,\n        minute: 0,\n      }),\n      DateTime.fromObject({\n        day: 5,\n        month: 4,\n        year: 2025,\n        hour: 0,\n        minute: 0,\n      }),\n    ] satisfies DateTime[]);\n  });\n});\n"]}

package/dist/helpers/estimateOpenAICost.d.ts

@@ -0,0 +1,40 @@
+type ResponsesUsageLike = {
+    input_tokens: number;
+    output_tokens: number;
+    total_tokens: number;
+    input_tokens_details?: {
+        cached_tokens?: number;
+    } | null;
+} | null | undefined;
+type ChatCompletionUsageLike = {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+    prompt_tokens_details?: {
+        cached_tokens?: number;
+    } | null;
+} | null | undefined;
+export type OpenAITokenUsage = {
+    inputTokens: number;
+    cachedInputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+};
+export type OpenAIModelPricing = {
+    inputUsdPer1MTokens: number;
+    cachedInputUsdPer1MTokens: number;
+    outputUsdPer1MTokens: number;
+};
+export declare const OPENAI_MODEL_PRICING: Record<string, OpenAIModelPricing>;
+export declare function normalizeOpenAIResponsesUsage(usage: ResponsesUsageLike): OpenAITokenUsage | null;
+export declare function normalizeOpenAIChatCompletionUsage(usage: ChatCompletionUsageLike): OpenAITokenUsage | null;
+export declare function estimateOpenAICostFromUsage({ model, usage, pricingByModel, }: {
+    model: string;
+    usage: OpenAITokenUsage | null;
+    pricingByModel?: Record<string, OpenAIModelPricing>;
+}): {
+    estimatedCostUsd: number;
+    usage: OpenAITokenUsage;
+    pricing: OpenAIModelPricing;
+} | null;
+export {};

package/dist/helpers/estimateOpenAICost.js

@@ -0,0 +1,55 @@
+export const OPENAI_MODEL_PRICING = {
+    'gpt-5-mini': {
+        inputUsdPer1MTokens: 0.25,
+        cachedInputUsdPer1MTokens: 0.025,
+        outputUsdPer1MTokens: 2,
+    },
+    'gpt-5-nano': {
+        inputUsdPer1MTokens: 0.05,
+        cachedInputUsdPer1MTokens: 0.005,
+        outputUsdPer1MTokens: 0.4,
+    },
+};
+export function normalizeOpenAIResponsesUsage(usage) {
+    if (usage == null) {
+        return null;
+    }
+    return {
+        inputTokens: usage.input_tokens,
+        cachedInputTokens: usage.input_tokens_details?.cached_tokens ?? 0,
+        outputTokens: usage.output_tokens,
+        totalTokens: usage.total_tokens,
+    };
+}
+export function normalizeOpenAIChatCompletionUsage(usage) {
+    if (usage == null) {
+        return null;
+    }
+    return {
+        inputTokens: usage.prompt_tokens,
+        cachedInputTokens: usage.prompt_tokens_details?.cached_tokens ?? 0,
+        outputTokens: usage.completion_tokens,
+        totalTokens: usage.total_tokens,
+    };
+}
+export function estimateOpenAICostFromUsage({ model, usage, pricingByModel = OPENAI_MODEL_PRICING, }) {
+    if (usage == null) {
+        return null;
+    }
+    const pricing = pricingByModel[model];
+    if (pricing == null) {
+        return null;
+    }
+    const cachedInputTokens = Math.max(usage.cachedInputTokens, 0);
+    const uncachedInputTokens = Math.max(usage.inputTokens - cachedInputTokens, 0);
+    const outputTokens = Math.max(usage.outputTokens, 0);
+    const estimatedCostUsd = (uncachedInputTokens / 1_000_000) * pricing.inputUsdPer1MTokens +
+        (cachedInputTokens / 1_000_000) * pricing.cachedInputUsdPer1MTokens +
+        (outputTokens / 1_000_000) * pricing.outputUsdPer1MTokens;
+    return {
+        estimatedCostUsd,
+        usage,
+        pricing,
+    };
+}
+//# sourceMappingURL=estimateOpenAICost.js.map

package/dist/helpers/estimateOpenAICost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimateOpenAICost.js","sourceRoot":"/","sources":["helpers/estimateOpenAICost.ts"],"names":[],"mappings":"AA+BA,MAAM,CAAC,MAAM,oBAAoB,GAAuC;IACtE,YAAY,EAAE;QACZ,mBAAmB,EAAE,IAAI;QACzB,yBAAyB,EAAE,KAAK;QAChC,oBAAoB,EAAE,CAAC;KACxB;IACD,YAAY,EAAE;QACZ,mBAAmB,EAAE,IAAI;QACzB,yBAAyB,EAAE,KAAK;QAChC,oBAAoB,EAAE,GAAG;KAC1B;CACF,CAAC;AAEF,MAAM,UAAU,6BAA6B,CAC3C,KAAyB;IAEzB,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,YAAY;QAC/B,iBAAiB,EAAE,KAAK,CAAC,oBAAoB,EAAE,aAAa,IAAI,CAAC;QACjE,YAAY,EAAE,KAAK,CAAC,aAAa;QACjC,WAAW,EAAE,KAAK,CAAC,YAAY;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,KAA8B;IAE9B,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,aAAa;QAChC,iBAAiB,EAAE,KAAK,CAAC,qBAAqB,EAAE,aAAa,IAAI,CAAC;QAClE,YAAY,EAAE,KAAK,CAAC,iBAAiB;QACrC,WAAW,EAAE,KAAK,CAAC,YAAY;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,EAC1C,KAAK,EACL,KAAK,EACL,cAAc,GAAG,oBAAoB,GAKtC;IACC,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC;IAC/D,MAAM,mBAAmB,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,GAAG,iBAAiB,EAAE,CAAC,CAAC,CAAC;IAC/E,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAErD,MAAM,gBAAgB,GACpB,CAAC,mBAAmB,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,mBAAmB;QAC/D,CAAC,iBAAiB,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,yBAAyB;QACnE,CAAC,YAAY,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAE5D,OAAO;QACL,gBAAgB;QAChB,KAAK;QACL,OAAO;KACR,CAAC;AACJ,CAAC","sourcesContent":["type ResponsesUsageLike = {\n  input_tokens: number;\n  output_tokens: number;\n  total_tokens: number;\n  input_tokens_details?: {\n    cached_tokens?: number;\n  } | null;\n} | null | undefined;\n\ntype ChatCompletionUsageLike = {\n  prompt_tokens: number;\n  completion_tokens: number;\n  total_tokens: number;\n  prompt_tokens_details?: {\n    cached_tokens?: number;\n  } | null;\n} | null | undefined;\n\nexport type OpenAITokenUsage = {\n  inputTokens: number;\n  cachedInputTokens: number;\n  outputTokens: number;\n  totalTokens: number;\n};\n\nexport type OpenAIModelPricing = {\n  inputUsdPer1MTokens: number;\n  cachedInputUsdPer1MTokens: number;\n  outputUsdPer1MTokens: number;\n};\n\nexport const OPENAI_MODEL_PRICING: Record<string, OpenAIModelPricing> = {\n  'gpt-5-mini': {\n    inputUsdPer1MTokens: 0.25,\n    cachedInputUsdPer1MTokens: 0.025,\n    outputUsdPer1MTokens: 2,\n  },\n  'gpt-5-nano': {\n    inputUsdPer1MTokens: 0.05,\n    cachedInputUsdPer1MTokens: 0.005,\n    outputUsdPer1MTokens: 0.4,\n  },\n};\n\nexport function normalizeOpenAIResponsesUsage(\n  usage: ResponsesUsageLike,\n): OpenAITokenUsage | null {\n  if (usage == null) {\n    return null;\n  }\n\n  return {\n    inputTokens: usage.input_tokens,\n    cachedInputTokens: usage.input_tokens_details?.cached_tokens ?? 0,\n    outputTokens: usage.output_tokens,\n    totalTokens: usage.total_tokens,\n  };\n}\n\nexport function normalizeOpenAIChatCompletionUsage(\n  usage: ChatCompletionUsageLike,\n): OpenAITokenUsage | null {\n  if (usage == null) {\n    return null;\n  }\n\n  return {\n    inputTokens: usage.prompt_tokens,\n    cachedInputTokens: usage.prompt_tokens_details?.cached_tokens ?? 0,\n    outputTokens: usage.completion_tokens,\n    totalTokens: usage.total_tokens,\n  };\n}\n\nexport function estimateOpenAICostFromUsage({\n  model,\n  usage,\n  pricingByModel = OPENAI_MODEL_PRICING,\n}: {\n  model: string;\n  usage: OpenAITokenUsage | null;\n  pricingByModel?: Record<string, OpenAIModelPricing>;\n}) {\n  if (usage == null) {\n    return null;\n  }\n\n  const pricing = pricingByModel[model];\n  if (pricing == null) {\n    return null;\n  }\n\n  const cachedInputTokens = Math.max(usage.cachedInputTokens, 0);\n  const uncachedInputTokens = Math.max(usage.inputTokens - cachedInputTokens, 0);\n  const outputTokens = Math.max(usage.outputTokens, 0);\n\n  const estimatedCostUsd =\n    (uncachedInputTokens / 1_000_000) * pricing.inputUsdPer1MTokens +\n    (cachedInputTokens / 1_000_000) * pricing.cachedInputUsdPer1MTokens +\n    (outputTokens / 1_000_000) * pricing.outputUsdPer1MTokens;\n\n  return {\n    estimatedCostUsd,\n    usage,\n    pricing,\n  };\n}\n"]}

package/dist/helpers/keyForAffectedEntity.d.ts

@@ -0,0 +1,7 @@
+import type { AffectedEntity } from '#schema/issue/entity.js';
+/**
+ * Generate a stable key for an affected entity.
+ * @param target - The affected entity.
+ * @returns The key.
+ */
+export declare function keyForAffectedEntity(affectedEntity: AffectedEntity): string;

package/dist/helpers/keyForAffectedEntity.js

@@ -0,0 +1,14 @@
+/**
+ * Generate a stable key for an affected entity.
+ * @param target - The affected entity.
+ * @returns The key.
+ */
+export function keyForAffectedEntity(affectedEntity) {
+    switch (affectedEntity.type) {
+        case 'service':
+            return `service:${affectedEntity.serviceId}`;
+        case 'facility':
+            return `facility:${affectedEntity.stationId}:${affectedEntity.kind}`;
+    }
+}
+//# sourceMappingURL=keyForAffectedEntity.js.map

package/dist/helpers/keyForAffectedEntity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyForAffectedEntity.js","sourceRoot":"/","sources":["helpers/keyForAffectedEntity.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,cAA8B;IACjE,QAAQ,cAAc,CAAC,IAAI,EAAE,CAAC;QAC5B,KAAK,SAAS;YACZ,OAAO,WAAW,cAAc,CAAC,SAAS,EAAE,CAAC;QAC/C,KAAK,UAAU;YACb,OAAO,YAAY,cAAc,CAAC,SAAS,IAAI,cAAc,CAAC,IAAI,EAAE,CAAC;IACzE,CAAC;AACH,CAAC","sourcesContent":["import type { AffectedEntity } from '#schema/issue/entity.js';\n\n/**\n * Generate a stable key for an affected entity.\n * @param target - The affected entity.\n * @returns The key.\n */\nexport function keyForAffectedEntity(affectedEntity: AffectedEntity): string {\n  switch (affectedEntity.type) {\n    case 'service':\n      return `service:${affectedEntity.serviceId}`;\n    case 'facility':\n      return `facility:${affectedEntity.stationId}:${affectedEntity.kind}`;\n  }\n}\n"]}

package/dist/helpers/normalizeRecurringPeriod.d.ts

@@ -0,0 +1,7 @@
+import type { PeriodFixed, PeriodRecurring } from '#schema/issue/period.js';
+/**
+ * Normalize a recurring period into a list of fixed periods.
+ * @param period - The recurring period to normalize.
+ * @returns The list of fixed periods.
+ */
+export declare function normalizeRecurringPeriod(period: PeriodRecurring): PeriodFixed[];

package/dist/helpers/normalizeRecurringPeriod.js

@@ -0,0 +1,118 @@
+import { DateTime } from 'luxon';
+import { DateTime as DateTimeRust, Frequency, RRule, RRuleSet, Weekday, } from 'rrule-rust';
+import { assert } from '#util/assert.js';
+function toFrequency(frequency) {
+    switch (frequency) {
+        case 'daily':
+            return Frequency.Daily;
+        case 'weekly':
+            return Frequency.Weekly;
+        case 'monthly':
+            return Frequency.Monthly;
+        case 'yearly':
+            return Frequency.Yearly;
+        default:
+            throw new Error(`Invalid frequency: ${frequency}`);
+    }
+}
+function toDaysOfWeek(daysOfWeek) {
+    const result = [];
+    for (const day of daysOfWeek ?? []) {
+        switch (day) {
+            case 'MO':
+                result.push(Weekday.Monday);
+                break;
+            case 'TU':
+                result.push(Weekday.Tuesday);
+                break;
+            case 'WE':
+                result.push(Weekday.Wednesday);
+                break;
+            case 'TH':
+                result.push(Weekday.Thursday);
+                break;
+            case 'FR':
+                result.push(Weekday.Friday);
+                break;
+            case 'SA':
+                result.push(Weekday.Saturday);
+                break;
+            case 'SU':
+                result.push(Weekday.Sunday);
+                break;
+            default:
+                throw new Error(`Invalid day of week: ${day}`);
+        }
+    }
+    return result;
+}
+function toByTimes(timeWindow) {
+    const startAtTime = DateTime.fromISO(timeWindow.startAt);
+    assert(startAtTime.isValid, `Invalid ISO datetime: ${timeWindow.startAt}`);
+    return {
+        byHour: [startAtTime.hour],
+        byMinute: [startAtTime.minute],
+        bySecond: [startAtTime.second],
+    };
+}
+/**
+ * Normalize a recurring period into a list of fixed periods.
+ * @param period - The recurring period to normalize.
+ * @returns The list of fixed periods.
+ */
+export function normalizeRecurringPeriod(period) {
+    const fixedPeriods = [];
+    const startAt = DateTime.fromISO(period.startAt).setZone(period.timeZone, {
+        keepLocalTime: true,
+    });
+    assert(startAt.isValid, `Invalid ISO datetime: ${period.startAt}`);
+    const endAt = DateTime.fromISO(period.endAt).setZone(period.timeZone, {
+        keepLocalTime: true,
+    });
+    assert(endAt.isValid, `Invalid ISO datetime: ${period.endAt}`);
+    const byTimes = toByTimes(period.timeWindow);
+    const rruleSet = new RRuleSet({
+        dtstart: DateTimeRust.fromObject(startAt.toObject()),
+        tzid: period.timeZone,
+        rrules: [
+            new RRule({
+                until: DateTimeRust.fromObject(endAt.toObject()),
+                frequency: toFrequency(period.frequency),
+                interval: 1,
+                byWeekday: toDaysOfWeek(period.daysOfWeek),
+                byHour: byTimes.byHour,
+                byMinute: byTimes.byMinute,
+                bySecond: byTimes.bySecond,
+            }),
+        ],
+        exdates: period.excludedDates?.map((date) => {
+            const dateTime = DateTime.fromISO(date).setZone(period.timeZone, {
+                keepLocalTime: true,
+            });
+            assert(dateTime.isValid, `Invalid ISO datetime: ${date}`);
+            return DateTimeRust.fromObject(dateTime.toObject());
+        }),
+    });
+    const timeWindowEndAt = DateTime.fromISO(period.timeWindow.endAt);
+    assert(timeWindowEndAt.isValid, `Invalid ISO datetime: ${period.timeWindow.endAt}`);
+    for (const dt of rruleSet.all()) {
+        const dtStart = DateTime.fromObject(dt.toObject()).setZone(rruleSet.tzid, {
+            keepLocalTime: true,
+        });
+        assert(dtStart.isValid);
+        const dtEnd = DateTime.fromObject({
+            ...dt.toObject(),
+            hour: timeWindowEndAt.toObject().hour,
+            minute: timeWindowEndAt.toObject().minute,
+            second: timeWindowEndAt.toObject().second,
+        });
+        assert(dtEnd.isValid);
+        fixedPeriods.push({
+            kind: 'fixed',
+            startAt: dtStart.toISO(),
+            endAt: dtEnd.toISO(),
+        });
+    }
+    return fixedPeriods;
+}
+//# sourceMappingURL=normalizeRecurringPeriod.js.map

package/dist/helpers/normalizeRecurringPeriod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeRecurringPeriod.js","sourceRoot":"/","sources":["helpers/normalizeRecurringPeriod.ts"],"names":[],"mappings":"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","sourcesContent":["import { DateTime } from 'luxon';\nimport {\n  DateTime as DateTimeRust,\n  Frequency,\n  type NWeekday,\n  RRule,\n  RRuleSet,\n  Weekday,\n} from 'rrule-rust';\nimport type {\n  PeriodFixed,\n  PeriodFrequency,\n  PeriodRecurring,\n} from '#schema/issue/period.js';\nimport { assert } from '#util/assert.js';\n\nfunction toFrequency(frequency: PeriodFrequency): Frequency {\n  switch (frequency) {\n    case 'daily':\n      return Frequency.Daily;\n    case 'weekly':\n      return Frequency.Weekly;\n    case 'monthly':\n      return Frequency.Monthly;\n    case 'yearly':\n      return Frequency.Yearly;\n    default:\n      throw new Error(`Invalid frequency: ${frequency}`);\n  }\n}\n\nfunction toDaysOfWeek(\n  daysOfWeek: PeriodRecurring['daysOfWeek'],\n): readonly (NWeekday | Weekday)[] {\n  const result: (NWeekday | Weekday)[] = [];\n\n  for (const day of daysOfWeek ?? []) {\n    switch (day) {\n      case 'MO':\n        result.push(Weekday.Monday);\n        break;\n      case 'TU':\n        result.push(Weekday.Tuesday);\n        break;\n      case 'WE':\n        result.push(Weekday.Wednesday);\n        break;\n      case 'TH':\n        result.push(Weekday.Thursday);\n        break;\n      case 'FR':\n        result.push(Weekday.Friday);\n        break;\n      case 'SA':\n        result.push(Weekday.Saturday);\n        break;\n      case 'SU':\n        result.push(Weekday.Sunday);\n        break;\n      default:\n        throw new Error(`Invalid day of week: ${day}`);\n    }\n  }\n\n  return result;\n}\n\nfunction toByTimes(timeWindow: PeriodRecurring['timeWindow']): {\n  byHour: number[];\n  byMinute: number[];\n  bySecond: number[];\n} {\n  const startAtTime = DateTime.fromISO(timeWindow.startAt);\n  assert(startAtTime.isValid, `Invalid ISO datetime: ${timeWindow.startAt}`);\n\n  return {\n    byHour: [startAtTime.hour],\n    byMinute: [startAtTime.minute],\n    bySecond: [startAtTime.second],\n  };\n}\n\n/**\n * Normalize a recurring period into a list of fixed periods.\n * @param period - The recurring period to normalize.\n * @returns The list of fixed periods.\n */\nexport function normalizeRecurringPeriod(\n  period: PeriodRecurring,\n): PeriodFixed[] {\n  const fixedPeriods: PeriodFixed[] = [];\n\n  const startAt = DateTime.fromISO(period.startAt).setZone(period.timeZone, {\n    keepLocalTime: true,\n  });\n  assert(startAt.isValid, `Invalid ISO datetime: ${period.startAt}`);\n  const endAt = DateTime.fromISO(period.endAt).setZone(period.timeZone, {\n    keepLocalTime: true,\n  });\n  assert(endAt.isValid, `Invalid ISO datetime: ${period.endAt}`);\n\n  const byTimes = toByTimes(period.timeWindow);\n\n  const rruleSet = new RRuleSet({\n    dtstart: DateTimeRust.fromObject(startAt.toObject()),\n    tzid: period.timeZone,\n    rrules: [\n      new RRule({\n        until: DateTimeRust.fromObject(endAt.toObject()),\n        frequency: toFrequency(period.frequency),\n        interval: 1,\n        byWeekday: toDaysOfWeek(period.daysOfWeek),\n        byHour: byTimes.byHour,\n        byMinute: byTimes.byMinute,\n        bySecond: byTimes.bySecond,\n      }),\n    ],\n    exdates: period.excludedDates?.map((date) => {\n      const dateTime = DateTime.fromISO(date).setZone(period.timeZone, {\n        keepLocalTime: true,\n      });\n      assert(dateTime.isValid, `Invalid ISO datetime: ${date}`);\n      return DateTimeRust.fromObject(dateTime.toObject());\n    }),\n  });\n\n  const timeWindowEndAt = DateTime.fromISO(period.timeWindow.endAt);\n  assert(\n    timeWindowEndAt.isValid,\n    `Invalid ISO datetime: ${period.timeWindow.endAt}`,\n  );\n\n  for (const dt of rruleSet.all()) {\n    const dtStart = DateTime.fromObject(dt.toObject()).setZone(rruleSet.tzid, {\n      keepLocalTime: true,\n    });\n    assert(dtStart.isValid);\n    const dtEnd = DateTime.fromObject({\n      ...dt.toObject(),\n      hour: timeWindowEndAt.toObject().hour,\n      minute: timeWindowEndAt.toObject().minute,\n      second: timeWindowEndAt.toObject().second,\n    });\n    assert(dtEnd.isValid);\n    fixedPeriods.push({\n      kind: 'fixed',\n      startAt: dtStart.toISO(),\n      endAt: dtEnd.toISO(),\n    });\n  }\n\n  return fixedPeriods;\n}\n"]}

package/dist/helpers/normalizeRecurringPeriod.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/helpers/normalizeRecurringPeriod.test.js

@@ -0,0 +1,93 @@
+import { describe, expect, test } from 'vitest';
+import { normalizeRecurringPeriod } from './normalizeRecurringPeriod.js';
+function makeRecurringPeriod(overrides = {}) {
+    return {
+        kind: 'recurring',
+        frequency: 'daily',
+        startAt: '2025-01-01T00:00:00+08:00',
+        endAt: '2025-01-03T23:59:59+08:00',
+        daysOfWeek: null,
+        timeWindow: {
+            startAt: '08:00:00',
+            endAt: '10:00:00',
+        },
+        timeZone: 'Asia/Singapore',
+        excludedDates: null,
+        ...overrides,
+    };
+}
+describe('normalizeRecurringPeriod', () => {
+    test('normalizes a bounded daily recurring period into fixed periods', () => {
+        const period = makeRecurringPeriod();
+        const fixed = normalizeRecurringPeriod(period);
+        expect(fixed).toHaveLength(3);
+        expect(fixed).toEqual([
+            {
+                kind: 'fixed',
+                startAt: '2025-01-01T08:00:00.000+08:00',
+                endAt: '2025-01-01T10:00:00.000+08:00',
+            },
+            {
+                kind: 'fixed',
+                startAt: '2025-01-02T08:00:00.000+08:00',
+                endAt: '2025-01-02T10:00:00.000+08:00',
+            },
+            {
+                kind: 'fixed',
+                startAt: '2025-01-03T08:00:00.000+08:00',
+                endAt: '2025-01-03T10:00:00.000+08:00',
+            },
+        ]);
+    });
+    test('filters recurrence by configured daysOfWeek', () => {
+        const period = makeRecurringPeriod({
+            startAt: '2025-01-01T00:00:00+08:00', // Wednesday
+            endAt: '2025-01-10T23:59:59+08:00',
+            frequency: 'weekly',
+            daysOfWeek: ['MO', 'WE', 'FR'],
+        });
+        const fixed = normalizeRecurringPeriod(period);
+        expect(fixed.map((item) => item.startAt)).toEqual([
+            '2025-01-01T08:00:00.000+08:00',
+            '2025-01-03T08:00:00.000+08:00',
+            '2025-01-06T08:00:00.000+08:00',
+            '2025-01-08T08:00:00.000+08:00',
+            '2025-01-10T08:00:00.000+08:00',
+        ]);
+    });
+    test('excludes specific dates from recurrence', () => {
+        const period = makeRecurringPeriod({
+            timeWindow: {
+                startAt: '00:00:00',
+                endAt: '01:00:00',
+            },
+            excludedDates: ['2025-01-02'],
+        });
+        const fixed = normalizeRecurringPeriod(period);
+        expect(fixed).toEqual([
+            {
+                kind: 'fixed',
+                startAt: '2025-01-01T00:00:00.000+08:00',
+                endAt: '2025-01-01T01:00:00.000+08:00',
+            },
+            {
+                kind: 'fixed',
+                startAt: '2025-01-03T00:00:00.000+08:00',
+                endAt: '2025-01-03T01:00:00.000+08:00',
+            },
+        ]);
+    });
+    test('returns start and end timestamps in Singapore timezone', () => {
+        const period = makeRecurringPeriod({
+            startAt: '2025-01-01T00:00:00Z',
+            endAt: '2025-01-02T23:59:59Z',
+        });
+        const fixed = normalizeRecurringPeriod(period);
+        expect(fixed).toHaveLength(2);
+        for (const item of fixed) {
+            expect(item.startAt.endsWith('+08:00')).toBe(true);
+            expect(item.endAt?.endsWith('+08:00')).toBe(true);
+        }
+    });
+});
+//# sourceMappingURL=normalizeRecurringPeriod.test.js.map

package/dist/helpers/normalizeRecurringPeriod.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeRecurringPeriod.test.js","sourceRoot":"/","sources":["helpers/normalizeRecurringPeriod.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, test } from 'vitest';\nimport type { PeriodRecurring } from '#schema/issue/period.js';\nimport { normalizeRecurringPeriod } from './normalizeRecurringPeriod.js';\n\nfunction makeRecurringPeriod(\n  overrides: Partial<PeriodRecurring> = {},\n): PeriodRecurring {\n  return {\n    kind: 'recurring',\n    frequency: 'daily',\n    startAt: '2025-01-01T00:00:00+08:00',\n    endAt: '2025-01-03T23:59:59+08:00',\n    daysOfWeek: null,\n    timeWindow: {\n      startAt: '08:00:00',\n      endAt: '10:00:00',\n    },\n    timeZone: 'Asia/Singapore',\n    excludedDates: null,\n    ...overrides,\n  };\n}\n\ndescribe('normalizeRecurringPeriod', () => {\n  test('normalizes a bounded daily recurring period into fixed periods', () => {\n    const period = makeRecurringPeriod();\n\n    const fixed = normalizeRecurringPeriod(period);\n\n    expect(fixed).toHaveLength(3);\n    expect(fixed).toEqual([\n      {\n        kind: 'fixed',\n        startAt: '2025-01-01T08:00:00.000+08:00',\n        endAt: '2025-01-01T10:00:00.000+08:00',\n      },\n      {\n        kind: 'fixed',\n        startAt: '2025-01-02T08:00:00.000+08:00',\n        endAt: '2025-01-02T10:00:00.000+08:00',\n      },\n      {\n        kind: 'fixed',\n        startAt: '2025-01-03T08:00:00.000+08:00',\n        endAt: '2025-01-03T10:00:00.000+08:00',\n      },\n    ]);\n  });\n\n  test('filters recurrence by configured daysOfWeek', () => {\n    const period = makeRecurringPeriod({\n      startAt: '2025-01-01T00:00:00+08:00', // Wednesday\n      endAt: '2025-01-10T23:59:59+08:00',\n      frequency: 'weekly',\n      daysOfWeek: ['MO', 'WE', 'FR'],\n    });\n\n    const fixed = normalizeRecurringPeriod(period);\n\n    expect(fixed.map((item) => item.startAt)).toEqual([\n      '2025-01-01T08:00:00.000+08:00',\n      '2025-01-03T08:00:00.000+08:00',\n      '2025-01-06T08:00:00.000+08:00',\n      '2025-01-08T08:00:00.000+08:00',\n      '2025-01-10T08:00:00.000+08:00',\n    ]);\n  });\n\n  test('excludes specific dates from recurrence', () => {\n    const period = makeRecurringPeriod({\n      timeWindow: {\n        startAt: '00:00:00',\n        endAt: '01:00:00',\n      },\n      excludedDates: ['2025-01-02'],\n    });\n\n    const fixed = normalizeRecurringPeriod(period);\n\n    expect(fixed).toEqual([\n      {\n        kind: 'fixed',\n        startAt: '2025-01-01T00:00:00.000+08:00',\n        endAt: '2025-01-01T01:00:00.000+08:00',\n      },\n      {\n        kind: 'fixed',\n        startAt: '2025-01-03T00:00:00.000+08:00',\n        endAt: '2025-01-03T01:00:00.000+08:00',\n      },\n    ]);\n  });\n\n  test('returns start and end timestamps in Singapore timezone', () => {\n    const period = makeRecurringPeriod({\n      startAt: '2025-01-01T00:00:00Z',\n      endAt: '2025-01-02T23:59:59Z',\n    });\n\n    const fixed = normalizeRecurringPeriod(period);\n\n    expect(fixed).toHaveLength(2);\n    for (const item of fixed) {\n      expect(item.startAt.endsWith('+08:00')).toBe(true);\n      expect(item.endAt?.endsWith('+08:00')).toBe(true);\n    }\n  });\n});\n"]}