@connexup/react-native-xprinter 0.1.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 Connexup
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NativeXPrinter.podspec

@@ -0,0 +1,23 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "NativeXPrinter"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => package["repository"]["url"], :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,swift,cpp}"
+  s.public_header_files = "ios/PrinterSDK/Headers/**/*.h"
+#   s.private_header_files = "ios/**/*.h"
+  s.preserve_paths = 'ios/PrinterSDK/libPrinterSDK.a'
+  s.vendored_libraries = 'ios/PrinterSDK/libPrinterSDK.a'
+
+  install_modules_dependencies(s)
+end

package/README.md

@@ -0,0 +1,24 @@
+# react-native-xprinter
+
+XPrinter's SDK for React Native
+
+## Installation
+
+
+```sh
+yarn add react-native-xprinter
+```
+
+## Contributing
+
+- [Development workflow](CONTRIBUTING.md#development-workflow)
+- [Sending a pull request](CONTRIBUTING.md#sending-a-pull-request)
+- [Code of conduct](CODE_OF_CONDUCT.md)
+
+## License
+
+MIT
+
+---
+
+Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)

package/android/build.gradle

@@ -0,0 +1,73 @@
+buildscript {
+  ext.getExtOrDefault = {name ->
+    return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['NativeXPrinter_' + name]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+apply plugin: "com.facebook.react"
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["NativeXPrinter_" + name]).toInteger()
+}
+
+android {
+  namespace "com.connexup.xprinter"
+
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+  }
+
+  buildFeatures {
+    buildConfig true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lint {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+
+  sourceSets {
+    main {
+      java.srcDirs += [
+        "generated/java",
+        "generated/jni"
+      ]
+    }
+  }
+}
+
+def kotlin_version = getExtOrDefault("kotlinVersion")
+
+dependencies {
+  implementation fileTree(include: ['*.aar'], dir: 'libs')
+  implementation "com.facebook.react:react-android"
+  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+}

package/android/gradle.properties

@@ -0,0 +1,5 @@
+NativeXPrinter_kotlinVersion=2.0.21
+NativeXPrinter_minSdkVersion=28
+NativeXPrinter_targetSdkVersion=35
+NativeXPrinter_compileSdkVersion=35
+NativeXPrinter_ndkVersion=27.1.12297006

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/java/com/connexup/xprinter/Errors.kt

@@ -0,0 +1,11 @@
+package com.connexup.xprinter
+
+/**
+ * Description:
+ * @author lukechen@chancetop.com
+ * @date 2026/2/5
+ */
+const val PARAMS_ERROR = "PARAMS_ERROR"
+const val COMMON_ERROR = "COMMON_ERROR"
+const val PRINTER_NOT_FOUND_ERROR = "PRINTER_NOT_FOUND_ERROR"
+const val NOT_YET_IMPLEMENTED_ERROR = "NOT_YET_IMPLEMENTED_ERROR"

package/android/src/main/java/com/connexup/xprinter/Util.kt

@@ -0,0 +1,106 @@
+package com.connexup.xprinter
+
+import android.graphics.Bitmap
+import android.graphics.BitmapFactory
+import android.graphics.Color
+import android.util.Base64
+import androidx.core.graphics.scale
+import kotlinx.coroutines.DelicateCoroutinesApi
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.GlobalScope
+import kotlinx.coroutines.launch
+import kotlin.math.ceil
+
+/**
+ * Description:
+ * @author lukechen@chancetop.com
+ * @date 2025/1/22
+ */
+
+fun parseAddressData(str: String): ByteArray? {
+  val arr = str.split(".")
+  if (arr.size != 4) {
+    return null
+  }
+  return byteArrayOf(
+    arr[0].toInt().toByte(),
+    arr[1].toInt().toByte(),
+    arr[2].toInt().toByte(),
+    arr[3].toInt().toByte()
+  )
+}
+
+fun loadAndScaleBitmap(
+  bitmapContent: String?,
+  bitmapPath: String?,
+  width: Int,
+): Bitmap? {
+  val bitmap = loadBitmap(bitmapContent = bitmapContent, bitmapPath = bitmapPath)
+  if (bitmap == null) {
+    return null
+  }
+  if (bitmap.width == width) {
+    return bitmap
+  }
+  val scale = width.toFloat() / bitmap.width
+  val height = ceil((bitmap.height * scale)).toInt()
+  val scaledBitmap = bitmap.scale(width, height, true)
+  if (scaledBitmap != bitmap) {
+    GlobalScope.launch(Dispatchers.IO) {
+      try {
+        if (!bitmap.isRecycled) {
+          bitmap.recycle()
+        }
+      } catch (_: Exception) {
+      }
+    }
+  }
+  return scaledBitmap
+}
+
+fun isPureWhiteImage(
+  bitmapContent: String?,
+  bitmapPath: String?
+): Boolean {
+  val bitmap = loadBitmap(bitmapContent = bitmapContent, bitmapPath = bitmapPath)
+    ?: throw RuntimeException("Image is nil or failed to decode.")
+  val scaledBitmap = bitmap.scale(8, 8, false)
+  val w = scaledBitmap.width
+  val h = scaledBitmap.height
+  val pixels = IntArray(w * h)
+  scaledBitmap.getPixels(pixels, 0, w, 0, 0, w, h)
+  var result = true
+  for (c in pixels) {
+    val r = Color.red(c)
+    val g = Color.green(c)
+    val b = Color.blue(c)
+    if (r != 255 || g != 255 || b != 255) {
+      result = false
+      break
+    }
+  }
+  GlobalScope.launch(Dispatchers.IO) {
+    try {
+      if (!bitmap.isRecycled) {
+        bitmap.recycle()
+      }
+      if (!scaledBitmap.isRecycled) {
+        scaledBitmap.recycle()
+      }
+    } catch (_: Exception) {
+    }
+  }
+  return result
+}
+
+private fun loadBitmap(
+  bitmapContent: String?,
+  bitmapPath: String?,
+): Bitmap? {
+  return if (bitmapContent != null) {
+    val bytes = Base64.decode(bitmapContent, Base64.DEFAULT)
+    BitmapFactory.decodeByteArray(bytes, 0, bytes.size)
+  } else {
+    BitmapFactory.decodeFile(bitmapPath)
+  }
+}

package/android/src/main/java/com/connexup/xprinter/XPrinterPackage.kt

@@ -0,0 +1,77 @@
+package com.connexup.xprinter
+
+import com.connexup.xprinter.esc.XPrinterESCModule
+import com.connexup.xprinter.printer.XPrinterPrinterModule
+import com.connexup.xprinter.tspl.XPrinterTSPLModule
+import com.connexup.xprinter.utils.XPrinterUtilsModule
+import com.facebook.react.BaseReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfo
+import com.facebook.react.module.model.ReactModuleInfoProvider
+import java.util.HashMap
+
+class XPrinterPackage : BaseReactPackage() {
+  override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? {
+    return when (name) {
+      XPrinterPrinterModule.NAME -> {
+        XPrinterPrinterModule(reactContext)
+      }
+
+      XPrinterESCModule.NAME -> {
+        XPrinterESCModule(reactContext)
+      }
+
+      XPrinterTSPLModule.NAME -> {
+        XPrinterTSPLModule(reactContext)
+      }
+
+      XPrinterUtilsModule.NAME -> {
+        XPrinterUtilsModule(reactContext)
+      }
+
+      else -> {
+        null
+      }
+    }
+  }
+
+  override fun getReactModuleInfoProvider(): ReactModuleInfoProvider {
+    return ReactModuleInfoProvider {
+      val moduleInfos: MutableMap<String, ReactModuleInfo> = HashMap()
+      moduleInfos[XPrinterPrinterModule.NAME] = ReactModuleInfo(
+        name = XPrinterPrinterModule.NAME,
+        className = XPrinterPrinterModule.NAME,
+        canOverrideExistingModule = false,
+        needsEagerInit = false,
+        isCxxModule = false,
+        isTurboModule = true
+      )
+      moduleInfos[XPrinterESCModule.NAME] = ReactModuleInfo(
+        name = XPrinterESCModule.NAME,
+        className = XPrinterESCModule.NAME,
+        canOverrideExistingModule = false,
+        needsEagerInit = false,
+        isCxxModule = false,
+        isTurboModule = true
+      )
+      moduleInfos[XPrinterTSPLModule.NAME] = ReactModuleInfo(
+        name = XPrinterTSPLModule.NAME,
+        className = XPrinterTSPLModule.NAME,
+        canOverrideExistingModule = false,  // canOverrideExistingModule
+        needsEagerInit = false,  // needsEagerInit
+        isCxxModule = false,  // isCxxModule
+        isTurboModule = true // isTurboModule
+      )
+      moduleInfos[XPrinterUtilsModule.NAME] = ReactModuleInfo(
+        name = XPrinterUtilsModule.NAME,
+        className = XPrinterUtilsModule.NAME,
+        canOverrideExistingModule = false,
+        needsEagerInit = false,
+        isCxxModule = false,
+        isTurboModule = true
+      )
+      moduleInfos
+    }
+  }
+}

package/android/src/main/java/com/connexup/xprinter/esc/Convert.kt

@@ -0,0 +1,211 @@
+package com.connexup.xprinter.esc
+
+import net.posprinter.POSConst
+
+fun String.toCharSet(): String? {
+    return when (this) {
+        "GBK" -> "GBK"
+        "UTF-8" -> "UTF-8"
+        else -> null
+    }
+}
+
+fun String.toESCTextWidth(): Int? {
+    return when (this) {
+        "TXT_1_WIDTH" -> POSConst.TXT_1WIDTH
+        "TXT_2_WIDTH" -> POSConst.TXT_2WIDTH
+        "TXT_3_WIDTH" -> POSConst.TXT_3WIDTH
+        "TXT_4_WIDTH" -> POSConst.TXT_4WIDTH
+        "TXT_5_WIDTH" -> POSConst.TXT_5WIDTH
+        "TXT_6_WIDTH" -> POSConst.TXT_6WIDTH
+        "TXT_7_WIDTH" -> POSConst.TXT_7WIDTH
+        "TXT_8_WIDTH" -> POSConst.TXT_8WIDTH
+        else -> null
+    }
+}
+
+fun String.toESCTextHeight(): Int? {
+    return when (this) {
+        "TXT_1_HEIGHT" -> POSConst.TXT_1HEIGHT
+        "TXT_2_HEIGHT" -> POSConst.TXT_2HEIGHT
+        "TXT_3_HEIGHT" -> POSConst.TXT_3HEIGHT
+        "TXT_4_HEIGHT" -> POSConst.TXT_4HEIGHT
+        "TXT_5_HEIGHT" -> POSConst.TXT_5HEIGHT
+        "TXT_6_HEIGHT" -> POSConst.TXT_6HEIGHT
+        "TXT_7_HEIGHT" -> POSConst.TXT_7HEIGHT
+        "TXT_8_HEIGHT" -> POSConst.TXT_8HEIGHT
+        else -> null
+    }
+}
+
+fun String.toESCTextAttribute(): Int? {
+    return when (this) {
+        "DEFAULT" -> POSConst.FNT_DEFAULT
+        "FONTB" -> POSConst.FNT_FONTB
+        "BOLD" -> POSConst.FNT_BOLD
+        "REVERSE" -> POSConst.FNT_REVERSE
+        "UNDERLINE" -> POSConst.FNT_UNDERLINE
+        "UNDERLINE2" -> POSConst.FNT_UNDERLINE2
+        else -> null
+    }
+}
+
+fun String.toESCAlignment(): Int? {
+    return when (this) {
+        "LEFT" -> POSConst.ALIGNMENT_LEFT
+        "CENTER" -> POSConst.ALIGNMENT_CENTER
+        "RIGHT" -> POSConst.ALIGNMENT_RIGHT
+        else -> null
+    }
+}
+
+fun String.toESCBmpModel(): Int? {
+    return when (this) {
+        "NORMAL" -> POSConst.BMP_NORMAL
+        "WIDTH_DOUBLE" -> POSConst.BMP_WIDTH_DOUBLE
+        "HEIGHT_DOUBLE" -> POSConst.BMP_HEIGHT_DOUBLE
+        "WIDTH_HEIGHT_DOUBLE" -> POSConst.BMP_WIDTH_HEIGHT_DOUBLE
+        else -> null
+    }
+}
+
+fun String.toESCBarcodeType(): Int? {
+    return when (this) {
+        "UPCA" -> POSConst.BCS_UPCA
+        "UPCE" -> POSConst.BCS_UPCE
+        "EAN8" -> POSConst.BCS_EAN8
+        "EAN13" -> POSConst.BCS_EAN13
+        "JAN8" -> POSConst.BCS_JAN8
+        "JAN13" -> POSConst.BCS_JAN13
+        "ITF" -> POSConst.BCS_ITF
+        "CODEBAR" -> POSConst.BCS_Codabar
+        "CODE39" -> POSConst.BCS_Code39
+        "CODE93" -> POSConst.BCS_Code93
+        "CODE128" -> POSConst.BCS_Code128
+        else -> null
+    }
+}
+
+fun String.toESCTextPosition(): Int? {
+    return when (this) {
+        "NONE" -> POSConst.HRI_TEXT_NONE
+        "ABOVE" -> POSConst.HRI_TEXT_ABOVE
+        "BELOW" -> POSConst.HRI_TEXT_BELOW
+        "BOTH" -> POSConst.HRI_TEXT_BOTH
+        else -> null
+    }
+}
+
+fun String.toESCPrinterCheckType(): Int? {
+    return when (this) {
+        "PRINT" -> POSConst.STS_TYPE_PRINT
+        "OFFLINE" -> POSConst.STS_TYPE_OFFLINE
+        "ERR" -> POSConst.STS_TYPE_ERR
+        "PAPER" -> POSConst.STS_TYPE_PAPER
+        else -> null
+    }
+}
+
+fun Int.toESCPrinterCheckStatus(): String {
+    return when (this) {
+        -2 -> "START_READ_LOOP_RETURN"
+        -3 -> "DISCONNECT"
+        -4 -> "TIMEOUT"
+        else -> "UNKNOWN"
+    }
+}
+
+
+fun Int.toESCPrinterStatus(): String {
+    return when (this) {
+        POSConst.STS_NORMAL -> "NORMAL"
+        POSConst.STS_COVEROPEN -> "COVER_OPEN"
+        POSConst.STS_PRESS_FEED -> "PRESS_FEED"
+        POSConst.STS_PAPEREMPTY -> "PAPER_EMPTY"
+        POSConst.STS_PRINTER_ERR -> "PRINTER_ERR"
+        54 -> "COVER_OPEN_AND_PAPER_EMPTY"
+        -1 -> "OTHER_ERROR"
+        -3 -> "DISCONNECT"
+        -4 -> "TIMEOUT"
+        else -> "UNKNOWN"
+    }
+}
+
+fun Int.toESCPrinterStatusII(): String {
+    return when (this) {
+        0 -> "NORMAL"
+        1 -> "PRINTING"
+        2 -> "COVER_OPEN"
+        4 -> "PAPER_EMPTY"
+        8 -> "PAPER_IS_OVER"
+        16 -> "MONEY_BOX_OPEN"
+        32 -> "OTHER_ERROR"
+        64 -> "CUTTING_ERROR"
+        128 -> "PRINT_HEAD_OVERHEATING"
+        -3 -> "DISCONNECT"
+        -4 -> "TIMEOUT"
+        else -> "UNKNOWN"
+    }
+}
+
+fun String.toESCECLevel(): Int? {
+    return when (this) {
+        "LEVEL_L" -> POSConst.QRCODE_EC_LEVEL_L
+        "LEVEL_M" -> POSConst.QRCODE_EC_LEVEL_M
+        "LEVEL_Q" -> POSConst.QRCODE_EC_LEVEL_Q
+        "LEVEL_H" -> POSConst.QRCODE_EC_LEVEL_H
+        else -> null
+    }
+}
+
+fun String.toESCCutModel(): Int? {
+    return when (this) {
+        "CUT_ALL" -> POSConst.CUT_ALL
+        "CUT_HALF" -> POSConst.CUT_HALF
+        else -> null
+    }
+}
+
+fun String.toESCDirection(): Int? {
+    return when (this) {
+        "LEFT_TOP" -> POSConst.DIRECTION_LEFT_TOP
+        "LEFT_BOTTOM" -> POSConst.DIRECTION_LEFT_BOTTOM
+        "RIGHT_BOTTOM" -> POSConst.DIRECTION_RIGHT_BOTTOM
+        "RIGHT_TOP" -> POSConst.DIRECTION_RIGHT_TOP
+        else -> null
+    }
+}
+
+fun String.toESCSelectBitmapModel(): Int? {
+    return when (this) {
+        "SINGLE_DENSITY_8" -> POSConst.SINGLE_DENSITY_8
+        "DOUBLE_DENSITY_8" -> POSConst.DOUBLE_DENSITY_8
+        "SINGLE_DENSITY_24" -> POSConst.SINGLE_DENSITY_24
+        "DOUBLE_DENSITY_24" -> POSConst.DOUBLE_DENSITY_24
+        else -> null
+    }
+}
+
+fun String.toESCFontType(): Int? {
+    return when (this) {
+        "STANDARD" -> POSConst.FONT_STANDARD
+        "COMPRESS" -> POSConst.FONT_COMPRESS
+        else -> null
+    }
+}
+
+fun String.toESCWifiEncrypt(): Byte? {
+    return when (this) {
+        "NULL" -> POSConst.ENCRYPT_NULL
+        "WEP64" -> POSConst.ENCRYPT_WEP64
+        "WEP128" -> POSConst.ENCRYPT_WEP128
+        "WPA_AES_PSK" -> POSConst.ENCRYPT_WPA_AES_PSK
+        "WPA_TKIP_PSK" -> POSConst.ENCRYPT_WPA_TKIP_PSK
+        "WPA_TKIP_AES_PSK" -> POSConst.ENCRYPT_WPA_TKIP_AES_PSK
+        "WPA2_AES_PSK" -> POSConst.ENCRYPT_WPA2_AES_PSK
+        "WPA2_TKIP" -> POSConst.ENCRYPT_WPA2_TKIP
+        "WPA2_TKIP_AES_PSK" -> POSConst.ENCRYPT_WPA2_TKIP_AES_PSK
+        "WPA_WPA2_MixedMode" -> POSConst.ENCRYPT_WPA_WPA2_MixedMode
+        else -> null
+    }
+}