community-cordova-plugin-nfc 1.5.4 → 1.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "community-cordova-plugin-nfc",
-  "version": "1.5.4",
+  "version": "1.6.0",
   "description": "Community Cordova NFC Plugin - Read and write NDEF messages, advanced tag analysis, raw memory access",
   "main": "./types/index.d.ts",
   "types": "./types/index.d.ts",

package/plugin.xml

@@ -7,7 +7,7 @@
     xmlns="http://apache.org/cordova/ns/plugins/1.0"
     xmlns:android="http://schemas.android.com/apk/res/android"
     id="community-cordova-plugin-nfc"
-    version="1.5.4">
+    version="1.6.0">
 
     <name>NFC</name>
     <description>Community Cordova NFC Plugin - Read and write NDEF messages, advanced tag analysis, raw memory access</description>
@@ -18,7 +18,7 @@
 
     <platform name="android">
         <js-module src="www/phonegap-nfc.js" name="NFC">
-            <runs />
+            <clobbers target="NfcPlugin" />
         </js-module>
 
         <config-file target="res/xml/config.xml" parent="/*">
@@ -42,7 +42,7 @@
 
     <platform name="wp8">
         <js-module src="www/phonegap-nfc.js" name="NFC">
-            <runs />
+            <clobbers target="NfcPlugin" />
         </js-module>
 
         <config-file target="config.xml" parent="/*">
@@ -63,7 +63,7 @@
     <!-- windows -->
     <platform name="windows">
         <js-module src="www/phonegap-nfc.js" name="NFC">
-            <runs />
+            <clobbers target="NfcPlugin" />
         </js-module>
 
         <config-file target="config.xml" parent="/*">
@@ -92,7 +92,7 @@
 
     <platform name="blackberry10">
         <js-module src="www/phonegap-nfc.js" name="NFC">
-            <runs />
+            <clobbers target="NfcPlugin" />
         </js-module>
         <!-- override defaults for BB10 -->
         <js-module src="www/phonegap-nfc-blackberry.js" name="NFCBB10">
@@ -110,7 +110,7 @@
 
     <platform name="ios">
         <js-module src="www/phonegap-nfc.js" name="NFC">
-            <runs />
+            <clobbers target="NfcPlugin" />
         </js-module>
 
         <config-file parent="/*" target="config.xml">
@@ -120,16 +120,15 @@
         </config-file>
 
         <!-- https://developer.apple.com/documentation/bundleresources/entitlements/com_apple_developer_nfc_readersession_formats?language=objc -->
+        <!-- Note: NDEF is deprecated/disallowed in iOS SDK 26.1+ (iOS 18+). Use TAG only. -->
         <config-file parent="com.apple.developer.nfc.readersession.formats" platform="ios" target="*-Debug.plist">
             <array>
-                <string>NDEF</string>
-                <string>TAG</string>  
+                <string>TAG</string>
             </array>
         </config-file>
         <config-file parent="com.apple.developer.nfc.readersession.formats" platform="ios" target="*-Release.plist">
             <array>
-                <string>NDEF</string>
-                <string>TAG</string>  
+                <string>TAG</string>
             </array>
         </config-file>
         

package/types/index.d.ts

@@ -206,6 +206,28 @@ export interface INfcPlugin {
         onError?: (error: string) => void
     ): void;
 
+    /**
+     * Register for tag discovered events (non-NDEF tags and NDEF tags)
+     * @param callback - Called when tag is detected
+     * @param onSuccess - Called on successful registration
+     * @param onError - Called on error
+     */
+    addTagDiscoveredListener(
+        callback: (event: INfcEvent) => void,
+        onSuccess?: () => void,
+        onError?: (error: string) => void
+    ): void;
+
+    /**
+     * Remove tag discovered listener
+     * @param onSuccess - Called on success
+     * @param onError - Called on error
+     */
+    removeTagDiscoveredListener(
+        onSuccess?: () => void,
+        onError?: (error: string) => void
+    ): void;
+
     // ========== NFC Status ==========
 
     /**
@@ -292,6 +314,16 @@ export interface INfcPlugin {
 // ============================================
 
 export interface INdefUtil {
+    /**
+     * Create a generic NDEF record
+     * @param tnf - Type Name Format (0-7)
+     * @param type - Record type as byte array or string
+     * @param id - Record ID as byte array or string
+     * @param payload - Payload as byte array or string
+     * @returns NDEF record
+     */
+    record(tnf: number, type: number[] | string, id: number[] | string, payload: number[] | string): INdefRecord;
+
     /**
      * Create a text record
      * @param text - Text content
@@ -407,23 +439,30 @@ export interface ITnf {
     TNF_RESERVED: 7;
 }
 
+// ============================================
+// Combined Plugin Interface (following SecurityPlugin pattern)
+// ============================================
+
+export interface NfcManager extends INfcPlugin {
+    /** NDEF helper utilities */
+    NdefPlugin: INdefUtil;
+    /** General utilities */
+    NfcUtil: IUtil;
+    /** Fire NFC tag event */
+    fireNfcTagEvent: (eventType: string, tagAsJson: string) => void;
+}
+
 // ============================================
 // Global Declarations
 // ============================================
 
 declare global {
     interface Window {
-        nfc: INfcPlugin;
-        ndef: INdefUtil;
-        util: IUtil;
+        NfcPlugin: NfcManager;
     }
 
-    /** NFC Plugin instance */
-    var nfc: INfcPlugin;
-    /** NDEF helper utilities */
-    var ndef: INdefUtil;
-    /** General utilities */
-    var util: IUtil;
+    /** NFC Plugin instance (following SecurityPlugin pattern) */
+    var NfcPlugin: NfcManager;
 }
 
-export default INfcPlugin;
+export default NfcManager;

package/www/nfc-plugin.js

@@ -0,0 +1,9 @@
+/*
+ * Community Cordova NFC Plugin - NfcPlugin wrapper
+ * Licensed under MIT License
+ */
+
+// Import from main phonegap-nfc.js (which sets window.nfc)
+var nfc = require('./phonegap-nfc').nfc;
+
+module.exports = nfc;

package/www/phonegap-nfc.js

@@ -1123,19 +1123,12 @@ nfc.bytesToString = util.bytesToString;
 nfc.stringToBytes = util.stringToBytes;
 nfc.bytesToHexString = util.bytesToHexString;
 
-// kludge some global variables for plugman js-module support
-// eventually these should be replaced and referenced via the module
-window.nfc = nfc;
-window.ndef = ndef;
-window.util = util;
-window.fireNfcTagEvent = fireNfcTagEvent;
-
-// This channel receives nfcEvent data from native code 
+// This channel receives nfcEvent data from native code
 // and fires JavaScript events.
 require('cordova/channel').onCordovaReady.subscribe(function() {
   require('cordova/exec')(success, null, 'NfcPlugin', 'channel', []);
   function success(message) {
-    if (!message.type) { 
+    if (!message.type) {
         console.log(message);
     } else {
         console.log("Received NFC data, firing '" + message.type + "' event");
@@ -1146,3 +1139,13 @@ require('cordova/channel').onCordovaReady.subscribe(function() {
     }
   }
 });
+
+// Export using same convention as SecurityPlugin
+// NfcPlugin is the main export (clobbered via plugin.xml)
+// NdefPlugin and NfcUtil are properties on the export
+var NfcPluginExport = nfc;
+NfcPluginExport.NdefPlugin = ndef;
+NfcPluginExport.NfcUtil = util;
+NfcPluginExport.fireNfcTagEvent = fireNfcTagEvent;
+
+module.exports = NfcPluginExport;