react-native-esc-pos-printer-chunyinli 4.5.2

package/package.json

@@ -0,0 +1,181 @@
+{
+  "name": "react-native-esc-pos-printer-chunyinli",
+  "version": "4.5.2",
+  "description": "An unofficial React Native library for printing on an EPSON TM printer with the Epson ePOS SDK for iOS and Epson ePOS SDK for Android",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "scripts",
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*",
+    "!scripts/movelib"
+  ],
+  "scripts": {
+    "example": "yarn workspace react-native-esc-pos-printer-example",
+    "test": "jest",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "release": "release-it --only-version",
+    "postinstall": "node ./scripts/movelib.js"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chunyinli/react-native-esc-pos-printer.git"
+  },
+  "author": "Chunyin LI (https://github.com/chunyinli)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/chunyinli/react-native-esc-pos-printer/issues"
+  },
+  "homepage": "https://github.com/chunyinli/react-native-esc-pos-printer#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "dependencies": {
+    "buffer": "6.0.3",
+    "p-queue": "7.4.1",
+    "react-native-esc-pos-printer-sdk": "2.31.1",
+    "wordwrapjs": "5.1.0"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^19.8.1",
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@evilmartians/lefthook": "^1.12.3",
+    "@react-native-community/cli": "20.0.1",
+    "@react-native/babel-preset": "0.81.1",
+    "@react-native/eslint-config": "^0.81.1",
+    "@release-it/conventional-changelog": "^10.0.1",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^19.1.0",
+    "commitlint": "^19.8.1",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "jest": "^29.7.0",
+    "prettier": "^3.6.2",
+    "react": "19.1.0",
+    "react-native": "0.81.1",
+    "react-native-builder-bob": "^0.40.13",
+    "react-native-view-shot": "^3.8.0",
+    "release-it": "^19.0.4",
+    "turbo": "^2.5.6",
+    "typescript": "^5.9.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@3.6.1",
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "codegen",
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "codegenConfig": {
+    "name": "RNEscPosPrinterSpec",
+    "type": "modules",
+    "jsSrcsDir": "src/specs",
+    "outputDir": {
+      "ios": "ios/generated",
+      "android": "android/generated"
+    },
+    "android": {
+      "javaPackageName": "com.escposprinter"
+    },
+    "includesGeneratedCode": true
+  },
+  "create-react-native-library": {
+    "languages": "kotlin-objc",
+    "type": "turbo-module",
+    "version": "0.54.3"
+  }
+}

package/react-native-esc-pos-printer.podspec

@@ -0,0 +1,24 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+folly_compiler_flags = '-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1 -Wno-comma -Wno-shorten-64-to-32'
+
+Pod::Spec.new do |s|
+  s.name         = "react-native-esc-pos-printer"
+  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 => "https://github.com/tr3v3r/react-native-esc-pos-printer.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,cpp}"
+  s.private_header_files = "ios/generated/**/*.h"
+  s.vendored_frameworks = "ios/PrinterSDK/libepos2.xcframework"
+  s.libraries = "xml2.2"
+  s.frameworks = "ExternalAccessory", "CoreBluetooth"
+
+  install_modules_dependencies(s)
+end

package/react-native.config.js

@@ -0,0 +1,12 @@
+/**
+ * @type {import('@react-native-community/cli-types').UserDependencyConfig}
+ */
+module.exports = {
+  dependency: {
+    platforms: {
+      android: {
+        cmakeListsPath: 'generated/jni/CMakeLists.txt',
+      },
+    },
+  },
+};

package/scripts/movelib.js

@@ -0,0 +1,66 @@
+const fs = require('fs');
+const path = require('path');
+
+let dir = '../../react-native-esc-pos-printer-sdk';
+
+if (!fs.existsSync(path.join(__dirname, dir))) {
+  dir = '../node_modules/react-native-esc-pos-printer-sdk';
+}
+
+const libCurrentPath = path.join(__dirname, dir, 'ios');
+const libDestPath = path.join(__dirname, '../ios/PrinterSDK');
+
+const libAndroidCurrentPath = path.join(__dirname, dir, 'android/libs');
+const libAndroidDestPath = path.join(__dirname, '../android/libs');
+
+const jnilibAndroidCurrentPath = path.join(__dirname, dir, 'android/jniLibs');
+const jnilibAndroidDestPath = path.join(
+  __dirname,
+  '../android/src/main/jniLibs'
+);
+
+// Helper to recursively copy directory
+function copyDirSync(src, dest) {
+  if (!fs.existsSync(src)) return;
+
+  if (!fs.existsSync(dest)) {
+    fs.mkdirSync(dest, { recursive: true });
+  }
+
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      copyDirSync(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+// Copy iOS SDK
+try {
+  copyDirSync(libCurrentPath, libDestPath);
+  console.log('iOS SDK copied!');
+} catch (err) {
+  console.error(err);
+}
+
+// Copy Android libs
+try {
+  copyDirSync(libAndroidCurrentPath, libAndroidDestPath);
+  console.log('Android lib copied!');
+} catch (err) {
+  console.error(err);
+}
+
+// Copy Android jniLibs
+try {
+  copyDirSync(jnilibAndroidCurrentPath, jnilibAndroidDestPath);
+  console.log('Android jniLibs copied!');
+} catch (err) {
+  console.error(err);
+}

package/src/core/errors/PrinterDiscoveryError.ts

@@ -0,0 +1,14 @@
+export class PrinterDiscoveryError extends Error {
+  message: string = '';
+  name: string = 'PrinterDiscoveryError';
+  timestamp: number = 0;
+  status: string = '';
+  methodName: string = '';
+
+  constructor(params: { status: string; message: string; methodName: string }) {
+    super(params.message);
+    Object.assign(this, params);
+  }
+}
+
+PrinterDiscoveryError.prototype.name = 'PrinterDiscoveryError';

package/src/core/errors/PrinterError.ts

@@ -0,0 +1,14 @@
+export class PrinterError extends Error {
+  message: string = '';
+  name: string = 'PrinterError';
+  timestamp: number = 0;
+  status: string = '';
+  methodName: string = '';
+
+  constructor(params: { status: string; message: string; methodName: string }) {
+    super(params.message);
+    Object.assign(this, params);
+  }
+}
+
+PrinterError.prototype.name = 'PrinterError';

package/src/core/errors/index.ts

@@ -0,0 +1,2 @@
+export { PrinterDiscoveryError } from './PrinterDiscoveryError';
+export { PrinterError } from './PrinterError';

package/src/core/index.ts

@@ -0,0 +1,2 @@
+export * from './errors';
+export * from './utils';

package/src/core/utils/constants.ts

@@ -0,0 +1,12 @@
+export function remapConstants<T extends object>(
+  constants: T
+): Record<string, keyof T> {
+  return Object.keys(constants).reduce(
+    (acc, key) => {
+      const value = constants[key as keyof T];
+      acc[String(value)] = key as keyof T;
+      return acc;
+    },
+    {} as Record<string, keyof T>
+  );
+}

package/src/core/utils/index.ts

@@ -0,0 +1,2 @@
+export * from './constants';
+export * from './permissions';

package/src/core/utils/permissions.ts

@@ -0,0 +1,92 @@
+import { PermissionsAndroid, Platform } from 'react-native';
+
+import type { EventSubscription, Permission } from 'react-native';
+import { EscPosPrinterDiscovery } from '../../specs';
+
+const platformVersion = Platform.Version as number;
+export async function requestAndroidPermissions(): Promise<boolean> {
+  if (platformVersion < 23) return true;
+
+  let permissions: Permission[] = [];
+
+  if (platformVersion >= 31) {
+    const permissionBluetoothScanGranted = await PermissionsAndroid.check(
+      PermissionsAndroid.PERMISSIONS.BLUETOOTH_SCAN
+    );
+
+    const permissionBluetoothConnectGranted = await PermissionsAndroid.check(
+      PermissionsAndroid.PERMISSIONS.BLUETOOTH_CONNECT
+    );
+
+    if (!permissionBluetoothScanGranted) {
+      permissions.push(PermissionsAndroid.PERMISSIONS.BLUETOOTH_SCAN);
+    }
+
+    if (!permissionBluetoothConnectGranted) {
+      permissions.push(PermissionsAndroid.PERMISSIONS.BLUETOOTH_CONNECT);
+    }
+  } else if (platformVersion >= 29 && platformVersion <= 30) {
+    const permissionFineLocationGranted = await PermissionsAndroid.check(
+      PermissionsAndroid.PERMISSIONS.ACCESS_FINE_LOCATION
+    );
+
+    if (!permissionFineLocationGranted) {
+      permissions.push(PermissionsAndroid.PERMISSIONS.ACCESS_FINE_LOCATION);
+    }
+  } else {
+    const permissionCoarseLocationGranted = await PermissionsAndroid.check(
+      PermissionsAndroid.PERMISSIONS.ACCESS_COARSE_LOCATION
+    );
+
+    if (!permissionCoarseLocationGranted) {
+      permissions.push(PermissionsAndroid.PERMISSIONS.ACCESS_COARSE_LOCATION);
+    }
+  }
+
+  if (permissions.length > 0) {
+    const status = await PermissionsAndroid.requestMultiple(permissions);
+    return Object.keys(status ?? {}).every(
+      (key) => status[key as Permission] === PermissionsAndroid.RESULTS.GRANTED
+    );
+  }
+
+  return true;
+}
+
+export function enableLocationAccessAndroid10() {
+  if (platformVersion > 28) {
+    let successListener: EventSubscription | null;
+    let errorListener: EventSubscription | null;
+
+    function removeListeners() {
+      successListener?.remove();
+      errorListener?.remove();
+
+      successListener = null;
+      errorListener = null;
+    }
+
+    return new Promise((res, rej) => {
+      successListener = EscPosPrinterDiscovery.enableLocationSettingSuccess(
+        () => {
+          removeListeners();
+          res(true);
+        }
+      );
+
+      errorListener = EscPosPrinterDiscovery.enableLocationSettingFailure(
+        () => {
+          removeListeners();
+          rej(false);
+        }
+      );
+
+      EscPosPrinterDiscovery.enableLocationSetting().then(() => {
+        removeListeners();
+        res(true);
+      });
+    });
+  }
+
+  return Promise.resolve(true);
+}

package/src/discovery/PrintersDiscovery.tsx

@@ -0,0 +1,166 @@
+import { Platform } from 'react-native';
+
+import {
+  PrinterDiscoveryError,
+  enableLocationAccessAndroid10,
+  requestAndroidPermissions,
+} from '../core';
+import type {
+  DiscoveryStartParams,
+  DeviceInfo,
+  DiscoveryStatus,
+  RawDeviceInfo,
+} from './types';
+import {
+  DEFAULT_DISCOVERY_TIMEOUT,
+  DiscoveryErrorResult,
+  DiscoveryDeviceTypeMapping,
+  PrinterPairBluetoothErrorMessageMapping,
+  PrinterPairBluetoothErrorStatusMapping,
+} from './constants';
+import { getProcessedError } from './utils';
+import { EscPosPrinterDiscovery } from '../specs';
+
+class PrintersDiscoveryClass {
+  timeout: ReturnType<typeof setTimeout> | null = null;
+  status: DiscoveryStatus = 'inactive';
+  statusListeners: ((status: DiscoveryStatus) => void)[] = [];
+  errorListeners: ((error: PrinterDiscoveryError) => void)[] = [];
+
+  public start = async ({
+    timeout = DEFAULT_DISCOVERY_TIMEOUT,
+    autoStop = true,
+    filterOption = {},
+  }: DiscoveryStartParams = {}) => {
+    try {
+      if (this.status === 'discovering') return;
+
+      if (
+        (Platform.OS === 'android' && !(await requestAndroidPermissions())) ||
+        !(await enableLocationAccessAndroid10())
+      ) {
+        this.triggerError(
+          'PrintersDiscovery.start',
+          new Error(String(DiscoveryErrorResult.PERMISSION_ERROR))
+        );
+        return;
+      }
+
+      this.setStatus('discovering');
+
+      await EscPosPrinterDiscovery.startDiscovery(filterOption);
+
+      if (autoStop) {
+        this.stopAfterDelay(timeout);
+      }
+    } catch (error) {
+      this.setStatus('inactive');
+      this.triggerError('start', error as Error);
+    }
+  };
+
+  public stop = async () => {
+    try {
+      if (this.status === 'inactive') return;
+      this.clearTimeout();
+
+      await EscPosPrinterDiscovery.stopDiscovery();
+
+      this.setStatus('inactive');
+    } catch (error) {
+      this.triggerError('stop', error as Error);
+    }
+  };
+
+  private stopAfterDelay = (timeout: number) => {
+    this.timeout = setTimeout(() => {
+      this.timeout = null;
+      this.stop();
+    }, timeout);
+  };
+
+  private clearTimeout = () => {
+    if (this.timeout) {
+      clearTimeout(this.timeout);
+      this.timeout = null;
+    }
+  };
+
+  public onStatusChange = (callback: (status: DiscoveryStatus) => void) => {
+    this.statusListeners.push(callback);
+
+    return () => {
+      this.statusListeners = this.statusListeners.filter(
+        (listener) => listener !== callback
+      );
+    };
+  };
+
+  public onError = (callback: (error: PrinterDiscoveryError) => void) => {
+    this.errorListeners.push(callback);
+
+    return () => {
+      this.errorListeners = this.errorListeners.filter(
+        (listener) => listener !== callback
+      );
+    };
+  };
+
+  public onDiscovery = (callback: (printers: DeviceInfo[]) => void) => {
+    const listener = EscPosPrinterDiscovery.onDiscovery(
+      (printer: RawDeviceInfo[]) => {
+        callback(
+          printer.map((info) => ({
+            ...info,
+            deviceType: DiscoveryDeviceTypeMapping[info.deviceType]!,
+          }))
+        );
+      }
+    );
+
+    return () => {
+      listener.remove();
+    };
+  };
+
+  pairBluetoothDevice = async (macAddress?: string) => {
+    if (Platform.OS === 'ios') {
+      try {
+        await EscPosPrinterDiscovery.pairBluetoothDevice(macAddress || '');
+      } catch (error) {
+        throw getProcessedError({
+          methodName: 'pairBluetoothDevice',
+          errorCode: error.message,
+          messagesMapping: PrinterPairBluetoothErrorMessageMapping,
+          statusMapping: PrinterPairBluetoothErrorStatusMapping,
+        });
+      }
+    } else {
+      return Promise.resolve();
+    }
+  };
+
+  private triggerError = (methodName: string, error: Error) => {
+    const processedError = getProcessedError({
+      methodName,
+      errorCode: error.message,
+    });
+
+    this.errorListeners.forEach((listener) => listener(processedError));
+  };
+
+  private triggerStatusChange = (status: DiscoveryStatus) => {
+    this.statusListeners.forEach((listener) => listener(status));
+  };
+
+  private setStatus = (status: DiscoveryStatus) => {
+    this.status = status;
+    this.triggerStatusChange(status);
+  };
+}
+
+function initPrintersClass() {
+  return new PrintersDiscoveryClass();
+}
+
+export const PrintersDiscovery = initPrintersClass();