native-update 1.4.9 → 3.1.0

package/docs/tracking/seo-checklist-tracker.json

@@ -0,0 +1,333 @@
+{
+  "project": "native-update",
+  "projectUrl": "https://nativeupdate.aoneahsan.com",
+  "projectDescription": "Capacitor plugin for OTA updates, app store updates & in-app reviews",
+  "createdAt": "2026-04-10",
+  "lastUpdated": "2026-04-10",
+  "summary": {
+    "totalItems": 47,
+    "completed": 14,
+    "inProgress": 0,
+    "pending": 22,
+    "notApplicable": 0,
+    "requiresDeployment": 11
+  },
+  "phases": {
+    "phase1_technical_foundation": {
+      "name": "Phase 1: Technical Foundation",
+      "description": "Core technical SEO setup that must be done first",
+      "items": [
+        {
+          "id": "P1-01",
+          "task": "Google Search Console - Add property, verify via HTML meta tag or DNS TXT, submit sitemap.xml",
+          "status": "requires_deployment",
+          "notes": "Must deploy first, then verify at search.google.com/search-console",
+          "implementedAt": null
+        },
+        {
+          "id": "P1-02",
+          "task": "Bing Webmaster Tools - Add site, verify via meta tag, submit sitemap.xml, import from GSC",
+          "status": "requires_deployment",
+          "notes": "bing.com/webmasters - has auto-import from Google Search Console",
+          "implementedAt": null
+        },
+        {
+          "id": "P1-03",
+          "task": "Yandex Webmaster - Add site, verify via meta tag, submit sitemap.xml",
+          "status": "requires_deployment",
+          "notes": "webmaster.yandex.com",
+          "implementedAt": null
+        },
+        {
+          "id": "P1-04",
+          "task": "Sitemap.xml - Ensure valid sitemap exists at /sitemap.xml with all public pages",
+          "status": "completed",
+          "notes": "Cleaned up: removed internal docs (reports, trackers, plans), login/signup. Now 62 clean public URLs.",
+          "implementedAt": "2026-04-10"
+        },
+        {
+          "id": "P1-05",
+          "task": "robots.txt - Ensure it exists and points to sitemap with correct project URL",
+          "status": "completed",
+          "notes": "Already exists with AI crawler allowlisting and correct sitemap URL",
+          "implementedAt": "2026-03-27"
+        },
+        {
+          "id": "P1-06",
+          "task": "SSL Certificate - All pages must be HTTPS",
+          "status": "completed",
+          "notes": "Already served via HTTPS on nativeupdate.aoneahsan.com",
+          "implementedAt": "2025-12-27"
+        },
+        {
+          "id": "P1-07",
+          "task": "Mobile Responsive - Test at search.google.com/test/mobile-friendly",
+          "status": "requires_deployment",
+          "notes": "Deploy then test. Site uses Tailwind CSS with responsive design.",
+          "implementedAt": null
+        },
+        {
+          "id": "P1-08",
+          "task": "Page Speed - Test at pagespeed.web.dev, aim for 90+ mobile",
+          "status": "requires_deployment",
+          "notes": "Deploy then test. Optimize based on results.",
+          "implementedAt": null
+        },
+        {
+          "id": "P1-09",
+          "task": "Core Web Vitals - Check in GSC after a few weeks. LCP < 2.5s, FID < 100ms, CLS < 0.1",
+          "status": "requires_deployment",
+          "notes": "Needs GSC data accumulation over weeks",
+          "implementedAt": null
+        }
+      ]
+    },
+    "phase2_on_page_seo": {
+      "name": "Phase 2: On-Page SEO",
+      "description": "Per-page SEO optimization for every public page",
+      "items": [
+        {
+          "id": "P2-01",
+          "task": "Title Tags - Every page needs unique <title> under 60 chars",
+          "status": "completed",
+          "notes": "usePageSEO hook applied to all 14 public pages with unique titles",
+          "implementedAt": "2026-04-10"
+        },
+        {
+          "id": "P2-02",
+          "task": "Meta Descriptions - Every page needs unique <meta description> under 155 chars",
+          "status": "completed",
+          "notes": "usePageSEO hook sets per-page descriptions on all 14 public pages",
+          "implementedAt": "2026-04-10"
+        },
+        {
+          "id": "P2-03",
+          "task": "H1 Tags - One H1 per page matching the page topic",
+          "status": "completed",
+          "notes": "Verified: all pages have exactly one H1 tag. Hidden SEO div also has H1 for crawlers.",
+          "implementedAt": "2026-04-10"
+        },
+        {
+          "id": "P2-04",
+          "task": "H2/H3 Structure - Logical heading hierarchy on every page",
+          "status": "completed",
+          "notes": "Pages use proper H1->H2->H3 hierarchy. Hidden SEO div has structured headings.",
+          "implementedAt": "2026-04-10"
+        },
+        {
+          "id": "P2-05",
+          "task": "Image Alt Text - Every image needs descriptive alt text",
+          "status": "pending",
+          "notes": "Need to audit all img/svg elements across pages for alt text",
+          "implementedAt": null
+        },
+        {
+          "id": "P2-06",
+          "task": "Internal Linking - Cross-link related pages (features->docs, pricing->features, etc.)",
+          "status": "pending",
+          "notes": "Pages have some CTAs but need more cross-linking for SEO juice",
+          "implementedAt": null
+        },
+        {
+          "id": "P2-07",
+          "task": "Canonical URLs - Add <link rel=canonical> per page to prevent duplicates",
+          "status": "completed",
+          "notes": "usePageSEO hook sets per-page canonical URL on every page dynamically",
+          "implementedAt": "2026-04-10"
+        },
+        {
+          "id": "P2-08",
+          "task": "Structured Data / Schema Markup - JSON-LD per page type (WebApplication, FAQPage, Article, BreadcrumbList)",
+          "status": "completed",
+          "notes": "BreadcrumbList auto-generated per page via usePageSEO. SoftwareApplication, FAQPage (10 Q&A), WebSite, Organization in postbuild.",
+          "implementedAt": "2026-04-10"
+        },
+        {
+          "id": "P2-09",
+          "task": "Open Graph tags - Per-page og:title, og:description, og:url, og:image",
+          "status": "completed",
+          "notes": "usePageSEO hook sets per-page OG tags on all pages",
+          "implementedAt": "2026-04-10"
+        },
+        {
+          "id": "P2-10",
+          "task": "Twitter Card tags - Per-page twitter:title, twitter:description",
+          "status": "completed",
+          "notes": "usePageSEO hook sets per-page Twitter Card tags on all pages",
+          "implementedAt": "2026-04-10"
+        }
+      ]
+    },
+    "phase3_content_seo": {
+      "name": "Phase 3: Content SEO",
+      "description": "Content strategy for long-tail keywords and organic traffic",
+      "items": [
+        {
+          "id": "P3-01",
+          "task": "Blog section - Create blog route and infrastructure for SEO content",
+          "status": "pending",
+          "notes": "No blog exists yet. Need /blog route with markdown-based posts.",
+          "implementedAt": null
+        },
+        {
+          "id": "P3-02",
+          "task": "Blog Posts - Write 5-10 initial posts targeting long-tail keywords",
+          "status": "pending",
+          "notes": "Topics: 'how to deploy OTA updates capacitor', 'capacitor vs codepush', 'mobile app update strategies', etc.",
+          "implementedAt": null
+        },
+        {
+          "id": "P3-03",
+          "task": "Keyword Research - Identify target keywords using free tools",
+          "status": "pending",
+          "notes": "Google Keyword Planner, Ubersuggest, AnswerThePublic, Google Autocomplete",
+          "implementedAt": null
+        },
+        {
+          "id": "P3-04",
+          "task": "FAQ Sections - Add visible FAQ with schema on key pages (home, features, pricing, docs)",
+          "status": "pending",
+          "notes": "FAQ schema exists in postbuild (expanded to 10 Q&A) but no visible FAQ sections on pages yet",
+          "implementedAt": null
+        },
+        {
+          "id": "P3-05",
+          "task": "Long-form feature descriptions - 300-500 words of unique content per feature page",
+          "status": "pending",
+          "notes": "Features page exists but may need more descriptive content per feature",
+          "implementedAt": null
+        }
+      ]
+    },
+    "phase4_niche_seo": {
+      "name": "Phase 4: Niche & Competitive SEO",
+      "description": "Niche-specific and competitive positioning content",
+      "items": [
+        {
+          "id": "P4-01",
+          "task": "Capacitor-specific keywords - Target 'capacitor ota updates', 'capacitor live updates plugin', 'capacitor code push alternative'",
+          "status": "pending",
+          "notes": "These are the primary niche keywords for this product",
+          "implementedAt": null
+        },
+        {
+          "id": "P4-02",
+          "task": "Comparison blog posts - 'Native Update vs CodePush', 'Native Update vs Capgo', 'Best Capacitor OTA plugins 2026'",
+          "status": "pending",
+          "notes": "Create honest comparison content highlighting strengths",
+          "implementedAt": null
+        },
+        {
+          "id": "P4-03",
+          "task": "Feature-specific landing content - Each feature (OTA, app updates, reviews) should have rich descriptive content",
+          "status": "pending",
+          "notes": "Dedicated feature pages exist in /docs/features/ but marketing pages need richer content",
+          "implementedAt": null
+        }
+      ]
+    },
+    "phase5_monitoring": {
+      "name": "Phase 5: Monitoring & Iteration",
+      "description": "Ongoing monitoring and optimization",
+      "items": [
+        {
+          "id": "P5-01",
+          "task": "Google Search Console - Weekly check: queries, indexed pages, errors",
+          "status": "requires_deployment",
+          "notes": "Requires GSC setup first (P1-01)",
+          "implementedAt": null
+        },
+        {
+          "id": "P5-02",
+          "task": "Track Rankings - Use free tier Ubersuggest/SERPRobot for 10-20 priority keywords",
+          "status": "pending",
+          "notes": "Set up after deployment and GSC verification",
+          "implementedAt": null
+        },
+        {
+          "id": "P5-03",
+          "task": "Fix Crawl Errors - Check GSC Coverage and fix any errors",
+          "status": "requires_deployment",
+          "notes": "Requires GSC data",
+          "implementedAt": null
+        },
+        {
+          "id": "P5-04",
+          "task": "Update Content - Refresh content every 3-6 months",
+          "status": "pending",
+          "notes": "Set reminder for quarterly content refresh",
+          "implementedAt": null
+        }
+      ]
+    },
+    "aeo_aio_optimization": {
+      "name": "AEO & AIO Optimization",
+      "description": "Answer Engine Optimization and AI Optimization for ChatGPT, Claude, Perplexity visibility",
+      "items": [
+        {
+          "id": "AI-01",
+          "task": "FAQ Schema - Add FAQPage JSON-LD to main pages and blog posts",
+          "status": "completed",
+          "notes": "Expanded to 10 Q&A pairs in postbuild-seo.ts covering installation, CodePush comparison, rollback, staged rollouts, security, platform support.",
+          "implementedAt": "2026-04-10"
+        },
+        {
+          "id": "AI-02",
+          "task": "Answer-First Content - Start descriptions with direct, concise answers in first paragraph",
+          "status": "pending",
+          "notes": "Review all page content for answer-first structure",
+          "implementedAt": null
+        },
+        {
+          "id": "AI-03",
+          "task": "How-to Guides - Step-by-step guides for common tasks",
+          "status": "pending",
+          "notes": "Docs have some guides. Need blog posts with 'How to' format.",
+          "implementedAt": null
+        },
+        {
+          "id": "AI-04",
+          "task": "Definition-Style Openings - Clear definitions at start of key pages",
+          "status": "pending",
+          "notes": "'Native Update is a Capacitor plugin that...' pattern on all key pages",
+          "implementedAt": null
+        },
+        {
+          "id": "AI-05",
+          "task": "Comparison Content - 'Native Update vs X' style content",
+          "status": "pending",
+          "notes": "Same as P4-02, cross-referenced",
+          "implementedAt": null
+        },
+        {
+          "id": "AI-06",
+          "task": "Structured Data Everywhere - Maximum schema markup coverage",
+          "status": "completed",
+          "notes": "WebSite, Organization, SoftwareApplication, FAQPage in postbuild. BreadcrumbList per-page via usePageSEO hook.",
+          "implementedAt": "2026-04-10"
+        },
+        {
+          "id": "AI-07",
+          "task": "Clear Product Description - 2-3 sentence quotable description for AI systems",
+          "status": "completed",
+          "notes": "Updated index.html hidden content with detailed, specific, quotable description including feature names and specifics.",
+          "implementedAt": "2026-04-10"
+        },
+        {
+          "id": "AI-08",
+          "task": "Be Specific - Use exact numbers and specifics instead of vague claims",
+          "status": "completed",
+          "notes": "Updated descriptions to include '3 core features', specific feature names, framework list, installation commands.",
+          "implementedAt": "2026-04-10"
+        },
+        {
+          "id": "AI-09",
+          "task": "AI Crawler Access in robots.txt - Allow GPTBot, ClaudeBot, PerplexityBot etc.",
+          "status": "completed",
+          "notes": "Already implemented in robots.txt with full AI crawler allowlisting",
+          "implementedAt": "2026-03-27"
+        }
+      ]
+    }
+  }
+}

package/ios/Plugin/BackgroundUpdate/BackgroundUpdatePlugin.swift

@@ -3,9 +3,23 @@ import Capacitor
 import BackgroundTasks
 import UserNotifications
 
+/// BackgroundUpdatePlugin schedules silent OTA update checks via
+/// `BGAppRefreshTask` on iOS 13+. The host app **must** declare the
+/// scheduler identifier in its own `Info.plist` — the framework's plist
+/// declaration does not propagate into the app bundle. Add:
+///
+///     <key>BGTaskSchedulerPermittedIdentifiers</key>
+///     <array>
+///         <string>com.aoneahsan.nativeupdate.background</string>
+///     </array>
+///
+/// and (for the Capabilities pane) ensure `background-app-refresh` is
+/// listed under `UIBackgroundModes`. Without those entries iOS will
+/// silently refuse to register the task and background updates never
+/// run — there is no runtime error.
 @objc(BackgroundUpdatePlugin)
 public class BackgroundUpdatePlugin: CAPPlugin {
-    
+
     private let backgroundTaskIdentifier = "com.aoneahsan.nativeupdate.background"
     private var backgroundUpdateConfig: BackgroundUpdateConfig?
     private var backgroundUpdateStatus = BackgroundUpdateStatus(
@@ -25,7 +39,13 @@ public class BackgroundUpdatePlugin: CAPPlugin {
         // Register background task
         if #available(iOS 13.0, *) {
             BGTaskScheduler.shared.register(forTaskWithIdentifier: backgroundTaskIdentifier, using: nil) { task in
-                self.handleBackgroundTask(task: task as! BGAppRefreshTask)
+                guard let refreshTask = task as? BGAppRefreshTask else {
+                    // Force-casting here would crash the host app process
+                    // if Apple ever delivers a different concrete type.
+                    task.setTaskCompleted(success: false)
+                    return
+                }
+                self.handleBackgroundTask(task: refreshTask)
             }
         }
     }
@@ -121,31 +141,68 @@ public class BackgroundUpdatePlugin: CAPPlugin {
     
     // MARK: - Private Methods
     
-    private func disableBackgroundUpdates() {
+    /// Plain Swift call — used by `NativeUpdatePlugin.cleanup()` so it
+    /// doesn't have to manufacture a `CAPPluginCall` (the relevant
+    /// initializer is internal in the public Capacitor SDK).
+    func disableBackgroundUpdatesInternal() {
         backgroundUpdateStatus.enabled = false
         backgroundUpdateStatus.isRunning = false
         backgroundUpdateStatus.currentTaskId = nil
-        
+
         if #available(iOS 13.0, *) {
             BGTaskScheduler.shared.cancel(taskRequestWithIdentifier: backgroundTaskIdentifier)
         }
     }
+
+    private func disableBackgroundUpdates() {
+        disableBackgroundUpdatesInternal()
+    }
     
     private func scheduleBackgroundTask(interval: Int) {
         guard #available(iOS 13.0, *) else {
-            NSLog("BackgroundTasks framework not available on iOS < 13.0")
+            NSLog("[native-update] BackgroundTasks framework not available on iOS < 13.0")
             return
         }
-        
+
+        // Cancel any prior pending request with this identifier before
+        // submitting a new one. iOS documents submit() as replacing an
+        // existing request of the same identifier, but a few OS versions
+        // have been observed to fail the second submit with an
+        // already-scheduled error instead of replacing. Explicit cancel
+        // is the reliable path.
+        BGTaskScheduler.shared.cancel(taskRequestWithIdentifier: backgroundTaskIdentifier)
+
         let request = BGAppRefreshTaskRequest(identifier: backgroundTaskIdentifier)
         request.earliestBeginDate = Date(timeIntervalSinceNow: TimeInterval(interval / 1000))
-        
+
         do {
             try BGTaskScheduler.shared.submit(request)
             backgroundUpdateStatus.nextCheckTime = Int(Date().timeIntervalSince1970 * 1000) + interval
-            NSLog("Background task scheduled for \(interval)ms from now")
+            NSLog("[native-update] Background task scheduled for \(interval)ms from now")
+        } catch let error as BGTaskScheduler.Error {
+            // Surface a specific diagnostic. .notPermitted almost always
+            // means the host app's Info.plist is missing the scheduler
+            // identifier — which is a silent failure mode otherwise.
+            switch error.code {
+            case .notPermitted:
+                NSLog("[native-update] BGTaskScheduler .notPermitted — host app is missing BGTaskSchedulerPermittedIdentifiers entry for \(backgroundTaskIdentifier) in Info.plist")
+            case .tooManyPendingTaskRequests:
+                NSLog("[native-update] BGTaskScheduler .tooManyPendingTaskRequests — another task is already queued; background updates will run on the existing schedule")
+            case .unavailable:
+                NSLog("[native-update] BGTaskScheduler .unavailable — background tasks are disabled on this device (likely simulator or Low Power Mode)")
+            @unknown default:
+                NSLog("[native-update] Failed to schedule background task: \(error.localizedDescription)")
+            }
+            backgroundUpdateStatus.lastError = UpdateError(
+                code: "BGTASK_SUBMIT_FAILED",
+                message: error.localizedDescription
+            )
         } catch {
-            NSLog("Failed to schedule background task: \(error.localizedDescription)")
+            NSLog("[native-update] Failed to schedule background task: \(error.localizedDescription)")
+            backgroundUpdateStatus.lastError = UpdateError(
+                code: "BGTASK_SUBMIT_FAILED",
+                message: error.localizedDescription
+            )
         }
     }