Commit Graph

21 Commits

Author SHA1 Message Date
ed8900275e docs: remove commentary where referenced eiles are missing 2025-11-11 18:50:19 -07:00
Matthew Raymer
37753bb051 docs: add comprehensive integration guides and diagnostic method documentation
Add integration guides and update API documentation with new Android
diagnostic methods. Emphasize critical NotifyReceiver registration
requirement that was causing notification delivery failures.

Documentation Updates:
- API.md: Document isAlarmScheduled(), getNextAlarmTime(), testAlarm()
- README.md: Add Quick Integration section and Android diagnostic methods
- notification-testing-procedures.md: Add BroadcastReceiver troubleshooting

New Integration Guides:
- QUICK_INTEGRATION.md: Step-by-step guide for human developers
- AI_INTEGRATION_GUIDE.md: Machine-readable guide with verification steps
- TODO.md: Task tracking for pending improvements

Key Improvements:
- Explicit NotifyReceiver registration requirement highlighted
- Complete troubleshooting flow for BroadcastReceiver issues
- Diagnostic method examples for debugging alarm scheduling
- AI-friendly integration instructions with verification commands

Fixes notification delivery issues caused by missing NotifyReceiver
registration in host app AndroidManifest.xml files.
2025-11-06 10:08:18 +00:00
Matthew Raymer
18106e5ba8 feat(android): consolidate databases and add prefetch scheduling
Consolidate Java and Kotlin database implementations into unified
schema, add delayed prefetch scheduling, and fix notification
delivery issues.

Database Consolidation:
- Merge Java DailyNotificationDatabase into Kotlin DatabaseSchema
- Add migration path from v1 to v2 unified schema
- Include all entities: ContentCache, Schedule, Callback, History,
  NotificationContentEntity, NotificationDeliveryEntity,
  NotificationConfigEntity
- Add @JvmStatic getInstance() for Java interoperability
- Update DailyNotificationWorker and DailyNotificationStorageRoom
  to use unified database

Prefetch Functionality:
- Add scheduleDelayedFetch() to FetchWorker for 5-minute prefetch
  before notifications
- Support delayed WorkManager scheduling with initialDelay
- Update scheduleDailyNotification() to optionally schedule prefetch
  when URL is provided

Notification Delivery Fixes:
- Register NotifyReceiver in AndroidManifest.xml (was missing,
  causing notifications not to fire)
- Add safe database initialization with lazy getDatabase() helper
- Prevent PluginLoadException on database init failure

Build Configuration:
- Add kotlin-android and kotlin-kapt plugins
- Configure Room annotation processor (kapt) for Kotlin
- Add Room KTX dependency for coroutines support
- Fix Gradle settings with pluginManagement blocks

Plugin Methods Added:
- checkPermissionStatus() - detailed permission status
- requestNotificationPermissions() - request POST_NOTIFICATIONS
- scheduleDailyNotification() - schedule with AlarmManager
- configureNativeFetcher() - configure native content fetcher
- Various status and configuration methods

Code Cleanup:
- Remove duplicate BootReceiver.java (keep Kotlin version)
- Remove duplicate DailyNotificationPlugin.java (keep Kotlin version)
- Remove old Java database implementation
- Add native fetcher SPI registry (@JvmStatic methods)

The unified database ensures schedule persistence across reboots
and provides a single source of truth for all plugin data.
Prefetch scheduling enables content caching before notifications
fire, improving offline-first reliability.
2025-11-06 06:28:00 +00:00
Matthew Raymer
d9bdeb6d02 refactor(android)!: restructure to standard Capacitor plugin layout
Restructure Android project from nested module layout to standard
Capacitor plugin structure following community conventions.

Structure Changes:
- Move plugin code from android/plugin/ to android/src/main/java/
- Move test app from android/app/ to test-apps/android-test-app/app/
- Remove nested android/plugin module structure
- Remove nested android/app test app structure

Build Infrastructure:
- Add Gradle wrapper files (gradlew, gradlew.bat, gradle/wrapper/)
- Transform android/build.gradle from root project to library module
- Update android/settings.gradle for standalone plugin builds
- Add android/gradle.properties with AndroidX configuration
- Add android/consumer-rules.pro for ProGuard rules

Configuration Updates:
- Add prepare script to package.json for automatic builds on npm install
- Update package.json version to 1.0.1
- Update android/build.gradle to properly resolve Capacitor dependencies
- Update test-apps/android-test-app/settings.gradle with correct paths
- Remove android/variables.gradle (hardcode values in build.gradle)

Documentation:
- Update BUILDING.md with new structure and build process
- Update INTEGRATION_GUIDE.md to reflect standard structure
- Update README.md to remove path fix warnings
- Add test-apps/BUILD_PROCESS.md documenting test app build flows

Test App Configuration:
- Fix android-test-app to correctly reference plugin and Capacitor
- Remove capacitor-cordova-android-plugins dependency (not needed)
- Update capacitor.settings.gradle path verification in fix script

BREAKING CHANGE: Plugin now uses standard Capacitor Android structure.
Consuming apps must update their capacitor.settings.gradle to reference
android/ instead of android/plugin/. This is automatically handled by
Capacitor CLI for apps using standard plugin installation.
2025-11-05 08:08:37 +00:00
Matthew Raymer
9ff5a8c588 docs: add comprehensive Android app analysis and improvement plan
- Add android-app-analysis.md: detailed analysis of /android/app structure and /www integration
- Add android-app-improvement-plan.md: phase-based implementation plan for architecture improvements
- Add chatgpt-analysis-guide.md: structured prompts for AI analysis of Android test app
- Update README.md: add links to new documentation files

These documents provide comprehensive guidance for understanding and improving the DailyNotification Android test app architecture.
2025-10-24 09:42:10 +00:00
Matthew Raymer
ef37b10503 docs: add comprehensive AAR integration troubleshooting guide
- 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.
2025-10-23 10:29:13 +00:00
Matthew Raymer
9b9dc25a8d feat: comprehensive emulator launch scripts with performance optimizations
- Add GPU-accelerated launch scripts with NVIDIA optimization
- Implement network connectivity troubleshooting and fixes
- Add CPU cores and memory allocation for better performance
- Disable Bluetooth to prevent hangs and ANRs
- Create comprehensive troubleshooting documentation
- Add multiple launch modes: GPU, OpenGL, ANGLE, Mesa, Network Fix
- Include network verification and diagnostic tools
- Add maximum performance mode for high-end systems
- Update documentation with detailed configuration options

Key improvements:
- GPU acceleration with Vulkan support
- Explicit DNS servers (8.8.8.8, 1.1.1.1) for network reliability
- CPU cores allocation (6-8 cores) for better performance
- Memory allocation (4-6GB) for smooth operation
- Bluetooth disabled (-feature -Bluetooth) to prevent hangs
- Clean state launches (-no-snapshot-load, -wipe-data)
- Comprehensive troubleshooting guides and verification scripts

All scripts include proper error checking, environment validation,
and detailed performance monitoring instructions.
2025-10-13 12:52:53 +00:00
Matthew Raymer
614ff7b5e4 docs: complete Phase 8 documentation and examples
- Update README with native-first architecture and compatibility matrix
- Enhance API documentation with TimeSafari-specific examples
- Update integration guide with current architecture and troubleshooting
- Add comprehensive observability dashboards guide
- Add accessibility and localization implementation guide
- Add legal and store compliance guide
- Add manual smoke testing documentation
- Update all documentation to reflect native-first architecture

Documentation: API reference, integration guide, observability, A11y, compliance
2025-10-08 06:19:14 +00:00
Matthew Raymer
09661a520f refactor: remove dead code and unused files
- Remove duplicate web implementation (src/web.ts - 1,129 lines)
- Remove unused DailyNotification wrapper class (src/daily-notification.ts - 288 lines)
- Remove unused callback registry (src/callback-registry.ts - 413 lines)
- Remove unused example files (5 files, ~1,500 lines)
- Remove unused TypeScript modules (moved to test-apps/shared/typescript/)
- Remove unused interfaces (ContentHandler, ScheduleOptions)
- Remove outdated documentation files (VERIFICATION_*, GLOSSARY, etc.)
- Update import paths in test apps to use moved TypeScript modules
- Clean up README and USAGE.md references to deleted files

Total cleanup: ~3,330+ lines of dead code removed
Files deleted: 20 files
Files modified: 6 files (import path updates and documentation cleanup)

This significantly reduces codebase complexity and maintenance burden.
2025-10-07 05:19:09 +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
b4cb3d5638 consolidate: Merge all analysis documents into single BACKGROUND_DATA_FETCHING_PLAN.md
- Consolidated DATABASE_ACCESS_CLARIFICATION.md content into main plan
- Consolidated ACTIVE_DID_CHANGE_REQUIREMENTS.md content into main plan
- Consolidated TIMESAFARI_INTEGRATION_ANALYSIS.md content into main plan
- Enhanced main document with Option A architecture overview
- Added comprehensive TimeSafari integration patterns section
- Added critical requirement section for activeDid change detection
- Added event-based solution implementation details
- Updated README.md to reference single consolidated document
- Eliminated unnecessary document proliferation as requested

The BACKGROUND_DATA_FETCHING_PLAN.md now serves as the single source of truth
for all implementation guidance, containing Option A architecture, TimeSafari
integration patterns, activeDid change management, and platform-specific details.
2025-10-02 09:20:43 +00:00
Matthew Raymer
77b6a8f497 docs: Update README with Option A background data fetching docs
- Added reference to BACKGROUND_DATA_FETCHING_PLAN.md with host-provided activeDid architecture
- Added reference to new DATABASE_ACCESS_CLARIFICATION.md document
- Provides clear documentation links for the Option A implementation approach
2025-10-02 09:16:42 +00:00
Matthew Raymer
a81b205e1f docs: Add comprehensive UI requirements and integration examples
- Add UI_REQUIREMENTS.md with detailed UI component specifications
- Add ui-integration-examples.ts with ready-to-use UI components
- Document all required UI elements for plugin integration
- Include platform-specific UI components (Android/iOS/Web)
- Provide complete implementation examples with TypeScript
- Add responsive design guidelines and accessibility requirements
- Include error handling and status monitoring UI components
- Update README.md to reference new UI documentation

UI Components Covered:
 Permission management dialogs and status displays
 Configuration panels for settings and preferences
 Status dashboards with real-time monitoring
 Platform-specific components (battery optimization, background refresh)
 Error handling and recovery UI
 Testing and debug components
 Complete integration examples with event handling
2025-09-28 05:24:28 +00:00
Matthew Raymer
3d27046c0d docs: Add comprehensive verification report and checklist for closed-app functionality
- Add VERIFICATION_REPORT.md with detailed analysis of closed-app requirements
- Add VERIFICATION_CHECKLIST.md for regular verification process
- Update README.md to reference verification documentation
- Document all test scenarios and platform-specific implementations
- Include performance metrics and security considerations
- Define quarterly verification schedule and success criteria

The verification report confirms the plugin meets all requirements:
 Local notifications from device database
 Data populated by scheduled network fetches
 Works when app is closed
 TTL enforcement and error handling
 Cross-platform support with platform optimizations
2025-09-28 02:09:33 +00:00
Matthew Raymer
999b824a36 docs: update README with Phase 2 completion status
- Add implementation status table showing all components complete
- Include testing and quality metrics (58 tests, build status)
- Update version information with production-ready status
- Clarify that all platforms have complete feature parity
- Highlight enterprise-grade functionality across Android, iOS, Web
2025-09-22 11:07:38 +00:00
Matthew Raymer
8817025b86 docs!: add comprehensive migration guide and enterprise callback examples
- Add complete migration guide with step-by-step instructions
- Include platform-specific configuration examples (Android, iOS, Web)
- Provide comprehensive enterprise callback examples
- Cover analytics integration (GA4, Mixpanel)
- Include CRM integration (Salesforce, HubSpot)
- Add database operations (PostgreSQL, MongoDB)
- Include monitoring & alerting (Datadog, New Relic)
- Provide multi-service orchestration examples
- Add error handling patterns (circuit breaker, retry logic)
- Include performance optimization techniques
- Add security best practices and authentication
- Update main README with complete API reference
- Include troubleshooting and testing guidance

BREAKING CHANGE: Documentation structure updated with new migration path
2025-09-22 11:03:41 +00:00
Matthew Raymer
fcc4e52d5d chore: document formatting rules 2025-09-22 07:27:01 +00:00
Matthew Raymer
956abff320 feat: add minimal Capacitor test apps for all platforms
- Add Android test app with exact alarm permission testing
- Add iOS test app with rolling window and BGTaskScheduler testing
- Add Electron test app with mock implementations and IPC
- Include automated setup scripts for each platform
- Provide comprehensive testing checklist and troubleshooting guide
- Follow best practices for Capacitor plugin testing

Test apps include:
- Plugin configuration and scheduling validation
- Platform-specific feature testing (Android exact alarms, iOS rolling window)
- Performance monitoring and debug information
- Error handling and edge case testing
- Cross-platform API consistency validation

Setup: Run ./setup-*.sh scripts for automated platform setup
Testing: Each app provides interactive UI for comprehensive plugin validation

Files: 25+ new files across test-apps/ directory
2025-09-09 05:24:27 +00:00
Matthew Raymer
a336b39754 refactor(plugin): modernize plugin architecture and improve type definitions
- 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
2025-03-28 12:47:10 +00:00
Server
9994db28bd feat: implement core notification functionality for iOS and Android - Add settings management, proper error handling, and platform-specific implementations 2025-03-27 01:50:19 -07:00
Matthew Raymer
71e0f297ff refactor: improve build configuration and code organization
- 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.
2025-03-25 13:13:55 +00:00