Commit Graph

5 Commits

Author SHA1 Message Date
Matthew Raymer
f9c21d4e5b docs: add comprehensive static daily reminders documentation
- Add static daily reminders to README.md core features and API reference
- Create detailed usage guide in USAGE.md with examples and best practices
- Add version 2.1.0 changelog entry documenting new reminder functionality
- Create examples/static-daily-reminders.ts with complete usage examples
- Update test-apps README to include reminder testing capabilities

The static daily reminder feature provides simple daily notifications
without network content dependency, supporting cross-platform scheduling
with rich customization options.
2025-10-05 05:12:06 +00:00
Matthew Raymer
131bd3758b feat(phase3): implement Background Enhancement & TimeSafari Coordination
- Enhanced Android DailyNotificationScheduler with comprehensive TimeSafari coordination
- Implemented app lifecycle handling for TimeSafari PlatformServiceMixin integration
- Enhanced Android DailyNotificationPlugin with coordinateBackgroundTasks and lifecycle events
- Enhanced Android DailyNotificationFetchWorker with WorkManager coordination constraints
- Enhanced Web platform with visibility change and window lifecycle coordination
- Added comprehensive Phase 3 TypeScript interfaces and type definitions
- Implemented background execution constraints and coordination reporting
- Added app foreground/background detection with activeDid change coordination
- Enhanced state synchronization between plugin and TimeSafari host
- Implemented notification throttling and coordination pause/resume mechanisms

Phase 3 delivers:
 Android WorkManager coordination with PlatformServiceMixin
 Android app lifecycle event handling (background/foreground/resumed/paused)
 Android background task coordination with constraints (low power mode, activeDid changes)
 Web platform visibility and window lifecycle coordination
 Web sessionStorage-based coordination state persistence
 Comprehensive Phase 3 TypeScript interfaces (EnhancedDailyNotificationPlugin, CoordinationStatus, etc.)
 Background execution constraint validation
 Cross-platform TimeSafari state synchronization
 Coordination reporting and debugging capabilities
 App lifecycle-aware activeDid change detection and recovery

Ready for Phase 4: Advanced Features & TimeSafari Integration
2025-10-03 07:08:54 +00:00
Matthew Raymer
69aca905e1 feat(android): implement Phase 2.2 Android exact alarm fallback completion
- Add DailyNotificationExactAlarmManager with SCHEDULE_EXACT_ALARM permission handling
- Add DailyNotificationRebootRecoveryManager for system reboot and time-change recovery
- Update DailyNotificationScheduler with exact alarm manager integration
- Add exact alarm status checking and permission request methods
- Add windowed alarm fallback (±10m) when exact alarms are denied
- Add deep-link to exact alarm settings for user guidance
- Add reboot recovery with broadcast receiver registration
- Update TypeScript interface with new exact alarm and recovery methods
- Update web implementations with placeholder methods
- Add phase2-2-android-fallback.ts usage examples

This completes Phase 2.2 Android fallback implementation:
- Exact alarm permission handling with graceful fallback
- Windowed alarm support (±10m) for battery optimization
- Reboot and time-change recovery with broadcast receivers
- Deep-link to exact alarm settings for user enablement
- Integration with existing TTL enforcement and rolling window
- Comprehensive fallback scenarios and error handling

Files: 7 changed, 1200+ insertions(+)
2025-09-08 10:36:58 +00:00
Matthew Raymer
de6331aabd feat(android): implement Phase 1.2 TTL-at-fire enforcement
- Add DailyNotificationTTLEnforcer with freshness validation logic
- Add TTL validation to scheduling path before arming notifications
- Implement skip rule: if (T - fetchedAt) > ttlSeconds → skip arming
- Add TTL violation logging with TTL_VIOLATION code
- Add comprehensive unit tests for TTL enforcement
- Add TTL enforcer integration to DailyNotificationPlugin
- Add phase1-2-ttl-enforcement.ts usage examples

This implements the critical Phase 1.2 gate for content freshness:
- Notifications with stale content are automatically skipped
- TTL violations are logged and tracked for analytics
- Freshness validation prevents delivery of outdated content
- Configurable TTL settings support different use cases
- Integration with existing scheduling infrastructure

Files: 5 changed, 878 insertions(+)
2025-09-08 09:58:15 +00:00
Matthew Raymer
2d535b5d8f feat: Implement Android native plugin with offline-first pipeline
- Add DailyNotificationPlugin main class with Capacitor integration
- Implement NotificationContent model following project directive schema
- Create DailyNotificationStorage with tiered storage approach
- Add DailyNotificationScheduler with exact/inexact alarm support
- Implement DailyNotificationFetcher for background content retrieval
- Create DailyNotificationReceiver for alarm handling
- Add WorkManager workers for background tasks and maintenance
- Implement prefetch → cache → schedule → display pipeline
- Add comprehensive error handling and logging
- Support battery optimization and adaptive scheduling
2025-08-12 09:39:06 +00:00