capacitor-thermal-state 1.0.0

package/CapacitorThermalState.podspec

@@ -0,0 +1,17 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name = 'CapacitorThermalState'
+  s.version = package['version']
+  s.summary = package['description']
+  s.license = package['license']
+  s.homepage = package['repository']['url']
+  s.author = package['author']
+  s.source = { :git => package['repository']['url'], :tag => s.version.to_s }
+  s.source_files = 'ios/Sources/**/*.{swift,h,m,c,cc,mm,cpp}'
+  s.ios.deployment_target = '15.0'
+  s.dependency 'Capacitor'
+  s.swift_version = '5.1'
+end

package/Package.swift

@@ -0,0 +1,28 @@
+// swift-tools-version: 5.9
+import PackageDescription
+
+let package = Package(
+    name: "CapacitorThermalState",
+    platforms: [.iOS(.v15)],
+    products: [
+        .library(
+            name: "CapacitorThermalState",
+            targets: ["ThermalStatePlugin"])
+    ],
+    dependencies: [
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "8.0.0")
+    ],
+    targets: [
+        .target(
+            name: "ThermalStatePlugin",
+            dependencies: [
+                .product(name: "Capacitor", package: "capacitor-swift-pm"),
+                .product(name: "Cordova", package: "capacitor-swift-pm")
+            ],
+            path: "ios/Sources/ThermalStatePlugin"),
+        .testTarget(
+            name: "ThermalStatePluginTests",
+            dependencies: ["ThermalStatePlugin"],
+            path: "ios/Tests/ThermalStatePluginTests")
+    ]
+)

package/README.md

@@ -0,0 +1,93 @@
+# capacitor-thermal-state
+
+Monitor device thermal state (overheating detection) for Capacitor apps.
+Works on iOS and Android. No configuration needed.
+
+## Install
+```bash
+npm install capacitor-thermal-state
+npx cap sync
+```
+
+## Usage
+```typescript
+import { ThermalState } from 'capacitor-thermal-state'
+
+// Get current state
+const { state, headroom } = await ThermalState.getState()
+// state: 'nominal' | 'fair' | 'serious' | 'critical' | 'unknown'
+// headroom: 0.0–1.0 (Android API 31+) or null
+
+// Listen for changes
+const listener = await ThermalState.addListener(
+  'thermalStateChange',
+  ({ state, headroom }) => {
+    if (state === 'serious') reduceLoad()
+    if (state === 'critical') stopHeavyWork()
+  }
+)
+
+// Remove listener
+await listener.remove()
+
+// Simulate heat for testing
+await ThermalState.simulateHeat()
+```
+
+## Thermal states
+
+| State    | Meaning                           | Recommended action         |
+|----------|-----------------------------------|----------------------------|
+| nominal  | Device is cool                    | Full performance OK         |
+| fair     | Slightly warm, no throttling      | Monitor situation           |
+| serious  | Hot, system reducing performance  | Reduce load                 |
+| critical | Very hot, heavy throttling        | Stop all heavy operations   |
+| unknown  | Web platform or old Android       | —                           |
+
+## API
+
+### getState()
+
+Returns the current thermal state of the device.
+```typescript
+getState(): Promise<ThermalStateResult>
+```
+
+### simulateHeat()
+
+Simulates a thermal state change event for testing purposes.
+Fires a `thermalStateChange` event with state `serious`.
+```typescript
+simulateHeat(): Promise<void>
+```
+
+### addListener('thermalStateChange', handler)
+
+Listen for thermal state changes in real time.
+```typescript
+addListener(
+  eventName: 'thermalStateChange',
+  listenerFunc: (state: ThermalStateResult) => void
+): Promise<PluginListenerHandle>
+```
+
+### removeAllListeners()
+
+Remove all listeners for this plugin.
+
+## Interfaces
+
+### ThermalStateResult
+
+| Property | Type | Description |
+|----------|------|-------------|
+| state | ThermalStateValue | Current thermal state |
+| headroom | number \| null | Thermal headroom 0.0–1.0, Android API 31+ only |
+
+## Platform support
+
+| Platform | Supported | Notes |
+|----------|-----------|-------|
+| Android  | ✅ | API 29+ for state, API 31+ for headroom |
+| iOS      | ✅ | iOS 11+ |
+| Web      | ⚠️ | Always returns unknown |

package/android/build.gradle

@@ -0,0 +1,67 @@
+ext {
+    junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
+    androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.1'
+    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.3.0'
+    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.7.0'
+    androidxCoreKTXVersion = project.hasProperty('androidxCoreKTXVersion') ? rootProject.ext.androidxCoreKTXVersion : '1.17.0'
+}
+
+buildscript {
+    ext.kotlin_version = project.hasProperty("kotlin_version") ? rootProject.ext.kotlin_version : '2.2.20'
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.13.0'
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
+    }
+}
+
+apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android'
+
+android {
+    namespace = "com.isaforge.thermalstate"
+    compileSdk = project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 36
+    defaultConfig {
+        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 24
+        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 36
+        versionCode 1
+        versionName "1.0"
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
+        }
+    }
+    lintOptions {
+        abortOnError = false
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_21
+        targetCompatibility JavaVersion.VERSION_21
+    }
+}
+
+kotlin {
+    jvmToolchain(21)
+}
+
+repositories {
+    google()
+    mavenCentral()
+}
+
+
+dependencies {
+    implementation fileTree(dir: 'libs', include: ['*.jar'])
+    implementation project(':capacitor-android')
+    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
+    implementation "androidx.core:core-ktx:$androidxCoreKTXVersion"
+    testImplementation "junit:junit:$junitVersion"
+    androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
+    androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/kotlin/com/isaforge/thermalstate/ThermalStatePlugin.kt

@@ -0,0 +1,80 @@
+package com.isaforge.thermalstate
+
+import android.content.Context
+import android.os.Build
+import android.os.PowerManager
+import com.getcapacitor.*
+import com.getcapacitor.annotation.CapacitorPlugin
+
+@CapacitorPlugin(name = "ThermalState")
+class ThermalStatePlugin : Plugin() {
+
+  private lateinit var powerManager: PowerManager
+  private var thermalListener: PowerManager.OnThermalStatusChangedListener? = null
+
+  override fun load() {
+    powerManager = context.getSystemService(Context.POWER_SERVICE) as PowerManager
+
+    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+      thermalListener = PowerManager.OnThermalStatusChangedListener { status ->
+        val result = buildResult()
+        notifyListeners("thermalStateChange", result)
+      }
+      powerManager.addThermalStatusListener(thermalListener!!)
+    }
+  }
+
+  @PluginMethod
+  fun getState(call: PluginCall) {
+    call.resolve(buildResult())
+  }
+
+  @PluginMethod
+    fun simulateHeat(call: PluginCall) {
+        val ret = JSObject()
+        ret.put("state", "serious")
+        ret.put("headroom", 0.2)
+        notifyListeners("thermalStateChange", ret)
+        call.resolve()
+    }
+
+  private fun buildResult(): JSObject {
+    val ret = JSObject()
+
+    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+      val status = powerManager.currentThermalStatus
+      ret.put("state", thermalStatusToString(status))
+    } else {
+      ret.put("state", "unknown")
+    }
+
+    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
+      val headroom = powerManager.getThermalHeadroom(30)
+      if (!headroom.isNaN()) ret.put("headroom", headroom)
+      else ret.put("headroom", JSObject.NULL)
+    } else {
+      ret.put("headroom", JSObject.NULL)
+    }
+
+    return ret
+  }
+
+  private fun thermalStatusToString(status: Int): String {
+    return when (status) {
+      PowerManager.THERMAL_STATUS_NONE,
+      PowerManager.THERMAL_STATUS_LIGHT    -> "nominal"
+      PowerManager.THERMAL_STATUS_MODERATE -> "fair"
+      PowerManager.THERMAL_STATUS_SEVERE,
+      PowerManager.THERMAL_STATUS_CRITICAL -> "serious"
+      PowerManager.THERMAL_STATUS_EMERGENCY,
+      PowerManager.THERMAL_STATUS_SHUTDOWN -> "critical"
+      else                                 -> "unknown"
+    }
+  }
+
+  override fun handleOnDestroy() {
+    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+      thermalListener?.let { powerManager.removeThermalStatusListener(it) }
+    }
+  }
+}

package/dist/esm/definitions.d.ts

@@ -0,0 +1,31 @@
+import type { PluginListenerHandle } from '@capacitor/core';
+export type ThermalStateValue = 'nominal' | 'fair' | 'serious' | 'critical' | 'unknown';
+export interface ThermalStateResult {
+    state: ThermalStateValue;
+    headroom: number | null;
+}
+export interface ThermalStatePlugin {
+    /**
+     * Get the current thermal state of the device.
+     * Returns 'unknown' on web platform.
+     * @since 1.0.0
+     */
+    getState(): Promise<ThermalStateResult>;
+    /**
+     * Simulate a thermal state change event for testing purposes.
+     * Fires a 'thermalStateChange' event with state 'serious'.
+     * Useful for testing your app's response without physically heating the device.
+     * @since 1.0.0
+     */
+    simulateHeat(): Promise<void>;
+    /**
+     * Listen for thermal state changes in real time.
+     * @since 1.0.0
+     */
+    addListener(eventName: 'thermalStateChange', listenerFunc: (state: ThermalStateResult) => void): Promise<PluginListenerHandle>;
+    /**
+     * Remove all listeners for this plugin.
+     * @since 1.0.0
+     */
+    removeAllListeners(): Promise<void>;
+}

package/dist/esm/definitions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=definitions.js.map

package/dist/esm/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core'\n\nexport type ThermalStateValue =\n  | 'nominal'\n  | 'fair'\n  | 'serious'\n  | 'critical'\n  | 'unknown'\n\nexport interface ThermalStateResult {\n  state: ThermalStateValue\n  headroom: number | null\n}\n\nexport interface ThermalStatePlugin {\n  /**\n   * Get the current thermal state of the device.\n   * Returns 'unknown' on web platform.\n   * @since 1.0.0\n   */\n  getState(): Promise<ThermalStateResult>\n\n  /**\n   * Simulate a thermal state change event for testing purposes.\n   * Fires a 'thermalStateChange' event with state 'serious'.\n   * Useful for testing your app's response without physically heating the device.\n   * @since 1.0.0\n   */\n  simulateHeat(): Promise<void>\n\n  /**\n   * Listen for thermal state changes in real time.\n   * @since 1.0.0\n   */\n  addListener(\n    eventName: 'thermalStateChange',\n    listenerFunc: (state: ThermalStateResult) => void\n  ): Promise<PluginListenerHandle>\n\n  /**\n   * Remove all listeners for this plugin.\n   * @since 1.0.0\n   */\n  removeAllListeners(): Promise<void>\n}"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+import type { ThermalStatePlugin } from './definitions';
+declare const ThermalState: ThermalStatePlugin;
+export * from './definitions';
+export { ThermalState };

package/dist/esm/index.js

@@ -0,0 +1,5 @@
+import { registerPlugin } from '@capacitor/core';
+const ThermalState = registerPlugin('ThermalState', { web: () => import('./web').then(m => new m.ThermalStateWeb()) });
+export * from './definitions';
+export { ThermalState };
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAGhD,MAAM,YAAY,GAAG,cAAc,CACjC,cAAc,EACd,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC,EAAE,CAClE,CAAA;AAED,cAAc,eAAe,CAAA;AAC7B,OAAO,EAAE,YAAY,EAAE,CAAA","sourcesContent":["import { registerPlugin } from '@capacitor/core'\nimport type { ThermalStatePlugin } from './definitions'\n\nconst ThermalState = registerPlugin<ThermalStatePlugin>(\n  'ThermalState',\n  { web: () => import('./web').then(m => new m.ThermalStateWeb()) }\n)\n\nexport * from './definitions'\nexport { ThermalState }"]}

package/dist/esm/web.d.ts

@@ -0,0 +1,6 @@
+import { WebPlugin } from '@capacitor/core';
+import type { ThermalStatePlugin, ThermalStateResult } from './definitions';
+export declare class ThermalStateWeb extends WebPlugin implements ThermalStatePlugin {
+    getState(): Promise<ThermalStateResult>;
+    simulateHeat(): Promise<void>;
+}

package/dist/esm/web.js

@@ -0,0 +1,15 @@
+import { WebPlugin } from '@capacitor/core';
+export class ThermalStateWeb extends WebPlugin {
+    async getState() {
+        console.warn('ThermalState: this plugin only works in a native app. ' +
+            'Web platform always returns unknown.');
+        return { state: 'unknown', headroom: null };
+    }
+    async simulateHeat() {
+        this.notifyListeners('thermalStateChange', {
+            state: 'serious',
+            headroom: null
+        });
+    }
+}
+//# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAG3C,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAE5C,KAAK,CAAC,QAAQ;QACZ,OAAO,CAAC,IAAI,CACV,wDAAwD;YACxD,sCAAsC,CACvC,CAAA;QACD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;IAC7C,CAAC;IACD,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC,eAAe,CAAC,oBAAoB,EAAE;YACzC,KAAK,EAAE,SAAS;YAChB,QAAQ,EAAE,IAAI;SACf,CAAC,CAAA;IACJ,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core'\nimport type { ThermalStatePlugin, ThermalStateResult } from './definitions'\n\nexport class ThermalStateWeb extends WebPlugin implements ThermalStatePlugin {\n\n  async getState(): Promise<ThermalStateResult> {\n    console.warn(\n      'ThermalState: this plugin only works in a native app. ' +\n      'Web platform always returns unknown.'\n    )\n    return { state: 'unknown', headroom: null }\n  }\n  async simulateHeat(): Promise<void> {\n    this.notifyListeners('thermalStateChange', {\n      state: 'serious',\n      headroom: null\n    })\n  }\n}"]}

package/dist/plugin.cjs.js

@@ -0,0 +1,27 @@
+'use strict';
+
+var core = require('@capacitor/core');
+
+const ThermalState = core.registerPlugin('ThermalState', { web: () => Promise.resolve().then(function () { return web; }).then(m => new m.ThermalStateWeb()) });
+
+class ThermalStateWeb extends core.WebPlugin {
+    async getState() {
+        console.warn('ThermalState: this plugin only works in a native app. ' +
+            'Web platform always returns unknown.');
+        return { state: 'unknown', headroom: null };
+    }
+    async simulateHeat() {
+        this.notifyListeners('thermalStateChange', {
+            state: 'serious',
+            headroom: null
+        });
+    }
+}
+
+var web = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    ThermalStateWeb: ThermalStateWeb
+});
+
+exports.ThermalState = ThermalState;
+//# sourceMappingURL=plugin.cjs.js.map

package/dist/plugin.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst ThermalState = registerPlugin('ThermalState', { web: () => import('./web').then(m => new m.ThermalStateWeb()) });\nexport * from './definitions';\nexport { ThermalState };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class ThermalStateWeb extends WebPlugin {\n    async getState() {\n        console.warn('ThermalState: this plugin only works in a native app. ' +\n            'Web platform always returns unknown.');\n        return { state: 'unknown', headroom: null };\n    }\n    async simulateHeat() {\n        this.notifyListeners('thermalStateChange', {\n            state: 'serious',\n            headroom: null\n        });\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACK,MAAC,YAAY,GAAGA,mBAAc,CAAC,cAAc,EAAE,EAAE,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC,EAAE;;ACA9G,MAAM,eAAe,SAASC,cAAS,CAAC;AAC/C,IAAI,MAAM,QAAQ,GAAG;AACrB,QAAQ,OAAO,CAAC,IAAI,CAAC,wDAAwD;AAC7E,YAAY,sCAAsC,CAAC;AACnD,QAAQ,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;AACnD,IAAI;AACJ,IAAI,MAAM,YAAY,GAAG;AACzB,QAAQ,IAAI,CAAC,eAAe,CAAC,oBAAoB,EAAE;AACnD,YAAY,KAAK,EAAE,SAAS;AAC5B,YAAY,QAAQ,EAAE;AACtB,SAAS,CAAC;AACV,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js

@@ -0,0 +1,30 @@
+var capacitorThermalState = (function (exports, core) {
+    'use strict';
+
+    const ThermalState = core.registerPlugin('ThermalState', { web: () => Promise.resolve().then(function () { return web; }).then(m => new m.ThermalStateWeb()) });
+
+    class ThermalStateWeb extends core.WebPlugin {
+        async getState() {
+            console.warn('ThermalState: this plugin only works in a native app. ' +
+                'Web platform always returns unknown.');
+            return { state: 'unknown', headroom: null };
+        }
+        async simulateHeat() {
+            this.notifyListeners('thermalStateChange', {
+                state: 'serious',
+                headroom: null
+            });
+        }
+    }
+
+    var web = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        ThermalStateWeb: ThermalStateWeb
+    });
+
+    exports.ThermalState = ThermalState;
+
+    return exports;
+
+})({}, capacitorExports);
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst ThermalState = registerPlugin('ThermalState', { web: () => import('./web').then(m => new m.ThermalStateWeb()) });\nexport * from './definitions';\nexport { ThermalState };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class ThermalStateWeb extends WebPlugin {\n    async getState() {\n        console.warn('ThermalState: this plugin only works in a native app. ' +\n            'Web platform always returns unknown.');\n        return { state: 'unknown', headroom: null };\n    }\n    async simulateHeat() {\n        this.notifyListeners('thermalStateChange', {\n            state: 'serious',\n            headroom: null\n        });\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;AACK,UAAC,YAAY,GAAGA,mBAAc,CAAC,cAAc,EAAE,EAAE,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC,EAAE;;ICA9G,MAAM,eAAe,SAASC,cAAS,CAAC;IAC/C,IAAI,MAAM,QAAQ,GAAG;IACrB,QAAQ,OAAO,CAAC,IAAI,CAAC,wDAAwD;IAC7E,YAAY,sCAAsC,CAAC;IACnD,QAAQ,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;IACnD,IAAI;IACJ,IAAI,MAAM,YAAY,GAAG;IACzB,QAAQ,IAAI,CAAC,eAAe,CAAC,oBAAoB,EAAE;IACnD,YAAY,KAAK,EAAE,SAAS;IAC5B,YAAY,QAAQ,EAAE;IACtB,SAAS,CAAC;IACV,IAAI;IACJ;;;;;;;;;;;;;;;"}

package/ios/Sources/ThermalStatePlugin/ThermalState.swift

@@ -0,0 +1,8 @@
+import Foundation
+
+@objc public class ThermalState: NSObject {
+    @objc public func echo(_ value: String) -> String {
+        print(value)
+        return value
+    }
+}

package/ios/Sources/ThermalStatePlugin/ThermalStatePlugin.swift

@@ -0,0 +1,23 @@
+import Foundation
+import Capacitor
+
+/**
+ * Please read the Capacitor iOS Plugin Development Guide
+ * here: https://capacitorjs.com/docs/plugins/ios
+ */
+@objc(ThermalStatePlugin)
+public class ThermalStatePlugin: CAPPlugin, CAPBridgedPlugin {
+    public let identifier = "ThermalStatePlugin"
+    public let jsName = "ThermalState"
+    public let pluginMethods: [CAPPluginMethod] = [
+        CAPPluginMethod(name: "echo", returnType: CAPPluginReturnPromise)
+    ]
+    private let implementation = ThermalState()
+
+    @objc func echo(_ call: CAPPluginCall) {
+        let value = call.getString("value") ?? ""
+        call.resolve([
+            "value": implementation.echo(value)
+        ])
+    }
+}

package/ios/Tests/ThermalStatePluginTests/ThermalStateTests.swift

@@ -0,0 +1,9 @@
+import XCTest
+@testable import ThermalStatePlugin
+
+class ThermalStateTests: XCTestCase {
+    func testThermalStatePluginLoads() {
+        let plugin = ThermalStatePlugin()
+        XCTAssertNotNil(plugin)
+    }
+}

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "capacitor-thermal-state",
+  "version": "1.0.0",
+  "description": "Monitor device thermal state on iOS and Android for Capacitor",
+  "main": "dist/plugin.cjs.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "unpkg": "dist/plugin.js",
+  "files": [
+    "android/src/main/",
+    "android/build.gradle",
+    "dist/",
+    "ios/Sources",
+    "ios/Tests",
+    "Package.swift",
+    "CapacitorThermalState.podspec"
+  ],
+  "author": "Issazhan issazhan77@gmail.com",
+  "homepage": "https://github.com/isaforge/capacitor-thermal-state#readme",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/isaforge/capacitor-thermal-state.git"
+  },
+  "bugs": {
+    "url": "https://github.com/isaforge/capacitor-thermal-state/issues"
+  },
+  "keywords": [
+    "capacitor",
+    "plugin",
+    "ionic",
+    "thermal",
+    "temperature",
+    "performance",
+    "android",
+    "ios",
+    "native"
+  ],
+  "scripts": {
+    "verify": "npm run verify:ios && npm run verify:android && npm run verify:web",
+    "verify:ios": "xcodebuild -scheme CapacitorThermalState -destination generic/platform=iOS",
+    "verify:android": "cd android && ./gradlew clean build test && cd ..",
+    "verify:web": "npm run build",
+    "lint": "npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint",
+    "fmt": "npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format",
+    "eslint": "eslint . --ext ts",
+    "prettier": "prettier \"**/*.{css,html,ts,js,java}\" --plugin=prettier-plugin-java",
+    "swiftlint": "node-swiftlint",
+    "docgen": "docgen --api ThermalStatePlugin --output-readme README.md --output-json dist/docs.json",
+    "build": "npm run clean && tsc && rollup -c rollup.config.mjs",
+    "clean": "rimraf ./dist",
+    "watch": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@capacitor/android": "^8.0.0",
+    "@capacitor/core": "^8.0.0",
+    "@capacitor/docgen": "^0.3.1",
+    "@capacitor/ios": "^8.0.0",
+    "@ionic/eslint-config": "^0.4.0",
+    "@ionic/prettier-config": "^4.0.0",
+    "@ionic/swiftlint-config": "^2.0.0",
+    "eslint": "^8.57.1",
+    "prettier": "^3.6.2",
+    "prettier-plugin-java": "^2.7.7",
+    "rimraf": "^6.1.0",
+    "rollup": "^4.53.2",
+    "swiftlint": "^2.0.0",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "@capacitor/core": ">=8.0.0"
+  },
+  "prettier": "@ionic/prettier-config",
+  "swiftlint": "@ionic/swiftlint-config",
+  "eslintConfig": {
+    "extends": "@ionic/eslint-config/recommended"
+  },
+  "capacitor": {
+    "ios": {
+      "src": "ios"
+    },
+    "android": {
+      "src": "android"
+    }
+  }
+}