@aleonnet/healthcare-scheduler 0.1.6

package/README.md

@@ -0,0 +1,264 @@
+# @healthcare-scheduler/core
+
+Production-ready healthcare scheduling library for medication reminders, appointments, and health-related notifications with OS-level integration.
+
+## Status
+
+- **169/169 tests passing**
+- **25 test suites** (unit, integration, validation)
+- **100% TypeScript** (strict mode)
+- **6 scheduling patterns** validated
+
+## Features
+
+- **📅 Flexible Scheduling**: 6 schedule types (TIMES, WEEKLY, INTERVAL, CYCLIC, DAYS_INTERVAL, PARTS_OF_DAY)
+- **🔔 OS Notifications**: Native notification scheduling with automatic reconciliation
+- **💾 Offline-First**: SQLite local storage
+- **📊 Adherence Tracking**: Materialized daily adherence metrics
+- **🎮 Gamification**: Streak calculation and level progression
+- **🔌 Extensible**: Event-driven plugin system
+- **🧪 Test Coverage**: Comprehensive validation suite
+
+## Installation
+
+```bash
+npm install @healthcare-scheduler/core
+# Peer dependency (if using React Native)
+npm install expo-sqlite
+```
+
+## Quick Start
+
+```typescript
+import { HealthcareScheduler, MockAdapter, MockNotificationAdapter } from '@healthcare-scheduler/core';
+
+const scheduler = new HealthcareScheduler({
+  storage: new MockAdapter(),  // or SQLiteAdapter for production
+  notificationDriver: new MockNotificationAdapter(),  // or NotifeeAdapter (see below)
+  windowDays: 14,
+  maxPendingNotifications: 45,
+  enableGrouping: false
+});
+
+await scheduler.bootstrap();
+
+// Create medication plan
+const planId = await scheduler.createPlan({
+  item: {
+    type: 'MED',
+    name: 'Losartana 50mg',
+    meta: { concentration: '50mg' }
+  },
+  schedule: {
+    kind: 'TIMES',
+    times: ['08:00', '20:00']
+  },
+  startsAt: new Date().toISOString()
+});
+
+// Get today's medication schedule
+const today = await scheduler.getTodayOccurrences();
+
+// Record medication taken
+await scheduler.recordEvent(occurrenceId, 'TAKEN', { source: 'user' });
+```
+
+## Schedule Types
+
+### 1. TIMES (Fixed times per day)
+```typescript
+{ kind: 'TIMES', times: ['08:00', '14:00', '20:00'] }
+```
+
+### 2. WEEKLY (Weekday-specific schedule)
+```typescript
+{ 
+  kind: 'WEEKLY',
+  lines: [
+    { id: '1', daysOfWeek: [1,2,3,4,5], time: '08:00', qty: 1 }
+  ]
+}
+```
+
+### 3. INTERVAL (Every N hours)
+```typescript
+{ 
+  kind: 'INTERVAL',
+  intervalH: 8,
+  firstDoseAt: '2025-01-01T08:00:00.000Z'
+}
+```
+
+### 4. CYCLIC (Take/pause cycles, e.g. contraceptives)
+```typescript
+{
+  kind: 'CYCLIC',
+  takeDays: 21,
+  pauseDays: 7,
+  times: ['21:00'],
+  cycleAnchorISO: '2025-01-01T00:00:00.000Z'
+}
+```
+
+### 5. DAYS_INTERVAL (Every N days)
+```typescript
+{
+  kind: 'DAYS_INTERVAL',
+  daysInterval: 7,
+  times: ['09:00'],
+  anchorDateISO: '2025-01-01T00:00:00.000Z'
+}
+```
+
+### 6. PARTS_OF_DAY (Morning/Afternoon/Evening)
+```typescript
+{
+  kind: 'PARTS_OF_DAY',
+  parts: [
+    { code: 'morning', label: 'Manhã', time: '08:00', qty: 1 },
+    { code: 'night', label: 'Noite', time: '21:00', qty: 1 }
+  ]
+}
+```
+
+## Gamification Plugin
+
+```typescript
+import { GamificationPlugin } from '@healthcare-scheduler/core';
+
+const gamification = new GamificationPlugin();
+scheduler.registerPlugin(gamification);
+
+await scheduler.bootstrap();
+
+// Get current level and streak
+const plugin = scheduler.getPlugin<GamificationPlugin>('gamification');
+const levels = await plugin.getCurrentLevelsState();
+// => { streak: 5, levelId: 'bronze', levelName: 'Bronze', progress: 0.4, ... }
+
+// Get daily adherence
+const adherence = await plugin.getDayAdherence(new Date());
+// => { date: '2025-10-11', total: 4, done: 3, pending: 1, percent: 75 }
+```
+
+## Production Usage with NotifeeAdapter
+
+For React Native production apps, use `NotifeeAdapter` with Platform information:
+
+```typescript
+import { Platform } from 'react-native';
+import { 
+  HealthcareScheduler, 
+  SQLiteAdapter, 
+  NotifeeAdapter,
+  GamificationPlugin 
+} from '@healthcare-scheduler/core';
+
+// Initialize storage
+const storage = await SQLiteAdapter.connect({ 
+  dbName: 'healthcare.db', 
+  autoApplySchema: true 
+});
+
+// Initialize notifications with Platform info
+const notificationDriver = new NotifeeAdapter({ 
+  platform: Platform  // Required for Android/iOS specific behavior
+});
+
+// Create scheduler
+const scheduler = new HealthcareScheduler({ 
+  storage, 
+  notificationDriver, 
+  windowDays: 14, 
+  maxPendingNotifications: 45 
+});
+
+// Register plugins
+scheduler.registerPlugin(new GamificationPlugin());
+
+// Bootstrap
+await scheduler.bootstrap();
+```
+
+**Note**: `NotifeeAdapter` requires `platform` to be passed to avoid dynamic imports of `react-native`, ensuring compatibility with React Native's New Architecture and preventing deprecated API warnings.
+
+## Architecture
+
+```
+src/
+├── core/              # Main API, EventBus, types
+├── database/          # Storage abstraction, repositories
+│   ├── repositories/  # ItemsRepo, PlansRepo, OccurrencesRepo, EventsRepo
+│   └── adapters/      # MockAdapter, SQLiteAdapter (peer dep)
+├── planning/          # Schedule expansion engine
+├── reconciler/        # DB ↔ OS notification sync
+├── notifications/     # Notification driver abstraction
+├── plugins/           # Extensible plugin system
+│   └── gamification/  # Adherence tracking & levels
+└── utils/             # Queue, timezone helpers
+```
+
+## Events
+
+```typescript
+scheduler.on('plans:changed', ({ planIds }) => {
+  console.log('Plans updated:', planIds);
+});
+
+scheduler.on('occurrences:changed', ({ occurrenceIds }) => {
+  console.log('Occurrences changed:', occurrenceIds);
+});
+
+scheduler.on('window:filled', ({ count }) => {
+  console.log('Notifications scheduled:', count);
+});
+```
+
+Note:
+- Window fill and reconciliation are asynchronous and triggered by events (`plans:changed`, `occurrences:changed`). Wait for `window:filled` in tests or after batch operations; there is no public `updateWindow` method.
+
+## Development
+
+```bash
+# Install
+npm install
+
+# Run tests
+npm test
+
+# Run specific test suite
+npm test -- tests/validation/scenarios/scenario1_weekly.test.ts
+
+# Build
+npm run build
+
+# Lint
+npm run lint
+```
+
+## Testing
+
+The library includes comprehensive validation:
+
+- **Unit tests**: Planning engine, repositories, window scheduler
+- **Integration tests**: Full CRUD cycles
+- **Validation scenarios**: 6 real-world medication schedules
+- **Plugin tests**: Gamification, streak calculation
+
+All tests run in-memory using MockAdapter (no database required).
+
+## Documentation
+
+- [Implementation Plan](./docs/healthcare-scheduler-library.plan.md)
+- [Executive Summary](./docs/EXECUTIVE_SUMMARY.md)
+- [Developer Guide](./docs/README_DEV.md)
+
+## License
+
+MIT
+
+## Credits
+
+Alessandro Barbosa.
+
+Built with TypeScript, tested with Jest, validated against real-world use cases.

package/dist/core/EventBus.d.ts

@@ -0,0 +1,14 @@
+type EventCallback<T = any> = (payload: T) => void;
+export declare class EventBus {
+    private listeners;
+    constructor();
+    on<T = any>(eventType: string, callback: EventCallback<T>): () => void;
+    off<T = any>(eventType: string, callback: EventCallback<T>): void;
+    emit<T = any>(eventType: string, payload: T): void;
+    clearEventType(eventType: string): void;
+    clearAll(): void;
+    listenerCount(eventType: string): number;
+}
+export declare const globalEventBus: EventBus;
+export default globalEventBus;
+//# sourceMappingURL=EventBus.d.ts.map

package/dist/core/EventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.d.ts","sourceRoot":"","sources":["../../src/core/EventBus.ts"],"names":[],"mappings":"AAMA,KAAK,aAAa,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;AAEnD,qBAAa,QAAQ;IACnB,OAAO,CAAC,SAAS,CAAkC;;IAYnD,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAetE,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI;IAYjE,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI;IAiBlD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAOvC,QAAQ,IAAI,IAAI;IAShB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAGzC;AAGD,eAAO,MAAM,cAAc,UAAiB,CAAC;AAG7C,eAAe,cAAc,CAAC"}

package/dist/core/EventBus.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.globalEventBus = exports.EventBus = void 0;
+class EventBus {
+    constructor() {
+        this.listeners = new Map();
+    }
+    on(eventType, callback) {
+        if (!this.listeners.has(eventType)) {
+            this.listeners.set(eventType, new Set());
+        }
+        this.listeners.get(eventType).add(callback);
+        return () => this.off(eventType, callback);
+    }
+    off(eventType, callback) {
+        const callbacks = this.listeners.get(eventType);
+        if (callbacks) {
+            callbacks.delete(callback);
+        }
+    }
+    emit(eventType, payload) {
+        const callbacks = this.listeners.get(eventType);
+        if (callbacks) {
+            for (const callback of callbacks) {
+                try {
+                    callback(payload);
+                }
+                catch (error) {
+                    console.error(`Error in event listener for "${eventType}":`, error);
+                }
+            }
+        }
+    }
+    clearEventType(eventType) {
+        this.listeners.delete(eventType);
+    }
+    clearAll() {
+        this.listeners.clear();
+    }
+    listenerCount(eventType) {
+        return this.listeners.get(eventType)?.size ?? 0;
+    }
+}
+exports.EventBus = EventBus;
+exports.globalEventBus = new EventBus();
+exports.default = exports.globalEventBus;
+//# sourceMappingURL=EventBus.js.map

package/dist/core/EventBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.js","sourceRoot":"","sources":["../../src/core/EventBus.ts"],"names":[],"mappings":";;;AAQA,MAAa,QAAQ;IAGnB;QACE,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;IAC7B,CAAC;IAQD,EAAE,CAAU,SAAiB,EAAE,QAA0B;QACvD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAG7C,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAOD,GAAG,CAAU,SAAiB,EAAE,QAA0B;QACxD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,SAAS,EAAE,CAAC;YACd,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAOD,IAAI,CAAU,SAAiB,EAAE,OAAU;QACzC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,SAAS,EAAE,CAAC;YACd,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,IAAI,CAAC;oBACH,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACpB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,KAAK,CAAC,gCAAgC,SAAS,IAAI,EAAE,KAAK,CAAC,CAAC;gBACtE,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAMD,cAAc,CAAC,SAAiB;QAC9B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAKD,QAAQ;QACN,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAOD,aAAa,CAAC,SAAiB;QAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC;IAClD,CAAC;CACF;AA5ED,4BA4EC;AAGY,QAAA,cAAc,GAAG,IAAI,QAAQ,EAAE,CAAC;AAG7C,kBAAe,sBAAc,CAAC"}

package/dist/core/HealthcareScheduler.d.ts

@@ -0,0 +1,63 @@
+import { EventBus } from './EventBus';
+import { SchedulerConfig, Item, ScheduleRule, Occurrence, EventAction, SchedulerPlugin } from './types';
+import { ItemsRepository, PlansRepository, EventsRepository, MedicationsRepository } from '../database/repositories';
+import { WindowScheduler } from '../reconciler/WindowScheduler';
+import type { PluginInterface } from '../plugins/interfaces';
+export declare class HealthcareScheduler {
+    private eventBus;
+    private storage;
+    private notificationDriver;
+    private config;
+    private itemsRepo;
+    private plansRepo;
+    private occurrencesRepo;
+    private eventsRepo;
+    private medicationsRepo;
+    private windowScheduler;
+    private plugins;
+    private pluginRegistry;
+    constructor(config: SchedulerConfig);
+    bootstrap(): Promise<void>;
+    fillWindow(): Promise<void>;
+    private resolveGroupOccurrencesFromPayload;
+    use(plugin: SchedulerPlugin): this;
+    registerPlugin(plugin: PluginInterface): this;
+    getPlugin<T extends PluginInterface>(name: string): T | undefined;
+    createPlan(options: {
+        item: Omit<Item, 'id' | 'created_at'>;
+        schedule: ScheduleRule;
+        startsAt: string;
+        endsAt?: string;
+    }): Promise<string>;
+    updatePlan(planId: string, updates: {
+        schedule?: ScheduleRule;
+        endsAt?: string;
+    }): Promise<void>;
+    endPlan(planId: string): Promise<void>;
+    deletePlan(planId: string): Promise<void>;
+    getOccurrences(options: {
+        days: number;
+        limit?: number;
+    }): Promise<Occurrence[]>;
+    getTodayOccurrences(): Promise<Occurrence[]>;
+    recordEvent(occurrenceId: string, action: EventAction, meta?: {
+        source?: 'notif' | 'screen';
+        note?: string;
+        payload?: Record<string, any>;
+    }): Promise<void>;
+    on<T = any>(eventType: string, callback: (payload: T) => void): () => void;
+    emit<T = any>(eventType: string, payload: T): void;
+    private setupEventHandlers;
+    getItemsRepository(): ItemsRepository;
+    getPlansRepository(): PlansRepository;
+    getMedicationsRepository(): MedicationsRepository;
+    getEventBus(): EventBus;
+    getConfig(): typeof this.config;
+    getWindowScheduler(): WindowScheduler;
+    getEventsRepository(): EventsRepository;
+    cleanupOldRecords(daysOld?: number): Promise<{
+        occurrences: number;
+        events: number;
+    }>;
+}
+//# sourceMappingURL=HealthcareScheduler.d.ts.map

package/dist/core/HealthcareScheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HealthcareScheduler.d.ts","sourceRoot":"","sources":["../../src/core/HealthcareScheduler.ts"],"names":[],"mappings":"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"}

package/dist/core/HealthcareScheduler.js

@@ -0,0 +1,269 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthcareScheduler = void 0;
+const EventBus_1 = require("./EventBus");
+const timestamp_1 = require("../utils/timestamp");
+const repositories_1 = require("../database/repositories");
+const WindowScheduler_1 = require("../reconciler/WindowScheduler");
+const PluginRegistry_1 = require("../plugins/PluginRegistry");
+class HealthcareScheduler {
+    constructor(config) {
+        this.plugins = [];
+        this.storage = config.storage;
+        this.notificationDriver = config.notificationDriver;
+        this.eventBus = new EventBus_1.EventBus();
+        this.config = {
+            windowDays: config.windowDays || 14,
+            maxPendingNotifications: config.maxPendingNotifications || 45,
+            enableGrouping: config.enableGrouping || false,
+            enableInventory: config.enableInventory || false,
+            timezone: config.timezone || 'America/Sao_Paulo'
+        };
+        this.itemsRepo = new repositories_1.ItemsRepository(this.storage);
+        this.plansRepo = new repositories_1.PlansRepository(this.storage);
+        this.occurrencesRepo = new repositories_1.OccurrencesRepository(this.storage);
+        this.eventsRepo = new repositories_1.EventsRepository(this.storage, this.eventBus);
+        this.medicationsRepo = new repositories_1.MedicationsRepository(this.storage);
+        this.windowScheduler = new WindowScheduler_1.WindowScheduler(this.plansRepo, this.occurrencesRepo, this.notificationDriver, this.eventBus);
+        this.pluginRegistry = new PluginRegistry_1.PluginRegistry();
+        this.setupEventHandlers();
+    }
+    async bootstrap() {
+        console.log('🚀 Bootstrapping HealthcareScheduler...');
+        const hasPermissions = await this.notificationDriver.ensurePermissions();
+        if (!hasPermissions) {
+            console.warn('⚠️ Notification permissions not granted');
+        }
+        if (this.notificationDriver.createChannelsAndCategories) {
+            await this.notificationDriver.createChannelsAndCategories();
+        }
+        try {
+            this.notificationDriver.registerHandlers(async (evt) => {
+                const type = evt?.type;
+                const occId = evt?.occurrenceId;
+                const payload = evt?.payload || {};
+                const occurrenceIds = Array.isArray(payload?.occurrenceIds) ? payload.occurrenceIds : [];
+                const groupKey = typeof payload?.groupKey === 'string' ? payload.groupKey : null;
+                const slotISO = typeof payload?.slotISO === 'string' ? payload.slotISO : null;
+                const itemType = typeof payload?.itemType === 'string' ? payload.itemType : null;
+                if (type === 'TAKEN' || type === 'SKIPPED' || type === 'SNOOZED') {
+                    let handledBatch = false;
+                    if (occurrenceIds && occurrenceIds.length > 0) {
+                        try {
+                            await this.eventsRepo.recordEventsBatch(occurrenceIds, type, { source: 'notif', payload });
+                            handledBatch = true;
+                        }
+                        catch (e) {
+                            console.error('❌ Error batch-recording events from notif:', e);
+                        }
+                    }
+                    else if (groupKey || slotISO) {
+                        try {
+                            const ids = await this.resolveGroupOccurrencesFromPayload(groupKey, slotISO, itemType || 'MED');
+                            if (ids.length > 0) {
+                                await this.eventsRepo.recordEventsBatch(ids, type, { source: 'notif', payload });
+                                handledBatch = true;
+                            }
+                        }
+                        catch (e) {
+                            console.error('❌ Error resolving group occurrences from notif:', e);
+                        }
+                    }
+                    if (!handledBatch && occId) {
+                        try {
+                            await this.eventsRepo.recordEvent(occId, type, { source: 'notif', payload });
+                        }
+                        catch { }
+                    }
+                    return;
+                }
+                if (occId && (type === 'TAPPED' || type === 'DISMISSED')) {
+                    try {
+                        await this.eventsRepo.recordEvent(occId, type, { source: 'notif', payload });
+                    }
+                    catch { }
+                    return;
+                }
+            });
+        }
+        catch (e) {
+            console.warn('⚠️ Failed to register notification handlers:', e);
+        }
+        for (const plugin of this.plugins) {
+            if (plugin.onBootstrap) {
+                await plugin.onBootstrap(this);
+            }
+        }
+        await this.pluginRegistry.bootstrapAll({
+            storage: this.storage,
+            eventBus: this.eventBus,
+            config: this.config
+        });
+        console.log('✅ HealthcareScheduler bootstrapped');
+    }
+    async fillWindow() {
+        await this.windowScheduler.updateWindow({ days: this.config.windowDays });
+    }
+    async resolveGroupOccurrencesFromPayload(groupKey, slotISO, itemType) {
+        const legacyMatch = groupKey ? /^([A-Z]+):HH:(\d{2}):(\d{2})$/.exec(groupKey) : null;
+        if (legacyMatch) {
+            const hh = Number(legacyMatch[2]);
+            const mm = Number(legacyMatch[3]);
+            const today = await this.occurrencesRepo.getToday(new Date());
+            return today
+                .filter(o => o.kind === itemType && (0, timestamp_1.parseUTC)(o.scheduled_at).getHours() === hh && (0, timestamp_1.parseUTC)(o.scheduled_at).getMinutes() === mm)
+                .map(o => o.id);
+        }
+        if (slotISO) {
+            const slot = new Date(slotISO);
+            const sameDayOccs = await this.occurrencesRepo.getToday(slot);
+            return sameDayOccs
+                .filter(o => o.kind === itemType && Math.abs((0, timestamp_1.parseUTC)(o.scheduled_at).getTime() - slot.getTime()) < 60 * 1000)
+                .map(o => o.id);
+        }
+        return [];
+    }
+    use(plugin) {
+        this.plugins.push(plugin);
+        console.log(`🔌 Plugin registered: ${plugin.name}`);
+        return this;
+    }
+    registerPlugin(plugin) {
+        this.pluginRegistry.register(plugin);
+        console.log(`🔌 Plugin registered: ${plugin.name}`);
+        return this;
+    }
+    getPlugin(name) {
+        return this.pluginRegistry.get(name);
+    }
+    async createPlan(options) {
+        const itemId = `item:${Date.now()}:${Math.random().toString(36).substr(2, 9)}`;
+        const item = {
+            id: itemId,
+            ...options.item
+        };
+        await this.itemsRepo.upsert(item);
+        const planId = `plan:${Date.now()}:${Math.random().toString(36).substr(2, 9)}`;
+        const plan = {
+            id: planId,
+            item_id: itemId,
+            schedule_rule: options.schedule,
+            tz: this.config.timezone,
+            starts_at: options.startsAt,
+            ends_at: options.endsAt
+        };
+        await this.plansRepo.upsert(plan);
+        this.eventBus.emit('plans:changed', { planId });
+        return planId;
+    }
+    async updatePlan(planId, updates) {
+        const plan = await this.plansRepo.findById(planId);
+        if (!plan) {
+            throw new Error(`Plan ${planId} not found`);
+        }
+        const updatedPlan = {
+            ...plan,
+            schedule_rule: updates.schedule || plan.schedule_rule,
+            ends_at: updates.endsAt !== undefined ? updates.endsAt : plan.ends_at
+        };
+        await this.plansRepo.upsert(updatedPlan);
+        this.eventBus.emit('plans:changed', { planId });
+    }
+    async endPlan(planId) {
+        const plan = await this.plansRepo.findById(planId);
+        if (!plan) {
+            throw new Error(`Plan ${planId} not found`);
+        }
+        const updatedPlan = {
+            ...plan,
+            ends_at: new Date().toISOString()
+        };
+        await this.plansRepo.upsert(updatedPlan);
+        this.eventBus.emit('plans:changed', { planId });
+    }
+    async deletePlan(planId) {
+        await this.plansRepo.delete(planId);
+        this.eventBus.emit('plans:changed', { planId });
+    }
+    async getOccurrences(options) {
+        if (options.days === 1) {
+            return this.occurrencesRepo.getToday(new Date());
+        }
+        return this.occurrencesRepo.getUpcomingWindow({
+            days: options.days - 1,
+            limit: options.limit || 50,
+            pastDays: 0
+        });
+    }
+    async getTodayOccurrences() {
+        return this.occurrencesRepo.getToday(new Date());
+    }
+    async recordEvent(occurrenceId, action, meta) {
+        await this.eventsRepo.recordEvent(occurrenceId, action, meta || {});
+    }
+    on(eventType, callback) {
+        return this.eventBus.on(eventType, callback);
+    }
+    emit(eventType, payload) {
+        this.eventBus.emit(eventType, payload);
+    }
+    setupEventHandlers() {
+        this.eventBus.on('plans:changed', () => {
+            void (async () => {
+                console.log('📅 Plans changed, updating window...');
+                try {
+                    await this.windowScheduler.updateWindow({ days: this.config.windowDays });
+                }
+                catch (error) {
+                    console.error('❌ Error updating window:', error);
+                }
+            })();
+        });
+        let reconciling = false;
+        this.eventBus.on('occurrences:changed', () => {
+            void (async () => {
+                if (reconciling)
+                    return;
+                reconciling = true;
+                console.log('🔄 Occurrences changed, reconciling...');
+                try {
+                    await this.windowScheduler.reconcileWithOS();
+                }
+                catch (error) {
+                    console.error('❌ Error reconciling:', error);
+                }
+                finally {
+                    reconciling = false;
+                }
+            })();
+        });
+    }
+    getItemsRepository() {
+        return this.itemsRepo;
+    }
+    getPlansRepository() {
+        return this.plansRepo;
+    }
+    getMedicationsRepository() {
+        return this.medicationsRepo;
+    }
+    getEventBus() {
+        return this.eventBus;
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    getWindowScheduler() {
+        return this.windowScheduler;
+    }
+    getEventsRepository() {
+        return this.eventsRepo;
+    }
+    async cleanupOldRecords(daysOld = 90) {
+        const occurrences = await this.occurrencesRepo.cleanupOldOccurrences(daysOld);
+        const events = await this.eventsRepo.cleanupOldEvents(daysOld);
+        return { occurrences, events };
+    }
+}
+exports.HealthcareScheduler = HealthcareScheduler;
+//# sourceMappingURL=HealthcareScheduler.js.map