Commit Graph

14 Commits

Author SHA1 Message Date
Matthew Raymer
8d7d1b10ef refactor(storage): migrate fetcher/worker to Room with legacy fallback
- DailyNotificationPlugin: inject Room storage into fetcher
- DailyNotificationFetcher: persist to Room first, mirror to legacy
- DailyNotificationWorker: read from Room, fallback to legacy; write next schedule to Room

Legacy SharedPreferences path deprecated; retained for transitional compatibility.
Co-authored-by: Matthew Raymer
2025-10-20 10:34:23 +00:00
Matthew Raymer
79dd1d82a7 feat: add platform-specific configuration and build system
- Add Android configuration with notification channels and WorkManager
- Add iOS configuration with BGTaskScheduler and notification categories
- Add platform-specific build scripts and bundle size checking
- Add API change detection and type checksum validation
- Add release notes generation and chaos testing scripts
- Add Vite configuration for TimeSafari-specific builds
- Add Android notification channels XML configuration
- Update package.json with new build scripts and dependencies

Platforms: Android (WorkManager + SQLite), iOS (BGTaskScheduler + Core Data), Electron (Desktop notifications)
2025-10-08 06:18:32 +00:00
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
0b6a8cdd39 feat(phase2): implement ActiveDid Integration & TimeSafari API Enhancement
- Enhanced ConfigureOptions with comprehensive TimeSafari activeDid configuration
- Extended ContentFetchConfig with Endorser.ch API endpoints and TimeSafari config
- Added detailed TimeSafari notification types (Offers, Projects, People, Items)
- Implemented Host-provided activeDid Plugin Configuration with auto-sync
- Enhanced Android retry logic with TimeSafari activeDid change detection
- Enhanced Web retry logic with Phase 2 ActiveDid change support
- Added comprehensive TimeSafari fallback content generation
- Implemented cross-platform ActiveDid change event tracking

Phase 2 delivers:
 Enhanced ConfigureOptions with host-provided activeDid patterns
 Extension of ContentFetchConfig with Endorser.ch endpoints
 Complete TimeSafari notification type definitions
 Host-provided activeDid Plugin Configuration implementation
 Enhanced Android retry logic with activeDid change detection
 Enhanced Web retry logic with session-based activeDid tracking
 TimeSafari-aware fallback content generation
 Comprehensive configuration storage and persistence

Ready for Phase 3: Background Enhancement & TimeSafari Coordination
2025-10-03 07:02:55 +00:00
Matthew Raymer
ee772f136a feat(android): implement Phase 1 TimeSafari integration infrastructure
- Extend ConfigureOptions interface with activeDid integration options
- Add ActiveDid management methods to DailyNotificationPlugin interface
- Create DailyNotificationJWTManager for Android JWT authentication
- Extend DailyNotificationFetcher with Endorser.ch API support
- Enhance Android plugin with TimeSafari integration components
- Implement Phase 1 ActiveDid methods for web platform
- Update all test mocks to include new interface methods
- Add comprehensive error handling and logging

Phase 1 delivers:
 Extended TypeScript interfaces
 Android JWT authentication manager
 Enhanced Android fetcher with Endorser.ch APIs
 Integrated activeDid management methods
 Cross-platform interface compliance
 All tests passing

Ready for Phase 2: ActiveDid Integration & TimeSafari API Enhancement
2025-10-03 06:59:07 +00:00
Matthew Raymer
0ccf071f5c feat(performance): implement Phase 3.3 performance optimization for production
- Add DailyNotificationPerformanceOptimizer for Android with comprehensive optimization
- Add DailyNotificationPerformanceOptimizer for iOS with Swift performance management
- Implement database query optimization with indexes and PRAGMA settings
- Add memory usage monitoring with automatic cleanup and thresholds
- Implement object pooling for frequently used objects to reduce allocation
- Add battery usage tracking and background CPU optimization
- Add network request optimization and efficiency monitoring
- Add comprehensive performance metrics and reporting
- Add production-ready optimization with stress testing support
- Add phase3-3-performance-optimization.ts usage examples

This implements Phase 3.3 performance optimization for production reliability:
- Database indexes for query optimization (slot_id, fetched_at, status, etc.)
- Memory monitoring with warning/critical thresholds and automatic cleanup
- Object pooling for String, Data, and other frequently used objects
- Battery optimization with background CPU usage minimization
- Network request batching and efficiency improvements
- Comprehensive performance metrics tracking and reporting
- Production-ready optimization with configurable thresholds
- Cross-platform implementation (Android + iOS)

Files: 3 changed, 1200+ insertions(+)
2025-09-09 05:00:36 +00:00
Matthew Raymer
359051c13f feat(etag): implement Phase 3.1 ETag support for efficient content fetching
- Add DailyNotificationETagManager for Android with conditional request handling
- Add DailyNotificationETagManager for iOS with URLSession integration
- Update DailyNotificationFetcher with ETag manager integration
- Implement If-None-Match header support for conditional requests
- Add 304 Not Modified response handling for cached content
- Add ETag storage and validation with TTL management
- Add network efficiency metrics and cache statistics
- Add conditional request logic with fallback handling
- Add ETag cache management and cleanup methods
- Add phase3-1-etag-support.ts usage examples

This implements Phase 3.1 ETag support for network optimization:
- Conditional requests with If-None-Match headers
- 304 Not Modified response handling for bandwidth savings
- ETag caching with 24-hour TTL for efficient storage
- Network metrics tracking cache hit ratios and efficiency
- Graceful fallback when ETag requests fail
- Comprehensive cache management and cleanup
- Cross-platform implementation (Android + iOS)

Files: 4 changed, 800+ insertions(+)
2025-09-09 03:31:43 +00:00
Matthew Raymer
13905db3e4 feat(etag): implement Phase 3.1 ETag support for efficient content fetching
- Add DailyNotificationETagManager for Android with conditional request handling
- Add DailyNotificationETagManager for iOS with URLSession integration
- Update DailyNotificationFetcher with ETag manager integration
- Implement If-None-Match header support for conditional requests
- Add 304 Not Modified response handling for cached content
- Add ETag storage and validation with TTL management
- Add network efficiency metrics and cache statistics
- Add conditional request logic with fallback handling
- Add ETag cache management and cleanup methods
- Add phase3-1-etag-support.ts usage examples

This implements Phase 3.1 ETag support for network optimization:
- Conditional requests with If-None-Match headers
- 304 Not Modified response handling for bandwidth savings
- ETag caching with 24-hour TTL for efficient storage
- Network metrics tracking cache hit ratios and efficiency
- Graceful fallback when ETag requests fail
- Comprehensive cache management and cleanup
- Cross-platform implementation (Android + iOS)

Files: 4 changed, 800+ insertions(+)
2025-09-09 03:19: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
01c1c0f30b feat(android): implement Phase 1.3 rolling window safety
- Add DailyNotificationRollingWindow with capacity-aware scheduling
- Implement iOS capacity limits (64 pending, 20 daily) vs Android (100, 50)
- Add automatic window maintenance every 15 minutes
- Add manual maintenance triggers and statistics API
- Integrate rolling window with TTL enforcer and scheduler
- Add comprehensive unit tests for rolling window functionality
- Add rolling window methods to TypeScript interface
- Add phase1-3-rolling-window.ts usage examples

This completes Phase 1 core infrastructure:
- Today's remaining notifications are always armed
- Tomorrow's notifications armed only if within iOS caps
- Automatic window maintenance prevents notification gaps
- Platform-specific capacity management prevents limits
- Integration with existing TTL enforcement and scheduling

Files: 7 changed, 928 insertions(+)
2025-09-08 10:22:12 +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
489dd4ac28 feat(android): implement Phase 1.1 SQLite database sharing with WAL mode
- Add DailyNotificationDatabase.java with three-table schema and WAL configuration
- Add DailyNotificationMigration.java for SharedPreferences to SQLite migration
- Add DailyNotificationDatabaseTest.java with comprehensive unit tests
- Add ConfigureOptions interface with dbPath, storage mode, and TTL settings
- Add configure() method to DailyNotificationPlugin interface
- Update Android plugin with SQLite integration and automatic migration
- Update web implementations to implement new configure() method
- Add phase1-sqlite-usage.ts example demonstrating shared storage configuration

This implements the critical Phase 1.1 gate for shared SQLite storage:
- App and plugin can open the same SQLite file with WAL mode
- Automatic migration from SharedPreferences preserves existing data
- Schema version checking prevents compatibility issues
- Concurrent reads during background writes enabled
- Configuration API supports both shared and tiered storage modes

Files: 8 changed, 1204 insertions(+)
2025-09-08 09:49:08 +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