react-native-gizwits-sdk-v5 1.5.6-light → 1.5.6-thirdbluetooth

package/android/build.gradle

@@ -64,12 +64,14 @@ dependencies {
     implementation "androidx.startup:startup-runtime:$startup_version"
 
     implementation 'com.github.wendykierp:JTransforms:3.1'
+    // ESPTouch
+    implementation 'com.github.EspressifApp:lib-esptouch-android:1.1.1'
 
-    implementation("io.github.gizwits:sdk:1.6.1-light")
-    implementation("io.github.gizwits:sdk-bluetooth:1.6.1-light")
-    implementation("io.github.gizwits:sdk-lan:1.6.1-light")
-    implementation("io.github.gizwits:sdk-mqtt:1.6.1-light")
-    //  implementation files('libs/sdk-release.aar', 'libs/sdk-bluetooth-release.aar', 'libs/sdk-lan-release.aar', 'libs/sdk-mqtt-release.aar')
+    implementation files('libs/sdk-release.aar', 'libs/sdk-bluetooth-release.aar', 'libs/sdk-lan-release.aar', 'libs/sdk-mqtt-release.aar')
+    // implementation("io.github.gizwits:sdk:1.4.2")
+    // implementation("io.github.gizwits:sdk-bluetooth:1.4.2")
+    // implementation("io.github.gizwits:sdk-lan:1.4.2")
+    // implementation("io.github.gizwits:sdk-mqtt:1.4.2")
     implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:$kotlin_coroutine_version")
     // retrofit
     implementation("com.squareup.retrofit2:retrofit:$retrofit_version")

package/android/src/main/java/com/gizwits/reactnativegizwitssdkv5/GizRNCallbackManager.kt

@@ -33,11 +33,12 @@ object GizRNCallbackManager {
         } else {
             data.success = false
             result.exceptionOrNull()?.let {
-                try {
-                    data.error = (it as GizException).errorCode
-                    data.message = (it as GizException).localizedMessage
-                } catch (e: Exception) {
-
+                if (it is GizException) {
+                    data.error = it.errorCode
+                    data.message = it.localizedMessage ?: it.message ?: ""
+                } else {
+                    // 对于非 GizException 的异常（如 IllegalArgumentException），使用异常的消息
+                    data.message = it.message ?: it.localizedMessage ?: it.toString()
                 }
             }
         }

package/android/src/main/java/com/gizwits/reactnativegizwitssdkv5/RNGizDeviceManagerModule.kt

@@ -8,13 +8,14 @@ import com.facebook.react.bridge.ReadableMap
 import com.facebook.react.bridge.WritableMap
 import com.facebook.react.modules.core.DeviceEventManagerModule
 import com.gizwits.smart.sdk.GizDevice
+import com.gizwits.smart.sdk.esptouch.GizESPTouchSmartConfig
 import com.gizwits.smart.sdk.GizSDKManager
 import com.gizwits.smart.sdk.bluetooth.bleCapability
 import com.gizwits.smart.sdk.common.GizConfiguration
-import com.gizwits.smart.sdk.common.ProvideWiFiCredentialsEvent
+import com.gizwits.smart.sdk.common.GizWiFiActivatorEvent
 import com.gizwits.smart.sdk.core.capacity.CapacityTypes
-import com.gizwits.smart.sdk.core.network.model.GizDeviceLocalTimerParams
 import com.gizwits.smart.sdk.exception.GizException
+import com.gizwits.smart.sdk.extend.hexToByteArray
 import com.gizwits.smart.sdk.lan.lanCapability
 import com.gizwits.smart.sdk.mqtt.mqttCapability
 import com.gizwits.smart.sdk.light.MusicalRhythmParseMode
@@ -27,6 +28,8 @@ import com.google.gson.JsonObject
 import com.google.gson.annotations.SerializedName
 import kotlinx.coroutines.CoroutineScope
 import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.SupervisorJob
+import kotlinx.coroutines.cancel
 import kotlinx.coroutines.launch
 import org.json.JSONArray
 import org.json.JSONObject
@@ -77,33 +80,22 @@ data class StopMusicalRhythmParams(
   override val id: String,
 ): DeviceParams
 
-data class QueryTimerParams(
+data class SetDeviceMtuParams(
   @SerializedName("id")
   override val id: String,
-  @SerializedName("type")
-  val type: CapacityTypes,
-): DeviceParams
-
-data class DeleteTimerParams(
-  @SerializedName("id")
-  override val id: String,
-  @SerializedName("type")
-  val type: CapacityTypes,
-  @SerializedName("timerId")
-  val timerId: Int,
+  @SerializedName("mtu")
+  val mtu: Int,
 ): DeviceParams
 
-data class CreateTimerParams(
+data class SendThirdDeviceDpParams(
   @SerializedName("id")
   override val id: String,
-  @SerializedName("type")
-  val type: CapacityTypes,
   @SerializedName("data")
-  val data: GizDeviceLocalTimerParams,
+  val data: String,
+  @SerializedName("characteristicUuid")
+  val characteristicUuid: String? = null,
 ): DeviceParams
 
-
-
 data class StartMusicalRhythmParams(
   @SerializedName("id")
   override val id: String,
@@ -145,6 +137,20 @@ data class GizProvideWiFiCredentialsParams(
   @SerializedName("timeout")
   val timeout: Long,
 ): DeviceParams
+
+data class GizProvideWiFiCredentialsWithAirLinkParams(
+  @SerializedName("ssid")
+  val ssid: String,
+  @SerializedName("password")
+  val password: String,
+  @SerializedName("timeout")
+  val timeout: Long,
+  @SerializedName("productKeys")
+  val productKeys: List<String>,
+): DeviceParams {
+  override val id: String = "airlink" // AirLink 配网不需要设备ID
+}
+
 data class GizStopProvideWiFiCredentialsParams(
   @SerializedName("id")
   override val id: String,
@@ -175,6 +181,8 @@ data class StopUpgradeParams(
 
 
 class RNGizDeviceManagerModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaModule(reactContext) {
+  private val moduleScope = CoroutineScope(SupervisorJob() + Dispatchers.IO)
+
   enum class EventName(val value: String) {
     GizOTAProgressEvent("GizOTAProgressEvent"),
     GizProvideWiFiCredentialsEvent("GizProvideWiFiCredentialsEvent"),
@@ -191,11 +199,17 @@ class RNGizDeviceManagerModule(reactContext: ReactApplicationContext) : ReactCon
   }
 
   override fun getName() = "RNGizDeviceManagerModule"
+
+  override fun onCatalystInstanceDestroy() {
+    super.onCatalystInstanceDestroy()
+    moduleScope.cancel() // 取消所有协程
+  }
+
   @ReactMethod
   fun sendDp(options: ReadableMap, result: Callback) {
     val (config, device) = RNGizParamsChecker.checkDeviceAndParams(options, result, GizSendDPParams::class.java)
     if (config !=null && device !=null) {
-      CoroutineScope(Dispatchers.IO).launch {
+      moduleScope.launch {
         try {
           val gson = Gson()
           val jsonObject = gson.fromJson(config.data, JsonObject::class.java)
@@ -216,7 +230,7 @@ class RNGizDeviceManagerModule(reactContext: ReactApplicationContext) : ReactCon
   fun getDp(options: ReadableMap, result: Callback) {
     val (config, device) = RNGizParamsChecker.checkDeviceAndParams(options, result, GizGetDPParams::class.java)
     if (config !=null && device !=null) {
-      CoroutineScope(Dispatchers.IO).launch {
+      moduleScope.launch {
         var res = when(config.type) {
           CapacityTypes.BLE -> device.bleCapability.getDp(config.attrs)
           CapacityTypes.LAN -> device.lanCapability.getDp(config.attrs)
@@ -238,7 +252,7 @@ class RNGizDeviceManagerModule(reactContext: ReactApplicationContext) : ReactCon
   fun getDeviceInfo(options: ReadableMap, result: Callback) {
     val (config, device) = RNGizParamsChecker.checkDeviceAndParams(options, result, GizGetDeviceInfoParams::class.java)
     if (config !=null && device !=null) {
-      CoroutineScope(Dispatchers.IO).launch {
+      moduleScope.launch {
         val res = when(config.type) {
           CapacityTypes.BLE -> device.bleCapability.getDeviceInfo()
           CapacityTypes.LAN -> device.lanCapability.getDeviceInfo()
@@ -253,7 +267,7 @@ class RNGizDeviceManagerModule(reactContext: ReactApplicationContext) : ReactCon
   fun updateDeviceInfo(options: ReadableMap, result: Callback) {
     val (config, device) = RNGizParamsChecker.checkDeviceAndParams(options, result, UpdateDeviceInfoParams::class.java)
     if (config !=null && device !=null) {
-      CoroutineScope(Dispatchers.IO).launch {
+      moduleScope.launch {
         val res = device.updateDeviceInfo(config.alias, config.remark)
         GizRNCallbackManager.callbackWithResult(callback = result, result = res)
         // if (res.isSuccess) {
@@ -267,7 +281,7 @@ class RNGizDeviceManagerModule(reactContext: ReactApplicationContext) : ReactCon
   fun bind(options: ReadableMap, result: Callback) {
     val (config, device) = RNGizParamsChecker.checkDeviceAndParams(options, result, GizBindParams::class.java)
     if (config !=null && device !=null) {
-      CoroutineScope(Dispatchers.IO).launch {
+      moduleScope.launch {
         val res = device.bind(config.alias, config.remark)
         GizRNCallbackManager.callbackWithResult(callback = result, result = res)
         // if (res.isSuccess) {
@@ -281,7 +295,7 @@ class RNGizDeviceManagerModule(reactContext: ReactApplicationContext) : ReactCon
   fun unBind(options: ReadableMap, result: Callback) {
     val (config, device) = RNGizParamsChecker.checkDeviceAndParams(options, result, GizUnBindParams::class.java)
     if (config !=null && device !=null) {
-      CoroutineScope(Dispatchers.IO).launch {
+      moduleScope.launch {
         val res = device.unBind()
         GizRNCallbackManager.callbackWithResult(callback = result, result = res)
         if (res.isSuccess) {
@@ -294,7 +308,7 @@ class RNGizDeviceManagerModule(reactContext: ReactApplicationContext) : ReactCon
   fun stopProvideWiFiCredentials(options: ReadableMap, result: Callback) {
     val (config, device) = RNGizParamsChecker.checkDeviceAndParams(options, result, GizStopProvideWiFiCredentialsParams::class.java)
     if (config !=null && device !=null) {
-      CoroutineScope(Dispatchers.IO).launch {
+      moduleScope.launch {
         val res = when(config.type) {
           CapacityTypes.BLE -> device.bleCapability.stopProvideWiFiCredentials()
           CapacityTypes.LAN -> device.lanCapability.stopProvideWiFiCredentials()
@@ -305,7 +319,15 @@ class RNGizDeviceManagerModule(reactContext: ReactApplicationContext) : ReactCon
     }
   }
 
-  fun wiFiCredentialsEventHandler(event: ProvideWiFiCredentialsEvent, device: GizDevice) {
+  @ReactMethod
+  fun stopProvideWiFiCredentialsWithAirLink(result: Callback) {
+      moduleScope.launch {
+        val res = GizESPTouchSmartConfig.stopProvideWiFiCredentialsWithAirLink()
+        GizRNCallbackManager.callbackWithResult(callback = result, result = res)
+      }
+  }
+
+  fun wiFiCredentialsEventHandler(event: GizWiFiActivatorEvent, device: GizDevice) {
     val jsonObject = JSONObject()
     jsonObject.put("data", event.toString())
     jsonObject.put("device", device.toJsonObject())
@@ -314,11 +336,21 @@ class RNGizDeviceManagerModule(reactContext: ReactApplicationContext) : ReactCon
       GizRNCallbackManager.jsonObject2WriteableMap(jsonObject)
     )
   }
+
+fun wiFiCredentialsWithAirLinkEventHandler(event: GizWiFiActivatorEvent) {
+    val jsonObject = JSONObject()
+    jsonObject.put("data", event.toString())
+    sendEvent(
+      EventName.GizProvideWiFiCredentialsEvent.name,
+      GizRNCallbackManager.jsonObject2WriteableMap(jsonObject)
+    )
+  }
+
   @ReactMethod
   fun provideWiFiCredentials(options: ReadableMap, result: Callback) {
     val (config, device) = RNGizParamsChecker.checkDeviceAndParams(options, result, GizProvideWiFiCredentialsParams::class.java)
     if (config !=null && device !=null) {
-      CoroutineScope(Dispatchers.IO).launch {
+      moduleScope.launch {
         val res = when(config.type) {
           CapacityTypes.BLE -> device.bleCapability.provideWiFiCredentials(
             config.ssid,
@@ -350,11 +382,31 @@ class RNGizDeviceManagerModule(reactContext: ReactApplicationContext) : ReactCon
     }
   }
 
+  @ReactMethod
+  fun provideWiFiCredentialsWithAirLink(options: ReadableMap, result: Callback) {
+    val config = RNGizParamsChecker.check(options, result, GizProvideWiFiCredentialsWithAirLinkParams::class.java)
+    config?.let {
+      moduleScope.launch {
+        val res = GizESPTouchSmartConfig.provideWiFiCredentialsWithAirLink(
+          reactApplicationContext,
+          config.ssid,
+          config.password,
+          config.timeout,
+          config.productKeys,
+          processHandler = {
+            wiFiCredentialsWithAirLinkEventHandler(it)
+          }
+        )
+        GizRNCallbackManager.callbackWithResult(callback = result, result = res)
+      }
+    }
+  }
+
   @ReactMethod
   fun register(options: ReadableMap, result: Callback) {
     val (config, device) = RNGizParamsChecker.checkDeviceAndParams(options, result, GizRegisterDeviceParams::class.java)
     if (config !=null && device !=null) {
-      CoroutineScope(Dispatchers.IO).launch {
+      moduleScope.launch {
         val res = device.register()
         GizRNCallbackManager.callbackWithResult(callback = result, result = res)
       }
@@ -365,7 +417,7 @@ class RNGizDeviceManagerModule(reactContext: ReactApplicationContext) : ReactCon
   fun connect(options: ReadableMap, result: Callback) {
     val (config, device) = RNGizParamsChecker.checkDeviceAndParams(options, result, GizConnectParams::class.java)
     if (config !=null && device !=null) {
-      CoroutineScope(Dispatchers.IO).launch {
+      moduleScope.launch {
         val res = when(config.type) {
           CapacityTypes.BLE -> device.bleCapability.connect()
           CapacityTypes.LAN -> device.lanCapability.connect()
@@ -379,7 +431,7 @@ class RNGizDeviceManagerModule(reactContext: ReactApplicationContext) : ReactCon
   fun disConnect(options: ReadableMap, result: Callback) {
     val (config, device) = RNGizParamsChecker.checkDeviceAndParams(options, result, GizDisConnectParams::class.java)
     if (config !=null && device !=null) {
-      CoroutineScope(Dispatchers.IO).launch {
+      moduleScope.launch {
         val res = when(config.type) {
           CapacityTypes.BLE -> device.bleCapability.disConnect()
           CapacityTypes.LAN -> device.lanCapability.disConnect()
@@ -394,7 +446,7 @@ class RNGizDeviceManagerModule(reactContext: ReactApplicationContext) : ReactCon
   fun checkUpdate(options: ReadableMap, result: Callback) {
     val (config, device) = RNGizParamsChecker.checkDeviceAndParams(options, result, GizCheckUpdateParams::class.java)
     if (config !=null && device !=null) {
-      CoroutineScope(Dispatchers.IO).launch {
+      moduleScope.launch {
         val res = when(config.type) {
           CapacityTypes.BLE -> device.bleCapability.checkUpdate(config.firmwareType)
           CapacityTypes.LAN -> device.lanCapability.checkUpdate(config.firmwareType)
@@ -421,7 +473,7 @@ class RNGizDeviceManagerModule(reactContext: ReactApplicationContext) : ReactCon
   fun startUpgrade(options: ReadableMap, result: Callback) {
     val (config, device) = RNGizParamsChecker.checkDeviceAndParams(options, result, GizCheckUpdateParams::class.java)
     if (config !=null && device !=null) {
-      CoroutineScope(Dispatchers.IO).launch {
+      moduleScope.launch {
         val res = when(config.type) {
           CapacityTypes.BLE -> {
             device.bleCapability.startUpgrade(config.firmwareType, processHandler = {
@@ -443,7 +495,7 @@ class RNGizDeviceManagerModule(reactContext: ReactApplicationContext) : ReactCon
   fun cancelUpgrade(options: ReadableMap, result: Callback) {
     val (config, device) = RNGizParamsChecker.checkDeviceAndParams(options, result, StopUpgradeParams::class.java)
     if (config !=null && device !=null) {
-      CoroutineScope(Dispatchers.IO).launch {
+      moduleScope.launch {
         val res = when(config.type) {
           CapacityTypes.BLE -> device.bleCapability.cancelUpgrade()
           CapacityTypes.LAN -> device.lanCapability.cancelUpgrade()
@@ -458,7 +510,7 @@ class RNGizDeviceManagerModule(reactContext: ReactApplicationContext) : ReactCon
     val (config, device) = RNGizParamsChecker.checkDeviceAndParams(options, result, StartMusicalRhythmParams::class.java)
     print("startMusicalRhythm ${config}")
     if (config !=null && device !=null) {
-      CoroutineScope(Dispatchers.IO).launch {
+      moduleScope.launch {
         val res = device.startMusicalRhythm(config.sensitivity, config.mode) { data ->
           if (config.needMonitor) {
             val jsonObject = JSONObject()
@@ -493,7 +545,7 @@ class RNGizDeviceManagerModule(reactContext: ReactApplicationContext) : ReactCon
   fun stopMusicalRhythm(options: ReadableMap, result: Callback) {
     val (config, device) = RNGizParamsChecker.checkDeviceAndParams(options, result, StopMusicalRhythmParams::class.java)
     if (config !=null && device !=null) {
-      CoroutineScope(Dispatchers.IO).launch {
+      moduleScope.launch {
         val res = device.stopMusicalRhythm();
         GizRNCallbackManager.callbackWithResult(callback = result, result = Result.success(Unit))
       }
@@ -501,67 +553,53 @@ class RNGizDeviceManagerModule(reactContext: ReactApplicationContext) : ReactCon
   }
 
   @ReactMethod
-  fun queryTimer(options: ReadableMap, result: Callback) {
-    val (config, device) = RNGizParamsChecker.checkDeviceAndParams(options, result, QueryTimerParams::class.java)
-    if (config !=null && device !=null) {
-      CoroutineScope(Dispatchers.IO).launch {
-        val res = when(config.type) {
-          CapacityTypes.BLE -> device.bleCapability.queryTimer()
-          CapacityTypes.LAN -> device.lanCapability.queryTimer()
-          CapacityTypes.MQTT -> device.mqttCapability.queryTimer()
-        }
-        GizRNCallbackManager.callbackWithResult(callback = result, result = res)
-      }
-    }
-  }
-
-  @ReactMethod
-  fun deleteTimer(options: ReadableMap, result: Callback) {
-    val (config, device) = RNGizParamsChecker.checkDeviceAndParams(options, result, DeleteTimerParams::class.java)
-    if (config !=null && device !=null) {
-      CoroutineScope(Dispatchers.IO).launch {
-        val res = when(config.type) {
-          CapacityTypes.BLE -> device.bleCapability.deleteTimer(config.timerId)
-          CapacityTypes.LAN -> device.lanCapability.deleteTimer(config.timerId)
-          CapacityTypes.MQTT -> device.mqttCapability.deleteTimer(config.timerId)
-        }
-        GizRNCallbackManager.callbackWithResult(callback = result, result = res)
-      }
-    }
-  }
-
-  @ReactMethod
-  fun createTimer(options: ReadableMap, result: Callback) {
-    val (config, device) = RNGizParamsChecker.checkDeviceAndParams(options, result, CreateTimerParams::class.java)
+  fun setDeviceMtu(options: ReadableMap, result: Callback) {
+    val (config, device) = RNGizParamsChecker.checkDeviceAndParams(options, result, SetDeviceMtuParams::class.java)
     if (config !=null && device !=null) {
-      CoroutineScope(Dispatchers.IO).launch {
-        val res = when(config.type) {
-          CapacityTypes.BLE -> device.bleCapability.createTimer(config.data)
-          CapacityTypes.LAN -> device.lanCapability.createTimer(config.data)
-          CapacityTypes.MQTT -> device.mqttCapability.createTimer(config.data)
-        }
+      moduleScope.launch {
+        val res = device.setDeviceMtu(config.mtu);
         GizRNCallbackManager.callbackWithResult(callback = result, result = res)
       }
     }
   }
 
-
   @ReactMethod
-  fun editTimer(options: ReadableMap, result: Callback) {
-    val (config, device) = RNGizParamsChecker.checkDeviceAndParams(options, result, CreateTimerParams::class.java)
+  fun sendThirdDeviceDp(options: ReadableMap, result: Callback) {
+    val (config, device) = RNGizParamsChecker.checkDeviceAndParams(options, result, SendThirdDeviceDpParams::class.java)
     if (config !=null && device !=null) {
-      CoroutineScope(Dispatchers.IO).launch {
-        val res = when(config.type) {
-          CapacityTypes.BLE -> device.bleCapability.editTimer(config.data)
-          CapacityTypes.LAN -> device.lanCapability.editTimer(config.data)
-          CapacityTypes.MQTT -> device.mqttCapability.editTimer(config.data)
+      moduleScope.launch {
+        try {
+          // 第三方设备直接透传原始数据，使用特殊键 "rawData" 标识原始数据
+          // 只支持十六进制字符串格式（只包含 0-9A-Fa-f，且长度为偶数）
+          if (!config.data.matches(Regex("^[0-9A-Fa-f]+$"))) {
+            GizRNCallbackManager.callbackWithResult(
+              callback = result, 
+              result = Result.failure<Unit>(IllegalArgumentException("Data must be a valid hexadecimal string (0-9A-Fa-f only)"))
+            )
+            return@launch
+          }
+          
+          if (config.data.length % 2 != 0) {
+            GizRNCallbackManager.callbackWithResult(
+              callback = result, 
+              result = Result.failure<Unit>(IllegalArgumentException("Hex string length must be even"))
+            )
+            return@launch
+          }
+          
+          // 使用十六进制解码
+          val rawData: ByteArray = config.data.hexToByteArray()
+          
+          // 使用特殊键 "rawData" 传递原始数据，sendThirdDeviceDp 会识别并直接透传
+          val res = device.sendThirdDeviceDp("rawData" to rawData, characteristicUuid = config.characteristicUuid)
+          GizRNCallbackManager.callbackWithResult(callback = result, result = res)
+        } catch (e: Exception) {
+          GizRNCallbackManager.callbackWithResult(callback = result, result = Result.failure<Unit>(e))
         }
-        GizRNCallbackManager.callbackWithResult(callback = result, result = res)
       }
     }
   }
 
-
   fun sendEvent(name:String, data: WritableMap?) {
     reactApplicationContext
       .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)

package/android/src/main/java/com/gizwits/reactnativegizwitssdkv5/RNGizParamsChecker.kt

@@ -5,6 +5,7 @@ import com.facebook.react.bridge.ReadableNativeMap
 import com.gizwits.smart.sdk.GizDevice
 import com.gizwits.smart.sdk.GizSDKManager
 import com.gizwits.smart.sdk.exception.GizException
+import com.gizwits.smart.sdk.exception.GizParseException
 import com.google.gson.Gson
 import com.google.gson.JsonSyntaxException
 import com.google.gson.annotations.SerializedName

package/ios/GizwitsiOSSDK.framework/Headers/CocoaAsyncSocket.h

@@ -0,0 +1,18 @@
+//
+//  CocoaAsyncSocket.h
+//  CocoaAsyncSocket
+//
+//  Created by Derek Clarkson on 10/08/2015.
+//  CocoaAsyncSocket project is in the public domain.
+//
+
+#import <Foundation/Foundation.h>
+
+//! Project version number for CocoaAsyncSocket.
+FOUNDATION_EXPORT double _cocoaAsyncSocketVersionNumber;
+
+//! Project version string for CocoaAsyncSocket.
+FOUNDATION_EXPORT const unsigned char _cocoaAsyncSocketVersionString[];
+
+#import "_GCDAsyncSocket.h"
+#import "_GCDAsyncUdpSocket.h"

package/ios/GizwitsiOSSDK.framework/Headers/DDASLLogger.h

@@ -0,0 +1,41 @@
+#import <Foundation/Foundation.h>
+#import <asl.h>
+
+#import "DDLog.h"
+
+/**
+ * Welcome to Cocoa Lumberjack!
+ * 
+ * The project page has a wealth of documentation if you have any questions.
+ * https://github.com/CocoaLumberjack/CocoaLumberjack
+ * 
+ * If you're new to the project you may wish to read the "Getting Started" wiki.
+ * https://github.com/CocoaLumberjack/CocoaLumberjack/wiki/GettingStarted
+ * 
+ * 
+ * This class provides a logger for the Apple System Log facility.
+ * 
+ * As described in the "Getting Started" page,
+ * the traditional NSLog() function directs it's output to two places:
+ * 
+ * - Apple System Log
+ * - StdErr (if stderr is a TTY) so log statements show up in Xcode console
+ * 
+ * To duplicate NSLog() functionality you can simply add this logger and a tty logger.
+ * However, if you instead choose to use file logging (for faster performance),
+ * you may choose to use a file logger and a tty logger.
+**/
+
+@interface DDASLLogger : DDAbstractLogger <DDLogger>
+{
+    aslclient client;
+}
+
++ (instancetype)sharedInstance;
+
+// Inherited from DDAbstractLogger
+
+// - (id <DDLogFormatter>)logFormatter;
+// - (void)setLogFormatter:(id <DDLogFormatter>)formatter;
+
+@end

package/ios/GizwitsiOSSDK.framework/Headers/DDAbstractDatabaseLogger.h

@@ -0,0 +1,102 @@
+#import <Foundation/Foundation.h>
+
+#import "DDLog.h"
+
+/**
+ * Welcome to Cocoa Lumberjack!
+ * 
+ * The project page has a wealth of documentation if you have any questions.
+ * https://github.com/CocoaLumberjack/CocoaLumberjack
+ * 
+ * If you're new to the project you may wish to read the "Getting Started" wiki.
+ * https://github.com/CocoaLumberjack/CocoaLumberjack/wiki/GettingStarted
+ * 
+ * 
+ * This class provides an abstract implementation of a database logger.
+ * 
+ * That is, it provides the base implementation for a database logger to build atop of.
+ * All that is needed for a concrete database logger is to extend this class
+ * and override the methods in the implementation file that are prefixed with "db_".
+**/
+
+@interface DDAbstractDatabaseLogger : DDAbstractLogger {
+@protected
+    NSUInteger saveThreshold;
+    NSTimeInterval saveInterval;
+    NSTimeInterval maxAge;
+    NSTimeInterval deleteInterval;
+    BOOL deleteOnEverySave;
+    
+    BOOL saveTimerSuspended;
+    NSUInteger unsavedCount;
+    dispatch_time_t unsavedTime;
+    dispatch_source_t saveTimer;
+    dispatch_time_t lastDeleteTime;
+    dispatch_source_t deleteTimer;
+}
+
+/**
+ * Specifies how often to save the data to disk.
+ * Since saving is an expensive operation (disk io) it is not done after every log statement.
+ * These properties allow you to configure how/when the logger saves to disk.
+ * 
+ * A save is done when either (whichever happens first):
+ * 
+ * - The number of unsaved log entries reaches saveThreshold
+ * - The amount of time since the oldest unsaved log entry was created reaches saveInterval
+ * 
+ * You can optionally disable the saveThreshold by setting it to zero.
+ * If you disable the saveThreshold you are entirely dependent on the saveInterval.
+ * 
+ * You can optionally disable the saveInterval by setting it to zero (or a negative value).
+ * If you disable the saveInterval you are entirely dependent on the saveThreshold.
+ * 
+ * It's not wise to disable both saveThreshold and saveInterval.
+ * 
+ * The default saveThreshold is 500.
+ * The default saveInterval is 60 seconds.
+**/
+@property (assign, readwrite) NSUInteger saveThreshold;
+@property (assign, readwrite) NSTimeInterval saveInterval;
+
+/**
+ * It is likely you don't want the log entries to persist forever.
+ * Doing so would allow the database to grow infinitely large over time.
+ * 
+ * The maxAge property provides a way to specify how old a log statement can get
+ * before it should get deleted from the database.
+ * 
+ * The deleteInterval specifies how often to sweep for old log entries.
+ * Since deleting is an expensive operation (disk io) is is done on a fixed interval.
+ * 
+ * An alternative to the deleteInterval is the deleteOnEverySave option.
+ * This specifies that old log entries should be deleted during every save operation.
+ * 
+ * You can optionally disable the maxAge by setting it to zero (or a negative value).
+ * If you disable the maxAge then old log statements are not deleted.
+ * 
+ * You can optionally disable the deleteInterval by setting it to zero (or a negative value).
+ * 
+ * If you disable both deleteInterval and deleteOnEverySave then old log statements are not deleted.
+ * 
+ * It's not wise to enable both deleteInterval and deleteOnEverySave.
+ * 
+ * The default maxAge is 7 days.
+ * The default deleteInterval is 5 minutes.
+ * The default deleteOnEverySave is NO.
+**/
+@property (assign, readwrite) NSTimeInterval maxAge;
+@property (assign, readwrite) NSTimeInterval deleteInterval;
+@property (assign, readwrite) BOOL deleteOnEverySave;
+
+/**
+ * Forces a save of any pending log entries (flushes log entries to disk).
+**/
+- (void)savePendingLogEntries;
+
+/**
+ * Removes any log entries that are older than maxAge.
+**/
+- (void)deleteOldLogEntries;
+
+@end