@exxili/capacitor-nfc 0.0.1

package/CapacitorNfc.podspec

@@ -0,0 +1,17 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name = 'CapacitorNfc'
+  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  = '13.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: "CapacitorNfc",
+    platforms: [.iOS(.v13)],
+    products: [
+        .library(
+            name: "CapacitorNfc",
+            targets: ["NFCPlugin"])
+    ],
+    dependencies: [
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", branch: "main")
+    ],
+    targets: [
+        .target(
+            name: "NFCPlugin",
+            dependencies: [
+                .product(name: "Capacitor", package: "capacitor-swift-pm"),
+                .product(name: "Cordova", package: "capacitor-swift-pm")
+            ],
+            path: "ios/Sources/NFCPlugin"),
+        .testTarget(
+            name: "NFCPluginTests",
+            dependencies: ["NFCPlugin"],
+            path: "ios/Tests/NFCPluginTests")
+    ]
+)

package/README.md

@@ -0,0 +1,371 @@
+# Capacitor NFC Plugin (@exxili/capacitor-nfc)
+
+A Capacitor plugin for reading and writing NFC tags on iOS devices. This plugin allows you to:
+
+- Read NDEF messages from NFC tags.
+- Write NDEF messages to NFC tags.
+
+**Note**: NFC functionality is only available on compatible iOS devices running iOS 13.0 or later. Android NFC functionality is still
+in development
+
+## Table of Contents
+
+- [Installation](#installation)
+- [iOS Setup](#ios-setup)
+- Android Setup (in Development)
+- [Usage](#usage)
+  - [Reading NFC Tags](#reading-nfc-tags)
+  - [Writing NFC Tags](#writing-nfc-tags)
+- [API](#api)
+  - [Methods](#methods)
+    - [`startScan()`](#startscan)
+    - [`writeNDEF(options)`](#writendefoptions)
+  - [Listeners](#listeners)
+    - [`addListener('nfcTag', listener)`](#addlistenernfctag-listener)
+    - [`addListener('nfcError', listener)`](#addlistenernfcerror-listener)
+    - [`addListener('nfcWriteSuccess', listener)`](#addlistenernfcwritesuccess-listener)
+  - [Interfaces](#interfaces)
+    - [`NDEFWriteOptions`](#ndefwriteoptions)
+    - [`NDEFMessages`](#ndefmessages)
+    - [`NDEFMessage`](#ndefmessage)
+    - [`NDEFRecord`](#ndefrecord)
+    - [`NFCError`](#nfcerror)
+- [Integration into a Capacitor App](#integration-into-a-capacitor-app)
+- [Example](#example)
+- [License](#license)
+
+## Installation
+
+Install the plugin using npm:
+
+```bash
+npm install @exxili/capacitor-nfc
+npx cap sync
+```
+
+## iOS Setup
+
+To use NFC functionality on iOS, you need to perform some additional setup steps.
+
+### 1. Enable NFC Capability
+
+In Xcode:
+
+1. Open your project (`.xcworkspace` file) in Xcode.
+2. Select your project in the Project Navigator.
+3. Select your app target.
+4. Go to the **Signing & Capabilities** tab.
+5. Click the `+ Capability` button.
+6. Add **Near Field Communication Tag Reading**.
+
+### 2. Add Usage Description
+
+Add the `NFCReaderUsageDescription` key to your `Info.plist` file to explain why your app needs access to NFC.
+
+In your `Info.plist` file (usually located at `ios/App/App/Info.plist`), add:
+
+```xml
+<key>NFCReaderUsageDescription</key>
+<string>This app requires access to NFC to read and write NFC tags.</string>
+```
+
+Replace the description with a message that explains why your app needs NFC access.
+
+## Usage
+
+Import the plugin into your code:
+
+```typescript
+import { NFC } from '@exxili/capacitor-nfc';
+```
+
+### Reading NFC Tags
+
+To read NFC tags, you need to start a scanning session and listen for `nfcTag` events.
+
+```typescript
+import { NFC, NDEFMessages, NFCError } from '@exxili/capacitor-nfc';
+
+// Start NFC scanning
+NFC.startScan().catch((error) => {
+  console.error('Error starting NFC scan:', error);
+});
+
+// Listen for NFC tag detection
+const nfcTagListener = NFC.addListener('nfcTag', (data: NDEFMessages) => {
+  console.log('Received NFC tag:', data);
+});
+
+// Handle NFC errors
+const nfcErrorListener = NFC.addListener('nfcError', (error: NFCError) => {
+  console.error('NFC Error:', error);
+});
+```
+
+### Writing NFC Tags
+
+To write NDEF messages to NFC tags, use the `writeNDEF` method and listen for `nfcWriteSuccess` events.
+
+```typescript
+import { NFC, NDEFWriteOptions, NFCError } from '@exxili/capacitor-nfc';
+
+const message: NDEFWriteOptions = {
+  records: [
+    {
+      type: 'T', // Text record type
+      payload: 'Hello, NFC!',
+    },
+  ],
+};
+
+// Write NDEF message to NFC tag
+NFC.writeNDEF(message)
+  .then(() => {
+    console.log('Write initiated');
+  })
+  .catch((error) => {
+    console.error('Error writing to NFC tag:', error);
+  });
+
+// Listen for write success
+const nfcWriteSuccessListener = NFC.addListener('nfcWriteSuccess', () => {
+  console.log('NDEF message written successfully.');
+});
+
+// Handle NFC errors
+const nfcErrorListener = NFC.addListener('nfcError', (error: NFCError) => {
+  console.error('NFC Error:', error);
+});
+```
+
+## API
+
+### Methods
+
+#### `startScan()`
+
+Starts the NFC scanning session.
+
+**Returns**: `Promise<void>`
+
+```typescript
+NFC.startScan()
+  .then(() => {
+    // Scanning started
+  })
+  .catch((error) => {
+    console.error('Error starting NFC scan:', error);
+  });
+```
+
+#### `writeNDEF(options: NDEFWriteOptions)`
+
+Writes an NDEF message to an NFC tag.
+
+**Parameters**:
+
+- `options: NDEFWriteOptions` - The NDEF message to write.
+
+**Returns**: `Promise<void>`
+
+```typescript
+NFC.writeNDEF(options)
+  .then(() => {
+    // Write initiated
+  })
+  .catch((error) => {
+    console.error('Error writing NDEF message:', error);
+  });
+```
+
+### Listeners
+
+#### `addListener('nfcTag', listener: (data: NDEFMessages) => void)`
+
+Adds a listener for NFC tag detection events.
+
+**Parameters**:
+
+- `eventName: 'nfcTag'`
+- `listener: (data: NDEFMessages) => void` - The function to call when an NFC tag is detected.
+
+**Returns**: `PluginListenerHandle`
+
+```typescript
+const nfcTagListener = NFC.addListener('nfcTag', (data: NDEFMessages) => {
+  console.log('Received NFC tag:', data);
+});
+```
+
+#### `addListener('nfcError', listener: (error: NFCError) => void)`
+
+Adds a listener for NFC error events.
+
+**Parameters**:
+
+- `eventName: 'nfcError'`
+- `listener: (error: NFCError) => void` - The function to call when an NFC error occurs.
+
+**Returns**: `PluginListenerHandle`
+
+```typescript
+const nfcErrorListener = NFC.addListener('nfcError', (error: NFCError) => {
+  console.error('NFC Error:', error);
+});
+```
+
+#### `addListener('nfcWriteSuccess', listener: () => void)`
+
+Adds a listener for NFC write success events.
+
+**Parameters**:
+
+- `eventName: 'nfcWriteSuccess'`
+- `listener: () => void` - The function to call when an NDEF message has been written successfully.
+
+**Returns**: `PluginListenerHandle`
+
+```typescript
+const nfcWriteSuccessListener = NFC.addListener('nfcWriteSuccess', () => {
+  console.log('NDEF message written successfully.');
+});
+```
+
+### Interfaces
+
+#### `NDEFWriteOptions`
+
+Options for writing an NDEF message.
+
+```typescript
+interface NDEFWriteOptions {
+  records: NDEFRecord[];
+}
+```
+
+#### `NDEFMessages`
+
+Data received from an NFC tag.
+
+```typescript
+interface NDEFMessages {
+  messages: NDEFMessage[];
+}
+```
+
+#### `NDEFMessage`
+
+An NDEF message consisting of one or more records.
+
+```typescript
+interface NDEFMessage {
+  records: NDEFRecord[];
+}
+```
+
+#### `NDEFRecord`
+
+An NDEF record.
+
+```typescript
+interface NDEFRecord {
+  /**
+   * The type of the record.
+   */
+  type: string;
+
+  /**
+   * The payload of the record.
+   */
+  payload: string;
+}
+```
+
+#### `NFCError`
+
+An NFC error.
+
+```typescript
+interface NFCError {
+  /**
+   * The error message.
+   */
+  error: string;
+}
+```
+
+## Integration into a Capacitor App
+
+To integrate this plugin into your Capacitor app:
+
+1. **Install the plugin:**
+
+   ```bash
+   npm install @exxili/capacitor-nfc
+   npx cap sync
+   ```
+
+2. **Import the plugin in your code:**
+
+   ```typescript
+   import { NFC } from '@exxili/capacitor-nfc';
+   ```
+
+3. **Use the plugin methods as described in the [Usage](#usage) section.**
+
+## Example
+
+Here's a complete example of how to read and write NFC tags in your app:
+
+```typescript
+import { NFC, NDEFMessages, NDEFWriteOptions, NFCError } from '@exxili/capacitor-nfc';
+
+// Start NFC scanning
+NFC.startScan().catch((error) => {
+  console.error('Error starting NFC scan:', error);
+});
+
+// Listen for NFC tag detection
+const nfcTagListener = NFC.addListener('nfcTag', (data: NDEFMessages) => {
+  console.log('Received NFC tag:', data);
+});
+
+// Handle NFC errors
+const nfcErrorListener = NFC.addListener('nfcError', (error: NFCError) => {
+  console.error('NFC Error:', error);
+});
+
+// Prepare an NDEF message to write
+const message: NDEFWriteOptions = {
+  records: [
+    {
+      type: 'T', // Text record type
+      payload: 'Hello, NFC!',
+    },
+  ],
+};
+
+// Write NDEF message to NFC tag
+NFC.writeNDEF(message)
+  .then(() => {
+    console.log('Write initiated');
+  })
+  .catch((error) => {
+    console.error('Error writing to NFC tag:', error);
+  });
+
+// Listen for write success
+const nfcWriteSuccessListener = NFC.addListener('nfcWriteSuccess', () => {
+  console.log('NDEF message written successfully.');
+});
+```
+
+## License
+
+[MIT License](LICENSE)
+
+---
+
+**Support**: If you encounter any issues or have questions, feel free to open an issue.
+
+---

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.6.1'
+    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.1.5'
+    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.5.1'
+}
+
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.2.1'
+    }
+}
+
+apply plugin: 'com.android.library'
+
+android {
+    namespace "com.exxili.capacitornfc"
+    compileSdk project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 34
+    defaultConfig {
+        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 22
+        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 34
+        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_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+}
+
+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/com/exxili/capacitornfc/NFC.java

@@ -0,0 +1,11 @@
+package com.exxili.capacitornfc;
+
+import android.util.Log;
+
+public class NFC {
+
+    public String echo(String value) {
+        Log.i("Echo", value);
+        return value;
+    }
+}

package/android/src/main/java/com/exxili/capacitornfc/NFCPlugin.java

@@ -0,0 +1,22 @@
+package com.exxili.capacitornfc;
+
+import com.getcapacitor.JSObject;
+import com.getcapacitor.Plugin;
+import com.getcapacitor.PluginCall;
+import com.getcapacitor.PluginMethod;
+import com.getcapacitor.annotation.CapacitorPlugin;
+
+@CapacitorPlugin(name = "NFC")
+public class NFCPlugin extends Plugin {
+
+    private NFC implementation = new NFC();
+
+    @PluginMethod
+    public void echo(PluginCall call) {
+        String value = call.getString("value");
+
+        JSObject ret = new JSObject();
+        ret.put("value", implementation.echo(value));
+        call.resolve(ret);
+    }
+}

package/dist/esm/definitions.d.ts

@@ -0,0 +1,54 @@
+import { PluginListenerHandle } from '@capacitor/core';
+export interface NFCPlugin {
+    /**
+     * Starts the NFC scanning session.
+     */
+    startScan(): Promise<void>;
+    /**
+     * Writes an NDEF message to an NFC tag.
+     * @param options The NDEF message to write.
+     */
+    writeNDEF(options: NDEFWriteOptions): Promise<void>;
+    /**
+     * Adds a listener for NFC tag detection events.
+     * @param eventName The name of the event ('nfcTag').
+     * @param listenerFunc The function to call when an NFC tag is detected.
+     */
+    addListener(eventName: 'nfcTag', listenerFunc: (data: NDEFMessages) => void): Promise<PluginListenerHandle> & PluginListenerHandle;
+    /**
+     * Adds a listener for NFC error events.
+     * @param eventName The name of the event ('nfcError').
+     * @param listenerFunc The function to call when an NFC error occurs.
+     */
+    addListener(eventName: 'nfcError', listenerFunc: (error: NFCError) => void): Promise<PluginListenerHandle> & PluginListenerHandle;
+    /**
+     * Removes all listeners for the specified event.
+     * @param eventName The name of the event.
+     */
+    removeAllListeners(eventName: 'nfcTag' | 'nfcError'): Promise<void>;
+}
+export interface NDEFMessages {
+    messages: NDEFMessage[];
+}
+export interface NDEFMessage {
+    records: NDEFRecord[];
+}
+export interface NDEFRecord {
+    /**
+     * The type of the record.
+     */
+    type: string;
+    /**
+     * The payload of the record.
+     */
+    payload: string;
+}
+export interface NFCError {
+    /**
+     * The error message.
+     */
+    error: string;
+}
+export interface NDEFWriteOptions {
+    records: NDEFRecord[];
+}

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 { PluginListenerHandle } from '@capacitor/core';\n\nexport interface NFCPlugin {\n  /**\n   * Starts the NFC scanning session.\n   */\n  startScan(): Promise<void>;\n\n  /**\n   * Writes an NDEF message to an NFC tag.\n   * @param options The NDEF message to write.\n   */\n  writeNDEF(options: NDEFWriteOptions): Promise<void>;\n\n  /**\n   * Adds a listener for NFC tag detection events.\n   * @param eventName The name of the event ('nfcTag').\n   * @param listenerFunc The function to call when an NFC tag is detected.\n   */\n  addListener(\n    eventName: 'nfcTag',\n    listenerFunc: (data: NDEFMessages) => void,\n  ): Promise<PluginListenerHandle> & PluginListenerHandle;\n\n  /**\n   * Adds a listener for NFC error events.\n   * @param eventName The name of the event ('nfcError').\n   * @param listenerFunc The function to call when an NFC error occurs.\n   */\n  addListener(\n    eventName: 'nfcError',\n    listenerFunc: (error: NFCError) => void,\n  ): Promise<PluginListenerHandle> & PluginListenerHandle;\n\n  /**\n   * Removes all listeners for the specified event.\n   * @param eventName The name of the event.\n   */\n  removeAllListeners(eventName: 'nfcTag' | 'nfcError'): Promise<void>;\n}\n\nexport interface NDEFMessages {\n  messages: NDEFMessage[];\n}\n\nexport interface NDEFMessage {\n  records: NDEFRecord[];\n}\n\nexport interface NDEFRecord {\n  /**\n   * The type of the record.\n   */\n  type: string;\n\n  /**\n   * The payload of the record.\n   */\n  payload: string;\n}\n\nexport interface NFCError {\n  /**\n   * The error message.\n   */\n  error: string;\n}\n\nexport interface NDEFWriteOptions {\n  records: NDEFRecord[];\n}\n"]}

package/dist/esm/index.d.ts

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

package/dist/esm/index.js

@@ -0,0 +1,5 @@
+import { registerPlugin } from '@capacitor/core';
+const NFC = registerPlugin('NFC');
+export * from './definitions';
+export { NFC };
+//# 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;AAGjD,MAAM,GAAG,GAAG,cAAc,CAAY,KAAK,CAAC,CAAC;AAE7C,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,GAAG,EAAE,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\nimport type { NFCPlugin } from './definitions';\n\nconst NFC = registerPlugin<NFCPlugin>('NFC');\n\nexport * from './definitions';\nexport { NFC };\n"]}

package/dist/plugin.cjs.js

@@ -0,0 +1,10 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var core = require('@capacitor/core');
+
+const NFC = core.registerPlugin('NFC');
+
+exports.NFC = NFC;
+//# sourceMappingURL=plugin.cjs.js.map

package/dist/plugin.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst NFC = registerPlugin('NFC');\nexport * from './definitions';\nexport { NFC };\n//# sourceMappingURL=index.js.map"],"names":["registerPlugin"],"mappings":";;;;;;AACK,MAAC,GAAG,GAAGA,mBAAc,CAAC,KAAK;;;;"}

package/dist/plugin.js

@@ -0,0 +1,13 @@
+var capacitorNFC = (function (exports, core) {
+	'use strict';
+
+	const NFC = core.registerPlugin('NFC');
+
+	exports.NFC = NFC;
+
+	Object.defineProperty(exports, '__esModule', { value: true });
+
+	return exports;
+
+})({}, capacitorExports);
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sources":["esm/index.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst NFC = registerPlugin('NFC');\nexport * from './definitions';\nexport { NFC };\n//# sourceMappingURL=index.js.map"],"names":["registerPlugin"],"mappings":";;;AACK,OAAC,GAAG,GAAGA,mBAAc,CAAC,KAAK;;;;;;;;;;;;"}

package/ios/Sources/NFCPlugin/NFCPlugin.swift

@@ -0,0 +1,93 @@
+import Foundation
+import Capacitor
+import CoreNFC
+
+@objc(NFCPlugin)
+public class NFCPlugin: CAPPlugin, CAPBridgedPlugin {
+    public let identifier = "NFCPlugin"
+    public let jsName = "NFC"
+    public let pluginMethods: [CAPPluginMethod] = [
+        CAPPluginMethod(name: "startScan", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "writeNDEF", returnType: CAPPluginReturnPromise)
+    ]
+
+    private let reader = NFCReader()
+    private let writer = NFCWriter()
+
+    @objc func startScan(_ call: CAPPluginCall) {
+        print("startScan called")
+        reader.onNDEFMessageReceived = { messages in
+            var ndefMessages = [[String: Any]]()
+            for message in messages {
+                var records = [[String: Any]]()
+                for record in message.records {
+                    let recordType = String(data: record.type, encoding: .utf8) ?? ""
+                    let payload = String(data: record.payload, encoding: .utf8) ?? ""
+                    records.append([
+                        "type": recordType,
+                        "payload": payload
+                    ])
+                }
+                ndefMessages.append([
+                    "records": records
+                ])
+            }
+            self.notifyListeners("nfcTag", data: ["messages": ndefMessages])
+        }
+
+        reader.onError = { error in
+            if let nfcError = error as? NFCReaderError {
+                if nfcError.code != .readerSessionInvalidationErrorUserCanceled {
+                    self.notifyListeners("nfcError", data: ["error": nfcError.localizedDescription])
+                }
+            }
+        }
+
+        reader.startScanning()
+        call.resolve()
+    }
+
+    @objc func writeNDEF(_ call: CAPPluginCall) {
+        print("writeNDEF called")
+
+        guard let recordsData = call.getArray("records") as? [[String: Any]] else {
+            call.reject("Records are required")
+            return
+        }
+
+        var ndefRecords = [NFCNDEFPayload]()
+        for recordData in recordsData {
+            guard let type = recordData["type"] as? String,
+                  let payload = recordData["payload"] as? String,
+                  let typeData = type.data(using: .utf8),
+                  let payloadData = payload.data(using: .utf8) else {
+                continue
+            }
+
+            let ndefRecord = NFCNDEFPayload(
+                format: .nfcWellKnown,
+                type: typeData,
+                identifier: Data(),
+                payload: payloadData
+            )
+            ndefRecords.append(ndefRecord)
+        }
+
+        let ndefMessage = NFCNDEFMessage(records: ndefRecords)
+
+        writer.onWriteSuccess = {
+            self.notifyListeners("nfcWriteSuccess", data: ["success": true])
+        }
+
+        writer.onError = { error in
+            if let nfcError = error as? NFCReaderError {
+                if nfcError.code != .readerSessionInvalidationErrorUserCanceled {
+                    self.notifyListeners("nfcError", data: ["error": nfcError.localizedDescription])
+                }
+            }
+        }
+
+        writer.startWriting(message: ndefMessage)
+        call.resolve()
+    }
+}

package/ios/Sources/NFCPlugin/NFCReader.swift

@@ -0,0 +1,96 @@
+import Foundation
+import CoreNFC
+
+@objc public class NFCReader: NSObject, NFCNDEFReaderSessionDelegate {
+    private var readerSession: NFCNDEFReaderSession?
+
+    public var onNDEFMessageReceived: (([NFCNDEFMessage]) -> Void)?
+    public var onError: ((Error) -> Void)?
+
+    @objc public func startScanning() {
+        print("NFCReader startScanning called")
+
+        guard NFCNDEFReaderSession.readingAvailable else {
+            print("NFC scanning not supported on this device")
+            return
+        }
+        readerSession = NFCNDEFReaderSession(delegate: self, queue: nil, invalidateAfterFirstRead: true)
+        readerSession?.alertMessage = "Hold your iPhone near the NFC tag."
+        readerSession?.begin()
+    }
+
+    // NFCNDEFReaderSessionDelegate methods for reading
+    public func readerSession(_ session: NFCNDEFReaderSession, didInvalidateWithError error: Error) {
+        print("NFC reader session error: \(error.localizedDescription)")
+        onError?(error)
+    }
+
+    public func readerSession(_ session: NFCNDEFReaderSession, didDetectNDEFs messages: [NFCNDEFMessage]) {
+        onNDEFMessageReceived?(messages)
+    }
+
+    public func readerSessionDidBecomeActive(_ session: NFCNDEFReaderSession) {
+        
+    }
+
+    // Handle detection of NDEF tags (need to connect and read the NDEF message)
+    public func readerSession(_ session: NFCNDEFReaderSession, didDetect tags: [NFCNDEFTag]) {
+        if tags.count > 1 {
+            // Restart polling in 500ms
+            let retryInterval = DispatchTimeInterval.milliseconds(500)
+            session.alertMessage = "More than one tag detected. Please remove extra tags and try again."
+            DispatchQueue.global().asyncAfter(deadline: .now() + retryInterval) {
+                session.restartPolling()
+            }
+            return
+        }
+        
+        // Connect to the found tag and perform NDEF message reading
+        let tag = tags.first!
+        session.connect(to: tag) { (error: Error?) in
+            if let error = error {
+                session.alertMessage = "Unable to connect to tag."
+                session.invalidate()
+                self.onError?(error)
+                return
+            }
+            
+            tag.queryNDEFStatus { (ndefStatus: NFCNDEFStatus, capacity: Int, error: Error?) in
+                if let error = error {
+                    session.alertMessage = "Unable to query NDEF status of tag."
+                    session.invalidate()
+                    self.onError?(error)
+                    return
+                }
+                
+                if ndefStatus == .notSupported {
+                    session.alertMessage = "Tag is not NDEF compliant."
+                    session.invalidate()
+                    return
+                }
+                
+                tag.readNDEF { (message: NFCNDEFMessage?, error: Error?) in
+                    var statusMessage: String
+                    if let error = error {
+                        statusMessage = "Failed to read NDEF from tag."
+                        session.alertMessage = statusMessage
+                        session.invalidate()
+                        self.onError?(error)
+                        return
+                    }
+                    
+                    if let message = message {
+                        statusMessage = "Found 1 NDEF message."
+                        session.alertMessage = statusMessage
+                        session.invalidate()
+                        self.onNDEFMessageReceived?([message])
+                    } else {
+                        statusMessage = "No NDEF message found."
+                        session.alertMessage = statusMessage
+                        session.invalidate()
+                    }
+                }
+            }
+        }
+    }
+}

package/ios/Sources/NFCPlugin/NFCWriter.swift

@@ -0,0 +1,96 @@
+import Foundation
+import CoreNFC
+
+@objc public class NFCWriter: NSObject, NFCNDEFReaderSessionDelegate {
+    private var writerSession: NFCNDEFReaderSession?
+    private var messageToWrite: NFCNDEFMessage?
+
+    public var onWriteSuccess: (() -> Void)?
+    public var onError: ((Error) -> Void)?
+
+    @objc public func startWriting(message: NFCNDEFMessage) {
+        print("NFCWriter startWriting called")
+        self.messageToWrite = message
+
+        guard NFCNDEFReaderSession.readingAvailable else {
+            print("NFC writing not supported on this device")
+            return
+        }
+        writerSession = NFCNDEFReaderSession(delegate: self, queue: nil, invalidateAfterFirstRead: false)
+        writerSession?.alertMessage = "Hold your iPhone near the NFC tag to write."
+        writerSession?.begin()
+    }
+
+    public func readerSession(_ session: NFCNDEFReaderSession, didDetectNDEFs messages: [NFCNDEFMessage]) {
+    }
+
+    // NFCNDEFReaderSessionDelegate methods for writing
+    public func readerSession(_ session: NFCNDEFReaderSession, didInvalidateWithError error: Error) {
+        print("NFC writer session error: \(error.localizedDescription)")
+        onError?(error)
+    }
+
+    public func readerSessionDidBecomeActive(_ session: NFCNDEFReaderSession) {
+        
+    }
+
+    public func readerSession(_ session: NFCNDEFReaderSession, didDetect tags: [NFCNDEFTag]) {
+        if tags.count > 1 {
+            let retryInterval = DispatchTimeInterval.milliseconds(500)
+            session.alertMessage = "More than one tag detected. Please try again."
+            DispatchQueue.global().asyncAfter(deadline: .now() + retryInterval) {
+                session.restartPolling()
+            }
+            return
+        }
+
+        guard let tag = tags.first else { return }
+
+        session.connect(to: tag) { (error) in
+            if let error = error {
+                session.alertMessage = "Unable to connect to tag."
+                session.invalidate()
+                self.onError?(error)
+                return
+            }
+
+            tag.queryNDEFStatus { (ndefStatus, capacity, error) in
+                if let error = error {
+                    session.alertMessage = "Unable to query the NDEF status of tag."
+                    session.invalidate()
+                    self.onError?(error)
+                    return
+                }
+
+                switch ndefStatus {
+                case .notSupported:
+                    session.alertMessage = "Tag is not NDEF compliant."
+                    session.invalidate()
+                case .readOnly:
+                    session.alertMessage = "Tag is read-only."
+                    session.invalidate()
+                case .readWrite:
+                    if let message = self.messageToWrite {
+                        tag.writeNDEF(message) { (error) in
+                            if let error = error {
+                                session.alertMessage = "Failed to write NDEF message."
+                                session.invalidate()
+                                self.onError?(error)
+                                return
+                            }
+                            session.alertMessage = "NDEF message written successfully."
+                            session.invalidate()
+                            self.onWriteSuccess?()
+                        }
+                    } else {
+                        session.alertMessage = "No message to write."
+                        session.invalidate()
+                    }
+                @unknown default:
+                    session.alertMessage = "Unknown NDEF tag status."
+                    session.invalidate()
+                }
+            }
+        }
+    }
+}

package/ios/Tests/NFCPluginTests/NFCPluginTests.swift

@@ -0,0 +1,15 @@
+import XCTest
+@testable import NFCPlugin
+
+class NFCTests: XCTestCase {
+    func testEcho() {
+        // This is an example of a functional test case for a plugin.
+        // Use XCTAssert and related functions to verify your tests produce the correct results.
+
+        let implementation = NFC()
+        let value = "Hello, World!"
+        let result = implementation.echo(value)
+
+        XCTAssertEqual(value, result)
+    }
+}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@exxili/capacitor-nfc",
+  "version": "0.0.1",
+  "description": "A Capacitor plugin for reading and writing NFC NDEFtags.",
+  "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",
+    "CapacitorNfc.podspec"
+  ],
+  "author": "Exxili",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Exxili/capacitor-nfc.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Exxili/capacitor-nfc/issues"
+  },
+  "keywords": [
+    "capacitor",
+    "plugin",
+    "native"
+  ],
+  "scripts": {
+    "verify": "npm run verify:ios && npm run verify:android && npm run verify:web",
+    "verify:ios": "xcodebuild -scheme CapacitorNfc -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 NFCPlugin --output-readme README.md --output-json dist/docs.json",
+    "build": "npm run clean && tsc && rollup -c rollup.config.js && rimraf *.tgz && npm pack",
+    "clean": "rimraf ./dist",
+    "watch": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@capacitor/android": "^6.0.0",
+    "@capacitor/core": "^6.0.0",
+    "@capacitor/docgen": "^0.2.2",
+    "@capacitor/ios": "^6.0.0",
+    "@ionic/eslint-config": "^0.4.0",
+    "@ionic/prettier-config": "^4.0.0",
+    "@ionic/swiftlint-config": "^1.1.2",
+    "eslint": "^8.57.0",
+    "prettier": "^3.3.3",
+    "prettier-plugin-java": "^2.6.4",
+    "rimraf": "^3.0.2",
+    "rollup": "^2.32.0",
+    "swiftlint": "^1.0.1",
+    "typescript": "~4.1.5"
+  },
+  "peerDependencies": {
+    "@capacitor/core": "^6.0.0"
+  },
+  "prettier": "@ionic/prettier-config",
+  "swiftlint": "@ionic/swiftlint-config",
+  "eslintConfig": {
+    "extends": "@ionic/eslint-config/recommended"
+  },
+  "capacitor": {
+    "ios": {
+      "src": "ios"
+    },
+    "android": {
+      "src": "android"
+    }
+  }
+}