- Add requestPermissions method alias to fix Vue app compatibility
- Fix permission response format to include both string and boolean values
- Add comprehensive debugging for permission request flow
- Implement permission request throttling to prevent app crashes
- Fix capacitor.settings.gradle plugin path configuration
- Enhance Vue app logging for permission status debugging
Resolves permission dialog not appearing and UI showing incorrect status.
All permission functionality now works end-to-end with proper status updates.
- Add AAR Duplicate Class Issues section to BUILDING.md with step-by-step solutions
- Create dedicated docs/aar-integration-troubleshooting.md with complete troubleshooting guide
- Document project reference approach (recommended) vs AAR-only approach
- Add verification steps, prevention strategies, and best practices
- Update README.md with links to new documentation
- Resolve duplicate class issues through proper project reference configuration
Fixes AAR integration issues that caused build failures due to plugin being
included both as project reference and AAR file simultaneously.
- DailyNotificationPlugin: strip SQLite init and writes; retain SharedPreferences path; Room storage remains authoritative
- DailyNotificationTTLEnforcer: remove SQLite reads/writes and DB constants; use SharedPreferences-only
- DailyNotificationMigration: make migration a no-op (legacy SQLite removed)
- DailyNotificationFetcher/Worker: write/read via Room; keep legacy SharedPreferences as fallback; guard removed API (type/vibration/storeLong) via reflection
- Room DAOs: add column aliases to match DTO fields
- Entities: add @Ignore to non-default constructors to silence Room warnings
Build fixes: resolve missing symbols and cursor mismatches after SQLite removal; align to current NotificationContent API.
Co-authored-by: Matthew Raymer
- 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
Complete migration from SharedPreferences to Room database architecture:
**New Components:**
- NotificationContentEntity: Core notification data with encryption support
- NotificationDeliveryEntity: Delivery tracking and analytics
- NotificationConfigEntity: Configuration and user preferences
- NotificationContentDao: Comprehensive CRUD operations with optimized queries
- NotificationDeliveryDao: Delivery analytics and performance tracking
- NotificationConfigDao: Configuration management with type safety
- DailyNotificationDatabase: Room database with migration support
- DailyNotificationStorageRoom: High-level storage service with async operations
**Key Features:**
- Enterprise-grade data persistence with proper indexing
- Encryption support for sensitive notification content
- Automatic retention policy enforcement
- Comprehensive analytics and reporting capabilities
- Background thread execution for all database operations
- Migration support from SharedPreferences-based storage
- Plugin-specific database isolation and lifecycle management
**Architecture Documentation:**
- Complete ARCHITECTURE.md with comprehensive system design
- Database schema design with relationships and indexing strategy
- Security architecture with encryption and key management
- Performance architecture with optimization strategies
- Testing architecture with unit and integration test patterns
- Migration strategy from legacy storage systems
**Technical Improvements:**
- Plugin-specific database with proper entity relationships
- Optimized queries with performance-focused indexing
- Async operations using CompletableFuture for non-blocking UI
- Comprehensive error handling and logging
- Data validation and integrity enforcement
- Cleanup operations with configurable retention policies
This completes the high-priority storage hardening improvement, providing
enterprise-grade data management capabilities for the DailyNotification plugin.
Co-authored-by: Matthew Raymer
Critical Priority Improvements (Completed):
- Enhanced exact-time reliability for Doze & Android 12+ with setExactAndAllowWhileIdle
- Implemented DST-safe time calculation using Java 8 Time API to prevent notification drift
- Added comprehensive schema validation with Zod for all notification inputs
- Created Android 13+ permission UX with graceful fallbacks and education dialogs
High Priority Improvements (Completed):
- Implemented work deduplication and idempotence in DailyNotificationWorker
- Added atomic locks and completion tracking to prevent race conditions
- Enhanced error handling and logging throughout the notification pipeline
New Services Added:
- NotificationValidationService: Runtime schema validation with detailed error messages
- NotificationPermissionManager: Comprehensive permission handling with user education
Documentation Added:
- NOTIFICATION_STACK_IMPROVEMENT_PLAN.md: Complete implementation roadmap with checkboxes
- VUE3_NOTIFICATION_IMPLEMENTATION_GUIDE.md: Vue3 integration guide with code examples
This implementation addresses the most critical reliability and user experience issues
identified in the notification stack analysis, providing a solid foundation for
production-ready notification delivery.
- Add capacitor.plugins.json for main plugin registration
- Add plugin dependency to test app build configuration
- Add local plugin dependency to test app package.json
- Update package-lock.json with plugin dependency resolution
Enables proper plugin discovery and integration in test environment.
- Make all notifications clickable to open the app
- Use PackageManager.getLaunchIntentForPackage() for reliable app launch
- Add 'View Details' action button when URL is available
- Maintain existing 'Dismiss' action button for all notifications
- Enhanced logging for click intent and action button configuration
- Proper Intent flags for NEW_TASK and CLEAR_TOP behavior
Features:
- Tap notification body: Opens app (with URL data if available)
- Tap 'View Details': Opens URL in browser (if URL provided)
- Tap 'Dismiss': Dismisses notification and cancels future scheduling
Improves user experience with intuitive notification interactions.
- Add deduplication system to prevent double-firing of notifications
* Check existing notifications within 1-minute tolerance before scheduling
* Prevents duplicate notifications from receiver double-firing on some OEMs
* Structured logging: DN|RESCHEDULE_DUPLICATE, DN|SCHEDULE_DUPLICATE
- Implement WorkManager doze fallback system for deep doze scenarios
* DozeFallbackWorker runs 30 minutes before notification time
* Re-arms exact alarms if they get pruned during deep doze mode
* Battery-friendly constraints with no network requirement
* Structured logging: DN|DOZE_FALLBACK_SCHEDULED, DN|DOZE_FALLBACK_REARM_OK
- Add JIT soft re-fetch for borderline age content
* SoftRefetchWorker prefetches fresh content when content is 80% of TTL
* Runs 2 hours before tomorrow's notification for proactive freshness
* Asynchronous background processing with network constraints
* Structured logging: DN|JIT_BORDERLINE, DN|SOFT_REFETCH_SCHEDULED
- Enhance DailyNotificationWorker with comprehensive resilience features
* Ultra-lightweight receiver with WorkManager handoff
* DST-safe scheduling with ZonedDateTime calculations
* Storage capping and retention policy (100 entries, 14-day retention)
* Performance monitoring with StrictMode and Trace markers
- Add comprehensive status checking API
* NotificationStatusChecker provides unified permission/channel status
* Channel management with deep links to settings
* Exact alarm permission validation and guidance
All P1 features tested and working under system stress conditions.
Notification system now production-ready with full resilience suite.
- Add null checks and lazy initialization for scheduler in all plugin methods
- Prevents NullPointerException when methods called before load() completes
- Ensures scheduler is available for scheduleDailyNotification, scheduleDailyReminder, cancelDailyReminder, and updateDailyReminder
- Adds structured logging for scheduler initialization events
- Resolves critical runtime error under system stress conditions
Fixes: NullPointerException in DailyNotificationScheduler.scheduleNotification()
Tested: Notification system working correctly under stress with 45+ notifications
- Add PendingIntentManager class for proper PendingIntent handling
- Implement correct FLAG_UPDATE_CURRENT | FLAG_IMMUTABLE flags for Android 12+
- Add comprehensive exact alarm permission checking and handling
- Add fallback to windowed alarms when exact alarm permission denied
- Update DailyNotificationScheduler to use PendingIntentManager
- Add detailed alarm status reporting with Android version info
- Improve error handling for SecurityException on exact alarm scheduling
- Add comprehensive alarm status to checkStatus() method
P0 Priority Implementation:
- Fixes PendingIntent flags for modern Android compatibility
- Ensures exact alarm permissions are properly checked before scheduling
- Provides actionable error messages when exact alarm permission denied
- Adds fallback to windowed alarms for better reliability
- Improves alarm scheduling status reporting and debugging
This addresses the critical P0 issues with PendingIntent flags and
exact alarm permission handling for production reliability.
- Add ChannelManager class for notification channel management
- Implement channel existence checking and creation
- Add channel importance validation (guards against IMPORTANCE_NONE)
- Add deep link to channel settings when notifications are blocked
- Integrate channel manager into plugin load() method
- Add new plugin methods: isChannelEnabled(), openChannelSettings(), checkStatus()
- Add comprehensive status checking including permissions and channel state
- Add test app UI for channel management testing
P0 Priority Implementation:
- Guards against channel = NONE (blocked notifications)
- Provides actionable error messages with deep links to settings
- Ensures notifications can actually be delivered
- Comprehensive status checking for all notification requirements
This addresses the critical issue where notifications are scheduled
but silently dropped due to blocked notification channels.
- Remove echo() method from DailyNotificationPlugin.java
- Update Android test app to show 'Plugin is loaded and ready!' instead of echo test
- Update web test app to remove echo method call
- Update iOS test app to remove echo method call
- Update documentation to remove echo test references
- Replace echo test with simple plugin availability check
The echo test was only used for initial plugin verification and is no longer
needed since the plugin now has comprehensive notification functionality.
This simplifies the codebase and removes unnecessary test code.
- Remove setFetchTime() call as fetchedAt is now set in constructor
- Align with new immutable timestamp model
- Ensure consistent timestamp handling across all components
This completes the migration to the new timestamp model where
fetchedAt is immutable and set at object creation time.
- Remove setFetchTime() calls from DailyNotificationFetchWorker
- Remove setFetchTime() calls from DailyNotificationFetcher
- Update DailyNotificationMaintenanceWorker to use getFetchedAt()
- Update DailyNotificationMigration to use getFetchedAt()
- Align all classes with immutable fetchedAt timestamp approach
- Ensure consistent timestamp handling across the codebase
These changes support the new timestamp model where fetchedAt
is immutable and set at object creation time.
- Separate fetchedAt (immutable) and scheduledAt (mutable) timestamps
- Add custom JsonDeserializer to ensure fetchedAt is set by constructor
- Add transient fetchTime field for Gson compatibility
- Update TTL enforcer to use fetchedAt for freshness checks
- Increase DEFAULT_TTL_SECONDS to 25 hours for daily notifications
- Update storage to use custom Gson deserializer
- Add debug logging for timestamp validation
- Fix timestamp initialization in NotificationContent constructor
This resolves the TTL_VIOLATION error that was preventing
notifications from being scheduled due to stale timestamp data.
- Add ensureStorageInitialized() helper method for null safety
- Add storage initialization checks to all plugin methods
- Fix null pointer exception in scheduleDailyNotification()
- Add storage initialization to getLastNotification()
- Add storage initialization to cancelAllNotifications()
- Add storage initialization to updateSettings()
- Add storage initialization to setAdaptiveScheduling()
- Add storage initialization to checkAndPerformRecovery()
- Improve exact alarm permission handling with proper Settings intent
- Add comprehensive error handling for storage operations
This resolves the 'Attempt to invoke virtual method on null object'
error that was occurring when plugin methods were called before
storage initialization completed.
- Add android:exported="true" for API 31+ compatibility
- Add android:directBootAware="true" for Direct Boot handling
- Add LOCKED_BOOT_COMPLETED action for early boot recovery
- Remove PACKAGE_REPLACED action (not needed for our use case)
- Implement handleLockedBootCompleted() for Direct Boot safety
- Use device protected storage context for Direct Boot operations
- Add comprehensive logging for boot receiver events
This fixes Android 10+ boot receiver restrictions and ensures
notifications are restored after device reboots and app updates.
- Add full DailyNotificationPlugin with @CapacitorPlugin annotation
- Implement echo method for testing plugin connectivity
- Add comprehensive notification functionality with offline-first approach
- Include performance optimization and error handling classes
- Add WorkManager integration for background content fetching
- Plugin now ready for testing with Capacitor 6 registration
- Remove manual plugin registration code
- Use standard BridgeActivity pattern
- Plugin registration now handled via capacitor.plugins.json
- Cleaner, more maintainable approach
- Add capacitor.plugins.json with correct DailyNotification plugin entry
- Use 'classpath' field instead of 'classname' for Capacitor 6 compatibility
- Add annotation processor dependency to plugin build.gradle
- Plugin now successfully registers with Capacitor bridge
Fixes: PluginLoadException and plugin availability issues
Resolves: DailyNotification plugin not loading despite manual registration
- Create missing capacitor-cordova-android-plugins directory and build files
- Add cordova.variables.gradle with proper variable definitions
- Create www directory with functional test web app
- Add capacitor.config.ts with plugin configuration
- Fix test file package names from com.getcapacitor.myapp to com.timesafari.dailynotification
- Move test files to correct package directories
- Test app now builds successfully and creates APK
- Capacitor sync now works (Android portion)
- Build script handles both plugin and test app builds
The android/app test app is now fully functional and can be used
to test the DailyNotification plugin in a real Android environment.
- Create fix-capacitor-build.sh script to restore fixes after Capacitor operations
- Update build-native.sh to automatically apply fix when needed
- Add warnings to BUILDING.md about auto-generated file risks
- Document which Capacitor commands will overwrite manual fixes
This protects against losing the capacitor.build.gradle fix when running
npx cap sync, npx cap update, or other Capacitor CLI commands.
- Fix capacitor.build.gradle to comment out missing Capacitor integration file
- Create separate plugin module with proper build.gradle configuration
- Copy plugin source code to android/plugin/src/main/java/
- Update settings.gradle to include plugin module
- Fix plugin build.gradle to remove Kotlin plugin dependency
- Successfully build plugin AAR: android/plugin/build/outputs/aar/plugin-release.aar
- Update BUILDING.md with correct build commands and troubleshooting
This resolves the Android Studio build issues by creating a proper
plugin library module separate from the test app.
- 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.
- Add complete SQLite schema with Room database (content_cache, schedules, callbacks, history)
- Implement WorkManager FetchWorker with exponential backoff and network constraints
- Add AlarmManager NotifyReceiver with TTL-at-fire logic and notification delivery
- Create BootReceiver for automatic rescheduling after device reboot
- Update AndroidManifest.xml with necessary permissions and receivers
- Add Room, WorkManager, and Kotlin coroutines dependencies to build.gradle
feat(callback-registry)!: implement callback registry with circuit breaker
- Add CallbackRegistryImpl with HTTP, local, and queue callback support
- Implement circuit breaker pattern with exponential backoff retry logic
- Add CallbackEvent interface with structured event types
- Support for exactly-once delivery semantics with retry queue
- Include callback status monitoring and health checks
feat(observability)!: add comprehensive observability and health monitoring
- Implement ObservabilityManager with structured logging and event codes
- Add performance metrics tracking (fetch, notify, callback times)
- Create health status API with circuit breaker monitoring
- Include log compaction and metrics reset functionality
- Support for DNP-* event codes throughout the system
feat(web)!: enhance web implementation with new functionality
- Integrate callback registry and observability into web platform
- Add mock implementations for dual scheduling methods
- Implement performance tracking and structured logging
- Support for local callback registration and management
- Enhanced error handling and event logging
BREAKING CHANGE: New Android dependencies require Room, WorkManager, and Kotlin coroutines
- Upgrade Android Gradle Plugin from 8.0.0 to 8.4.0
- Upgrade Google Services plugin from 4.3.15 to 4.4.0
- Upgrade Android SDK from API 33 to API 34
- Upgrade Gradle wrapper from 8.13 to 8.14
- Upgrade Android Gradle wrapper from 8.0.2 to 8.6
- Update AndroidX library versions for API 34 compatibility
- Fix Jest environment configuration issue
- All tests passing (58/58) after upgrades
Resolves: Gradle upgrade requirements for callback system implementation
- Update package.json with modern build tooling and dependencies
- Streamline and enhance TypeScript definitions for better type safety
- Reorganize plugin structure for better maintainability
- Add comprehensive interface definitions for notification features
- Implement proper build configuration with rollup
- Update tsconfig.json for stricter type checking and ES2020 modules
Breaking Changes:
- Changed module structure to use ES modules
- Updated interface definitions with stricter typing
- Removed redundant notification options
- Simplified API surface while maintaining core functionality
Dependencies:
- Upgrade @capacitor dependencies to v5.7.8
- Add rollup and typescript build tools
- Update test framework configuration
- Add BatteryOptimizationSettings class for centralized power management
- Implement adaptive scheduling based on power state and battery level
- Add comprehensive battery monitoring and status tracking
- Improve notification reliability with WorkManager integration
- Add maintenance worker for background tasks
- Enhance logging with structured DailyNotificationLogger
- Add configuration management with DailyNotificationConfig
- Define constants in DailyNotificationConstants
- Improve error handling and recovery mechanisms
Security:
- Add proper permission checks for battery optimization
- Implement secure wake lock management
- Add validation for notification parameters
- Use FLAG_IMMUTABLE for PendingIntents
- Implement proper cleanup in handleOnDestroy
Testing:
- Add test coverage for battery optimization features
- Add test coverage for notification scheduling
- Add test coverage for power state management
- Add test coverage for maintenance tasks
Documentation:
- Add comprehensive file-level documentation
- Add method-level documentation
- Add security considerations
- Add performance optimization notes
This commit improves the Android implementation's reliability and battery
efficiency while maintaining feature parity with iOS. It adds robust
error handling, logging, and configuration management to make the plugin
more maintainable and debuggable.
- Add build scripts for Android and iOS platforms
- Remove duplicate web implementation (src/web.ts)
- Add proper TypeScript configuration
- Add module documentation to index.ts
- Clean up package.json scripts
This commit improves the project structure and build process by:
1. Adding dedicated build scripts for native platforms
2. Removing redundant web implementation
3. Adding proper TypeScript configuration with strict mode
4. Improving code documentation
5. Organizing package.json scripts
The changes maintain backward compatibility while improving
the development experience and code quality.
Matthew Raymer
Matthew Raymer
Server