@mrtdown/core 2.0.0-alpha.1

package/README.md

@@ -0,0 +1,107 @@
+# mrtdown-data
+
+A comprehensive data repository and API system that tracks Singapore's MRT (Mass Rapid Transit) service disruptions, maintenance, and infrastructure issues. Functions as a status monitoring system for Singapore's public transportation network.
+
+## Tech Stack
+
+- **Backend**: Node.js + TypeScript, Hono API framework
+- **Database**: DuckDB with normalized relational schema
+- **Validation**: Zod schemas with OpenAPI integration
+- **Testing**: Vitest
+- **Linting**: Biome
+
+## Quick Start
+
+```bash
+# Install dependencies
+npm install
+
+# Build and generate database
+npm run build
+
+# Start development API server
+npm run api:dev  # Runs on port 4000
+
+# Run tests
+npm test
+
+# Lint and format
+npx biome check
+```
+
+## Development Commands
+
+### Database Operations
+```bash
+npm run build              # Compile TypeScript (auto-runs db:generate)
+npm run db:generate        # Generate DuckDB database from source data
+```
+
+### API Development
+```bash
+npm run api:dev            # Start dev server on port 4000
+```
+
+### Data Processing
+```bash
+npm run ingest:webhook     # Process incoming webhook data
+```
+
+### Testing & Quality
+```bash
+npm test                   # Run Vitest tests
+npx biome check            # Lint and format code
+```
+
+### Database Queries
+```bash
+# Query the database (use -readonly when API server is running)
+duckdb -readonly -c "SELECT * FROM issues LIMIT 10" mrtdown.duckdb
+```
+
+## Architecture Overview
+
+### Core Data Models
+- **Lines**: MRT/LRT lines (NSL, EWL, CCL, etc.) with service schedules
+- **Issues**: Disruptions, maintenance, infrastructure problems with time intervals
+- **Stations**: Station information with multi-language support
+- **Time-aware**: All operations handle Singapore timezone (`Asia/Singapore`)
+
+### API Structure
+Located in `/src/api/routes/`:
+- **Overview**: System-wide status and line summaries
+- **Lines**: Individual line profiles with detailed uptime metrics
+- **Issues**: Issue details and historical data
+- **Stations**: Station-specific information
+- **Analytics**: Statistical analysis endpoints
+
+All endpoints require Bearer token authentication except `/docs`.
+
+### Data Flow
+1. **Source data** (JSON files in `/data/source/`)
+2. **Database generation** (DuckDB with complex analytics)
+3. **API endpoints** (Real-time queries with multi-language support)
+
+## Key Features
+
+- **Real-time Status Monitoring**: Track MRT line disruptions and maintenance
+- **Historical Analytics**: Complex uptime calculations and service metrics
+- **Multi-language Support**: Content available in 4 languages
+- **Time-zone Aware**: All operations in Singapore timezone
+- **Service Hours Logic**: Different schedules for weekdays/weekends/holidays
+- **Webhook Integration**: Real-time data ingestion capabilities
+
+## Issue Data Structure
+
+- **File naming**: `YYYY-MM-DD-descriptive-slug.json`
+- **Types**: `disruption`, `maintenance`, `infra`
+- **Time intervals**: Start/end timestamps with timezone awareness
+- **Multi-language**: All titles have 4-language translations
+
+## Development Notes
+
+- Database regeneration required when source data changes
+- API responses include related entities for client efficiency
+- Performance optimized for read-heavy analytical workloads
+- Extensive use of CTEs for complex uptime calculations
+- Proper handling of ongoing issues (end_at = NULL)

package/dist/constants.d.ts

@@ -0,0 +1,10 @@
+export declare const DIR_ISSUE = "issue";
+export declare const DIR_LINE = "line";
+export declare const DIR_LANDMARK = "landmark";
+export declare const DIR_OPERATOR = "operator";
+export declare const DIR_SERVICE = "service";
+export declare const DIR_STATION = "station";
+export declare const DIR_TOWN = "town";
+export declare const FILE_ISSUE = "issue.json";
+export declare const FILE_ISSUE_EVIDENCE = "evidence.ndjson";
+export declare const FILE_ISSUE_IMPACT = "impact.ndjson";

package/dist/constants.js

@@ -0,0 +1,11 @@
+export const DIR_ISSUE = 'issue';
+export const DIR_LINE = 'line';
+export const DIR_LANDMARK = 'landmark';
+export const DIR_OPERATOR = 'operator';
+export const DIR_SERVICE = 'service';
+export const DIR_STATION = 'station';
+export const DIR_TOWN = 'town';
+export const FILE_ISSUE = 'issue.json';
+export const FILE_ISSUE_EVIDENCE = 'evidence.ndjson';
+export const FILE_ISSUE_IMPACT = 'impact.ndjson';
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"/","sources":["constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC;AACjC,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC;AAC/B,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;AACvC,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;AACvC,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC;AACrC,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC;AACrC,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE/B,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAC;AACvC,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AACrD,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC","sourcesContent":["export const DIR_ISSUE = 'issue';\nexport const DIR_LINE = 'line';\nexport const DIR_LANDMARK = 'landmark';\nexport const DIR_OPERATOR = 'operator';\nexport const DIR_SERVICE = 'service';\nexport const DIR_STATION = 'station';\nexport const DIR_TOWN = 'town';\n\nexport const FILE_ISSUE = 'issue.json';\nexport const FILE_ISSUE_EVIDENCE = 'evidence.ndjson';\nexport const FILE_ISSUE_IMPACT = 'impact.ndjson';\n"]}

package/dist/helpers/calculateDurationWithinServiceHours.d.ts

@@ -0,0 +1,2 @@
+import { type DateTime, Duration } from 'luxon';
+export declare function calculateDurationWithinServiceHours(start: DateTime, end: DateTime): Duration;

package/dist/helpers/calculateDurationWithinServiceHours.js

@@ -0,0 +1,13 @@
+import { Duration, Interval } from 'luxon';
+import { assert } from '../util/assert.js';
+import { splitIntervalByServiceHours } from './splitIntervalByServiceHours.js';
+export function calculateDurationWithinServiceHours(start, end) {
+    const interval = Interval.fromDateTimes(start, end);
+    assert(interval.isValid);
+    let result = Duration.fromObject({ seconds: 0 });
+    for (const segment of splitIntervalByServiceHours(interval)) {
+        result = result.plus(segment.toDuration());
+    }
+    return result;
+}
+//# sourceMappingURL=calculateDurationWithinServiceHours.js.map

package/dist/helpers/calculateDurationWithinServiceHours.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculateDurationWithinServiceHours.js","sourceRoot":"/","sources":["helpers/calculateDurationWithinServiceHours.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,QAAQ,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAE/E,MAAM,UAAU,mCAAmC,CACjD,KAAe,EACf,GAAa;IAEb,MAAM,QAAQ,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAEzB,IAAI,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IAEjD,KAAK,MAAM,OAAO,IAAI,2BAA2B,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5D,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import { type DateTime, Duration, Interval } from 'luxon';\nimport { assert } from '../util/assert.js';\nimport { splitIntervalByServiceHours } from './splitIntervalByServiceHours.js';\n\nexport function calculateDurationWithinServiceHours(\n  start: DateTime,\n  end: DateTime,\n): Duration {\n  const interval = Interval.fromDateTimes(start, end);\n  assert(interval.isValid);\n\n  let result = Duration.fromObject({ seconds: 0 });\n\n  for (const segment of splitIntervalByServiceHours(interval)) {\n    result = result.plus(segment.toDuration());\n  }\n\n  return result;\n}\n"]}

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

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

package/dist/helpers/calculateDurationWithinServiceHours.test.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"calculateDurationWithinServiceHours.test.js","sourceRoot":"/","sources":["helpers/calculateDurationWithinServiceHours.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, test } from 'vitest';\nimport { calculateDurationWithinServiceHours } from './calculateDurationWithinServiceHours.js';\nimport { DateTime } from 'luxon';\n\ndescribe('calculateDurationWithinServiceHours', () => {\n  test('single day, within service hours', () => {\n    expect(\n      calculateDurationWithinServiceHours(\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      ).as('hours'),\n    ).toEqual(4.5);\n  });\n  describe('transcends service hour boundaries', () => {\n    test('single day, starts before service hours', () => {\n      expect(\n        calculateDurationWithinServiceHours(\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        ).as('hours'),\n      ).toEqual(0.5);\n    });\n    test('single day, ends after service hours', () => {\n      expect(\n        calculateDurationWithinServiceHours(\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        ).as('hours'),\n      ).toEqual(6);\n    });\n    test('multiple days, transcends multiple service hours/non services hour ranges', () => {\n      expect(\n        calculateDurationWithinServiceHours(\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        ).as('hours'),\n      ).toEqual(18.5);\n    });\n  });\n  test('outside service hours', () => {\n    expect(\n      calculateDurationWithinServiceHours(\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      ).as('hours'),\n    ).toEqual(0);\n  });\n});\n"]}

package/dist/helpers/computeImpactFromEvidenceClaims.d.ts

@@ -0,0 +1,21 @@
+import { type IssueBundleState } from '../repo/issue/helpers/deriveCurrentState.js';
+import type { IssueBundle } from '../schema/issue/bundle.js';
+import type { Claim } from '../schema/issue/claim.js';
+import type { ImpactEvent } from '../schema/issue/impactEvent.js';
+type Params = {
+    issueBundle: IssueBundle;
+    evidenceId: string;
+    evidenceTs: string;
+    claims: Claim[];
+};
+type Result = {
+    newState: IssueBundleState;
+    newImpactEvents: ImpactEvent[];
+};
+/**
+ * Compute the impact from the evidence claims.
+ * @param params - The parameters.
+ * @returns The result.
+ */
+export declare function computeImpactFromEvidenceClaims(params: Params): Result;
+export {};

package/dist/helpers/computeImpactFromEvidenceClaims.js

@@ -0,0 +1,293 @@
+import { deepStrictEqual } from 'node:assert';
+import { DateTime } from 'luxon';
+import { deriveCurrentState, } from '../repo/issue/helpers/deriveCurrentState.js';
+import { assert } from '../util/assert.js';
+import { IdGenerator } from '../write/id/IdGenerator.js';
+import { keyForAffectedEntity } from './keyForAffectedEntity.js';
+/**
+ * Compute the impact from the evidence claims.
+ * @param params - The parameters.
+ * @returns The result.
+ */
+export function computeImpactFromEvidenceClaims(params) {
+    const result = {
+        newState: {
+            services: {},
+            servicesProvenance: {},
+            facilities: {},
+            facilitiesProvenance: {},
+            impactEventIds: [],
+        },
+        newImpactEvents: [],
+    };
+    const eventTs = params.evidenceTs;
+    const eventDateTime = DateTime.fromISO(eventTs);
+    assert(eventDateTime.isValid, `Invalid date: ${eventTs}`);
+    const currentState = deriveCurrentState(params.issueBundle);
+    const claimsKeyedByAffectedEntity = Object.fromEntries(params.claims.map((claim) => [keyForAffectedEntity(claim.entity), claim]));
+    for (const [key, claim] of Object.entries(claimsKeyedByAffectedEntity)) {
+        switch (claim.entity.type) {
+            case 'service': {
+                const currentServiceState = currentState.services[key] ?? {
+                    effect: null,
+                    scopes: [],
+                    periods: [],
+                    causes: [],
+                };
+                const currentServiceProvenance = currentState.servicesProvenance[key] ?? {};
+                if (claim.effect?.service != null &&
+                    !isEqual(currentServiceState.effect, claim.effect.service)) {
+                    currentServiceState.effect = claim.effect.service;
+                    currentServiceProvenance.effect = {
+                        evidenceId: params.evidenceId,
+                    };
+                    result.newImpactEvents.push({
+                        id: IdGenerator.impactEventId(eventDateTime),
+                        type: 'service_effects.set',
+                        ts: eventTs,
+                        basis: { evidenceId: params.evidenceId },
+                        entity: claim.entity,
+                        effect: claim.effect.service,
+                    });
+                }
+                switch (params.issueBundle.issue.type) {
+                    case 'disruption': {
+                        const isCleared = currentServiceState.periods.every((period) => period.kind === 'fixed' && period.endAt != null);
+                        let currentStatus = 'open';
+                        if (isCleared) {
+                            currentStatus = 'cleared';
+                        }
+                        if (currentStatus !== claim.statusSignal) {
+                            switch (claim.statusSignal) {
+                                case 'open': {
+                                    break;
+                                }
+                                case 'cleared': {
+                                    break;
+                                }
+                            }
+                        }
+                        break;
+                    }
+                }
+                if (claim.timeHints != null) {
+                    const { newPeriods, hasChanged } = reconcilePeriodsWithTimeHints(currentServiceState.periods, claim.timeHints);
+                    if (hasChanged) {
+                        currentServiceState.periods = newPeriods;
+                        currentServiceProvenance.periods = {
+                            evidenceId: params.evidenceId,
+                        };
+                        result.newImpactEvents.push({
+                            id: IdGenerator.impactEventId(eventDateTime),
+                            type: 'periods.set',
+                            ts: eventTs,
+                            basis: { evidenceId: params.evidenceId },
+                            entity: claim.entity,
+                            periods: currentServiceState.periods,
+                        });
+                    }
+                }
+                if (claim.scopes?.service != null &&
+                    !isEqual(currentServiceState.scopes, claim.scopes.service)) {
+                    currentServiceState.scopes = claim.scopes.service;
+                    currentServiceProvenance.scopes = {
+                        evidenceId: params.evidenceId,
+                    };
+                    result.newImpactEvents.push({
+                        id: IdGenerator.impactEventId(eventDateTime),
+                        type: 'service_scopes.set',
+                        ts: eventTs,
+                        basis: { evidenceId: params.evidenceId },
+                        entity: claim.entity,
+                        serviceScopes: claim.scopes.service,
+                    });
+                }
+                if (claim.causes != null &&
+                    !isEqual(currentServiceState.causes, claim.causes)) {
+                    currentServiceState.causes = claim.causes;
+                    currentServiceProvenance.causes = {
+                        evidenceId: params.evidenceId,
+                    };
+                    result.newImpactEvents.push({
+                        id: IdGenerator.impactEventId(eventDateTime),
+                        type: 'causes.set',
+                        ts: eventTs,
+                        basis: { evidenceId: params.evidenceId },
+                        entity: claim.entity,
+                        causes: claim.causes,
+                    });
+                }
+                result.newState.services[key] = currentServiceState;
+                result.newState.servicesProvenance[key] = currentServiceProvenance;
+                break;
+            }
+            case 'facility': {
+                const currentFacilityState = currentState.facilities[key] ?? {
+                    effect: null,
+                    periods: [],
+                };
+                const currentFacilityProvenance = currentState.facilitiesProvenance[key] ?? {};
+                if (claim.effect?.facility != null &&
+                    !isEqual(currentFacilityState.effect, claim.effect.facility)) {
+                    currentFacilityState.effect = claim.effect.facility;
+                    currentFacilityProvenance.effect = {
+                        evidenceId: params.evidenceId,
+                    };
+                    result.newImpactEvents.push({
+                        id: IdGenerator.impactEventId(eventDateTime),
+                        type: 'facility_effects.set',
+                        ts: eventTs,
+                        basis: { evidenceId: params.evidenceId },
+                        entity: claim.entity,
+                        effect: claim.effect.facility,
+                    });
+                }
+                if (claim.timeHints != null) {
+                    const { newPeriods, hasChanged } = reconcilePeriodsWithTimeHints(currentFacilityState.periods, claim.timeHints);
+                    if (hasChanged) {
+                        currentFacilityState.periods = newPeriods;
+                        currentFacilityProvenance.periods = {
+                            evidenceId: params.evidenceId,
+                        };
+                        result.newImpactEvents.push({
+                            id: IdGenerator.impactEventId(eventDateTime),
+                            type: 'periods.set',
+                            ts: eventTs,
+                            basis: { evidenceId: params.evidenceId },
+                            entity: claim.entity,
+                            periods: currentFacilityState.periods,
+                        });
+                    }
+                }
+                if (claim.causes != null &&
+                    !isEqual(currentFacilityState.causes, claim.causes)) {
+                    currentFacilityState.causes = claim.causes;
+                    currentFacilityProvenance.causes = {
+                        evidenceId: params.evidenceId,
+                    };
+                    result.newImpactEvents.push({
+                        id: IdGenerator.impactEventId(eventDateTime),
+                        type: 'causes.set',
+                        ts: eventTs,
+                        basis: { evidenceId: params.evidenceId },
+                        entity: claim.entity,
+                        causes: claim.causes,
+                    });
+                }
+                result.newState.facilities[key] = currentFacilityState;
+                result.newState.facilitiesProvenance[key] = currentFacilityProvenance;
+                break;
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Reconcile the periods with the time hints.
+ * @param currentPeriods - The current periods.
+ * @param timeHints - The time hints.
+ * @returns The new periods and whether the periods have changed.
+ */
+function reconcilePeriodsWithTimeHints(currentPeriods, timeHints) {
+    switch (timeHints.kind) {
+        case 'fixed': {
+            return {
+                newPeriods: [timeHints],
+                hasChanged: true,
+            };
+        }
+        case 'recurring': {
+            return {
+                newPeriods: [timeHints],
+                hasChanged: true,
+            };
+        }
+        case 'start-only': {
+            let hasChanged = false;
+            const newPeriods = [];
+            if (currentPeriods.length === 0) {
+                newPeriods.push({
+                    kind: 'fixed',
+                    startAt: timeHints.startAt,
+                    endAt: null,
+                });
+                hasChanged = true;
+                return { newPeriods, hasChanged };
+            }
+            for (const period of currentPeriods) {
+                switch (period.kind) {
+                    case 'fixed': {
+                        newPeriods.push({
+                            ...period,
+                            startAt: timeHints.startAt,
+                        });
+                        hasChanged = true;
+                        break;
+                    }
+                    case 'recurring': {
+                        const newPeriod = {
+                            ...period,
+                            startAt: timeHints.startAt,
+                        };
+                        if (newPeriod.timeWindow != null) {
+                            const startAt = DateTime.fromISO(timeHints.startAt);
+                            assert(startAt.isValid);
+                            newPeriod.timeWindow.startAt = startAt.toFormat('HH:mm:ss');
+                        }
+                        newPeriods.push(newPeriod);
+                        hasChanged = true;
+                        break;
+                    }
+                }
+            }
+            return {
+                newPeriods,
+                hasChanged,
+            };
+        }
+        case 'end-only': {
+            let hasChanged = false;
+            const newPeriods = [];
+            for (const period of currentPeriods) {
+                switch (period.kind) {
+                    case 'fixed': {
+                        newPeriods.push({
+                            ...period,
+                            endAt: timeHints.endAt,
+                        });
+                        hasChanged = true;
+                        break;
+                    }
+                    case 'recurring': {
+                        const newPeriod = {
+                            ...period,
+                            endAt: timeHints.endAt,
+                        };
+                        if (newPeriod.timeWindow != null) {
+                            const endAt = DateTime.fromISO(timeHints.endAt);
+                            assert(endAt.isValid);
+                            newPeriod.timeWindow.endAt = endAt.toFormat('HH:mm:ss');
+                        }
+                        newPeriods.push(newPeriod);
+                        hasChanged = true;
+                        break;
+                    }
+                }
+            }
+            return {
+                newPeriods,
+                hasChanged,
+            };
+        }
+    }
+}
+function isEqual(a, b) {
+    try {
+        deepStrictEqual(a, b);
+        return true;
+    }
+    catch (error) {
+        return false;
+    }
+}
+//# sourceMappingURL=computeImpactFromEvidenceClaims.js.map

package/dist/helpers/computeImpactFromEvidenceClaims.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeImpactFromEvidenceClaims.js","sourceRoot":"/","sources":["helpers/computeImpactFromEvidenceClaims.ts"],"names":[],"mappings":"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","sourcesContent":["import { deepStrictEqual } from 'node:assert';\nimport { DateTime } from 'luxon';\nimport {\n  deriveCurrentState,\n  type IssueBundleState,\n} from '../repo/issue/helpers/deriveCurrentState.js';\nimport type { IssueBundle } from '../schema/issue/bundle.js';\nimport type {\n  Claim,\n  ClaimStatusSignal,\n  ClaimTimeHints,\n} from '../schema/issue/claim.js';\nimport type { ImpactEvent } from '../schema/issue/impactEvent.js';\nimport type { Period } from '../schema/issue/period.js';\nimport { assert } from '../util/assert.js';\nimport { IdGenerator } from '../write/id/IdGenerator.js';\nimport { keyForAffectedEntity } from './keyForAffectedEntity.js';\n\ntype Params = {\n  issueBundle: IssueBundle;\n  evidenceId: string;\n  evidenceTs: string;\n  claims: Claim[];\n};\n\ntype Result = {\n  newState: IssueBundleState;\n  newImpactEvents: ImpactEvent[];\n};\n\n/**\n * Compute the impact from the evidence claims.\n * @param params - The parameters.\n * @returns The result.\n */\nexport function computeImpactFromEvidenceClaims(params: Params): Result {\n  const result: Result = {\n    newState: {\n      services: {},\n      servicesProvenance: {},\n      facilities: {},\n      facilitiesProvenance: {},\n      impactEventIds: [],\n    },\n    newImpactEvents: [],\n  };\n\n  const eventTs = params.evidenceTs;\n  const eventDateTime = DateTime.fromISO(eventTs);\n  assert(eventDateTime.isValid, `Invalid date: ${eventTs}`);\n\n  const currentState = deriveCurrentState(params.issueBundle);\n\n  const claimsKeyedByAffectedEntity: Record<string, Claim> = Object.fromEntries(\n    params.claims.map((claim) => [keyForAffectedEntity(claim.entity), claim]),\n  );\n\n  for (const [key, claim] of Object.entries(claimsKeyedByAffectedEntity)) {\n    switch (claim.entity.type) {\n      case 'service': {\n        const currentServiceState = currentState.services[key] ?? {\n          effect: null,\n          scopes: [],\n          periods: [],\n          causes: [],\n        };\n        const currentServiceProvenance =\n          currentState.servicesProvenance[key] ?? {};\n\n        if (\n          claim.effect?.service != null &&\n          !isEqual(currentServiceState.effect, claim.effect.service)\n        ) {\n          currentServiceState.effect = claim.effect.service;\n          currentServiceProvenance.effect = {\n            evidenceId: params.evidenceId,\n          };\n          result.newImpactEvents.push({\n            id: IdGenerator.impactEventId(eventDateTime),\n            type: 'service_effects.set',\n            ts: eventTs,\n            basis: { evidenceId: params.evidenceId },\n            entity: claim.entity,\n            effect: claim.effect.service,\n          });\n        }\n\n        switch (params.issueBundle.issue.type) {\n          case 'disruption': {\n            const isCleared = currentServiceState.periods.every(\n              (period) => period.kind === 'fixed' && period.endAt != null,\n            );\n\n            let currentStatus: ClaimStatusSignal = 'open';\n\n            if (isCleared) {\n              currentStatus = 'cleared';\n            }\n\n            if (currentStatus !== claim.statusSignal) {\n              switch (claim.statusSignal) {\n                case 'open': {\n                  break;\n                }\n                case 'cleared': {\n                  break;\n                }\n              }\n            }\n            break;\n          }\n        }\n\n        if (claim.timeHints != null) {\n          const { newPeriods, hasChanged } = reconcilePeriodsWithTimeHints(\n            currentServiceState.periods,\n            claim.timeHints,\n          );\n          if (hasChanged) {\n            currentServiceState.periods = newPeriods;\n            currentServiceProvenance.periods = {\n              evidenceId: params.evidenceId,\n            };\n            result.newImpactEvents.push({\n              id: IdGenerator.impactEventId(eventDateTime),\n              type: 'periods.set',\n              ts: eventTs,\n              basis: { evidenceId: params.evidenceId },\n              entity: claim.entity,\n              periods: currentServiceState.periods,\n            });\n          }\n        }\n\n        if (\n          claim.scopes?.service != null &&\n          !isEqual(currentServiceState.scopes, claim.scopes.service)\n        ) {\n          currentServiceState.scopes = claim.scopes.service;\n          currentServiceProvenance.scopes = {\n            evidenceId: params.evidenceId,\n          };\n          result.newImpactEvents.push({\n            id: IdGenerator.impactEventId(eventDateTime),\n            type: 'service_scopes.set',\n            ts: eventTs,\n            basis: { evidenceId: params.evidenceId },\n            entity: claim.entity,\n            serviceScopes: claim.scopes.service,\n          });\n        }\n\n        if (\n          claim.causes != null &&\n          !isEqual(currentServiceState.causes, claim.causes)\n        ) {\n          currentServiceState.causes = claim.causes;\n          currentServiceProvenance.causes = {\n            evidenceId: params.evidenceId,\n          };\n          result.newImpactEvents.push({\n            id: IdGenerator.impactEventId(eventDateTime),\n            type: 'causes.set',\n            ts: eventTs,\n            basis: { evidenceId: params.evidenceId },\n            entity: claim.entity,\n            causes: claim.causes,\n          });\n        }\n\n        result.newState.services[key] = currentServiceState;\n        result.newState.servicesProvenance[key] = currentServiceProvenance;\n\n        break;\n      }\n      case 'facility': {\n        const currentFacilityState = currentState.facilities[key] ?? {\n          effect: null,\n          periods: [],\n        };\n        const currentFacilityProvenance =\n          currentState.facilitiesProvenance[key] ?? {};\n\n        if (\n          claim.effect?.facility != null &&\n          !isEqual(currentFacilityState.effect, claim.effect.facility)\n        ) {\n          currentFacilityState.effect = claim.effect.facility;\n          currentFacilityProvenance.effect = {\n            evidenceId: params.evidenceId,\n          };\n          result.newImpactEvents.push({\n            id: IdGenerator.impactEventId(eventDateTime),\n            type: 'facility_effects.set',\n            ts: eventTs,\n            basis: { evidenceId: params.evidenceId },\n            entity: claim.entity,\n            effect: claim.effect.facility,\n          });\n        }\n\n        if (claim.timeHints != null) {\n          const { newPeriods, hasChanged } = reconcilePeriodsWithTimeHints(\n            currentFacilityState.periods,\n            claim.timeHints,\n          );\n          if (hasChanged) {\n            currentFacilityState.periods = newPeriods;\n            currentFacilityProvenance.periods = {\n              evidenceId: params.evidenceId,\n            };\n            result.newImpactEvents.push({\n              id: IdGenerator.impactEventId(eventDateTime),\n              type: 'periods.set',\n              ts: eventTs,\n              basis: { evidenceId: params.evidenceId },\n              entity: claim.entity,\n              periods: currentFacilityState.periods,\n            });\n          }\n        }\n\n        if (\n          claim.causes != null &&\n          !isEqual(currentFacilityState.causes, claim.causes)\n        ) {\n          currentFacilityState.causes = claim.causes;\n          currentFacilityProvenance.causes = {\n            evidenceId: params.evidenceId,\n          };\n          result.newImpactEvents.push({\n            id: IdGenerator.impactEventId(eventDateTime),\n            type: 'causes.set',\n            ts: eventTs,\n            basis: { evidenceId: params.evidenceId },\n            entity: claim.entity,\n            causes: claim.causes,\n          });\n        }\n\n        result.newState.facilities[key] = currentFacilityState;\n        result.newState.facilitiesProvenance[key] = currentFacilityProvenance;\n\n        break;\n      }\n    }\n  }\n\n  return result;\n}\n\ntype ReconcilePeriodsWithTimeHintsResults = {\n  newPeriods: Period[];\n  hasChanged: boolean;\n};\n\n/**\n * Reconcile the periods with the time hints.\n * @param currentPeriods - The current periods.\n * @param timeHints - The time hints.\n * @returns The new periods and whether the periods have changed.\n */\nfunction reconcilePeriodsWithTimeHints(\n  currentPeriods: Period[],\n  timeHints: ClaimTimeHints,\n): ReconcilePeriodsWithTimeHintsResults {\n  switch (timeHints.kind) {\n    case 'fixed': {\n      return {\n        newPeriods: [timeHints],\n        hasChanged: true,\n      };\n    }\n    case 'recurring': {\n      return {\n        newPeriods: [timeHints],\n        hasChanged: true,\n      };\n    }\n    case 'start-only': {\n      let hasChanged = false;\n      const newPeriods: Period[] = [];\n      if (currentPeriods.length === 0) {\n        newPeriods.push({\n          kind: 'fixed',\n          startAt: timeHints.startAt,\n          endAt: null,\n        });\n        hasChanged = true;\n        return { newPeriods, hasChanged };\n      }\n      for (const period of currentPeriods) {\n        switch (period.kind) {\n          case 'fixed': {\n            newPeriods.push({\n              ...period,\n              startAt: timeHints.startAt,\n            });\n            hasChanged = true;\n            break;\n          }\n          case 'recurring': {\n            const newPeriod: Period = {\n              ...period,\n              startAt: timeHints.startAt,\n            };\n            if (newPeriod.timeWindow != null) {\n              const startAt = DateTime.fromISO(timeHints.startAt);\n              assert(startAt.isValid);\n              newPeriod.timeWindow.startAt = startAt.toFormat('HH:mm:ss');\n            }\n            newPeriods.push(newPeriod);\n            hasChanged = true;\n            break;\n          }\n        }\n      }\n      return {\n        newPeriods,\n        hasChanged,\n      };\n    }\n    case 'end-only': {\n      let hasChanged = false;\n      const newPeriods: Period[] = [];\n      for (const period of currentPeriods) {\n        switch (period.kind) {\n          case 'fixed': {\n            newPeriods.push({\n              ...period,\n              endAt: timeHints.endAt,\n            });\n            hasChanged = true;\n            break;\n          }\n          case 'recurring': {\n            const newPeriod: Period = {\n              ...period,\n              endAt: timeHints.endAt,\n            };\n            if (newPeriod.timeWindow != null) {\n              const endAt = DateTime.fromISO(timeHints.endAt);\n              assert(endAt.isValid);\n              newPeriod.timeWindow.endAt = endAt.toFormat('HH:mm:ss');\n            }\n            newPeriods.push(newPeriod);\n            hasChanged = true;\n            break;\n          }\n        }\n      }\n      return {\n        newPeriods,\n        hasChanged,\n      };\n    }\n  }\n}\n\nfunction isEqual(a: unknown, b: unknown): boolean {\n  try {\n    deepStrictEqual(a, b);\n    return true;\n  } catch (error) {\n    return false;\n  }\n}\n"]}

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

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