@capgo/capacitor-nfc 8.0.9 → 8.0.11

package/README.md

@@ -44,6 +44,8 @@ Remember to add the required platform configuration:
 
 ## Usage
 
+### Reading NDEF tags (default behavior)
+
 ```ts
 import { CapacitorNfc } from '@capgo/capacitor-nfc';
 
@@ -79,6 +81,36 @@ await listener.remove();
 await CapacitorNfc.stopScanning();
 ```
 
+### Reading raw tags (iOS) - Get UID from unformatted tags
+
+```ts
+import { CapacitorNfc } from '@capgo/capacitor-nfc';
+
+// Use 'tag' session type to read raw (non-NDEF) tags
+await CapacitorNfc.startScanning({
+  iosSessionType: 'tag', // Enable raw tag reading on iOS
+  alertMessage: 'Hold your card near the device',
+});
+
+const listener = await CapacitorNfc.addListener('nfcEvent', (event) => {
+  console.info('Tag detected:', event.type); // 'tag' or 'ndef'
+  
+  // Read the UID (identifier) - works for both NDEF and raw tags
+  if (event.tag?.id) {
+    const uid = event.tag.id.map(byte => byte.toString(16).padStart(2, '0').toUpperCase()).join(':');
+    console.info('Tag UID:', uid); // e.g., "04:A1:B2:C3:D4:E5:F6"
+  }
+  
+  // If the tag has NDEF data, it will also be available
+  if (event.tag?.ndefMessage) {
+    console.info('NDEF records:', event.tag.ndefMessage);
+  }
+});
+
+await listener.remove();
+await CapacitorNfc.stopScanning();
+```
+
 ## API
 
 <docgen-index>
@@ -290,11 +322,12 @@ addListener(eventName: 'nfcStateChange', listenerFunc: (event: NfcStateChangeEve
 
 Options controlling the behaviour of {@link CapacitorNfcPlugin.startScanning}.
 
-| Prop                           | Type                 | Description                                                                                                                    |
-| ------------------------------ | -------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
-| **`invalidateAfterFirstRead`** | <code>boolean</code> | iOS-only: closes the NFC session automatically after the first successful tag read. Defaults to `true`.                        |
-| **`alertMessage`**             | <code>string</code>  | iOS-only: custom message displayed in the NFC system sheet while scanning.                                                     |
-| **`androidReaderModeFlags`**   | <code>number</code>  | Android-only: raw flags passed to `NfcAdapter.enableReaderMode`. Defaults to enabling all tag types with skipping NDEF checks. |
+| Prop                           | Type                         | Description                                                                                                                                                                                                                                                                                                                     |
+| ------------------------------ | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`invalidateAfterFirstRead`** | <code>boolean</code>         | iOS-only: closes the NFC session automatically after the first successful tag read. Defaults to `true`.                                                                                                                                                                                                                         |
+| **`alertMessage`**             | <code>string</code>          | iOS-only: custom message displayed in the NFC system sheet while scanning.                                                                                                                                                                                                                                                      |
+| **`iosSessionType`**           | <code>'tag' \| 'ndef'</code> | iOS-only: session type to use for NFC scanning. - `'ndef'`: Uses NFCNDEFReaderSession (default). Only detects NDEF-formatted tags. - `'tag'`: Uses NFCTagReaderSession. Detects both NDEF and non-NDEF tags (e.g., raw MIFARE tags). Allows reading UID from unformatted tags. Defaults to `'ndef'` for backward compatibility. |
+| **`androidReaderModeFlags`**   | <code>number</code>          | Android-only: raw flags passed to `NfcAdapter.enableReaderMode`. Defaults to enabling all tag types with skipping NDEF checks.                                                                                                                                                                                                  |
 
 
 #### WriteTagOptions

package/dist/docs.json

@@ -228,6 +228,13 @@
           "complexTypes": [],
           "type": "string | undefined"
         },
+        {
+          "name": "iosSessionType",
+          "tags": [],
+          "docs": "iOS-only: session type to use for NFC scanning.\n- `'ndef'`: Uses NFCNDEFReaderSession (default). Only detects NDEF-formatted tags.\n- `'tag'`: Uses NFCTagReaderSession. Detects both NDEF and non-NDEF tags (e.g., raw MIFARE tags).\n           Allows reading UID from unformatted tags.\nDefaults to `'ndef'` for backward compatibility.",
+          "complexTypes": [],
+          "type": "'tag' | 'ndef' | undefined"
+        },
         {
           "name": "androidReaderModeFlags",
           "tags": [],

package/dist/esm/definitions.d.ts

@@ -97,6 +97,14 @@ export interface StartScanningOptions {
      * iOS-only: custom message displayed in the NFC system sheet while scanning.
      */
     alertMessage?: string;
+    /**
+     * iOS-only: session type to use for NFC scanning.
+     * - `'ndef'`: Uses NFCNDEFReaderSession (default). Only detects NDEF-formatted tags.
+     * - `'tag'`: Uses NFCTagReaderSession. Detects both NDEF and non-NDEF tags (e.g., raw MIFARE tags).
+     *            Allows reading UID from unformatted tags.
+     * Defaults to `'ndef'` for backward compatibility.
+     */
+    iosSessionType?: 'ndef' | 'tag';
     /**
      * Android-only: raw flags passed to `NfcAdapter.enableReaderMode`.
      * Defaults to enabling all tag types with skipping NDEF checks.

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\n/**\n * Possible NFC adapter states returned by {@link CapacitorNfcPlugin.getStatus}.\n *\n * Matches the constants provided by the original PhoneGap NFC plugin for\n * compatibility with existing applications.\n */\nexport type NfcStatus = 'NFC_OK' | 'NO_NFC' | 'NFC_DISABLED' | 'NDEF_PUSH_DISABLED';\n\n/**\n * Event type describing the kind of NFC discovery that happened.\n *\n * - `tag`: A generic NFC tag (no NDEF payload).\n * - `ndef`: A tag exposing an NDEF payload.\n * - `ndef-mime`: An NDEF tag that matched one of the MIME type filters.\n * - `ndef-formatable`: A tag that can be formatted to NDEF.\n */\nexport type NfcEventType = 'tag' | 'ndef' | 'ndef-mime' | 'ndef-formatable';\n\n/**\n * JSON structure representing a single NDEF record.\n *\n * Mirrors the data format returned by the legacy Cordova implementation and\n * uses integer arrays instead of strings to preserve the original payload\n * bytes.\n */\nexport interface NdefRecord {\n  /**\n   * Type Name Format identifier.\n   */\n  tnf: number;\n  /**\n   * Type field expressed as an array of byte values.\n   */\n  type: number[];\n  /**\n   * Record identifier expressed as an array of byte values.\n   */\n  id: number[];\n  /**\n   * Raw payload expressed as an array of byte values.\n   */\n  payload: number[];\n}\n\n/**\n * Representation of the full tag information returned by the native layers.\n *\n * Supports standard NFC Forum tags as well as MIFARE Ultralight cards (including\n * EV1 and NTAG variants). NDEF data is automatically extracted from MIFARE Ultralight\n * tags when available.\n */\nexport interface NfcTag {\n  /**\n   * Raw identifier bytes for the tag.\n   */\n  id?: number[];\n  /**\n   * List of Android tech strings (e.g. `android.nfc.tech.Ndef`).\n   */\n  techTypes?: string[];\n  /**\n   * Human readable tag type when available (e.g. `NFC Forum Type 2`, `MIFARE Ultralight`).\n   */\n  type?: string | null;\n  /**\n   * Maximum writable size in bytes for tags that expose NDEF information.\n   */\n  maxSize?: number | null;\n  /**\n   * Indicates whether the tag can be written to.\n   */\n  isWritable?: boolean | null;\n  /**\n   * Indicates whether the tag can be permanently locked.\n   */\n  canMakeReadOnly?: boolean | null;\n  /**\n   * Array of NDEF records discovered on the tag.\n   */\n  ndefMessage?: NdefRecord[] | null;\n}\n\n/**\n * Generic NFC discovery event dispatched by the plugin.\n */\nexport interface NfcEvent {\n  type: NfcEventType;\n  tag: NfcTag;\n}\n\n/**\n * Options controlling the behaviour of {@link CapacitorNfcPlugin.startScanning}.\n */\nexport interface StartScanningOptions {\n  /**\n   * iOS-only: closes the NFC session automatically after the first successful tag read.\n   * Defaults to `true`.\n   */\n  invalidateAfterFirstRead?: boolean;\n  /**\n   * iOS-only: custom message displayed in the NFC system sheet while scanning.\n   */\n  alertMessage?: string;\n  /**\n   * Android-only: raw flags passed to `NfcAdapter.enableReaderMode`.\n   * Defaults to enabling all tag types with skipping NDEF checks.\n   */\n  androidReaderModeFlags?: number;\n}\n\n/**\n * Options used when writing an NDEF message on the current tag.\n */\nexport interface WriteTagOptions {\n  /**\n   * Array of records that compose the NDEF message to be written.\n   */\n  records: NdefRecord[];\n  /**\n   * When `true`, the plugin attempts to format NDEF-formattable tags before writing.\n   * Defaults to `true`.\n   */\n  allowFormat?: boolean;\n}\n\n/**\n * Options used when sharing an NDEF message with another device using Android Beam / P2P mode.\n */\nexport interface ShareTagOptions {\n  records: NdefRecord[];\n}\n\n/**\n * Event emitted whenever the NFC adapter availability changes.\n */\nexport interface NfcStateChangeEvent {\n  status: NfcStatus;\n  enabled: boolean;\n}\n\n/**\n * Public API surface for the Capacitor NFC plugin.\n *\n * The interface intentionally mirrors the behaviour of the reference PhoneGap\n * implementation to ease migration while embracing idiomatic Capacitor APIs.\n */\nexport interface CapacitorNfcPlugin {\n  /**\n   * Starts listening for NFC tags.\n   */\n  startScanning(options?: StartScanningOptions): Promise<void>;\n  /**\n   * Stops the ongoing NFC scanning session.\n   */\n  stopScanning(): Promise<void>;\n  /**\n   * Writes the provided NDEF records to the last discovered tag.\n   */\n  write(options: WriteTagOptions): Promise<void>;\n  /**\n   * Attempts to erase the last discovered tag by writing an empty NDEF message.\n   */\n  erase(): Promise<void>;\n  /**\n   * Attempts to make the last discovered tag read-only.\n   */\n  makeReadOnly(): Promise<void>;\n  /**\n   * Shares an NDEF message with another device via peer-to-peer (Android only).\n   */\n  share(options: ShareTagOptions): Promise<void>;\n  /**\n   * Stops sharing previously provided NDEF message (Android only).\n   */\n  unshare(): Promise<void>;\n  /**\n   * Returns the current NFC adapter status.\n   */\n  getStatus(): Promise<{ status: NfcStatus }>;\n  /**\n   * Opens the system settings page where the user can enable NFC.\n   */\n  showSettings(): Promise<void>;\n  /**\n   * Returns the version string baked into the native plugin.\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n\n  addListener(eventName: 'nfcEvent', listenerFunc: (event: NfcEvent) => void): Promise<PluginListenerHandle>;\n  addListener(\n    eventName: 'tagDiscovered' | 'ndefDiscovered' | 'ndefMimeDiscovered' | 'ndefFormatableDiscovered',\n    listenerFunc: (event: NfcEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  addListener(\n    eventName: 'nfcStateChange',\n    listenerFunc: (event: NfcStateChangeEvent) => void,\n  ): Promise<PluginListenerHandle>;\n}\n\nexport type { PluginListenerHandle } from '@capacitor/core';\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { PluginListenerHandle } from '@capacitor/core';\n\n/**\n * Possible NFC adapter states returned by {@link CapacitorNfcPlugin.getStatus}.\n *\n * Matches the constants provided by the original PhoneGap NFC plugin for\n * compatibility with existing applications.\n */\nexport type NfcStatus = 'NFC_OK' | 'NO_NFC' | 'NFC_DISABLED' | 'NDEF_PUSH_DISABLED';\n\n/**\n * Event type describing the kind of NFC discovery that happened.\n *\n * - `tag`: A generic NFC tag (no NDEF payload).\n * - `ndef`: A tag exposing an NDEF payload.\n * - `ndef-mime`: An NDEF tag that matched one of the MIME type filters.\n * - `ndef-formatable`: A tag that can be formatted to NDEF.\n */\nexport type NfcEventType = 'tag' | 'ndef' | 'ndef-mime' | 'ndef-formatable';\n\n/**\n * JSON structure representing a single NDEF record.\n *\n * Mirrors the data format returned by the legacy Cordova implementation and\n * uses integer arrays instead of strings to preserve the original payload\n * bytes.\n */\nexport interface NdefRecord {\n  /**\n   * Type Name Format identifier.\n   */\n  tnf: number;\n  /**\n   * Type field expressed as an array of byte values.\n   */\n  type: number[];\n  /**\n   * Record identifier expressed as an array of byte values.\n   */\n  id: number[];\n  /**\n   * Raw payload expressed as an array of byte values.\n   */\n  payload: number[];\n}\n\n/**\n * Representation of the full tag information returned by the native layers.\n *\n * Supports standard NFC Forum tags as well as MIFARE Ultralight cards (including\n * EV1 and NTAG variants). NDEF data is automatically extracted from MIFARE Ultralight\n * tags when available.\n */\nexport interface NfcTag {\n  /**\n   * Raw identifier bytes for the tag.\n   */\n  id?: number[];\n  /**\n   * List of Android tech strings (e.g. `android.nfc.tech.Ndef`).\n   */\n  techTypes?: string[];\n  /**\n   * Human readable tag type when available (e.g. `NFC Forum Type 2`, `MIFARE Ultralight`).\n   */\n  type?: string | null;\n  /**\n   * Maximum writable size in bytes for tags that expose NDEF information.\n   */\n  maxSize?: number | null;\n  /**\n   * Indicates whether the tag can be written to.\n   */\n  isWritable?: boolean | null;\n  /**\n   * Indicates whether the tag can be permanently locked.\n   */\n  canMakeReadOnly?: boolean | null;\n  /**\n   * Array of NDEF records discovered on the tag.\n   */\n  ndefMessage?: NdefRecord[] | null;\n}\n\n/**\n * Generic NFC discovery event dispatched by the plugin.\n */\nexport interface NfcEvent {\n  type: NfcEventType;\n  tag: NfcTag;\n}\n\n/**\n * Options controlling the behaviour of {@link CapacitorNfcPlugin.startScanning}.\n */\nexport interface StartScanningOptions {\n  /**\n   * iOS-only: closes the NFC session automatically after the first successful tag read.\n   * Defaults to `true`.\n   */\n  invalidateAfterFirstRead?: boolean;\n  /**\n   * iOS-only: custom message displayed in the NFC system sheet while scanning.\n   */\n  alertMessage?: string;\n  /**\n   * iOS-only: session type to use for NFC scanning.\n   * - `'ndef'`: Uses NFCNDEFReaderSession (default). Only detects NDEF-formatted tags.\n   * - `'tag'`: Uses NFCTagReaderSession. Detects both NDEF and non-NDEF tags (e.g., raw MIFARE tags).\n   *            Allows reading UID from unformatted tags.\n   * Defaults to `'ndef'` for backward compatibility.\n   */\n  iosSessionType?: 'ndef' | 'tag';\n  /**\n   * Android-only: raw flags passed to `NfcAdapter.enableReaderMode`.\n   * Defaults to enabling all tag types with skipping NDEF checks.\n   */\n  androidReaderModeFlags?: number;\n}\n\n/**\n * Options used when writing an NDEF message on the current tag.\n */\nexport interface WriteTagOptions {\n  /**\n   * Array of records that compose the NDEF message to be written.\n   */\n  records: NdefRecord[];\n  /**\n   * When `true`, the plugin attempts to format NDEF-formattable tags before writing.\n   * Defaults to `true`.\n   */\n  allowFormat?: boolean;\n}\n\n/**\n * Options used when sharing an NDEF message with another device using Android Beam / P2P mode.\n */\nexport interface ShareTagOptions {\n  records: NdefRecord[];\n}\n\n/**\n * Event emitted whenever the NFC adapter availability changes.\n */\nexport interface NfcStateChangeEvent {\n  status: NfcStatus;\n  enabled: boolean;\n}\n\n/**\n * Public API surface for the Capacitor NFC plugin.\n *\n * The interface intentionally mirrors the behaviour of the reference PhoneGap\n * implementation to ease migration while embracing idiomatic Capacitor APIs.\n */\nexport interface CapacitorNfcPlugin {\n  /**\n   * Starts listening for NFC tags.\n   */\n  startScanning(options?: StartScanningOptions): Promise<void>;\n  /**\n   * Stops the ongoing NFC scanning session.\n   */\n  stopScanning(): Promise<void>;\n  /**\n   * Writes the provided NDEF records to the last discovered tag.\n   */\n  write(options: WriteTagOptions): Promise<void>;\n  /**\n   * Attempts to erase the last discovered tag by writing an empty NDEF message.\n   */\n  erase(): Promise<void>;\n  /**\n   * Attempts to make the last discovered tag read-only.\n   */\n  makeReadOnly(): Promise<void>;\n  /**\n   * Shares an NDEF message with another device via peer-to-peer (Android only).\n   */\n  share(options: ShareTagOptions): Promise<void>;\n  /**\n   * Stops sharing previously provided NDEF message (Android only).\n   */\n  unshare(): Promise<void>;\n  /**\n   * Returns the current NFC adapter status.\n   */\n  getStatus(): Promise<{ status: NfcStatus }>;\n  /**\n   * Opens the system settings page where the user can enable NFC.\n   */\n  showSettings(): Promise<void>;\n  /**\n   * Returns the version string baked into the native plugin.\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n\n  addListener(eventName: 'nfcEvent', listenerFunc: (event: NfcEvent) => void): Promise<PluginListenerHandle>;\n  addListener(\n    eventName: 'tagDiscovered' | 'ndefDiscovered' | 'ndefMimeDiscovered' | 'ndefFormatableDiscovered',\n    listenerFunc: (event: NfcEvent) => void,\n  ): Promise<PluginListenerHandle>;\n  addListener(\n    eventName: 'nfcStateChange',\n    listenerFunc: (event: NfcStateChangeEvent) => void,\n  ): Promise<PluginListenerHandle>;\n}\n\nexport type { PluginListenerHandle } from '@capacitor/core';\n"]}

package/ios/Sources/NfcPlugin/NfcPlugin.swift

@@ -4,7 +4,7 @@ import UIKit
 
 @objc(NfcPlugin)
 public class NfcPlugin: CAPPlugin, CAPBridgedPlugin {
-    private let pluginVersion: String = "8.0.9"
+    private let pluginVersion: String = "8.0.11"
 
     public let identifier = "NfcPlugin"
     public let jsName = "CapacitorNfc"
@@ -21,10 +21,12 @@ public class NfcPlugin: CAPPlugin, CAPBridgedPlugin {
         CAPPluginMethod(name: "getPluginVersion", returnType: CAPPluginReturnPromise)
     ]
 
-    private var readerSession: NFCNDEFReaderSession?
+    private var ndefReaderSession: NFCNDEFReaderSession?
+    private var tagReaderSession: NFCTagReaderSession?
     private let sessionQueue = DispatchQueue(label: "app.capgo.nfc.session")
     private var currentTag: NFCNDEFTag?
     private var invalidateAfterFirstRead = true
+    private var sessionType: String = "ndef"
 
     @objc public func startScanning(_ call: CAPPluginCall) {
         #if targetEnvironment(simulator)
@@ -38,14 +40,38 @@ public class NfcPlugin: CAPPlugin, CAPBridgedPlugin {
 
         invalidateAfterFirstRead = call.getBool("invalidateAfterFirstRead", true)
         let alertMessage = call.getString("alertMessage")
+        sessionType = call.getString("iosSessionType", "ndef")
 
         DispatchQueue.main.async {
-            self.readerSession?.invalidate()
-            self.readerSession = NFCNDEFReaderSession(delegate: self, queue: self.sessionQueue, invalidateAfterFirstRead: self.invalidateAfterFirstRead)
-            if let alertMessage, !alertMessage.isEmpty {
-                self.readerSession?.alertMessage = alertMessage
+            // Invalidate any existing sessions
+            self.ndefReaderSession?.invalidate()
+            self.ndefReaderSession = nil
+            self.tagReaderSession?.invalidate()
+            self.tagReaderSession = nil
+
+            if self.sessionType == "tag" {
+                // Use NFCTagReaderSession for raw tag support
+                self.tagReaderSession = NFCTagReaderSession(
+                    pollingOption: [.iso14443, .iso15693, .iso18092],
+                    delegate: self,
+                    queue: self.sessionQueue
+                )
+                if let alertMessage, !alertMessage.isEmpty {
+                    self.tagReaderSession?.alertMessage = alertMessage
+                }
+                self.tagReaderSession?.begin()
+            } else {
+                // Use NFCNDEFReaderSession (default behavior)
+                self.ndefReaderSession = NFCNDEFReaderSession(
+                    delegate: self,
+                    queue: self.sessionQueue,
+                    invalidateAfterFirstRead: self.invalidateAfterFirstRead
+                )
+                if let alertMessage, !alertMessage.isEmpty {
+                    self.ndefReaderSession?.alertMessage = alertMessage
+                }
+                self.ndefReaderSession?.begin()
             }
-            self.readerSession?.begin()
         }
 
         call.resolve()
@@ -54,15 +80,17 @@ public class NfcPlugin: CAPPlugin, CAPBridgedPlugin {
 
     @objc public func stopScanning(_ call: CAPPluginCall) {
         DispatchQueue.main.async {
-            self.readerSession?.invalidate()
-            self.readerSession = nil
+            self.ndefReaderSession?.invalidate()
+            self.ndefReaderSession = nil
+            self.tagReaderSession?.invalidate()
+            self.tagReaderSession = nil
             self.currentTag = nil
         }
         call.resolve()
     }
 
     @objc public func write(_ call: CAPPluginCall) {
-        guard let session = readerSession, let tag = currentTag else {
+        guard currentTag != nil else {
             call.reject("No active NFC session or tag. Call startScanning and present a tag before writing.")
             return
         }
@@ -74,21 +102,40 @@ public class NfcPlugin: CAPPlugin, CAPBridgedPlugin {
 
         do {
             let message = try buildMessage(from: rawRecords)
-            performWrite(message: message, on: tag, session: session, call: call)
+            performWriteToCurrentTag(message: message, call: call)
         } catch {
             call.reject("Invalid NDEF records payload.", nil, error)
         }
     }
 
     @objc public func erase(_ call: CAPPluginCall) {
-        guard let session = readerSession, let tag = currentTag else {
+        guard currentTag != nil else {
             call.reject("No active NFC session or tag. Call startScanning and present a tag before erasing.")
             return
         }
 
         let emptyRecord = NFCNDEFPayload(format: .empty, type: Data(), identifier: Data(), payload: Data())
         let message = NFCNDEFMessage(records: [emptyRecord])
-        performWrite(message: message, on: tag, session: session, call: call)
+        performWriteToCurrentTag(message: message, call: call)
+    }
+
+    private func performWriteToCurrentTag(message: NFCNDEFMessage, call: CAPPluginCall) {
+        guard let tag = currentTag else {
+            call.reject("No active NFC session or tag.")
+            return
+        }
+        
+        if let ndefSession = ndefReaderSession {
+            // For NDEF session, we need to connect to the tag first
+            performWrite(message: message, on: tag, session: ndefSession, call: call)
+        } else if tagReaderSession != nil {
+            // For Tag session, tag remains connected from discovery
+            // Note: If the tag is removed and re-presented, the session will detect it as a new tag
+            // and performWriteToTag may fail. Users should keep the tag in place after detection.
+            performWriteToTag(message: message, on: tag, call: call)
+        } else {
+            call.reject("No active NFC session.")
+        }
     }
 
     @objc public func makeReadOnly(_ call: CAPPluginCall) {
@@ -142,44 +189,48 @@ public class NfcPlugin: CAPPlugin, CAPBridgedPlugin {
                 return
             }
 
-            tag.queryNDEFStatus { status, capacity, statusError in
-                if let statusError {
-                    DispatchQueue.main.async {
-                        call.reject("Failed to query tag status.", nil, statusError)
-                    }
-                    return
+            self.performWriteToTag(message: message, on: tag, call: call)
+        }
+    }
+
+    private func performWriteToTag(message: NFCNDEFMessage, on tag: NFCNDEFTag, call: CAPPluginCall) {
+        tag.queryNDEFStatus { status, capacity, statusError in
+            if let statusError {
+                DispatchQueue.main.async {
+                    call.reject("Failed to query tag status.", nil, statusError)
                 }
+                return
+            }
 
-                switch status {
-                case .readWrite:
-                    if capacity < message.length {
-                        DispatchQueue.main.async {
-                            call.reject("Tag capacity is insufficient for the provided message.")
-                        }
-                        return
-                    }
-                    tag.writeNDEF(message) { writeError in
-                        DispatchQueue.main.async {
-                            if let writeError {
-                                call.reject("Failed to write NDEF message.", nil, writeError)
-                            } else {
-                                call.resolve()
-                            }
-                        }
-                    }
-                case .readOnly:
-                    DispatchQueue.main.async {
-                        call.reject("Tag is read only.")
-                    }
-                case .notSupported:
+            switch status {
+            case .readWrite:
+                if capacity < message.length {
                     DispatchQueue.main.async {
-                        call.reject("Tag does not support NDEF.")
+                        call.reject("Tag capacity is insufficient for the provided message.")
                     }
-                @unknown default:
+                    return
+                }
+                tag.writeNDEF(message) { writeError in
                     DispatchQueue.main.async {
-                        call.reject("Unknown tag status.")
+                        if let writeError {
+                            call.reject("Failed to write NDEF message.", nil, writeError)
+                        } else {
+                            call.resolve()
+                        }
                     }
                 }
+            case .readOnly:
+                DispatchQueue.main.async {
+                    call.reject("Tag is read only.")
+                }
+            case .notSupported:
+                DispatchQueue.main.async {
+                    call.reject("Tag does not support NDEF.")
+                }
+            @unknown default:
+                DispatchQueue.main.async {
+                    call.reject("Unknown tag status.")
+                }
             }
         }
     }
@@ -343,7 +394,7 @@ extension NfcPlugin: NFCNDEFReaderSessionDelegate {
                 self.notifyListeners("nfcStateChange", data: payload, retainUntilConsumed: true)
             }
         }
-        readerSession = nil
+        ndefReaderSession = nil
     }
 
     public func readerSession(_ session: NFCNDEFReaderSession, didDetect tags: [NFCNDEFTag]) {
@@ -402,6 +453,140 @@ extension NfcPlugin: NFCNDEFReaderSessionDelegate {
     }
 }
 
+// MARK: - NFCTagReaderSessionDelegate
+extension NfcPlugin: NFCTagReaderSessionDelegate {
+    public func tagReaderSessionDidBecomeActive(_ session: NFCTagReaderSession) {
+        // Session became active, ready to detect tags
+    }
+
+    public func tagReaderSession(_ session: NFCTagReaderSession, didInvalidateWithError error: Error) {
+        currentTag = nil
+        let nfcError = error as NSError
+        
+        // Don't emit state change for normal session completion (user canceled)
+        // Also check for successful read completion
+        if nfcError.code != NFCReaderError.readerSessionInvalidationErrorUserCanceled.rawValue {
+            DispatchQueue.main.async {
+                let payload: [String: Any] = [
+                    "status": NFCNDEFReaderSession.readingAvailable ? "NFC_OK" : "NO_NFC",
+                    "enabled": NFCNDEFReaderSession.readingAvailable
+                ]
+                self.notifyListeners("nfcStateChange", data: payload, retainUntilConsumed: true)
+            }
+        }
+        tagReaderSession = nil
+    }
+
+    public func tagReaderSession(_ session: NFCTagReaderSession, didDetect tags: [NFCTag]) {
+        // Handle multiple tags case - CoreNFC recommends invalidating with a message
+        if tags.count > 1 {
+            session.invalidate(errorMessage: "More than one tag detected. Please present only one tag.")
+            return
+        }
+        
+        guard let firstTag = tags.first else {
+            return
+        }
+
+        session.connect(to: firstTag) { [weak self] error in
+            guard let self else {
+                return
+            }
+
+            if let error {
+                session.invalidate(errorMessage: "Failed to connect to the tag: \(error.localizedDescription)")
+                return
+            }
+
+            // Handle different tag types
+            switch firstTag {
+            case .miFare(let mifareTag):
+                self.processTag(mifareTag, session: session)
+            case .iso7816(let iso7816Tag):
+                self.processTag(iso7816Tag, session: session)
+            case .iso15693(let iso15693Tag):
+                self.processTag(iso15693Tag, session: session)
+            case .feliCa(let feliCaTag):
+                self.processTag(feliCaTag, session: session)
+            @unknown default:
+                session.invalidate(errorMessage: "Unsupported tag type")
+            }
+        }
+    }
+
+    private func processTag(_ tag: NFCNDEFTag, session: NFCTagReaderSession) {
+        // Try to read NDEF if available, otherwise emit tag with UID only
+        tag.queryNDEFStatus { [weak self] status, capacity, error in
+            guard let self else {
+                return
+            }
+
+            if error == nil && status != .notSupported {
+                // Tag supports NDEF, try to read it
+                tag.readNDEF { [weak self] message, _ in
+                    guard let self else {
+                        return
+                    }
+
+                    if message == nil {
+                        // NDEF read failed, still emit tag with UID
+                        self.emitTagEvent(tag: tag, message: nil, session: session)
+                    } else {
+                        // Successfully read NDEF
+                        self.currentTag = tag
+                        let event = self.buildEvent(tag: tag, status: status, capacity: capacity, message: message)
+                        self.notify(event: event)
+                        if self.invalidateAfterFirstRead {
+                            session.invalidate()
+                        }
+                    }
+                }
+            } else {
+                // Tag doesn't support NDEF or query failed - just emit UID
+                self.emitTagEvent(tag: tag, message: nil, session: session)
+            }
+        }
+    }
+
+    private func emitTagEvent(tag: NFCNDEFTag, message: NFCNDEFMessage?, session: NFCTagReaderSession) {
+        // Save the current tag for writing
+        currentTag = tag
+
+        var tagInfo: [String: Any] = [:]
+        
+        // Extract and add the tag ID (UID)
+        if let identifierData = extractIdentifier(from: tag) {
+            tagInfo["id"] = array(from: identifierData)
+        }
+        
+        tagInfo["techTypes"] = detectTechTypes(for: tag)
+        tagInfo["type"] = translateType(for: tag)
+
+        if let message {
+            tagInfo["isWritable"] = true
+            tagInfo["ndefMessage"] = message.records.map { record in
+                [
+                    "tnf": NSNumber(value: record.typeNameFormat.rawValue),
+                    "type": array(from: record.type),
+                    "id": array(from: record.identifier),
+                    "payload": array(from: record.payload)
+                ].compactMapValues { $0 }
+            }
+        }
+
+        let event: [String: Any] = [
+            "type": message != nil ? "ndef" : "tag",
+            "tag": tagInfo
+        ]
+        
+        notify(event: event)
+        
+        if invalidateAfterFirstRead {
+            session.invalidate()
+        }
+    }
+}
+
 enum NfcPluginError: Error {
     case invalidPayload
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capgo/capacitor-nfc",
-  "version": "8.0.9",
+  "version": "8.0.11",
   "description": "Native NFC tag discovery, reading and writing for Capacitor apps on iOS and Android.",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",
@@ -47,7 +47,8 @@
     "build": "npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs",
     "clean": "rimraf ./dist",
     "watch": "tsc --watch",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "check:wiring": "node scripts/check-capacitor-plugin-wiring.mjs"
   },
   "devDependencies": {
     "@capacitor/android": "^8.0.0",