capdebug 0.1.0

package/ios/Sources/CapDebugPlugin/CapDebugPlugin.swift

@@ -0,0 +1,204 @@
+import Foundation
+import Capacitor
+import UIKit
+import Network
+import WebKit
+
+@objc(CapDebugPlugin)
+public class CapDebugPlugin: CAPPlugin, CAPBridgedPlugin {
+    public let identifier = "CapDebugPlugin"
+    public let jsName = "CapDebug"
+    public let pluginMethods: [CAPPluginMethod] = [
+        CAPPluginMethod(name: "getDeviceInfo", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "getMemoryInfo", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "getWebViewInfo", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "getAppInfo", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "getNetworkInfo", returnType: CAPPluginReturnPromise)
+    ]
+
+    private let networkMonitor = NWPathMonitor()
+    private let monitorQueue = DispatchQueue(label: "com.capdebug.networkMonitor")
+    private var lastKnownPath: NWPath?
+
+    override public func load() {
+        super.load()
+        networkMonitor.pathUpdateHandler = { [weak self] path in
+            self?.lastKnownPath = path
+        }
+        networkMonitor.start(queue: monitorQueue)
+    }
+
+    deinit {
+        networkMonitor.cancel()
+    }
+
+    @objc func getDeviceInfo(_ call: CAPPluginCall) {
+        var machineIdentifier = "Unknown"
+        var systemInfo = utsname()
+        if uname(&systemInfo) == 0 {
+            let machineMirror = Mirror(reflecting: systemInfo.machine)
+            let identifier = machineMirror.children.reduce("") { identifier, element in
+                guard let value = element.value as? Int8, value != 0 else { return identifier }
+                return identifier + String(UnicodeScalar(UInt8(value)))
+            }
+            if !identifier.isEmpty {
+                machineIdentifier = identifier
+            }
+        }
+
+        #if targetEnvironment(simulator)
+        let isSimulator = true
+        #else
+        let isSimulator = false
+        #endif
+
+        let result: [String: Any] = [
+            "manufacturer": "Apple",
+            "model": UIDevice.current.model,
+            "device": machineIdentifier,
+            "systemName": UIDevice.current.systemName,
+            "systemVersion": UIDevice.current.systemVersion,
+            "isSimulator": isSimulator,
+            "architecture": getCpuArchitecture(),
+            "availableProcessors": ProcessInfo.processInfo.activeProcessorCount,
+            "processorCount": ProcessInfo.processInfo.processorCount,
+            "platform": "ios"
+        ]
+
+        call.resolve(result)
+    }
+
+    @objc func getMemoryInfo(_ call: CAPPluginCall) {
+        var usedBytes: UInt64 = 0
+        var taskInfo = mach_task_basic_info()
+        var count = mach_msg_type_number_t(MemoryLayout<mach_task_basic_info>.size / 4)
+
+        let kerr: kern_return_t = withUnsafeMutablePointer(to: &taskInfo) {
+            $0.withMemoryRebound(to: integer_t.self, capacity: 1) {
+                task_info(mach_task_self_, task_flavor_t(MACH_TASK_BASIC_INFO), $0, &count)
+            }
+        }
+
+        if kerr == KERN_SUCCESS {
+            usedBytes = UInt64(taskInfo.resident_size)
+        }
+
+        let totalBytes = ProcessInfo.processInfo.physicalMemory
+
+        var availableBytes: UInt64 = 0
+        if #available(iOS 13.0, *) {
+            availableBytes = UInt64(os_proc_available_memory())
+        }
+
+        var result: [String: Any] = [
+            "appMemoryUsage": usedBytes,
+            "appMemoryUsageFormatted": formatBytes(usedBytes),
+            "systemTotalMemory": totalBytes,
+            "systemTotalMemoryFormatted": formatBytes(totalBytes),
+            "lowMemory": false
+        ]
+
+        if availableBytes > 0 {
+            result["systemAvailableMemory"] = availableBytes
+            result["systemAvailableMemoryFormatted"] = formatBytes(availableBytes)
+        }
+
+        call.resolve(result)
+    }
+
+    @objc func getWebViewInfo(_ call: CAPPluginCall) {
+        var userAgent = "Unknown"
+        if let customUA = self.bridge?.webView?.customUserAgent, !customUA.isEmpty {
+            userAgent = customUA
+        }
+
+        #if DEBUG
+        let isDebug = true
+        #else
+        let isDebug = false
+        #endif
+
+        let result: [String: Any] = [
+            "userAgent": userAgent,
+            "version": "WebKit iOS",
+            "packageName": Bundle.main.bundleIdentifier ?? "Unknown",
+            "debugEnabled": isDebug
+        ]
+
+        call.resolve(result)
+    }
+
+    @objc func getAppInfo(_ call: CAPPluginCall) {
+        let bundleId = Bundle.main.bundleIdentifier ?? "Unknown"
+        let version = Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String ?? "Unknown"
+        let build = Bundle.main.infoDictionary?["CFBundleVersion"] as? String ?? "Unknown"
+
+        #if DEBUG
+        let buildType = "debug"
+        #else
+        let buildType = "release"
+        #endif
+
+        let result: [String: Any] = [
+            "applicationId": bundleId,
+            "bundleIdentifier": bundleId,
+            "version": version,
+            "versionName": version,
+            "build": build,
+            "versionCode": build,
+            "buildType": buildType
+        ]
+
+        call.resolve(result)
+    }
+
+    @objc func getNetworkInfo(_ call: CAPPluginCall) {
+        let path = lastKnownPath ?? networkMonitor.currentPath
+        let isConnected = path.status == .satisfied
+        let isMetered = path.isExpensive
+
+        var connectionType = "none"
+        if isConnected {
+            if path.usesInterfaceType(.wifi) {
+                connectionType = "wifi"
+            } else if path.usesInterfaceType(.cellular) {
+                connectionType = "cellular"
+            } else if path.usesInterfaceType(.wiredEthernet) {
+                connectionType = "ethernet"
+            } else {
+                connectionType = "other"
+            }
+        }
+
+        let result: [String: Any] = [
+            "connected": isConnected,
+            "connectionType": connectionType,
+            "metered": isMetered
+        ]
+
+        call.resolve(result)
+    }
+
+    private func getCpuArchitecture() -> String {
+        #if arch(x86_64)
+        return "x86_64"
+        #elseif arch(arm64)
+        return "arm64"
+        #elseif arch(arm)
+        return "arm"
+        #elseif arch(i386)
+        return "i386"
+        #else
+        return "unknown"
+        #endif
+    }
+
+    private func formatBytes(_ bytes: UInt64) -> String {
+        if bytes == 0 { return "0 B" }
+        let units = ["B", "KB", "MB", "GB", "TB"]
+        let digitGroups = Int(log10(Double(bytes)) / log10(1024.0))
+        let safeGroup = min(digitGroups, units.count - 1)
+        let formatted = String(format: "%.2f %@", Double(bytes) / pow(1024.0, Double(safeGroup)), units[safeGroup])
+        return formatted
+    }
+}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "capdebug",
+  "version": "0.1.0",
+  "description": "Lightweight, embedded debug viewer and diagnostics plugin for Capacitor apps",
+  "main": "dist/plugin.cjs.js",
+  "module": "dist/plugin.mjs",
+  "types": "dist/index.d.ts",
+  "unpkg": "dist/plugin.js",
+  "files": [
+    "dist/",
+    "ios/",
+    "android/",
+    "CapDebug.podspec"
+  ],
+  "scripts": {
+    "build": "rollup -c rollup.config.mjs && tsc --emitDeclarationOnly",
+    "watch": "rollup -c rollup.config.mjs -w",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "capacitor",
+    "plugin",
+    "native",
+    "debug",
+    "devtools",
+    "logger",
+    "console",
+    "inspector",
+    "viewer",
+    "embedded",
+    "ios",
+    "android"
+  ],
+  "author": "CapDebug Contributors",
+  "license": "MIT",
+  "peerDependencies": {
+    "@capacitor/core": "^5.0.0 || ^6.0.0 || ^7.0.0"
+  },
+  "devDependencies": {
+    "@capacitor/core": "^6.2.0",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@rollup/plugin-typescript": "^11.1.6",
+    "@types/node": "^22.10.2",
+    "jsdom": "^25.0.1",
+    "rollup": "^4.28.1",
+    "tslib": "^2.8.1",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "capacitor": {
+    "ios": {
+      "src": "ios"
+    },
+    "android": {
+      "src": "android"
+    }
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/plugin.mjs",
+      "require": "./dist/plugin.cjs.js",
+      "default": "./dist/plugin.mjs"
+    }
+  }
+}