@annadata/capacitor-mqtt-quic 0.1.2 → 0.1.3

package/android/build.gradle

@@ -22,6 +22,7 @@ apply plugin: 'org.jetbrains.kotlin.android'
 android {
     namespace "ai.annadata.mqttquic"
     compileSdk project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 35
+    ndkVersion "26.1.10909125"
     defaultConfig {
         minSdk project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 23
         targetSdk project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 35
@@ -66,7 +67,7 @@ repositories {
 
 dependencies {
     implementation fileTree(dir: 'libs', include: ['*.jar'])
-    implementation project(':capacitor-android')
+    compileOnly 'com.getcapacitor:core:6.0.0'
     implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8:$kotlin_version"
     implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3'
     testImplementation "junit:junit:$junitVersion"

package/android/src/main/kotlin/ai/annadata/mqttquic/mqtt/MQTT5Properties.kt

@@ -58,7 +58,7 @@ object MQTT5PropertyEncoder {
             
             when (propId) {
                 MQTT5PropertyType.PAYLOAD_FORMAT_INDICATOR.toInt() -> {
-                    result.add(((value as? Int) ?: 0).toByte())
+                    result.add((((value as? Int) ?: 0) and 0xFF).toByte())
                 }
                 MQTT5PropertyType.MESSAGE_EXPIRY_INTERVAL.toInt(),
                 MQTT5PropertyType.SESSION_EXPIRY_INTERVAL.toInt(),
@@ -104,7 +104,7 @@ object MQTT5PropertyEncoder {
                 MQTT5PropertyType.WILDCARD_SUBSCRIPTION_AVAILABLE.toInt(),
                 MQTT5PropertyType.SUBSCRIPTION_IDENTIFIER_AVAILABLE.toInt(),
                 MQTT5PropertyType.SHARED_SUBSCRIPTION_AVAILABLE.toInt() -> {
-                    result.add(((value as? Int) ?: 0).toByte())
+                    result.add((((value as? Int) ?: 0) and 0xFF).toByte())
                 }
                 MQTT5PropertyType.USER_PROPERTY.toInt() -> {
                     if (value is Pair<*, *>) {

package/android/src/main/kotlin/ai/annadata/mqttquic/mqtt/MQTT5ReasonCodes.kt

@@ -2,14 +2,24 @@ package ai.annadata.mqttquic.mqtt
 
 /**
  * MQTT 5.0 Reason Codes. Matches MQTTD mqttd/reason_codes.py.
+ * MQTT 5.0 reuses byte values across packet types; we keep one constant per unique byte.
+ * Context-specific aliases are provided as properties for semantic clarity.
  */
 object MQTT5ReasonCode {
-    // Success
+    // 0x00 - Success (CONNACK), Granted QoS 0 (SUBACK), Success (UNSUBACK), Normal disconnection (DISCONNECT)
     const val SUCCESS: Int = 0x00
-    const val NORMAL_DISCONNECTION: Int = 0x00
+    // 0x01 - Granted QoS 1 (SUBACK)
+    const val GRANTED_QOS_1: Int = 0x01
+    // 0x02 - Granted QoS 2 (SUBACK)
+    const val GRANTED_QOS_2: Int = 0x02
+    // 0x04 - Disconnect with will message
     const val DISCONNECT_WITH_WILL_MESSAGE: Int = 0x04
+    // 0x10 - No matching subscribers (PUBACK/PUBREC/PUBREL/PUBCOMP)
+    const val NO_MATCHING_SUBSCRIBERS: Int = 0x10
+    // 0x11 - No subscription existed (UNSUBACK)
+    const val NO_SUBSCRIPTION_EXISTED: Int = 0x11
     
-    // CONNACK Reason Codes
+    // CONNACK / generic errors (0x80+)
     const val UNSPECIFIED_ERROR: Int = 0x80
     const val MALFORMED_PACKET: Int = 0x81
     const val PROTOCOL_ERROR: Int = 0x82
@@ -21,81 +31,83 @@ object MQTT5ReasonCode {
     const val SERVER_UNAVAILABLE: Int = 0x88
     const val SERVER_BUSY: Int = 0x89
     const val BANNED: Int = 0x8A
+    const val SERVER_SHUTTING_DOWN: Int = 0x8B
     const val BAD_AUTHENTICATION_METHOD: Int = 0x8C
+    const val KEEP_ALIVE_TIMEOUT: Int = 0x8D
+    const val SESSION_TAKEN_OVER: Int = 0x8E
+    const val TOPIC_FILTER_INVALID: Int = 0x8F
     const val TOPIC_NAME_INVALID: Int = 0x90
+    const val PACKET_IDENTIFIER_IN_USE: Int = 0x91
+    const val RECEIVE_MAXIMUM_EXCEEDED: Int = 0x93
+    const val TOPIC_ALIAS_INVALID: Int = 0x94
     const val PACKET_TOO_LARGE: Int = 0x95
+    const val MESSAGE_RATE_TOO_HIGH: Int = 0x96
     const val QUOTA_EXCEEDED: Int = 0x97
+    const val ADMINISTRATIVE_ACTION: Int = 0x98
     const val PAYLOAD_FORMAT_INVALID: Int = 0x99
     const val RETAIN_NOT_SUPPORTED: Int = 0x9A
     const val QOS_NOT_SUPPORTED: Int = 0x9B
     const val USE_ANOTHER_SERVER: Int = 0x9C
     const val SERVER_MOVED: Int = 0x9D
-    const val CONNECTION_RATE_EXCEEDED: Int = 0x9F
-    
-    // PUBACK, PUBREC, PUBREL, PUBCOMP Reason Codes
-    const val NO_MATCHING_SUBSCRIBERS: Int = 0x10
-    const val UNSPECIFIED_ERROR_PUB: Int = 0x80
-    const val IMPLEMENTATION_SPECIFIC_ERROR_PUB: Int = 0x83
-    const val NOT_AUTHORIZED_PUB: Int = 0x87
-    const val TOPIC_NAME_INVALID_PUB: Int = 0x90
-    const val PACKET_IDENTIFIER_IN_USE: Int = 0x91
-    const val QUOTA_EXCEEDED_PUB: Int = 0x97
-    const val PAYLOAD_FORMAT_INVALID_PUB: Int = 0x99
-    
-    // SUBACK Reason Codes
-    const val GRANTED_QOS_0: Int = 0x00
-    const val GRANTED_QOS_1: Int = 0x01
-    const val GRANTED_QOS_2: Int = 0x02
-    const val UNSPECIFIED_ERROR_SUB: Int = 0x80
-    const val IMPLEMENTATION_SPECIFIC_ERROR_SUB: Int = 0x83
-    const val NOT_AUTHORIZED_SUB: Int = 0x87
-    const val TOPIC_FILTER_INVALID: Int = 0x8F
-    const val PACKET_IDENTIFIER_IN_USE_SUB: Int = 0x91
-    const val QUOTA_EXCEEDED_SUB: Int = 0x97
     const val SHARED_SUBSCRIPTIONS_NOT_SUPPORTED: Int = 0x9E
+    const val CONNECTION_RATE_EXCEEDED: Int = 0x9F
+    const val MAXIMUM_CONNECT_TIME: Int = 0xA0
     const val SUBSCRIPTION_IDENTIFIERS_NOT_SUPPORTED: Int = 0xA1
     const val WILDCARD_SUBSCRIPTIONS_NOT_SUPPORTED: Int = 0xA2
     
-    // UNSUBACK Reason Codes
-    const val SUCCESS_UNSUB: Int = 0x00
-    const val NO_SUBSCRIPTION_EXISTED: Int = 0x11
-    const val UNSPECIFIED_ERROR_UNSUB: Int = 0x80
-    const val IMPLEMENTATION_SPECIFIC_ERROR_UNSUB: Int = 0x83
-    const val NOT_AUTHORIZED_UNSUB: Int = 0x87
-    const val TOPIC_FILTER_INVALID_UNSUB: Int = 0x8F
-    const val PACKET_IDENTIFIER_IN_USE_UNSUB: Int = 0x91
+    // Context-specific aliases (all map to the same underlying values)
+    // SUBACK aliases
+    const val GRANTED_QOS_0: Int = SUCCESS  // 0x00
     
-    // DISCONNECT Reason Codes
-    const val NORMAL_DISCONNECTION_DISC: Int = 0x00
-    const val DISCONNECT_WITH_WILL_MESSAGE_DISC: Int = 0x04
-    const val UNSPECIFIED_ERROR_DISC: Int = 0x80
-    const val MALFORMED_PACKET_DISC: Int = 0x81
-    const val PROTOCOL_ERROR_DISC: Int = 0x82
-    const val IMPLEMENTATION_SPECIFIC_ERROR_DISC: Int = 0x83
-    const val NOT_AUTHORIZED_DISC: Int = 0x87
-    const val SERVER_BUSY_DISC: Int = 0x89
-    const val SERVER_SHUTTING_DOWN: Int = 0x8B
-    const val BAD_AUTHENTICATION_METHOD_DISC: Int = 0x8C
-    const val KEEP_ALIVE_TIMEOUT: Int = 0x8D
-    const val SESSION_TAKEN_OVER: Int = 0x8E
-    const val TOPIC_FILTER_INVALID_DISC: Int = 0x8F
-    const val TOPIC_NAME_INVALID_DISC: Int = 0x90
-    const val RECEIVE_MAXIMUM_EXCEEDED: Int = 0x93
-    const val TOPIC_ALIAS_INVALID: Int = 0x94
-    const val PACKET_TOO_LARGE_DISC: Int = 0x95
-    const val MESSAGE_RATE_TOO_HIGH: Int = 0x96
-    const val QUOTA_EXCEEDED_DISC: Int = 0x97
-    const val ADMINISTRATIVE_ACTION: Int = 0x98
-    const val PAYLOAD_FORMAT_INVALID_DISC: Int = 0x99
-    const val RETAIN_NOT_SUPPORTED_DISC: Int = 0x9A
-    const val QOS_NOT_SUPPORTED_DISC: Int = 0x9B
-    const val USE_ANOTHER_SERVER_DISC: Int = 0x9C
-    const val SERVER_MOVED_DISC: Int = 0x9D
-    const val SHARED_SUBSCRIPTIONS_NOT_SUPPORTED_DISC: Int = 0x9E
-    const val CONNECTION_RATE_EXCEEDED_DISC: Int = 0x9F
-    const val MAXIMUM_CONNECT_TIME: Int = 0xA0
-    const val SUBSCRIPTION_IDENTIFIERS_NOT_SUPPORTED_DISC: Int = 0xA1
-    const val WILDCARD_SUBSCRIPTIONS_NOT_SUPPORTED_DISC: Int = 0xA2
+    // UNSUBACK aliases
+    const val SUCCESS_UNSUB: Int = SUCCESS  // 0x00
+    
+    // DISCONNECT aliases
+    const val NORMAL_DISCONNECTION: Int = SUCCESS  // 0x00
+    const val NORMAL_DISCONNECTION_DISC: Int = SUCCESS  // 0x00
+    const val DISCONNECT_WITH_WILL_MESSAGE_DISC: Int = DISCONNECT_WITH_WILL_MESSAGE  // 0x04
+    const val UNSPECIFIED_ERROR_DISC: Int = UNSPECIFIED_ERROR  // 0x80
+    const val MALFORMED_PACKET_DISC: Int = MALFORMED_PACKET  // 0x81
+    const val PROTOCOL_ERROR_DISC: Int = PROTOCOL_ERROR  // 0x82
+    const val IMPLEMENTATION_SPECIFIC_ERROR_DISC: Int = IMPLEMENTATION_SPECIFIC_ERROR  // 0x83
+    const val NOT_AUTHORIZED_DISC: Int = NOT_AUTHORIZED  // 0x87
+    const val SERVER_BUSY_DISC: Int = SERVER_BUSY  // 0x89
+    const val BAD_AUTHENTICATION_METHOD_DISC: Int = BAD_AUTHENTICATION_METHOD  // 0x8C
+    const val TOPIC_FILTER_INVALID_DISC: Int = TOPIC_FILTER_INVALID  // 0x8F
+    const val TOPIC_NAME_INVALID_DISC: Int = TOPIC_NAME_INVALID  // 0x90
+    const val PACKET_TOO_LARGE_DISC: Int = PACKET_TOO_LARGE  // 0x95
+    const val QUOTA_EXCEEDED_DISC: Int = QUOTA_EXCEEDED  // 0x97
+    const val PAYLOAD_FORMAT_INVALID_DISC: Int = PAYLOAD_FORMAT_INVALID  // 0x99
+    const val RETAIN_NOT_SUPPORTED_DISC: Int = RETAIN_NOT_SUPPORTED  // 0x9A
+    const val QOS_NOT_SUPPORTED_DISC: Int = QOS_NOT_SUPPORTED  // 0x9B
+    const val USE_ANOTHER_SERVER_DISC: Int = USE_ANOTHER_SERVER  // 0x9C
+    const val SERVER_MOVED_DISC: Int = SERVER_MOVED  // 0x9D
+    const val SHARED_SUBSCRIPTIONS_NOT_SUPPORTED_DISC: Int = SHARED_SUBSCRIPTIONS_NOT_SUPPORTED  // 0x9E
+    const val CONNECTION_RATE_EXCEEDED_DISC: Int = CONNECTION_RATE_EXCEEDED  // 0x9F
+    const val SUBSCRIPTION_IDENTIFIERS_NOT_SUPPORTED_DISC: Int = SUBSCRIPTION_IDENTIFIERS_NOT_SUPPORTED  // 0xA1
+    const val WILDCARD_SUBSCRIPTIONS_NOT_SUPPORTED_DISC: Int = WILDCARD_SUBSCRIPTIONS_NOT_SUPPORTED  // 0xA2
+    
+    // PUBACK/PUBREC/PUBREL/PUBCOMP aliases
+    const val UNSPECIFIED_ERROR_PUB: Int = UNSPECIFIED_ERROR  // 0x80
+    const val IMPLEMENTATION_SPECIFIC_ERROR_PUB: Int = IMPLEMENTATION_SPECIFIC_ERROR  // 0x83
+    const val NOT_AUTHORIZED_PUB: Int = NOT_AUTHORIZED  // 0x87
+    const val TOPIC_NAME_INVALID_PUB: Int = TOPIC_NAME_INVALID  // 0x90
+    const val QUOTA_EXCEEDED_PUB: Int = QUOTA_EXCEEDED  // 0x97
+    const val PAYLOAD_FORMAT_INVALID_PUB: Int = PAYLOAD_FORMAT_INVALID  // 0x99
+    
+    // SUBACK aliases
+    const val UNSPECIFIED_ERROR_SUB: Int = UNSPECIFIED_ERROR  // 0x80
+    const val IMPLEMENTATION_SPECIFIC_ERROR_SUB: Int = IMPLEMENTATION_SPECIFIC_ERROR  // 0x83
+    const val NOT_AUTHORIZED_SUB: Int = NOT_AUTHORIZED  // 0x87
+    const val PACKET_IDENTIFIER_IN_USE_SUB: Int = PACKET_IDENTIFIER_IN_USE  // 0x91
+    const val QUOTA_EXCEEDED_SUB: Int = QUOTA_EXCEEDED  // 0x97
+    
+    // UNSUBACK aliases
+    const val UNSPECIFIED_ERROR_UNSUB: Int = UNSPECIFIED_ERROR  // 0x80
+    const val IMPLEMENTATION_SPECIFIC_ERROR_UNSUB: Int = IMPLEMENTATION_SPECIFIC_ERROR  // 0x83
+    const val NOT_AUTHORIZED_UNSUB: Int = NOT_AUTHORIZED  // 0x87
+    const val TOPIC_FILTER_INVALID_UNSUB: Int = TOPIC_FILTER_INVALID  // 0x8F
+    const val PACKET_IDENTIFIER_IN_USE_UNSUB: Int = PACKET_IDENTIFIER_IN_USE  // 0x91
 }
 
 // Compatibility mapping for MQTT 3.1.1 return codes

package/ios/MqttQuicPlugin.podspec

@@ -12,7 +12,7 @@ Pod::Spec.new do |s|
   s.source = { :git => 'https://github.com/annadata/capacitor-mqtt-quic', :tag => s.version.to_s }
   s.source_files = 'Sources/**/*.{swift,h,m,c,cc,mm,cpp}'
   s.resources = ['Sources/MqttQuicPlugin/Resources/*.pem']
-  s.ios.deployment_target = '15.0'
+  s.ios.deployment_target = '14.0'
   s.dependency 'Capacitor'
   s.swift_version = '5.1'
   s.vendored_libraries = [

package/ios/Sources/MqttQuicPlugin/MQTT/MQTT5Properties.swift

@@ -71,7 +71,7 @@ public final class MQTT5PropertyEncoder {
             
             switch propId {
             case MQTT5PropertyType.payloadFormatIndicator.rawValue:
-                result.append((value as? Int ?? 0) & 0xFF)
+                result.append(UInt8((value as? Int ?? 0) & 0xFF))
                 
             case MQTT5PropertyType.messageExpiryInterval.rawValue,
                  MQTT5PropertyType.sessionExpiryInterval.rawValue,
@@ -117,7 +117,7 @@ public final class MQTT5PropertyEncoder {
                  MQTT5PropertyType.wildcardSubscriptionAvailable.rawValue,
                  MQTT5PropertyType.subscriptionIdentifierAvailable.rawValue,
                  MQTT5PropertyType.sharedSubscriptionAvailable.rawValue:
-                result.append((value as? Int ?? 0) & 0xFF)
+                result.append(UInt8((value as? Int ?? 0) & 0xFF))
                 
             case MQTT5PropertyType.userProperty.rawValue:
                 if let pair = value as? (String, String) {

package/ios/Sources/MqttQuicPlugin/MQTT/MQTT5ReasonCodes.swift.rej

@@ -0,0 +1,131 @@
+@@ -3,17 +3,27 @@
+ // MqttQuicPlugin
+ //
+ // MQTT 5.0 Reason Codes. Matches MQTTD mqttd/reason_codes.py.
++// Swift requires unique raw values; MQTT 5.0 reuses byte values across packet types.
++// We keep one case per unique byte; semantic aliases documented in comments.
+ //
+ 
+ import Foundation
+ 
+ public enum MQTT5ReasonCode: UInt8 {
+-    // Success
++    // 0x00 - Success (CONNACK), Granted QoS 0 (SUBACK), Success (UNSUBACK), Normal disconnection (DISCONNECT)
+     case success = 0x00
+-    case normalDisconnection = 0x00
++    // 0x01 - Granted QoS 1 (SUBACK)
++    case grantedQoS1 = 0x01
++    // 0x02 - Granted QoS 2 (SUBACK)
++    case grantedQoS2 = 0x02
++    // 0x04 - Disconnect with will message
+     case disconnectWithWillMessage = 0x04
++    // 0x10 - No matching subscribers (PUBACK/PUBREC/PUBREL/PUBCOMP)
++    case noMatchingSubscribers = 0x10
++    // 0x11 - No subscription existed (UNSUBACK)
++    case noSubscriptionExisted = 0x11
+ 
+-    // CONNACK Reason Codes
++    // CONNACK / generic errors (0x80+)
+     case unspecifiedError = 0x80
+     case malformedPacket = 0x81
+     case protocolError = 0x82
+@@ -25,81 +35,37 @@
+     case serverUnavailable = 0x88
+     case serverBusy = 0x89
+     case banned = 0x8A
++    case serverShuttingDown = 0x8B
+     case badAuthenticationMethod = 0x8C
++    case keepAliveTimeout = 0x8D
++    case sessionTakenOver = 0x8E
++    case topicFilterInvalid = 0x8F
+     case topicNameInvalid = 0x90
++    case packetIdentifierInUse = 0x91
++    case receiveMaximumExceeded = 0x93
++    case topicAliasInvalid = 0x94
+     case packetTooLarge = 0x95
++    case messageRateTooHigh = 0x96
+     case quotaExceeded = 0x97
++    case administrativeAction = 0x98
+     case payloadFormatInvalid = 0x99
+     case retainNotSupported = 0x9A
+     case qosNotSupported = 0x9B
+     case useAnotherServer = 0x9C
+     case serverMoved = 0x9D
+-    case connectionRateExceeded = 0x9F
+-    
+-    // PUBACK, PUBREC, PUBREL, PUBCOMP Reason Codes
+-    case noMatchingSubscribers = 0x10
+-    case unspecifiedErrorPub = 0x80
+-    case implementationSpecificErrorPub = 0x83
+-    case notAuthorizedPub = 0x87
+-    case topicNameInvalidPub = 0x90
+-    case packetIdentifierInUse = 0x91
+-    case quotaExceededPub = 0x97
+-    case payloadFormatInvalidPub = 0x99
+-    
+-    // SUBACK Reason Codes
+-    case grantedQoS0 = 0x00
+-    case grantedQoS1 = 0x01
+-    case grantedQoS2 = 0x02
+-    case unspecifiedErrorSub = 0x80
+-    case implementationSpecificErrorSub = 0x83
+-    case notAuthorizedSub = 0x87
+-    case topicFilterInvalid = 0x8F
+-    case packetIdentifierInUseSub = 0x91
+-    case quotaExceededSub = 0x97
+     case sharedSubscriptionsNotSupported = 0x9E
++    case connectionRateExceeded = 0x9F
++    case maximumConnectTime = 0xA0
+     case subscriptionIdentifiersNotSupported = 0xA1
+     case wildcardSubscriptionsNotSupported = 0xA2
++}
+ 
+-    // UNSUBACK Reason Codes
+-    case successUnsub = 0x00
+-    case noSubscriptionExisted = 0x11
+-    case unspecifiedErrorUnsub = 0x80
+-    case implementationSpecificErrorUnsub = 0x83
+-    case notAuthorizedUnsub = 0x87
+-    case topicFilterInvalidUnsub = 0x8F
+-    case packetIdentifierInUseUnsub = 0x91
+-    
+-    // DISCONNECT Reason Codes
+-    case normalDisconnectionDisc = 0x00
+-    case disconnectWithWillMessageDisc = 0x04
+-    case unspecifiedErrorDisc = 0x80
+-    case malformedPacketDisc = 0x81
+-    case protocolErrorDisc = 0x82
+-    case implementationSpecificErrorDisc = 0x83
+-    case notAuthorizedDisc = 0x87
+-    case serverBusyDisc = 0x89
+-    case serverShuttingDown = 0x8B
+-    case badAuthenticationMethodDisc = 0x8C
+-    case keepAliveTimeout = 0x8D
+-    case sessionTakenOver = 0x8E
+-    case topicFilterInvalidDisc = 0x8F
+-    case topicNameInvalidDisc = 0x90
+-    case receiveMaximumExceeded = 0x93
+-    case topicAliasInvalid = 0x94
+-    case packetTooLargeDisc = 0x95
+-    case messageRateTooHigh = 0x96
+-    case quotaExceededDisc = 0x97
+-    case administrativeAction = 0x98
+-    case payloadFormatInvalidDisc = 0x99
+-    case retainNotSupportedDisc = 0x9A
+-    case qosNotSupportedDisc = 0x9B
+-    case useAnotherServerDisc = 0x9C
+-    case serverMovedDisc = 0x9D
+-    case sharedSubscriptionsNotSupportedDisc = 0x9E
+-    case connectionRateExceededDisc = 0x9F
+-    case maximumConnectTime = 0xA0
+-    case subscriptionIdentifiersNotSupportedDisc = 0xA1
+-    case wildcardSubscriptionsNotSupportedDisc = 0xA2
++// Aliases for context clarity (same raw values)
++extension MQTT5ReasonCode {
++    /// SUBACK granted QoS 0 (rawValue 0x00, same as success)
++    public static let grantedQoS0: MQTT5ReasonCode = .success
++    /// DISCONNECT normal disconnection (rawValue 0x00)
++    public static let normalDisconnectionDisc: MQTT5ReasonCode = .success
+ }
+ 
+ // Compatibility mapping for MQTT 3.1.1 return codes

package/ios/Sources/MqttQuicPlugin/MqttQuicPlugin.swift

@@ -11,6 +11,17 @@ import Capacitor
 @objc(MqttQuicPlugin)
 public class MqttQuicPlugin: CAPPlugin, CAPBridgedPlugin {
 
+    public let identifier = "MqttQuicPlugin"
+    public let jsName = "MqttQuic"
+    public let pluginMethods: [CAPPluginMethod] = [
+        CAPPluginMethod(name: "connect", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "disconnect", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "publish", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "subscribe", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "unsubscribe", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "testHarness", returnType: CAPPluginReturnPromise)
+    ]
+
     private var client = MQTTClient(protocolVersion: .auto)
 
     @objc override public func load() {}

package/ios/Sources/MqttQuicPlugin/Transport/StreamTransport.swift

@@ -46,6 +46,10 @@ public final class MockStreamBuffer {
         return Data(out)
     }
 
+    public func appendWrite(_ data: Data) {
+        writeBuffer.append(data)
+    }
+
     public func consumeWrite() -> Data {
         let d = writeBuffer
         writeBuffer = Data()
@@ -94,7 +98,7 @@ public final class MockStreamWriter: MQTTStreamWriterProtocol {
     }
 
     public func write(_ data: Data) async throws {
-        buffer.writeBuffer.append(data)
+        buffer.appendWrite(data)
     }
 
     public func drain() async throws {}

package/ios/build-nghttp3.sh

@@ -23,7 +23,12 @@ if [ -z "$PROJECT_DIR" ] && [ -f "$SCRIPT_DIR/../package.json" ]; then
     PROJECT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
 fi
 if [ -n "$PROJECT_DIR" ]; then
-    REF_CODE_DIR="$(cd "$PROJECT_DIR/ref-code" && pwd)"
+    if [ -d "$PROJECT_DIR/ref-code" ]; then
+        REF_CODE_DIR="$(cd "$PROJECT_DIR/ref-code" && pwd)"
+    else
+        # Plugin run from repo: use parent as ref-code (e.g. ref-code/capacitor-mqtt-quic -> ref-code)
+        REF_CODE_DIR="$(cd "$PROJECT_DIR/.." && pwd)"
+    fi
 else
     if [ -d "$SCRIPT_DIR/../ref-code" ]; then
         REF_CODE_DIR="$(cd "$SCRIPT_DIR/../ref-code" && pwd)"
@@ -35,6 +40,10 @@ NGHTTP3_SOURCE_DIR="${NGHTTP3_SOURCE_DIR:-$REF_CODE_DIR/nghttp3}"
 if [[ "$NGHTTP3_SOURCE_DIR" != /* ]]; then
     NGHTTP3_SOURCE_DIR="$REF_CODE_DIR/$NGHTTP3_SOURCE_DIR"
 fi
+# If default path does not exist, try sibling ref-code/nghttp3 (e.g. when plugin has ref-code/ but nghttp3 lives in repo ref-code/)
+if [ -n "$PROJECT_DIR" ] && [ ! -d "$NGHTTP3_SOURCE_DIR" ] && [ -d "$(cd "$PROJECT_DIR/.." && pwd)/nghttp3" ]; then
+    NGHTTP3_SOURCE_DIR="$(cd "$PROJECT_DIR/../nghttp3" && pwd)"
+fi
 ARCH="${ARCH:-arm64}"
 SDK="${SDK:-iphoneos}"
 BUILD_TYPE="${BUILD_TYPE:-Release}"
@@ -100,8 +109,8 @@ if [ ! -d "$NGHTTP3_SOURCE_DIR" ]; then
     exit 1
 fi
 
-# Ensure required submodules are present (sfparse, munit)
-if [ ! -f "$NGHTTP3_SOURCE_DIR/sfparse/sfparse.c" ] || [ ! -f "$NGHTTP3_SOURCE_DIR/munit/munit.c" ]; then
+# Ensure required sources are present (sfparse: top-level or lib/sfparse)
+if [ ! -f "$NGHTTP3_SOURCE_DIR/sfparse/sfparse.c" ] && [ ! -f "$NGHTTP3_SOURCE_DIR/lib/sfparse/sfparse.c" ]; then
     if [ -d "$NGHTTP3_SOURCE_DIR/.git" ]; then
         echo "Initializing nghttp3 submodules..."
         (cd "$NGHTTP3_SOURCE_DIR" && git submodule update --init --recursive) || {
@@ -109,7 +118,7 @@ if [ ! -f "$NGHTTP3_SOURCE_DIR/sfparse/sfparse.c" ] || [ ! -f "$NGHTTP3_SOURCE_D
             exit 1
         }
     else
-        echo "Error: nghttp3 submodules are missing (sfparse/munit)"
+        echo "Error: nghttp3 submodules are missing (sfparse)"
         echo "Please clone with submodules:"
         echo "  git clone --recurse-submodules https://github.com/ngtcp2/nghttp3.git $NGHTTP3_SOURCE_DIR"
         echo "Or if already cloned:"

package/ios/build-ngtcp2.sh

@@ -36,6 +36,10 @@ NGTCP2_SOURCE_DIR="${NGTCP2_SOURCE_DIR:-$REF_CODE_DIR/ngtcp2}"
 if [[ "$NGTCP2_SOURCE_DIR" != /* ]]; then
     NGTCP2_SOURCE_DIR="$REF_CODE_DIR/$NGTCP2_SOURCE_DIR"
 fi
+# If default path does not exist, try sibling ref-code/ngtcp2 (e.g. when plugin has ref-code/ but ngtcp2 lives in repo ref-code/)
+if [ -n "$PROJECT_DIR" ] && [ ! -d "$NGTCP2_SOURCE_DIR" ] && [ -d "$(cd "$PROJECT_DIR/.." && pwd)/ngtcp2" ]; then
+    NGTCP2_SOURCE_DIR="$(cd "$PROJECT_DIR/../ngtcp2" && pwd)"
+fi
 OPENSSL_PATH="${OPENSSL_PATH:-}"
 USE_QUICTLS="${USE_QUICTLS:-0}"
 ARCH="${ARCH:-arm64}"
@@ -111,8 +115,8 @@ if [ ! -d "$NGTCP2_SOURCE_DIR" ]; then
     exit 1
 fi
 
-# Ensure required submodules are present (munit)
-if [ ! -f "$NGTCP2_SOURCE_DIR/munit/munit.c" ]; then
+# Ensure required sources are present (munit: top-level or tests/munit)
+if [ ! -f "$NGTCP2_SOURCE_DIR/munit/munit.c" ] && [ ! -f "$NGTCP2_SOURCE_DIR/tests/munit/munit.c" ]; then
     if [ -d "$NGTCP2_SOURCE_DIR/.git" ]; then
         echo "Initializing ngtcp2 submodules..."
         (cd "$NGTCP2_SOURCE_DIR" && git submodule update --init --recursive) || {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@annadata/capacitor-mqtt-quic",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "type": "module",
   "description": "MQTT-over-QUIC client for Capacitor (iOS/Android). Uses ngtcp2 for QUIC; MQTT over WebSocket fallback on web.",
   "main": "dist/plugin.cjs.js",