@delicity/capacitor-thermal-printer 7.0.0

package/android/build.gradle

@@ -0,0 +1,122 @@
+ext {
+    junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
+    androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.6.1'
+    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.1.5'
+    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.5.1'
+}
+
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        // Capacitor 7 : AGP 8.7.2 / Gradle 8.11.1 / JDK 21
+        classpath 'com.android.tools.build:gradle:8.7.2'
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:2.0.21"
+    }
+}
+
+apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android'
+apply plugin: 'jacoco'
+
+android {
+    namespace "com.delicity.thermalprinter"
+    compileSdk project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 35
+    defaultConfig {
+        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 23
+        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 35
+        versionCode 1
+        versionName "0.1.0"
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_21
+        targetCompatibility JavaVersion.VERSION_21
+    }
+    kotlinOptions {
+        jvmTarget = '21'
+    }
+    lintOptions {
+        abortOnError false
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+        }
+    }
+    testOptions {
+        unitTests {
+            includeAndroidResources = true
+            returnDefaultValues = true
+        }
+    }
+}
+
+repositories {
+    google()
+    mavenCentral()
+    flatDir {
+        // SDK fabricants livrés en .aar/.jar manuel (Epson ePOS2, Brother, Zebra Link-OS)
+        // à déposer dans android/libs/ (binaires NON committés). Voir docs/SDK_INTEGRATION.md
+        dirs 'libs'
+    }
+    // ---- Zebra Link-OS : dépôt Maven PRIVÉ Zebra (credentials requis) ----
+    // Décommenter + renseigner zebraCoreId / zebraToken dans gradle.properties pour
+    // activer l'auto-download de Zebra. Voir docs/SDK_INTEGRATION.md (§ Zebra).
+    // maven {
+    //     url "https://artifactory-us.zebra.com/artifactory/dmo-mvn-rel/"
+    //     credentials {
+    //         username = project.findProperty('zebraCoreId') ?: ''
+    //         password = project.findProperty('zebraToken') ?: ''
+    //     }
+    // }
+}
+
+dependencies {
+    implementation fileTree(include: ['*.jar', '*.aar'], dir: 'libs')
+    implementation project(':capacitor-android')
+    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
+    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3"
+
+    // ---- Star StarXpand : SEUL SDK 100% auto-download (Maven Central, sans licence gate) ----
+    // L'adapter Star utilise des appels TYPÉS (compilation directe contre ces classes).
+    // Pour désactiver Star (réduire la taille), commenter cette ligne ET StarAdapter sera
+    // ignoré (isAvailable()=false via réflexion). Version à réactualiser au besoin.
+    implementation "com.starmicronics:stario10:1.12.1"
+
+    // ---- Epson / Brother / Zebra : binaires MANUELS (license-gated, non redistribuables) ----
+    // Les adapters correspondants utilisent la RÉFLEXION : le plugin compile/s'installe SANS
+    // ces binaires, et chaque adapter s'active automatiquement si le binaire est présent.
+    // Déposer les fichiers dans android/libs/ (voir docs/SDK_INTEGRATION.md) :
+    //   • Epson  : ePOS2.jar    (portail Epson)
+    //   • Brother: BrotherPrintLibrary.aar (portail Brother)
+    //   • Zebra  : ZSDK_ANDROID_API.jar (portail Zebra) — ou dépôt Maven privé ci-dessus.
+    // Aucune ligne `implementation` n'est requise pour eux : fileTree(libs) ci-dessus suffit
+    // à les embarquer dans l'app consommatrice quand ils sont présents.
+
+    testImplementation "junit:junit:$junitVersion"
+    // Tests JVM des adapters SDK (faux SDK sur le classpath de test) + Robolectric
+    // pour Context/Bitmap, sans émulateur. Voir docs/TESTING_SDK.md.
+    testImplementation "org.robolectric:robolectric:4.13"
+    testImplementation "androidx.test:core:1.6.1"
+    testImplementation "org.jetbrains.kotlinx:kotlinx-coroutines-test:1.7.3"
+    androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
+    androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
+}
+
+// Rapport de couverture des tests unitaires JVM (./gradlew testDebugUnitTest jacocoTestReport)
+tasks.register('jacocoTestReport', JacocoReport) {
+    dependsOn 'testDebugUnitTest'
+    reports {
+        html.required = true
+        xml.required = true
+    }
+    def kotlinClasses = fileTree(dir: "${buildDir}/tmp/kotlin-classes/debug", excludes: [
+        '**/model/**', // data classes / JSON mapping
+    ])
+    classDirectories.setFrom(kotlinClasses)
+    sourceDirectories.setFrom(files('src/main/java'))
+    executionData.setFrom(fileTree(dir: buildDir, includes: ['**/testDebugUnitTest.exec', '**/jacoco/*.exec']))
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
+
+    <!-- ============ Bluetooth (Android <= 11 / API <= 30) ============ -->
+    <uses-permission android:name="android.permission.BLUETOOTH"
+        android:maxSdkVersion="30" />
+    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"
+        android:maxSdkVersion="30" />
+    <!-- Le scan BLE exige la localisation jusqu'à Android 11 -->
+    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"
+        android:maxSdkVersion="30" />
+
+    <!-- ============ Bluetooth (Android 12+ / API 31+) ============ -->
+    <!-- usesPermissionFlags=neverForLocation : on déclare ne PAS dériver la
+         localisation à partir du scan BT, ce qui évite de demander la localisation. -->
+    <uses-permission android:name="android.permission.BLUETOOTH_SCAN"
+        android:usesPermissionFlags="neverForLocation"
+        tools:targetApi="s" />
+    <uses-permission android:name="android.permission.BLUETOOTH_CONNECT"
+        tools:targetApi="s" />
+
+    <!-- ============ Réseau (Wi-Fi / Ethernet TCP 9100) ============ -->
+    <uses-permission android:name="android.permission.INTERNET" />
+    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
+    <!-- mDNS / discovery réseau (multicast) -->
+    <uses-permission android:name="android.permission.CHANGE_WIFI_MULTICAST_STATE" />
+
+    <!-- ============ USB host (optionnel) ============ -->
+    <uses-feature android:name="android.hardware.usb.host" android:required="false" />
+
+    <!-- Déclarations de matériel non obligatoire pour ne pas exclure d'appareils -->
+    <uses-feature android:name="android.hardware.bluetooth" android:required="false" />
+    <uses-feature android:name="android.hardware.bluetooth_le" android:required="false" />
+    <uses-feature android:name="android.hardware.wifi" android:required="false" />
+
+</manifest>

package/android/src/main/java/com/delicity/thermalprinter/Logger.kt

@@ -0,0 +1,50 @@
+package com.delicity.thermalprinter
+
+import android.util.Log
+import org.json.JSONArray
+import org.json.JSONObject
+import java.util.ArrayDeque
+
+/**
+ * Logger circulaire en mémoire + Logcat, pour le diagnostic support client.
+ *
+ * - garde les N dernières lignes (ring buffer) consultables via getDebugLog(),
+ * - chaque ligne est horodatée et catégorisée (discovery/connect/print/status),
+ * - jamais de données image brutes (juste tailles/dimensions).
+ *
+ * L'app peut exposer ces logs dans un écran "Diagnostic imprimante" et les
+ * joindre à un ticket de support.
+ */
+object Logger {
+    private const val TAG = "ThermalPrinter"
+    private const val MAX_LINES = 500
+    private val ring = ArrayDeque<JSONObject>(MAX_LINES)
+    @Volatile var verbose: Boolean = false
+
+    @Synchronized
+    fun log(category: String, message: String, data: Map<String, Any?>? = null) {
+        val entry = JSONObject()
+            .put("ts", System.currentTimeMillis())
+            .put("category", category)
+            .put("message", message)
+        data?.forEach { (k, v) -> entry.put(k, v ?: JSONObject.NULL) }
+        if (ring.size >= MAX_LINES) ring.pollFirst()
+        ring.addLast(entry)
+        if (verbose) Log.d(TAG, "[$category] $message ${data ?: ""}")
+    }
+
+    fun error(category: String, message: String, t: Throwable? = null) {
+        log(category, message, mapOf("error" to (t?.message ?: "")))
+        Log.e(TAG, "[$category] $message", t)
+    }
+
+    @Synchronized
+    fun snapshot(): JSONArray {
+        val arr = JSONArray()
+        ring.forEach { arr.put(it) }
+        return arr
+    }
+
+    @Synchronized
+    fun clear() = ring.clear()
+}