@mrtdown/core 2.0.0-alpha.1

package/dist/helpers/resolvePeriods.test.js

@@ -0,0 +1,239 @@
+import { describe, expect, test } from 'vitest';
+import { resolvePeriods } from './resolvePeriods.js';
+describe('resolvePeriods', () => {
+    const asOf = '2025-01-01T12:00:00+08:00';
+    const factEndedPeriod = [
+        {
+            kind: 'fixed',
+            startAt: '2025-01-01T08:00:00+08:00',
+            endAt: '2025-01-01T09:00:00+08:00',
+        },
+    ];
+    test('keeps fact-ended period in all modes', () => {
+        const canonical = resolvePeriods({
+            periods: factEndedPeriod,
+            asOf,
+            mode: { kind: 'canonical' },
+        });
+        const operational = resolvePeriods({
+            periods: factEndedPeriod,
+            asOf,
+            mode: { kind: 'operational' },
+        });
+        expect(canonical[0]).toMatchObject({
+            startAt: '2025-01-01T08:00:00+08:00',
+            endAt: '2025-01-01T09:00:00+08:00',
+            endAtResolved: '2025-01-01T09:00:00+08:00',
+            endAtSource: 'fact',
+        });
+        expect(operational[0].endAtSource).toBe('fact');
+    });
+    test('open period with no evidence and no crowd remains open', () => {
+        const result = resolvePeriods({
+            periods: [
+                {
+                    kind: 'fixed',
+                    startAt: '2025-01-01T08:00:00+08:00',
+                    endAt: null,
+                },
+            ],
+            asOf,
+            mode: { kind: 'operational' },
+        });
+        expect(result[0]).toMatchObject({
+            endAt: null,
+            endAtResolved: null,
+            endAtSource: 'none',
+        });
+    });
+    test('open period infers end from evidence timeout only', () => {
+        const result = resolvePeriods({
+            periods: [
+                {
+                    kind: 'fixed',
+                    startAt: '2025-01-01T08:00:00+08:00',
+                    endAt: null,
+                },
+            ],
+            asOf: '2025-01-02T01:00:00+08:00', // Past inferred end-of-day (2025-01-02T00:00)
+            mode: {
+                kind: 'operational',
+                lastEvidenceAt: '2025-01-01T09:00:00+08:00',
+            },
+        });
+        expect(result[0]).toMatchObject({
+            endAtResolved: '2025-01-02T00:00:00.000+08:00',
+            endAtSource: 'inferred',
+            endAtReason: 'evidence_timeout',
+        });
+    });
+    test('crowd exited inference wins over evidence timeout', () => {
+        const result = resolvePeriods({
+            periods: [
+                {
+                    kind: 'fixed',
+                    startAt: '2025-01-01T08:00:00+08:00',
+                    endAt: null,
+                },
+            ],
+            asOf: '2025-01-02T01:00:00+08:00', // Past inferred end-of-day (2025-01-02T00:00)
+            mode: {
+                kind: 'operational',
+                lastEvidenceAt: '2025-01-01T09:00:00+08:00',
+                crowd: {
+                    activeNow: false,
+                    exitedAt: '2025-01-01T10:15:00+08:00',
+                },
+            },
+        });
+        expect(result[0]).toMatchObject({
+            endAtResolved: '2025-01-02T00:00:00.000+08:00',
+            endAtSource: 'inferred',
+            endAtReason: 'crowd_decay',
+        });
+    });
+    test('crowd.activeNow=true prevents crowd-based inference fallback', () => {
+        const result = resolvePeriods({
+            periods: [
+                {
+                    kind: 'fixed',
+                    startAt: '2025-01-01T08:00:00+08:00',
+                    endAt: null,
+                },
+            ],
+            asOf,
+            mode: {
+                kind: 'operational',
+                crowd: {
+                    activeNow: true,
+                    lastActiveAt: '2025-01-01T09:30:00+08:00',
+                },
+            },
+        });
+        expect(result[0]).toMatchObject({
+            endAtResolved: null,
+            endAtSource: 'none',
+        });
+    });
+    test('clamps inferred end to maxInferredDurationMinutes', () => {
+        const result = resolvePeriods({
+            periods: [
+                {
+                    kind: 'fixed',
+                    startAt: '2025-01-01T08:00:00+08:00',
+                    endAt: null,
+                },
+            ],
+            asOf: '2025-01-02T13:00:00+08:00',
+            mode: {
+                kind: 'operational',
+                lastEvidenceAt: '2025-01-02T10:00:00+08:00',
+                config: {
+                    maxInferredDurationMinutes: 60,
+                },
+            },
+        });
+        expect(result[0]).toMatchObject({
+            endAtResolved: '2025-01-01T09:00:00.000+08:00',
+            endAtSource: 'inferred',
+            endAtReason: 'evidence_timeout',
+        });
+    });
+    test('does not close period when inferred end is later than asOf', () => {
+        const result = resolvePeriods({
+            periods: [
+                {
+                    kind: 'fixed',
+                    startAt: '2025-01-01T08:00:00+08:00',
+                    endAt: null,
+                },
+            ],
+            asOf: '2025-01-01T10:00:00+08:00',
+            mode: {
+                kind: 'operational',
+                lastEvidenceAt: '2025-01-01T09:30:00+08:00',
+            },
+        });
+        expect(result[0]).toMatchObject({
+            endAtResolved: null,
+            endAtSource: 'none',
+        });
+    });
+    test('expands recurring periods into fixed periods in canonical mode', () => {
+        const result = resolvePeriods({
+            periods: [
+                {
+                    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,
+                },
+            ],
+            asOf,
+            mode: { kind: 'canonical' },
+        });
+        expect(result).toEqual([
+            {
+                kind: 'fixed',
+                startAt: '2025-01-01T08:00:00.000+08:00',
+                endAt: '2025-01-01T10:00:00.000+08:00',
+                endAtResolved: '2025-01-01T10:00:00.000+08:00',
+                endAtSource: 'fact',
+            },
+            {
+                kind: 'fixed',
+                startAt: '2025-01-02T08:00:00.000+08:00',
+                endAt: '2025-01-02T10:00:00.000+08:00',
+                endAtResolved: '2025-01-02T10:00:00.000+08:00',
+                endAtSource: 'fact',
+            },
+            {
+                kind: 'fixed',
+                startAt: '2025-01-03T08:00:00.000+08:00',
+                endAt: '2025-01-03T10:00:00.000+08:00',
+                endAtResolved: '2025-01-03T10:00:00.000+08:00',
+                endAtSource: 'fact',
+            },
+        ]);
+    });
+    test('sorts normalized recurring periods together with fixed periods', () => {
+        const result = resolvePeriods({
+            periods: [
+                {
+                    kind: 'fixed',
+                    startAt: '2025-01-01T07:00:00+08:00',
+                    endAt: '2025-01-01T07:30:00+08:00',
+                },
+                {
+                    kind: 'recurring',
+                    frequency: 'daily',
+                    startAt: '2025-01-01T00:00:00+08:00',
+                    endAt: '2025-01-02T23:59:59+08:00',
+                    daysOfWeek: null,
+                    timeWindow: {
+                        startAt: '08:00:00',
+                        endAt: '09:00:00',
+                    },
+                    timeZone: 'Asia/Singapore',
+                    excludedDates: null,
+                },
+            ],
+            asOf,
+            mode: { kind: 'operational' },
+        });
+        expect(result.map((period) => period.startAt)).toEqual([
+            '2025-01-01T07:00:00+08:00',
+            '2025-01-01T08:00:00.000+08:00',
+            '2025-01-02T08:00:00.000+08:00',
+        ]);
+        expect(result.every((period) => period.endAtSource === 'fact')).toBe(true);
+    });
+});
+//# sourceMappingURL=resolvePeriods.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolvePeriods.test.js","sourceRoot":"/","sources":["helpers/resolvePeriods.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, test } from 'vitest';\nimport type { Period } from '#schema/issue/period.js';\nimport { resolvePeriods } from './resolvePeriods.js';\n\ndescribe('resolvePeriods', () => {\n  const asOf = '2025-01-01T12:00:00+08:00';\n  const factEndedPeriod: Period[] = [\n    {\n      kind: 'fixed',\n      startAt: '2025-01-01T08:00:00+08:00',\n      endAt: '2025-01-01T09:00:00+08:00',\n    },\n  ];\n\n  test('keeps fact-ended period in all modes', () => {\n    const canonical = resolvePeriods({\n      periods: factEndedPeriod,\n      asOf,\n      mode: { kind: 'canonical' },\n    });\n    const operational = resolvePeriods({\n      periods: factEndedPeriod,\n      asOf,\n      mode: { kind: 'operational' },\n    });\n\n    expect(canonical[0]).toMatchObject({\n      startAt: '2025-01-01T08:00:00+08:00',\n      endAt: '2025-01-01T09:00:00+08:00',\n      endAtResolved: '2025-01-01T09:00:00+08:00',\n      endAtSource: 'fact',\n    });\n    expect(operational[0].endAtSource).toBe('fact');\n  });\n\n  test('open period with no evidence and no crowd remains open', () => {\n    const result = resolvePeriods({\n      periods: [\n        {\n          kind: 'fixed',\n          startAt: '2025-01-01T08:00:00+08:00',\n          endAt: null,\n        },\n      ],\n      asOf,\n      mode: { kind: 'operational' },\n    });\n\n    expect(result[0]).toMatchObject({\n      endAt: null,\n      endAtResolved: null,\n      endAtSource: 'none',\n    });\n  });\n\n  test('open period infers end from evidence timeout only', () => {\n    const result = resolvePeriods({\n      periods: [\n        {\n          kind: 'fixed',\n          startAt: '2025-01-01T08:00:00+08:00',\n          endAt: null,\n        },\n      ],\n      asOf: '2025-01-02T01:00:00+08:00', // Past inferred end-of-day (2025-01-02T00:00)\n      mode: {\n        kind: 'operational',\n        lastEvidenceAt: '2025-01-01T09:00:00+08:00',\n      },\n    });\n\n    expect(result[0]).toMatchObject({\n      endAtResolved: '2025-01-02T00:00:00.000+08:00',\n      endAtSource: 'inferred',\n      endAtReason: 'evidence_timeout',\n    });\n  });\n\n  test('crowd exited inference wins over evidence timeout', () => {\n    const result = resolvePeriods({\n      periods: [\n        {\n          kind: 'fixed',\n          startAt: '2025-01-01T08:00:00+08:00',\n          endAt: null,\n        },\n      ],\n      asOf: '2025-01-02T01:00:00+08:00', // Past inferred end-of-day (2025-01-02T00:00)\n      mode: {\n        kind: 'operational',\n        lastEvidenceAt: '2025-01-01T09:00:00+08:00',\n        crowd: {\n          activeNow: false,\n          exitedAt: '2025-01-01T10:15:00+08:00',\n        },\n      },\n    });\n\n    expect(result[0]).toMatchObject({\n      endAtResolved: '2025-01-02T00:00:00.000+08:00',\n      endAtSource: 'inferred',\n      endAtReason: 'crowd_decay',\n    });\n  });\n\n  test('crowd.activeNow=true prevents crowd-based inference fallback', () => {\n    const result = resolvePeriods({\n      periods: [\n        {\n          kind: 'fixed',\n          startAt: '2025-01-01T08:00:00+08:00',\n          endAt: null,\n        },\n      ],\n      asOf,\n      mode: {\n        kind: 'operational',\n        crowd: {\n          activeNow: true,\n          lastActiveAt: '2025-01-01T09:30:00+08:00',\n        },\n      },\n    });\n\n    expect(result[0]).toMatchObject({\n      endAtResolved: null,\n      endAtSource: 'none',\n    });\n  });\n\n  test('clamps inferred end to maxInferredDurationMinutes', () => {\n    const result = resolvePeriods({\n      periods: [\n        {\n          kind: 'fixed',\n          startAt: '2025-01-01T08:00:00+08:00',\n          endAt: null,\n        },\n      ],\n      asOf: '2025-01-02T13:00:00+08:00',\n      mode: {\n        kind: 'operational',\n        lastEvidenceAt: '2025-01-02T10:00:00+08:00',\n        config: {\n          maxInferredDurationMinutes: 60,\n        },\n      },\n    });\n\n    expect(result[0]).toMatchObject({\n      endAtResolved: '2025-01-01T09:00:00.000+08:00',\n      endAtSource: 'inferred',\n      endAtReason: 'evidence_timeout',\n    });\n  });\n\n  test('does not close period when inferred end is later than asOf', () => {\n    const result = resolvePeriods({\n      periods: [\n        {\n          kind: 'fixed',\n          startAt: '2025-01-01T08:00:00+08:00',\n          endAt: null,\n        },\n      ],\n      asOf: '2025-01-01T10:00:00+08:00',\n      mode: {\n        kind: 'operational',\n        lastEvidenceAt: '2025-01-01T09:30:00+08:00',\n      },\n    });\n\n    expect(result[0]).toMatchObject({\n      endAtResolved: null,\n      endAtSource: 'none',\n    });\n  });\n\n  test('expands recurring periods into fixed periods in canonical mode', () => {\n    const result = resolvePeriods({\n      periods: [\n        {\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        },\n      ],\n      asOf,\n      mode: { kind: 'canonical' },\n    });\n\n    expect(result).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        endAtResolved: '2025-01-01T10:00:00.000+08:00',\n        endAtSource: 'fact',\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        endAtResolved: '2025-01-02T10:00:00.000+08:00',\n        endAtSource: 'fact',\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        endAtResolved: '2025-01-03T10:00:00.000+08:00',\n        endAtSource: 'fact',\n      },\n    ]);\n  });\n\n  test('sorts normalized recurring periods together with fixed periods', () => {\n    const result = resolvePeriods({\n      periods: [\n        {\n          kind: 'fixed',\n          startAt: '2025-01-01T07:00:00+08:00',\n          endAt: '2025-01-01T07:30:00+08:00',\n        },\n        {\n          kind: 'recurring',\n          frequency: 'daily',\n          startAt: '2025-01-01T00:00:00+08:00',\n          endAt: '2025-01-02T23:59:59+08:00',\n          daysOfWeek: null,\n          timeWindow: {\n            startAt: '08:00:00',\n            endAt: '09:00:00',\n          },\n          timeZone: 'Asia/Singapore',\n          excludedDates: null,\n        },\n      ],\n      asOf,\n      mode: { kind: 'operational' },\n    });\n\n    expect(result.map((period) => period.startAt)).toEqual([\n      '2025-01-01T07:00:00+08:00',\n      '2025-01-01T08:00:00.000+08:00',\n      '2025-01-02T08:00:00.000+08:00',\n    ]);\n    expect(result.every((period) => period.endAtSource === 'fact')).toBe(true);\n  });\n});\n"]}

package/dist/helpers/splitIntervalByServiceHours.d.ts

@@ -0,0 +1,2 @@
+import { type Interval } from 'luxon';
+export declare function splitIntervalByServiceHours(interval: Interval): Interval[];

package/dist/helpers/splitIntervalByServiceHours.js

@@ -0,0 +1,30 @@
+import { DateTime } from 'luxon';
+import { computeStartOfDaysWithinInterval } from './computeStartOfDaysWithinInterval.js';
+import { assert } from '../util/assert.js';
+export function splitIntervalByServiceHours(interval) {
+    assert(interval.start != null);
+    assert(interval.end != null);
+    const startOfDaysWithinRange = computeStartOfDaysWithinInterval(interval.start, interval.end);
+    const segments = [];
+    for (const segment of interval.splitAt(...startOfDaysWithinRange)) {
+        const { start, end } = segment;
+        assert(start != null);
+        assert(end != null);
+        const segmentStart = DateTime.max(start, start.set({ hour: 5, minute: 30, second: 0, millisecond: 0 }));
+        const segmentEnd = DateTime.max(end, segmentStart);
+        const segmentDuration = segmentEnd.diff(segmentStart);
+        if (segmentDuration.as('milliseconds') <= 0) {
+            continue;
+        }
+        const segmentUpdated = segment.set({
+            start: segmentStart,
+            end: segmentEnd,
+        });
+        if (!segmentUpdated.isValid) {
+            continue;
+        }
+        segments.push(segmentUpdated);
+    }
+    return segments;
+}
+//# sourceMappingURL=splitIntervalByServiceHours.js.map

package/dist/helpers/splitIntervalByServiceHours.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"splitIntervalByServiceHours.js","sourceRoot":"/","sources":["helpers/splitIntervalByServiceHours.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAiB,MAAM,OAAO,CAAC;AAChD,OAAO,EAAE,gCAAgC,EAAE,MAAM,uCAAuC,CAAC;AACzF,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,UAAU,2BAA2B,CAAC,QAAkB;IAC5D,MAAM,CAAC,QAAQ,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;IAC/B,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;IAE7B,MAAM,sBAAsB,GAAG,gCAAgC,CAC7D,QAAQ,CAAC,KAAK,EACd,QAAQ,CAAC,GAAG,CACb,CAAC;IAEF,MAAM,QAAQ,GAAe,EAAE,CAAC;IAEhC,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,sBAAsB,CAAC,EAAE,CAAC;QAClE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;QAC/B,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;QACtB,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;QAEpB,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAC/B,KAAK,EACL,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAC9D,CAAC;QACF,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QACnD,MAAM,eAAe,GAAG,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAEtD,IAAI,eAAe,CAAC,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5C,SAAS;QACX,CAAC;QAED,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC;YACjC,KAAK,EAAE,YAAY;YACnB,GAAG,EAAE,UAAU;SAChB,CAAC,CAAC;QAEH,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;YAC5B,SAAS;QACX,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["import { DateTime, type Interval } from 'luxon';\nimport { computeStartOfDaysWithinInterval } from './computeStartOfDaysWithinInterval.js';\nimport { assert } from '../util/assert.js';\n\nexport function splitIntervalByServiceHours(interval: Interval): Interval[] {\n  assert(interval.start != null);\n  assert(interval.end != null);\n\n  const startOfDaysWithinRange = computeStartOfDaysWithinInterval(\n    interval.start,\n    interval.end,\n  );\n\n  const segments: Interval[] = [];\n\n  for (const segment of interval.splitAt(...startOfDaysWithinRange)) {\n    const { start, end } = segment;\n    assert(start != null);\n    assert(end != null);\n\n    const segmentStart = DateTime.max(\n      start,\n      start.set({ hour: 5, minute: 30, second: 0, millisecond: 0 }), // Limit to start of general service hours\n    );\n    const segmentEnd = DateTime.max(end, segmentStart);\n    const segmentDuration = segmentEnd.diff(segmentStart);\n\n    if (segmentDuration.as('milliseconds') <= 0) {\n      continue;\n    }\n\n    const segmentUpdated = segment.set({\n      start: segmentStart,\n      end: segmentEnd,\n    });\n\n    if (!segmentUpdated.isValid) {\n      continue;\n    }\n\n    segments.push(segmentUpdated);\n  }\n\n  return segments;\n}\n"]}

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

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

package/dist/helpers/splitIntervalByServiceHours.test.js

@@ -0,0 +1,152 @@
+import { describe, expect, test } from 'vitest';
+import { DateTime, Interval } from 'luxon';
+import { splitIntervalByServiceHours } from './splitIntervalByServiceHours.js';
+describe('splitIntervalByServiceHours', () => {
+    test('single day, within service hours', () => {
+        expect(splitIntervalByServiceHours(Interval.fromDateTimes(DateTime.fromObject({
+            day: 1,
+            month: 4,
+            year: 2025,
+            hour: 8,
+            minute: 0,
+        }), DateTime.fromObject({
+            day: 1,
+            month: 4,
+            year: 2025,
+            hour: 12,
+            minute: 30,
+        })))).toEqual([
+            Interval.fromDateTimes(DateTime.fromObject({
+                day: 1,
+                month: 4,
+                year: 2025,
+                hour: 8,
+                minute: 0,
+            }), DateTime.fromObject({
+                day: 1,
+                month: 4,
+                year: 2025,
+                hour: 12,
+                minute: 30,
+            })),
+        ]);
+    });
+    describe('transcends service hour boundaries', () => {
+        test('single day, starts before service hours', () => {
+            expect(splitIntervalByServiceHours(Interval.fromDateTimes(DateTime.fromObject({
+                day: 1,
+                month: 4,
+                year: 2025,
+                hour: 5,
+                minute: 0,
+            }), DateTime.fromObject({
+                day: 1,
+                month: 4,
+                year: 2025,
+                hour: 6,
+                minute: 0,
+            })))).toEqual([
+                Interval.fromDateTimes(DateTime.fromObject({
+                    day: 1,
+                    month: 4,
+                    year: 2025,
+                    hour: 5,
+                    minute: 30,
+                }), DateTime.fromObject({
+                    day: 1,
+                    month: 4,
+                    year: 2025,
+                    hour: 6,
+                    minute: 0,
+                })),
+            ]);
+        });
+        test('single day, ends after service hours', () => {
+            expect(splitIntervalByServiceHours(Interval.fromDateTimes(DateTime.fromObject({
+                day: 1,
+                month: 4,
+                year: 2025,
+                hour: 18,
+                minute: 0,
+            }), DateTime.fromObject({
+                day: 2,
+                month: 4,
+                year: 2025,
+                hour: 1,
+                minute: 0,
+            })))).toEqual([
+                Interval.fromDateTimes(DateTime.fromObject({
+                    day: 1,
+                    month: 4,
+                    year: 2025,
+                    hour: 18,
+                    minute: 0,
+                }), DateTime.fromObject({
+                    day: 2,
+                    month: 4,
+                    year: 2025,
+                    hour: 0,
+                    minute: 0,
+                })),
+            ]);
+        });
+        test('multiple days, transcends multiple service hours/non services hour ranges', () => {
+            expect(splitIntervalByServiceHours(Interval.fromDateTimes(DateTime.fromObject({
+                day: 1,
+                month: 4,
+                year: 2025,
+                hour: 18,
+                minute: 0,
+            }), DateTime.fromObject({
+                day: 2,
+                month: 4,
+                year: 2025,
+                hour: 18,
+                minute: 0,
+            })))).toEqual([
+                Interval.fromDateTimes(DateTime.fromObject({
+                    day: 1,
+                    month: 4,
+                    year: 2025,
+                    hour: 18,
+                    minute: 0,
+                }), DateTime.fromObject({
+                    day: 2,
+                    month: 4,
+                    year: 2025,
+                    hour: 0,
+                    minute: 0,
+                })),
+                Interval.fromDateTimes(DateTime.fromObject({
+                    day: 2,
+                    month: 4,
+                    year: 2025,
+                    hour: 5,
+                    minute: 30,
+                }), DateTime.fromObject({
+                    day: 2,
+                    month: 4,
+                    year: 2025,
+                    hour: 18,
+                    minute: 0,
+                })),
+            ]);
+        });
+    });
+    test('outside service hours', () => {
+        expect(splitIntervalByServiceHours(Interval.fromDateTimes(DateTime.fromObject({
+            day: 1,
+            month: 4,
+            year: 2025,
+            hour: 3,
+            minute: 0,
+        }), DateTime.fromObject({
+            day: 1,
+            month: 4,
+            year: 2025,
+            hour: 4,
+            minute: 30,
+        })))).toEqual([]);
+    });
+});
+//# sourceMappingURL=splitIntervalByServiceHours.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"splitIntervalByServiceHours.test.js","sourceRoot":"/","sources":["helpers/splitIntervalByServiceHours.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, test } from 'vitest';\nimport { DateTime, Interval } from 'luxon';\nimport { splitIntervalByServiceHours } from './splitIntervalByServiceHours.js';\n\ndescribe('splitIntervalByServiceHours', () => {\n  test('single day, within service hours', () => {\n    expect(\n      splitIntervalByServiceHours(\n        Interval.fromDateTimes(\n          DateTime.fromObject({\n            day: 1,\n            month: 4,\n            year: 2025,\n            hour: 8,\n            minute: 0,\n          }),\n          DateTime.fromObject({\n            day: 1,\n            month: 4,\n            year: 2025,\n            hour: 12,\n            minute: 30,\n          }),\n        ),\n      ),\n    ).toEqual([\n      Interval.fromDateTimes(\n        DateTime.fromObject({\n          day: 1,\n          month: 4,\n          year: 2025,\n          hour: 8,\n          minute: 0,\n        }),\n        DateTime.fromObject({\n          day: 1,\n          month: 4,\n          year: 2025,\n          hour: 12,\n          minute: 30,\n        }),\n      ),\n    ] satisfies Interval[]);\n  });\n  describe('transcends service hour boundaries', () => {\n    test('single day, starts before service hours', () => {\n      expect(\n        splitIntervalByServiceHours(\n          Interval.fromDateTimes(\n            DateTime.fromObject({\n              day: 1,\n              month: 4,\n              year: 2025,\n              hour: 5,\n              minute: 0,\n            }),\n            DateTime.fromObject({\n              day: 1,\n              month: 4,\n              year: 2025,\n              hour: 6,\n              minute: 0,\n            }),\n          ),\n        ),\n      ).toEqual([\n        Interval.fromDateTimes(\n          DateTime.fromObject({\n            day: 1,\n            month: 4,\n            year: 2025,\n            hour: 5,\n            minute: 30,\n          }),\n          DateTime.fromObject({\n            day: 1,\n            month: 4,\n            year: 2025,\n            hour: 6,\n            minute: 0,\n          }),\n        ),\n      ] satisfies Interval[]);\n    });\n    test('single day, ends after service hours', () => {\n      expect(\n        splitIntervalByServiceHours(\n          Interval.fromDateTimes(\n            DateTime.fromObject({\n              day: 1,\n              month: 4,\n              year: 2025,\n              hour: 18,\n              minute: 0,\n            }),\n            DateTime.fromObject({\n              day: 2,\n              month: 4,\n              year: 2025,\n              hour: 1,\n              minute: 0,\n            }),\n          ),\n        ),\n      ).toEqual([\n        Interval.fromDateTimes(\n          DateTime.fromObject({\n            day: 1,\n            month: 4,\n            year: 2025,\n            hour: 18,\n            minute: 0,\n          }),\n          DateTime.fromObject({\n            day: 2,\n            month: 4,\n            year: 2025,\n            hour: 0,\n            minute: 0,\n          }),\n        ),\n      ] satisfies Interval[]);\n    });\n    test('multiple days, transcends multiple service hours/non services hour ranges', () => {\n      expect(\n        splitIntervalByServiceHours(\n          Interval.fromDateTimes(\n            DateTime.fromObject({\n              day: 1,\n              month: 4,\n              year: 2025,\n              hour: 18,\n              minute: 0,\n            }),\n            DateTime.fromObject({\n              day: 2,\n              month: 4,\n              year: 2025,\n              hour: 18,\n              minute: 0,\n            }),\n          ),\n        ),\n      ).toEqual([\n        Interval.fromDateTimes(\n          DateTime.fromObject({\n            day: 1,\n            month: 4,\n            year: 2025,\n            hour: 18,\n            minute: 0,\n          }),\n          DateTime.fromObject({\n            day: 2,\n            month: 4,\n            year: 2025,\n            hour: 0,\n            minute: 0,\n          }),\n        ),\n        Interval.fromDateTimes(\n          DateTime.fromObject({\n            day: 2,\n            month: 4,\n            year: 2025,\n            hour: 5,\n            minute: 30,\n          }),\n          DateTime.fromObject({\n            day: 2,\n            month: 4,\n            year: 2025,\n            hour: 18,\n            minute: 0,\n          }),\n        ),\n      ] satisfies Interval[]);\n    });\n  });\n  test('outside service hours', () => {\n    expect(\n      splitIntervalByServiceHours(\n        Interval.fromDateTimes(\n          DateTime.fromObject({\n            day: 1,\n            month: 4,\n            year: 2025,\n            hour: 3,\n            minute: 0,\n          }),\n          DateTime.fromObject({\n            day: 1,\n            month: 4,\n            year: 2025,\n            hour: 4,\n            minute: 30,\n          }),\n        ),\n      ),\n    ).toEqual([] satisfies Interval[]);\n  });\n});\n"]}

package/dist/helpers/sumIntervalDuration.d.ts

@@ -0,0 +1,2 @@
+import { Duration, type Interval } from 'luxon';
+export declare function sumIntervalDuration(intervals: Interval[]): Duration<true>;

package/dist/helpers/sumIntervalDuration.js

@@ -0,0 +1,9 @@
+import { Duration } from 'luxon';
+export function sumIntervalDuration(intervals) {
+    let duration = Duration.fromObject({ milliseconds: 0 });
+    for (const segment of intervals) {
+        duration = duration.plus(segment.toDuration());
+    }
+    return duration;
+}
+//# sourceMappingURL=sumIntervalDuration.js.map

package/dist/helpers/sumIntervalDuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sumIntervalDuration.js","sourceRoot":"/","sources":["helpers/sumIntervalDuration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAiB,MAAM,OAAO,CAAC;AAEhD,MAAM,UAAU,mBAAmB,CAAC,SAAqB;IACvD,IAAI,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC;IACxD,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;QAChC,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["import { Duration, type Interval } from 'luxon';\n\nexport function sumIntervalDuration(intervals: Interval[]) {\n  let duration = Duration.fromObject({ milliseconds: 0 });\n  for (const segment of intervals) {\n    duration = duration.plus(segment.toDuration());\n  }\n  return duration;\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export { FileStore } from '#repo/common/FileStore.js';
+export { MRTDownRepository } from '#repo/MRTDownRepository.js';
+export { type IssueBundle, IssueBundleSchema, } from '#schema/issue/bundle.js';
+export { type CauseDisruption, CauseDisruptionSchema, type CauseInfra, CauseInfraSchema, type CauseMaintenance, CauseMaintenanceSchema, type CauseSubtype, CauseSubtypeSchema, } from '#schema/issue/cause.js';
+export { type AffectedEntity, type AffectedEntityFacility, AffectedEntityFacilitySchema, AffectedEntitySchema, type AffectedEntityService, AffectedEntityServiceSchema, type EntityImpactState, EntityImpactStateSchema, } from '#schema/issue/entity.js';
+export { type Evidence, EvidenceSchema, } from '#schema/issue/evidence.js';
+export { type FacilityEffect, FacilityEffectSchema, } from '#schema/issue/facilityEffect.js';
+export { type ImpactEvent, ImpactEventSchema, } from '#schema/issue/impactEvent.js';
+export { type Issue, IssueSchema } from '#schema/issue/issue.js';
+export { type IssueType, IssueTypeSchema, } from '#schema/issue/issueType.js';
+export { type Period, PeriodSchema, } from '#schema/issue/period.js';
+export { type ServiceEffect, ServiceEffectSchema, } from '#schema/issue/serviceEffect.js';
+export { type ServiceScope, ServiceScopeSchema, } from '#schema/issue/serviceScope.js';
+export { FileWriteStore } from '#write/common/FileWriteStore.js';
+export { IdGenerator } from '#write/id/IdGenerator.js';
+export { MRTDownWriter } from '#write/MRTDownWriter.js';
+export { normalizeRecurringPeriod } from './helpers/normalizeRecurringPeriod.js';
+export { resolvePeriods } from './helpers/resolvePeriods.js';

package/dist/index.js

@@ -0,0 +1,19 @@
+export { FileStore } from '#repo/common/FileStore.js';
+export { MRTDownRepository } from '#repo/MRTDownRepository.js';
+export { IssueBundleSchema, } from '#schema/issue/bundle.js';
+export { CauseDisruptionSchema, CauseInfraSchema, CauseMaintenanceSchema, CauseSubtypeSchema, } from '#schema/issue/cause.js';
+export { AffectedEntityFacilitySchema, AffectedEntitySchema, AffectedEntityServiceSchema, EntityImpactStateSchema, } from '#schema/issue/entity.js';
+export { EvidenceSchema, } from '#schema/issue/evidence.js';
+export { FacilityEffectSchema, } from '#schema/issue/facilityEffect.js';
+export { ImpactEventSchema, } from '#schema/issue/impactEvent.js';
+export { IssueSchema } from '#schema/issue/issue.js';
+export { IssueTypeSchema, } from '#schema/issue/issueType.js';
+export { PeriodSchema, } from '#schema/issue/period.js';
+export { ServiceEffectSchema, } from '#schema/issue/serviceEffect.js';
+export { ServiceScopeSchema, } from '#schema/issue/serviceScope.js';
+export { FileWriteStore } from '#write/common/FileWriteStore.js';
+export { IdGenerator } from '#write/id/IdGenerator.js';
+export { MRTDownWriter } from '#write/MRTDownWriter.js';
+export { normalizeRecurringPeriod } from './helpers/normalizeRecurringPeriod.js';
+export { resolvePeriods } from './helpers/resolvePeriods.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"/","sources":["index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAEL,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,qBAAqB,EAErB,gBAAgB,EAEhB,sBAAsB,EAEtB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAGL,4BAA4B,EAC5B,oBAAoB,EAEpB,2BAA2B,EAE3B,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,cAAc,GACf,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAEL,oBAAoB,GACrB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAEL,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAc,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAEL,eAAe,GAChB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,YAAY,GACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,mBAAmB,GACpB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAEL,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC","sourcesContent":["export { FileStore } from '#repo/common/FileStore.js';\nexport { MRTDownRepository } from '#repo/MRTDownRepository.js';\nexport {\n  type IssueBundle,\n  IssueBundleSchema,\n} from '#schema/issue/bundle.js';\nexport {\n  type CauseDisruption,\n  CauseDisruptionSchema,\n  type CauseInfra,\n  CauseInfraSchema,\n  type CauseMaintenance,\n  CauseMaintenanceSchema,\n  type CauseSubtype,\n  CauseSubtypeSchema,\n} from '#schema/issue/cause.js';\nexport {\n  type AffectedEntity,\n  type AffectedEntityFacility,\n  AffectedEntityFacilitySchema,\n  AffectedEntitySchema,\n  type AffectedEntityService,\n  AffectedEntityServiceSchema,\n  type EntityImpactState,\n  EntityImpactStateSchema,\n} from '#schema/issue/entity.js';\nexport {\n  type Evidence,\n  EvidenceSchema,\n} from '#schema/issue/evidence.js';\nexport {\n  type FacilityEffect,\n  FacilityEffectSchema,\n} from '#schema/issue/facilityEffect.js';\nexport {\n  type ImpactEvent,\n  ImpactEventSchema,\n} from '#schema/issue/impactEvent.js';\nexport { type Issue, IssueSchema } from '#schema/issue/issue.js';\nexport {\n  type IssueType,\n  IssueTypeSchema,\n} from '#schema/issue/issueType.js';\nexport {\n  type Period,\n  PeriodSchema,\n} from '#schema/issue/period.js';\nexport {\n  type ServiceEffect,\n  ServiceEffectSchema,\n} from '#schema/issue/serviceEffect.js';\nexport {\n  type ServiceScope,\n  ServiceScopeSchema,\n} from '#schema/issue/serviceScope.js';\nexport { FileWriteStore } from '#write/common/FileWriteStore.js';\nexport { IdGenerator } from '#write/id/IdGenerator.js';\nexport { MRTDownWriter } from '#write/MRTDownWriter.js';\nexport { normalizeRecurringPeriod } from './helpers/normalizeRecurringPeriod.js';\nexport { resolvePeriods } from './helpers/resolvePeriods.js';\n"]}

package/dist/repo/MRTDownRepository.d.ts

@@ -0,0 +1,23 @@
+import type { IStore } from './common/store.js';
+import { IssueRepository } from './issue/IssueRepository.js';
+import { LandmarkRepository } from './landmark/LandmarkRepository.js';
+import { LineRepository } from './line/LineRepository.js';
+import { OperatorRepository } from './operator/OperatorRepository.js';
+import { ServiceRepository } from './service/ServiceRepository.js';
+import { StationRepository } from './station/StationRepository.js';
+import { TownRepository } from './town/TownRepository.js';
+interface MRTDownRepositoryOptions {
+    store: IStore;
+}
+export declare class MRTDownRepository {
+    private readonly store;
+    readonly stations: StationRepository;
+    readonly towns: TownRepository;
+    readonly landmarks: LandmarkRepository;
+    readonly lines: LineRepository;
+    readonly operators: OperatorRepository;
+    readonly services: ServiceRepository;
+    readonly issues: IssueRepository;
+    constructor(options: MRTDownRepositoryOptions);
+}
+export {};

package/dist/repo/MRTDownRepository.js

@@ -0,0 +1,28 @@
+import { IssueRepository } from './issue/IssueRepository.js';
+import { LandmarkRepository } from './landmark/LandmarkRepository.js';
+import { LineRepository } from './line/LineRepository.js';
+import { OperatorRepository } from './operator/OperatorRepository.js';
+import { ServiceRepository } from './service/ServiceRepository.js';
+import { StationRepository } from './station/StationRepository.js';
+import { TownRepository } from './town/TownRepository.js';
+export class MRTDownRepository {
+    store;
+    stations;
+    towns;
+    landmarks;
+    lines;
+    operators;
+    services;
+    issues;
+    constructor(options) {
+        this.store = options.store;
+        this.stations = new StationRepository(this.store);
+        this.towns = new TownRepository(this.store);
+        this.landmarks = new LandmarkRepository(this.store);
+        this.lines = new LineRepository(this.store);
+        this.operators = new OperatorRepository(this.store);
+        this.services = new ServiceRepository(this.store);
+        this.issues = new IssueRepository(this.store);
+    }
+}
+//# sourceMappingURL=MRTDownRepository.js.map

package/dist/repo/MRTDownRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MRTDownRepository.js","sourceRoot":"/","sources":["repo/MRTDownRepository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAM1D,MAAM,OAAO,iBAAiB;IACX,KAAK,CAAS;IAEtB,QAAQ,CAAoB;IAC5B,KAAK,CAAiB;IACtB,SAAS,CAAqB;IAC9B,KAAK,CAAiB;IACtB,SAAS,CAAqB;IAC9B,QAAQ,CAAoB;IAC5B,MAAM,CAAkB;IAEjC,YAAY,OAAiC;QAC3C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,CAAC,KAAK,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;CACF","sourcesContent":["import type { IStore } from './common/store.js';\nimport { IssueRepository } from './issue/IssueRepository.js';\nimport { LandmarkRepository } from './landmark/LandmarkRepository.js';\nimport { LineRepository } from './line/LineRepository.js';\nimport { OperatorRepository } from './operator/OperatorRepository.js';\nimport { ServiceRepository } from './service/ServiceRepository.js';\nimport { StationRepository } from './station/StationRepository.js';\nimport { TownRepository } from './town/TownRepository.js';\n\ninterface MRTDownRepositoryOptions {\n  store: IStore;\n}\n\nexport class MRTDownRepository {\n  private readonly store: IStore;\n\n  readonly stations: StationRepository;\n  readonly towns: TownRepository;\n  readonly landmarks: LandmarkRepository;\n  readonly lines: LineRepository;\n  readonly operators: OperatorRepository;\n  readonly services: ServiceRepository;\n  readonly issues: IssueRepository;\n\n  constructor(options: MRTDownRepositoryOptions) {\n    this.store = options.store;\n    this.stations = new StationRepository(this.store);\n    this.towns = new TownRepository(this.store);\n    this.landmarks = new LandmarkRepository(this.store);\n    this.lines = new LineRepository(this.store);\n    this.operators = new OperatorRepository(this.store);\n    this.services = new ServiceRepository(this.store);\n    this.issues = new IssueRepository(this.store);\n  }\n}\n"]}

package/dist/repo/common/FileStore.d.ts

@@ -0,0 +1,12 @@
+import type { IStore } from './store.js';
+/**
+ * A store for reading and writing files.
+ */
+export declare class FileStore implements IStore {
+    private readonly rootDir;
+    constructor(rootDir: string);
+    readText(path: string): string;
+    readJson<T>(path: string): T;
+    listDir(path: string): string[];
+    exists(path: string): boolean;
+}