proofcite-capacitor-overlay 0.1.0

package/README.md

@@ -0,0 +1,27 @@
+# proofcite-capacitor-overlay
+
+Native Android Capacitor plugin for ProofCite's floating CHECK bubble.
+
+## API
+
+- `checkPermission()`
+- `requestPermission()`
+- `startOverlay()`
+- `stopOverlay()`
+- `getStatus()`
+- event `checkPressed`
+
+## Intended ProofCite flow
+
+1. ProofCite opens visibly.
+2. User starts Prüfmodus.
+3. App requests `SYSTEM_ALERT_WINDOW` if needed.
+4. App starts the overlay service.
+5. User switches to Instagram/TikTok/etc.
+6. Bubble stays visible and can be dragged.
+7. Tap emits `checkPressed` through Capacitor.
+8. ProofCite's JS handler triggers the already-existing screenshot/MediaProjection path and sends the image to the fact-check endpoint.
+
+## Important
+
+This package only draws the overlay and emits the click event. It deliberately does not own MediaProjection consent or the fact-check backend; those stay in the main ProofCite app.

package/android/build.gradle

@@ -0,0 +1,31 @@
+ext {
+    junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
+}
+
+buildscript {
+    repositories { google(); mavenCentral() }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.7.2'
+    }
+}
+
+apply plugin: 'com.android.library'
+
+android {
+    namespace "com.proofcite.overlay"
+    compileSdk project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 35
+
+    defaultConfig {
+        minSdk project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 23
+        targetSdk project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 35
+        versionCode 1
+        versionName "0.1.0"
+    }
+}
+
+repositories { google(); mavenCentral() }
+
+dependencies {
+    implementation project(':capacitor-android')
+    testImplementation "junit:junit:$junitVersion"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,10 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
+
+    <application>
+        <service
+            android:name=".ProofCiteOverlayService"
+            android:exported="false"
+            android:stopWithTask="false" />
+    </application>
+</manifest>

package/android/src/main/java/com/proofcite/overlay/ProofCiteOverlayPlugin.kt

@@ -0,0 +1,69 @@
+package com.proofcite.overlay
+
+import android.content.Intent
+import android.net.Uri
+import android.provider.Settings
+import com.getcapacitor.JSObject
+import com.getcapacitor.Plugin
+import com.getcapacitor.PluginCall
+import com.getcapacitor.PluginMethod
+import com.getcapacitor.annotation.CapacitorPlugin
+
+@CapacitorPlugin(name = "ProofCiteOverlay")
+class ProofCiteOverlayPlugin : Plugin() {
+
+    override fun load() {
+        ProofCiteOverlayState.listener = {
+            notifyListeners("checkPressed", JSObject())
+        }
+    }
+
+    override fun handleOnDestroy() {
+        ProofCiteOverlayState.listener = null
+        super.handleOnDestroy()
+    }
+
+    @PluginMethod
+    fun checkPermission(call: PluginCall) {
+        val result = JSObject()
+        result.put("granted", Settings.canDrawOverlays(context))
+        call.resolve(result)
+    }
+
+    @PluginMethod
+    fun requestPermission(call: PluginCall) {
+        if (Settings.canDrawOverlays(context)) {
+            val result = JSObject(); result.put("granted", true); call.resolve(result); return
+        }
+        val intent = Intent(
+            Settings.ACTION_MANAGE_OVERLAY_PERMISSION,
+            Uri.parse("package:${context.packageName}")
+        ).apply { addFlags(Intent.FLAG_ACTIVITY_NEW_TASK) }
+        context.startActivity(intent)
+        val result = JSObject(); result.put("granted", false); call.resolve(result)
+    }
+
+    @PluginMethod
+    fun startOverlay(call: PluginCall) {
+        if (!Settings.canDrawOverlays(context)) {
+            call.reject("Overlay permission not granted")
+            return
+        }
+        context.startService(Intent(context, ProofCiteOverlayService::class.java))
+        call.resolve()
+    }
+
+    @PluginMethod
+    fun stopOverlay(call: PluginCall) {
+        context.stopService(Intent(context, ProofCiteOverlayService::class.java))
+        call.resolve()
+    }
+
+    @PluginMethod
+    fun getStatus(call: PluginCall) {
+        val result = JSObject()
+        result.put("visible", ProofCiteOverlayState.visible)
+        result.put("permissionGranted", Settings.canDrawOverlays(context))
+        call.resolve(result)
+    }
+}

package/android/src/main/java/com/proofcite/overlay/ProofCiteOverlayService.kt

@@ -0,0 +1,95 @@
+package com.proofcite.overlay
+
+import android.app.Service
+import android.content.Intent
+import android.graphics.Color
+import android.graphics.PixelFormat
+import android.graphics.Typeface
+import android.os.IBinder
+import android.view.Gravity
+import android.view.MotionEvent
+import android.view.View
+import android.view.WindowManager
+import android.widget.TextView
+import kotlin.math.abs
+
+class ProofCiteOverlayService : Service() {
+    private lateinit var windowManager: WindowManager
+    private var bubble: TextView? = null
+
+    override fun onCreate() {
+        super.onCreate()
+        windowManager = getSystemService(WINDOW_SERVICE) as WindowManager
+        showBubble()
+    }
+
+    override fun onBind(intent: Intent?): IBinder? = null
+
+    override fun onDestroy() {
+        bubble?.let { runCatching { windowManager.removeView(it) } }
+        bubble = null
+        ProofCiteOverlayState.visible = false
+        super.onDestroy()
+    }
+
+    private fun showBubble() {
+        if (bubble != null) return
+
+        val view = TextView(this).apply {
+            text = "CHECK"
+            setTextColor(Color.WHITE)
+            textSize = 14f
+            typeface = Typeface.DEFAULT_BOLD
+            gravity = Gravity.CENTER
+            setPadding(34, 22, 34, 22)
+            setBackgroundColor(Color.rgb(0, 174, 184))
+            elevation = 18f
+        }
+
+        val params = WindowManager.LayoutParams(
+            WindowManager.LayoutParams.WRAP_CONTENT,
+            WindowManager.LayoutParams.WRAP_CONTENT,
+            WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY,
+            WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE or
+                WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS,
+            PixelFormat.TRANSLUCENT
+        ).apply {
+            gravity = Gravity.TOP or Gravity.END
+            x = 24
+            y = 320
+        }
+
+        var downX = 0f
+        var downY = 0f
+        var startX = 0
+        var startY = 0
+
+        view.setOnTouchListener { _: View, event: MotionEvent ->
+            when (event.action) {
+                MotionEvent.ACTION_DOWN -> {
+                    downX = event.rawX
+                    downY = event.rawY
+                    startX = params.x
+                    startY = params.y
+                    true
+                }
+                MotionEvent.ACTION_MOVE -> {
+                    params.x = startX - (event.rawX - downX).toInt()
+                    params.y = startY + (event.rawY - downY).toInt()
+                    windowManager.updateViewLayout(view, params)
+                    true
+                }
+                MotionEvent.ACTION_UP -> {
+                    val moved = abs(event.rawX - downX) + abs(event.rawY - downY)
+                    if (moved < 18f) ProofCiteOverlayState.listener?.invoke()
+                    true
+                }
+                else -> false
+            }
+        }
+
+        windowManager.addView(view, params)
+        bubble = view
+        ProofCiteOverlayState.visible = true
+    }
+}

package/android/src/main/java/com/proofcite/overlay/ProofCiteOverlayState.kt

@@ -0,0 +1,6 @@
+package com.proofcite.overlay
+
+object ProofCiteOverlayState {
+    @Volatile var visible: Boolean = false
+    @Volatile var listener: (() -> Unit)? = null
+}

package/dist/esm/index.d.ts

@@ -0,0 +1,22 @@
+import type { PluginListenerHandle } from '@capacitor/core';
+
+export interface OverlayPermissionResult {
+  granted: boolean;
+}
+
+export interface OverlayStatusResult {
+  visible: boolean;
+  permissionGranted: boolean;
+}
+
+export interface ProofCiteOverlayPlugin {
+  checkPermission(): Promise<OverlayPermissionResult>;
+  requestPermission(): Promise<OverlayPermissionResult>;
+  startOverlay(): Promise<void>;
+  stopOverlay(): Promise<void>;
+  getStatus(): Promise<OverlayStatusResult>;
+  addListener(eventName: 'checkPressed', listenerFunc: () => void): Promise<PluginListenerHandle>;
+  removeAllListeners(): Promise<void>;
+}
+
+export declare const ProofCiteOverlay: ProofCiteOverlayPlugin;

package/dist/esm/index.js

@@ -0,0 +1,3 @@
+import { registerPlugin } from '@capacitor/core';
+
+export const ProofCiteOverlay = registerPlugin('ProofCiteOverlay');

package/dist/esm/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/dist/plugin.cjs.js

@@ -0,0 +1,7 @@
+'use strict';
+
+const core = require('@capacitor/core');
+
+const ProofCiteOverlay = core.registerPlugin('ProofCiteOverlay');
+
+exports.ProofCiteOverlay = ProofCiteOverlay;

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "proofcite-capacitor-overlay",
+  "version": "0.1.0",
+  "description": "Native Android floating CHECK overlay Capacitor plugin for ProofCite",
+  "main": "dist/plugin.cjs.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "files": [
+    "android/",
+    "dist/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "verify:android": "cd android && ./gradlew assembleDebug"
+  },
+  "peerDependencies": {
+    "@capacitor/core": ">=7.0.0"
+  },
+  "capacitor": {
+    "android": {
+      "src": "android"
+    }
+  },
+  "license": "UNLICENSED",
+  "keywords": [
+    "capacitor",
+    "android",
+    "overlay",
+    "floating-button",
+    "proofcite"
+  ]
+}