expo-app-blocker 0.1.0

package/src/index.ts

@@ -0,0 +1,225 @@
+import {
+  requireNativeModule,
+  requireNativeViewManager,
+  EventEmitter,
+} from "expo-modules-core";
+import { Platform } from "react-native";
+import React from "react";
+
+import type {
+  PermissionStatus,
+  AndroidPermissions,
+  IOSPermissions,
+  AndroidBlockableApp,
+  IOSBlockedItem,
+  IOSBlockConfiguration,
+  TemporaryUnlockResult,
+  RelockResult,
+} from "./ExpoAppBlocker.types";
+
+export type {
+  PermissionStatus,
+  AndroidPermissions,
+  IOSPermissions,
+  AndroidBlockableApp,
+  IOSBlockedItem,
+  IOSBlockConfiguration,
+  TemporaryUnlockResult,
+  RelockResult,
+  ShieldConfig,
+  PluginConfig,
+} from "./ExpoAppBlocker.types";
+
+// ──────────────────────────────────────────────────────────────────────────────
+// Native module bridge
+// ──────────────────────────────────────────────────────────────────────────────
+
+const NativeModule = requireNativeModule("ExpoAppBlocker");
+
+// ──────────────────────────────────────────────────────────────────────────────
+// Permissions
+// ──────────────────────────────────────────────────────────────────────────────
+
+export async function getPermissionStatus(): Promise<PermissionStatus> {
+  if (Platform.OS === "android") {
+    const overlay = await NativeModule.checkOverlayPermission();
+    const usageStats = await NativeModule.checkUsageStatsPermission();
+    const details: AndroidPermissions = { platform: "android", overlay, usageStats };
+    return { allGranted: overlay && usageStats, details };
+  }
+
+  if (Platform.OS === "ios") {
+    const result = NativeModule.getAuthorizationStatus();
+    const details: IOSPermissions = {
+      platform: "ios",
+      authorized: result.authorized,
+      status: result.status,
+    };
+    return { allGranted: result.authorized, details };
+  }
+
+  throw new Error("Unsupported platform");
+}
+
+export async function requestPermissions(): Promise<PermissionStatus> {
+  if (Platform.OS === "ios") {
+    const result = await NativeModule.requestAuthorization();
+    const details: IOSPermissions = {
+      platform: "ios",
+      authorized: result.authorized,
+      status: result.status,
+    };
+    return { allGranted: result.authorized, details };
+  }
+  return getPermissionStatus();
+}
+
+// ──────────────────────────────────────────────────────────────────────────────
+// Android-specific: permission settings
+// ──────────────────────────────────────────────────────────────────────────────
+
+export function openOverlaySettings(): void {
+  if (Platform.OS !== "android") return;
+  NativeModule.openOverlaySettings();
+}
+
+export function openUsageStatsSettings(): void {
+  if (Platform.OS !== "android") return;
+  NativeModule.openUsageStatsSettings();
+}
+
+// ──────────────────────────────────────────────────────────────────────────────
+// Android-specific: app list and blocking
+// ──────────────────────────────────────────────────────────────────────────────
+
+export async function getInstalledApps(): Promise<AndroidBlockableApp[]> {
+  if (Platform.OS !== "android") return [];
+  return NativeModule.getInstalledApps();
+}
+
+export function setBlockedApps(packageNames: string[]): void {
+  if (Platform.OS !== "android") return;
+  NativeModule.setBlockedApps(packageNames);
+}
+
+export function getBlockedApps(): string[] {
+  if (Platform.OS !== "android") return [];
+  return NativeModule.getBlockedApps();
+}
+
+export function startMonitoring(): void {
+  if (Platform.OS !== "android") return;
+  NativeModule.startMonitoring();
+}
+
+export function stopMonitoring(): void {
+  if (Platform.OS !== "android") return;
+  NativeModule.stopMonitoring();
+}
+
+// ──────────────────────────────────────────────────────────────────────────────
+// iOS-specific: Family Controls
+// ──────────────────────────────────────────────────────────────────────────────
+
+export async function presentFamilyActivityPicker(): Promise<IOSBlockedItem[]> {
+  if (Platform.OS !== "ios") {
+    throw new Error("Family Activity Picker is only available on iOS");
+  }
+  return NativeModule.presentFamilyActivityPicker();
+}
+
+export async function setBlockConfiguration(config: IOSBlockConfiguration): Promise<void> {
+  if (Platform.OS !== "ios") {
+    throw new Error("Block configuration is only available on iOS");
+  }
+  return NativeModule.setBlockConfiguration(config);
+}
+
+export function getBlockConfiguration(): IOSBlockConfiguration | null {
+  if (Platform.OS !== "ios") return null;
+  return NativeModule.getBlockConfiguration();
+}
+
+export function clearAllBlocks(): void {
+  if (Platform.OS !== "ios") return;
+  NativeModule.clearAllBlocks();
+}
+
+export function isAppBlocked(bundleIdentifier: string): boolean {
+  if (Platform.OS !== "ios") return false;
+  return NativeModule.isAppBlocked(bundleIdentifier);
+}
+
+// ──────────────────────────────────────────────────────────────────────────────
+// iOS-specific: Temporary unlock
+// ──────────────────────────────────────────────────────────────────────────────
+
+export async function temporaryUnlock(durationMinutes: number = 15): Promise<TemporaryUnlockResult> {
+  if (Platform.OS !== "ios") {
+    throw new Error("Temporary unlock is only available on iOS");
+  }
+  return NativeModule.temporaryUnlock(durationMinutes);
+}
+
+export function isTemporarilyUnlocked(): boolean {
+  if (Platform.OS !== "ios") return false;
+  return NativeModule.isTemporarilyUnlocked();
+}
+
+export function getRemainingUnlockTime(): number {
+  if (Platform.OS !== "ios") return 0;
+  return NativeModule.getRemainingUnlockTime();
+}
+
+export async function relockApps(): Promise<RelockResult> {
+  if (Platform.OS !== "ios") {
+    throw new Error("Relock is only available on iOS");
+  }
+  return NativeModule.relockApps();
+}
+
+export function checkAndClearPendingUnlock(): boolean {
+  if (Platform.OS !== "ios") return false;
+  return NativeModule.checkAndClearPendingUnlock();
+}
+
+export function addPendingUnlockListener(
+  handler: () => void
+): { remove: () => void } | null {
+  if (Platform.OS !== "ios") return null;
+  const emitter = new EventEmitter(NativeModule);
+  return (emitter as any).addListener("onPendingUnlockRequest", handler);
+}
+
+// ──────────────────────────────────────────────────────────────────────────────
+// iOS Native View: renders blocked app tokens with real names and icons
+// ──────────────────────────────────────────────────────────────────────────────
+
+let NativeBlockedAppsView: any = null;
+if (Platform.OS === "ios") {
+  try {
+    NativeBlockedAppsView = requireNativeViewManager("ExpoAppBlocker");
+  } catch {}
+}
+
+export function BlockedAppsNativeList({
+  items,
+  selectionData,
+  style,
+}: {
+  items: IOSBlockedItem[];
+  selectionData?: string;
+  style?: any;
+}) {
+  if (!NativeBlockedAppsView || Platform.OS !== "ios") return null;
+
+  const tokens = items
+    .filter((item) => (item.type as string) !== "summary")
+    .map((item) => ({ token: item.token, type: item.type }));
+
+  return React.createElement(NativeBlockedAppsView, {
+    selectionData: selectionData || "",
+    tokens,
+    style: [{ minHeight: 50 }, style],
+  });
+}

package/targets/DeviceActivityMonitor/DeviceActivityMonitor.swift

@@ -0,0 +1,150 @@
+import DeviceActivity
+import ManagedSettings
+import FamilyControls
+import Foundation
+
+@available(iOS 15.0, *)
+class AppBlockerDeviceActivityMonitor: DeviceActivityMonitor {
+  // CONFIGURE: Replace with your App Group identifier
+  private let appGroupIdentifier = "APP_GROUP_PLACEHOLDER"
+  private let temporaryUnlockKey = "appBlocker.temporaryUnlock.v1"
+  private let blockConfigStorageKey = "appBlocker.blockConfiguration.v1"
+
+  private let store = ManagedSettingsStore()
+  private var sharedDefaults: UserDefaults?
+
+  override init() {
+    super.init()
+    sharedDefaults = UserDefaults(suiteName: appGroupIdentifier)
+  }
+
+  override func intervalDidEnd(for activity: DeviceActivityName) {
+    super.intervalDidEnd(for: activity)
+    sharedDefaults?.removeObject(forKey: temporaryUnlockKey)
+    reapplyBlockConfiguration()
+  }
+
+  override func intervalDidStart(for activity: DeviceActivityName) {
+    super.intervalDidStart(for: activity)
+  }
+
+  private func reapplyBlockConfiguration() {
+    let userDefaults = sharedDefaults ?? UserDefaults.standard
+
+    guard let configDict = userDefaults.dictionary(forKey: blockConfigStorageKey) else {
+      store.shield.applications = nil
+      store.shield.applicationCategories = nil
+      return
+    }
+
+    guard let blockConfig = parseBlockConfig(configDict) else {
+      return
+    }
+
+    applyBlocks(blockConfig)
+  }
+
+  private func parseBlockConfig(_ dict: [String: Any]) -> MonitorBlockConfig? {
+    let rawItems: [[String: Any]]
+    if let blockedItems = dict["blockedItems"] as? [[String: Any]] {
+      rawItems = blockedItems
+    } else if let appSelections = dict["appSelections"] as? [[String: Any]] {
+      rawItems = appSelections.map { item in
+        var normalized = item
+        normalized["type"] = "app"
+        return normalized
+      }
+    } else {
+      return nil
+    }
+
+    let items: [MonitorBlockedItemInfo] = rawItems.compactMap { selection -> MonitorBlockedItemInfo? in
+      guard let tokenString = selection["token"] as? String else {
+        return nil
+      }
+
+      let itemTypeRaw = (selection["type"] as? String ?? "app").lowercased()
+      let itemType: MonitorBlockedItemType = itemTypeRaw == "category" ? .category : .app
+
+      return MonitorBlockedItemInfo(
+        type: itemType,
+        tokenId: tokenString,
+        appToken: itemType == .app ? decodeApplicationToken(from: tokenString) : nil,
+        categoryToken: itemType == .category ? decodeCategoryToken(from: tokenString) : nil
+      )
+    }
+
+    let isActive = dict["isActive"] as? Bool ?? true
+    return MonitorBlockConfig(items: items, isActive: isActive)
+  }
+
+  private func applyBlocks(_ config: MonitorBlockConfig) {
+    guard config.isActive else {
+      store.shield.applications = nil
+      store.shield.applicationCategories = nil
+      return
+    }
+
+    let validAppTokens = config.items.compactMap { $0.appToken }
+    let validCategoryTokens = config.items.compactMap { $0.categoryToken }
+
+    guard !validAppTokens.isEmpty || !validCategoryTokens.isEmpty else {
+      store.shield.applications = nil
+      store.shield.applicationCategories = nil
+      return
+    }
+
+    if !validAppTokens.isEmpty {
+      store.shield.applications = Set(validAppTokens)
+    } else {
+      store.shield.applications = nil
+    }
+
+    if !validCategoryTokens.isEmpty {
+      store.shield.applicationCategories = .specific(Set(validCategoryTokens))
+    } else {
+      store.shield.applicationCategories = nil
+    }
+  }
+
+  private func decodeApplicationToken(from encoded: String) -> ApplicationToken? {
+    guard let data = Data(base64Encoded: encoded) else {
+      return nil
+    }
+
+    do {
+      return try JSONDecoder().decode(ApplicationToken.self, from: data)
+    } catch {
+      return nil
+    }
+  }
+
+  private func decodeCategoryToken(from encoded: String) -> ActivityCategoryToken? {
+    guard let data = Data(base64Encoded: encoded) else {
+      return nil
+    }
+
+    do {
+      return try JSONDecoder().decode(ActivityCategoryToken.self, from: data)
+    } catch {
+      return nil
+    }
+  }
+}
+
+enum MonitorBlockedItemType: String {
+  case app
+  case category
+}
+
+struct MonitorBlockedItemInfo {
+  let type: MonitorBlockedItemType
+  let tokenId: String
+  let appToken: ApplicationToken?
+  let categoryToken: ActivityCategoryToken?
+}
+
+struct MonitorBlockConfig {
+  let items: [MonitorBlockedItemInfo]
+  let isActive: Bool
+}

package/targets/DeviceActivityMonitor/expo-target.config.js

@@ -0,0 +1,17 @@
+/** @type {import('@bacons/apple-targets/app.plugin').ConfigFunction} */
+module.exports = (config) => {
+  const appGroup = config.ios?.entitlements?.["com.apple.security.application-groups"]?.[0]
+    || "group.expo.app-blocker";
+
+  return {
+    type: "device-activity-monitor",
+    name: "DeviceActivityMonitor",
+    deploymentTarget: "16.0",
+    bundleIdentifier: ".DeviceActivityMonitor",
+    frameworks: ["DeviceActivity", "ManagedSettings", "FamilyControls"],
+    entitlements: {
+      "com.apple.developer.family-controls": true,
+      "com.apple.security.application-groups": [appGroup],
+    },
+  };
+};

package/targets/ShieldAction/ShieldActionExtension.swift

@@ -0,0 +1,86 @@
+import ManagedSettings
+import ManagedSettingsUI
+import UIKit
+import UserNotifications
+
+class ShieldActionExtension: ShieldActionDelegate {
+  private let appGroupIdentifier = "APP_GROUP_PLACEHOLDER"
+  private let pendingUnlockKey = "appBlocker.pendingUnlock.v1"
+  private let pendingUnlockNotificationIdentifier = "expo.appblocker.pendingUnlock.local"
+
+  override func handle(action: ShieldAction, for application: ApplicationToken, completionHandler: @escaping (ShieldActionResponse) -> Void) {
+    handleAction(action, completionHandler: completionHandler)
+  }
+
+  override func handle(action: ShieldAction, for webDomain: WebDomainToken, completionHandler: @escaping (ShieldActionResponse) -> Void) {
+    handleAction(action, completionHandler: completionHandler)
+  }
+
+  override func handle(action: ShieldAction, for category: ActivityCategoryToken, completionHandler: @escaping (ShieldActionResponse) -> Void) {
+    handleAction(action, completionHandler: completionHandler)
+  }
+
+  private func handleAction(_ action: ShieldAction, completionHandler: @escaping (ShieldActionResponse) -> Void) {
+    switch action {
+    case .primaryButtonPressed:
+      setPendingUnlockFlag()
+      schedulePendingUnlockNotification { didSchedule in
+        let response: ShieldActionResponse = didSchedule ? .none : .defer
+        self.complete(on: response, completionHandler: completionHandler)
+      }
+
+    case .secondaryButtonPressed:
+      complete(on: .close, completionHandler: completionHandler)
+
+    @unknown default:
+      complete(on: .close, completionHandler: completionHandler)
+    }
+  }
+
+  private func complete(on response: ShieldActionResponse, completionHandler: @escaping (ShieldActionResponse) -> Void) {
+    if Thread.isMainThread {
+      completionHandler(response)
+      return
+    }
+
+    DispatchQueue.main.async {
+      completionHandler(response)
+    }
+  }
+
+  private func setPendingUnlockFlag() {
+    guard let sharedDefaults = UserDefaults(suiteName: appGroupIdentifier) else { return }
+    sharedDefaults.set(true, forKey: pendingUnlockKey)
+    sharedDefaults.synchronize()
+
+    let notificationCenter = CFNotificationCenterGetDarwinNotifyCenter()
+    CFNotificationCenterPostNotification(
+      notificationCenter,
+      CFNotificationName("expo.appblocker.pendingUnlock" as CFString),
+      nil,
+      nil,
+      true
+    )
+  }
+
+  private func schedulePendingUnlockNotification(completion: @escaping (Bool) -> Void) {
+    let center = UNUserNotificationCenter.current()
+
+    let content = UNMutableNotificationContent()
+    content.title = "App Blocker"
+    content.body = "Tap to return to the app and complete the unlock challenge."
+    content.sound = .default
+    content.userInfo = ["link": "/unlock"]
+
+    let request = UNNotificationRequest(
+      identifier: pendingUnlockNotificationIdentifier,
+      content: content,
+      trigger: nil
+    )
+
+    center.removePendingNotificationRequests(withIdentifiers: [pendingUnlockNotificationIdentifier])
+    center.add(request) { error in
+      completion(error == nil)
+    }
+  }
+}

package/targets/ShieldAction/expo-target.config.js

@@ -0,0 +1,17 @@
+/** @type {import('@bacons/apple-targets/app.plugin').ConfigFunction} */
+module.exports = (config) => {
+  const appGroup = config.ios?.entitlements?.["com.apple.security.application-groups"]?.[0]
+    || "group.expo.app-blocker";
+
+  return {
+    type: "shield-action",
+    name: "ShieldAction",
+    deploymentTarget: "16.0",
+    bundleIdentifier: ".ShieldAction",
+    frameworks: ["ManagedSettings", "ManagedSettingsUI"],
+    entitlements: {
+      "com.apple.developer.family-controls": true,
+      "com.apple.security.application-groups": [appGroup],
+    },
+  };
+};

package/targets/ShieldConfiguration/ShieldConfigurationExtension.swift

@@ -0,0 +1,152 @@
+import ManagedSettingsUI
+import ManagedSettings
+import UIKit
+
+class ShieldConfigurationExtension: ShieldConfigurationDataSource {
+
+  private let appGroupIdentifier = "APP_GROUP_PLACEHOLDER"
+
+  // Grandmizer design system colors
+  private let primaryGreen = UIColor(red: 0.486, green: 0.710, blue: 0.094, alpha: 1.0) // #7cb518
+  private let darkGreen = UIColor(red: 0.361, green: 0.502, blue: 0.004, alpha: 1.0)    // #5c8001
+  private let accentOrange = UIColor(red: 0.984, green: 0.380, blue: 0.027, alpha: 1.0) // #fb6107
+  private let darkText = UIColor(red: 0.067, green: 0.067, blue: 0.067, alpha: 1.0)     // #111111
+  private let subtitleGray = UIColor(red: 0.45, green: 0.45, blue: 0.45, alpha: 1.0)
+
+  private var mascotIcon: UIImage? {
+    // Load from the extension's own bundle
+    let bundle = Bundle(for: type(of: self))
+    return UIImage(named: "shield-icon", in: bundle, compatibleWith: nil)
+      ?? UIImage(contentsOfFile: bundle.path(forResource: "shield-icon", ofType: "png") ?? "")
+  }
+
+  private func getBlockedAppCount() -> Int {
+    guard let defaults = UserDefaults(suiteName: appGroupIdentifier) else { return 0 }
+    guard let config = defaults.dictionary(forKey: "appBlocker.blockConfiguration.v1") else { return 0 }
+    if let items = config["blockedItems"] as? [[String: Any]] {
+      return items.count
+    }
+    return 0
+  }
+
+  private func isTemporarilyUnlocked() -> Bool {
+    guard let defaults = UserDefaults(suiteName: appGroupIdentifier) else { return false }
+    guard let expiration = defaults.object(forKey: "appBlocker.temporaryUnlock.v1") as? Date else { return false }
+    return Date() < expiration
+  }
+
+  override func configuration(shielding application: Application) -> ShieldConfiguration {
+    let appName = application.localizedDisplayName ?? "This app"
+
+    // If temporarily unlocked, show a different message
+    if isTemporarilyUnlocked() {
+      return ShieldConfiguration(
+        backgroundBlurStyle: .systemThickMaterial,
+        backgroundColor: nil,
+        icon: mascotIcon,
+        title: ShieldConfiguration.Label(
+          text: "Almost there!",
+          color: darkText
+        ),
+        subtitle: ShieldConfiguration.Label(
+          text: "Your free time is loading. Try again in a moment.",
+          color: subtitleGray
+        ),
+        primaryButtonLabel: ShieldConfiguration.Label(
+          text: "OK",
+          color: .white
+        ),
+        primaryButtonBackgroundColor: primaryGreen,
+        secondaryButtonLabel: nil
+      )
+    }
+
+    let count = getBlockedAppCount()
+    let contextLine = count > 1
+      ? "You have \(count) apps blocked. Stay focused!"
+      : "Stay focused! Take a quick quiz to earn free time."
+
+    return ShieldConfiguration(
+      backgroundBlurStyle: .systemThickMaterial,
+      backgroundColor: nil,
+      icon: mascotIcon,
+      title: ShieldConfiguration.Label(
+        text: "Hold on!",
+        color: darkText
+      ),
+      subtitle: ShieldConfiguration.Label(
+        text: "\(appName) is blocked. \(contextLine)",
+        color: subtitleGray
+      ),
+      primaryButtonLabel: ShieldConfiguration.Label(
+        text: "Earn Free Time",
+        color: .white
+      ),
+      primaryButtonBackgroundColor: accentOrange,
+      secondaryButtonLabel: ShieldConfiguration.Label(
+        text: "Not now",
+        color: subtitleGray
+      )
+    )
+  }
+
+  override func configuration(shielding application: Application,
+                               in category: ActivityCategory) -> ShieldConfiguration {
+    let categoryName = category.localizedDisplayName ?? "This category"
+
+    return ShieldConfiguration(
+      backgroundBlurStyle: .systemThickMaterial,
+      backgroundColor: nil,
+      icon: mascotIcon,
+      title: ShieldConfiguration.Label(
+        text: "Hold on!",
+        color: darkText
+      ),
+      subtitle: ShieldConfiguration.Label(
+        text: "\(categoryName) is blocked. Take a quick quiz to earn free time!",
+        color: subtitleGray
+      ),
+      primaryButtonLabel: ShieldConfiguration.Label(
+        text: "Earn Free Time",
+        color: .white
+      ),
+      primaryButtonBackgroundColor: accentOrange,
+      secondaryButtonLabel: ShieldConfiguration.Label(
+        text: "Not now",
+        color: subtitleGray
+      )
+    )
+  }
+
+  override func configuration(shielding webDomain: WebDomain) -> ShieldConfiguration {
+    let domain = webDomain.domain ?? "This website"
+
+    return ShieldConfiguration(
+      backgroundBlurStyle: .systemThickMaterial,
+      backgroundColor: nil,
+      icon: mascotIcon,
+      title: ShieldConfiguration.Label(
+        text: "Hold on!",
+        color: darkText
+      ),
+      subtitle: ShieldConfiguration.Label(
+        text: "\(domain) is blocked. Take a quick quiz to earn free time!",
+        color: subtitleGray
+      ),
+      primaryButtonLabel: ShieldConfiguration.Label(
+        text: "Earn Free Time",
+        color: .white
+      ),
+      primaryButtonBackgroundColor: accentOrange,
+      secondaryButtonLabel: ShieldConfiguration.Label(
+        text: "Not now",
+        color: subtitleGray
+      )
+    )
+  }
+
+  override func configuration(shielding webDomain: WebDomain,
+                               in category: ActivityCategory) -> ShieldConfiguration {
+    return configuration(shielding: webDomain)
+  }
+}

package/targets/ShieldConfiguration/expo-target.config.js

@@ -0,0 +1,17 @@
+/** @type {import('@bacons/apple-targets/app.plugin').ConfigFunction} */
+module.exports = (config) => {
+  const appGroup = config.ios?.entitlements?.["com.apple.security.application-groups"]?.[0]
+    || "group.expo.app-blocker";
+
+  return {
+    type: "shield-config",
+    name: "ShieldConfiguration",
+    deploymentTarget: "16.0",
+    bundleIdentifier: ".ShieldConfiguration",
+    frameworks: ["ManagedSettings", "ManagedSettingsUI"],
+    entitlements: {
+      "com.apple.developer.family-controls": true,
+      "com.apple.security.application-groups": [appGroup],
+    },
+  };
+};

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "esnext",
+    "module": "commonjs",
+    "lib": ["esnext"],
+    "jsx": "react-native",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "outDir": "./build",
+    "rootDir": "."
+  },
+  "include": ["src/**/*", "plugin/**/*"],
+  "exclude": ["node_modules", "build"]
+}