@capawesome/capacitor-clipboard 0.0.1

package/CapawesomeCapacitorClipboard.podspec

@@ -0,0 +1,17 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name = 'CapawesomeCapacitorClipboard'
+  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: "CapawesomeCapacitorClipboard",
+    platforms: [.iOS(.v15)],
+    products: [
+        .library(
+            name: "CapawesomeCapacitorClipboard",
+            targets: ["ClipboardPlugin"])
+    ],
+    dependencies: [
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "8.0.0")
+    ],
+    targets: [
+        .target(
+            name: "ClipboardPlugin",
+            dependencies: [
+                .product(name: "Capacitor", package: "capacitor-swift-pm"),
+                .product(name: "Cordova", package: "capacitor-swift-pm")
+            ],
+            path: "ios/Plugin"),
+        .testTarget(
+            name: "ClipboardPluginTests",
+            dependencies: ["ClipboardPlugin"],
+            path: "ios/PluginTests")
+    ]
+)

package/README.md

@@ -0,0 +1,220 @@
+# Capacitor Clipboard Plugin
+
+Capacitor plugin to read from and write to the system clipboard.
+
+<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
+
+- 📋 **Read & Write**: Read from and write to the system clipboard.
+- 🖼️ **Images**: Copy and paste real images, not just data URLs as plain text.
+- 📝 **Rich Text**: Write HTML content with a plain-text fallback.
+- 🔗 **URLs**: Copy URLs as native URL clipboard items.
+- 🌐 **Cross-platform**: Works on Android, iOS, and the web.
+- 🔒 **App Store safe**: Uses only official platform APIs.
+- 📦 **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-clipboard` 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-clipboard
+npx cap sync
+```
+
+### Android
+
+No additional configuration is required for this plugin.
+
+### iOS
+
+No additional configuration is required for this plugin.
+
+## Configuration
+
+No configuration required for this plugin.
+
+## Usage
+
+```typescript
+import { Clipboard } from '@capawesome/capacitor-clipboard';
+
+const writeText = async () => {
+  await Clipboard.write({ text: 'Hello World' });
+};
+
+const writeHtml = async () => {
+  await Clipboard.write({
+    html: '<b>Hello World</b>',
+    text: 'Hello World',
+  });
+};
+
+const writeImage = async () => {
+  await Clipboard.write({
+    image: 'data:image/png;base64,iVBORw0KGgo...',
+  });
+};
+
+const writeUrl = async () => {
+  await Clipboard.write({ url: 'https://capawesome.io' });
+};
+
+const read = async () => {
+  const { type, value } = await Clipboard.read();
+  console.log('Type:', type, 'Value:', value);
+};
+```
+
+## API
+
+<docgen-index>
+
+* [`read()`](#read)
+* [`write(...)`](#write)
+* [Interfaces](#interfaces)
+* [Enums](#enums)
+
+</docgen-index>
+
+<docgen-api>
+<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
+
+### read()
+
+```typescript
+read() => Promise<ReadResult>
+```
+
+Read the current content of the system clipboard.
+
+On Android, reading the clipboard is only possible while the app is in the
+foreground.
+
+On iOS, reading the clipboard displays a system paste notification. This is
+expected behavior and cannot be suppressed.
+
+**Returns:** <code>Promise&lt;<a href="#readresult">ReadResult</a>&gt;</code>
+
+**Since:** 0.1.0
+
+--------------------
+
+
+### write(...)
+
+```typescript
+write(options: WriteOptions) => Promise<void>
+```
+
+Write content to the system clipboard.
+
+Exactly one of `text`, `html`, `image` or `url` must be provided. The
+`html` property may additionally be combined with `text` to provide a
+plain-text fallback.
+
+| Param         | Type                                                  |
+| ------------- | ----------------------------------------------------- |
+| **`options`** | <code><a href="#writeoptions">WriteOptions</a></code> |
+
+**Since:** 0.1.0
+
+--------------------
+
+
+### Interfaces
+
+
+#### ReadResult
+
+| Prop        | Type                                                                  | Description                                                                                     | Since |
+| ----------- | --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | ----- |
+| **`type`**  | <code><a href="#clipboardcontenttype">ClipboardContentType</a></code> | The type of the content that was read from the clipboard.                                       | 0.1.0 |
+| **`value`** | <code>string</code>                                                   | The content that was read from the clipboard. Images are returned as a Base64-encoded data URL. | 0.1.0 |
+
+
+#### WriteOptions
+
+| Prop        | Type                | Description                                                                                                                                     | Since |
+| ----------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
+| **`html`**  | <code>string</code> | The HTML content to write to the clipboard. Combine this with `text` to provide a plain-text fallback for apps that cannot handle HTML content. | 0.1.0 |
+| **`image`** | <code>string</code> | The image to write to the clipboard as a Base64-encoded data URL.                                                                               | 0.1.0 |
+| **`label`** | <code>string</code> | The label used to describe the clipboard content. Only available on Android.                                                                    | 0.1.0 |
+| **`text`**  | <code>string</code> | The plain text to write to the clipboard.                                                                                                       | 0.1.0 |
+| **`url`**   | <code>string</code> | The URL to write to the clipboard.                                                                                                              | 0.1.0 |
+
+
+### Enums
+
+
+#### ClipboardContentType
+
+| Members     | Value                | Description                                                     | Since |
+| ----------- | -------------------- | --------------------------------------------------------------- | ----- |
+| **`Html`**  | <code>'HTML'</code>  | The content is HTML.                                            | 0.1.0 |
+| **`Image`** | <code>'IMAGE'</code> | The content is an image, returned as a Base64-encoded data URL. | 0.1.0 |
+| **`Text`**  | <code>'TEXT'</code>  | The content is plain text.                                      | 0.1.0 |
+| **`Url`**   | <code>'URL'</code>   | The content is a URL.                                           | 0.1.0 |
+
+</docgen-api>
+
+## Platform Behavior
+
+### Android
+
+- On Android 10 (API level 29) and later, apps can only read the clipboard while they are in the foreground and have input focus. The `read(...)` method rejects otherwise.
+- On Android 12 (API level 31) and later, the system shows a toast message when an app reads the clipboard content that was written by another app. This is expected behavior and cannot be suppressed.
+
+### iOS
+
+- On iOS 14 and later, the system shows a paste notification banner every time the clipboard is read. This is expected behavior and cannot be suppressed.
+
+## Migrating from `@capacitor/clipboard`
+
+This plugin is a drop-in alternative to the official [`@capacitor/clipboard`](https://github.com/ionic-team/capacitor-plugins/tree/main/clipboard) plugin with real image support on Android and HTML support on all platforms. The following differences apply:
+
+| `@capacitor/clipboard`                     | `@capawesome/capacitor-clipboard`                      |
+| ------------------------------------------ | ------------------------------------------------------ |
+| `write({ string: 'Hello' })`               | `write({ text: 'Hello' })`                             |
+| `write({ image: dataUrl })` (text-only on Android) | `write({ image: dataUrl })` (real image on all platforms) |
+| —                                          | `write({ html: '<b>Hello</b>', text: 'Hello' })`       |
+| `read() → { value, type: 'text/plain' }`   | `read() → { value, type: 'TEXT' }`                     |
+
+## Changelog
+
+See [CHANGELOG.md](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/clipboard/CHANGELOG.md).
+
+## License
+
+See [LICENSE](https://github.com/capawesome-team/capacitor-plugins/blob/main/packages/clipboard/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.clipboard"
+    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/clipboard/Clipboard.java

@@ -0,0 +1,141 @@
+package io.capawesome.capacitorjs.plugins.clipboard;
+
+import android.content.ClipData;
+import android.content.ClipboardManager;
+import android.content.Context;
+import android.graphics.Bitmap;
+import android.graphics.BitmapFactory;
+import android.net.Uri;
+import android.util.Base64;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import androidx.core.content.FileProvider;
+import io.capawesome.capacitorjs.plugins.clipboard.classes.ClipboardContentType;
+import io.capawesome.capacitorjs.plugins.clipboard.classes.CustomExceptions;
+import io.capawesome.capacitorjs.plugins.clipboard.classes.options.WriteOptions;
+import io.capawesome.capacitorjs.plugins.clipboard.classes.results.ReadResult;
+import io.capawesome.capacitorjs.plugins.clipboard.interfaces.EmptyCallback;
+import io.capawesome.capacitorjs.plugins.clipboard.interfaces.NonEmptyResultCallback;
+import java.io.ByteArrayOutputStream;
+import java.io.File;
+import java.io.FileOutputStream;
+import java.io.InputStream;
+
+public class Clipboard {
+
+    private static final String DEFAULT_LABEL = "";
+    private static final String IMAGE_FILE_NAME = "capawesome_capacitor_clipboard_image.png";
+
+    @NonNull
+    private final ClipboardPlugin plugin;
+
+    public Clipboard(@NonNull ClipboardPlugin plugin) {
+        this.plugin = plugin;
+    }
+
+    public void read(@NonNull NonEmptyResultCallback<ReadResult> callback) {
+        try {
+            ClipboardManager clipboardManager = getClipboardManager();
+            ClipData clipData = clipboardManager.getPrimaryClip();
+            if (clipData == null || clipData.getItemCount() == 0) {
+                callback.error(CustomExceptions.EMPTY_CLIPBOARD);
+                return;
+            }
+            ClipData.Item item = clipData.getItemAt(0);
+            ReadResult result = createReadResult(item);
+            if (result == null) {
+                callback.error(CustomExceptions.EMPTY_CLIPBOARD);
+                return;
+            }
+            callback.success(result);
+        } catch (Exception exception) {
+            callback.error(CustomExceptions.READ_FAILED);
+        }
+    }
+
+    public void write(@NonNull WriteOptions options, @NonNull EmptyCallback callback) {
+        try {
+            String label = options.getLabel() == null ? DEFAULT_LABEL : options.getLabel();
+            ClipData clipData;
+            if (options.getImage() != null) {
+                clipData = createImageClipData(label, options.getImage());
+            } else if (options.getHtml() != null) {
+                String text = options.getText() == null ? options.getHtml() : options.getText();
+                clipData = ClipData.newHtmlText(label, text, options.getHtml());
+            } else if (options.getUrl() != null) {
+                clipData = ClipData.newRawUri(label, Uri.parse(options.getUrl()));
+            } else {
+                clipData = ClipData.newPlainText(label, options.getText());
+            }
+            getClipboardManager().setPrimaryClip(clipData);
+            callback.success();
+        } catch (Exception exception) {
+            callback.error(CustomExceptions.WRITE_FAILED);
+        }
+    }
+
+    @NonNull
+    private ClipData createImageClipData(@NonNull String label, @NonNull String image) throws Exception {
+        byte[] bytes = decodeDataUrl(image);
+        File file = new File(getContext().getCacheDir(), IMAGE_FILE_NAME);
+        try (FileOutputStream outputStream = new FileOutputStream(file)) {
+            outputStream.write(bytes);
+        }
+        String authority = getContext().getPackageName() + ".fileprovider";
+        Uri uri = FileProvider.getUriForFile(getContext(), authority, file);
+        return ClipData.newUri(getContext().getContentResolver(), label, uri);
+    }
+
+    @Nullable
+    private ReadResult createReadResult(@NonNull ClipData.Item item) throws Exception {
+        Uri uri = item.getUri();
+        if (uri != null) {
+            String mimeType = getContext().getContentResolver().getType(uri);
+            if (mimeType != null && mimeType.startsWith("image/")) {
+                return new ReadResult(ClipboardContentType.IMAGE, encodeImageAsDataUrl(uri));
+            }
+            return new ReadResult(ClipboardContentType.URL, uri.toString());
+        }
+        String html = item.getHtmlText();
+        if (html != null) {
+            return new ReadResult(ClipboardContentType.HTML, html);
+        }
+        CharSequence text = item.getText();
+        if (text != null) {
+            String value = text.toString();
+            if (value.startsWith("http://") || value.startsWith("https://")) {
+                return new ReadResult(ClipboardContentType.URL, value);
+            }
+            return new ReadResult(ClipboardContentType.TEXT, value);
+        }
+        return null;
+    }
+
+    @NonNull
+    private byte[] decodeDataUrl(@NonNull String dataUrl) throws Exception {
+        int index = dataUrl.indexOf(',');
+        String base64 = index == -1 ? dataUrl : dataUrl.substring(index + 1);
+        return Base64.decode(base64, Base64.DEFAULT);
+    }
+
+    @NonNull
+    private String encodeImageAsDataUrl(@NonNull Uri uri) throws Exception {
+        try (InputStream inputStream = getContext().getContentResolver().openInputStream(uri)) {
+            Bitmap bitmap = BitmapFactory.decodeStream(inputStream);
+            ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
+            bitmap.compress(Bitmap.CompressFormat.PNG, 100, outputStream);
+            String base64 = Base64.encodeToString(outputStream.toByteArray(), Base64.NO_WRAP);
+            return "data:image/png;base64," + base64;
+        }
+    }
+
+    @NonNull
+    private ClipboardManager getClipboardManager() {
+        return (ClipboardManager) getContext().getSystemService(Context.CLIPBOARD_SERVICE);
+    }
+
+    @NonNull
+    private Context getContext() {
+        return plugin.getContext();
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/clipboard/ClipboardPlugin.java

@@ -0,0 +1,96 @@
+package io.capawesome.capacitorjs.plugins.clipboard;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+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.clipboard.classes.CustomException;
+import io.capawesome.capacitorjs.plugins.clipboard.classes.options.WriteOptions;
+import io.capawesome.capacitorjs.plugins.clipboard.classes.results.ReadResult;
+import io.capawesome.capacitorjs.plugins.clipboard.interfaces.EmptyCallback;
+import io.capawesome.capacitorjs.plugins.clipboard.interfaces.NonEmptyResultCallback;
+import io.capawesome.capacitorjs.plugins.clipboard.interfaces.Result;
+
+@CapacitorPlugin(name = "Clipboard")
+public class ClipboardPlugin extends Plugin {
+
+    public static final String ERROR_UNKNOWN_ERROR = "An unknown error has occurred.";
+    public static final String TAG = "ClipboardPlugin";
+
+    private Clipboard implementation;
+
+    @Override
+    public void load() {
+        super.load();
+        this.implementation = new Clipboard(this);
+    }
+
+    @PluginMethod
+    public void read(PluginCall call) {
+        try {
+            NonEmptyResultCallback<ReadResult> callback = new NonEmptyResultCallback<>() {
+                @Override
+                public void success(@NonNull ReadResult result) {
+                    resolveCall(call, result);
+                }
+
+                @Override
+                public void error(Exception exception) {
+                    rejectCall(call, exception);
+                }
+            };
+            implementation.read(callback);
+        } catch (Exception exception) {
+            rejectCall(call, exception);
+        }
+    }
+
+    @PluginMethod
+    public void write(PluginCall call) {
+        try {
+            WriteOptions options = new WriteOptions(call);
+            EmptyCallback callback = new EmptyCallback() {
+                @Override
+                public void success() {
+                    resolveCall(call);
+                }
+
+                @Override
+                public void error(Exception exception) {
+                    rejectCall(call, exception);
+                }
+            };
+            implementation.write(options, callback);
+        } catch (Exception exception) {
+            rejectCall(call, exception);
+        }
+    }
+
+    private void rejectCall(@NonNull PluginCall call, @NonNull Exception exception) {
+        String message = exception.getMessage();
+        if (message == null) {
+            message = ERROR_UNKNOWN_ERROR;
+        }
+        String code = null;
+        if (exception instanceof CustomException) {
+            code = ((CustomException) exception).getCode();
+        }
+        Logger.error(TAG, message, exception);
+        call.reject(message, code);
+    }
+
+    private void resolveCall(@NonNull PluginCall call) {
+        call.resolve();
+    }
+
+    private void resolveCall(@NonNull PluginCall call, @Nullable Result result) {
+        if (result == null) {
+            call.resolve();
+        } else {
+            call.resolve(result.toJSObject());
+        }
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/clipboard/classes/ClipboardContentType.java

@@ -0,0 +1,22 @@
+package io.capawesome.capacitorjs.plugins.clipboard.classes;
+
+import androidx.annotation.NonNull;
+
+public enum ClipboardContentType {
+    HTML("HTML"),
+    IMAGE("IMAGE"),
+    TEXT("TEXT"),
+    URL("URL");
+
+    @NonNull
+    private final String value;
+
+    ClipboardContentType(@NonNull String value) {
+        this.value = value;
+    }
+
+    @NonNull
+    public String getValue() {
+        return value;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/clipboard/classes/CustomException.java

@@ -0,0 +1,20 @@
+package io.capawesome.capacitorjs.plugins.clipboard.classes;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+
+public class CustomException extends Exception {
+
+    @Nullable
+    private final String code;
+
+    public CustomException(@Nullable String code, @NonNull String message) {
+        super(message);
+        this.code = code;
+    }
+
+    @Nullable
+    public String getCode() {
+        return code;
+    }
+}

package/android/src/main/java/io/capawesome/capacitorjs/plugins/clipboard/classes/CustomExceptions.java

@@ -0,0 +1,12 @@
+package io.capawesome.capacitorjs.plugins.clipboard.classes;
+
+public class CustomExceptions {
+
+    public static final CustomException CONTENT_MISSING = new CustomException(null, "One of text, html, image or url must be provided.");
+    public static final CustomException EMPTY_CLIPBOARD = new CustomException("EMPTY_CLIPBOARD", "The clipboard is empty.");
+    public static final CustomException READ_FAILED = new CustomException("READ_FAILED", "The clipboard content could not be read.");
+    public static final CustomException WRITE_FAILED = new CustomException(
+        "WRITE_FAILED",
+        "The content could not be written to the clipboard."
+    );
+}