@pradip1995/pos-common

Shared POS utilities for offline-pos and medusa-pos:

• Secure storage helpers (native SecureStore + web AsyncStorage)
• Receipt paper width + default print target prefs
• HTML / system receipt printing (expo-print)
• Bluetooth ESC/POS printing (address normalize, permissions, Rs. for ₹)
• Smart print routing (Bluetooth vs system)
• React Query hooks for printer settings

Install

npm install @pradip1995/pos-common

Configure (required once per app)

// src/pos-common-setup.ts
import { configurePosCommon } from '@pradip1995/pos-common';

configurePosCommon({
  storagePrefix: 'offline_pos', // or medusa_pos
  appName: 'Offline POS',
  printerSettingsHint: 'Open Settings → Bluetooth printer.',
  receiptAccentColor: '#0D9488',
  printFrameId: 'offline-pos-receipt-print-frame',
});

Import that file first in your root layout:

import './pos-common-setup';

Usage

Prefer subpath imports so Jest / tree-shaking stay light:

import { printReceiptSmart } from '@pradip1995/pos-common/print-smart';
import { scanBluetoothPrinters } from '@pradip1995/pos-common/bluetooth-printer';
import { useBluetoothPrinter } from '@pradip1995/pos-common/hooks';
import { escPosSafeText } from '@pradip1995/pos-common/bluetooth-printer';

Or the barrel:

import { printReceiptSmart, scanBluetoothPrinters } from '@pradip1995/pos-common';