@capawesome/capacitor-thermal-state 0.0.1

package/CapawesomeCapacitorThermalState.podspec

@@ -0,0 +1,17 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name = 'CapawesomeCapacitorThermalState'
+  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/Plugin/**/*.{swift,h,m,c,cc,mm,cpp}'
+  s.ios.deployment_target = '15.0'
+  s.dependency 'Capacitor'
+  s.swift_version = '5.1'
+end

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Robin Genz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/Package.swift

@@ -0,0 +1,28 @@
+// swift-tools-version: 5.9
+import PackageDescription
+
+let package = Package(
+    name: "CapawesomeCapacitorThermalState",
+    platforms: [.iOS(.v15)],
+    products: [
+        .library(
+            name: "CapawesomeCapacitorThermalState",
+            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/Plugin"),
+        .testTarget(
+            name: "ThermalStatePluginTests",
+            dependencies: ["ThermalStatePlugin"],
+            path: "ios/PluginTests")
+    ]
+)

package/README.md

@@ -0,0 +1,221 @@
+# @capawesome/capacitor-thermal-state
+
+Capacitor plugin to read the device thermal state and react before the operating system throttles your app.
+
+<div class="capawesome-z29o10a">
+  <a href="https://cloud.capawesome.io/" target="_blank">
+    <img alt="Deliver Live Updates to your Capacitor app with Capawesome Cloud" src="https://cloud.capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.png?t=1" />
+  </a>
+</div>
+
+## Features
+
+- 🌡️ **Thermal state**: Read the current thermal state of the device.
+- 🔔 **Change events**: Get notified whenever the thermal state changes.
+- 📦 **CocoaPods & SPM**: Supports CocoaPods and Swift Package Manager for iOS.
+- 🔁 **Up-to-date**: Always supports the latest Capacitor version.
+
+Missing a feature? Just [open an issue](https://github.com/capawesome-team/capacitor-plugins/issues) and we'll take a look!
+
+## Newsletter
+
+Stay up to date with the latest news and updates about the Capawesome, Capacitor, and Ionic ecosystem by subscribing to our [Capawesome Newsletter](https://cloud.capawesome.io/newsletter/).
+
+## Compatibility
+
+| Plugin Version | Capacitor Version | Status         |
+| -------------- | ----------------- | -------------- |
+| 0.x.x          | >=8.x.x           | Active support |
+
+## Installation
+
+You can use our **AI-Assisted Setup** to install the plugin.
+Add the [Capawesome Skills](https://github.com/capawesome-team/skills) to your AI tool using the following command:
+
+```bash
+npx skills add capawesome-team/skills --skill capacitor-plugins
+```
+
+Then use the following prompt:
+
+```
+ Use the `capacitor-plugins` skill from `capawesome-team/skills` to install the `@capawesome/capacitor-thermal-state` plugin in my project.
+```
+
+If you prefer **Manual Setup**, install the plugin by running the following commands and follow the platform-specific instructions below:
+
+```bash
+npm install @capawesome/capacitor-thermal-state
+npx cap sync
+```
+
+This plugin is available on **Android** and **iOS**. On the web, all methods reject as unimplemented.
+
+### Android
+
+Reading the thermal state requires **Android 10** (API level 29) or newer. On older versions, `getThermalState(...)` rejects as unavailable and the `thermalStateChange` event is never emitted.
+
+The Android thermal status values are mapped to the four common thermal states as follows:
+
+| Android Thermal Status                                                                  | Thermal State |
+| --------------------------------------------------------------------------------------- | ------------- |
+| `THERMAL_STATUS_NONE`                                                                    | `nominal`     |
+| `THERMAL_STATUS_LIGHT`                                                                   | `fair`        |
+| `THERMAL_STATUS_MODERATE`                                                                | `serious`     |
+| `THERMAL_STATUS_SEVERE` / `THERMAL_STATUS_CRITICAL` / `THERMAL_STATUS_EMERGENCY` / `THERMAL_STATUS_SHUTDOWN` | `critical`    |
+
+## Configuration
+
+No configuration required for this plugin.
+
+## Usage
+
+```typescript
+import { ThermalState } from '@capawesome/capacitor-thermal-state';
+
+const getThermalState = async () => {
+  const { state } = await ThermalState.getThermalState();
+  return state;
+};
+
+const addThermalStateChangeListener = async () => {
+  await ThermalState.addListener('thermalStateChange', event => {
+    console.log(event.state);
+  });
+};
+
+const removeAllListeners = async () => {
+  await ThermalState.removeAllListeners();
+};
+```
+
+## API
+
+<docgen-index>
+
+* [`getThermalState()`](#getthermalstate)
+* [`addListener('thermalStateChange', ...)`](#addlistenerthermalstatechange-)
+* [`removeAllListeners()`](#removealllisteners)
+* [Interfaces](#interfaces)
+* [Type Aliases](#type-aliases)
+
+</docgen-index>
+
+<docgen-api>
+<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
+
+### getThermalState()
+
+```typescript
+getThermalState() => Promise<GetThermalStateResult>
+```
+
+Get the current thermal state of the device.
+
+Only available on Android (API level 29+) and iOS.
+
+**Returns:** <code>Promise&lt;<a href="#getthermalstateresult">GetThermalStateResult</a>&gt;</code>
+
+**Since:** 0.1.0
+
+--------------------
+
+
+### addListener('thermalStateChange', ...)
+
+```typescript
+addListener(eventName: 'thermalStateChange', listenerFunc: (event: ThermalStateChangeEvent) => void) => Promise<PluginListenerHandle>
+```
+
+Listen for changes to the thermal state of the device.
+
+The device is only observed while at least one listener is attached.
+
+Only available on Android (API level 29+) and iOS.
+
+| Param              | Type                                                                                            |
+| ------------------ | ----------------------------------------------------------------------------------------------- |
+| **`eventName`**    | <code>'thermalStateChange'</code>                                                               |
+| **`listenerFunc`** | <code>(event: <a href="#thermalstatechangeevent">ThermalStateChangeEvent</a>) =&gt; void</code> |
+
+**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt;</code>
+
+**Since:** 0.1.0
+
+--------------------
+
+
+### removeAllListeners()
+
+```typescript
+removeAllListeners() => Promise<void>
+```
+
+Remove all listeners for this plugin.
+
+**Since:** 0.1.0
+
+--------------------
+
+
+### Interfaces
+
+
+#### GetThermalStateResult
+
+| Prop        | Type                                                            | Description                              | Since |
+| ----------- | --------------------------------------------------------------- | ---------------------------------------- | ----- |
+| **`state`** | <code><a href="#thermalstatevalue">ThermalStateValue</a></code> | The current thermal state of the device. | 0.1.0 |
+
+
+#### PluginListenerHandle
+
+| Prop         | Type                                      |
+| ------------ | ----------------------------------------- |
+| **`remove`** | <code>() =&gt; Promise&lt;void&gt;</code> |
+
+
+#### ThermalStateChangeEvent
+
+| Prop        | Type                                                            | Description                              | Since |
+| ----------- | --------------------------------------------------------------- | ---------------------------------------- | ----- |
+| **`state`** | <code><a href="#thermalstatevalue">ThermalStateValue</a></code> | The current thermal state of the device. | 0.1.0 |
+
+
+### Type Aliases
+
+
+#### ThermalStateValue
+
+The thermal state of the device.
+
+- `critical`: The thermal state is significantly impacting performance.
+  Reduce the workload as much as possible.
+- `fair`: The thermal state is slightly elevated. Consider reducing
+  non-essential work.
+- `nominal`: The thermal state is within normal limits. No action is needed.
+- `serious`: The thermal state is high. Reduce the workload to help the
+  device cool down.
+
+<code>'critical' | 'fair' | 'nominal' | 'serious'</code>
+
+</docgen-api>
+
+## Handling the Thermal State
+
+Use the thermal state to progressively reduce your app's workload before the operating system throttles it. The following table lists suggested reactions for each state:
+
+| State      | Suggested App Reaction                                                                 |
+| ---------- | -------------------------------------------------------------------------------------- |
+| `nominal`  | No action needed. Run at full quality.                                                  |
+| `fair`     | Reduce non-essential work, e.g. lower the prefetching rate.                             |
+| `serious`  | Reduce the frame rate, pause prefetching, and defer background or ML work.              |
+| `critical` | Reduce the workload as much as possible to help the device cool down.                   |
+
+## Changelog
+
+See [CHANGELOG.md](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/thermal-state/CHANGELOG.md).
+
+## License
+
+See [LICENSE](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/thermal-state/LICENSE).

package/android/build.gradle

@@ -0,0 +1,58 @@
+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'
+}
+
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.13.0'
+    }
+}
+
+apply plugin: 'com.android.library'
+
+android {
+    namespace = "io.capawesome.capacitorjs.plugins.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.txt'), 'proguard-rules.pro'
+        }
+    }
+    lintOptions {
+        abortOnError = false
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_21
+        targetCompatibility JavaVersion.VERSION_21
+    }
+}
+
+repositories {
+    google()
+    mavenCentral()
+}
+
+
+dependencies {
+    implementation fileTree(dir: 'libs', include: ['*.jar'])
+    implementation project(':capacitor-android')
+    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
+    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/java/io/capawesome/capacitorjs/plugins/thermalstate/ThermalState.java

@@ -0,0 +1,78 @@
+package io.capawesome.capacitorjs.plugins.thermalstate;
+
+import android.content.Context;
+import android.os.Build;
+import android.os.PowerManager;
+import androidx.annotation.NonNull;
+import androidx.annotation.RequiresApi;
+import androidx.core.content.ContextCompat;
+import io.capawesome.capacitorjs.plugins.thermalstate.classes.events.ThermalStateChangeEvent;
+import io.capawesome.capacitorjs.plugins.thermalstate.classes.results.GetThermalStateResult;
+import io.capawesome.capacitorjs.plugins.thermalstate.interfaces.NonEmptyResultCallback;
+import java.util.concurrent.Executor;
+
+public class ThermalState {
+
+    @NonNull
+    private final ThermalStatePlugin plugin;
+
+    private boolean isObserving = false;
+
+    @NonNull
+    private final PowerManager powerManager;
+
+    private PowerManager.OnThermalStatusChangedListener thermalStatusChangedListener;
+
+    public ThermalState(@NonNull ThermalStatePlugin plugin) {
+        this.plugin = plugin;
+        this.powerManager = (PowerManager) plugin.getContext().getSystemService(Context.POWER_SERVICE);
+    }
+
+    @RequiresApi(api = Build.VERSION_CODES.Q)
+    public void getThermalState(@NonNull NonEmptyResultCallback<GetThermalStateResult> callback) {
+        String state = mapThermalStatus(powerManager.getCurrentThermalStatus());
+        callback.success(new GetThermalStateResult(state));
+    }
+
+    public void startObserving() {
+        if (isObserving || Build.VERSION.SDK_INT < Build.VERSION_CODES.Q) {
+            return;
+        }
+        Executor executor = ContextCompat.getMainExecutor(plugin.getContext());
+        thermalStatusChangedListener = this::handleThermalStatusChanged;
+        powerManager.addThermalStatusListener(executor, thermalStatusChangedListener);
+        isObserving = true;
+    }
+
+    public void stopObserving() {
+        if (!isObserving) {
+            return;
+        }
+        if (thermalStatusChangedListener != null && Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+            powerManager.removeThermalStatusListener(thermalStatusChangedListener);
+            thermalStatusChangedListener = null;
+        }
+        isObserving = false;
+    }
+
+    private void handleThermalStatusChanged(int status) {
+        plugin.notifyThermalStateChangeListeners(new ThermalStateChangeEvent(mapThermalStatus(status)));
+    }
+
+    @NonNull
+    private String mapThermalStatus(int status) {
+        switch (status) {
+            case PowerManager.THERMAL_STATUS_SEVERE:
+            case PowerManager.THERMAL_STATUS_CRITICAL:
+            case PowerManager.THERMAL_STATUS_EMERGENCY:
+            case PowerManager.THERMAL_STATUS_SHUTDOWN:
+                return "critical";
+            case PowerManager.THERMAL_STATUS_LIGHT:
+                return "fair";
+            case PowerManager.THERMAL_STATUS_MODERATE:
+                return "serious";
+            default:
+                return "nominal";
+        }
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/thermalstate/ThermalStatePlugin.java

@@ -0,0 +1,99 @@
+package io.capawesome.capacitorjs.plugins.thermalstate;
+
+import android.os.Build;
+import androidx.annotation.NonNull;
+import com.getcapacitor.Logger;
+import com.getcapacitor.Plugin;
+import com.getcapacitor.PluginCall;
+import com.getcapacitor.PluginMethod;
+import com.getcapacitor.annotation.CapacitorPlugin;
+import io.capawesome.capacitorjs.plugins.thermalstate.classes.events.ThermalStateChangeEvent;
+import io.capawesome.capacitorjs.plugins.thermalstate.classes.results.GetThermalStateResult;
+import io.capawesome.capacitorjs.plugins.thermalstate.interfaces.NonEmptyResultCallback;
+import io.capawesome.capacitorjs.plugins.thermalstate.interfaces.Result;
+
+@CapacitorPlugin(name = "ThermalState")
+public class ThermalStatePlugin extends Plugin {
+
+    public static final String EVENT_THERMAL_STATE_CHANGE = "thermalStateChange";
+
+    public static final String TAG = "ThermalStatePlugin";
+
+    private static final String ERROR_UNKNOWN_ERROR = "An unknown error occurred.";
+
+    private ThermalState implementation;
+
+    @Override
+    public void load() {
+        implementation = new ThermalState(this);
+    }
+
+    @Override
+    @PluginMethod(returnType = PluginMethod.RETURN_NONE)
+    public void addListener(PluginCall call) {
+        super.addListener(call);
+        implementation.startObserving();
+    }
+
+    @PluginMethod
+    public void getThermalState(PluginCall call) {
+        try {
+            if (Build.VERSION.SDK_INT < Build.VERSION_CODES.Q) {
+                rejectCallAsUnavailable(call);
+                return;
+            }
+            NonEmptyResultCallback<GetThermalStateResult> callback = new NonEmptyResultCallback<>() {
+                @Override
+                public void success(@NonNull GetThermalStateResult result) {
+                    resolveCall(call, result);
+                }
+
+                @Override
+                public void error(@NonNull Exception exception) {
+                    rejectCall(call, exception);
+                }
+            };
+
+            implementation.getThermalState(callback);
+        } catch (Exception exception) {
+            rejectCall(call, exception);
+        }
+    }
+
+    public void notifyThermalStateChangeListeners(@NonNull ThermalStateChangeEvent event) {
+        notifyListeners(EVENT_THERMAL_STATE_CHANGE, event.toJSObject());
+    }
+
+    @Override
+    @PluginMethod
+    public void removeAllListeners(PluginCall call) {
+        super.removeAllListeners(call);
+        implementation.stopObserving();
+    }
+
+    @Override
+    @PluginMethod(returnType = PluginMethod.RETURN_NONE)
+    public void removeListener(PluginCall call) {
+        super.removeListener(call);
+        if (!hasListeners(EVENT_THERMAL_STATE_CHANGE)) {
+            implementation.stopObserving();
+        }
+    }
+
+    private void rejectCall(@NonNull PluginCall call, @NonNull Exception exception) {
+        String message = exception.getMessage();
+        if (message == null) {
+            message = ERROR_UNKNOWN_ERROR;
+        }
+        Logger.error(TAG, message, exception);
+        call.reject(message);
+    }
+
+    private void rejectCallAsUnavailable(@NonNull PluginCall call) {
+        call.unavailable("This method is not available on this platform.");
+    }
+
+    private void resolveCall(@NonNull PluginCall call, @NonNull Result result) {
+        call.resolve(result.toJSObject());
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/thermalstate/classes/events/ThermalStateChangeEvent.java

@@ -0,0 +1,23 @@
+package io.capawesome.capacitorjs.plugins.thermalstate.classes.events;
+
+import androidx.annotation.NonNull;
+import com.getcapacitor.JSObject;
+import io.capawesome.capacitorjs.plugins.thermalstate.interfaces.Result;
+
+public class ThermalStateChangeEvent implements Result {
+
+    @NonNull
+    private final String state;
+
+    public ThermalStateChangeEvent(@NonNull String state) {
+        this.state = state;
+    }
+
+    @Override
+    @NonNull
+    public JSObject toJSObject() {
+        JSObject result = new JSObject();
+        result.put("state", state);
+        return result;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/thermalstate/classes/results/GetThermalStateResult.java

@@ -0,0 +1,23 @@
+package io.capawesome.capacitorjs.plugins.thermalstate.classes.results;
+
+import androidx.annotation.NonNull;
+import com.getcapacitor.JSObject;
+import io.capawesome.capacitorjs.plugins.thermalstate.interfaces.Result;
+
+public class GetThermalStateResult implements Result {
+
+    @NonNull
+    private final String state;
+
+    public GetThermalStateResult(@NonNull String state) {
+        this.state = state;
+    }
+
+    @Override
+    @NonNull
+    public JSObject toJSObject() {
+        JSObject result = new JSObject();
+        result.put("state", state);
+        return result;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/thermalstate/interfaces/Callback.java

@@ -0,0 +1,5 @@
+package io.capawesome.capacitorjs.plugins.thermalstate.interfaces;
+
+public interface Callback {
+    void error(Exception exception);
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/thermalstate/interfaces/NonEmptyResultCallback.java

@@ -0,0 +1,7 @@
+package io.capawesome.capacitorjs.plugins.thermalstate.interfaces;
+
+import androidx.annotation.NonNull;
+
+public interface NonEmptyResultCallback<T extends Result> extends Callback {
+    void success(@NonNull T result);
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/thermalstate/interfaces/Result.java

@@ -0,0 +1,7 @@
+package io.capawesome.capacitorjs.plugins.thermalstate.interfaces;
+
+import com.getcapacitor.JSObject;
+
+public interface Result {
+    JSObject toJSObject();
+}

package/dist/docs.json

@@ -0,0 +1,181 @@
+{
+  "api": {
+    "name": "ThermalStatePlugin",
+    "slug": "thermalstateplugin",
+    "docs": "",
+    "tags": [],
+    "methods": [
+      {
+        "name": "getThermalState",
+        "signature": "() => Promise<GetThermalStateResult>",
+        "parameters": [],
+        "returns": "Promise<GetThermalStateResult>",
+        "tags": [
+          {
+            "name": "since",
+            "text": "0.1.0"
+          }
+        ],
+        "docs": "Get the current thermal state of the device.\n\nOnly available on Android (API level 29+) and iOS.",
+        "complexTypes": [
+          "GetThermalStateResult"
+        ],
+        "slug": "getthermalstate"
+      },
+      {
+        "name": "addListener",
+        "signature": "(eventName: 'thermalStateChange', listenerFunc: (event: ThermalStateChangeEvent) => void) => Promise<PluginListenerHandle>",
+        "parameters": [
+          {
+            "name": "eventName",
+            "docs": "",
+            "type": "'thermalStateChange'"
+          },
+          {
+            "name": "listenerFunc",
+            "docs": "",
+            "type": "(event: ThermalStateChangeEvent) => void"
+          }
+        ],
+        "returns": "Promise<PluginListenerHandle>",
+        "tags": [
+          {
+            "name": "since",
+            "text": "0.1.0"
+          }
+        ],
+        "docs": "Listen for changes to the thermal state of the device.\n\nThe device is only observed while at least one listener is attached.\n\nOnly available on Android (API level 29+) and iOS.",
+        "complexTypes": [
+          "PluginListenerHandle",
+          "ThermalStateChangeEvent"
+        ],
+        "slug": "addlistenerthermalstatechange-"
+      },
+      {
+        "name": "removeAllListeners",
+        "signature": "() => Promise<void>",
+        "parameters": [],
+        "returns": "Promise<void>",
+        "tags": [
+          {
+            "name": "since",
+            "text": "0.1.0"
+          }
+        ],
+        "docs": "Remove all listeners for this plugin.",
+        "complexTypes": [],
+        "slug": "removealllisteners"
+      }
+    ],
+    "properties": []
+  },
+  "interfaces": [
+    {
+      "name": "GetThermalStateResult",
+      "slug": "getthermalstateresult",
+      "docs": "",
+      "tags": [
+        {
+          "text": "0.1.0",
+          "name": "since"
+        }
+      ],
+      "methods": [],
+      "properties": [
+        {
+          "name": "state",
+          "tags": [
+            {
+              "text": "'nominal'",
+              "name": "example"
+            },
+            {
+              "text": "0.1.0",
+              "name": "since"
+            }
+          ],
+          "docs": "The current thermal state of the device.",
+          "complexTypes": [
+            "ThermalStateValue"
+          ],
+          "type": "ThermalStateValue"
+        }
+      ]
+    },
+    {
+      "name": "PluginListenerHandle",
+      "slug": "pluginlistenerhandle",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "remove",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "() => Promise<void>"
+        }
+      ]
+    },
+    {
+      "name": "ThermalStateChangeEvent",
+      "slug": "thermalstatechangeevent",
+      "docs": "",
+      "tags": [
+        {
+          "text": "0.1.0",
+          "name": "since"
+        }
+      ],
+      "methods": [],
+      "properties": [
+        {
+          "name": "state",
+          "tags": [
+            {
+              "text": "'nominal'",
+              "name": "example"
+            },
+            {
+              "text": "0.1.0",
+              "name": "since"
+            }
+          ],
+          "docs": "The current thermal state of the device.",
+          "complexTypes": [
+            "ThermalStateValue"
+          ],
+          "type": "ThermalStateValue"
+        }
+      ]
+    }
+  ],
+  "enums": [],
+  "typeAliases": [
+    {
+      "name": "ThermalStateValue",
+      "slug": "thermalstatevalue",
+      "docs": "The thermal state of the device.\n\n- `critical`: The thermal state is significantly impacting performance.\n  Reduce the workload as much as possible.\n- `fair`: The thermal state is slightly elevated. Consider reducing\n  non-essential work.\n- `nominal`: The thermal state is within normal limits. No action is needed.\n- `serious`: The thermal state is high. Reduce the workload to help the\n  device cool down.",
+      "types": [
+        {
+          "text": "'critical'",
+          "complexTypes": []
+        },
+        {
+          "text": "'fair'",
+          "complexTypes": []
+        },
+        {
+          "text": "'nominal'",
+          "complexTypes": []
+        },
+        {
+          "text": "'serious'",
+          "complexTypes": []
+        }
+      ]
+    }
+  ],
+  "pluginConfigs": []
+}

package/dist/esm/definitions.d.ts

@@ -0,0 +1,65 @@
+import type { PluginListenerHandle } from '@capacitor/core';
+export interface ThermalStatePlugin {
+    /**
+     * Get the current thermal state of the device.
+     *
+     * Only available on Android (API level 29+) and iOS.
+     *
+     * @since 0.1.0
+     */
+    getThermalState(): Promise<GetThermalStateResult>;
+    /**
+     * Listen for changes to the thermal state of the device.
+     *
+     * The device is only observed while at least one listener is attached.
+     *
+     * Only available on Android (API level 29+) and iOS.
+     *
+     * @since 0.1.0
+     */
+    addListener(eventName: 'thermalStateChange', listenerFunc: (event: ThermalStateChangeEvent) => void): Promise<PluginListenerHandle>;
+    /**
+     * Remove all listeners for this plugin.
+     *
+     * @since 0.1.0
+     */
+    removeAllListeners(): Promise<void>;
+}
+/**
+ * @since 0.1.0
+ */
+export interface GetThermalStateResult {
+    /**
+     * The current thermal state of the device.
+     *
+     * @example 'nominal'
+     * @since 0.1.0
+     */
+    state: ThermalStateValue;
+}
+/**
+ * @since 0.1.0
+ */
+export interface ThermalStateChangeEvent {
+    /**
+     * The current thermal state of the device.
+     *
+     * @example 'nominal'
+     * @since 0.1.0
+     */
+    state: ThermalStateValue;
+}
+/**
+ * The thermal state of the device.
+ *
+ * - `critical`: The thermal state is significantly impacting performance.
+ *   Reduce the workload as much as possible.
+ * - `fair`: The thermal state is slightly elevated. Consider reducing
+ *   non-essential work.
+ * - `nominal`: The thermal state is within normal limits. No action is needed.
+ * - `serious`: The thermal state is high. Reduce the workload to help the
+ *   device cool down.
+ *
+ * @since 0.1.0
+ */
+export type ThermalStateValue = 'critical' | 'fair' | 'nominal' | 'serious';

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 interface ThermalStatePlugin {\n  /**\n   * Get the current thermal state of the device.\n   *\n   * Only available on Android (API level 29+) and iOS.\n   *\n   * @since 0.1.0\n   */\n  getThermalState(): Promise<GetThermalStateResult>;\n  /**\n   * Listen for changes to the thermal state of the device.\n   *\n   * The device is only observed while at least one listener is attached.\n   *\n   * Only available on Android (API level 29+) and iOS.\n   *\n   * @since 0.1.0\n   */\n  addListener(\n    eventName: 'thermalStateChange',\n    listenerFunc: (event: ThermalStateChangeEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  /**\n   * Remove all listeners for this plugin.\n   *\n   * @since 0.1.0\n   */\n  removeAllListeners(): Promise<void>;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface GetThermalStateResult {\n  /**\n   * The current thermal state of the device.\n   *\n   * @example 'nominal'\n   * @since 0.1.0\n   */\n  state: ThermalStateValue;\n}\n\n/**\n * @since 0.1.0\n */\nexport interface ThermalStateChangeEvent {\n  /**\n   * The current thermal state of the device.\n   *\n   * @example 'nominal'\n   * @since 0.1.0\n   */\n  state: ThermalStateValue;\n}\n\n/**\n * The thermal state of the device.\n *\n * - `critical`: The thermal state is significantly impacting performance.\n *   Reduce the workload as much as possible.\n * - `fair`: The thermal state is slightly elevated. Consider reducing\n *   non-essential work.\n * - `nominal`: The thermal state is within normal limits. No action is needed.\n * - `serious`: The thermal state is high. Reduce the workload to help the\n *   device cool down.\n *\n * @since 0.1.0\n */\nexport type ThermalStateValue = 'critical' | 'fair' | 'nominal' | 'serious';\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,7 @@
+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,CAAC;AAIjD,MAAM,YAAY,GAAG,cAAc,CAAqB,cAAc,EAAE;IACtE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC;CAC9D,CAAC,CAAC;AAEH,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\n\nimport type { ThermalStatePlugin } from './definitions';\n\nconst ThermalState = registerPlugin<ThermalStatePlugin>('ThermalState', {\n  web: () => import('./web').then(m => new m.ThermalStateWeb()),\n});\n\nexport * from './definitions';\nexport { ThermalState };\n"]}

package/dist/esm/web.d.ts

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

package/dist/esm/web.js

@@ -0,0 +1,7 @@
+import { WebPlugin } from '@capacitor/core';
+export class ThermalStateWeb extends WebPlugin {
+    async getThermalState() {
+        throw this.unimplemented('Not implemented on web.');
+    }
+}
+//# 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,CAAC;AAI5C,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5C,KAAK,CAAC,eAAe;QACnB,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACtD,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type { GetThermalStateResult, ThermalStatePlugin } from './definitions';\n\nexport class ThermalStateWeb extends WebPlugin implements ThermalStatePlugin {\n  async getThermalState(): Promise<GetThermalStateResult> {\n    throw this.unimplemented('Not implemented on web.');\n  }\n}\n"]}

package/dist/plugin.cjs.js

@@ -0,0 +1,21 @@
+'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 getThermalState() {
+        throw this.unimplemented('Not implemented on web.');
+    }
+}
+
+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', {\n    web: () => import('./web').then(m => new m.ThermalStateWeb()),\n});\nexport * from './definitions';\nexport { ThermalState };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class ThermalStateWeb extends WebPlugin {\n    async getThermalState() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACK,MAAC,YAAY,GAAGA,mBAAc,CAAC,cAAc,EAAE;AACpD,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC;AACjE,CAAC;;ACFM,MAAM,eAAe,SAASC,cAAS,CAAC;AAC/C,IAAI,MAAM,eAAe,GAAG;AAC5B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;AAC3D,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js

@@ -0,0 +1,24 @@
+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 getThermalState() {
+            throw this.unimplemented('Not implemented on web.');
+        }
+    }
+
+    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', {\n    web: () => import('./web').then(m => new m.ThermalStateWeb()),\n});\nexport * from './definitions';\nexport { ThermalState };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class ThermalStateWeb extends WebPlugin {\n    async getThermalState() {\n        throw this.unimplemented('Not implemented on web.');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;AACK,UAAC,YAAY,GAAGA,mBAAc,CAAC,cAAc,EAAE;IACpD,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC;IACjE,CAAC;;ICFM,MAAM,eAAe,SAASC,cAAS,CAAC;IAC/C,IAAI,MAAM,eAAe,GAAG;IAC5B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,yBAAyB,CAAC;IAC3D,IAAI;IACJ;;;;;;;;;;;;;;;"}

package/ios/Plugin/Classes/Events/ThermalStateChangeEvent.swift

@@ -0,0 +1,16 @@
+import Foundation
+import Capacitor
+
+@objc public class ThermalStateChangeEvent: NSObject, Result {
+    let state: String
+
+    init(state: String) {
+        self.state = state
+    }
+
+    @objc public func toJSObject() -> AnyObject {
+        var result = JSObject()
+        result["state"] = state
+        return result as AnyObject
+    }
+}

package/ios/Plugin/Classes/Results/GetThermalStateResult.swift

@@ -0,0 +1,16 @@
+import Foundation
+import Capacitor
+
+@objc public class GetThermalStateResult: NSObject, Result {
+    let state: String
+
+    init(state: String) {
+        self.state = state
+    }
+
+    @objc public func toJSObject() -> AnyObject {
+        var result = JSObject()
+        result["state"] = state
+        return result as AnyObject
+    }
+}

package/ios/Plugin/Info.plist

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>$(DEVELOPMENT_LANGUAGE)</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>FMWK</string>
+	<key>CFBundleShortVersionString</key>
+	<string>1.0</string>
+	<key>CFBundleVersion</key>
+	<string>$(CURRENT_PROJECT_VERSION)</string>
+	<key>NSPrincipalClass</key>
+	<string></string>
+</dict>
+</plist>

package/ios/Plugin/Protocols/Result.swift

@@ -0,0 +1,5 @@
+import Capacitor
+
+@objc public protocol Result {
+    @objc func toJSObject() -> AnyObject
+}

package/ios/Plugin/ThermalState.swift

@@ -0,0 +1,62 @@
+import Foundation
+
+@objc public class ThermalState: NSObject {
+    private let plugin: ThermalStatePlugin
+
+    private var isObserving = false
+
+    init(plugin: ThermalStatePlugin) {
+        self.plugin = plugin
+        super.init()
+    }
+
+    deinit {
+        NotificationCenter.default.removeObserver(self)
+    }
+
+    @objc public func getThermalState(completion: @escaping (GetThermalStateResult?, Error?) -> Void) {
+        let state = mapThermalState(ProcessInfo.processInfo.thermalState)
+        completion(GetThermalStateResult(state: state), nil)
+    }
+
+    func startObserving() {
+        guard !isObserving else {
+            return
+        }
+        isObserving = true
+        NotificationCenter.default.addObserver(
+            self,
+            selector: #selector(handleThermalStateDidChange),
+            name: ProcessInfo.thermalStateDidChangeNotification,
+            object: nil
+        )
+    }
+
+    func stopObserving() {
+        guard isObserving else {
+            return
+        }
+        isObserving = false
+        NotificationCenter.default.removeObserver(self, name: ProcessInfo.thermalStateDidChangeNotification, object: nil)
+    }
+
+    @objc private func handleThermalStateDidChange() {
+        let state = mapThermalState(ProcessInfo.processInfo.thermalState)
+        plugin.notifyThermalStateChangeListeners(ThermalStateChangeEvent(state: state))
+    }
+
+    private func mapThermalState(_ state: ProcessInfo.ThermalState) -> String {
+        switch state {
+        case .critical:
+            return "critical"
+        case .fair:
+            return "fair"
+        case .nominal:
+            return "nominal"
+        case .serious:
+            return "serious"
+        @unknown default:
+            return "nominal"
+        }
+    }
+}

package/ios/Plugin/ThermalStatePlugin.swift

@@ -0,0 +1,65 @@
+import Foundation
+import Capacitor
+
+@objc(ThermalStatePlugin)
+public class ThermalStatePlugin: CAPPlugin, CAPBridgedPlugin {
+    public let identifier = "ThermalStatePlugin"
+    public let jsName = "ThermalState"
+    public let pluginMethods: [CAPPluginMethod] = [
+        CAPPluginMethod(name: "getThermalState", returnType: CAPPluginReturnPromise)
+    ]
+
+    public static let eventThermalStateChange = "thermalStateChange"
+
+    public static let tag = "ThermalStatePlugin"
+
+    private var implementation: ThermalState?
+
+    override public func load() {
+        self.implementation = ThermalState(plugin: self)
+    }
+
+    @objc override public func addListener(_ call: CAPPluginCall) {
+        super.addListener(call)
+        implementation?.startObserving()
+    }
+
+    @objc func getThermalState(_ call: CAPPluginCall) {
+        implementation?.getThermalState { result, error in
+            if let error = error {
+                self.rejectCall(call, error)
+                return
+            }
+            self.resolveCall(call, result)
+        }
+    }
+
+    public func notifyThermalStateChangeListeners(_ event: ThermalStateChangeEvent) {
+        self.notifyListeners(Self.eventThermalStateChange, data: event.toJSObject() as? [String: Any])
+    }
+
+    @objc override public func removeAllListeners(_ call: CAPPluginCall) {
+        super.removeAllListeners(call)
+        implementation?.stopObserving()
+    }
+
+    @objc override public func removeListener(_ call: CAPPluginCall) {
+        super.removeListener(call)
+        if !hasListeners(Self.eventThermalStateChange) {
+            implementation?.stopObserving()
+        }
+    }
+
+    private func rejectCall(_ call: CAPPluginCall, _ error: Error) {
+        CAPLog.print("[", ThermalStatePlugin.tag, "] ", error)
+        call.reject(error.localizedDescription)
+    }
+
+    private func resolveCall(_ call: CAPPluginCall, _ result: Result?) {
+        if let result = result?.toJSObject() as? JSObject {
+            call.resolve(result)
+        } else {
+            call.resolve()
+        }
+    }
+}

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "@capawesome/capacitor-thermal-state",
+  "version": "0.0.1",
+  "description": "Capacitor plugin to read the device thermal state.",
+  "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/Plugin/",
+    "CapawesomeCapacitorThermalState.podspec",
+    "Package.swift"
+  ],
+  "author": "Robin Genz <mail@robingenz.dev>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/capawesome-team/capacitor-plugins.git"
+  },
+  "bugs": {
+    "url": "https://github.com/capawesome-team/capacitor-plugins/issues"
+  },
+  "funding": [
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/capawesome-team/"
+    },
+    {
+      "type": "opencollective",
+      "url": "https://opencollective.com/capawesome"
+    }
+  ],
+  "homepage": "https://capawesome.io/docs/plugins/thermal-state/",
+  "keywords": [
+    "capacitor",
+    "plugin",
+    "native"
+  ],
+  "scripts": {
+    "verify": "npm run verify:ios && npm run verify:android && npm run verify:web",
+    "verify:ios": "cd ios && pod install && xcodebuild -workspace Plugin.xcworkspace -scheme Plugin -destination generic/platform=iOS && cd ..",
+    "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}\"",
+    "swiftlint": "node-swiftlint",
+    "docgen": "docgen --api ThermalStatePlugin --output-readme README.md --output-json dist/docs.json",
+    "build": "npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs",
+    "clean": "rimraf ./dist",
+    "watch": "tsc --watch",
+    "ios:pod:install": "cd ios && pod install --repo-update && cd ..",
+    "ios:spm:install": "cd ios && swift package resolve && cd ..",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@capacitor/android": "8.0.0",
+    "@capacitor/cli": "8.0.0",
+    "@capacitor/core": "8.0.0",
+    "@capacitor/docgen": "0.3.1",
+    "@capacitor/ios": "8.0.0",
+    "@ionic/eslint-config": "0.4.0",
+    "eslint": "8.57.0",
+    "prettier-plugin-java": "2.6.7",
+    "rimraf": "6.1.2",
+    "rollup": "4.53.3",
+    "swiftlint": "2.0.0",
+    "typescript": "5.9.3"
+  },
+  "peerDependencies": {
+    "@capacitor/core": ">=8.0.0"
+  },
+  "eslintConfig": {
+    "extends": "@ionic/eslint-config/recommended"
+  },
+  "capacitor": {
+    "ios": {
+      "src": "ios"
+    },
+    "android": {
+      "src": "android"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}